cargo-nextest

Welcome to the home page for cargo-nextest, a next-generation test runner for Rust projects.

Features

  • Clean, beautiful user interface. Nextest presents its results concisely so you can see which tests passed and failed at a glance.
  • Up to 60% faster than cargo test. Nextest uses a state-of-the-art execution model for faster, more reliable test runs.
  • Identify slow and leaky tests. Use nextest to detect misbehaving tests, identify bottlenecks during test execution, and optionally terminate tests if they take too long.
  • Filter tests using an embedded language. Use powerful filter expressions to specify granular subsets of tests on the command-line, and to enable per-test overrides.
  • Designed for CI. Nextest addresses real-world pain points in continuous integration scenarios:
  • Cross-platform. Nextest works on Linux and other Unixes, Mac and Windows, so you get the benefits of faster test runs no matter what platform you use.
  • ... and more coming soon!

Quick start

Install cargo-nextest for your platform using the pre-built binaries.

Run all tests in a workspace:

cargo nextest run

For more detailed installation instructions, see Installation.

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

Cratecrates.iorustdoc (latest version)rustdoc (main)
cargo-nextest, the main test binarycargo-nextest on crates.ioDocumentation (latest release)Documentation (main)
nextest-runner, core nextest logicnextest-runner on crates.ioDocumentation (latest release)Documentation (main)
nextest-metadata, parsers for machine-readable outputnextest-metadata on crates.ioDocumentation (latest release)Documentation (main)
nextest-filtering, parser and evaluator for filter expressionsnextest-filtering on crates.ioDocumentation (latest release)Documentation (main)
quick-junit, JUnit XML serializerquick-junit on crates.ioDocumentation (latest release)Documentation (main)

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.