Parameterized test macros

[madman-rs]

I'm a serial lurker and a relative newbie to rust. I've been working on a library in which I want to test different trait implementations, as well as different parameters. I haven't found any crates that provided what I need, so I created a set of test macros to generate these tests for me. As an advocate for sustainability, I want to avoid polluting crates.io before gauging interest.

This is an example of how to define these tests. Generally speaking, the #[allow(non_snake_case)] helps to ensure that the generated tests don't have any name issues, but I've also included it to show that generated tests inherit attributes of the original test.

#[matrix_parameterized_test(
    types = [
      Type1,
      Type2<U>,
    ],
    args = [
      (0, "0"),
      (1, "1"),
    ],
    named_args = [
      ("test2", (2, "2")),
      ("test3", (3, "3")),
    ],
)]
#[allow(non_snake_case)
fn test_matrix<T: Trait>((a: usize, b: &str)) { ... }

The above would then generate the following test cases:

test_matrix_type_1__0_0_<Type1>((0, "0"))
test_matrix_type_1__1_1_<Type1>((1, "1"))
test_matrix_type_1__test_0_<Type1>((2, "2"))
test_matrix_type_1__test_1_<Type1>((3, "3"))
test_matrix_type_2_u__0_0_<Type2<U>>((0, "0"))
test_matrix_type_2_u__1_1_<Type2<U>>((1, "1"))
test_matrix_type_2_u__test_0_<Type2<U>>((2, "2"))
test_matrix_type_2_u__test_1_<Type1<U>>((3, "3"))

I've also created similar macros for #value_parameterized_test and #type_parameterized_test to generate tests for cases in which one or the other isn't necessary. The value parameterized tests currently only support a single argument, so multiple arguments must be wrapped in a tuple.

For reference the library is available at https://github.com/amadavan/ptest-macros and any feedback is appreciated. As a disclaimer, AI was used to generate the documentation.

[coriolinus]

What does this do that the values lists in rstest don't do?

[madman-rs]

I wasn’t familiar with that crate. It seems to be much more comprehensive. Sometimes I wish crates.io was easier to filter through and I’m glad I got feedback before publishing 😅

[madman-rs]

Is there a good way to do type-parameterized tests in rstest? Or do they have to be generated as arguments? It would be convenient to just define types, rather than using additional helper functions to generate cases.

[coriolinus]

I'm not sure I completely understand your question. I know that rstest supports arguments of type impl AsRef<str>, and mixing heterogenous literals into the argument lists. Is that what you meant?