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

Новое в версии 3.4.

Исходный код: Lib/ensurepip

Пакет 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 не будет установлен.
--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).

© 2001–2023 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.10/library/ensurepip.html