Что советуют:
* зависимости можно указывать прямо в файле через inline metadata и запускать через
uv run* секреты не хардкодить, а брать из env,
getpass или системного keyring*
print() оставить для пользователя, logging — для отладки* env-переменные документировать в
--help* результат отдавать в
stdout, ошибки и логи — в stderr* поддерживать pipe через
stdin* завершаться нормальными exit code
* явно задавать приоритет конфигурации: CLI > env > config > default
Маленький скрипт тоже может быть удобным, безопасным и предсказуемым.
Особенно когда его через месяц запускает уже не автор, а кто-то другой.
https://www.bitecode.dev/p/scripting-good-practices-in-python