Skip to content

PEP 817: Wheel Variants: Beyond Platform Tags #4740

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DEKHTIARJonathan wants to merge 23 commits into
base: main
Choose a base branch
from
+2,708 −0
Open

PEP 817: Wheel Variants: Beyond Platform Tags #4740

Changes from 1 commit
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
f81a825
PEP 817: Wheel Variants: Beyond Platform Tags
DEKHTIARJonathan Dec 10, 2025
5c3b867
Code-Owners editing
DEKHTIARJonathan Dec 10, 2025
8e3d5ea
Apply suggestions from code review
mgorny Dec 11, 2025
f0d43f6
Switch to plain quotation marks
mgorny Dec 11, 2025
e16bf03
Move "definitions" to "specification" section
mgorny Dec 11, 2025
fede5ff
Reflow the cupy package list
mgorny Dec 11, 2025
c68242d
Update peps/pep-0817/appendix-variant-metadata-json-schema.rst
DEKHTIARJonathan Dec 12, 2025
64f32ed
[PEP Review] JSON Schema Indent switched to 2
DEKHTIARJonathan Dec 12, 2025
78ff40b
Replace the benchmark chart with SVG
mgorny Dec 12, 2025
a31b68b
Compact the SVG
mgorny Dec 12, 2025
73753b9
Reflow text
mgorny Dec 15, 2025
162ec7b
Replace typographic apostrophes
mgorny Dec 15, 2025
0064073
Remove double spaces introduced while reflowing
mgorny Dec 15, 2025
4b6f0f3
Apply suggestions from code review
mgorny Dec 19, 2025
553f13e
Apply suggestions from code review
mgorny Dec 19, 2025
cd2ca30
Remove one more "induced"
mgorny Dec 19, 2025
4222f09
Apply suggestions from code review
mgorny Dec 19, 2025
3836f17
Apply suggestions from code review
mgorny Dec 19, 2025
1e2d260
Fix list indent
mgorny Dec 19, 2025
5cf8487
Uppercase RFC 2119 terms
mgorny Dec 20, 2025
08e3778
Replace disjunction/conjunction with OR/AND
mgorny Dec 20, 2025
c40f3c9
Add "untrusted" to "security considerations"
mgorny Dec 20, 2025
7e70c3d
Move "summary of changes" to the rationale
mgorny Dec 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Apply suggestions from code review 
Co-authored-by: Adam Turner <[email protected]>
  • Loading branch information
@mgorny @AA-Turner
mgorny and AA-Turner authored Dec 11, 2025
commit 8e3d5ea7baab6b7147b37f7dd5822bca6db910d2
12 changes: 6 additions & 6 deletions peps/pep-0817.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ against different dependency ABIs. This is particularly challenging for
the scientific computing, artificial intelligence (AI), machine learning
(ML), and high-performance computing (HPC) communities.

This PEP proposes “Wheel Variants,” an extension to the
This PEP proposes "Wheel Variants", an extension to the
:doc:`packaging:specifications/binary-distribution-format`. This
extension introduces a mechanism for package maintainers to declare
multiple build variants for the same package version, while allowing
Expand All @@ -52,8 +52,8 @@ the best user experience.
Definitions
===========

The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”,
“SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in :rfc:`2119`.


Expand Down Expand Up @@ -82,8 +82,8 @@ wheel of considerable size, or using separate package names
(``mypackage-gpu``, ``mypackage-cpu``, etc.). Each of these approaches
has significant drawbacks.

According to the `2024 Python Developers
Survey <https://lp.jetbrains.com/python-developers-survey-2024/#purposes-for-using-python>`__,
According to the `2024 Python Developers Survey
<https://lp.jetbrains.com/python-developers-survey-2024/#purposes-for-using-python>`__,
a significant portion of respondents over the last years have been
successively using Python for scientific computing purposes, covering
such areas as Data analysis (steadily over 40% respondents), Machine
Expand Down Expand Up @@ -224,7 +224,7 @@ Tools need to implement special handling for the way PyTorch uses local
version segments. These requirements break the pattern that packages
are usually installed with. Problems with installing PyTorch
are a very common point of user confusion. To quantify this, on
2025-12-05, 552 out of 8136, or 6.8%, of issues on the `uv's issue
2025-12-05, 552 out of 8136, or 6.8%, of issues on `uv's issue
tracker <https://github.com/astral-sh/uv/issues/>`__ contained the term
"torch".

Expand Down