error-trace 4.0.0

Small Rust crate for printing nice errors traits based on `std::error::Error::source()`.
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//  TRACE.rs
//    by Lut99
//
//  Created:
//    22 Sep 2023, 12:47:16
//  Last edited:
//    22 Sep 2023, 12:49:02
//  Auto updated?
//    Yes
//
//  Description:
//!   Shows how one might normally use the [`error_trace`] crate.
//

use std::error::Error;
use std::fmt::{Display, Formatter, Result as FResult};

use error_trace::ErrorTrace as _;



/***** ERRORS *****/
#[derive(Debug)]
struct SomeError {
    msg: String,
}
impl Display for SomeError {
    fn fmt(&self, f: &mut Formatter<'_>) -> FResult { write!(f, "{}", self.msg) }
}
impl Error for SomeError {}

#[derive(Debug)]
struct HigherError {
    msg:   String,
    child: SomeError,
}
impl Display for HigherError {
    fn fmt(&self, f: &mut Formatter<'_>) -> FResult { write!(f, "{}", self.msg) }
}
impl Error for HigherError {
    fn source(&self) -> Option<&(dyn 'static + Error)> { Some(&self.child) }
}




/***** ENTRYPOINT *****/
fn main() {
    // Create the tiered error
    let err = HigherError { msg: "Oh no, something went wrong!".into(), child: SomeError { msg: "A specific reason".into() } };

    // Show it nicely!
    eprintln!("{}", err.trace());
}