Pip: [Doc] Widersprüchliche Beschreibungen für `pip config --site`

Erstellt am 23. Juli 2020  ·  4Kommentare  ·  Quelle: pypa/pip

Umgebung

  • Pip-Version: 2.1.1

Beschreibung

In der Pip - Konfiguration bedeutet --global eine systemweite Konfiguration und --site eine Umgebungskonfiguration .

--global
Verwenden Sie nur die systemweite Konfigurationsdatei
--site
Verwenden Sie nur die aktuelle Umgebungskonfigurationsdatei

Im Benutzerhandbuch - Konfigurationsdatei bedeutet Site-weit jedoch Systemkonfiguration , z. B. C:\ProgramData\pip\pip.ini unter Windows.

Erwartetes Verhalten

Diese beiden Dokumente sollten konsistente Beschreibungen enthalten.

Es wäre auch schön, einige Beispiele in der Pip-Konfiguration hinzuzufügen, um anzugeben, wie name ("Punkt getrennter Abschnitt und Schlüssel" gemäß der Fehlermeldung) korrekt angegeben werden kann, wie z

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

Hilfreichster Kommentar

Hallo! Ich werde heute versuchen, an diesem Problem bei EuroPython Sprints zu arbeiten :)

Alle 4 Kommentare

Ich denke, diese Logik wurde von Appdirs übernommen, aber auch unter GNU / Linux ist sie verwirrend:

$ 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

Ich meine, wer legt überhaupt Konfigurationsdateien in /usr (ich denke, es soll /usr/share/pip/pip.conf )?

Beim Lesen der Implementierung scheint global systemweit zu sein, Site bedeutet Dolmetscherweit und Benutzer bedeutet pro Benutzer.

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

Daher muss das Benutzerhandbuch wahrscheinlich repariert werden.

Hallo! Ich werde heute versuchen, an diesem Problem bei EuroPython Sprints zu arbeiten :)

Ich habe mir GH-6268 (und das damit verbundene Problem) angesehen, aber es scheint nicht, dass die Site für eine dateninterpreterweite Konfiguration gedacht ist. sys.prefix verweist nicht auf das für den Interpreter spezifische Verzeichnis, sondern auf {sys.prefix}/*/pythonX.Y . Möglicherweise kann die für den Interpreter spezifische Konfigurationsdatei in {sys.prefix}/share/pythonX.Y gespeichert werden, oder wir können dies vollständig ablehnen und obskure Setups konvertieren, um stattdessen PIP_CONFIG_FILE zu verwenden.

Ich verstehe, dass dies nicht genau im Rahmen dieser Ausgabe liegt, daher werde ich bei Bedarf ein neues Ticket dafür einreichen.

War diese Seite hilfreich?
0 / 5 - 0 Bewertungen