error-stack

error-stack is a context-aware error-handling library that supports arbitrary attached user data.

Read our [announcement post] for the story behind its origins.

The library enables building a Report around an error as it propagates:

```rust use std::fmt;

use error_stack::{Context, IntoReport, Report, Result, ResultExt};

[derive(Debug)]

struct ParseExperimentError;

impl fmt::Display for ParseExperimentError { fn fmt(&self, fmt: &mut fmt::Formatter<'>) -> fmt::Result { fmt.writestr("invalid experiment description") } }

impl Context for ParseExperimentError {}

fn parseexperiment(description: &str) -> Result<(u64, u64), ParseExperimentError> { let value = description .parse() .intoreport() .attachprintablelazy(|| format!("{description:?} could not be parsed as experiment")) .change_context(ParseExperimentError)?;

Ok((value, 2 * value))

}

[derive(Debug)]

struct ExperimentError;

impl fmt::Display for ExperimentError { fn fmt(&self, fmt: &mut fmt::Formatter<'>) -> fmt::Result { fmt.writestr("experiment error: could not run experiment") } }

impl Context for ExperimentError {}

fn startexperiments( experimentids: &[usize], experimentdescriptions: &[&str], ) -> Result, ExperimentError> { let experiments = experimentids .iter() .map(|expid| { let description = experimentdescriptions.get(*expid).okorelse(|| { Report::new(ExperimentError) .attachprintable(format!("experiment {exp_id} has no valid description")) })?;

        let experiment = parse_experiment(description)
            .attach_printable(format!("experiment {exp_id} could not be parsed"))
            .change_context(ExperimentError)?;

        Ok(move || experiment.0 * experiment.1)
    })
    .collect::<Result<Vec<_>, ExperimentError>>()
    .attach_printable("unable to set up experiments")?;

Ok(experiments.iter().map(|experiment| experiment()).collect())

}

fn main() -> Result<(), ExperimentError> { let experimentids = &[0, 2]; let experimentdescriptions = &["10", "20", "3o"]; startexperiments(experimentids, experiment_descriptions)?;

Ok(())

} ```

This will most likely result in an error and print

Please see the [documentation] for a full description.

For more examples, please check out the examples folder.