Rust / 系统课时

补充测试用例

补充测试用例

本课为一个接收次数参数的 Rust 命令行程序补齐测试,覆盖正常解析、边界输入、错误分支和真实进程执行。完成后,你可以用一组稳定测试保护解析规则,并确认二进制程序的退出码、标准输出与错误输出都符合预期。

学习目标

  • 使用单元测试覆盖解析逻辑、边界值和错误路径
  • 使用集成测试启动真实二进制并断言退出码与输出
  • 通过分层测试快速定位规则错误或命令执行问题

先划分测试边界

解析函数只负责把字符串转换为合法次数,适合用单元测试快速验证。命令入口还涉及参数读取、标准输出和退出码,需要用集成测试启动真实进程。两层测试分别保护业务规则与用户可见行为,失败时也更容易定位。

本例约定 count 必须是 1 到 1000 的整数。缺少参数、非数字、零和超过上限都属于错误输入,程序统一以退出码 2 结束。

建立可测试的命令结构

创建以下 Cargo.toml。assert_cmd 用于启动 Cargo 构建出的二进制,predicates 用于匹配输出文本。

toml
[package]
name = "counter"
version = "0.1.0"
edition = "2021"

[dependencies]

[dev-dependencies]
assert_cmd = "2"
predicates = "3"

配置生效后,cargo test 会自动编译开发依赖;它们不会进入正式运行时依赖。

将解析和命令逻辑放入 src/lib.rs,并在同一文件中编写单元测试。

rust
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。入口只负责收集参数、打印结果并映射退出码,不重复实现解析规则。

rust
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 进程,因此能发现入口未打印信息、退出码错误或标准输出通道用错等问题。

rust
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 参数"));
}

依次运行库测试和命令集成测试。

bash
cargo test --quiet --lib
cargo test --quiet --test cli

预期输出

text
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> 会随机器性能变化。若单元测试失败,优先检查解析规则;若只有集成测试失败,则检查入口、输出通道和退出码。

检查容易遗漏的边界

边界测试不应只验证“能成功”。至少要覆盖最小合法值、最大合法值、刚好越界、空参数和类型错误。错误断言应验证稳定且有意义的文本,但不要绑定编译器路径、系统临时目录等易变内容。

完整进程测试数量不宜过多,因为它比函数测试慢。核心规则用单元测试穷举,保留少量集成测试确认成功路径和代表性失败路径即可。

本课总结

  • 单元测试适合保护解析规则、边界值和错误分支
  • 集成测试应验证真实二进制的退出码、标准输出和错误输出
  • 测试失败的位置可以帮助区分业务规则问题与命令入口问题

下一课预告

下一课将继续优化命令行工具的帮助信息、错误提示、日志输出和跨平台路径处理,让功能正确之外的使用体验也保持一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

补充测试用例

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通