测试用例

概述

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