4 releases
0.2.1 | Sep 8, 2024 |
---|---|
0.2.0 | Sep 8, 2024 |
0.1.1 | Aug 11, 2024 |
0.1.0 | Aug 10, 2024 |
#272 in Cargo plugins
28 downloads per month
38KB
162 lines
cargo-testdox
A Cargo subcommand to print your Rust test names as sentences.
Installation
cargo install cargo-testdox
Usage
In any Rust project with tests, run:
cargo testdox
cargo-testdox
will first invoke cargo test
to run your tests, with any extra arguments that you give it. It will then show the result for each test (passed, failed, or ignored), with the test name formatted as a sentence. That is, with underscores replaced by spaces.
For example, the following test:
#[test]
fn it_works() {}
will produce this output when run with cargo-testdox
:
✔ it works
If the test were failing, it would produce:
x it works
If the test were ignored, it would produce:
? it works
Doctests are ignored, since they can't currently be named (pending RFC #3311).
Function names with underscores
To avoid underscores in a snake-case function name from being replaced, put _fn_
after the function name:
#[test]
fn print_hello_world_fn_prints_hello_world() {}
becomes:
✔ print_hello_world prints hello world
Why
Because test names should be sentences.
Compare gotestdox
, a similar tool for Go tests.
Dependencies
~2–13MB
~97K SLoC