Other Language Changes
======================
-* The compiler now strips common common leading whitespace
+* The compiler now strips common leading whitespace
from every line in a docstring.
This reduces the size of the :term:`bytecode cache <bytecode>`
(such as ``.pyc`` files), with reductions in file size of around 5%,
It can be used instead of ``'u'`` type code, which is deprecated.
(Contributed by Inada Naoki in :gh:`80480`.)
-* Add ``clear()`` method in order to implement ``MutableSequence``.
+* Add ``clear()`` method in order to implement :class:`~collections.abc.MutableSequence`.
(Contributed by Mike Zimin in :gh:`114894`.)
ast
io
--
-* The :class:`io.IOBase` finalizer now logs the ``close()`` method errors with
+* The :class:`io.IOBase` finalizer now logs errors raised by the ``close()`` method with
:data:`sys.unraisablehook`. Previously, errors were ignored silently by default,
and only logged in :ref:`Python Development Mode <devmode>` or on :ref:`Python
built on debug mode <debug-build>`.
mmap
----
-* The :class:`mmap.mmap` class now has an :meth:`~mmap.mmap.seekable` method
+* The :class:`mmap.mmap` class now has a :meth:`~mmap.mmap.seekable` method
that can be used when a seekable file-like object is required.
The :meth:`~mmap.mmap.seek` method now returns the new absolute position.
(Contributed by Donghee Na and Sylvie Liberman in :gh:`111835`.)
pdb
---
-* Add ability to move between chained exceptions during post mortem debugging in :func:`~pdb.pm` using
+* Add ability to move between chained exceptions during post-mortem debugging in :func:`~pdb.pm` using
the new ``exceptions [exc_number]`` command for Pdb. (Contributed by Matthias
Bussonnier in :gh:`106676`.)
more situations. Notably in the default case of ``close_fds=True`` on more
recent versions of platforms including Linux, FreeBSD, and Solaris where the
C library provides :c:func:`!posix_spawn_file_actions_addclosefrom_np`.
- On Linux this should perform similar to our existing Linux :c:func:`!vfork`
+ On Linux this should perform similarly to the existing Linux :c:func:`!vfork`
based code. A private control knob :attr:`!subprocess._USE_POSIX_SPAWN` can
be set to ``False`` if you need to force :mod:`subprocess` not to ever use
:func:`os.posix_spawn`. Please report your reason and platform details in
sys
---
-* Add the :func:`sys._is_interned` function to test if the string was interned.
+* Add the :func:`sys._is_interned` function to test if a string was interned.
This function is not guaranteed to exist in all implementations of Python.
(Contributed by Serhiy Storchaka in :gh:`78573`.)
----
* On Windows, :func:`time.monotonic()` now uses the
- ``QueryPerformanceCounter()`` clock to have a resolution better than 1 us,
+ ``QueryPerformanceCounter()`` clock to have a resolution better than 1 μs,
instead of the ``GetTickCount64()`` clock which has a resolution of 15.6 ms.
(Contributed by Victor Stinner in :gh:`88494`.)
* Add new optional keyword-only parameter *return_ints* in
the :meth:`!Text.count` method.
- Passing ``return_ints=True`` makes it always returning the single count
+ Passing ``return_ints=True`` makes it always return the single count
as an integer instead of a 1-tuple or ``None``.
(Contributed by Serhiy Storchaka in :gh:`97928`.)
types
-----
-* :class:`~types.SimpleNamespace` constructor now allows specifying initial
- values of attributes as a positional argument which must be a mapping or
+* The :class:`~types.SimpleNamespace` constructor now allows specifying initial
+ values of attributes as a positional argument, which must be a mapping or
an iterable of key-value pairs.
(Contributed by Serhiy Storchaka in :gh:`108191`.)
(Contributed by Erlend E. Aasland in :gh:`107948` and :gh:`108278`.)
-* :mod:`sys`: :func:`sys._enablelegacywindowsfsencoding` function.
+* :mod:`sys`: The :func:`sys._enablelegacywindowsfsencoding` function is deprecated.
Replace it with the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment variable.
(Contributed by Inada Naoki in :gh:`73427`.)
deprecated. Passing ``None`` to the 'fields' parameter
(``NT = NamedTuple("NT", None)`` or ``TD = TypedDict("TD", None)``) is also
deprecated. Both will be disallowed in Python 3.15. To create a NamedTuple
- class with 0 fields, use ``class NT(NamedTuple): pass`` or
- ``NT = NamedTuple("NT", [])``. To create a TypedDict class with 0 fields, use
+ class with zero fields, use ``class NT(NamedTuple): pass`` or
+ ``NT = NamedTuple("NT", [])``. To create a TypedDict class with zero fields, use
``class TD(TypedDict): pass`` or ``TD = TypedDict("TD", {})``.
(Contributed by Alex Waygood in :gh:`105566` and :gh:`105570`.)
* :ref:`user-defined-funcs`:
Assignment to a function's :attr:`~function.__code__` attribute where the new code
- object's type does not match the function's type, is deprecated. The
+ object's type does not match the function's type is deprecated. The
different types are: plain function, generator, async generator and
coroutine.
(Contributed by Irit Katriel in :gh:`81137`.)
(Contributed by Victor Stinner in :gh:`116936`.)
* Add two new functions to the C-API, :c:func:`PyRefTracer_SetTracer` and
- :c:func:`PyRefTracer_GetTracer`, that allows to track object creation and
+ :c:func:`PyRefTracer_GetTracer`, that allow to track object creation and
destruction the same way the :mod:`tracemalloc` module does. (Contributed
by Pablo Galindo in :gh:`93502`.)
projects / thirdparty / Python / cpython.git / commitdiff
