Pip: [Doc] Descriptions contradictoires pour `pip config --site`

Créé le 23 juil. 2020  ·  4Commentaires  ·  Source: pypa/pip

Environnement

  • version de pip: 2.1.1

La description

Dans pip config , --global signifie la configuration à l' échelle du système et --site la configuration de l'environnement .

--global
Utilisez uniquement le fichier de configuration à l' échelle du
--site
Utilisez uniquement le fichier de configuration de l' environnement actuel

Mais dans le Guide de l'utilisateur - Fichier de configuration , à l'échelle du site signifie la configuration du système , telle que C:\ProgramData\pip\pip.ini sous Windows.

Comportement prévisible

Ces 2 documents doivent avoir des descriptions cohérentes.

De plus, il serait bien d'ajouter quelques exemples dans la configuration de pip pour indiquer comment spécifier correctement name ("section et clé séparées par des points", selon le message d'erreur), comme

pip config set --site global.timeout 60
good first issue bug docs

Commentaire le plus utile

Salut! Je vais essayer de travailler sur ce problème aujourd'hui sur EuroPython Sprints :)

Tous les 4 commentaires

Je pense que cette logique est adaptée des appdirs, mais elle est également déroutante sur 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

Je veux dire qui met même les fichiers de configuration dans /usr (je pense que c'est censé être /usr/share/pip/pip.conf )?

À la lecture de l'implémentation, il semble que global signifie à l' site signifie à l'échelle de l'interprète et utilisateur signifie par utilisateur.

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

Donc, le guide de l'utilisateur doit probablement être corrigé.

Salut! Je vais essayer de travailler sur ce problème aujourd'hui sur EuroPython Sprints :)

J'ai jeté un coup d'œil au GH-6268 (et à son problème lié), mais il ne semble pas que le site soit destiné à une configuration à l'échelle de l'interpréteur. sys.prefix ne pointe pas vers le répertoire spécifique à l'interpréteur, mais {sys.prefix}/*/pythonX.Y . Peut-être où le fichier de configuration qui est spécifique à l'interpréteur peut être stocké dans {sys.prefix}/share/pythonX.Y , ou que nous pouvons le déprécier entièrement et convertir des configurations obscures pour utiliser PIP_CONFIG_FILE à la place.

Je comprends que ce n'est pas exactement dans le cadre de ce problème, je vais donc déposer un nouveau ticket pour cela si nécessaire.

Cette page vous a été utile?
0 / 5 - 0 notes