Cosmic Ray

Visit Website

Introduction

Cosmic Ray is a mutation testing tool for Python. It makes small changes to your source code, runs your test suite for each change, and reports which mutants survive.

A session is configured in TOML, initialised into a SQLite database of work items, and executed by local or distributed workers, which helps on large codebases. Operators include changing comparison and arithmetic operators, replacing constants and breaking out of loops. Filters skip code that should not be mutated, and reports come in text, HTML and other formats.

In the quality loop Cosmic Ray measures Python test effectiveness beyond coverage.

The source code is at sixty-north/cosmic-ray on GitHub under the MIT licence, with about 665 stars; the most recent commit was on 10 November 2026.

Features

1. Mutation operators: A broad set for Python.
2. Session database: Resumable runs in SQLite.
3. Distributed workers: Scale across machines.
4. Filters: Exclude code from mutation.
5. Reports: Text and HTML.
6. Test runner agnostic: Runs any test command.

Pros

1. Resumable: Long runs can be paused and continued.
2. Free to use: Open source under the MIT licence, so the core tool costs nothing to use.
3. Actively maintained: The repository had commits as recent as 10 November 2026.

Cons

1. Slow: Many mutants mean long runs.
2. Setup steps: More ceremony than mutmut.
3. Python 3.9+: Older versions unsupported.

Usage and Links (Example)

pip install cosmic-ray
cosmic-ray init config.toml session.sqlite
cosmic-ray exec config.toml session.sqlite
cr-report session.sqlite

Resources:

• Cosmic Ray website
• GitHub repository

Pricing

Cosmic Ray is free and open source under the MIT licence.

Recommended for?

1. Python teams with strong unit tests.
2. Large codebases needing distributed runs.

Conclusion

Cosmic Ray is a thorough, resumable mutation tester for Python.

Compare it with mutmut if you prefer less configuration.

On CheckOps, Cosmic Ray is filed under the Unit testing and Release & CI gates stages. Related tools listed here include mutmut, pytest, Hypothesis, StrykerJS, PIT (Pitest) and mutmut. Before standardising on one, compare recent maintenance activity, the pricing model as your usage grows, and the integrations you rely on today. Information on this page was verified against the official website, documentation and repository on 11 November 2026.