cargo-nextest¶
Welcome to the home page for cargo-nextest, a next-generation test runner for Rust projects.
Features¶
- Clean, beautiful user interface
See which tests passed and failed at a glance.
- Up to 3x as fast as cargo test
Nextest uses a modern execution model for faster, more reliable test runs.
- Identify misbehaving tests
Treat tests as cattle, not pets. Detect slow tests and terminate them if they take too long.
- Customize settings by test
Automatically retry some tests, mark them as heavy, run them serially, and much more.
- Designed for CI
Set up CI configuration, reuse and partition tests across multiple workers, and output JUnit XML.
- Cross-platform
Use nextest on Linux, Mac, Windows, and elsewhere. Download binaries or build it from source.
- Open source, widely trusted
Nextest powers Rust development at every scale, from independent open source projects to the world's largest technology companies.
- State-of-the-art, made with love
Nextest brings infrastructure-grade reliability to test runners, with care about getting the details right.
Quick start¶
Install cargo-nextest for your platform using the pre-built binaries.
Run all tests in a workspace:
cargo nextest run
Note: Doctests are currently not supported because of limitations in stable Rust. For now, run doctests in a separate step with
cargo test --doc.
Crates in this project¶
| Crate | crates.io | rustdoc (latest version) | rustdoc (main) |
|---|---|---|---|
| cargo-nextest, the main test binary |  |
 |
 |
| nextest-runner, core nextest logic |  |
|
|
| nextest-metadata, parsers for machine-readable output |  |
|
|
| nextest-filtering, parser and evaluator for filtersets |  |
|
|
| quick-junit, JUnit XML serializer |  |
|
|
| datatest-stable, custom test harness for data-driven tests |  |
|
|
| future-queue, run queued futures with global and group limits |  |
|
|
Contributing¶
The source code for nextest and this site are hosted on GitHub, at https://github.com/nextest-rs/nextest.
Contributions are welcome! Please see the CONTRIBUTING file for how to help out.
License¶
The source code for nextest is licensed under the MIT and Apache 2.0 licenses.
This document is licensed under CC BY 4.0. This means that you are welcome to share, adapt or modify this material as long as you give appropriate credit.