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 argumentroot
.Примечание
Процесс начальной загрузки имеет побочные эффекты как на
sys.path
, так и наos.environ
. Вызов интерфейса командной строки в подпроцессы вместо этого позволяет избежать этих побочных эффектов.Примечание
В процессе начальной загрузки могут быть установлены дополнительные модули, требуемые
pip
, но другие программы не должны предполагать, что эти зависимости всегда будут присутствовать по умолчанию (поскольку зависимости могут быть удалены в будущей версииpip
).