PyPI

Не следует путать с PyPy — интерпретатором языка Python.

PyPI
URL	pypi.org
Тип сайта	репозиторий программного обеспечения
Язык	многоязычный
Язык программирования	различные
Владелец	Python Software Foundation
Начало работы	2003
Текущий статус	активный

PyPI (аббр. от англ. Python Package Index — «каталог пакетов Python», произн. /ˌpaɪpiˈaɪ/) — каталог программного обеспечения, написанного на языке программирования Python. В сочетании с системами управления библиотечными пакетами (pip, easy_install) аналогичен PEAR для PHP и CPAN для Perl. По состоянию на февраль 2020 года содержит более 216 000 пакетов, тогда как в 2010 году пакетов было всего около 10 000.

История

Модуль Python Distribution Utilities (distutils) был впервые добавлен в стандартную библиотеку Python в выпуске 1.6.1 в сентябре 2000 года, а затем в выпуске 2.0 в октябре 2000 года, через девять лет после первого выпуска Python в феврале 1991 года, с целью упрощения процесса установки сторонних пакетов Python.

Однако, distutils предоставлял только инструменты для упаковки кода Python, и не более того. Он мог собирать и распространять метаданные, но не использовал их для других целей. Python по-прежнему не имел централизованного каталога пакетов в интернете. PEP 241, предложение по стандартизации метаданных для индексов, было окончательно утверждено в марте 2001 года. Предложение о создании всеобъемлющего централизованного каталога, размещенного на домене python.org, было окончательно утверждено в ноябре 2002 года.

16 апреля 2018 года весь трафик PyPI начал обслуживаться более современной веб-платформой: Warehouse. Устаревший веб-сайт был отключен в конце того же месяца. Все существующие пакеты были перенесены на новую платформу с сохранением их истории.

В мае 2023 года Python Software Foundation сообщил, что Министерство юстиции США запросило данные пользователей пяти участников PyPI. Представитель организации дополнительно пояснил, что они ожидают конфиденциальности от участников, но также соблюдают закон и постановления суда, и по этой причине передали данные, запрошенные правительством.

Регистрация в каталоге

Авторы сами регистрируют в каталоге свои пакеты (первый раз им необходимо предоставить данные и о себе) на PyPI:

python setup.py register

Метаданные обычно хранятся в файле setup.py в составе приготовленного к распространению пакета, а загрузка пакета осуществляется одной командой:

python setup.py sdist—format=zip,gztar upload

Требуемые для регистрации метаданные зафиксированы в PEP241 (предложению по развитию Python), принятому в 2001 году. Обязательными являются: версия метаданных, название пакета, версия пакета, платформа (платформы), краткое описание, адрес электронной почты автора, лицензия.

Кроме того, пакет может быть классифицирован с помощью одного или нескольких классификаторов.

Системы управления библиотечными пакетами

Модуль distutils из стандартной библиотеки Python:

1. Предоставляет основу для стандартных полей метаданных пакета
2. Содержит набор утилит для сборки пакета и создания архива для распространения или установщика (для Windows)

Возможности distutils ограничиваются рамками одного пакета, он не имеет возможности определять зависимости.

Система управления пакетами setuptools, основанная на модуле distutils, реализует простейшую систему отслеживания зависимостей, занимается загрузкой пакетов и взаимодействием с PyPI. Пакет setuptools умеет автоматически загружать и устанавливать зависимости пакета.

Утилита easy_install является дополнением к setuptools, и устанавливает их во время своей установки.

От проекта setuptools отделился пакет Distribute, который активно развивается и поддерживает Python 3.

Предполагается, что в разрабатываемый в настоящее время на основе distutils и Distribute пакет distutils2 войдёт в стандартную библиотеку Python. При этом будет сохранена совместимость со старым distutils.

Утилита pip является аналогом easy_install.

Пример

Следующий пример заимствован из файла setup.py пакета webpy-celery и представляет собой описание метаданных, относящихся к пакету:

setup(
    name='webpy-celery',
    version=__version__,
    url='http://github.com/faruken/webpy-celery',
    license='BSD',
    author='Faruk Akgul',
    author_email='me@akgul.org',
    description='Celery wrapper for web.py framework',
    long_description=__doc__,
    zip_safe=False,
    packages=find_packages(exclude=['examples', 'tests']),
    platforms='any',
    install_requires=[
        'web.py>=0.34',
        'celery>=2.3.0',
    ],
    classifiers=[
        'Environment:: Web Environment',
        'Intended Audience:: Developers',
        'License:: OSI Approved:: BSD License',
        'Operating System:: OS Independent',
        'Programming Language:: Python',
        'Programming Language:: Python:: 2.5',
        'Programming Language:: Python:: 2.6',
        'Programming Language:: Python:: 2.7',
        'Topic:: Internet:: WWW/HTTP:: Dynamic Content',
        'Topic:: Software Development:: Libraries:: Python Modules',
    ],
)

Использование каталога

Как указано на сайте PyPI, воспользоваться каталогом можно с помощью команды pip (при условии, что она предварительно установлена):

pip install название_пакета

Или же просто найти, загрузить, разархивировать, а затем запуском файла setup.py установить требуемый пакет:

python setup.py install

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

То же самое можно осуществить и с помощью других утилит, например easy install.

Безопасность

Основной источник:

Каталог PyPI служит источником информации для систем обновления программного обеспечения на Python, что неизбежно ставит вопрос обеспечения информационной безопасности. Система управления библиотеками Python позволяет недоверяющим друг другу (англ. mutually distrustful) разработчикам делать свои библиотеки доступными пользователям. В настоящее время в PyPI отсутствует механизм защиты обнаружения обновлений (англ. update discovery) и процесса установки, но существует TUF (англ. The Update Framework) — прототип каркаса для безопасной работы с PyPI посредством утилиты easy_install.

Ссылки

• pypi.python.org

Литература

• Paul Barry. Head First Python. — O'Reilly Media, 2010. — 494 с. — ISBN 978-1-4493-8267-4.
• Marty Alchin. Pro Python. — Apress, 2010. — 368 с. — ISBN 978-1-4302-2757-1.
• Justin Samuel, Nick Mathewson, Justin Cappos, and Roger Dingledine. Survivable key compromise in software update systems (англ.) // Proceedings of the XVII ACM conference on Computer and communications security. — N.Y, 2010. — P. 61—72. — ISBN 978-1-4503-0245-6. — doi:10.1145/1866307.1866315.
• Tarek Ziadé. Expert Python Programming. — Packt Publishing, 2008. — 372 с. — ISBN 9781847194947.