ensurepip — Инициализация установщика pip

Интерфейс командной строки

Интерфейс командной строки вызывается с помощью переключателя -m интерпретатора.

Самый простой способ вызова:

python -m ensurepip

Этот вызов установит pip, если он ещё не установлен, и ничего не сделает в противном случае. Чтобы убедиться, что установленная версия pip не старее версии, доступной в ensurepip, передайте параметр --upgrade:

python -m ensurepip --upgrade

По умолчанию pip устанавливается в текущую виртуальную среду (если она активна) или в системные пакеты сайта (если активной виртуальной среды нет). Место установки можно задать с помощью двух дополнительных параметров командной строки:

--root <dir>

Устанавливает pip относительно указанного корневого каталога, а не корня текущей активной виртуальной среды (если она есть) или корневого каталога по умолчанию для текущей установки Python.

--user

Устанавливает pip в каталог пользовательских пакетов сайта, а не глобально для текущей установки Python (этот параметр нельзя использовать в активной виртуальной среде).

По умолчанию будут установлены скрипты pipX и pipX.Y (где X.Y — версия Python, с помощью которой был вызван ensurepip). Устанавливаемые скрипты можно задать с помощью двух дополнительных параметров командной строки:

--altinstall

Если запрошена альтернативная установка, скрипт pipX не будет установлен.

--default-pip

Если запрошена установка «pip по умолчанию», скрипт pip будет установлен в дополнение к двум обычным скриптам.

Одновременное указание обоих параметров выбора скриптов приведёт к возникновению исключения.

API модуля

ensurepip предоставляет две функции для программного использования:

ensurepip.version()

Возвращает строку с доступной версией pip, которая будет установлена при инициализации среды.

ensurepip.bootstrap(root=None, upgrade=False, user=False, altinstall=False, default_pip=False, verbosity=0)

Инициализирует pip в текущей или указанной среде.

root задаёт альтернативный корневой каталог, относительно которого выполняется установка. Если root равен None, для установки используется расположение по умолчанию в текущей среде.

upgrade указывает, следует ли обновить существующую установку более ранней версии pip до доступной версии.

user указывает, следует ли использовать пользовательскую схему вместо глобальной установки.

По умолчанию будут установлены скрипты pipX и pipX.Y (где X.Y — текущая версия Python).

Если задан параметр altinstall, pipX не будет установлен.

Если задан параметр default_pip, pip будет установлен в дополнение к двум обычным скриптам.

Одновременная установка параметров altinstall и default_pip приведёт к возникновению исключения ValueError.

verbosity управляет уровнем вывода операции инициализации в поток sys.stdout.

Вызывает событие аудита ensurepip.bootstrap с аргументом root.

Примечание

Процесс инициализации имеет побочные эффекты как для sys.path, так и для os.environ. Вызов интерфейса командной строки в отдельном подпроцессе позволяет избежать этих побочных эффектов.

Примечание

В процессе инициализации могут устанавливаться дополнительные модули, необходимые для pip, однако другое программное обеспечение не должно предполагать, что эти зависимости всегда будут доступны по умолчанию (в будущей версии pip они могут быть удалены).