cargo-nextest

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

Features

Introduction - 图1

  • 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.
  • Detect flaky tests. Nextest can automatically retry failing tests for you, and if they pass later nextest will mark them as flaky.
  • Partition test runs across several CI jobs. If your tests take too long to run in CI, nextest can automatically split them up for you across several jobs.
  • Cross-platform. nextest works on Unix, 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 from crates.io (requires Rust 1.54 or later):

  1. cargo install cargo-nextest

Run all tests in a workspace:

  1. cargo nextest run

For more detailed installation instructions, see Installation and usage.

Crates in this project

Crate crates.io rustdoc (latest version) rustdoc (main)
cargo-nextest, the main test binary cargo-nextest on crates.io Documentation (latest release) Documentation (main)
nextest-runner, core nextest logic nextest-runner on crates.io Documentation (latest release) Documentation (main)
nextest-metadata, parsers for machine-readable output nextest-metadata on crates.io Documentation (latest release) Documentation (main)
quick-junit, JUnit XML serializer quick-junit on crates.io Documentation (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.