peps icon indicating copy to clipboard operation
peps copied to clipboard

Mark remaining completed PEPs as Final

Open CAM-Gerlach opened this issue 3 years ago • 4 comments

The other PEPs that look like good candidates for being marked final are listed as follows. I've excluded PEPs that were approved for >3.11, refer to removals/changes planned for future version (e.g. PEP 594) or are otherwise known to be not yet final, and list special cases, PEPs I'm unsure about and typing PEPs (which may be contingent on implementation in mainstream type checkers) separately.

@gustavgransbo If you'd like to help, feel free to go ahead and submit a PR for each PEP, pinging any authors not already listed as codeowners.

The PEPs that are implemented in released versions and have no outstanding considerations I'm aware of:

  • [x] PEP-560 Core support for typing module and generic types [^1]: https://github.com/python/peps/pull/3570
  • [ ] PEP-578 Python Runtime Audit Hooks
  • [ ] PEP-590 Vectorcall: a fast calling protocol for CPython: https://github.com/python/peps/pull/3598
  • [ ] PEP-615 Support for the IANA Time Zone Database in the Standard Library: https://github.com/python/peps/pull/3592
  • [x] PEP-617 New PEG parser for CPython: https://github.com/python/peps/pull/3596
  • [x] PEP-634 Structural Pattern Matching: Specification
  • [x] PEP-654 Exception Groups and except*
  • [x] PEP-678 Enriching Exceptions with Notes
  • [x] PEP-680 tomllib: Support for Parsing TOML in the Standard Library
  • [x] PEP-3121 Extension Module Initialization and Finalization

[^1]: Typing-related, but principally deals with core CPython, not type checkers

There are also some special cases:

  • [ ] PEP-602 Annual Release Cycle for Python: Should be recategorized as an Active Process PEP: https://github.com/python/peps/pull/3736
  • [ ] PEP-581 Using GitHub Issues for CPython: Since the PEP's content is tightly focused on the rationale for choosing GitHub rather than the current, active process for using it and is thus now of historical rather than procedural value, it should be marked Final (rather than Active) like other transition-oriented Process PEPs have.

~I'm not sure about the following:~

  • PEP-590 Vectorcall: a fast calling protocol for CPython: ~Implemented, but there is currently active work in 3.12 to better expose both ends of the protocol via the CPython API, and have the changes in the Finalizing the API section been addressed? @encukou @markshannon any insight here?~ Confirmed by @encukou to be fully implemented and should be marked Final; added above.
  • PEP-3121 Extension Module Initialization and Finalization: ~Accepted from all the way back in 3.0, but I'm not sure whether this should be considered Final yet, since its been a long time and there is still ongoing work in PEP 687 that might be related. @encukou @erlend-aasland any insight?~ Confirmed by @encukou to be Final, as the API it describes is implemented and building on top of it is a topic for future PEPs.

There's also the Accepted typing PEPs, which might also depend on implementation status in the major typecheckers as well as being formally documented the appropriate places, since that is generally the majority of actual implementation work; @JelleZijlstra would be much better informed about that. Here's the raw list:

544                   Protocols: Structural subtyping (static duck typing)  typing
563                                    Postponed Evaluation of Annotations  typing
586                                                          Literal Types  typing
589        TypedDict: Type Hints for Dictionaries with a Fixed Set of Keys  typing
591                                     Adding a final qualifier to typing  typing
593                             Flexible function and variable annotations  typing
604                                 Allow writing union types as ``X | Y``  typing
612                                      Parameter Specification Variables  typing
613                                                  Explicit Type Aliases  typing
646                                                      Variadic Generics  typing
647                                               User-Defined Type Guards  typing
655  Marking individual TypedDict items as required or potentially-missing  typing
673                                                              Self Type  typing
675                                          Arbitrary Literal String Type  typing
681                                                  Data Class Transforms  typing

Finally, I've left the 8000-series PEPs for a separate issue.

CAM-Gerlach avatar Nov 07 '22 00:11 CAM-Gerlach

Thank you for tying the loose ends!

PEP-590 Vectorcall: a fast calling protocol for CPython is implemented, but there is currently active work in 3.12 to better expose both ends of the protocol via the CPython API, and have the changes in the Finalizing the API section been addressed?

The finalization was done in 3.9 as planned. The API is being added to Limited API in 3.12, but that's not part of the PEP. Just more work in the area. So, it should be marked Final.

PEP-3121 Extension Module Initialization and Finalization: Accepted from all the way back in 3.0, but I'm not sure whether this should be considered Final yet, since its been a long time and there is still ongoing work in PEP 687 that might be related.

There were many PEPs that build on top of this one, and more are probably to come, but the API specified in PEP-3121 should still work – as it did in 3.0. This PEP should be Final as well.

As for typing PEPs, AFAIK many are still missing documentation.

encukou avatar Nov 07 '22 12:11 encukou

Thanks @encukou ! I've updated the list above to reflect both.

CAM-Gerlach avatar Nov 08 '22 02:11 CAM-Gerlach

Thank you for providing this list @CAM-Gerlach! I can probably help out with some of these, but others are more than welcome to contribute as well.

gustavgransbo avatar Nov 09 '22 18:11 gustavgransbo

Excelente

Karliz24 avatar Jan 23 '24 18:01 Karliz24

Closed, all the PEPs with checkboxes have been done.

Let's create new issues such as https://github.com/python/peps/issues/3579 and https://github.com/python/peps/issues/3781 for tracking any more that need doing.

hugovk avatar Jun 03 '24 14:06 hugovk