@@ -612,71 +612,6 @@ module_name
612612
613613
614614
615- Deprecated
616- ==========
617-
618- New deprecations
619- ----------------
620-
621- * CLI:
622-
623- * Deprecate :option: `-b ` and :option: `!-bb ` command-line options
624- and schedule them to become no-op in Python 3.17.
625- These were primarily helpers for the Python 2 -> 3 transition.
626- Starting with Python 3.17, no :exc: `BytesWarning ` will be raised
627- for these cases; use a type checker instead.
628-
629- (Contributed by Nikita Sobolev in :gh: `136355 `.)
630-
631- * :mod: `hashlib `:
632-
633- * In hash function constructors such as :func: `~hashlib.new ` or the
634- direct hash-named constructors such as :func: `~hashlib.md5 ` and
635- :func: `~hashlib.sha256 `, their optional initial data parameter could
636- also be passed a keyword argument named ``data= `` or ``string= `` in
637- various :mod: `hashlib ` implementations.
638-
639- Support for the ``string `` keyword argument name is now deprecated and
640- is slated for removal in Python 3.19. Prefer passing the initial data as
641- a positional argument for maximum backwards compatibility.
642-
643- (Contributed by Bénédikt Tran in :gh: `134978 `.)
644-
645- * ``__version__ ``
646-
647- * The ``__version__ `` attribute has been deprecated in these standard library
648- modules and will be removed in Python 3.20.
649- Use :py:data: `sys.version_info ` instead.
650-
651- - :mod: `argparse `
652- - :mod: `csv `
653- - :mod: `!ctypes.macholib `
654- - :mod: `ipaddress `
655- - :mod: `json `
656- - :mod: `logging ` (``__date__ `` also deprecated)
657- - :mod: `optparse `
658- - :mod: `pickle `
659- - :mod: `platform `
660- - :mod: `re `
661- - :mod: `socketserver `
662- - :mod: `tabnanny `
663- - :mod: `tkinter.font `
664- - :mod: `tkinter.ttk `
665-
666- (Contributed by Hugo van Kemenade in :gh: `76007 `.)
667-
668- .. Add deprecations above alphabetically, not here at the end.
669-
670- .. include :: ../deprecations/pending-removal-in-3.16.rst
671-
672- .. include :: ../deprecations/pending-removal-in-3.17.rst
673-
674- .. include :: ../deprecations/pending-removal-in-3.19.rst
675-
676- .. include :: ../deprecations/pending-removal-in-3.20.rst
677-
678- .. include :: ../deprecations/pending-removal-in-future.rst
679-
680615Removed
681616=======
682617
@@ -816,6 +751,72 @@ zipimport
816751 (Contributed by Jiahao Li in :gh: `133656 `.)
817752
818753
754+ Deprecated
755+ ==========
756+
757+ New deprecations
758+ ----------------
759+
760+ * CLI:
761+
762+ * Deprecate :option: `-b ` and :option: `!-bb ` command-line options
763+ and schedule them to become no-op in Python 3.17.
764+ These were primarily helpers for the Python 2 -> 3 transition.
765+ Starting with Python 3.17, no :exc: `BytesWarning ` will be raised
766+ for these cases; use a type checker instead.
767+
768+ (Contributed by Nikita Sobolev in :gh: `136355 `.)
769+
770+ * :mod: `hashlib `:
771+
772+ * In hash function constructors such as :func: `~hashlib.new ` or the
773+ direct hash-named constructors such as :func: `~hashlib.md5 ` and
774+ :func: `~hashlib.sha256 `, their optional initial data parameter could
775+ also be passed a keyword argument named ``data= `` or ``string= `` in
776+ various :mod: `hashlib ` implementations.
777+
778+ Support for the ``string `` keyword argument name is now deprecated and
779+ is slated for removal in Python 3.19. Prefer passing the initial data as
780+ a positional argument for maximum backwards compatibility.
781+
782+ (Contributed by Bénédikt Tran in :gh: `134978 `.)
783+
784+ * ``__version__ ``
785+
786+ * The ``__version__ `` attribute has been deprecated in these standard library
787+ modules and will be removed in Python 3.20.
788+ Use :py:data: `sys.version_info ` instead.
789+
790+ - :mod: `argparse `
791+ - :mod: `csv `
792+ - :mod: `!ctypes.macholib `
793+ - :mod: `ipaddress `
794+ - :mod: `json `
795+ - :mod: `logging ` (``__date__ `` also deprecated)
796+ - :mod: `optparse `
797+ - :mod: `pickle `
798+ - :mod: `platform `
799+ - :mod: `re `
800+ - :mod: `socketserver `
801+ - :mod: `tabnanny `
802+ - :mod: `tkinter.font `
803+ - :mod: `tkinter.ttk `
804+
805+ (Contributed by Hugo van Kemenade in :gh: `76007 `.)
806+
807+ .. Add deprecations above alphabetically, not here at the end.
808+
809+ .. include :: ../deprecations/pending-removal-in-3.16.rst
810+
811+ .. include :: ../deprecations/pending-removal-in-3.17.rst
812+
813+ .. include :: ../deprecations/pending-removal-in-3.19.rst
814+
815+ .. include :: ../deprecations/pending-removal-in-3.20.rst
816+
817+ .. include :: ../deprecations/pending-removal-in-future.rst
818+
819+
819820Porting to Python 3.15
820821======================
821822
@@ -903,39 +904,6 @@ Porting to Python 3.15
903904 underlying syscall, instead of raising a :exc: `SystemError `.
904905
905906
906- Deprecated C APIs
907- -----------------
908-
909- * For unsigned integer formats in :c:func: `PyArg_ParseTuple `,
910- accepting Python integers with value that is larger than the maximal value
911- for the C type or less than the minimal value for the corresponding
912- signed integer type of the same size is now deprecated.
913- (Contributed by Serhiy Storchaka in :gh: `132629 `.)
914-
915- * :c:func: `PyBytes_FromStringAndSize(NULL, len) <PyBytes_FromStringAndSize> `
916- and :c:func: `_PyBytes_Resize ` are :term: `soft deprecated `,
917- use the :c:type: `PyBytesWriter ` API instead.
918- (Contributed by Victor Stinner in :gh: `129813 `.)
919-
920- * Deprecate :c:member: `~PyComplexObject.cval ` field of the the
921- :c:type: `PyComplexObject ` type.
922- Use :c:func: `PyComplex_AsCComplex ` and :c:func: `PyComplex_FromCComplex `
923- to convert a Python complex number to/from the C :c:type: `Py_complex `
924- representation.
925- (Contributed by Sergey B Kirpichev in :gh: `128813 `.)
926-
927- * Functions :c:func: `_Py_c_sum `, :c:func: `_Py_c_diff `, :c:func: `_Py_c_neg `,
928- :c:func: `_Py_c_prod `, :c:func: `_Py_c_quot `, :c:func: `_Py_c_pow ` and
929- :c:func: `_Py_c_abs ` are :term: `soft deprecated `.
930- (Contributed by Sergey B Kirpichev in :gh: `128813 `.)
931-
932- * :c:member: `~PyConfig.bytes_warning ` is deprecated
933- since 3.15 and will be removed in 3.17.
934- (Contributed by Nikita Sobolev in :gh: `136355 `.)
935-
936-
937- .. Add C API deprecations above alphabetically, not here at the end.
938-
939907Removed C APIs
940908--------------
941909
@@ -1004,3 +972,37 @@ on Python 3.13 and older.
1004972.. |pythoncapi_compat_project | replace :: |pythoncapi_compat_project_link |_
1005973.. |pythoncapi_compat_project_link | replace :: pythoncapi-compat project
1006974.. _pythoncapi_compat_project_link : https://github.com/python/pythoncapi-compat
975+
976+
977+ Deprecated C APIs
978+ -----------------
979+
980+ * For unsigned integer formats in :c:func: `PyArg_ParseTuple `,
981+ accepting Python integers with value that is larger than the maximal value
982+ for the C type or less than the minimal value for the corresponding
983+ signed integer type of the same size is now deprecated.
984+ (Contributed by Serhiy Storchaka in :gh: `132629 `.)
985+
986+ * :c:func: `PyBytes_FromStringAndSize(NULL, len) <PyBytes_FromStringAndSize> `
987+ and :c:func: `_PyBytes_Resize ` are :term: `soft deprecated `,
988+ use the :c:type: `PyBytesWriter ` API instead.
989+ (Contributed by Victor Stinner in :gh: `129813 `.)
990+
991+ * Deprecate :c:member: `~PyComplexObject.cval ` field of the the
992+ :c:type: `PyComplexObject ` type.
993+ Use :c:func: `PyComplex_AsCComplex ` and :c:func: `PyComplex_FromCComplex `
994+ to convert a Python complex number to/from the C :c:type: `Py_complex `
995+ representation.
996+ (Contributed by Sergey B Kirpichev in :gh: `128813 `.)
997+
998+ * Functions :c:func: `_Py_c_sum `, :c:func: `_Py_c_diff `, :c:func: `_Py_c_neg `,
999+ :c:func: `_Py_c_prod `, :c:func: `_Py_c_quot `, :c:func: `_Py_c_pow ` and
1000+ :c:func: `_Py_c_abs ` are :term: `soft deprecated `.
1001+ (Contributed by Sergey B Kirpichev in :gh: `128813 `.)
1002+
1003+ * :c:member: `~PyConfig.bytes_warning ` is deprecated
1004+ since 3.15 and will be removed in 3.17.
1005+ (Contributed by Nikita Sobolev in :gh: `136355 `.)
1006+
1007+
1008+ .. Add C API deprecations above alphabetically, not here at the end.
0 commit comments