peta

Human-friendly Python package metadata viewer. Think cargo info for Python.

peta shows detailed metadata for a Python package — from your local environment or from PyPI — with clean, Rich-formatted terminal output.

Features

• Local + remote — inspect installed packages or any package on PyPI
• Rich output — readable tables, panels, and trees
• Dependency listing — see a package's declared dependencies
• File listing — list files installed by a local package
• Version listing — browse published versions from PyPI
• Release artifacts — wheels, sdists, digests, compatibility, and provenance
• Structured output — Rich, plain text, versioned JSON, or Markdown

Installation

peta is an end-user CLI tool; install it into an isolated environment:

# Run without installing
uvx peta requests

# Install as a tool
uv tool install peta
pipx install peta

On macOS/Linux via Homebrew:

brew install hasansezertasan/tap/peta

On Windows via Scoop:

scoop bucket add hasansezertasan https://github.com/hasansezertasan/scoop-bucket
scoop install peta

Requires: Python 3.11+ (3.11 through 3.14 are tested; see supported Python versions)

Usage

Inspect another Python environment

info, compare, deps, files, and origin normally inspect the environment running peta. Pass --python PATH to inspect an explicit interpreter, or repeat --path to search explicit metadata directories:

peta info django --local --python .venv/bin/python
peta deps django --local --path .venv/lib/python3.14/site-packages
peta files django --python .venv/bin/python
peta origin django --python .venv/bin/python --verify
peta compare django flask --local --python .venv/bin/python

--path selects the metadata search directories. --python selects both the interpreter's search path and its marker environment; when both are supplied, the paths come from --path and markers come from --python. With only --path, markers come from the running interpreter. Peta never guesses a nearby .venv; human output and JSON identify the target and marker values.

peta requests                 # info (local first, falls back to PyPI)
peta info requests            # explicit info
peta info requests==2.31.0    # a specific version from PyPI
peta deps flask               # declared metadata tree
peta deps flask --why certifi # why is certifi pulled in?
peta files rich               # files installed locally
peta origin rich              # how it was installed, and do its files match?
peta versions httpx           # published versions on PyPI
peta artifacts cryptography   # what the latest release ships
peta artifacts numpy==2.3.0 --files --python 3.12
peta compare requests httpx   # side-by-side comparison plus semantic changes
peta compare django==5.2 django==6.0 --changes-only  # what an upgrade changes
peta requests --format json   # versioned machine-readable output
peta requests --json          # compatibility alias for --format json

Flags

License

MIT