error-stack 0.7.0

A context-aware error-handling library that supports arbitrary attached user data
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

//! Example of using `attach` to set a custom exit code. Requires nightly and std feature.

use core::error::Error;
use std::process::{ExitCode, Termination as _};

use error_stack::Report;

#[derive(Debug)]
struct CustomError;

impl Error for CustomError {}

impl core::fmt::Display for CustomError {
    fn fmt(&self, fmt: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        fmt.write_str("Custom Error")
    }
}

fn main() -> ExitCode {
    let report = Report::new(CustomError)
        .attach_opaque(ExitCode::from(100))
        .attach("this error has an exit code of 100!");

    report.report()
}