测试用例

概述

test_case Crate 提供了程序宏属性，用于生成参数化测试实例。

入门

必须将 Crate 添加到 Cargo.toml 的依赖项中

[dev-dependencies]
test-case = "*"

并将其导入到调用它的代码块的范围内（因为属性名称与 Rust 的内置 custom_test_frameworks 冲突）

use test_case::test_case;

示例用法

#[cfg(test)]
mod tests {
    use test_case::test_case;

    #[test_case(-2, -4 ; "when both operands are negative")]
    #[test_case(2,  4  ; "when both operands are positive")]
    #[test_case(4,  2  ; "when operands are swapped")]
    fn multiplication_tests(x: i8, y: i8) {
        let actual = (x * y).abs();

        assert_eq!(8, actual)
    }
}

此示例的 cargo test 输出

$ cargo test

running 4 tests
test tests::multiplication_tests::when_both_operands_are_negative ... ok
test tests::multiplication_tests::when_both_operands_are_positive ... ok
test tests::multiplication_tests::when_operands_are_swapped ... ok

test result: ok. 4 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out

测试矩阵

宏 #[test_matrix(...)] 允许通过每个测试函数参数的可能值的笛卡尔积生成多个测试用例。宏 test_matrix 的参数数量必须与测试函数的参数数量相同。每个宏参数可以是

1. A list in array (`[x, y, ...]`) or tuple (`(x, y, ...)`) syntax. The values can be any
   valid [expression](https://doc.rust-lang.org/reference/expressions.html).
2. A closed numeric range expression (e.g. `0..100` or `1..=99`), which will generate
   argument values for all integers in the range.
3. A single expression, which can be used to keep one argument constant while varying the
   other test function arguments using a list or range.

示例用法

#[cfg(test)]
mod tests {
    use test_case::test_matrix;

    #[test_matrix(
        [-2, 2],
        [-4, 4]
    )]
    fn multiplication_tests(x: i8, y: i8) {
        let actual = (x * y).abs();

        assert_eq!(8, actual)
    }
}

MSRV 政策

从版本 3.0 及以上开始，test-case 仅支持最新稳定的 Rust。这些更改可能会在夜间发生，因此如果您的工作栈落后于当前稳定版本，最好考虑在您的 Cargo.toml 中锁定 test-case 版本。

文档

最新文档可在我们的 wiki 上找到。

许可证

在 MIT 许可证下授权 (LICENSE-MIT 或 https://opensource.org/licenses/MIT)

贡献

项目路线图可在链接找到。欢迎所有贡献。

推荐工具

• cargo readme - 基于模板和lib.rs注释重新生成README.md
• cargo insta - 查看测试快照
• cargo edit - 添加/删除依赖项
• cargo fmt - 格式化代码
• cargo clippy - 提供所有洞察和建议
• cargo fix - 用于修复警告