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

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

• pip — предпочтительная программа-установщик. Начиная с Python 3.4, она включена по умолчанию в установщики библиотек Python.
• Виртуальная среда — это полуизолированная среда Python, которая позволяет устанавливать пакеты для использования конкретным приложением, а не устанавливать их в систему в целом.
• venv — стандартный инструмент для создания виртуальных сред, являющийся частью Python с версии 3.3. Начиная с Python 3.4, по умолчанию он устанавливает pip во все созданные виртуальные среды.
• virtualenv — альтернативный инструмент сторонних разработчиков (и предшественник) venv. Он позволяет использовать виртуальные среды с версиями Python до 3.4, которые либо не предоставляют venv вообще, либо не могут автоматически установить pip в созданные среды.
• Индекс пакетов Python (Python Package Index) — общедоступный репозиторий пакетов с открытым исходным кодом, доступный для использования другими пользователями Python.
• Организация Python Packaging Authority (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