Pip: [Doc] Descripciones contradictorias para `pip config --site`

Creado en 23 jul. 2020  ·  4Comentarios  ·  Fuente: pypa/pip

Ambiente

  • versión pip: 2.1.1

Descripción

En la configuración de pip , --global significa configuración de todo el sistema y --site significa configuración de entorno .

--global
Utilice solo el archivo de configuración de todo el
--site
Utilice solo el archivo de configuración del entorno actual

Pero en la Guía del usuario - Archivo de configuración, Todo el sitio significa configuración del sistema , como C:\ProgramData\pip\pip.ini en Windows.

Comportamiento esperado

Estos 2 documentos deben tener descripciones coherentes.

Además, sería bueno agregar algunos ejemplos en la configuración de pip para indicar cómo especificar correctamente name ("sección y clave separadas por puntos", según el mensaje de error), como

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

Comentario más útil

¡Hola! Intentaré trabajar en este problema hoy en EuroPython Sprints :)

Todos 4 comentarios

Creo que esta lógica está adaptada de appdirs, pero también es confusa en 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

Quiero decir, ¿quién incluso pone archivos de configuración en /usr (creo que se supone que es /usr/share/pip/pip.conf )?

Al leer la implementación, parece que global significa todo el sistema, sitio significa todo el intérprete y usuario significa por usuario.

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

Por lo tanto, es probable que sea necesario corregir la guía del usuario.

¡Hola! Intentaré trabajar en este problema hoy en EuroPython Sprints :)

Eché un vistazo a GH-6268 (y su problema vinculado), pero no parece que el sitio sea ​​para la configuración de todo el intérprete. sys.prefix no apunta al directorio específico del intérprete, sino {sys.prefix}/*/pythonX.Y . Quizás donde el archivo de configuración que es específico del intérprete se pueda almacenar en {sys.prefix}/share/pythonX.Y , o que podamos desaprobar esto por completo y convertir configuraciones oscuras para emplear PIP_CONFIG_FILE en su lugar.

Entiendo que esto no está exactamente dentro del alcance de este problema, por lo que presentaré una nueva infracción si es necesario.

¿Fue útil esta página
0 / 5 - 0 calificaciones