Trait ToRecursiveError

Source

pub trait ToRecursiveError {
    // Required method
    fn construct_recursive(self, context: &'static str) -> RecursiveError;
}

Expand description

Attach context to an error which RecursiveError knows how to wrap.

By forcing ourselves to map errors everywhere in order for question mark operators to work, we ensure that we can take the opportunity to include a little bit of manual context. Pervasively done, this means that our errors have quite a lot of contextual information about the call stack and what precisely has gone wrong.

Implementing this trait is what lets RecursiveError::context select the right variant from the error’s type alone, so most call sites never need to name a variant. It also lets generic code wrap an arbitrary module error without knowing which one it has; core-crypto-ffi relies on that.