ensurepip — Настройка установщика pip

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

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

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

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

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

python -m ensurepip

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

python -m ensurepip --upgrade

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

• --root <dir>: Устанавливает pip относительно указанного корневого каталога, а не относительно корня текущей активной виртуальной среды (если таковая имеется) или корневого каталога по умолчанию для текущей установки Python.
• --user: Устанавливает pip в каталог пользовательских пакетов, а не глобально для текущей установки Python (эта опция недоступна внутри активной виртуальной среды).

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

• --altinstall: если запрашивается альтернативная установка, скрипты pip и pipX не будут установлены.
• --no-default-pip: если запрашивается нестандартная установка, скрипт pip не будет установлен.

2. API модуля

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

ensurepip.version()

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

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

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

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

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

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

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

Если altinstall установлено, то pip и pipX не будут установлены.

Если default_pip установлено в False, то pip не будет установлен.

Установка altinstall и default_pip одновременно приведет к возникновению ошибки ValueError.

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

Примечание

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

Примечание

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