编写测试函数
当使用Cargo创建lib类别的Rust包时,Cargo会为我们自动生成测试模块。下面是一个简单的测试例子:
#[cfg(test)]
mod tests {
#[test]
fn it_works() {
assert_eq!(2 + 2, 4);
}
}
测试函数需要使用#[test]属性进行标记。在测试函数中,使用assert_eq!宏来进行结果断言,从而验证被测试的代码是否符合预期。
使用cargo test运行测试
要运行所有测试,只需在项目根目录下运行以下命令:
$ cargo test
当测试用例较多时,你可能希望只运行部分测试或对输出结果进行特定的控制。这时,你可以使用命令行参数来实现。
控制测试行为
控制测试的并发行为
默认情况下,Rust以多线程的形式并行执行各个测试用例,如果你想要改变测试执行的并行程度,可以通过以下命令:
$ cargo test -- --test-threads=1
这里的--test-threads=1告诉测试程序以单线程执行所有测试。
显示测试函数中的输出
如果你希望在测试成功时也能看到println!等宏的输出内容,你可以使用以下命令:
$ cargo test -- --show-output
运行特定的测试
如果你只想运行名称中包含指定关键字的测试用例,你可以通过名称来过滤测试:
$ cargo test add
上面的命令仅运行名称中包含add字符串的测试用例。
处理panic的测试
在Rust中,我们还可以测试那些预期会发生panic的代码。当你的函数在某些条件下应该触发panic时,这会非常有用:
#[cfg(test)]
mod tests {
#[test]
#[should_panic]
fn test_panic() {
assert!(false, "This test should panic");
}
}
通过使用#[should_panic]属性,你可以指定一个测试函数应当触发panic。
自定义panic信息
对于需要具体panic信息的情况,我们可以使用expected参数,如下所示:
#[cfg(test)]
mod tests {
#[test]
#[should_panic(expected = "specific error message")]
fn test_panic_with_message() {
panic!("specific error message");
}
}
这样你就可以指定期望触发的具体panic信息。
使用Result测试错误
除了使用panic!进行测试之外,你还可以返回Result
#[cfg(test)]
mod tests {
#[test]
fn test_result() -> Result<(), String> {
if 2 + 2 == 4 {
Ok(())
} else {
Err(String::from("two plus two does not equal four"))
}
}
}
如果测试失败,将返回一个包含错误信息的Err值。
通过上述深入的讲解和丰富的示例,相信你已经对Rust中的测试有了较为全面的理解。现在,应用这些知识点到你的Rust项目中,可以让你的代码更加稳健,降低潜在的错误和问题。