unref
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
Getting Started
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.4
hooks:
- id: ruff-check
- id: ruff-format
- repo: https://github.com/Apakottur/unref
rev: v0.2.0 # Or run `pre-commit autoupdate`.
hooks:
- id: unref
Contributing
False positives and other bugs are welcome as issues. To contribute code, see CONTRIBUTING.md.
Metadata
Release files for unref 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| unref-0.3.0.tar.gz | 226.7 kB | Without provenance | Details for unref-0.3.0.tar.gz |
Built distributions (wheels)
Total release size: 20.4 MB
Release files / unref-0.3.0.tar.gz
| Download URL | unref-0.3.0.tar.gz |
|---|---|
| Size | 226.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
54b1060573b221ee41154ba02ab57f34e3182ed844010b6ef5c983a3e23aa1d2
|
|
BLAKE2b-256 checksum How to use checksums |
ea5694a734828acd85ca9d092df22e92722697fb0ba2a4c0c7bb17071f4815d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-win_arm64.whl
| Download URL | unref-0.3.0-py3-none-win_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
5b5b364276fc877c265a423eb0319caf7ae1dc6850d49a521884aed47a29e9c8
|
|
BLAKE2b-256 checksum How to use checksums |
a261a85ee8ce3ed6298c3b0b14c33d00399e2a2fa2e21367f8ca2ec43dc13d0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-win_amd64.whl
| Download URL | unref-0.3.0-py3-none-win_amd64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
11624c585fcf0ac8c95640056a76975a656e319b125763bf1743592403b29a48
|
|
BLAKE2b-256 checksum How to use checksums |
997e7f41e6fc0370f1bfa99b712096102b553beef8e2b1b377df1311b7de7e19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-musllinux_1_2_x86_64.whl
| Download URL | unref-0.3.0-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
05ed3c1a606bc958efbad440bf445de78697a53e0d1bd52a4b3f859472ec864c
|
|
BLAKE2b-256 checksum How to use checksums |
29fef77935e46d30668d6b689937b32d566775b34c60a52c803dd06a8fe89307
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-musllinux_1_2_aarch64.whl
| Download URL | unref-0.3.0-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
f91b3fc94a87b1b248701c1e0dee7f72d0b34a279e83f6aa59ce50b8cb206160
|
|
BLAKE2b-256 checksum How to use checksums |
f2faf088e4fbf3153e16e8c47cca75b8c13f683198180580c35f3bb78be9b275
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | unref-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
c33b80396133d09d5f55fd71b921c3ed38aceb18e0c15e769d0a4ad184c2717f
|
|
BLAKE2b-256 checksum How to use checksums |
8854f9feba4fcfcaee220cd0f1c9cba5d0f9024a25f559cbef81683d56d45880
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | unref-0.3.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
53f782cac9135874df49eb377b74e78cc1d05cb5da45481fe0d0f965c9ab481d
|
|
BLAKE2b-256 checksum How to use checksums |
5cad083b655aa758d6816999b5b0e935c2e3674d6598e6cd8f46fe41a0b92305
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-macosx_11_0_arm64.whl
| Download URL | unref-0.3.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
fe6e042b658d6984ae9e7b8d9eb13aafa7bf1804d9b33b25a08cb59392807dbc
|
|
BLAKE2b-256 checksum How to use checksums |
9ec1a715f0e9d3ea3f8054da77a5972ee50dcbd55848cc5fbe87786e07ef70cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / unref-0.3.0-py3-none-macosx_10_12_x86_64.whl
| Download URL | unref-0.3.0-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
da4040e9dc5eec062c9a03aadc8db02ccafda017ff751285b9ab1fff49173d34
|
|
BLAKE2b-256 checksum How to use checksums |
ef51e96991991f9d041bc9df96ccd976bf37f15eb8579f4c3d1da91f0628a4c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for unref 0.3.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.