Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
January 17, 2023 11:19
December 30, 2018 10:06
December 30, 2018 23:25
January 17, 2023 11:19


Version Downloads Docs MIT license Build Status MSRV: 1.51.0

serial_test allows for the creation of serialised Rust tests using the serial attribute e.g.

fn test_serial_one() {
  // Do things

fn test_serial_another() {
  // Do things

async fn test_serial_another() {
  // Do things asynchronously

Multiple tests with the serial attribute are guaranteed to be executed in serial. Ordering of the tests is not guaranteed however. Other tests with the parallel attribute may run at the same time as each other, but not at the same time as a test with serial. Tests with neither attribute may run at any time and no guarantees are made about their timing!

For cases like doctests and integration tests where the tests are run as separate processes, we also support file_serial, with similar properties but based off file locking. Note that there are no guarantees about one test with serial and another with file_serial as they lock using different methods, and parallel doesn't support file_serial yet (patches welcomed!).


We require at least Rust 1.51. Upgrades to this will require at a major version bump.

Add to your Cargo.toml

serial_test = "*"

plus use serial_test::serial; (for Rust 2018) or

extern crate serial_test;

for earlier versions.

You can then either add #[serial] or #[serial(some_text)] to tests as required.