Unpack python packages from your project and more.
Unpack has a few goals:
- To easily navigate and remove used, unused, and untracked python packages.
- To quickly identify disk usage of packages in the above categories.
- To view the relationship between various packages and their dependencies.
To achieve those, Unpack:
- Collects all project imports by walking the abstract syntax tree.
- Collects all declared dependencies from the dependency specification file.
- Maps local environment site-packages to resolve dependencies and the imports they expose.
- Identifies local site-package dependencies as to not accidently remove actively used dependencies of other packages.
- Calculates package(s) size, and total disk usage.
-
-used
is when the package is locally installed, one of it's aliases is actively used in the project, and a corresponding dependency is declared inpyproject.toml
orrequirements.txt
. This state indicates a fully integrated and properly managed package. -
-unused
is when the package is locally installed, and a corresponding dependency is declared inpyproject.toml
orrequirements.txt
, but is not actively used in the project. Caveat: This package must not be a dependency of any actively-used
package to be considered unused. -
-untracked
is when the package is installed, and one of it's aliases is actively used in the project, but is not declared inpyproject.toml
orrequirements.txt
. This highlights packages that are implicitly used but not formally declared, which may lead to inconsistencies or issues in dependency management and deployment.
❯ unpack
📦 Unused Packages
package | version | size
-------------- -------------- ----------
scikit-learn | ^1.4.1.post1 | 33.2 MiB
pydantic | ^1.9.0 | 7.2 MiB
keras | ^3.0.5 | 3.9 MiB
💽 Total disk space: 44.3 MiB
Note: There might be false-positives.
For example, Unpack cannot detect usage of packages that are not imported under `[tool.poetry.*]`.
Similarly, it can only detect declared packages in requirements.txt or pyproject.toml.
For more documentation, please refer to the unpack crate documentation
You can install unpack
with Homebrew
brew tap bnkc/tap
brew install unpack
… or with MacPorts:
sudo port install [COMING SOON]
cargo install un-pack --locked
Alternatively, you can install unpack
directly from the repository by using:
git clone https://github.com/bnkc/unpack
cargo install --path ./unpack
Warning
There are scenarios where using Unpack
can yield false positives. Mapping site-packages
to their corresponding
dependencies/imports are not always a 1:1 relationship. For Example: scikit-learn
is imported as sklearn
.
Alot of decisions were made based on Metadata for Python Software Packages
This is the output of un-pack -h
. To see the full set of command-line options, use un-pack --help
which
also includes a much more detailed help text.
Usage: un-pack [OPTIONS]
Options:
-b, --base-directory <BASE_DIRECTORY>
The path to the directory to search for Python files. [default: .]
-s, --package-status <STATUS>
Select the packages status to search for [default: unused] [possible values: used,
unused, untracked]
-i, --ignore-hidden
Ignore hidden files and directories.
-d, --max-depth <DEPTH>
Set maximum search depth (default: none)
-o, --output <OUTPUT>
The output format to use allows for the selection of the output format for the results
of the unused packages search. The default output format is `human`. The `json` format
is also available [default: human] [possible values: human, json]
-t, --dep-type <DEP_TYPE>
Select the depencency specification file of choice if more than one exists. By default,
`pyproject.toml` is selected [default: poetry] [possible values: pip, poetry]
-h, --help
Print help (see more with '--help')
-V, --version
Print version
Unpack is very much a labor of love. There's alot of improvements that could be done, but if you find this project useful, PM me!
If you'd like to contribute to Unpack, please open an issue/PR ❤️