Python Package Contract

Current package surface:

• package: mercury
• dev version on main: 0.0.0.dev0
• Python: >=3.12
• build backend: hatchling
• runtime dependency: typer>=0.24
• optional extras: extras and dev

The package exposes one console script:

[project.scripts]
mercury = "mercury.cli:app"

• uv run mercury

• python -m mercury

• uvx mercury after publishing a release and configuring indexes correctly

• current behavior: read JSON from stdin and pretty-print it

• tests cover version output, passthrough, pretty printing, and invalid JSON failure

Follow-On Docs

• develop-locally — running the in-tree package during development
• run-released-package — running the latest built release via uv
• interview-repo-architecture — why the shipped app surface stays intentionally small