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