🪚
poetry-udeps

poetry-udeps is inspired by cargo-udeps and is a tool for finding unused dependencies in a Poetry-based Python project. That is, finding unused dependencies in pyproject.toml.

Install

This tool expects that you run it where you have poetry on your $PATH.

From crates.io

cargo install poetry-udeps --locked

Usage

This is meant to be run in the root of your Poetry project.

``` Find unused dependencies in pyproject.toml

Usage: poetry-udeps [OPTIONS]

Options: -v, --verbose... More output per occurrence -q, --quiet... Less output per occurrence -e, --virtualenv Whether to look for dependency usage in the poetry virtualenv -d, --dev Whether to look for unused dependencies from dev-dependencies -h, --help Print help (see more with '--help') -V, --version Print version ```

Related Tools

• deptry (python): Find unused, missing and transitive dependencies in a Python project.
• pip-check-reqs (python): find packages that should be in requirements for a project

Benchmarks

TODO

Trophy Case

This is a list of cases where unused dependencies were found using poetry-udeps. You are welcome to expand it:

• TODO

License

This tool is distributed under the terms of the Blue Oak license. Any contributions are licensed under the same license, and acknowledge via the Developer Certificate of Origin.

See LICENSE for details.

Roadmap

• Better logging. E.g., the ability to increase verbosity and see where dependencies are referenced as they are removed from the set.
• Ability to distinguish if deps were removed from the set by the projects deps (i.e., during the venv scan), or by the project itself.
• Ability to parse jupyter notebooks. This would likely introduce a dependency like jupyter to use nbconvert. Lower priority.