@@ -239,7 +239,7 @@ inspect
239
239
-------
240
240
241
241
* Add:func: `inspect.markcoroutinefunction ` to mark sync functions that return
242
- a:term: `coroutine ` for use with:func: `iscoroutinefunction `.
242
+ a:term: `coroutine ` for use with:func: `inspect. iscoroutinefunction `.
243
243
(Contributed Carlton Gibson in:gh: `99247 `.)
244
244
245
245
pathlib
264
264
* Pseudo instruction opcodes (which are used by the compiler but
265
265
do not appear in executable bytecode) are now exposed in the
266
266
:mod: `dis ` module.
267
- :data: ` ~dis. HAVE_ARGUMENT ` is still relevant to real opcodes,
267
+ :opcode: ` HAVE_ARGUMENT ` is still relevant to real opcodes,
268
268
but it is not useful for pseudo instructions. Use the new
269
269
:data: `~dis.hasarg ` collection instead.
270
270
(Contributed by Irit Katriel in:gh: `94216 `.)
@@ -383,7 +383,7 @@ Optimizations
383
383
(Contributed by Kevin Modzelewski in:gh: `90536 `.)
384
384
385
385
* Speed up the regular expression substitution (functions:func: `re.sub ` and
386
- :func: `re.subn ` and corresponding:class: `re.Pattern ` methods) for
386
+ :func: `re.subn ` and corresponding:class: `! re.Pattern ` methods) for
387
387
replacement strings containing group references by 2--3 times.
388
388
(Contributed by Serhiy Storchaka in:gh: `91524 `.)
389
389
@@ -440,7 +440,7 @@ Deprecated
440
440
:exc: `ImportWarning `).
441
441
(Contributed by Brett Cannon in:gh: `65961 `.)
442
442
443
- * The:meth: `~asyncio.DefaultEventLoopPolicy. get_event_loop ` method of the
443
+ * The:meth: `~asyncio.get_event_loop ` method of the
444
444
default event loop policy now emits a:exc: `DeprecationWarning ` if there
445
445
is no current event loop set and it decides to create one.
446
446
(Contributed by Serhiy Storchaka and Guido van Rossum in:gh: `100160 `.)
@@ -485,23 +485,23 @@ Modules (see :pep:`594`):
485
485
486
486
APIs:
487
487
488
- *:class: `configparser.LegacyInterpolation ` (:gh: `90765 `)
488
+ *:class: `! configparser.LegacyInterpolation ` (:gh: `90765 `)
489
489
*:func: `locale.getdefaultlocale ` (:gh: `90817 `)
490
- *:meth: `turtle.RawTurtle.settiltangle ` (:gh: `50096 `)
491
- *:func: `unittest.findTestCases ` (:gh: `50096 `)
492
- *:func: `unittest.makeSuite ` (:gh: `50096 `)
493
- *:func: `unittest.getTestCaseNames ` (:gh: `50096 `)
494
- *:class: `webbrowser.MacOSX ` (:gh: `86421 `)
490
+ *:meth: `! turtle.RawTurtle.settiltangle ` (:gh: `50096 `)
491
+ *:func: `! unittest.findTestCases ` (:gh: `50096 `)
492
+ *:func: `! unittest.makeSuite ` (:gh: `50096 `)
493
+ *:func: `! unittest.getTestCaseNames ` (:gh: `50096 `)
494
+ *:class: `! webbrowser.MacOSX ` (:gh: `86421 `)
495
495
496
496
Pending Removal in Python 3.14
497
497
------------------------------
498
498
499
499
* Deprecated the following:mod: `importlib.abc ` classes, scheduled for removal in
500
500
Python 3.14:
501
501
502
- *:class: `importlib.abc.ResourceReader `
503
- *:class: `importlib.abc.Traversable `
504
- *:class: `importlib.abc.TraversableResources `
502
+ *:class: `! importlib.abc.ResourceReader `
503
+ *:class: `! importlib.abc.Traversable `
504
+ *:class: `! importlib.abc.TraversableResources `
505
505
506
506
Use:mod: `importlib.resources.abc ` classes instead:
507
507
@@ -510,7 +510,7 @@ Pending Removal in Python 3.14
510
510
511
511
(Contributed by Jason R. Coombs and Hugo van Kemenade in:gh: `93963 `.)
512
512
513
- * Creating:c:data: ` immutable types< Py_TPFLAGS_IMMUTABLETYPE> ` with mutable
513
+ * Creating immutable types( :data: ` Py_TPFLAGS_IMMUTABLETYPE `) with mutable
514
514
bases using the C API.
515
515
516
516
* ``__package__ `` and ``__cached__ `` will cease to be set or taken
@@ -639,11 +639,11 @@ Removed
639
639
640
640
* Remove ``io.OpenWrapper `` and ``_pyio.OpenWrapper ``, deprecated in Python
641
641
3.10: just use:func: `open ` instead. The:func: `open ` (:func: `io.open `)
642
- function is a built-in function. Since Python 3.10,:func: `_pyio.open ` is
642
+ function is a built-in function. Since Python 3.10,:func: `! _pyio.open ` is
643
643
also a static method.
644
644
(Contributed by Victor Stinner in:gh: `94169 `.)
645
645
646
- * Remove the:func: `ssl.RAND_pseudo_bytes ` function, deprecated in Python 3.6:
646
+ * Remove the:func: `! ssl.RAND_pseudo_bytes ` function, deprecated in Python 3.6:
647
647
use:func: `os.urandom ` or:func: `ssl.RAND_bytes ` instead.
648
648
(Contributed by Victor Stinner in:gh: `94199 `.)
649
649
@@ -653,13 +653,13 @@ Removed
653
653
extension if it was not present.
654
654
(Contributed by Victor Stinner in:gh: `94196 `.)
655
655
656
- * Remove the:func: `ssl.match_hostname ` function. The
657
- :func: ` ssl.match_hostname ` was deprecated in Python 3.7. OpenSSL performs
656
+ * Remove the:func: `! ssl.match_hostname ` function.
657
+ It was deprecated in Python 3.7. OpenSSL performs
658
658
hostname matching since Python 3.7, Python no longer uses the
659
- :func: `ssl.match_hostname ` function.
659
+ :func: `! ssl.match_hostname ` function.
660
660
(Contributed by Victor Stinner in:gh: `94199 `.)
661
661
662
- * Remove the:func: `locale.format ` function, deprecated in Python 3.7:
662
+ * Remove the:func: `! locale.format ` function, deprecated in Python 3.7:
663
663
use:func: `locale.format_string ` instead.
664
664
(Contributed by Victor Stinner in:gh: `94226 `.)
665
665
@@ -669,9 +669,9 @@ Removed
669
669
a C implementation of:func: `~hashlib.pbkdf2_hmac() ` which is faster.
670
670
(Contributed by Victor Stinner in:gh: `94199 `.)
671
671
672
- *:mod: `xml.etree `: Remove the ``ElementTree.Element.copy() `` method of the
672
+ *:mod: `xml.etree.ElementTree `: Remove the ``ElementTree.Element.copy() `` method of the
673
673
pure Python implementation, deprecated in Python 3.10, use the
674
- :func: `copy.copy ` function instead. The C implementation of:mod: `xml.etree `
674
+ :func: `copy.copy ` function instead. The C implementation of:mod: `xml.etree.ElementTree `
675
675
has no ``copy() `` method, only a ``__copy__() `` method.
676
676
(Contributed by Victor Stinner in:gh: `94383 `.)
677
677
@@ -680,10 +680,10 @@ Removed
680
680
:pep: `451 ` for the rationale.
681
681
(Contributed by Victor Stinner in:gh: `94379 `.)
682
682
683
- * Remove the:func: `ssl.wrap_socket ` function, deprecated in Python 3.7:
683
+ * Remove the:func: `! ssl.wrap_socket ` function, deprecated in Python 3.7:
684
684
instead, create a:class: `ssl.SSLContext ` object and call its
685
685
:class: `ssl.SSLContext.wrap_socket ` method. Any package that still uses
686
- :func: `ssl.wrap_socket ` is broken and insecure. The function neither sends a
686
+ :func: `! ssl.wrap_socket ` is broken and insecure. The function neither sends a
687
687
SNI TLS extension nor validates server hostname. Code is subject to `CWE-295
688
688
<https://cwe.mitre.org/data/definitions/295.html> `_: Improper Certificate
689
689
Validation.
@@ -850,7 +850,7 @@ New Features
850
850
The:const: `Py_TPFLAGS_HAVE_VECTORCALL ` flag is now removed from a class
851
851
when the class's:py:meth: `~object.__call__ ` method is reassigned.
852
852
This makes vectorcall safe to use with mutable types (i.e. heap types
853
- without the:const: `immutable < Py_TPFLAGS_IMMUTABLETYPE> ` flag ).
853
+ without theimmutable flag, :const: `Py_TPFLAGS_IMMUTABLETYPE ` ).
854
854
Mutable types that do not override:c:member: `~PyTypeObject.tp_call ` now
855
855
inherit the ``Py_TPFLAGS_HAVE_VECTORCALL `` flag.
856
856
(Contributed by Petr Viktorin in:gh: `93274 `.)
@@ -883,7 +883,7 @@ New Features
883
883
(Contributed by Andrew Frost in:gh: `92257 `.)
884
884
885
885
* The C API now permits registering callbacks via:c:func: `PyDict_AddWatcher `,
886
- :c:func: `PyDict_AddWatch ` and related APIs to be called whenever a dictionary
886
+ :c:func: `PyDict_Watch ` and related APIs to be called whenever a dictionary
887
887
is modified. This is intended for use by optimizing interpreters, JIT
888
888
compilers, or debuggers.
889
889
(Contributed by Carl Meyer in:gh: `91052 `.)
@@ -958,9 +958,9 @@ Porting to Python 3.12
958
958
supported, but does not fully support multiple inheritance
959
959
(:gh: `95589 `), and performance may be worse.
960
960
Classes declaring:const: `Py_TPFLAGS_MANAGED_DICT ` should call
961
- :c:func: `_PyObject_VisitManagedDict ` and:c:func: `_PyObject_ClearManagedDict `
961
+ :c:func: `! _PyObject_VisitManagedDict ` and:c:func: `! _PyObject_ClearManagedDict `
962
962
to traverse and clear their instance's dictionaries.
963
- To clear weakrefs, call:c:func: `PyObject_ClearWeakRefs `, as before.
963
+ To clear weakrefs, call:c:func: `! PyObject_ClearWeakRefs `, as before.
964
964
965
965
* The:c:func: `PyUnicode_FSDecoder ` function no longer accepts bytes-like
966
966
paths, like:class: `bytearray ` and:class: `memoryview ` types: only the exact
@@ -993,17 +993,17 @@ Deprecated
993
993
*:c:var: `Py_HashRandomizationFlag `: use:c:member: `PyConfig.use_hash_seed `
994
994
and:c:member: `PyConfig.hash_seed `
995
995
*:c:var: `Py_IsolatedFlag `: use:c:member: `PyConfig.isolated `
996
- *:c:var: `Py_LegacyWindowsFSEncodingFlag `: use:c:member: `PyConfig .legacy_windows_fs_encoding `
996
+ *:c:var: `Py_LegacyWindowsFSEncodingFlag `: use:c:member: `PyPreConfig .legacy_windows_fs_encoding `
997
997
*:c:var: `Py_LegacyWindowsStdioFlag `: use:c:member: `PyConfig.legacy_windows_stdio `
998
- *:c:var: `Py_FileSystemDefaultEncoding `: use:c:member: `PyConfig.filesystem_encoding `
999
- *:c:var: `Py_FileSystemDefaultEncodeErrors `: use:c:member: `PyConfig.filesystem_errors `
1000
- *:c:var: `Py_UTF8Mode `: use:c:member: `PyPreConfig.utf8_mode ` (see:c:func: `Py_PreInitialize `)
998
+ *:c:var: `! Py_FileSystemDefaultEncoding `: use:c:member: `PyConfig.filesystem_encoding `
999
+ *:c:var: `! Py_FileSystemDefaultEncodeErrors `: use:c:member: `PyConfig.filesystem_errors `
1000
+ *:c:var: `! Py_UTF8Mode `: use:c:member: `PyPreConfig.utf8_mode ` (see:c:func: `Py_PreInitialize `)
1001
1001
1002
1002
The:c:func: `Py_InitializeFromConfig ` API should be used with
1003
1003
:c:type: `PyConfig ` instead.
1004
1004
(Contributed by Victor Stinner in:gh: `77782 `.)
1005
1005
1006
- * Creating:c:data : `immutable types <Py_TPFLAGS_IMMUTABLETYPE> ` with mutable
1006
+ * Creating:const : `immutable types <Py_TPFLAGS_IMMUTABLETYPE> ` with mutable
1007
1007
bases is deprecated and will be disabled in Python 3.14.
1008
1008
1009
1009
* The ``structmember.h `` header is deprecated, though it continues to be
@@ -1053,15 +1053,15 @@ Removed
1053
1053
1054
1054
* Legacy Unicode APIs have been removed. See:pep: `623 ` for detail.
1055
1055
1056
- *:c:macro: `PyUnicode_WCHAR_KIND `
1057
- *:c:func: `PyUnicode_AS_UNICODE `
1058
- *:c:func: `PyUnicode_AsUnicode `
1059
- *:c:func: `PyUnicode_AsUnicodeAndSize `
1060
- *:c:func: `PyUnicode_AS_DATA `
1061
- *:c:func: `PyUnicode_FromUnicode `
1062
- *:c:func: `PyUnicode_GET_SIZE `
1063
- *:c:func: `PyUnicode_GetSize `
1064
- *:c:func: `PyUnicode_GET_DATA_SIZE `
1056
+ *:c:macro: `! PyUnicode_WCHAR_KIND `
1057
+ *:c:func: `! PyUnicode_AS_UNICODE `
1058
+ *:c:func: `! PyUnicode_AsUnicode `
1059
+ *:c:func: `! PyUnicode_AsUnicodeAndSize `
1060
+ *:c:func: `! PyUnicode_AS_DATA `
1061
+ *:c:func: `! PyUnicode_FromUnicode `
1062
+ *:c:func: `! PyUnicode_GET_SIZE `
1063
+ *:c:func: `! PyUnicode_GetSize `
1064
+ *:c:func: `! PyUnicode_GET_DATA_SIZE `
1065
1065
1066
1066
* Remove the ``PyUnicode_InternImmortal() `` function and the
1067
1067
``SSTATE_INTERNED_IMMORTAL `` macro.