pypa/pip

Document shared cache dir

Open

#11,032 建立於 2022年4月13日

在 GitHub 查看
 (2 留言) (1 反應) (0 負責人)Python (8,952 star) (3,032 fork)batch import
help wantedtype: docstype: feature request

描述

What's the problem this feature will solve?

Background: pip caches various information in the pip cache dir. Potentially, a user could configure this to reside on a shared filesystem (network mount, container/VM bound volume). Some attention appears to be paid to making this configuration work in the source (building wheel, then moving it into place) and issues with this configuration appear to be accepted in the project (for example, #11012 or #1969).

However, there is no documentation on whether configuring the cache dir on a shared filesystem is supported, or any limits or caveats of this configuration.

Describe the solution you'd like

Document (probably in https://pip.pypa.io/en/latest/topics/caching/) that configuring the cache dir on a shared filesystem is supported, as well as any limits or caveats of such configuration.

Alternative Solutions

As an alternative, document (probably in https://pip.pypa.io/en/latest/topics/caching/) that configuring the cache dir on a shared filesystem is not supported.

Additional context

Some of the limitation or caveats of configuring the cache dir on a shared filesystem may also apply to one user running multiple instances of pip on the same machine on separate environments.

Code of Conduct

貢獻者指南

技術棧
python
領域
documentation
議題類型
documentation
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
stale
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
basic knowledge of pip cacheunderstanding of shared filesystemsfamiliarity with pip documentation structure
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
70
研究方向
Examine the existing caching documentation at https://pip.pypa.io/en/latest/topics/caching/. Review the referenced issues #11012 and #1969 for additional context on shared filesystem behavior. Determine if the current implementation supports shared filesystems and document the supported configuration, including known limitations and caveats. Add a section to the caching documentation that clarifies support for shared filesystem configurations.