Загрузка…
Короткая голосовая сессия: один вопрос, один уточняющий вопрос, затем мгновенный фидбек — до 5 минут.
Держать небольшой явный публичный API с понятными границами модулей и type hints, следовать semantic versioning, перед удалением объявлять устаревание через предупреждения и заметки о миграции и тестировать в CI на поддерживаемых версиях Python и зависимостей.
Всё, что можно импортировать, обычно становится публичным, поэтому помечайте внутренние части ведущим подчёркиванием, задавайте экспорт в init и all и документируйте, что поддерживается. Поставляйте type hints с маркером py.typed, чтобы потребители получали статическую проверку. Используйте semantic versioning: patch — для исправлений, minor — для совместимых возможностей, major — для breaking changes. Перед удалением выдавайте DeprecationWarning хотя бы в течение одного minor-релиза, предоставляйте замену и руководство по миграции и рассматривайте автоматические codemods для крупных миграций. Держите диапазоны версий зависимостей достаточно широкими, чтобы не конфликтовать с другими пакетами потребителей, тестируйте матрицу версий Python и зависимостей и публикуйте wheels во внутренний package index. Учёт того, какие сервисы используют какую версию, помогает спланировать окончательное удаление.