pypa / pypa/packaging.python.org
Outdated details in the `wheel` spec overview (inherited from PEP 425)
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 1.7k
- Forks
- 1.7k
- Avg merge
- 3d 12h
- Merged PRs (30d)
- 4
Description
@brettcannon migrated the wheel spec from PEP 425 to the relevant spec page in https://github.com/pypa/packaging.python.org/pull/1206/files
Scanning that PR highlighted some original PEP 425 content that hasn't aged well:
- the tag consideration example is Linux based, but doesn't account for the
manylinuxtags and other Linux-specific tweaks to the tag evaluation process - the platform tag is still defined as the result of calling
distutils.util.get_platform(), but that was just removed from Python 3.12 (and has been deprecated since 3.10).sysconfig.get_platform()is mostly a replacement for that, but as discussed in https://stackoverflow.com/questions/71664875/what-is-the-replacement-for-distutils-util-get-platform it isn't 100% the same, and neither API truly reflects the behaviour ofwheel.bdist_wheel.get_platform()(there are some additional pragmatic corrections in https://github.com/pypa/wheel/blob/main/src/wheel/bdist_wheel.py#L47 to deal with some Mac OS X and Linux details)
Those were the two main points I noticed on a quick scan, but PEP 425 is old enough now that there are probably other inconsistencies we missed as the later wheel tagging PEPs adjusted the way things work.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the migrated wheel spec page from packaging.python.org and compare it with PEP 425 and the later wheel-tagging PEPs. Inspect wheel/src/wheel/bdist_wheel.py around the platform corrections noted in the issue. Done means the overview reflects current manylinux and platform-tag behavior and other inconsistencies found during the review.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- build-system, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100