Trait Context 

pub trait Context:
    Display
    + Debug
    + Send
    + Sync
    + 'static {
    // Provided method
    fn provide<'a>(&'a self, request: &mut Request<'a>) { ... }
}

👎Deprecated since 0.6.0: Use core::error::Error instead

Defines the current context of a Report.

When in a std environment or on a nightly toolchain, every Error is a valid Context. This trait is not limited to Errors and can also be manually implemented on a type.

Example

Used for creating a Report or for switching the Report’s context:

use std::{error::Error, fmt, fs, io};

use error_stack::{ResultExt, Report};

#[derive(Debug)]
pub enum ConfigError {
    ParseError,
}

impl fmt::Display for ConfigError {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        ...
    }
}

// In this scenario, `Error` is not implemented for `ConfigError` for some reason, so implement
// `Context` manually.
impl Error for ConfigError {}

pub fn read_file(path: &str) -> Result<String, Report<io::Error>> {
    // Creates a `Report` from `io::Error`, the current context is `io::Error`
    fs::read_to_string(path).map_err(Report::from)
}

pub fn parse_config(path: &str) -> Result<Config, Report<ConfigError>> {
    // The return type of `parse_config` requires another context. By calling `change_context`
    // the context may be changed.
    read_file(path).change_context(ConfigError::ParseError)?;

    ...
}

Provided Methods

fn provide<'a>(&'a self, request: &mut Request<'a>)

👎Deprecated since 0.6.0: Use core::error::Error instead

Available on nightly only.

Provide values which can then be requested by Report.

Implementors

impl<C: Error + Send + Sync + 'static> Context for C