Менеджер установки Python настраивается с помощью иерархии файлов конфигурации, переменных окружения, параметров командной строки и параметров реестра. Как правило, файлы конфигурации позволяют настраивать всё, включая расположение других файлов конфигурации, в то время как параметры реестра доступны только администратору и переопределяют файлы конфигурации. Параметры командной строки переопределяют все остальные настройки, но не все доступны.

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

Глобальный файл конфигурации может быть настроен администратором и будет прочитан первым. Пользовательский файл конфигурации хранится в %AppData%\Python\pymanager.json(по умолчанию) и считывается следующим, перезаписывая все настройки из более ранних файлов. Дополнительный файл конфигурации можно указать как PYTHON_MANAGER_CONFIGпеременную окружения или --configкак параметр командной строки (но не как то и другое одновременно).

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

Стандартные параметры конфигурации

Конфигурационный ключ

Переменная среды

Описание

default_tag
PYTHON_MANAGER_DEFAULT

Предпочтительная версия по умолчанию для запуска или установки. По умолчанию это последняя версия (не предварительная) от команды CPython.

default_platform

PYTHON_MANAGER_DEFAULT_PLATFORM

Предпочтительная платформа по умолчанию для запуска или установки. Рассматривается как суффикс к указанному тегу, поэтому py -V:3.14предпочтительнее будет установить, 3.14-64если она существует (и default_platformравна -64), но будет использоваться, 3.14если нет указанной установки.

logs_dir

PYTHON_MANAGER_LOGS

Место, где записываются файлы журналов. По умолчанию %TEMP%.

automatic_install

PYTHON_MANAGER_AUTOMATIC_INSTALL

Значение True разрешает автоматическую установку при указании конкретной среды выполнения для запуска. Значение по умолчанию — true.

include_unmanaged

PYTHON_MANAGER_INCLUDE_UNMANAGED

Значение True, чтобы разрешить вывод списка и запуск сред выполнения, которые не были установлены менеджером установки Python, или значение False, чтобы исключить их. Значение по умолчанию — True.

shebang_can_run_anything

PYTHON_MANAGER_SHEBANG_CAN_RUN_ANYTHING

Значение True, чтобы разрешить шебангам в .pyфайлах запускать приложения, отличные от сред выполнения Python, или значение False, чтобы запретить это. По умолчанию — True.

log_level

PYMANAGER_VERBOSE,PYMANAGER_DEBUG

Установите уровень выходных данных по умолчанию (0–50). По умолчанию — 20. Более низкие значения приводят к увеличению выходных данных. Переменные окружения являются логическими и могут создавать дополнительные выходные данные во время запуска, которые впоследствии подавляются другими настройками.

confirm

PYTHON_MANAGER_CONFIRM

True, чтобы подтвердить определённые действия перед их выполнением (например, удаление), или false, чтобы пропустить подтверждение. По умолчанию — true.

install.source

PYTHON_MANAGER_SOURCE_URL

Переопределить индексный канал для получения новых установок.

list.format

PYTHON_MANAGER_LIST_FORMAT

Укажите формат, используемый командой по умолчанию py list. По умолчанию — table.

Имена, разделенные точками, должны быть вложены в объекты JSON, например, list.formatбудут указаны как {"list": {"format": "table"}}.