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

Ключевые термины

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

Основные примеры использования

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

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

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