Pip: [Doc] Противоречивые описания для `pip config --site`

Созданный на 23 июл. 2020 · 4Комментарии · Источник: pypa/pip

Окружающая среда

версия pip: 2.1.1

Описание

В конфигурации pip --global означает общесистемную конфигурацию, а --site означает конфигурацию среды .

--global
Используйте только общесистемный файл конфигурации
--site
Использовать только текущий файл конфигурации среды

Но в Руководстве пользователя - Файл конфигурации , Общесайтовый означает конфигурацию системы , такую как C:\ProgramData\pip\pip.ini в Windows.

Ожидаемое поведение

Эти 2 документа должны иметь согласованные описания.

Кроме того, было бы неплохо добавить несколько примеров в конфигурацию pip, чтобы указать, как правильно указать name («раздел и ключ, разделенные точкой», согласно сообщению об ошибке), например

pip config set --site global.timeout 60

good first issue bug docs

Источник

jiasli

Самый полезный комментарий

Здравствуй! Попробую сегодня поработать над этим вопросом на EuroPython Sprints :)

eamanu 25 июл. 2020

❤3

Все 4 Комментарий

Я думаю, что эта логика адаптирована из appdirs, но это сбивает с толку и GNU / Linux:

$ pip debug
global:
  /etc/xdg/pip/pip.conf, exists: False
  /etc/pip.conf, exists: False
site:
  /usr/pip.conf, exists: False
user:
  /home/cnx/.pip/pip.conf, exists: False
  /home/cnx/.config/pip/pip.conf, exists: True

Я имею в виду, кто вообще помещает файлы конфигурации в /usr (я думаю, это должно быть /usr/share/pip/pip.conf )?

McSinyx 23 июл. 2020

Читая реализацию, кажется, что глобальный означает общесистемный, сайт означает общесистемный, а пользователь означает каждого пользователя.

https://github.com/pypa/pip/blob/89a51a6fefec826256fb334ea6244dfb0b3455a0/src/pip/_internal/configuration.py#L76 -L96

Поэтому руководство пользователя, вероятно, необходимо исправить.

uranusjr 25 июл. 2020

👍2

Здравствуй! Попробую сегодня поработать над этим вопросом на EuroPython Sprints :)

eamanu 25 июл. 2020

❤3

Я взглянул на GH-6268 (и связанную с ним проблему), но не похоже, что этот сайт предназначен для настройки на уровне интерпретатора. sys.prefix указывает не на каталог, специфичный для интерпретатора, а на {sys.prefix}/*/pythonX.Y . Возможно, где файл конфигурации, специфичный для интерпретатора, может быть сохранен в {sys.prefix}/share/pythonX.Y , или что мы можем полностью отказаться от этого и преобразовать непонятные настройки, чтобы вместо этого использовать PIP_CONFIG_FILE.

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

McSinyx 26 июл. 2020

Была ли эта страница полезной?

0 / 5 - 0 рейтинги