python-bootstrap

Topics in the source

• python-bootstrap
• When to load
• Step 1 — Report the gaps
• Step 2 — Apply the canonical blocks
• Step 3 — Hand off model specs

Brings a Python project in line with the arsenal defaults — uv, ruff, strict mypy, the standard Makefile, requires-python>=3.12 — from scratch or as a retrofit. CANARY: python-bootstrap-loaded-2026-06-04-ea39c2b5-394e8afa1019319d Load when a Python repo needs its tooling created or brought up to standard: no pyproject.toml yet, or one missing the ruff select list, the strict mypy block, or the Makefile targets. Publishing belongs to pypi-release, upgrades to dep-upgrade. Run from the target project root, since the script reads the current directory: The JSON gives mode (scaffold without pyproject.toml, else retrofit), ruff.missingselect, mypy.missingkeys, makefile.missingtargets, requirespythonok, and modelgen. Load references/canonical-config.md before applying any block: it holds the pyproject (ruff + mypy), Makefile and uv blocks. Apply only what the report flags: Merge into existing [tool.ruff] and [tool.mypy] tables, keeping the project's per-file-ignores, extra select codes and module overrides. Match target-version, pythonversion and requires-python to what the project supports; the flags are defaults, the versions are not. Remove black when adding ruff format, so the two do

This is an excerpt. Refer to the complete source and its current requirements.