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

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

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

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

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

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

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