Установка модулей Python

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

• pip — предпочтительная программа-инсталлятор. Начиная с Python 3.4, она включена по умолчанию в установщики бинарных файлов Python.
• Виртуальная среда — это полуизолированная среда Python, которая позволяет устанавливать пакеты для использования конкретным приложением, а не по всей системе.
• venv — стандартный инструмент для создания виртуальных сред, который является частью Python с Python 3.3. Начиная с Python 3.4, он по умолчанию устанавливает pip во все созданные виртуальные среды.
• virtualenv — альтернативный инструмент сторонних разработчиков (и предшественник) venv. Он позволяет использовать виртуальные среды на версиях Python до 3.4, которые либо не предоставляют venv вообще, либо не могут автоматически устанавливать pip в созданные среды.
• Индекс пакетов Python (Python Packaging Index) — это общедоступный репозиторий пакетов с открытым исходным кодом, предоставляемых для использования другими пользователями Python.
• Авторитет по упаковке Python (Python Packaging Authority) — группа разработчиков и авторов документации, ответственных за поддержание и развитие стандартных инструментов упаковки и соответствующих метаданных и стандартов формата файлов. Они поддерживают различные инструменты, документацию и системы отслеживания проблем как на GitHub, так и на Bitbucket.
• distutils — оригинальная система сборки и распространения, впервые добавленная в стандартную библиотеку Python в 1998 году. Несмотря на то, что прямое использование distutils постепенно сводится к минимуму, она всё ещё заложила основу для современной инфраструктуры упаковки и распространения, и она не только остаётся частью стандартной библиотеки, но её имя сохраняется и в других аспектах (например, в имени списка рассылки, используемого для координации разработки стандартов упаковки Python).

Основное использование

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

Следующая команда установит последнюю версию модуля и его зависимости из Индекса пакетов Python:

python -m pip install SomePackage

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

python -m pip install SomePackage==1.0.4    # specific version
python -m pip install "SomePackage>=1.0.4"  # minimum version

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

python -m pip install --upgrade SomePackage

Дополнительную информацию и ресурсы относительно pip и его возможностей можно найти в Руководстве пользователя по упаковке Python.

Создание виртуальных сред выполняется через модуль venv. Установка пакетов в активную виртуальную среду выполняется с помощью команд, показанных выше.

Как мне …?

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

python2   -m pip install SomePackage  # default Python 2
python2.7 -m pip install SomePackage  # specifically Python 2.7
python3   -m pip install SomePackage  # default Python 3
python3.4 -m pip install SomePackage  # specifically Python 3.4

py -2   -m pip install SomePackage  # default Python 2
py -2.7 -m pip install SomePackage  # specifically Python 2.7
py -3   -m pip install SomePackage  # default Python 3
py -3.4 -m pip install SomePackage  # specifically Python 3.4

Общие проблемы с установкой

python -m ensurepip --default-pip