ensurepip — Начальная загрузка `` pip`` установщика

Добавлено в версии 3.4.


Пакет ensurepip поддерживает загрузку программы установки pip в существующую установку Python или виртуальную среду. Этот подход самонастройки отражает то, что pip - независимый проект со своим собственным циклом выпуска, и последняя доступная стабильная версия связана обслуживанием и выпусками особенности ссылки CPython интерпретатор.

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

Примечание

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

См.также

Установка модулей Python
Руководство конечного пользователя по установке пакетов Python
PEP 453: Явная загрузка pip в установках Python
Оригинальное обоснование и спецификация этого модуля.

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

Интерфейс командной строки призван, используя выключатель интерпретатор -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 not будет установлен.
  • --default-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 от операции по самонастройке.

Raises an auditing event ensurepip.bootstrap with argument root.

Примечание

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

Примечание

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