Skip to content

Remove variant label length limitation #41

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

Merged
mgorny merged 2 commits into from
Feb 23, 2026
+9 −2
Merged

Remove variant label length limitation #41

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
375ef16
Remove variant label length limitation
mgorny Feb 23, 2026
77f7372
Update peps/pep-0825.rst
mgorny Feb 23, 2026
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
11 changes: 9 additions & 2 deletions peps/pep-0825.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -137,8 +137,8 @@ to:

Variant wheels MUST include the variant label component. Conversely,
wheels without variant label are non-variant wheels. The variant label
MUST consist only of ``0-9``, ``a-z``, ``_`` and ``.`` ASCII characters,
and be 1-16 characters long (``^[0-9a-z_.]{1,16}$``).
MUST be non-empty and consist only of ``0-9``, ``a-z``, ``_`` and ``.``
ASCII characters (``^[0-9a-z_.]+$``).

Every variant label MUST uniquely correspond to a specific set of
variant properties, which MUST be the same for all wheels using the same
Expand Down Expand Up @@ -841,6 +841,12 @@ commonly used today reject it:
numpy-2.3.2-cp313-cp313t-musllinux_1_2_x86_64-x86_64_v3.whl
^^^^^

The addition of the variant label increases the filename length. On platforms
with a low total path length limit such as Windows, long filenames are a
concern. However, given that the name and version components are already
unrestricted, we do not set a specific limit in this PEP. Others, such as PyPI,
may set a limit for total filename length.

Aside from this explicit incompatibility, the specification makes
minimal and non-intrusive changes to the binary package format. The
`variant metadata`_ is stored in a separate file in the ``.dist-info``
Expand Down Expand Up @@ -965,6 +971,7 @@ Change History
best value that is compatible with the system, for every feature,
rather than all compatible values, and add a fallback to ordering
on variant label.
- Removed the variant label length limitation.


Appendices
Expand Down
Loading