Rust / 系统课时
补充测试用例
补充测试用例
本课为一个接收次数参数的 Rust 命令行程序补齐测试,覆盖正常解析、边界输入、错误分支和真实进程执行。完成后,你可以用一组稳定测试保护解析规则,并确认二进制程序的退出码、标准输出与错误输出都符合预期。
学习目标
- 使用单元测试覆盖解析逻辑、边界值和错误路径
- 使用集成测试启动真实二进制并断言退出码与输出
- 通过分层测试快速定位规则错误或命令执行问题
先划分测试边界
解析函数只负责把字符串转换为合法次数,适合用单元测试快速验证。命令入口还涉及参数读取、标准输出和退出码,需要用集成测试启动真实进程。两层测试分别保护业务规则与用户可见行为,失败时也更容易定位。
本例约定 count 必须是 1 到 1000 的整数。缺少参数、非数字、零和超过上限都属于错误输入,程序统一以退出码 2 结束。
建立可测试的命令结构
创建以下 Cargo.toml。assert_cmd 用于启动 Cargo 构建出的二进制,predicates 用于匹配输出文本。
[package]
name = "counter"
version = "0.1.0"
edition = "2021"
[dependencies]
[dev-dependencies]
assert_cmd = "2"
predicates = "3"配置生效后,cargo test 会自动编译开发依赖;它们不会进入正式运行时依赖。
将解析和命令逻辑放入 src/lib.rs,并在同一文件中编写单元测试。
pub fn parse_count(value: &str) -> Result<u32, String> {
let count = value
.parse::<u32>()
.map_err(|_| format!("count 必须是整数,收到:{value}"))?;
if count == 0 {
return Err("count 必须大于 0".to_owned());
}
if count > 1000 {
return Err("count 不能超过 1000".to_owned());
}
Ok(count)
}
pub fn execute(args: &[String]) -> Result<String, String> {
let raw = args
.get(1)
.ok_or_else(|| "缺少 count 参数".to_owned())?;
let count = parse_count(raw)?;
Ok(format!("将执行 {count} 次"))
}
#[cfg(test)]
mod tests {
use super::{execute, parse_count};
#[test]
fn parses_valid_boundaries() {
assert_eq!(parse_count("1"), Ok(1));
assert_eq!(parse_count("1000"), Ok(1000));
}
#[test]
fn rejects_invalid_values() {
assert_eq!(parse_count("0"), Err("count 必须大于 0".to_owned()));
assert_eq!(
parse_count("1001"),
Err("count 不能超过 1000".to_owned())
);
assert_eq!(
parse_count("abc"),
Err("count 必须是整数,收到:abc".to_owned())
);
}
#[test]
fn reports_missing_argument() {
let args = vec!["counter".to_owned()];
assert_eq!(execute(&args), Err("缺少 count 参数".to_owned()));
}
}再创建 src/main.rs。入口只负责收集参数、打印结果并映射退出码,不重复实现解析规则。
fn main() {
let args = std::env::args().collect::<Vec<_>>();
match counter::execute(&args) {
Ok(message) => println!("{message}"),
Err(error) => {
eprintln!("错误:{error}");
std::process::exit(2);
}
}
}补充完整命令执行测试
创建 tests/cli.rs。这里启动真实的 counter 进程,因此能发现入口未打印信息、退出码错误或标准输出通道用错等问题。
use assert_cmd::Command;
use predicates::prelude::*;
#[test]
fn runs_with_valid_count() {
let mut command = Command::cargo_bin("counter").unwrap();
command
.arg("3")
.assert()
.success()
.stdout(predicate::str::contains("将执行 3 次"));
}
#[test]
fn fails_when_argument_is_missing() {
let mut command = Command::cargo_bin("counter").unwrap();
command
.assert()
.code(2)
.stderr(predicate::str::contains("错误:缺少 count 参数"));
}依次运行库测试和命令集成测试。
cargo test --quiet --lib
cargo test --quiet --test cli预期输出
running 3 tests
...
test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in <TIME>
running 2 tests
..
test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in <TIME><TIME> 会随机器性能变化。若单元测试失败,优先检查解析规则;若只有集成测试失败,则检查入口、输出通道和退出码。
检查容易遗漏的边界
边界测试不应只验证“能成功”。至少要覆盖最小合法值、最大合法值、刚好越界、空参数和类型错误。错误断言应验证稳定且有意义的文本,但不要绑定编译器路径、系统临时目录等易变内容。
完整进程测试数量不宜过多,因为它比函数测试慢。核心规则用单元测试穷举,保留少量集成测试确认成功路径和代表性失败路径即可。
本课总结
- 单元测试适合保护解析规则、边界值和错误分支
- 集成测试应验证真实二进制的退出码、标准输出和错误输出
- 测试失败的位置可以帮助区分业务规则问题与命令入口问题
下一课预告
下一课将继续优化命令行工具的帮助信息、错误提示、日志输出和跨平台路径处理,让功能正确之外的使用体验也保持一致。