An extremely fast Python dead code finder, written in Rust.
Checking the whole CPython codebase (v3.15.0, about 2,300 Python files),
measured with scripts/benchmark.py.
- Fast: 20x faster than vulture, it checks all of CPython's Python code in under a second.
- Just works: built-in rules for pytest, Django, Flask, Pydantic, SQLAlchemy and more, so most projects need little or no configuration.
- Flexible: works for applications and libraries alike, see what counts as dead code.
- Modern: follows the conventions of Ruff and ty.
- Fits your workflow: runs with
uvx, as a pre-commit or prek hook, and in GitHub Actions.
Documentation: unref.readthedocs.io
Run it with uvx:
$ uvx unref
src/project/models.py:12:7: unused-class 'Account'
src/project/utils.py:40:5: unused-function 'parse_date'Or as a pre-commit or prek hook, alongside Ruff:
repos:
- repo: https://github.com/astral-sh/ruff-pre-commit
rev: v0.17.5
hooks:
- id: ruff-check
- id: ruff-format
- repo: https://github.com/Apakottur/unref-pre-commit
rev: v0.5.1
hooks:
- id: unrefBug reports and other feedback are welcome as issues. To contribute, see CONTRIBUTING.md.