Skip to content

PEP 817: Wheel Variants: switch to Informational, major update - #5149

Open
rgommers wants to merge 3 commits into
python:mainfrom
rgommers:pep-817-integration
Open

rgommers wants to merge 3 commits into
python:mainfrom
rgommers:pep-817-integration

Conversation

@rgommers

Copy link
Copy Markdown
Contributor

This is a large update to the first PEP on Wheel Variants, turning it from an all-in-one Standards Track PEP to an Informational PEP that will serve as the umbrella for the various Standards Track PEPs.

The Specification section has been removed, as that doesn't fit in an Informational PEP.

The Design overview section has been updated, to bring it in line with PEP 825 and current design of the next PEPs.

The largest addition is a side-by-side comparison of five design options, which are the ones we've considered and those that have been brought up in the various discussions on DPO. It's deliberately side-by-side, so reviewers can understand how we arrived at the current design.

Other sections that are updated:

  • Abstract
  • Overview of Standards Track PEPs
  • Backwards Compatibility
  • Security Implications
  • Change History
  • Adoption and Rollout (new)

The Motivation and Prior Art sections were not touched significantly.

  • 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)

DEKHTIARJonathan and others added 3 commits September 30, 2026 09:10
Co-authored-by: rgommers <ralf.gommers@gmail.com>
The largest addition is a side-by-side comparison of five design options, which
are the ones we've considered and those that have been brought up in the
various discussions on DPO. It's deliberately side-by-side, so reviewers can
understand how we arrived at the current design.

Note that in a call a while back, I showed a similar table to the one added
now, but with more decision criteria and explicit scoring (good, medium, bad
with emoji's); I decided against that because any scoring as well as the
choices of more detailed criteria can all be argued with, while the version in
this PR is as objective as possible.

Other sections that are updated:

- Abstract
- Overview of Standards Track PEPs
- Backwards Compatibility
- Security Implications
- Change History
- Adoption and Rollout (new)

Sections added or touched in the design overview:

- Depending on a variant-enabled package (new; this question has come up very
  regularly)
- Package ABI matching (needed a tweak)

The Motivation and Prior Art sections were not touched significantly.
@read-the-docs-community

Copy link
Copy Markdown

This branch has not been deployed

No deployments
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.

3 participants