parameterized

基于过程宏的参数化测试库。当您想要运行具有许多不同输入集的测试用例时非常有用。

定义参数化测试用例时，应使用 #[parameterized(...)] 属性，而不是 #[test] 属性。

这个crate受到了JUnit @ParameterizedTest 的启发。

如果您考虑使用参数化，也可以查看 Yare，它是对 parameterized 的一种变体，它改变了参数的顺序，因此您可以定义自己的案例标识符。或者，还有 Sif，其中每个案例都可以由一个单独的 #[case(...)] 属性定义。

示例

更多示例可以在 parameterized-examples 仓库 中找到，以及在 测试 文件夹中。

enum Fruit {
    Apple,
    Bramble(BrambleFruit),
    Pear,
}

trait NameOf {
    fn name_of(&self) -> &str;
}

impl NameOf for Fruit {
    fn name_of(&self) -> &str {
        match self {
            Fruit::Apple => "apple",
            Fruit::Bramble(fruit) => fruit.name_of(),
            Fruit::Pear => "pear",
        }
    }
}

enum BrambleFruit {
    Blackberry,
}

impl NameOf for BrambleFruit {
    fn name_of(&self) -> &str {
        match self {
            BrambleFruit::Blackberry => "blackberry",
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use parameterized::parameterized;


    #[parameterized(fruit = {
        Fruit::Apple, Fruit::Pear, Fruit::Bramble(BrambleFruit::Blackberry)
    }, name = {
        "apple", "pear", "blackberry"
    })]
    fn a_fruity_test(fruit: Fruit, name: &str) {
        assert_eq!(fruit.name_of(), name)
    }
}

自定义测试属性（例如 tokio::test）

默认情况下，parameterized 属性的代码生成步骤将生成带有 #[test] 属性的测试用例。例如，对于下面的参数化测试用例 add5，以下代码将被生成

参数化测试用例

use parameterized::parameterized;

#[parameterized(input = {
    0, 1
}, expected = {
    5, 6
})]
fn add5(input: u32, expected: u32) {
    assert_eq!(input + 5, expected);
}

生成的代码

#[cfg(test)]
mod add5 {
    use super::*;

    #[test]
    fn case_0() {
        assert_eq!(0 + 5, 5);
    }

    #[test]
    fn case_1() {
        assert_eq!(1 + 5, 6);
    }
}

然而，有时我们可能需要不同的测试宏，例如使用#[tokio::test]。为了让#[parameterized]使用用户指定的测试宏，您可以在#[parameterized]属性之后添加#[parameterized_macro(...)]属性。由于在这个例子中我们使用了#[tokio::test]，因此我们也在函数签名中添加了async项（但当然，对于其他宏来说，这并非强制性的）。

使用#[parameterized_macro(...)]参数化的测试用例

#[parameterized(input = {
    0, 1
}, expected = {
    5, 6
})]
#[parameterized_macro(tokio::test)]
async fn add5(input: u32, expected: u32) {
    assert_eq!(input + 5, expected);
}

注意事项

• #[parameterized_macro(...)]必须在#[parameterized]属性之后指定
• 目前，每个参数化测试函数只支持一个#[parameterized_macro(...)]属性
• 虽然您可以通过导入重命名来重命名参数化属性（例如，使用use parameterized::parameterized as pm），但parameterized_macro属性不能重命名，因为它实际上没有被定义为单独的宏。相反，parameterized将这个属性也解析为参数化的一部分。

导入

如果您不想在每一个测试模块中导入这个库（使用use parameterized::parameterized;），您可以将以下代码片段放在crate根目录的顶部

#[cfg(test)]
#[macro_use]
extern crate parameterized;

fn squared(input: i8) -> i8 {
    input * input
}

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

    use parameterized::parameterized as pm;
    use parameterized::ide;
        
    mod squared_tests { // <--
        use super::*;

        ide!(); // <--
    
        #[pm(input = {
            -2, -1, 0, 1, 2
        }, expected = {
            4, 1, 0, 1, 4
        })]
        fn test_squared(input: i8, output: i8) {
            assert_eq(squared(input), output);
        }
    }
}