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 они могут быть удалены).