Mark various accepted PEPs as Final

[ZeroIntensity]

I didn't touch PEPs that already have a PR marking them as final. For the packaging PEPs, I only finalized those that already have a .. canonical-pypa-spec marker. I don't know enough about packaging to dig through the spec and find links for the others.

[read-the-docs-community]

Documentation build overview

📚 pep-previews | 🛠️ Build #33146527 | 📁 Comparing 3f5e7c6 against latest (fc7b518)

🔍 Preview build

711 files changed · ± 711 modified

±Modified

• index.html
• numerical/index.html
• pep-0000/index.html
• pep-0001/index.html
• pep-0002/index.html
• pep-0003/index.html
• pep-0004/index.html
• pep-0005/index.html
• pep-0006/index.html
• pep-0007/index.html
• and 701 more...

[encukou]

Thanks for the nudge!

For my 3.15 PEPs (793, 803, 820), I want to go through them once again and note any surprises and changes found during implementation. Since there will be some of that, I want to get SC approval before marking them Final.
(But before that, docs!)

[brettcannon]

This is not final yet; tools have not rolled out support.

[ZeroIntensity]

Okay, I reverted it.

Out of curiosity, why does packaging have a different definition of "Final" than standards? For standards, "Final" means "implemented", not "used by users".

[merwok]

Brett means this is not implemented by tools.

[ZeroIntensity]

I know -- my question was why we have a process difference between packaging and standards PEPs. Standards PEPs are marked as final when they're officialized in CPython, not when downstream users start using it. I guess it's because there's no CPython equivalent for packaging?

[merwok]

That’s what I am trying to say: this is not about a percentage of end users using the feature described in the PEP, but initial implementation by relevant projects, like the packaging library for core formats, pip/uv for installer things, pypi for index standards.

[ZeroIntensity]

For my 3.15 PEPs (793, 803, 820), I want to go through them once again and note any surprises and changes found during implementation. Since there will be some of that, I want to get SC approval before marking them Final.

No problem, reverted it. I think as long as there's a clear path to "Final", it's no big deal -- I got the impression that Hugo was getting a little frustrated by the lack of communication from PEP authors, so thanks for clarifying :)

[brettcannon]

Approving because my PEP was removed. 😉

[hugovk]

For the packaging PEPs, do they need to be implemented by tools before marking Final?

[ZeroIntensity]

For the packaging PEPs, do they need to be implemented by tools before marking Final?

To be blunt: I have no idea. Brett's comment suggests that they're supposed to wait, but I don't think it makes much sense to do so -- for example, would you consider the C23 standard as "not done" simply because there's not full compiler support for it yet?

[hugovk]

Let's ask @pfmoore: are these packaging PEPs ready to be marked Final?

• PEP 668: Marking Python base environments as “externally managed”
• PEP 691: JSON-based Simple API for Python Package Indexes
• PEP 753: Uniform project URLs in core metadata
• PEP 770: Improving measurability of Python packages with Software Bill-of-Materials

[pfmoore]

Yeah, those 4 packaging PEPs can be marked final. We only need implementations in the case of provisional acceptance where that's an explicit condition. And all 4 of those have been implemented in any case, I believe.

[hugovk]

Thanks!

[merwok]

(Why was it impossible to use :ref:some text <dist-info-sbom-ref> here?)

[ZeroIntensity]

There is no ref: https://github.com/pypa/packaging.python.org/blob/c31a69a5a951d3e0ba0200fe011c5fd90aff8279/source/specifications/binary-distribution-format.rst#L278-L280

[merwok]

Ah! Headings always create a ref, but its value derives from the heading content (so I can see why your tries didn’t find it, given inline markup in the title), and are prone to breaking for any change. Hopefully the doc will remain stable, and/or a linkcheck job in this repo can catch breakage.

[ZeroIntensity]

Who controls the PyPA spec page (or is it us)? We could just ask nicely to add a ref there.

[hugovk]

The PyPA folk do, you can open a PR at https://github.com/pypa/packaging.python.org.

[ZeroIntensity]

pypa/packaging.python.org#2075