#error #failure #track #tracking #object #mechanism #backtracing

trackable

该库提供了一种手动跟踪对象的方法,作为类似回溯等机制的替代方案

38次发布 (4稳定)

使用旧的Rust 2015

1.3.0 2023年5月5日
1.2.0 2021年4月3日
1.1.0 2021年3月10日
1.0.0 2020年5月5日
0.1.6 2017年3月22日

#35 in 调试

Download history 49212/week @ 2024-03-14 44194/week @ 2024-03-21 39590/week @ 2024-03-28 49247/week @ 2024-04-04 48726/week @ 2024-04-11 52908/week @ 2024-04-18 47554/week @ 2024-04-25 44999/week @ 2024-05-02 51407/week @ 2024-05-09 50367/week @ 2024-05-16 44869/week @ 2024-05-23 45078/week @ 2024-05-30 46663/week @ 2024-06-06 54749/week @ 2024-06-13 50200/week @ 2024-06-20 47123/week @ 2024-06-27

208,841 每月下载量
用于 147 个crates (61 直接)

MIT 协议

48KB
801 代码行

trackable

Crates.io: trackable Documentation Actions Status Coverage Status License: MIT

trackable 提供定义可追踪对象和跟踪这些对象的功能。

文档

以下代码是一个跟踪I/O操作失败示例

#[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
"#);
}

此示例使用了内置的 Failure 类型,但你也可以轻松定义自己的可追踪错误类型。有关详细信息,请参阅 error 模块的文档。

依赖关系

~1.5MB
~36K SLoC