ensurepip.md

1> **Источник:** https://python-all.ru/3.4/library/ensurepip.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 28.2. [`ensurepip`](https://python-all.ru/3.4/library/ensurepip.html#module-ensurepip) – начальная загрузка установщика `pip`89Новое в версии 3.4.1011Пакет [`ensurepip`](https://python-all.ru/3.4/library/ensurepip.html#module-ensurepip) обеспечивает начальную загрузку установщика `pip` в существующую установку Python или виртуальное окружение. Этот подход к начальной загрузке отражает тот факт, что `pip` является независимым проектом со своим собственным циклом выпуска, и последняя доступная стабильная версия включается в состав релизов сопровождения и функциональных релизов эталонного интерпретатора CPython.1213В большинстве случаев конечным пользователям Python не нужно вызывать этот модуль напрямую (так как `pip` должен быть установлен по умолчанию), но это может потребоваться, если установка `pip` была пропущена при установке Python (или при создании виртуального окружения) или после явного удаления `pip`.1415> **Примечание**16>17> Этот модуль *не* обращается к интернету. Все компоненты, необходимые для начальной загрузки `pip`, включены как внутренние части пакета.1819> **См. также**20>21> **[*Установка модулей Python*](https://python-all.ru/3.4/installing/index.html#installing-index)**22>23> Руководство конечного пользователя по установке пакетов Python24>25> **[**PEP 453**](https://python-all.ru/3.4/library/ensurepip.html): Явная начальная установка pip в установках Python**26>27> Исходные обоснование и спецификация этого модуля.2829## 28.2.1. Интерфейс командной строки3031Интерфейс командной строки вызывается с помощью ключа `-m` интерпретатора.3233Самый простой вызов:3435```python36python -m ensurepip37```3839Этот вызов установит `pip`, если он ещё не установлен, но в противном случае ничего не делает. Чтобы убедиться, что установленная версия `pip` не менее свежая, чем та, что входит в состав `ensurepip`, укажите опцию `--upgrade`:4041```python42python -m ensurepip --upgrade43```4445По умолчанию `pip` устанавливается в текущее виртуальное окружение (если оно активно) или в системные пакеты сайта (если нет активного виртуального окружения). Расположение установки можно контролировать с помощью двух дополнительных опций командной строки:4647- `--root <dir>`: Устанавливает `pip` относительно указанного корневого каталога, а не корня текущего активного виртуального окружения (если оно есть) или корневого каталога по умолчанию для текущей установки Python.48- `--user`: Устанавливает `pip` в каталог пользовательских пакетов сайта, а не глобально для текущей установки Python (эта опция не разрешена внутри активного виртуального окружения).4950По умолчанию будут установлены скрипты `pipX` и `pipX.Y` (где X.Y обозначает версию Python, использованную для вызова `ensurepip`). Устанавливаемые скрипты можно контролировать с помощью двух дополнительных опций командной строки:5152- `--altinstall`: если запрошена альтернативная установка, скрипт `pipX` *не* будет установлен.53- **`--default-pip`: если запрошена установка «pip по умолчанию»,**5455  скрипт5657  `pip`5859  будет установлен в дополнение к двум обычным скриптам.6061Указание обоих параметров выбора скриптов приведёт к исключению.6263## 28.2.2. API модуля6465[`ensurepip`](https://python-all.ru/3.4/library/ensurepip.html#module-ensurepip) предоставляет две функции для программного использования:6667#### `ensurepip.version()`6869Возвращает строку, указывающую версию pip, входящую в поставку, которая будет установлена при начальной настройке окружения.7071#### `ensurepip.bootstrap(root=None, upgrade=False, user=False, altinstall=False, default_pip=False, verbosity=0)`7273Выполняет начальную загрузку `pip` в текущее или указанное окружение.7475*root* указывает альтернативный корневой каталог, относительно которого производится установка. Если *root* равно None, то установка использует расположение по умолчанию для текущего окружения.7677*upgrade* указывает, следует ли обновлять существующую установку более ранней версии `pip` до версии, входящей в состав.7879*user* указывает, следует ли использовать пользовательскую схему вместо глобальной установки.8081По умолчанию будут установлены скрипты `pipX` и `pipX.Y` (где X.Y обозначает текущую версию Python).8283Если *altinstall* установлен, то `pipX` *не* будет установлен.8485Если *default\_pip* установлен, то `pip` будет установлен в дополнение к двум обычным скриптам.8687Установка одновременно *altinstall* и *default\_pip* вызовет [`ValueError`](https://python-all.ru/3.4/library/exceptions.html#ValueError).8889*verbosity* управляет уровнем вывода в [`sys.stdout`](https://python-all.ru/3.4/library/sys.html#sys.stdout) от операции начальной загрузки.9091> **Примечание**92>93> Процесс начальной загрузки имеет побочные эффекты как на `sys.path`, так и на `os.environ`. Вызов интерфейса командной строки в подпроцессе вместо этого позволяет избежать этих побочных эффектов.9495> **Примечание**96>97> Процесс начальной загрузки может установить дополнительные модули, необходимые для `pip`, но другое программное обеспечение не должно предполагать, что эти зависимости будут всегда присутствовать по умолчанию (поскольку зависимости могут быть удалены в будущей версии `pip`).98