Stack:
Python package / CLI
Python-Package / CLI Preset
Ein Reasoning-Leitfaden, den der onboard-Ablauf für Python-Packages und CLI-Tools nutzt. Es ist eine Checkliste, keine Vorlage — die erkannte Realität gewinnt.
Signale
pyproject.tomlmit einem[project.scripts]-Entry-Point (eine installierbare CLI).- Ein CLI-Framework in den Abhängigkeiten:
click,typeroder das stdlib-argparse. - Ein src-Layout (
src/<pkg>/) oder ein Wurzel-Package mit__init__.py,cli.py/__main__.pyundcommands/.
Worüber nachzudenken ist
- Das echte Validierungs-Gate (
ruff check,mypy,pytest) — wortwörtlich erfasst, inklusive eines etwaigen Makefile-/tox-/hatch-Wrappers. - Der Name des Console-Scripts und die Befehls-/Unterbefehls-Struktur.
- Stack-passende Skills:
command-add,subcommand,option/flagundrelease, falls es auf PyPI veröffentlicht wird.
Hinweise
Die Stabilität der öffentlichen API, der Hilfetext und die Exit-Codes sind benutzersichtbare Oberflächen — behandeln Sie sie als Standards.