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).