• 测试
    • 参见：

    测试

    函数可以通过这些属性（attribute） 进行测试：

    • #[test] 将一个函数标记为一个单元测试。该函数不能接受参数且返回空。
    • #[should_panic] 将一个函数标记为 panic 测试。
    1. // 当且仅当测试套件没有运行时，才条件编译 `main` 函数。
    2. #[cfg(not(test))]
    3. fn main() {
    4.     println!("If you see this, the tests were not compiled nor ran!");
    5. }
    7. // 当且仅当测试套件运行时，才条件编译 `test` 模块。
    8. #[cfg(test)]
    9. mod test {
    10.     // 需要一个辅助函数 `distance_test`。
    11.     fn distance(a: (f32, f32), b: (f32, f32)) -> f32 {
    12.         (
    13.             (b.0 - a.0).powi(2) +
    14.             (b.1 - a.1).powi(2)
    15.         ).sqrt()
    16.     }
    18.     #[test]
    19.     fn distance_test() {
    20.         assert!(distance((0f32, 0f32), (1f32, 1f32)) == (2f32).sqrt());
    21.     }
    23.     #[test]
    24.     #[should_panic]
    25.     fn failing_test() {
    26.         assert!(1i32 == 2i32);
    27.     }
    28. }

    通过 cargo test 或 rustc --test 运行测试。

    1. $ rustc --test unit_test.rs
    2. $ ./unit_test 
    4. running 2 tests
    5. test test::distance_test ... ok
    6. test test::failing_test ... ok
    8. test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured

    若 --test 没有包含进来，则会出现这样的情况：

    1. $ rustc unit_test.rs
    2. $ ./unit_test
    3. If you see this, the tests were not compiled nor ran!

    参见：

    属性, 条件编译, 和 mod.