snafu-tracing 0.8.3

Snafu tracing is an error handling mechanism with pseudo-stack traces implemented through SNAFU, the proc macro trace_error, and the DebugTrace trait, inspired by GreptimeDB.
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

# snafu-tracing

Snafu tracing is an error handling mechanism with pseudo-stack traces implemented through SNAFU, the proc macro trace_error, and the DebugTrace trait, inspired by GreptimeDB.

## Example

```rust
use snafu::Snafu;
use snafu_tracing::{DebugTrace, trace_error, quick_tracing};

pub type Result<T, E = Error> = std::result::Result<T, E>;

#[trace_error]
#[derive(Snafu, DebugTrace)]
#[snafu(module, context(suffix(false)), visibility(pub))]
pub enum Error {
    #[snafu(display("{_error}"))]
    Any { _error: String },
    #[snafu(display("{error_source}"))]
    Wrap {
        #[snafu(source(from(Box<dyn std::error::Error + Send + Sync>, |e| e)))]
        error_source: Box<dyn std::error::Error + Send + Sync>,
    },
}

quick_tracing!(anyerr, crate::error::Any);

pub fn hello_err() -> Result<()> {
    let _e = anyerr!("Any error test! {}", 123);
    Err(anyerr!("Any error test!"))
}

fn main() {
    let e = hello_err();
    println!("{:?}", e);
}
```

Or refer to: [full example](https://github.com/dancingpeanut/snafu-tracing/tree/master/example)

## References

1. [Rust 错误处理在 GreptimeDB 的实践](https://mp.weixin.qq.com/s/PK38PtvAETD7pcHeqeDSTA)
   (Rust error handling practice in GreptimeDB). Strongly recommended. Google
   translation should be enough for non-Chinese speakers.