Pip: [Doc] Deskripsi kontradiktif untuk `pip config --site`

Dibuat pada 23 Jul 2020  ·  4Komentar  ·  Sumber: pypa/pip

Lingkungan Hidup

  • versi pip: 2.1.1

Deskripsi

Dalam konfigurasi pip , --global berarti konfigurasi seluruh sistem dan --site berarti konfigurasi lingkungan .

--global
Gunakan file konfigurasi seluruh sistem saja
--site
Gunakan file konfigurasi lingkungan saat ini saja

Tetapi dalam Panduan Pengguna - File konfigurasi , seluruh situs berarti konfigurasi sistem , seperti C:\ProgramData\pip\pip.ini pada Windows.

Perilaku yang diharapkan

Kedua dokumen ini harus memiliki deskripsi yang konsisten.

Selain itu, alangkah baiknya untuk menambahkan beberapa contoh di pip config untuk menunjukkan cara menentukan name ("bagian dan kunci yang dipisahkan titik", sesuai dengan pesan kesalahan), seperti

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

Komentar yang paling membantu

Hai! Saya akan mencoba menangani masalah ini hari ini di EuroPython Sprints :)

Semua 4 komentar

Saya pikir logika ini diadaptasi dari appdirs, tetapi juga membingungkan di 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

Maksud saya, siapa yang bahkan meletakkan file konfigurasi di /usr (saya pikir seharusnya /usr/share/pip/pip.conf )?

Membaca implementasinya, sepertinya global berarti situs berarti interpreter-wide, dan cara pengguna per pengguna.

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

Jadi panduan pengguna sepertinya perlu diperbaiki.

Hai! Saya akan mencoba menangani masalah ini hari ini di EuroPython Sprints :)

Saya melihat GH-6268 (dan masalah terkaitnya), tetapi tampaknya situs itu bukan untuk konfigurasi sarana interpreter-wide. sys.prefix tidak menunjuk ke direktori khusus untuk penerjemah, tetapi {sys.prefix}/*/pythonX.Y . Mungkin di mana file konfigurasi yang khusus untuk interpreter dapat disimpan di {sys.prefix}/share/pythonX.Y , atau kita dapat menghentikan ini sepenuhnya dan mengubah pengaturan yang tidak jelas untuk menggunakan PIP_CONFIG_FILE sebagai gantinya.

Saya memahami bahwa ini tidak persis dalam cakupan masalah ini, jadi saya akan mengajukan tiket baru untuk ini jika perlu.

Apakah halaman ini membantu?
0 / 5 - 0 peringkat