喜欢的话别忘了点赞、收藏加关注哦(加关注即可阅读全文),对接下来的教程有兴趣的可以关注专栏。谢谢喵!(=・ω・=)
11.6.1. 控制测试的运行方式
cargo test
和cargo run
一样,cargo test
也会编译代码并生成一个二进制文件用于测试,只不过cargo test
是在测试模式下。
为cargo test
添加参数可以改变cargo test
的行为,如果不添加任何参数,那么就会执行默认行为:
- 并行运行所有测试
- 在测试通过的情况下,捕获(不显示)所有输出,使读取与测试结果相关的输出更容易。如果测试不通过,输出是会显示的,以便于程序员纠错。
命令行参数分为两类:
- 针对
cargo test
的参数,紧跟cargo test
后 - 针对生成的可执行文件:放在
--
之后。例如:cargo test --help
,这个参数会显示cargo test
所有可用的参数。cargo test -- --help
会显示所有能放在--
之后的参数,也就是所有针对可执行文件的参数。
11.6.2. 并行运行测试
在运行多个测试时默认会使用多个线程来并行地运行测试,这样运行得更快,但代价是这些测试之间不能有相互依赖,而且它们不依赖于某个共享状态(环境、工作目录、环境变量…)。
如果两个测试都依赖于某个共享的状态,其中一个测试运行完时把状态改了,那么其他共享了相同状态的测试就会受到影响。
如果不想并行地运行测试,或是希望精确地控制测试时所启用的线程数量,那就可以使用--test-threads
这个参数,这个参数时传递给二进制文件的。在这个参数后紧跟着线程的数量。
比如说cargo test -- --test-threads=1
就是使用一个线程(单线程),这样的话如果执行多个测试它会比并行测试花费更多的时间。但它也有优点,因为它是顺序执行,所以这些测试因为共享状态而出现干扰的情况就比较少了。
11.6.3. 显式函数输出
默认,如果测试通过,Rust的test
库会捕获(不显示)所有打印到标准输出的内容,比如说println!
输出的内容。如果测试不通过,就会显示打印的内容和失败信息。
看个例子:
fn prints_and_returns_10(a: i32) -> i32 {
println!("I got the value {a}");
10
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn this_test_will_pass() {
let value = prints_and_returns_10(4);
assert_eq!(value, 10);
}
#[test]
fn this_test_will_fail() {
let value = prints_and_returns_10(8);
assert_eq!(value, 5);
}
}
- 在被测试的函数
prints_and_returns_10
调用了println!
输出传入的值,然后返回10 - 测试函数
this_test_will_pass
传了4给被输出函数,所以被测试函数会打印4,然后又把函数固定的返回值与10比较。这个测试会成功。 - 测试函数
this_test_will_fail
传了8给被输出函数,所以被测试函数会打印8,然后又把函数固定的返回值与5比较。这个测试会失败。
测试结果:
$ cargo test
Compiling silly-function v0.1.0 (file:///projects/silly-function)
Finished `test` profile [unoptimized + debuginfo] target(s) in 0.58s
Running unittests src/lib.rs (target/debug/deps/silly_function-160869f38cff9166)
running 2 tests
test tests::this_test_will_fail ... FAILED
test tests::this_test_will_pass ... ok
failures:
---- tests::this_test_will_fail stdout ----
I got the value 8
thread 'tests::this_test_will_fail' panicked at src/lib.rs:19:9:
assertion `left == right` failed
left: 10
right: 5
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
tests::this_test_will_fail
test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass `--lib`
测试结果中没有成功的测试所打印的句子,但是有失败的测试打印的句子:“I got the value 8”。
如果你想让成功的测试也打印句子,就可以加一个参数:cargo test -- --show-output
,此时的输出如下:
$ cargo test -- --show-output
Compiling silly-function v0.1.0 (file:///projects/silly-function)
Finished `test` profile [unoptimized + debuginfo] target(s) in 0.60s
Running unittests src/lib.rs (target/debug/deps/silly_function-160869f38cff9166)
running 2 tests
test tests::this_test_will_fail ... FAILED
test tests::this_test_will_pass ... ok
successes:
---- tests::this_test_will_pass stdout ----
I got the value 4
successes:
tests::this_test_will_pass
failures:
---- tests::this_test_will_fail stdout ----
I got the value 8
thread 'tests::this_test_will_fail' panicked at src/lib.rs:19:9:
assertion `left == right` failed
left: 10
right: 5
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
tests::this_test_will_fail
test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass `--lib`