Skip to content

PEP 825: Various clarifications#4969

Merged
dstufft merged 20 commits into
python:mainfrom
wheelnext:pep-wheel-variants-acceptance
Jul 2, 2026
Merged

PEP 825: Various clarifications#4969
dstufft merged 20 commits into
python:mainfrom
wheelnext:pep-wheel-variants-acceptance

Conversation

@konstin

@konstin konstin commented May 11, 2026

Copy link
Copy Markdown
Contributor

No functional changes, but clarifications to the variant ordering algorithm, index support and scope.

  • Change is either:
    • To a Draft PEP
    • To an Accepted or Final PEP, with Steering Council approval
    • To fix an editorial issue (markup, typo, link, header, etc)
  • PR title prefixed with PEP number (e.g. PEP 123: Summary of changes)

mgorny and others added 13 commits May 10, 2026 20:00
Reword the ordering algorithm to avoid introducing new terms.  Rather
than talking of abstract "variants", operate in the terms of grouping
variant wheels by their labels, and creating an additional group for
non-variant wheels.  Then, sorting by platform compatibility tags
becomes a matter of in-group ordering.  Hopefully this also avoids
discussing the existing ordering algorithm.

Signed-off-by: Michał Górny <mgorny@quansight.com>
Co-authored-by: konsti <konstin@mailbox.org>
Signed-off-by: Michał Górny <mgorny@quansight.com>
Signed-off-by: Michał Górny <mgorny@quansight.com>
Update Change History (11-May-2026)
@konstin konstin requested review from dstufft and warsaw as code owners May 11, 2026 13:21
@read-the-docs-community

read-the-docs-community Bot commented May 11, 2026

Copy link
Copy Markdown

Documentation build overview

📚 pep-previews | 🛠️ Build #32976557 | 📁 Comparing f904447 against latest (0cde95d)

  🔍 Preview build  

740 files changed · ± 740 modified

± Modified

Comment thread peps/pep-0825.rst Outdated
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst Outdated
Comment thread peps/pep-0825.rst Outdated
Comment thread peps/pep-0825.rst Outdated
konstin and others added 6 commits May 11, 2026 23:00
Co-authored-by: Paul Moore <p.f.moore@gmail.com>
Signed-off-by: Michał Górny <mgorny@quansight.com>
Signed-off-by: Michał Górny <mgorny@quansight.com>
Signed-off-by: Michał Górny <mgorny@quansight.com>
Signed-off-by: Michał Górny <mgorny@quansight.com>
Given it came up more than once already, I suppose it makes sense to
point it out explicitly, even though it technically falls under
"compatibility".

Signed-off-by: Michał Górny <mgorny@quansight.com>

@rgommers rgommers left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I went through all open comments; it doesn't seem like there is anything to change right now. Given that this PR is meant as clarifications and textual improvements to the currently published PEP text, it looks to me like it can be merged as is. Open comments about textual details have been answered. More substantial content discussions belong on Discourse.

Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst
Comment thread peps/pep-0825.rst Outdated
@dstufft dstufft merged commit e7a60c2 into python:main Jul 2, 2026
5 checks passed
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.

7 participants