Сообщить об ошибке.

Модуль ensurepip в Python

Начальная загрузка установщика пакетов pip

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

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

Примечание.
Модуль ensurepip не имеет доступа к Интернету. Все компоненты, необходимые для начальной загрузки, включены как внутренние части пакета.

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

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

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

~$ python3 -m ensurepip

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

~$ python3 -m ensurepip --upgrade

По умолчанию pip устанавливается в текущую виртуальную среду если она активна или в пакеты системного Python если активной виртуальной среды нет.

Местом установки можно управлять с помощью двух дополнительных параметров командной строки:

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

По умолчанию будут установлены скрипты pipX и pipX.Y, где X.Y обозначает версию Python, используемую для вызова ensurepip.

Установленные сценарии можно контролировать с помощью двух дополнительных параметров командной строки:

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

Одновременное указание обоих вариантов вызовет исключение.