hoimin
hoimin is a mutation-testing CLI for Python. It makes small changes to copies of your source and runs your tests to find behavior they do not check.
Browse the searchable main documentation after its initial Pages activation. The existing references below remain available on GitHub. Maintainers can follow the publication guide.
Install
uv tool install --python 3.14 hoimin
Wheels require Python 3.14 and support macOS Apple Silicon, Linux x86_64
(glibc), and Windows x86_64. Run uv tool update-shell if hoimin is not on
PATH, then open a new shell.
Quick start
From your project directory, use a Python environment with your test dependencies
installed. Replace src/calc.py with the file you want to check:
hoimin run --root . --file src/calc.py --allow-best-effort-memory --format human -- python -m pytest -q
Everything after -- is your project's test command. hoimin runs it once as a
baseline, then for each selected mutation. Inspect surviving mutations to find
missing assertions or test cases. --allow-best-effort-memory permits execution
on macOS and Linux without delegated cgroup limits; see the
resource limits.
See the usage reference
for selectors and configuration, the
plan/verify workflow,
and results,
or run hoimin --help.
For questions and bug reports, see the reporting guide.
External Issues and pull requests are not accepted.
For maintainer development, see development
and building and releases.
Licensed under Elastic License 2.0. See licensing details.
1 maintainer
Metadata
1 maintainer
Release files for hoimin 0.4.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hoimin-0.4.4-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| hoimin-0.4.4-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| hoimin-0.4.4-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 19.5 MB
Release files / hoimin-0.4.4-py3-none-win_amd64.whl
| Download URL | hoimin-0.4.4-py3-none-win_amd64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
abbc29be5296a208879c3df67ff7cc03667451e7327ba03d4cdcd2efc56c0bff
|
|
BLAKE2b-256 checksum How to use checksums |
423b2b38ebaa3df15dfadfea324d80e3058a5d6064fbd86440bb2259d7afec88
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency log
SLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logRelease files / hoimin-0.4.4-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | hoimin-0.4.4-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
f8474f340f061e73d87fe41b39fc15f344f3e3e46017d2a97d53735dd00dd4dc
|
|
BLAKE2b-256 checksum How to use checksums |
06c8cd234f6d6e10607808d97bd2c82a324b59fd9af68cd16a3bf80d509e8b3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logSLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logRelease files / hoimin-0.4.4-py3-none-macosx_11_0_arm64.whl
| Download URL | hoimin-0.4.4-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ab2c4964115e92824ea6543e19778fa16370f7db2dfefdf2732e28068ae1bb8a
|
|
BLAKE2b-256 checksum How to use checksums |
f15730d6a950f86504a183ad859c2a35f10832e9c0d0af87835ad6073e8e2895
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logSLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency log
