Struct rustdoc::html::render::context::Context[][src]

pub(crate) struct Context<'tcx> {
    pub(crate) current: Vec<String>,
    pub(super) dst: PathBuf,
    pub(super) render_redirect_pages: bool,
    pub(super) id_map: RefCell<IdMap>,
    pub(super) deref_id_map: RefCell<FxHashMap<DefId, String>>,
    pub(super) shared: Rc<SharedContext<'tcx>>,
    pub(super) cache: Rc<Cache>,

Major driving force in all rustdoc rendering. This contains information about where in the tree-like hierarchy rendering is occurring and controls how the current page is being rendered.

It is intended that this context is a lightweight object which can be fairly easily cloned because it is cloned per work-job (about once per item in the rustdoc tree).


current: Vec<String>

Current hierarchy of components leading down to what’s currently being rendered

dst: PathBuf

The current destination folder of where HTML artifacts should be placed. This changes as the context descends into the module hierarchy.

render_redirect_pages: bool

A flag, which when true, will render pages which redirect to the real location of an item. This is used to allow external links to publicly reused items to redirect to the right location.

id_map: RefCell<IdMap>

The map used to ensure all generated ‘id=’ attributes are unique.

deref_id_map: RefCell<FxHashMap<DefId, String>>

Tracks section IDs for Deref targets so they match in both the main body and the sidebar.

shared: Rc<SharedContext<'tcx>>

Shared mutable state.

Issue for improving the situation: #82381

cache: Rc<Cache>

The Cache used during rendering.

Ideally the cache would be in SharedContext, but it’s mutated between when the SharedContext is created and when Context is created, so more refactoring would be needed.

It’s immutable once in Context, so it’s not as bad that it’s not in SharedContext.


impl<'tcx> Context<'tcx>[src]

pub(crate) fn tcx(&self) -> TyCtxt<'tcx>[src]

pub(crate) fn cache(&self) -> &Cache[src]

fn sess(&self) -> &'tcx Session[src]

pub(super) fn derive_id(&self, id: String) -> String[src]

pub(super) fn root_path(&self) -> String[src]

String representation of how to get back to the root path of the ‘doc/’ folder in terms of a relative URL.

fn render_item(&self, it: &Item, is_module: bool) -> String[src]

fn build_sidebar_items(
    m: &Module
) -> BTreeMap<String, Vec<(String, Option<String>)>>

Construct a map of items shown in the sidebar to a plain-text summary of their docs.

pub(super) fn src_href(&self, item: &Item) -> Option<String>[src]

Generates a url appropriate for an href attribute back to the source of this item.

The url generated, when clicked, will redirect the browser back to the original source code.

If None is returned, then a source link couldn’t be generated. This may happen, for example, with externally inlined items where the source of their crate documentation isn’t known.

impl Context<'_>[src]

fn suffix_path(&self, filename: &str) -> PathBuf[src]

fn write_shared<C: AsRef<[u8]>>(
    resource: SharedResource<'_>,
    contents: C,
    emit: &[EmitType]
) -> Result<(), Error>

fn write_minify(
    resource: SharedResource<'_>,
    contents: &str,
    minify: bool,
    emit: &[EmitType]
) -> Result<(), Error>

Trait Implementations

impl<'tcx> FormatRenderer<'tcx> for Context<'tcx>[src]

Generates the documentation for crate into the directory dst

fn descr() -> &'static str[src]

Gives a description of the renderer. Used for performance profiling.

const RUN_ON_MODULE: bool[src]

Whether to call item recursivly for modules Read more

fn init(
    krate: Crate,
    options: RenderOptions,
    cache: Cache,
    tcx: TyCtxt<'tcx>
) -> Result<(Self, Crate), Error>

Sets up any state required for the renderer. When this is called the cache has already been populated. Read more

fn make_child_renderer(&self) -> Self[src]

Make a new renderer to render a child of the item currently being rendered.

fn after_krate(&mut self) -> Result<(), Error>[src]

Post processing hook for cleanup and dumping output to files.

fn mod_item_in(&mut self, item: &Item) -> Result<(), Error>[src]

Renders a module (should not handle recursing into children).

fn mod_item_out(&mut self) -> Result<(), Error>[src]

Runs after recursively rendering all sub-items of a module.

fn item(&mut self, item: Item) -> Result<(), Error>[src]

Renders a single non-module item. This means no recursive sub-item rendering is required.

fn cache(&self) -> &Cache[src]

Auto Trait Implementations

impl<'tcx> !RefUnwindSafe for Context<'tcx>

impl<'tcx> !Send for Context<'tcx>

impl<'tcx> !Sync for Context<'tcx>

impl<'tcx> Unpin for Context<'tcx>

impl<'tcx> !UnwindSafe for Context<'tcx>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

impl<T> From<T> for T[src]

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<T> Instrument for T[src]

fn instrument(self, span: Span) -> Instrumented<Self>[src]

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>[src]

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T where
    U: From<T>, 

pub fn into(self) -> U[src]

Performs the conversion.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

Performs the conversion.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 

pub fn vzip(self) -> V

impl<T> WithConstness for T[src]

fn with_constness(self, constness: Constness) -> ConstnessAnd<Self>[src]

fn with_const(self) -> ConstnessAnd<Self>[src]

fn without_const(self) -> ConstnessAnd<Self>[src]

impl<'a, T> Captures<'a> for T where
    T: ?Sized