Пресет Python package / CLI

Орієнтир для міркувань, який процес онбордингу використовує для Python-пакетів і CLI-інструментів. Це чек-лист, а не шаблон — виявлена реальність важливіша.

Сигнали

pyproject.toml із точкою входу [project.scripts] (встановлюваний CLI).
CLI-фреймворк у залежностях: click, typer або argparse зі стандартної бібліотеки.
src-структура (src/<pkg>/) або кореневий пакет із __init__.py, cli.py/__main__.py і commands/.

Про що міркувати

Справжня перевірка валідації (ruff check, mypy, pytest) — фіксується дослівно, включно з будь-якою обгорткою Makefile/tox/hatch.
Назва точки входу консольного скрипта й структура команд і підкоманд.
Доречні для стека скіли: command-add, subcommand, option/flag та release, якщо пакет публікується в PyPI.

Примітки

Стабільність публічного API, текст довідки й коди виходу — це поверхні, видимі користувачеві; ставтеся до них як до стандартів.