Pip: [Doc] `pip config--site`の矛盾した説明

作成日 2020年07月23日 · 4コメント · ソース: pypa/pip

環境

pipバージョン：2.1.1

説明

pip configでは、 --globalはシステム全体の構成を意味し、 --siteは環境構成を意味し

--global
システム全体の構成ファイルのみを使用する
--site
現在の環境構成ファイルのみを使用する

ただし、ユーザーガイド-構成ファイルでは、サイト全体とは、WindowsのC:\ProgramData\pip\pip.iniなどのシステム構成を意味します。

予想される行動

これらの2つのドキュメントには、一貫した説明が必要です。

また、 pip configにいくつかの例を追加して、 name （エラーメッセージによると「ドットで区切られたセクションとキー」）を正しく指定する方法を示すとよいでしょう。

pip config set --site global.timeout 60

good first issue bug docs

ソース

jiasli

最も参考になるコメント

こんにちは！今日はEuroPythonSprintsでこの問題に取り組んでいきます:)

eamanu 2020年07月25日

❤3

全てのコメント4件

このロジックはappdirから採用されていると思いますが、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 2020年07月23日

実装を読むと、グローバルはシステムサイトはインタプリタ全体を意味し、ユーザーは

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

したがって、ユーザーガイドを修正する必要がある可能性があります。

uranusjr 2020年07月25日

👍2

こんにちは！今日はEuroPythonSprintsでこの問題に取り組んでいきます:)

eamanu 2020年07月25日

❤3

GH-6268（およびそれに関連する問題）を調べましたが、サイトが通訳者全体の構成を意味するものではないようです。 sys.prefixは、インタプリタに固有のディレクトリではなく、 {sys.prefix}/*/pythonX.Y指します。おそらく、インタープリターに固有の構成ファイルを{sys.prefix}/share/pythonX.Yに格納できる場合、またはこれを完全に非推奨にして、代わりにPIP_CONFIG_FILEを使用するようにあいまいなセットアップを変換できる場合です。

これはこの問題の範囲内ではないことを理解しているので、必要に応じて新しいチケットを提出します。

McSinyx 2020年07月26日

このページは役に立ちましたか？

0 / 5 - 0 評価