测试

函数可以通过这些属性（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.