Skip to main content

image image image image

unref

An extremely fast Python dead code finder, written in Rust.

Time to check CPython with unref and other dead code finders

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)

Source distribution for unref 0.3.0
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)

Table of built distributions (wheels) for unref 0.3.0
File Actions
unref-0.3.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for unref-0.3.0-py3-none-win_arm64.whl
unref-0.3.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for unref-0.3.0-py3-none-win_amd64.whl
unref-0.3.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for unref-0.3.0-py3-none-musllinux_1_2_x86_64.whl
unref-0.3.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for unref-0.3.0-py3-none-musllinux_1_2_aarch64.whl
unref-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for unref-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
unref-0.3.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for unref-0.3.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
unref-0.3.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for unref-0.3.0-py3-none-macosx_11_0_arm64.whl
unref-0.3.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for unref-0.3.0-py3-none-macosx_10_12_x86_64.whl

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page