Skip to content

Clarify wheel compatibility tag matching and preference - #2199

Open
Himanshuagrawal4 wants to merge 1 commit into
pypa:mainfrom
Himanshuagrawal4:PRO/packaging-wheel-tag-matching-20261120
Open

Himanshuagrawal4 wants to merge 1 commit into
pypa:mainfrom
Himanshuagrawal4:PRO/packaging-wheel-tag-matching-20261120

Conversation

@Himanshuagrawal4

@Himanshuagrawal4 Himanshuagrawal4 commented Nov 20, 2026 •

Copy link
Copy Markdown

Summary

Explain that a wheel is tag-compatible when any of its tags matches the target environment, and that tag preference compares each otherwise equivalent wheel's earliest match. Distinguish tag compatibility from other selection criteria, and show how to inspect the ordered tags on the current interpreter.

The historical CPython 3.3 example stays in place. This is a clarification of tag matching and preference, not a change to the tag format or an exhaustive description of pip's candidate ranking.

Refs #1663.

Validation

  • Compared native, compressed pure-Python, and incompatible wheel tags using pip on Windows.
  • Built the full guide with Sphinx in strict mode; the build passed.

AI assistance: OpenAI Codex assisted with the change, local checks, and this draft description. The contributor manually reviewed the patch.


📚 Documentation preview 📚: https://python-packaging-user-guide--2199.org.readthedocs.build/en/2199/

@Himanshuagrawal4
Himanshuagrawal4 marked this pull request as ready for review November 20, 2026 06:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant