Установка модулей 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.
• Группа разработчиков и авторов документации 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