error-stack 0.8.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
26
27
28

//! A `&mut Frame` must not be able to escape the `frames_mut` visitor. Two escaped references
//! could alias the same frame (directly and through `Frame::sources_mut`), which is the
//! soundness hole the visitor API exists to close.

use core::{error::Error, fmt, ops::ControlFlow};

use error_stack::{Frame, Report};

#[derive(Debug)]
pub struct RootError;

impl fmt::Display for RootError {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt.write_str("root error")
    }
}

impl Error for RootError {}

fn main() {
    let mut report = Report::new(RootError).attach("attachment");

    let mut escaped: Vec<&mut Frame> = Vec::new();
    let _ = report.frames_mut(|frame| {
        escaped.push(frame);
        ControlFlow::Continue(())
    });
}