测试用例

概述

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 - 修复警告