Method current_contexts

libs/error-stack/src/report.rs:876–915

Returns an iterator over the current contexts of the `Report`. This method is similar to [`current_context`], but instead of returning a single context, it returns an iterator over all contexts in the `Report`. The order of the contexts should not be relied upon, as it is not guaranteed to be stable. ## Example ```rust # use std::{fs, path::Path}; # use error_stack::Report; use std::io; fn re

(&self)

    ///
    /// [`current_context`]: Self::current_context
    pub fn current_contexts(&self) -> impl Iterator<Item = &C>
    where
        C: Send + Sync + 'static,
    {
        // this needs a manual traveral implementation, why?
        // We know that each arm has a current context, but we don't know where that context is,
        // therefore we need to search for it on each branch, but stop once we found it, that way
        // we're able to return the current context, even if it is "buried" underneath a bunch of
        // attachments.
        let mut output = Vec::new();

        // this implementation does some "weaving" in a sense, it goes L->R for the frames, then
        // R->L for the sources, which means that some sources might be out of order, but this
        // simplifies implementation.
        let mut stack = vec![self.current_frames()];
        while let Some(frames) = stack.pop() {
            for frame in frames {
                // check if the frame is the current context, in that case we don't need to follow
                // the tree anymore
                if let Some(context) = frame.downcast_ref::<C>() {
                    output.push(context);
                    continue;
                }

                // descend into the tree
                let sources = frame.sources();
                match sources {
                    [] => unreachable!(
                        "Report does not contain a context. This is considered a bug and should be \
                        reported to https://github.com/hashintel/hash/issues/new/choose"
                    ),
                    sources => {
                        stack.push(sources);
                    }
                }
            }
        }

        output.into_iter()
    }
}

impl<C: 'static> From<Report<C>> for Box<dyn Error> {