pypa / pypa/packaging.python.org
Document real compatibility tag interpretation
还没有人认领这个 Issue。
- 主要语言
- Python
- 星标
- 1.7k
- 派生
- 1.7k
- 平均合并
- 3 天 12 小时
- 30 天内合并 PR
- 4
描述
Issue Description
The compatibility tag section of the documentation is lifted directly from PEP-425 and covers how compatibility tags are constructed.
However, it is incomplete and inaccurate regarding how those tags are matched by pip. The described algorithm is:
This example list is for an installer running under CPython 3.3 on a linux_x86_64 system. It is in order from most-preferred (a distribution with a compiled extension module, built for the current version of Python) to least-preferred (a pure-Python distribution built with an older version of Python):
- cp33-cp33m-linux_x86_64
- cp33-abi3-linux_x86_64
- cp3-abi3-linux_x86_64
- cp33-none-linux_x86_64*
- cp3-none-linux_x86_64*
- py33-none-linux_x86_64*
- py3-none-linux_x86_64*
- cp33-none-any
- cp3-none-any
- py33-none-any
- py3-none-any
- py32-none-any
- py31-none-any
- py30-none-any
This is modified by "Compressed Tag Sets" but that's not relevant to this issue.
From this we can surmise, for a CPython version X.Y:
- It can match if
pythoniscpXYandabiiscpXY*. - It can match if
pythonis incpXY, cpXandabiisabi3 - It can match if
pythonis incpXY,cpX,pyXY,pyXandabiisnone - It can also match any
pyXZ-none-anyfor Z < Y
This is not the actual algorithm used by pip.
In particular I'm aware of these rules obeyed by pip in practice (but I haven't found a spec):
- It can also match any
cpXZ-abi3for Z < Y - It can also match any
pyXZ-none-manylinux*for Z < Y
Given these are valid, they must be in the ordering somewhere, and it should be documented where.
Some examples illustrating these rules (pip 24.3.1, python 3.13):
$ .venv/bin/pip --version
pip 24.3.1 from /home/mauve/dev/demo/.venv/lib/python3.13/site-packages/pip (python 3.13)
$ .venv/bin/pip install --dry-run solace_pubsubplus --no-deps --no-cache
Looking in indexes: https://artifactory/pypi/simple/
Collecting solace_pubsubplus
Downloading https://artifactory/pypi/packages/packages/5e/33/e5923f962b89b5a63eac2c0f7493abb53e7a1054a1da580c0037fd51713f/solace_pubsubplus-1.9.0-py36-none-manylinux_2_12_x86_64.whl (4.4 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 4.4/4.4 MB 549.6 MB/s eta 0:00:00
Would install solace-pubsubplus-1.9.0
$ .venv/bin/pip install --dry-run argon2_cffi_bindings --no-deps --no-cache
Looking in indexes: https://artifactory/pypi/simple/
Collecting argon2_cffi_bindings
Downloading https://artifactory/pypi/packages/packages/ec/f7/378254e6dd7ae6f31fe40c8649eea7d4832a42243acaf0f1fff9083b2bed/argon2_cffi_bindings-21.2.0-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (86 kB)
Would install argon2-cffi-bindings-21.2.0
Given also that Compressed Tag Sets modify the whole algorithm, making it about set intersection, it would also be better to incorporate them into a description of the algorithm too.
Code of Conduct
- I am aware that participants in this repository must follow the PSF Code of Conduct.
贡献指南
这个仓库没有索引到贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从平台兼容性标签文档的兼容性标签部分开始,将其 PEP-425 排序与 issue 中的 pip 24.3.1 示例进行比较。研究实际排序,包括 Compressed Tag Sets 以及较旧的 cp/py manylinux 匹配,然后记录下来,使所描述的算法与 pip 的行为一致,并解释这些示例。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- python
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 活跃度
- 停滞
- 描述清晰度
- 基本清楚
- 新手友好度
- 45/100