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
|
trackable
=========
[](https://crates.io/crates/trackable)
[](https://docs.rs/trackable)
[](https://github.com/sile/trackable/actions)
[](https://coveralls.io/github/sile/trackable?branch=master)
[](LICENSE)
`trackable` provides functionalities to define trackable objects and track those.
[Documentation](https://docs.rs/trackable)
Below code is an example that tracks failure of an I/O operation:
```rust
#[macro_use]
extern crate trackable;
use trackable::error::Failure;
fn foo() -> Result<(), Failure> {
track!(std::fs::File::open("/path/to/non_existent_file").map_err(Failure::from_error))?;
Ok(())
}
fn bar() -> Result<(), Failure> {
track!(foo())?;
Ok(())
}
fn baz() -> Result<(), Failure> {
track!(bar())?;
Ok(())
}
fn main() {
let result = baz();
assert!(result.is_err());
let error = result.err().unwrap();
assert_eq!(format!("\r{}", error), r#"
Failed (cause; No such file or directory)
HISTORY:
[0] at rust_out:<anon>:7
[1] at rust_out:<anon>:12
[2] at rust_out:<anon>:16
"#);
}
```
This example used the built-in `Failure` type, but you can easily define your own trackable error types.
See the documentaion of [error](https://docs.rs/trackable/0.2/trackable/error/index.html) module for more details.
|
