PEP 699: Follow standard deprecation policy (#2927)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
This commit is contained in:
Ken Jin 2022-12-22 22:41:33 +08:00 committed by GitHub
parent 58d49df46a
commit 574e82c2f4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 5 deletions

View File

@ -64,10 +64,9 @@ Certain extensions use ``ma_version_tag`` for fast dictionary or globals
lookups. For example,
`Cython uses the field for fast dynamic module variable lookups <https://github.com/cython/cython/blob/169876872f3cb6198971a1db07e5b8a9d12b3dac/Cython/Utility/ObjectHandling.c#L1556>`_.
Since this field is private and makes no guarantees on backwards compatibility,
this PEP proposes to repeal :pep:`509` immediately within the next CPython
version. A function for fast cached dictionary lookups may be provided as an
alternative feature to replace directly accessing ``ma_version_tag``.
This PEP proposes to emit a compiler warning when accessing ``ma_version_tag``.
After two consecutive version releases with warnings, ``ma_version_tag``
will be removed, in line with :pep:`387`.
The biggest user the author could find for this field was Cython.
Discussions with a Cython maintainer indicated that
@ -96,7 +95,8 @@ Special Thanks
==============
Thanks to C.A.M. Gerlach for edits and wording changes to this document.
Thanks also to Mark Shannon and Kumar Aditya for providing possible
implementations.
Copyright
=========