Skip to content

🧟 `cargo mutants` mutation testing for Rust

License

Notifications You must be signed in to change notification settings

yining/cargo-mutants

This branch is 987 commits behind sourcefrog/cargo-mutants:main.

Folders and files

NameName
Last commit message
Last commit date
May 5, 2023
Jul 25, 2022
Aug 28, 2023
May 2, 2023
Aug 21, 2023
Oct 28, 2021
Jun 11, 2023
Jun 11, 2023
Jun 11, 2023
May 27, 2023
May 27, 2023
May 27, 2023
Feb 16, 2022
Aug 14, 2022
May 27, 2023
Aug 20, 2022
May 5, 2023
Aug 12, 2023
Jun 11, 2023
Jun 11, 2023
Oct 25, 2021
Jun 11, 2023
Apr 26, 2023
Aug 8, 2022

Repository files navigation

cargo-mutants

https://github.com/sourcefrog/cargo-mutants

Tests crates.io libs.rs

cargo-mutants is a mutation testing tool for Rust. It helps you improve your program's quality by finding functions whose body could be replaced without causing any tests to fail.

Coverage measurements can be helpful, but they really tell you what code is reached by a test, and not whether the test really checks anything about the behavior of the code. Mutation tests give different information, about whether the tests really check the code's behavior.

The goal of cargo-mutants is to be easy to run on any Rust source tree, and to tell you something interesting about areas where bugs might be lurking or the tests might be insufficient.

The main documentation is the user guide at https://mutants.rs/.

Install

cargo install --locked cargo-mutants

Quick start

From within a Rust source directory, just run

cargo mutants

Project status

As of April 2023 this is an actively-maintained spare time project. It is very usable as it is and there is room for future improvements, especially in adding new types of mutation.

I expect to make releases about every one or two months, depending on how much time and energy I have available.

Constructive feedback is welcome but there is absolutely no warranty or guarantee of support.

Further reading

The main documentation is the user guide at https://mutants.rs/.

See also:

About

🧟 `cargo mutants` mutation testing for Rust

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 99.8%
  • Dockerfile 0.2%