Metadata-Version: 2.5
Name: unref
Version: 0.0.1
Summary: Find unreferenced Python code
Project-URL: homepage, https://github.com/Apakottur/unref
Project-URL: repository, https://github.com/Apakottur/unref
Author: Yossi Rozantsev
License-Expression: MIT
License-File: LICENSE
Keywords: dead-code,linter,static-analysis,unused-code
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown

[![image](https://img.shields.io/pypi/v/unref.svg)](https://pypi.python.org/pypi/unref)
[![image](https://img.shields.io/pypi/l/unref.svg)](https://github.com/Apakottur/unref/blob/main/LICENSE)
[![image](https://img.shields.io/pypi/pyversions/unref.svg)](https://pypi.python.org/pypi/unref)

# unref

Find unreferenced Python code.

`unref` reports the functions, classes and methods in a Python codebase that nothing references.

> [!NOTE]
> `unref` is in early development and does not do anything useful yet.

## Why

Finding dead code needs whole-program analysis: a function is unused only if no file in the project
references it. [Ruff](https://docs.astral.sh/ruff/) analyses one file at a time and does not have this
feature yet, see [astral-sh/ruff#872](https://github.com/astral-sh/ruff/issues/872).

Use `unref` today, and migrate when Ruff ships it.

## Contributing

See [CONTRIBUTING.md](https://github.com/Apakottur/unref/blob/main/CONTRIBUTING.md).
