Распространение модулей Python

Основные термины

• Индекс пакетов Python (Python Packaging Index) — это публичный репозиторий пакетов с открытым исходным кодом, доступных для использования другими пользователями Python
• Группа разработчиков и авторов документации по Python Packaging Authority отвечает за поддержку и развитие стандартных инструментов упаковки, а также связанных стандартов метаданных и форматов файлов. Они поддерживают различные инструменты, документацию и трекеры проблем на GitHub и Bitbucket.
• distutils — это оригинальная система сборки и распространения, впервые добавленная в стандартную библиотеку Python в 1998 году. Хотя прямое использование distutils постепенно отмирает, оно всё же заложило основу для текущей инфраструктуры упаковки и распространения, и оно не только остаётся частью стандартной библиотеки, но и его имя сохраняется и другими способами (например, в названии почтовой рассылки, используемой для координации разработки стандартов упаковки Python).
• setuptools — это (в основном) замена distutils, опубликованная в 2004 году. Самое заметное добавление по сравнению с немодифицированными distutils инструментами — это возможность объявления зависимостей от других пакетов. В настоящее время рекомендуется как более регулярно обновляемая альтернатива distutils, которая обеспечивает согласованную поддержку более современных стандартов упаковки в широком диапазоне версий Python.
• wheel (в данном контексте) — это проект, который добавляет команду bdist_wheel в distutils/setuptools. Это создаёт кроссплатформенный двоичный формат упаковки (называемый «wheels» или «wheel файлы», определённый в PEP 427), позволяющий устанавливать библиотеки Python, даже те, которые включают двоичные расширения, на систему без необходимости локальной сборки.

Лицензирование с открытым исходным кодом и сотрудничество

В большинстве стран программное обеспечение автоматически подпадает под действие авторского права. Это означает, что другие разработчики требуют явного разрешения на копирование, использование, модификацию и повторное распространение программного обеспечения.

Лицензирование с открытым исходным кодом — это способ явного предоставления такого разрешения относительно согласованным образом, что позволяет разработчикам эффективно обмениваться и сотрудничать, делая общие решения для различных проблем свободно доступными. Это освобождает многих разработчиков, чтобы они больше времени могли уделять решению проблем, специфичных для их конкретной ситуации.

Инструменты распространения, поставляемые с Python, разработаны, чтобы сделать вклад разработчиков в общий пул программного обеспечения достаточно простым, если они того пожелают.

Те же инструменты распространения также могут быть использованы для распространения программного обеспечения внутри организации, независимо от того, публикуется ли это программное обеспечение как программное обеспечение с открытым исходным кодом или нет.

Установка инструментов

Стандартная библиотека не включает инструменты сборки, которые поддерживают современные стандарты упаковки Python, поскольку основная команда разработчиков сочла важным иметь стандартные инструменты, которые работают согласованно даже в старых версиях Python.

Рекомендуемые в настоящее время инструменты сборки и распространения можно установить, вызвав модуль pip в командной строке:

python -m pip install setuptools wheel twine

В руководстве для пользователей Python Packaging содержится больше подробностей о рекомендуемых в настоящее время инструментах.

Изучение руководства пользователя Python Packaging

Руководство пользователя Python Packaging охватывает различные ключевые шаги и элементы, участвующие в создании и публикации проекта:

• Структура проекта
• Сборка и упаковка проекта
• Загрузка проекта в индекс пакетов Python
• Файл .pypirc

Как мне…

Вот быстрые ответы или ссылки для некоторых распространенных задач.