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

Why

Because test names should be sentences.

Compare gotestdox, a similar tool for Go tests.