python-packaging
Полное руководство по созданию, структуре и публикации Python‑пакетов с использованием современных инструментов (pyproject.toml, wheel, PyPI).
Суть
Что это за skill и зачем он нужен
Навигация по всем этапам упаковки Python‑проекта: выбор структуры (src‑layout, flat‑layout, мульти‑пакет), описание современных стандартов (PEP 517/518, PEP 621, PEP 660), обзор популярных build‑backend’ов (setuptools, hatchling, flit, poetry), создание и настройка pyproject.toml, написание CLI (Click, argparse), сборка wheel и sdist, проверка пакета с помощью twine, публикация в TestPyPI и PyPI, автоматизация публикации через GitHub Actions, а также рекомендации по управлению версиями и токенами доступа.
Установка
Как установить
npx skills add https://github.com/wshobson/agents --skill python-packagingСценарии
Когда использовать
Подходит
- Создание переиспользуемой библиотеки, которую планируют распространять через PyPI или частный репозиторий.
- Разработка консольных утилит с точками входа (entry points).
- Нужна стандартизированная структура проекта и единый файл конфигурации pyproject.toml.
- Требуется автоматизированный процесс сборки и публикации (CI/CD).
- Необходимо управлять версиями пакета (статическая или динамическая).
- Планируется поддержка нескольких подпакетов или namespace‑пакетов.
Не подходит
- Для одноразовых скриптов или ноутбуков, которые не предполагают распространение как пакет.
- Если проект уже использует полностью настроенный процесс упаковки, не требующий дополнительного руководства.
- При работе с другими языковыми экосистемами, где Python‑упаковка не актуальна.
- Для проектов, требующих сложных C/C++ расширений, не покрытых базовыми примерами.
- Когда цель – только хранить код в репозитории без намерения публиковать его.
- Если требуется полностью кастомный build‑backend, не описанный в руководстве.
Доверие
Проверки безопасности
Проверка не нашла критичных проблем.
Проверка не нашла критичных проблем.
Низкий риск · проблем не найдено.
Предупреждений нет.
Оценка 93/100 · проанализировано 2 раздела.
Похожие