A working engineer's Python reference — uv, Ruff, pytest, mypy, pre-commit, rich, typer, and more.
Personal notes, configuration files, scripts, and snippets collected while getting productive with the modern Python toolchain. Covers uv (package & project manager), Ruff (linter/formatter), pytest, mypy (type checking), pre-commit, rich (terminal output), typer (CLI builder), pip-audit (vulnerability scanning), pipdeptree (dependency trees), py-spy (profiler), tox (test automation), httpie (API testing), ty (alternative type checker), uv.lock, and pyproject conventions. Written from the perspective of a working engineer who prefers plain language over marketing.
| Tool | Notes | Scripts | Configs | Snippets | Docs |
|---|---|---|---|---|---|
| uv | 4 | 2 | 1 | 1 | 1 |
| uv.lock | 2 | 2 | — | — | — |
| py | 2 | 1 | 1 | — | — |
| pyproject.toml | 2 | — | 2 | — | — |
| pytest | 2 | 1 | — | 1 | 1 |
| pre-commit | 2 | 1 | 2 | 1 | — |
| pip-audit | 2 | 2 | 1 | — | — |
| pipdeptree | 4 | 1 | — | 1 | — |
| mypy | 5 | 1 | 1 | 1 | — |
| rich | 5 | 1 | — | 4 | — |
| ty | 3 | — | 2 | 1 | — |
| typer | 2 | 2 | — | — | — |
| py-spy | 2 | 2 | — | 1 | — |
| httpie | 3 | 1 | — | — | — |
| tox | 2 | — | 1 | — | — |
| ruff | 3 | — | 1 | 1 | 1 |
- pipdeptree filtering notes — What tripped me up: filter by package, JSON format quirks, and handling missing deps
- pipdeptree JSON parser snippet — Parse pipdeptree JSON output and list leaf packages
- py-spy CPU-bound simulation — Minimal script simulating CPU-bound work for py-spy to sample
- mypy first check tripped me up — What caught me off guard on my first mypy check
- Ruff CLI exploration notes — CLI flags, output formats for check and format commands
| Directory | Contents |
|---|---|
00_index/ |
Navigation: quick-links.md, topics.md, glossary.md |
uv/ |
Notes, scripts, configs, and snippets for Astral's uv |
py/ |
Ruff and related Python tooling notes, scripts, configs |
pytest/ |
pytest testing framework notes and snippets |
pyproject.toml/ |
pyproject.toml configuration notes and examples |
uv.lock/ |
uv.lock lock file notes and scripts |
pre-commit/ |
Hook configs: snippets/, notes/, scripts/ |
pip-audit/ |
Vulnerability scanning notes and scripts |
pipdeptree/ |
Dependency tree notes and scripts |
mypy/ |
Type checking notes and test scripts |
rich/ |
Terminal output notes, scripts, and snippets |
ruff/ |
Linter/formatter notes, configs, and comparisons |
ty/ |
Type checker comparison notes and configs |
typer/ |
CLI framework notes and demos |
py-spy/ |
Profiler notes and scripts for py-spy |
httpie/ |
API testing CLI notes, scripts, and configs |
tox/ |
Test automation notes and configs for tox |
docs/ |
Project-level documentation (repository-structure.md) |
See docs/repository-structure.md for full details.
Building out first-contact notes across the Python toolchain. Recent additions cover pipdeptree JSON parsing, py-spy profiling snippets, mypy workflow notes, and Ruff CLI exploration. Actively working through notes for uv, pytest, and rich.
Last updated: 2026-06-07