pip-weigh 0.1.0

Know the cost of your imports - Audit your dependencies before you commit

pip-weigh 📦⚖️

"Know the cost of your imports."

A CLI tool that measures the true disk size of Python packages, including all their dependencies. Perfect for optimizing Docker images, Lambda functions, and understanding your dependency footprint.

Features

• 🔍 Accurate Size Analysis - Measures the real disk footprint of packages and all dependencies
• 🌐 Cross-Platform Analysis - Check Linux package sizes from macOS/Windows (great for Docker planning)
• 🐍 Python Version Support - Analyze sizes across different Python versions
• 📊 Beautiful Output - Rich terminal output with dependency trees
• 🔄 CI/CD Ready - JSON output and budget checks for pipelines
• ⚡ Fast - Leverages uv's speed and caching

Installation

pip install pip-weigh

Or with uv:

uv pip install pip-weigh

Requirements

• Python 3.9+
• uv must be installed and available in PATH

Usage

Basic Usage

pip-weigh pandas

Output:

Package: pandas (2.1.4)
├── Total Size: 138 MB
├── Self Size: 45 MB
└── Dependencies (Recursive):
    ├── numpy (1.26.2): 85 MB
    ├── pytz (2023.3): 5 MB
    └── python-dateutil: 3 MB

Cross-Platform Analysis

Check what the size would be on Linux (great for Docker):

pip-weigh torch --platform linux

Multiple Packages

pip-weigh pandas numpy requests

JSON Output (for CI/CD)

pip-weigh pandas --json

Budget Check

Fail if package exceeds a size limit:

pip-weigh pandas --budget 100MB
# Exit code 1 if exceeded

Specify Python Version

pip-weigh pandas --python 3.12

CLI Options

Option	Short	Description
--platform	-p	Target platform (linux, macos, windows)
--python		Python version to analyze (e.g., 3.11)
--json	-j	Output as JSON
--budget	-b	Maximum allowed size (e.g., 100MB, 1GB)
--no-deps		Show only the package itself, not dependencies
--verbose	-v	Show detailed output
--help	-h	Show help message

How It Works

1. Creates a temporary isolated environment using uv
2. Installs the target package(s) with all dependencies
3. Parses uv.lock to get the complete dependency tree
4. Scans .dist-info/RECORD files for accurate file-to-package mapping
5. Calculates logical sizes (important for Docker/Lambda accuracy)
6. Presents results with a beautiful dependency tree

Why Logical Size Matters

uv uses hardlinks from a global cache, so disk usage tools might show misleading numbers. pip-weigh always reports the logical size - the actual bytes your package would consume in a Docker image or cloud function.

License

MIT