+++++++++++
Python News
+++++++++++
What's New in Python 3.14.6 final?
==================================
*Release date: 2026-06-10*
Security
--------
- gh-151159: Update Android and iOS installers to use OpenSSL 3.5.7.
- gh-150599: Fix a possible stack buffer overflow in :mod:`bz2` when a
:class:`bz2.BZ2Decompressor` is reused after a decompression error. The
decompressor now becomes unusable after libbz2 reports an error.
- gh-149835: :func:`shutil.move` now resolves symlinks via
:func:`os.path.realpath` when checking whether the destination is inside
the source directory, preventing a symlink-based bypass of that guard.
- gh-149698: Update bundled `libexpat `_ to
version 2.8.1 for the fix for :cve:`2026-45186`.
- gh-87451: The :mod:`ftplib` module's undocumented ``ftpcp`` function no
longer trusts the IPv4 address value returned from the source server in
response to the ``PASV`` command by default, completing the fix for
CVE-2021-4189. As with :class:`ftplib.FTP`, the former behavior can be
re-enabled by setting the ``trust_server_pasv_ipv4_address`` attribute on
the source :class:`ftplib.FTP` instance to ``True``. Thanks to Qi Deng at
Aurascape AI for the report.
- gh-149486: :func:`tarfile.data_filter` now validates link targets using
the same normalised value that is written to disk, strips trailing
separators from the member name when resolving a symlink's directory, and
rejects link members that would replace the destination directory itself.
This closes several path-traversal bypasses of the ``data`` extraction
filter.
- gh-149079: Fix a potential denial of service in
:func:`unicodedata.normalize`. The canonical ordering step of Unicode
normalization used a quadratic-time insertion sort for reordering
combining characters, which could be exploited with crafted input
containing many combining characters in non-canonical order. Replaced with
a linear-time counting sort for long runs.
- gh-149018: Improved protection against XML hash-flooding attacks in
:mod:`xml.parsers.expat` and :mod:`xml.etree.ElementTree` when Python is
compiled with libExpat 2.8.0 or later.
Core and Builtins
-----------------
- gh-151112: Fix a crash in the compiler that could occur when running out
of memory.
- gh-151126: Fix a crash, when there's no memory left on a device, which
happened in:
- code compilation - :func:`!_winapi.CreateProcess`
Now these places raise proper :exc:`MemoryError` errors.
- gh-150700: Fix a :exc:`SystemError` when compiling a class-scope
comprehension containing a ``lambda`` that references ``__class__``,
``__classdict__``, or ``__conditional_annotations__``. Patch by Bartosz
Sławecki.
- gh-150633: Fix the frozen importer accepting module names with embedded
null bytes, which caused it to bypass the :data:`sys.modules` cache and
create duplicate module objects.
- gh-148613: Fix a data race in the free-threaded build between
:func:`gc.set_threshold` and garbage collection scheduling during object
allocation.
- gh-149156: Fix an intermittent crash after :func:`os.fork` when perf
trampoline profiling is enabled and the child returns through trampoline
frames inherited from the parent process.
- gh-149449: Fix a use-after-free crash when the :mod:`unicodedata` module
was removed from :data:`sys.modules` and garbage-collected between calls
that decode ``\N{...}`` escapes or use the ``namereplace`` codec error
handler.
- gh-150207: Fix a crash when a memory allocation fails during tokenizer
initialization. A proper :exc:`MemoryError` is now raised instead.
- gh-150107: :mod:`asyncio`: ``sendfile()`` and ``sock_sendfile()`` event
loop methods now call ``file.seek(offset)`` if *file* has a ``seek()``
method, even if *offset* is ``0`` (default value).
- gh-150146: Fix a crash on a complex type variable substitution.
``from typing import TypeVar; memoryview[TypeVar("")][*typing.Mapping[...,
...]]`` used to fail due to missing ``NULL`` check on ``_unpack_args`` C
function call.
- gh-149590: Fix crash when faulthandler is imported more than once.
- gh-149816: Fix a race condition in ``_PyBytes_FromList`` in free-threading
mode.
- gh-149816: Fix a race condition in :class:`memoryview` with
free-threading.
- gh-149805: Fix a :exc:`SystemError` when compiling a compiling
``__classdict__`` class annotation. Found by OSS-Fuzz in
:oss-fuzz:`512907042`.
- gh-149738: :mod:`sqlite3`: Disallow removing ``row_factory`` and
``text_factory`` attributes of a connection to prevent a crash on a query.
- gh-139808: Add branch protections for AArch64 (BTI/PAC) in assembly code
used by :option:`-X perf_jit <-X>` (Linux perf profiler integration).
- gh-148450: Fix ``abc.register()`` so it invalidates type version tags for
registered classes.
Library
-------
- gh-151039: Fix a crash when static :mod:`datetime` types outlive the
``_datetime`` module.
- gh-150913: Fix :class:`sqlite3.Blob` slice assignment to raise
:exc:`TypeError` and :exc:`IndexError` for type and size mismatches
respectively, even when the target slice is empty.
- gh-143008: Fix race conditions when re-initializing a
:class:`io.TextIOWrapper` object.
- gh-150750: Fix a race condition in :meth:`collections.deque.index` with
free-threading.
- gh-150685: Update bundled pip to 26.1.2
- gh-150406: Fix a possible crash occurring during :mod:`socket` module
initialization when the system is out of memory on platforms without a
reentrant ``gethostbyname``.
- gh-150372: :mod:`readline`: Fix a potential crash during tab completion
caused by an out-of-memory error during module initialization.
- gh-150157: Fix a crash in free-threaded builds that occurs when pickling
by name objects without a ``__module__`` attribute while
:data:`sys.modules` is concurrently being modified.
- gh-150175: Fix race condition in :class:`unittest.mock.ThreadingMock`
where concurrent calls could lose increments to ``call_count`` and other
attributes due to a missing lock in ``_increment_mock_call``.
- gh-84353: Preserve non-UTF-8 encoded filenames when appending to a
:class:`zipfile.ZipFile`. Previously, non-ASCII names stored in a legacy
encoding (without the UTF-8 flag bit set) could be corrupted when the
central directory was rewritten: they were decoded as cp437 and then
re-stored as UTF-8.
- gh-149816: Fix race condition in :attr:`ssl.SSLContext.sni_callback`
- gh-149995: Update various docstrings in :mod:`typing`.
- gh-88726: The :mod:`email` package now uses standard MIME charset names
"gb2312" and "big5" instead of non-standard names "eucgb2312_cn" and
"big5_tw".
- gh-149571: Fix the C implementation of
:meth:`xml.etree.ElementTree.Element.itertext`: it no longer emits text
for comments and processing instructions.
- gh-149921: Fix reference leaks in error paths of the
:mod:`!_interpchannels` and :mod:`!_interpqueues` extension modules.
- gh-149816: Fix a race condition in ``_random.Random.__init__`` method in
free-threading mode.
- gh-149801: Add IANA registered names and aliases with leading zeros before
number (like IBM00858, CP00858, IBM01140, CP01140) for corresponding
codecs.
- gh-149701: Fix bad return code from Lib/venv/bin/activate if hashing is
disabled
- gh-112821: In the REPL, autocompletion might run arbitrary code in the
getter of a descriptor. If that getter raised an exception, autocompletion
would fail to present any options for the entire object. Autocompletion
now works as expected for these objects.
- gh-149489: Fix :mod:`~xml.etree.ElementTree` serialization to HTML. The
content of elements "xmp", "iframe", "noembed", "noframes", and
"plaintext" is no longer escaped. The "plaintext" element no longer have
the closing tag.
- gh-149231: In :mod:`tomllib`, the number of parts in TOML keys is now
limited.
- gh-149046: :mod:`io`: Fix :class:`io.StringIO` serialization: no longer
call ``str(obj)`` on :class:`str` subclasses. Patch by Thomas Kowalski.
- gh-148954: Fix XML injection vulnerability in :func:`xmlrpc.client.dumps`
where the ``methodname`` was not being escaped before interpolation into
the XML body.
- gh-148441: :mod:`xml.parsers.expat`: prevent a crash in
:meth:`~xml.parsers.expat.xmlparser.CharacterDataHandler` when the
character data size exceeds the parser's :attr:`buffer size
`.
- gh-146452: Fix segfault in :mod:`pickle` when pickling a dictionary
concurrently mutated by another thread in the free-threaded build.
- gh-142831: Fix a crash in the :mod:`json` module where a use-after-free
could occur if the object being encoded is modified during serialization.
- gh-90949: Add
:meth:`~xml.parsers.expat.xmlparser.SetBillionLaughsAttackProtectionActivationThreshold`
and
:meth:`~xml.parsers.expat.xmlparser.SetBillionLaughsAttackProtectionMaximumAmplification`
to :ref:`xmlparser ` objects to tune protections
against `billion laughs
`_ attacks. Patch by
Bénédikt Tran.
- gh-134261: zip: On reproducible builds, ZipFile uses UTC instead of the
local time when writing file datetimes to avoid underflows.
- gh-128110: Fix bug in the parsing of :mod:`email` address headers that
could result in extraneous spaces in the decoded text when using a modern
email policy. Space between pairs of adjacent :rfc:`2047` encoded-words is
now ignored, per section 6.2 (and consistent with existing parsing of
unstructured headers like *Subject*).
- gh-107398: Fix :mod:`tarfile` stream mode exception when process the file
with the gzip extra field.
- gh-123853: Update the table of Windows language code identifiers (LCIDs)
used by :func:`locale.getdefaultlocale` on Windows to protocol version
16.0 (2024-04-23).
- gh-91099: :meth:`imaplib.IMAP4.login` now raises exceptions with
:class:`str` instead of :class:`bytes`. Patch by Florian Best.
Documentation
-------------
- gh-150319: Generic builtin and standard library types now document the
meaning of their type parameters.
- gh-109503: Fix documentation for :func:`shutil.move` on usage of
:func:`os.rename` since nonatomic move might be used even if the files are
on the same filesystem. Patch by Fang Li
Tests
-----
- gh-151130: Add more tests for ``PyWeakref_*`` C API.
- gh-149776: Fix test_socket on Linux kernel 7.1 and newer: skip UDP Lite
tests if it's not supported. Patch by Victor Stinner.
Build
-----
- gh-148294: Corrected the use of ``AC_PATH_TOOL`` in ``configure.ac`` to
allow a C++ compiler to be found on :envvar:`!PATH`.
Windows
-------
- gh-151159: Updated bundled version of OpenSSL to 3.5.7.
macOS
-----
- gh-151159: Update macOS installer to use OpenSSL 3.5.7.
- gh-150644: When system logging is enabled (with
``config.use_system_logger``, messages are now tagged as public. This
allows the macOS 26 system logger to view messages without special
configuration.
- gh-115119: Update macOS installer to use libmpdecimal 4.0.1.
IDLE
----
- bpo-6699: Warn the user if a file will be overwritten when saving.
C API
-----
- gh-150907: Fix ``dynamic_annotations.h`` header file when built with C++
and Valgrind: add ``extern "C++" scope`` for the C++ template. Patch by
Victor Stinner.
- gh-145235: Made :c:func:`PyDict_AddWatcher`,
:c:func:`PyDict_ClearWatcher`, :c:func:`PyDict_Watch`, and
:c:func:`PyDict_Unwatch` thread-safe on the :term:`free threaded ` build.
What's New in Python 3.14.5 final?
==================================
*Release date: 2026-05-10*
Security
--------
- gh-148178: Hardened :mod:`!_remote_debugging` by validating remote debug
offset tables before using them to size memory reads or interpret remote
layouts.
Core and Builtins
-----------------
- gh-146270: Fix a sequential consistency bug in ``structmember.c``.
- gh-137293: Fix :exc:`SystemError` when searching ELF Files in
:func:`sys.remote_exec`.
Library
-------
- gh-149388: Make :class:`!asyncio.windows_utils.PipeHandle` closing
idempotent.
- gh-149377: Update bundled pip to 26.1.1
- gh-138907: Support :rfc:`9309` in :mod:`urllib.robotparser`.
- gh-148615: Fix :mod:`pdb` to accept standard -- end of options separator.
Reported by haampie. Patched by Shrey Naithani.
- gh-130750: Restore quoting of choices in :mod:`argparse` error messages
for improved clarity and consistency with documentation.
- gh-141449: Improve tests and documentation for non-function callables as
:term:`annotate functions `.
Tests
-----
- gh-149425: Increase time delta in
``test.test_zipfile.test_core.OtherTests.test_write_without_source_date_epoch``
- gh-145736: Fix test_tkinter test_configure_values test case backport miss
for Tk 9.
macOS
-----
- gh-142295: For Python macOS framework builds, update Info.plist files to
be more compliant with current Apple guidelines. Original patch
contributed by Martinus Verburg.
- gh-124111: Update macOS installer to use Tcl/Tk 9.0.3.
What's New in Python 3.14.5 release candidate 1?
================================================
*Release date: 2026-05-04*
Security
--------
- gh-149254: Update Android and iOS installer to use OpenSSL 3.0.20.
- gh-149017: Update bundled `libexpat `_ to
version 2.8.0.
- gh-90309: Base64-encode values when embedding cookies to JavaScript using
the :meth:`http.cookies.BaseCookie.js_output` method to avoid injection
and escaping.
- gh-148808: Added buffer boundary check when using ``nbytes`` parameter
with :meth:`!asyncio.AbstractEventLoop.sock_recvfrom_into`. Only relevant
for Windows and the :class:`asyncio.ProactorEventLoop`.
- gh-148395: Fix a dangling input pointer in :class:`lzma.LZMADecompressor`,
:class:`bz2.BZ2Decompressor`, and internal
:class:`!zlib._ZlibDecompressor` when memory allocation fails with
:exc:`MemoryError`, which could let a subsequent :meth:`!decompress` call
read or write through a stale pointer to the already-released caller
buffer.
- gh-148169: A bypass in :mod:`webbrowser` allowed URLs prefixed with
``%action`` to pass the dash-prefix safety check.
- gh-146581: Fix vulnerability in :func:`shutil.unpack_archive` for ZIP
files on Windows which allowed to write files outside of the destination
tree if the patch in the archive contains a Windows drive prefix. Now such
invalid paths will be skipped. Files containing ".." in the name (like
"foo..bar") are no longer skipped.
- gh-146333: Fix quadratic backtracking in
:class:`configparser.RawConfigParser` option parsing regexes (``OPTCRE``
and ``OPTCRE_NV``). A crafted configuration line with many whitespace
characters could cause excessive CPU usage.
- gh-146211: Reject CR/LF characters in tunnel request headers for the
HTTPConnection.set_tunnel() method.
Core and Builtins
-----------------
- gh-149122: Fix a crash in optimized calls to :func:`all`, :func:`any`,
:func:`tuple`, :func:`list`, and :func:`set` with an async generator
expression argument (for example, ``tuple(await x for x in y)``). These
calls now correctly raise ``TypeError`` instead of crashing.
- gh-113956: Fix a data race in :func:`sys.intern` in the free-threaded
build when interning a string owned by another thread. An interned copy
owned by the current thread is used instead when it is not safe to
immortalize the original.
- gh-148820: Fix a race in :c:type:`!_PyRawMutex` on the free-threaded build
where a ``Py_PARK_INTR`` return from ``_PySemaphore_Wait`` could let the
waiter destroy its semaphore before the unlocking thread's
``_PySemaphore_Wakeup`` completed, causing a fatal ``ReleaseSemaphore``
error.
- gh-148653: Forbid :mod:`marshalling ` recursive code objects and
:class:`slice` objects which cannot be correctly unmarshalled.
- gh-142516: Forward-port the generational cycle garbage collector to the
default 3.14 build, replacing the incremental collector while leaving the
free-threaded collector unchanged.
- gh-148390: Fix an undefined behavior in :class:`memoryview` when using the
native boolean format (``?``) in :meth:`~memoryview.cast`. Previously, on
some common platforms, calling ``memoryview(b).cast("?").tolist()``
incorrectly returned ``[False]`` instead of ``[True]`` for any even byte
*b*. Patch by Bénédikt Tran.
- gh-148418: Fix a possible reference leak in a corrupted ``TYPE_CODE``
marshal stream.
- gh-148393: Fix data races between :c:func:`PyDict_Watch` /
:c:func:`PyDict_Unwatch` and concurrent dict mutation in the
:term:`free-threaded build`.
- gh-148284: Fix high stack consumption in Python's interpreter loop on
Clang 22 by setting function limits for inlining when building with
computed gotos.
- gh-148037: Remove critical section from :c:func:`!PyCode_Addr2Line` in
free-threading.
- gh-148222: Fix vectorcall support in :class:`types.GenericAlias` when the
underlying type does not support the vectorcall protocol. Fix possible
leaks in :class:`types.GenericAlias` and :class:`types.UnionType` in case
of memory error.
- gh-148208: Fix recursion depth leak in :c:func:`PyObject_Print`
- gh-137814: Fix the ``__qualname__`` attribute of ``__annotate__``
functions on functions.
- gh-147998: Fixed a memory leak in interpreter helper calls so cleanup
works when an operation falls across interpreter boundaries. Patch by
Maurycy Pawłowski-Wieroński.
- gh-146455: Fix O(N²) compile-time regression in constant folding after it
was moved from AST to CFG optimizer.
Library
-------
- gh-149221: Catch rare math domain error for
:func:`random.binomialvariate`.
- gh-149117: Fix :func:`runpy.run_module` and :func:`runpy.run_path` to set
the :attr:`~ImportError.name` attribute on the :exc:`ImportError` they
raise.
- gh-149148: :mod:`ensurepip`: Upgrade bundled pip to 26.1. This version
fixes the :cve:`2026-3219` vulnerability. Patch by Victor Stinner.
- gh-148093: Fix an out-of-bounds read of one byte in
:func:`binascii.a2b_uu`. Raise :exc:`binascii.Error`, instead of reading
past the buffer end.
- gh-148914: Fix memoization of in-band :class:`~pickle.PickleBuffer` in the
Python implementation of :mod:`pickle`. Previously, identical
:class:`!PickleBuffer`\ s did not preserve identity, and empty writable
:class:`!PickleBuffer` memoized an empty bytearray object in place of
``b''``, so the following references to ``b''`` were unpickled as an empty
bytearray object.
- gh-148947: Fix crash in :deco:`dataclasses.dataclass` with ``slots=True``
that occurred when a function found within the class had an empty
``__class__`` cell.
- gh-148680: ``ForwardRef`` objects that contain internal names to represent
known objects now show the ``type_repr`` of the known object rather than
the internal ``__annotationlib_name_x__`` name when evaluated as strings.
- gh-148801: :mod:`xml.etree.ElementTree`: Fix a crash in
:meth:`Element.__deepcopy__ ` on deeply nested trees.
- gh-148735: :mod:`xml.etree.ElementTree`: Fix a use-after-free in
:meth:`Element.findtext ` when the
element tree is mutated concurrently during the search.
- gh-148740: Fix usage for :mod:`uuid` command-line interface to support a
custom namespace be provided for uuid3 and uuid5.
- gh-148651: Fix reference leak in
:class:`compression.zstd.ZstdDecompressor` when an invalid option key is
passed.
- gh-146553: Fix infinite loop in :func:`typing.get_type_hints` when
``__wrapped__`` forms a cycle. Patch by Shamil Abdulaev.
- gh-148508: An intermittent timing error when running SSL tests on iOS has
been resolved.
- gh-148518: If an email containing an address header that ended in an open
double quote was parsed with a non-``compat32`` policy, accessing the
``username`` attribute of the mailbox accessed through that header object
would result in an ``IndexError``. It now correctly returns an empty
string as the result.
- gh-148464: Add missing ``__ctype_le/be__`` attributes for
:class:`~ctypes.c_float_complex` and :class:`~ctypes.c_double_complex`.
Patch by Sergey B Kirpichev.
- gh-148370: :mod:`configparser`: prevent quadratic behavior when a
:exc:`~configparser.ParsingError` is raised after a parser fails to parse
multiple lines. Patch by Bénédikt Tran.
- gh-148254: Use singular "sec" instead of "secs" in :mod:`timeit` verbose
output for consistency with other time units.
- gh-148192: ``email.generator.Generator._make_boundary`` could fail to
detect a duplicate boundary string if linesep was not \n. It now correctly
detects boundary strings when linesep is \r\n as well.
- gh-146313: Fix a deadlock in :mod:`multiprocessing`'s resource tracker
where the parent process could hang indefinitely in :func:`os.waitpid`
during interpreter shutdown if a child created via :func:`os.fork` still
held the resource tracker's pipe open.
- gh-145831: Fix :func:`!email.quoprimime.decode` leaving a stray ``\r``
when ``eol='\r\n'`` by stripping the full *eol* string instead of one
character.
- gh-145105: Fix crash in :mod:`csv` reader when iterating with a re-entrant
iterator that calls :func:`next` on the same reader from within
``__next__``.
- gh-105936: Attempting to mutate non-field attributes of :mod:`dataclasses`
with both *frozen* and *slots* being ``True`` now raises
:class:`~dataclasses.FrozenInstanceError` instead of :class:`TypeError`.
Their non-dataclass subclasses can now freely mutate non-field attributes,
and the original non-slotted class can be garbage collected.
- gh-140287: The :mod:`asyncio` REPL now handles exceptions when executing
:envvar:`PYTHONSTARTUP` scripts. Patch by Bartosz Sławecki.
- gh-132631: Fix "I/O operation on closed file" when parsing JSON Lines file
with :mod:`JSON CLI `.
- gh-70039: Fixed bug where :meth:`smtplib.SMTP.starttls` could fail if
:meth:`smtplib.SMTP.connect` is called explicitly rather than implicitly.
- gh-83281: :mod:`email`: improve handling trailing garbage in address lists
to avoid throwing AttributeError in certain edge cases
Documentation
-------------
- gh-148663: Document that :class:`calendar.IllegalMonthError` is a subclass
of both :exc:`ValueError` and :exc:`IndexError` since Python 3.12.
- gh-146646: Document that :func:`glob.glob`, :func:`glob.iglob`,
:meth:`pathlib.Path.glob`, and :meth:`pathlib.Path.rglob` silently
suppress :exc:`OSError` exceptions raised from scanning the filesystem.
Build
-----
- gh-149351: Avoid possible broken macOS framework install names when
DESTDIR is specified during builds.
- gh-146475: Block Apple Clang from being used to build the JIT as it ships
without required LLVM tools.
- gh-148535: No longer use the ``gcc -fprofile-update=atomic`` flag on i686.
The flag has been added to fix a random GCC internal error on PGO build
(:gh:`145801`) caused by corruption of profile data (.gcda files). The
problem is that it makes the PGO build way slower (up to 47x slower) on
i686. Since the GCC internal error was not seen on i686 so far, don't use
``-fprofile-update=atomic`` on i686 anymore. Patch by Victor Stinner.
- gh-146264: Fix static module builds on non-WASI targets by linking HACL
dependencies as static libraries when ``MODULE_BUILDTYPE=static``,
preventing duplicate ``_Py_LibHacl_*`` symbol errors at link time.
Windows
-------
- gh-149254: Updated bundled version of OpenSSL to 3.0.20.
- gh-146458: Fix incorrect REPL height and width tracking on console window
resize on Windows.
macOS
-----
- gh-149254: Update macOS installer to use OpenSSL 3.0.20.
What's New in Python 3.14.4 final?
==================================
*Release date: 2026-04-07*
Security
--------
- gh-145986: :mod:`xml.parsers.expat`: Fixed a crash caused by unbounded C
recursion when converting deeply nested XML content models with
:meth:`~xml.parsers.expat.xmlparser.ElementDeclHandler`. This addresses
:cve:`2026-4224`.
- gh-145599: Reject control characters in :class:`http.cookies.Morsel`
:meth:`~http.cookies.Morsel.update` and
:meth:`~http.cookies.BaseCookie.js_output`. This addresses
:cve:`2026-3644`.
- gh-145506: Fixes :cve:`2026-2297` by ensuring that
``SourcelessFileLoader`` uses :func:`io.open_code` when opening ``.pyc``
files.
- gh-144370: Disallow usage of control characters in status in
:mod:`wsgiref.handlers` to prevent HTTP header injections. Patch by
Benedikt Johannes.
- gh-143930: Reject leading dashes in URLs passed to
:func:`webbrowser.open`.
Core and Builtins
-----------------
- gh-148157: Fix an unlikely crash when parsing an invalid type comments for
function parameters. Found by OSS Fuzz in :oss-fuzz:`492782951`.
- gh-148144: Initialize ``_PyInterpreterFrame.visited`` when copying
interpreter frames so incremental GC does not read an uninitialized byte
from generator and frame-object copies.
- gh-146615: Fix a crash in :meth:`~object.__get__` for
:c:expr:`METH_METHOD` descriptors when an invalid (non-type) object is
passed as the second argument. Patch by Steven Sun.
- gh-146308: Fixed several error handling issues in the
:mod:`!_remote_debugging` module, including safer validation of remote
``int`` objects, clearer asyncio task chain failures, and cache cleanup
fixes that avoid leaking or double-freeing metadata on allocation failure.
Patch by Pablo Galindo.
- gh-146128: Fix a bug which could cause constant values to be partially
corrupted in AArch64 JIT code. This issue is theoretical, and hasn't
actually been observed in unmodified Python interpreters.
- gh-146250: Fixed a memory leak in :exc:`SyntaxError` when re-initializing
it.
- gh-146245: Fixed reference leaks in :mod:`socket` when audit hooks raise
exceptions in :func:`socket.getaddrinfo` and :meth:`!socket.sendto`.
- gh-146196: Fix potential Undefined Behavior in
:c:func:`PyUnicodeWriter_WriteASCII` by adding a zero-length check. Patch
by Shamil Abdulaev.
- gh-146227: Fix wrong type in ``_Py_atomic_load_uint16`` in the C11 atomics
backend (``pyatomic_std.h``), which used a 32-bit atomic load instead of
16-bit. Found by Mohammed Zuhaib.
- gh-146056: Fix :func:`repr` for lists and tuples containing ``NULL``\ s.
- gh-146092: Handle properly memory allocation failures on str and float
opcodes. Patch by Victor Stinner.
- gh-146041: Fix free-threading scaling bottleneck in :func:`sys.intern` and
:c:func:`PyObject_SetAttr` by avoiding the interpreter-wide lock when the
string is already interned and immortalized.
- gh-145990: ``python --help-env`` sections are now sorted by environment
variable name.
- gh-145990: ``python --help-xoptions`` is now sorted by ``-X`` option name.
- gh-145376: Fix GC tracking in ``structseq.__replace__()``.
- gh-145792: Fix out-of-bounds access when invoking faulthandler on a
CPython build compiled without support for VLAs.
- gh-142183: Avoid a pathological case where repeated calls at a specific
stack depth could be significantly slower.
- gh-145779: Improve scaling of :func:`classmethod` and :func:`staticmethod`
calls in the free-threaded build by avoiding the descriptor ``__get__``
call.
- gh-145783: Fix an unlikely crash in the parser when certain errors were
erroneously not propagated. Found by OSS Fuzz in :oss-fuzz:`491369109`.
- gh-145685: Improve scaling of type attribute lookups in the
:term:`free-threaded build` by avoiding contention on the internal type
lock.
- gh-145701: Fix :exc:`SystemError` when ``__classdict__`` or
``__conditional_annotations__`` is in a class-scope inlined comprehension.
Found by OSS Fuzz in :oss-fuzz:`491105000`.
- gh-145713: Make :meth:`bytearray.resize` thread-safe in the free-threaded
build by using a critical section and calling the lock-held variant of the
resize function.
- gh-145615: Fixed a memory leak in the :term:`free-threaded build` where
mimalloc pages could become permanently unreclaimable until the owning
thread exited.
- gh-145566: In the free threading build, skip the stop-the-world pause when
reassigning ``__class__`` on a newly created object.
- gh-145335: Fix a crash in :func:`os.pathconf` when called with ``-1`` as
the path argument.
- gh-145036: In free-threaded build, fix race condition when calling
:meth:`!__sizeof__` on a :class:`list`
- gh-145376: Fix reference leaks in various unusual error scenarios.
- gh-145234: Fixed a ``SystemError`` in the parser when an encoding cookie
(for example, UTF-7) decodes to carriage returns (``\r``). Newlines are
now normalized after decoding in the string tokenizer.
Patch by Pablo Galindo.
- gh-130555: Fix use-after-free in :meth:`dict.clear` when the dictionary
values are embedded in an object and a destructor causes re-entrant
mutation of the dictionary.
- gh-145187: Fix compiler assertion fail when a type parameter bound
contains an invalid expression in a conditional block.
- gh-145142: Fix a crash in the free-threaded build when the dictionary
argument to :meth:`str.maketrans` is concurrently modified.
- gh-144872: Fix heap buffer overflow in the parser found by OSS-Fuzz.
- gh-144766: Fix a crash in fork child process when perf support is enabled.
- gh-144759: Fix undefined behavior in the lexer when ``start`` and
``multi_line_start`` pointers are ``NULL`` in
``_PyLexer_remember_fstring_buffers()`` and
``_PyLexer_restore_fstring_buffers()``. The ``NULL`` pointer arithmetic
(``NULL - valid_pointer``) is now guarded with explicit ``NULL`` checks.
- gh-144563: Fix interaction of the Tachyon profiler and :mod:`ctypes` and
other modules that load the Python shared library (if present) in an
independent map as this was causing the mechanism that loads the binary
information to be confused. Patch by Pablo Galindo
- gh-144601: Fix crash when importing a module whose ``PyInit`` function
raises an exception from a subinterpreter.
- gh-144438: Align the QSBR thread state array to a 64-byte cache line
boundary to avoid false sharing in the :term:`free-threaded build`.
- gh-144513: Fix potential deadlock when using critical sections during
stop-the-world pauses in the free-threaded build.
- gh-144446: Fix data races in the free-threaded build when reading frame
object attributes while another thread is executing the frame.
- gh-143636: Fix a crash when calling :class:`SimpleNamespace.__replace__()
` on non-namespace instances. Patch by Bénédikt
Tran.
- gh-143650: Fix race condition in :mod:`importlib` where a thread could
receive a stale module reference when another thread's import fails.
- gh-141732: Ensure the :meth:`~object.__repr__` for :exc:`ExceptionGroup`
and :exc:`BaseExceptionGroup` does not change when the exception sequence
that was original passed in to its constructor is subsequently mutated.
- gh-140594: Fix an out of bounds read when a single NUL character is read
from the standard input. Patch by Shamil Abdulaev.
- gh-91636: While performing garbage collection, clear weakrefs to
unreachable objects that are created during running of finalizers. If
those weakrefs were are not cleared, they could reveal unreachable
objects.
- gh-130327: Fix erroneous clearing of an object's :attr:`~object.__dict__`
if overwritten at runtime.
- gh-80667: Literals using the ``\N{name}`` escape syntax can now construct
CJK ideographs and Hangul syllables using case-insensitive names.
Library
-------
- gh-144503: Fix a regression introduced in 3.14.3 and 3.13.12 where the
:mod:`multiprocessing` ``forkserver`` start method would fail with
:exc:`BrokenPipeError` when the parent process had a very large
:data:`sys.argv`. The argv is now passed to the forkserver as separate
command-line arguments rather than being embedded in the ``-c`` command
string, avoiding the operating system's per-argument length limit.
- gh-146613: :mod:`itertools`: Fix a crash in :func:`itertools.groupby` when
the grouper iterator is concurrently mutated.
- gh-146080: :mod:`ssl`: fix a crash when an SNI callback tries to use an
SSL object that has already been garbage-collected. Patch by Bénédikt
Tran.
- gh-146556: Fix :func:`annotationlib.get_annotations` hanging indefinitely
when called with ``eval_str=True`` on a callable that has a circular
``__wrapped__`` chain (e.g. ``f.__wrapped__ = f``). Cycle detection using
an id-based visited set now stops the traversal and falls back to the
globals found so far, mirroring the approach of :func:`inspect.unwrap`.
- gh-146090: :mod:`sqlite3`: fix a crash when
:meth:`sqlite3.Connection.create_collation` fails with `SQLITE_BUSY
`__. Patch by Bénédikt Tran.
- gh-146090: :mod:`sqlite3`: properly raise :exc:`MemoryError` instead of
:exc:`SystemError` when a context callback fails to be allocated. Patch by
Bénédikt Tran.
- gh-145633: Fix ``struct.pack('f', float)``: use :c:func:`PyFloat_Pack4` to
raise :exc:`OverflowError`. Patch by Sergey B Kirpichev and Victor
Stinner.
- gh-146310: The :mod:`ensurepip` module no longer looks for ``pip-*.whl``
wheel packages in the current directory.
- gh-146083: Update bundled `libexpat `_ to
version 2.7.5.
- gh-146076: :mod:`zoneinfo`: fix crashes when deleting ``_weak_cache`` from
a :class:`zoneinfo.ZoneInfo` subclass.
- gh-146054: Limit the size of :func:`encodings.search_function` cache.
Found by OSS Fuzz in :oss-fuzz:`493449985`.
- gh-146004: All :option:`-X` options from the Python command line are now
propagated to child processes spawned by :mod:`multiprocessing`, not just
a hard-coded subset. This makes the behavior consistent between default
"spawn" and "forkserver" start methods and the old "fork" start method.
The options that were previously not propagated are:
``context_aware_warnings``, ``cpu_count``, ``disable-remote-debug``,
``int_max_str_digits``, ``lazy_imports``, ``no_debug_ranges``,
``pathconfig_warnings``, ``perf``, ``perf_jit``, ``presite``,
``pycache_prefix``, ``thread_inherit_context``, and
``warn_default_encoding``.
- gh-145883: :mod:`zoneinfo`: Fix heap buffer overflow reads from malformed
TZif data. Found by OSS Fuzz, issues :oss-fuzz:`492245058` and
:oss-fuzz:`492230068`.
- gh-145754: Request signature during mock autospec with ``FORWARDREF``
annotation format. This prevents runtime errors when an annotation uses a
name that is not defined at runtime.
- gh-145750: Avoid undefined behaviour from signed integer overflow when
parsing format strings in the :mod:`struct` module. Found by OSS Fuzz in
:oss-fuzz:`488466741`.
- gh-145492: Fix infinite recursion in :class:`collections.defaultdict`
``__repr__`` when a ``defaultdict`` contains itself. Based on analysis by
KowalskiThomas in :gh:`145492`.
- gh-145623: Fix crash in :mod:`struct` when calling :func:`repr` or
``__sizeof__()`` on an uninitialized :class:`struct.Struct` object created
via ``Struct.__new__()`` without calling ``__init__()``.
- gh-145616: Detect Android sysconfig ABI correctly on 32-bit ARM Android on
64-bit ARM kernel
- gh-145551: Fix InvalidStateError when cancelling process created by
:func:`asyncio.create_subprocess_exec` or
:func:`asyncio.create_subprocess_shell`. Patch by Daan De Meyer.
- gh-145446: Now :mod:`functools` is safer in free-threaded build when using
keywords in :func:`functools.partial`
- gh-145417: :mod:`venv`: Prevent incorrect preservation of SELinux context
when copying the ``Activate.ps1`` script. The script inherited the SELinux
security context of the system template directory, rather than the
destination project directory.
- gh-145376: Fix double free and null pointer dereference in unusual error
scenarios in :mod:`hashlib` and :mod:`hmac` modules.
- gh-145301: :mod:`hmac`: fix a crash when the initialization of the
underlying C extension module fails.
- gh-145301: :mod:`hashlib`: fix a crash when the initialization of the
underlying C extension module fails.
- gh-145264: Base64 decoder (see :func:`binascii.a2b_base64`,
:func:`base64.b64decode`, etc) no longer ignores excess data after the
first padded quad in non-strict (default) mode. Instead, in conformance
with :rfc:`4648`, section 3.3, it now ignores the pad character, "=", if
it is present before the end of the encoded data.
- gh-145158: Avoid undefined behaviour from signed integer overflow when
parsing format strings in the :mod:`struct` module.
- gh-144984: Fix crash in
:meth:`xml.parsers.expat.xmlparser.ExternalEntityParserCreate` when an
allocation fails. The error paths could dereference NULL ``handlers`` and
double-decrement the parent parser's reference count.
- gh-88091: Fix :func:`unicodedata.decomposition` for Hangul characters.
- gh-144986: Fix a memory leak in :func:`atexit.register`. Patch by Shamil
Abdulaev.
- gh-144777: Fix data races in :class:`io.IncrementalNewlineDecoder` in the
:term:`free-threaded build`.
- gh-144809: Make :class:`collections.deque` copy atomic in the
:term:`free-threaded build`.
- gh-144835: Added missing explanations for some parameters in
:func:`glob.glob` and :func:`glob.iglob`.
- gh-144833: Fixed a use-after-free in :mod:`ssl` when ``SSL_new()`` returns
NULL in ``newPySSLSocket()``. The error was reported via a dangling
pointer after the object had already been freed.
- gh-144782: Fix :class:`argparse.ArgumentParser` to be :mod:`pickleable
`.
- gh-144259: Fix inconsistent display of long multiline pasted content in
the REPL.
- gh-144156: Fix the folding of headers by the :mod:`email` library when
:rfc:`2047` encoded words are used. Now whitespace is correctly preserved
and also correctly added between adjacent encoded words. The latter
property was broken by the fix for gh-92081, which mostly fixed previous
failures to preserve whitespace.
- gh-66305: Fixed a hang on Windows in the :mod:`tempfile` module when
trying to create a temporary file or subdirectory in a non-writable
directory.
- gh-140814: :func:`multiprocessing.freeze_support` no longer sets the
default start method as a side effect, which previously caused a
subsequent :func:`multiprocessing.set_start_method` call to raise
:exc:`RuntimeError`.
- gh-144475: Calling :func:`repr` on :func:`functools.partial` is now safer
when the partial object's internal attributes are replaced while the
string representation is being generated.
- gh-144538: Bump the version of pip bundled in ensurepip to version 26.0.1
- gh-144494: Fix performance regression in :func:`asyncio.all_tasks` on
:term:`free-threaded builds `. Patch by Kumar Aditya.
- gh-144316: Fix crash in ``_remote_debugging`` that caused
``test_external_inspection`` to intermittently fail. Patch by Taegyun Kim.
- gh-144363: Update bundled `libexpat `_ to
2.7.4
- gh-143637: Fixed a crash in socket.sendmsg() that could occur if ancillary
data is mutated re-entrantly during argument parsing.
- gh-143543: Fix a crash in itertools.groupby that could occur when a
user-defined :meth:`~object.__eq__` method re-enters the iterator during
key comparison.
- gh-140652: Fix a crash in :func:`!_interpchannels.list_all` after closing
a channel.
- gh-143698: Allow *scheduler* and *setpgroup* arguments to be explicitly
:const:`None` when calling :func:`os.posix_spawn` or
:func:`os.posix_spawnp`. Patch by Bénédikt Tran.
- gh-143698: Raise :exc:`TypeError` instead of :exc:`SystemError` when the
*scheduler* in :func:`os.posix_spawn` or :func:`os.posix_spawnp` is not a
tuple. Patch by Bénédikt Tran.
- gh-142516: :mod:`ssl`: fix reference leaks in :class:`ssl.SSLContext`
objects. Patch by Bénédikt Tran.
- gh-143304: Fix :class:`ctypes.CDLL` to honor the ``handle`` parameter on
POSIX systems.
- gh-142781: :mod:`zoneinfo`: fix a crash when instantiating
:class:`~zoneinfo.ZoneInfo` objects for which the internal class-level
cache is inconsistent.
- gh-142763: Fix a race condition between :class:`zoneinfo.ZoneInfo`
creation and :func:`zoneinfo.ZoneInfo.clear_cache` that could raise
:exc:`KeyError`.
- gh-142787: Fix assertion failure in :mod:`sqlite3` blob subscript when
slicing with indices that result in an empty slice.
- gh-142352: Fix :meth:`asyncio.StreamWriter.start_tls` to transfer buffered
data from :class:`~asyncio.StreamReader` to the SSL layer, preventing data
loss when upgrading a connection to TLS mid-stream (e.g., when
implementing PROXY protocol support).
- gh-141707: Don't change :class:`tarfile.TarInfo` type from ``AREGTYPE`` to
``DIRTYPE`` when parsing GNU long name or link headers.
- gh-139933: Improve :exc:`AttributeError` suggestions for classes with a
custom :meth:`~object.__dir__` method returning a list of unsortable
values. Patch by Bénédikt Tran.
- gh-137335: Get rid of any possibility of a name conflict for named pipes
in :mod:`multiprocessing` and :mod:`asyncio` on Windows, no matter how
small.
- gh-80667: Support lookup for Tangut Ideographs in :mod:`unicodedata`.
- bpo-40243: Fix :meth:`!unicodedata.ucd_3_2_0.numeric` for non-decimal
values.
Documentation
-------------
- gh-126676: Expand :mod:`argparse` documentation for ``type=bool`` with a
demonstration of the surprising behavior and pointers to common
alternatives.
- gh-145649: Fix text wrapping and formatting of ``-X`` option descriptions
in the :manpage:`python(1)` man page by using proper roff markup.
- gh-145450: Document missing public :class:`wave.Wave_write` getter
methods.
- gh-136246: A new "Improve this page" link is available in the left-hand
sidebar of the docs, offering links to create GitHub issues, discussion
forum posts, or pull requests.
Tests
-----
- gh-144418: The Android testbed's emulator RAM has been increased from 2 GB
to 4 GB.
- gh-146202: Fix a race condition in regrtest: make sure that the temporary
directory is created in the worker process. Previously, temp_cwd() could
fail on Windows if the "build" directory was not created. Patch by Victor
Stinner.
- gh-144739: When Python was compiled with system expat older then 2.7.2 but
tests run with newer expat, still skip
:class:`!test.test_pyexpat.MemoryProtectionTest`.
Build
-----
- gh-146541: The Android testbed can now be built for 32-bit ARM and x86
targets.
- gh-146498: The iOS XCframework build script now ensures libpython isn't
included in installed app content, and is more robust in identifying
standard library binary content that requires processing.
- gh-146450: The Android build script was modified to improve parity with
other platform build scripts.
- gh-146446: The clean target for the Apple/iOS XCframework build script is
now more selective when targeting a single architecture.
- gh-145801: When Python build is optimized with GCC using PGO, use
``-fprofile-update=atomic`` option to use atomic operations when updating
profile information. This option reduces the risk of gcov Data Files
(.gcda) corruption which can cause random GCC crashes. Patch by Victor
Stinner.
Windows
-------
- gh-145307: Defers loading of the ``psapi.dll`` module until it is used by
:func:`ctypes.util.dllist`.
- gh-144551: Updated bundled version of OpenSSL to 3.0.19.
- gh-140131: Fix REPL cursor position on Windows when module completion
suggestion line hits console width.
macOS
-----
- gh-144551: Update macOS installer to use OpenSSL 3.0.19.
- gh-137586: Invoke :program:`osascript` with absolute path in
:mod:`webbrowser` and :mod:`!turtledemo`.
C API
-----
- gh-146056: :c:func:`PyUnicodeWriter_WriteRepr` now supports ``NULL``
argument.
- gh-145010: Use GCC dialect alternatives for inline assembly in
``object.h`` so that the Python headers compile correctly with
``-masm=intel``.
- gh-144981: Made :c:func:`PyUnstable_Code_SetExtra`,
:c:func:`PyUnstable_Code_GetExtra`, and
:c:func:`PyUnstable_Eval_RequestCodeExtraIndex` thread-safe on the
:term:`free threaded ` build.
What's New in Python 3.14.3 final?
==================================
*Release date: 2026-02-03*
Windows
-------
- gh-128067: Fix a bug in PyREPL on Windows where output without a trailing
newline was overwritten by the next prompt.
Tools/Demos
-----------
- gh-142095: Make gdb 'py-bt' command use frame from thread local state when
available. Patch by Sam Gross and Victor Stinner.
Tests
-----
- gh-144415: The Android testbed now distinguishes between stdout/stderr
messages which were triggered by a newline, and those triggered by a
manual call to ``flush``. This fixes logging of progress indicators and
similar content.
- gh-143460: Skip tests relying on infinite recusion if stack size is
unlimited.
- gh-65784: Add support for parametrized resource ``wantobjects`` in
regrtests, which allows to run Tkinter tests with the specified value of
:data:`!tkinter.wantobjects`, for example ``-u wantobjects=0``.
- gh-143553: Add support for parametrized resources, such as ``-u
xpickle=2.7``.
- gh-142836: Accommodated Solaris in
``test_pdb.test_script_target_anonymous_pipe``.
- bpo-31391: Forward-port test_xpickle from Python 2 to Python 3 and add the
resource back to test's command line.
Security
--------
- gh-144125: :mod:`~email.generator.BytesGenerator` will now refuse to
serialize (write) headers that are unsafely folded or delimited; see
:attr:`~email.policy.Policy.verify_generated_headers`. (Contributed by Bas
Bloemsaat and Petr Viktorin in :gh:`121650`).
- gh-143935: Fixed a bug in the folding of comments when flattening an email
message using a modern email policy. Comments consisting of a very long
sequence of non-foldable characters could trigger a forced line wrap that
omitted the required leading space on the continuation line, causing the
remainder of the comment to be interpreted as a new header field. This
enabled header injection with carefully crafted inputs.
- gh-143925: Reject control characters in ``data:`` URL media types.
- gh-143919: Reject control characters in :class:`http.cookies.Morsel`
fields and values.
- gh-143916: Reject C0 control characters within wsgiref.headers.Headers
fields, values, and parameters.
Library
-------
- gh-144380: Improve performance of :class:`io.BufferedReader` line
iteration by ~49%.
- gh-144169: Fix three crashes when non-string keyword arguments are
supplied to objects in the :mod:`ast` module.
- gh-144100: Fixed a crash in ctypes when using a deprecated
``POINTER(str)`` type in ``argtypes``. Instead of aborting, ctypes now
raises a proper Python exception when the pointer target type is
unresolved.
- gh-144050: Fix :func:`stat.filemode` in the pure-Python implementation to
avoid misclassifying invalid mode values as block devices.
- gh-144023: Fixed validation of file descriptor 0 in posix functions when
used with follow_symlinks parameter.
- gh-143999: Fix an issue where :func:`inspect.getgeneratorstate` and
:func:`inspect.getcoroutinestate` could fail for generators wrapped by
:func:`types.coroutine` in the suspended state.
- gh-143831: :class:`annotationlib.ForwardRef` objects are now hashable when
created from annotation scopes with closures. Previously, hashing such
objects would throw an exception. Patch by Bartosz Sławecki.
- gh-143874: Fixed a bug in :mod:`pdb` where expression results were not
sent back to remote client.
- gh-143880: Fix data race in :func:`functools.partial` in the :term:`free
threading` build.
- gh-143706: Fix :mod:`multiprocessing` forkserver so that :data:`sys.argv`
is correctly set before ``__main__`` is preloaded. Previously,
:data:`sys.argv` was empty during main module import in forkserver child
processes. This fixes a regression introduced in 3.13.8 and 3.14.1. Root
caused by Aaron Wieczorek, test provided by Thomas Watson, thanks!
- gh-143638: Forbid reentrant calls of the :class:`pickle.Pickler` and
:class:`pickle.Unpickler` methods for the C implementation. Previously,
this could cause crash or data corruption, now concurrent calls of methods
of the same object raise :exc:`RuntimeError`.
- gh-78724: Raise :exc:`RuntimeError`'s when user attempts to call methods
on half-initialized :class:`~struct.Struct` objects, For example, created
by ``Struct.__new__(Struct)``. Patch by Sergey B Kirpichev.
- gh-143196: Fix crash when the internal encoder object returned by
undocumented function :func:`!json.encoder.c_make_encoder` was called with
non-zero second (*_current_indent_level*) argument.
- gh-143191: :func:`_thread.stack_size` now raises :exc:`ValueError` if the
stack size is too small. Patch by Victor Stinner.
- gh-143602: Fix a inconsistency issue in :meth:`~io.RawIOBase.write` that
leads to unexpected buffer overwrite by deduplicating the buffer exports.
- gh-143547: Fix :func:`sys.unraisablehook` when the hook raises an
exception and changes :func:`sys.unraisablehook`: hold a strong reference
to the old hook. Patch by Victor Stinner.
- gh-143517: :func:`annotationlib.get_annotations` no longer raises a
:exc:`SyntaxError` when evaluating a stringified starred annotation that
starts with one or more whitespace characters followed by a ``*``. Patch
by Bartosz Sławecki.
- gh-143378: Fix use-after-free crashes when a :class:`~io.BytesIO` object
is concurrently mutated during :meth:`~io.RawIOBase.write` or
:meth:`~io.IOBase.writelines`.
- gh-143346: Fix incorrect wrapping of the Base64 data in
:class:`!plistlib._PlistWriter` when the indent contains a mix of tabs and
spaces.
- gh-143310: :mod:`tkinter`: fix a crash when a Python :class:`list` is
mutated during the conversion to a Tcl object (e.g., when setting a Tcl
variable). Patch by Bénédikt Tran.
- gh-143309: Fix a crash in :func:`os.execve` on non-Windows platforms when
given a custom environment mapping which is then mutated during parsing.
Patch by Bénédikt Tran.
- gh-143308: :mod:`pickle`: fix use-after-free crashes when a
:class:`~pickle.PickleBuffer` is concurrently mutated by a custom buffer
callback during pickling. Patch by Bénédikt Tran and Aaron Wieczorek.
- gh-143237: Fix support of named pipes in the rotating :mod:`logging`
handlers.
- gh-143249: Fix possible buffer leaks in Windows overlapped I/O on error
handling.
- gh-143241: :mod:`zoneinfo`: fix infinite loop in :meth:`ZoneInfo.from_file
` when parsing a malformed TZif file. Patch
by Fatih Celik.
- gh-142830: :mod:`sqlite3`: fix use-after-free crashes when the
connection's callbacks are mutated during a callback execution. Patch by
Bénédikt Tran.
- gh-143200: :mod:`xml.etree.ElementTree`: fix use-after-free crashes in
:meth:`~object.__getitem__` and :meth:`~object.__setitem__` methods of
:class:`~xml.etree.ElementTree.Element` when the element is concurrently
mutated. Patch by Bénédikt Tran.
- gh-142195: Updated timeout evaluation logic in :mod:`subprocess` to be
compatible with deterministic environments like Shadow where time moves
exactly as requested.
- gh-142164: Fix the ctypes bitfield overflow error message to report the
correct offset and size calculation.
- gh-143145: Fixed a possible reference leak in ctypes when constructing
results with multiple output parameters on error.
- gh-122431: Corrected the error message in
:func:`readline.append_history_file` to state that ``nelements`` must be
non-negative instead of positive.
- gh-143004: Fix a potential use-after-free in
:meth:`collections.Counter.update` when user code mutates the Counter
during an update.
- gh-143046: The :mod:`asyncio` REPL no longer prints copyright and version
messages in the quiet mode (:option:`-q`). Patch by Bartosz Sławecki.
- gh-140648: The :mod:`asyncio` REPL now respects the :option:`-I` flag
(isolated mode). Previously, it would load and execute
:envvar:`PYTHONSTARTUP` even if the flag was set. Contributed by Bartosz
Sławecki.
- gh-142991: Fixed socket operations such as recvfrom() and sendto() for
FreeBSD divert(4) socket.
- gh-143010: Fixed a bug in :mod:`mailbox` where the precise timing of an
external event could result in the library opening an existing file
instead of a file it expected to create.
- gh-142881: Fix concurrent and reentrant call of :func:`atexit.unregister`.
- gh-112127: Fix possible use-after-free in :func:`atexit.unregister` when
the callback is unregistered during comparison.
- gh-142783: Fix zoneinfo use-after-free with descriptor _weak_cache. a
descriptor as _weak_cache could cause crashes during object creation. The
fix ensures proper reference counting for descriptor-provided objects.
- gh-142754: Add the *ownerDocument* attribute to :mod:`xml.dom.minidom`
elements and attributes created by directly instantiating the ``Element``
or ``Attr`` class. Note that this way of creating nodes is not supported;
creator functions like :py:meth:`xml.dom.Document.documentElement` should
be used instead.
- gh-142784: The :mod:`asyncio` REPL now properly closes the loop upon the
end of interactive session. Previously, it could cause surprising
warnings. Contributed by Bartosz Sławecki.
- gh-142555: :mod:`array`: fix a crash in ``a[i] = v`` when converting *i*
to an index via :meth:`i.__index__ ` or
:meth:`i.__float__ ` mutates the array.
- gh-142594: Fix crash in ``TextIOWrapper.close()`` when the underlying
buffer's ``closed`` property calls :meth:`~io.TextIOBase.detach`.
- gh-142451: :mod:`hmac`: Ensure that the :attr:`HMAC.block_size
` attribute is correctly copied by :meth:`HMAC.copy
`. Patch by Bénédikt Tran.
- gh-142495: :class:`collections.defaultdict` now prioritizes
:meth:`~object.__setitem__` when inserting default values from
``default_factory``. This prevents race conditions where a default value
would overwrite a value set before ``default_factory`` returns.
- gh-142651: :mod:`unittest.mock`: fix a thread safety issue where
:attr:`Mock.call_count ` may return
inaccurate values when the mock is called concurrently from multiple
threads.
- gh-142595: Added type check during initialization of the :mod:`decimal`
module to prevent a crash in case of broken stdlib. Patch by Sergey B
Kirpichev.
- gh-142556: Fix crash when a task gets re-registered during finalization in
:mod:`asyncio`. Patch by Kumar Aditya.
- gh-123241: Avoid reference count operations in garbage collection of
:mod:`ctypes` objects.
- gh-142517: The non-``compat32`` :mod:`email` policies now correctly handle
refolding encoded words that contain bytes that can not be decoded in
their specified character set. Previously this resulted in an encoding
exception during folding.
- gh-112527: The help text for required options in :mod:`argparse` no longer
extended with " (default: None)".
- gh-142346: Fix usage formatting for mutually exclusive groups in
:mod:`argparse` when they are preceded by positional arguments or followed
or intermixed with other optional arguments.
- gh-142315: Pdb can now run scripts from anonymous pipes used in process
substitution. Patch by Bartosz Sławecki.
- gh-142332: Fix usage formatting for positional arguments in mutually
exclusive groups in :mod:`argparse`. in :mod:`argparse`.
- gh-142282: Fix :func:`winreg.QueryValueEx` to not accidentally read
garbage buffer under race condition.
- gh-75949: Fix :mod:`argparse` to preserve ``|`` separators in mutually
exclusive groups when the usage line wraps due to length.
- gh-142267: Improve :mod:`argparse` performance by caching the formatter
used for argument validation.
- gh-68552: ``MisplacedEnvelopeHeaderDefect`` and ``Missing header name``
defects are now correctly passed to the ``handle_defect`` method of
``policy`` in :class:`~email.parser.FeedParser`.
- gh-142006: Fix a bug in the :mod:`email.policy.default` folding algorithm
which incorrectly resulted in a doubled newline when a line ending at
exactly max_line_length was followed by an unfoldable token.
- gh-105836: Fix :meth:`asyncio.run_coroutine_threadsafe` leaving underlying
cancelled asyncio task running.
- gh-139971: :mod:`pydoc`: Ensure that the link to the online documentation
of a :term:`stdlib` module is correct.
- gh-139262: Some keystrokes can be swallowed in the new ``PyREPL`` on
Windows, especially when used together with the ALT key. Fix by Chris
Eibl.
- gh-138897: Improved :data:`license`/:data:`copyright`/:data:`credits`
display in the :term:`REPL`: now uses a pager.
- gh-79986: Add parsing for ``References`` and ``In-Reply-To`` headers to
the :mod:`email` library that parses the header content as lists of
message id tokens. This prevents them from being folded incorrectly.
- gh-136282: Add support for :const:`~configparser.UNNAMED_SECTION` when
creating a section via the mapping protocol access
- gh-109263: Starting a process from spawn context in :mod:`multiprocessing`
no longer sets the start method globally.
- gh-133253: Fix thread-safety issues in :mod:`linecache`.
- gh-132715: Skip writing objects during marshalling once a failure has
occurred.
IDLE
----
- gh-143774: Better explain the operation of Format / Format Paragraph.
Documentation
-------------
- gh-140806: Add documentation for :func:`enum.bin`.
Core and Builtins
-----------------
- gh-144307: Prevent a reference leak in module teardown at interpreter
finalization.
- gh-144194: Fix error handling in perf jitdump initialization on memory
allocation failure.
- gh-144012: Check if the result is ``NULL`` in ``BINARY_OP_EXTENT`` opcode.
- gh-141805: Fix crash in :class:`set` when objects with the same hash are
concurrently added to the set after removing an element with the same hash
while the set still contains elements with the same hash.
- gh-143670: Fixes a crash in ``ga_repr_items_list`` function.
- gh-143377: Fix a crash in :func:`!_interpreters.capture_exception` when
the exception is incorrectly formatted. Patch by Bénédikt Tran.
- gh-136924: The interactive help mode in the :term:`REPL` no longer
incorrectly syntax highlights text input as Python code. Contributed by
Olga Matoula.
- gh-143189: Fix crash when inserting a non-:class:`str` key into a split
table dictionary when the key matches an existing key in the split table
but has no corresponding value in the dict.
- gh-143228: Fix use-after-free in perf trampoline when toggling profiling
while threads are running or during interpreter finalization with daemon
threads active. The fix uses reference counting to ensure trampolines are
not freed while any code object could still reference them. Pach by Pablo
Galindo
- gh-142664: Fix a use-after-free crash in :meth:`memoryview.__hash__
` when the ``__hash__`` method of the referenced object
mutates that object or the view. Patch by Bénédikt Tran.
- gh-142557: Fix a use-after-free crash in :ref:`bytearray.__mod__
` when the :class:`!bytearray` is mutated while
formatting the ``%``-style arguments. Patch by Bénédikt Tran.
- gh-143195: Fix use-after-free crashes in :meth:`bytearray.hex` and
:meth:`memoryview.hex` when the separator's :meth:`~object.__len__`
mutates the original object. Patch by Bénédikt Tran.
- gh-142975: Fix crash after unfreezing all objects tracked by the garbage
collector on the :term:`free threaded ` build.
- gh-143135: Set :data:`sys.flags.inspect` to ``1`` when
:envvar:`PYTHONINSPECT` is ``0``. Previously, it was set to ``0`` in this
case.
- gh-143003: Fix an overflow of the shared empty buffer in
:meth:`bytearray.extend` when ``__length_hint__()`` returns 0 for
non-empty iterator.
- gh-143006: Fix a possible assertion error when comparing negative
non-integer ``float`` and ``int`` with the same number of bits in the
integer part.
- gh-143057: Avoid locking in :c:func:`PyTraceMalloc_Track` and
:c:func:`PyTraceMalloc_Untrack` when :mod:`tracemalloc` is not enabled.
- gh-142776: Fix a file descriptor leak in import.c
- gh-142829: Fix a use-after-free crash in :class:`contextvars.Context`
comparison when a custom ``__eq__`` method modifies the context via
:meth:`~contextvars.ContextVar.set`.
- gh-142766: Clear the frame of a generator when :meth:`generator.close` is
called.
- gh-142737: Tracebacks will be displayed in fallback mode even if
:func:`io.open` is lost. Previously, this would crash the interpreter.
Patch by Bartosz Sławecki.
- gh-142554: Fix a crash in :func:`divmod` when :func:`!_pylong.int_divmod`
does not return a tuple of length two exactly. Patch by Bénédikt Tran.
- gh-142560: Fix use-after-free in :class:`bytearray` search-like methods
(:meth:`~bytearray.find`, :meth:`~bytearray.count`,
:meth:`~bytearray.index`, :meth:`~bytearray.rindex`, and
:meth:`~bytearray.rfind`) by marking the storage as exported which causes
reallocation attempts to raise :exc:`BufferError`. For
:func:`~operator.contains`, :meth:`~bytearray.split`, and
:meth:`~bytearray.rsplit` the :ref:`buffer protocol ` is
used for this.
- gh-142531: Fix a free-threaded GC performance regression. If there are
many untracked tuples, the GC will run too often, resulting in poor
performance. The fix is to include untracked tuples in the "long lived"
object count. The number of frozen objects is also now included since the
free-threaded GC must scan those too.
- gh-142402: Fix reference counting when adjacent literal parts are merged
while constructing :class:`string.templatelib.Template`, preventing the
displaced string object from leaking.
- gh-133932: Fix crash in the free threading build when clearing frames that
hold tagged integers.
- gh-142343: Fix SIGILL crash on m68k due to incorrect assembly constraint.
- gh-100964: Fix reference cycle in exhausted generator frames. Patch by
Savannah Ostrowski.
- gh-69605: Fix edge-cases around already imported modules in the
:term:`REPL` auto-completion of imports.
- gh-138568: Adjusted the built-in :func:`help` function so that empty
inputs are ignored in interactive mode.
- gh-137007: Fix a bug during JIT compilation failure which caused garbage
collection debug assertions to fail.
C API
-----
- gh-142589: Fix :c:func:`PyUnstable_Object_IsUniqueReferencedTemporary()`
handling of tagged ints on the interpreter stack.
- gh-142571: :c:func:`!PyUnstable_CopyPerfMapFile` now checks that opening
the file succeeded before flushing.
Build
-----
- gh-142454: When calculating the digest of the JIT stencils input, sort the
hashed files by filenames before adding their content to the hasher. This
ensures deterministic hash input and hence deterministic hash, independent
on filesystem order.
- gh-141808: When running ``make clean-retain-profile``, keep the generated
JIT stencils. That way, the stencils are not generated twice when
Profile-guided optimization (PGO) is used. It also allows distributors to
supply their own pre-built JIT stencils.
- gh-138061: Ensure reproducible builds by making JIT stencil header
generation deterministic.
What's New in Python 3.14.2 final?
==================================
*Release date: 2025-12-05*
Security
--------
- gh-142145: Remove quadratic behavior in ``xml.minidom`` node ID cache
clearing.
- gh-119452: Fix a potential memory denial of service in the
:mod:`http.server` module. When a malicious user is connected to the CGI
server on Windows, it could cause an arbitrary amount of memory to be
allocated. This could have led to symptoms including a :exc:`MemoryError`,
swapping, out of memory (OOM) killed processes or containers, or even
system crashes.
Library
-------
- gh-140797: Revert changes to the undocumented :class:`!re.Scanner` class.
Capturing groups are still allowed for backward compatibility, although
using them can lead to incorrect result. They will be forbidden in future
Python versions.
- gh-142206: The resource tracker in the :mod:`multiprocessing` module now
uses the original communication protocol, as in Python 3.14.0 and below,
by default. This avoids issues with upgrading Python while it is running.
(Note that such 'in-place' upgrades are not tested.) The tracker remains
compatible with subprocesses that use new protocol (that is, subprocesses
using Python 3.13.10, 3.14.1 and 3.15).
- gh-142214: Fix two regressions in :mod:`dataclasses` in Python 3.14.1
related to annotations.
* An exception is no longer raised if ``slots=True`` is used and the
``__init__`` method does not have an ``__annotate__`` attribute
(likely because ``init=False`` was used).
* An exception is no longer raised if annotations are requested on the
``__init__`` method and one of the fields is not present in the class
annotations. This can occur in certain dynamic scenarios.
Patch by Jelle Zijlstra.
Core and Builtins
-----------------
- gh-142218: Fix crash when inserting into a split table dictionary with a
non :class:`str` key that matches an existing key.
Library
-------
- gh-116738: Fix :mod:`cmath` data race when initializing trigonometric
tables with subinterpreters.
What's New in Python 3.14.1 final?
==================================
*Release date: 2025-12-02*
Windows
-------
- gh-139810: Installing with ``py install 3[.x]-dev`` will now select final
versions as well as prereleases.
Tools/Demos
-----------
- gh-141692: Each slice of an iOS XCframework now contains a ``lib`` folder
that contains a symlink to the libpython dylib. This allows binary modules
to be compiled for iOS using dynamic libreary linking, rather than
Framework linking.
- gh-141442: The iOS testbed now correctly handles test arguments that
contain spaces.
- gh-140702: The iOS testbed app will now expose the ``GITHUB_ACTIONS``
environment variable to iOS apps being tested.
- gh-137484: Have ``Tools/wasm/wasi`` put the build Python into a directory
named after the build triple instead of "build".
- gh-137248: Add a ``--logdir`` option to ``Tools/wasm/wasi`` for specifying
where to write log files.
- gh-137243: Have Tools/wasm/wasi detect a WASI SDK install in /opt when it
was directly extracted from a release tarball.
Tests
-----
- gh-140482: Preserve and restore the state of ``stty echo`` as part of the
test environment.
- gh-140082: Update ``python -m test`` to set ``FORCE_COLOR=1`` when being
run with color enabled so that :mod:`unittest` which is run by it with
redirected output will output in color.
- gh-139208: Fix regrtest ``--fast-ci --verbose``: don't ignore the
``--verbose`` option anymore. Patch by Victor Stinner.
- gh-136442: Use exitcode ``1`` instead of ``5`` if
:func:`unittest.TestCase.setUpClass` raises an exception
Security
--------
- gh-139700: Check consistency of the zip64 end of central directory record.
Support records with "zip64 extensible data" if there are no bytes
prepended to the ZIP file.
- gh-139283: :mod:`sqlite3`: correctly handle maximum number of rows to
fetch in :meth:`Cursor.fetchmany ` and reject
negative values for :attr:`Cursor.arraysize `.
Patch by Bénédikt Tran.
- gh-137836: Add support of the "plaintext" element, RAWTEXT elements "xmp",
"iframe", "noembed" and "noframes", and optionally RAWTEXT element
"noscript" in :class:`html.parser.HTMLParser`.
- gh-136063: :mod:`email.message`: ensure linear complexity for legacy HTTP
parameters parsing. Patch by Bénédikt Tran.
- gh-136065: Fix quadratic complexity in :func:`os.path.expandvars`.
- gh-119451: Fix a potential memory denial of service in the
:mod:`http.client` module. When connecting to a malicious server, it could
cause an arbitrary amount of memory to be allocated. This could have led
to symptoms including a :exc:`MemoryError`, swapping, out of memory (OOM)
killed processes or containers, or even system crashes.
- gh-119342: Fix a potential memory denial of service in the :mod:`plistlib`
module. When reading a Plist file received from untrusted source, it could
cause an arbitrary amount of memory to be allocated. This could have led
to symptoms including a :exc:`MemoryError`, swapping, out of memory (OOM)
killed processes or containers, or even system crashes.
Library
-------
- gh-74389: When the stdin being used by a :class:`subprocess.Popen`
instance is closed, this is now ignored in
:meth:`subprocess.Popen.communicate` instead of leaving the class in an
inconsistent state.
- gh-87512: Fix :func:`subprocess.Popen.communicate` timeout handling on
Windows when writing large input. Previously, the timeout was ignored
during stdin writing, causing the method to block indefinitely if the
child process did not consume input quickly. The stdin write is now
performed in a background thread, allowing the timeout to be properly
enforced.
- gh-141473: When :meth:`subprocess.Popen.communicate` was called with
*input* and a *timeout* and is called for a second time after a
:exc:`~subprocess.TimeoutExpired` exception before the process has died,
it should no longer hang.
- gh-59000: Fix :mod:`pdb` breakpoint resolution for class methods when the
module defining the class is not imported.
- gh-141570: Support :term:`file-like object` raising :exc:`OSError` from
:meth:`~io.IOBase.fileno` in color detection
(``_colorize.can_colorize()``). This can occur when ``sys.stdout`` is
redirected.
- gh-141659: Fix bad file descriptor errors from ``_posixsubprocess`` on
AIX.
- gh-141600: Fix musl version detection on Void Linux.
- gh-141497: :mod:`ipaddress`: ensure that the methods
:meth:`IPv4Network.hosts() ` and
:meth:`IPv6Network.hosts() ` always return an
iterator.
- gh-140938: The :func:`statistics.stdev` and :func:`statistics.pstdev`
functions now raise a :exc:`ValueError` when the input contains an
infinity or a NaN.
- gh-124111: Updated Tcl threading configuration in :mod:`_tkinter` to
assume that threads are always available in Tcl 9 and later.
- gh-137109: The :mod:`os.fork` and related forking APIs will no longer warn
in the common case where Linux or macOS platform APIs return the number of
threads in a process and find the answer to be 1 even when a
:func:`os.register_at_fork` ``after_in_parent=`` callback (re)starts a
thread.
- gh-141314: Fix assertion failure in :meth:`io.TextIOWrapper.tell` when
reading files with standalone carriage return (``\r``) line endings.
- gh-141311: Fix assertion failure in :func:`!io.BytesIO.readinto` and
undefined behavior arising when read position is above capcity in
:class:`io.BytesIO`.
- gh-141141: Fix a thread safety issue with :func:`base64.b85decode`.
Contributed by Benel Tayar.
- gh-137969: Fix :meth:`annotationlib.ForwardRef.evaluate` returning
:class:`~annotationlib.ForwardRef` objects which don't update with new
globals.
- gh-140911: :mod:`collections`: Ensure that the methods
``UserString.rindex()`` and ``UserString.index()`` accept
:class:`collections.UserString` instances as the sub argument.
- gh-140797: The undocumented :class:`!re.Scanner` class now forbids regular
expressions containing capturing groups in its lexicon patterns. Patterns
using capturing groups could previously lead to crashes with segmentation
fault. Use non-capturing groups (?:...) instead.
- gh-125115: Refactor the :mod:`pdb` parsing issue so positional arguments
can pass through intuitively.
- gh-140815: :mod:`faulthandler` now detects if a frame or a code object is
invalid or freed. Patch by Victor Stinner.
- gh-100218: Correctly set :attr:`~OSError.errno` when
:func:`socket.if_nametoindex` or :func:`socket.if_indextoname` raise an
:exc:`OSError`. Patch by Bénédikt Tran.
- gh-140875: Fix handling of unclosed character references (named and
numerical) followed by the end of file in :class:`html.parser.HTMLParser`
with ``convert_charrefs=False``.
- gh-140734: :mod:`multiprocessing`: fix off-by-one error when checking the
length of a temporary socket file path. Patch by Bénédikt Tran.
- gh-140874: Bump the version of pip bundled in ensurepip to version 25.3
- gh-140691: In :mod:`urllib.request`, when opening a FTP URL fails because
a data connection cannot be made, the control connection's socket is now
closed to avoid a :exc:`ResourceWarning`.
- gh-103847: Fix hang when cancelling process created by
:func:`asyncio.create_subprocess_exec` or
:func:`asyncio.create_subprocess_shell`. Patch by Kumar Aditya.
- gh-120057: Add :func:`os.reload_environ` to ``os.__all__``.
- gh-140228: Avoid making unnecessary filesystem calls for frozen modules in
:mod:`linecache` when the global module cache is not present.
- gh-140590: Fix arguments checking for the
:meth:`!functools.partial.__setstate__` that may lead to internal state
corruption and crash. Patch by Sergey Miryanov.
- gh-125434: Display thread name in :mod:`faulthandler` on Windows. Patch by
Victor Stinner.
- gh-140634: Fix a reference counting bug in
:meth:`!os.sched_param.__reduce__`.
- gh-140633: Ignore :exc:`AttributeError` when setting a module's
``__file__`` attribute when loading an extension module packaged as Apple
Framework.
- gh-140593: :mod:`xml.parsers.expat`: Fix a memory leak that could affect
users with :meth:`~xml.parsers.expat.xmlparser.ElementDeclHandler` set to
a custom element declaration handler. Patch by Sebastian Pipping.
- gh-140607: Inside :meth:`io.RawIOBase.read`, validate that the count of
bytes returned by :meth:`io.RawIOBase.readinto` is valid (inside the
provided buffer).
- gh-138162: Fix :class:`logging.LoggerAdapter` with ``merge_extra=True``
and without the *extra* argument.
- gh-138774: :func:`ast.unparse` now generates full source code when
handling :class:`ast.Interpolation` nodes that do not have a specified
source.
- gh-140474: Fix memory leak in :class:`array.array` when creating arrays
from an empty :class:`str` and the ``u`` type code.
- gh-137530: :mod:`dataclasses` Fix annotations for generated ``__init__``
methods by replacing the annotations that were in-line in the generated
source code with ``__annotate__`` functions attached to the methods.
- gh-140348: Fix regression in Python 3.14.0 where using the ``|`` operator
on a :class:`typing.Union` object combined with an object that is not a
type would raise an error.
- gh-140272: Fix memory leak in the :meth:`!clear` method of the
:mod:`dbm.gnu` database.
- gh-140041: Fix import of :mod:`ctypes` on Android and Cygwin when ABI
flags are present.
- gh-140120: Fixed a memory leak in :mod:`hmac` when it was using the
hacl-star backend. Discovered by ``@ashm-dev`` using AddressSanitizer.
- gh-139905: Add suggestion to error message for :class:`typing.Generic`
subclasses when ``cls.__parameters__`` is missing due to a parent class
failing to call :meth:`super().__init_subclass__()
` in its ``__init_subclass__``.
- gh-139894: Fix incorrect sharing of current task with the child process
while forking in :mod:`asyncio`. Patch by Kumar Aditya.
- gh-139845: Fix to not print KeyboardInterrupt twice in default asyncio
REPL.
- gh-139783: Fix :func:`inspect.getsourcelines` for the case when a
decorator is followed by a comment or an empty line.
- gh-139809: Prevent premature colorization of subparser ``prog`` in
:meth:`argparse.ArgumentParser.add_subparsers` to respect color
environment variable changes after parser creation.
- gh-139736: Fix excessive indentation in the default :mod:`argparse`
:class:`!HelpFormatter`. Patch by Alexander Edland.
- gh-70765: :mod:`http.server`: fix default handling of HTTP/0.9 requests in
:class:`~http.server.BaseHTTPRequestHandler`. Previously,
:meth:`!BaseHTTPRequestHandler.parse_request` incorrectly waited for
headers in the request although those are not supported in HTTP/0.9. Patch
by Bénédikt Tran.
- gh-63161: Fix :func:`tokenize.detect_encoding`. Support non-UTF-8 shebang
and comments if non-UTF-8 encoding is specified. Detect decoding error for
non-UTF-8 encoding. Detect null bytes in source code.
- gh-139391: Fix an issue when, on non-Windows platforms, it was not
possible to gracefully exit a ``python -m asyncio`` process suspended by
Ctrl+Z and later resumed by :manpage:`fg` other than with :manpage:`kill`.
- gh-101828: Fix ``'shift_jisx0213'``, ``'shift_jis_2004'``,
``'euc_jisx0213'`` and ``'euc_jis_2004'`` codecs truncating null chars as
they were treated as part of multi-character sequences.
- gh-139289: Do a real lazy-import on :mod:`rlcompleter` in :mod:`pdb` and
restore the existing completer after importing :mod:`rlcompleter`.
- gh-139246: fix: paste zero-width in default repl width is wrong.
- gh-90949: Add
:meth:`~xml.parsers.expat.xmlparser.SetAllocTrackerActivationThreshold`
and
:meth:`~xml.parsers.expat.xmlparser.SetAllocTrackerMaximumAmplification`
to :ref:`xmlparser ` objects to tune protections
against disproportional amounts of dynamic memory usage from within an
Expat parser. Patch by Bénédikt Tran.
- gh-139210: Fix use-after-free when reporting unknown event in
:func:`xml.etree.ElementTree.iterparse`. Patch by Ken Jin.
- gh-138860: Lazy import :mod:`rlcompleter` in :mod:`pdb` to avoid deadlock
in subprocess.
- gh-112729: Fix crash when calling :func:`concurrent.interpreters.create`
when the process is out of memory.
- gh-135729: Fix unraisable exception during finalization when using
:mod:`concurrent.interpreters` in the REPL.
- gh-139076: Fix a bug in the :mod:`pydoc` module that was hiding functions
in a Python module if they were implemented in an extension module and the
module did not have ``__all__``.
- gh-139065: Fix trailing space before a wrapped long word if the line
length is exactly *width* in :mod:`textwrap`.
- gh-139001: Fix race condition in :class:`pathlib.Path` on the internal
``_raw_paths`` field.
- gh-138813: :class:`!multiprocessing.BaseProcess` defaults ``kwargs`` to
``None`` instead of a shared dictionary.
- gh-138993: Dedent :data:`credits` text.
- gh-138891: Fix ``SyntaxError`` when ``inspect.get_annotations(f,
eval_str=True)`` is called on a function annotated with a :pep:`646`
``star_expression``
- gh-130567: Fix possible crash in :func:`locale.strxfrm` due to a platform
bug on macOS.
- gh-138859: Fix generic type parameterization raising a :exc:`TypeError`
when omitting a :class:`ParamSpec` that has a default which is not a list
of types.
- gh-138764: Prevent :func:`annotationlib.call_annotate_function` from
calling ``__annotate__`` functions that don't support
``VALUE_WITH_FAKE_GLOBALS`` in a fake globals namespace with empty
globals.
Make ``FORWARDREF`` and ``STRING`` annotations fall back to using
``VALUE`` annotations in the case that neither their own format, nor
``VALUE_WITH_FAKE_GLOBALS`` are supported.
- gh-138775: Use of ``python -m`` with :mod:`base64` has been fixed to
detect input from a terminal so that it properly notices EOF.
- gh-138779: Support device numbers larger than ``2**63-1`` for the
:attr:`~os.stat_result.st_rdev` field of the :class:`os.stat_result`
structure.
- gh-137706: Fix the partial evaluation of annotations that use
``typing.Annotated[T, x]`` where ``T`` is a forward reference.
- gh-88375: Fix normalization of the ``robots.txt`` rules and URLs in the
:mod:`urllib.robotparser` module. No longer ignore trailing ``?``.
Distinguish raw special characters ``?``, ``=`` and ``&`` from the
percent-encoded ones.
- gh-111788: Fix parsing errors in the :mod:`urllib.robotparser` module.
Don't fail trying to parse weird paths. Don't fail trying to decode
non-UTF-8 ``robots.txt`` files.
- gh-98896: Fix a failure in multiprocessing resource_tracker when
SharedMemory names contain colons. Patch by Rani Pinchuk.
- gh-138425: Fix partial evaluation of :class:`annotationlib.ForwardRef`
objects which rely on names defined as globals.
- gh-138432: :meth:`zoneinfo.reset_tzpath` will now convert any
:class:`os.PathLike` objects it receives into strings before adding them
to ``TZPATH``. It will raise ``TypeError`` if anything other than a string
is found after this conversion. If given an :class:`os.PathLike` object
that represents a relative path, it will now raise ``ValueError`` instead
of ``TypeError``, and present a more informative error message.
- gh-138008: Fix segmentation faults in the :mod:`ctypes` module due to
invalid :attr:`~ctypes._CFuncPtr.argtypes`. Patch by Dung Nguyen.
- gh-60462: Fix :func:`locale.strxfrm` on Solaris (and possibly other
platforms).
- gh-138239: The REPL now highlights :keyword:`type` as a soft keyword in
:ref:`type statements `.
- gh-138204: Forbid expansion of shared anonymous :mod:`memory maps `
on Linux, which caused a bus error.
- gh-138010: Fix an issue where defining a class with an
:func:`@warnings.deprecated `-decorated base class
may not invoke the correct :meth:`~object.__init_subclass__` method in
cases involving multiple inheritance. Patch by Brian Schubert.
- gh-138151: In :mod:`annotationlib`, improve evaluation of forward
references to nonlocal variables that are not yet defined when the
annotations are initially evaluated.
- gh-137317: :func:`inspect.signature` now correctly handles classes that
use a descriptor on a wrapped :meth:`!__init__` or :meth:`!__new__`
method. Contributed by Yongyu Yan.
- gh-137754: Fix import of the :mod:`zoneinfo` module if the C
implementation of the :mod:`datetime` module is not available.
- gh-137490: Handle :data:`~errno.ECANCELED` in the same way as
:data:`~errno.EINTR` in :func:`signal.sigwaitinfo` on NetBSD.
- gh-137477: Fix :func:`!inspect.getblock`, :func:`inspect.getsourcelines`
and :func:`inspect.getsource` for generator expressions.
- gh-137044: Return large limit values as positive integers instead of
negative integers in :func:`resource.getrlimit`. Accept large values and
reject negative values (except :data:`~resource.RLIM_INFINITY`) for limits
in :func:`resource.setrlimit`.
- gh-75989: :func:`tarfile.TarFile.extractall` and
:func:`tarfile.TarFile.extract` now overwrite symlinks when extracting
hardlinks. (Contributed by Alexander Enrique Urieles Nieto in
:gh:`75989`.)
- gh-137017: Fix :obj:`threading.Thread.is_alive` to remain ``True`` until
the underlying OS thread is fully cleaned up. This avoids false negatives
in edge cases involving thread monitoring or premature
:obj:`threading.Thread.is_alive` calls.
- gh-137273: Fix debug assertion failure in :func:`locale.setlocale` on
Windows.
- gh-137239: :mod:`heapq`: Update :data:`!heapq.__all__` with ``*_max``
functions.
- gh-81325: :class:`tarfile.TarFile` now accepts a :term:`path-like
` when working on a tar archive. (Contributed by
Alexander Enrique Urieles Nieto in :gh:`81325`.)
- gh-137185: Fix a potential async-signal-safety issue in
:mod:`faulthandler` when printing C stack traces.
- gh-136914: Fix retrieval of :attr:`doctest.DocTest.lineno` for objects
decorated with :func:`functools.cache` or
:class:`functools.cached_property`.
- gh-136912: :func:`hmac.digest` now properly handles large keys and
messages by falling back to the pure Python implementation when necessary.
Patch by Bénédikt Tran.
- gh-83424: Allows creating a :class:`ctypes.CDLL` without name when passing
a handle as an argument.
- gh-136234: Fix :meth:`asyncio.WriteTransport.writelines` to be robust to
connection failure, by using the same behavior as
:meth:`~asyncio.WriteTransport.write`.
- gh-136507: Fix mimetypes CLI to handle multiple file parameters.
- gh-136057: Fixed the bug in :mod:`pdb` and :mod:`bdb` where ``next`` and
``step`` can't go over the line if a loop exists in the line.
- gh-135386: Fix opening a :mod:`dbm.sqlite3` database for reading from
read-only file or directory.
- gh-135444: Fix :meth:`asyncio.DatagramTransport.sendto` to account for
datagram header size when data cannot be sent.
- gh-126631: Fix :mod:`multiprocessing` ``forkserver`` bug which prevented
``__main__`` from being preloaded.
- gh-135307: :mod:`email`: Fix exception in ``set_content()`` when encoding
text and max_line_length is set to ``0`` or ``None`` (unlimited).
- gh-134453: Fixed :func:`subprocess.Popen.communicate` ``input=`` handling
of :class:`memoryview` instances that were non-byte shaped on POSIX
platforms. Those are now properly cast to a byte shaped view instead of
truncating the input. Windows platforms did not have this bug.
- gh-134698: Fix a crash when calling methods of :class:`ssl.SSLContext` or
:class:`ssl.SSLSocket` across multiple threads.
- gh-125996: Fix thread safety of :class:`collections.OrderedDict`. Patch by
Kumar Aditya.
- gh-133789: Fix unpickling of :mod:`pathlib` objects that were pickled in
Python 3.13.
- gh-127081: Fix libc thread safety issues with :mod:`dbm` by performing
stateful operations in critical sections.
- gh-132551: Make :class:`io.BytesIO` safe in :term:`free-threaded ` build.
- gh-131788: Make ``ResourceTracker.send`` from :mod:`multiprocessing`
re-entrant safe
- gh-118981: Fix potential hang in ``multiprocessing.popen_spawn_posix``
that can happen when the child proc dies early by closing the child fds
right away.
- gh-102431: Clarify constraints for "logical" arguments in methods of
:class:`decimal.Context`.
- gh-78319: UTF8 support for the IMAP APPEND command has been made RFC
compliant.
- bpo-38735: Fix failure when importing a module from the root directory on
unix-like platforms with sys.pycache_prefix set.
- bpo-41839: Allow negative priority values from
:func:`os.sched_get_priority_min` and :func:`os.sched_get_priority_max`
functions.
IDLE
----
- gh-96491: Deduplicate version number in IDLE shell title bar after saving
to a file.
- gh-139742: Colorize t-string prefixes for template strings in IDLE, as
done for f-string prefixes.
Documentation
-------------
- gh-141994: :mod:`xml.sax.handler`: Make Documentation of
:data:`xml.sax.handler.feature_external_ges` warn of opening up to
`external entity attacks
`_. Patch by
Sebastian Pipping.
- gh-140578: Remove outdated sencence in the documentation for
:mod:`multiprocessing`, that implied that
:class:`concurrent.futures.ThreadPoolExecutor` did not exist.
Core and Builtins
-----------------
- gh-142048: Fix quadratically increasing garbage collection delays in
free-threaded build.
Library
-------
- gh-116738: Fix thread safety issue with :mod:`re` scanner objects in
free-threaded builds.
Core and Builtins
-----------------
- gh-141930: When importing a module, use Python's regular file object to
ensure that writes to ``.pyc`` files are complete or an appropriate error
is raised.
- gh-120158: Fix inconsistent state when enabling or disabling monitoring
events too many times.
- gh-139653: Only raise a ``RecursionError`` or trigger a fatal error if the
stack pointer is both below the limit pointer *and* above the stack base.
If outside of these bounds assume that it is OK. This prevents false
positives when user-space threads swap stacks.
- gh-139103: Improve multithreaded scaling of dataclasses on the
free-threaded build.
- gh-141579: Fix :func:`sys.activate_stack_trampoline` to properly support
the ``perf_jit`` backend. Patch by Pablo Galindo.
- gh-114203: Skip locking if object is already locked by two-mutex critical
section.
- gh-141528: Suggest using :meth:`concurrent.interpreters.Interpreter.close`
instead of the private ``_interpreters.destroy`` function when warning
about remaining subinterpreters. Patch by Sergey Miryanov.
- gh-141312: Fix the assertion failure in the ``__setstate__`` method of the
range iterator when a non-integer argument is passed. Patch by Sergey
Miryanov.
Library
-------
- gh-116738: Make csv module thread-safe on the :term:`free threaded ` build.
Core and Builtins
-----------------
- gh-140939: Fix memory leak when :class:`bytearray` or :class:`bytes` is
formated with the ``%*b`` format with a large width that results in a
:exc:`MemoryError`.
Library
-------
- gh-140260: Fix :mod:`struct` data race in endian table initialization with
subinterpreters. Patch by Shamil Abdulaev.
Core and Builtins
-----------------
- gh-140530: Fix a reference leak when ``raise exc from cause`` fails. Patch
by Bénédikt Tran.
- gh-140373: Correctly emit ``PY_UNWIND`` event when generator object is
closed. Patch by Mikhail Efimov.
- gh-140576: Fixed crash in :func:`tokenize.generate_tokens` in case of
specific incorrect input. Patch by Mikhail Efimov.
- gh-140551: Fixed crash in :class:`dict` if :meth:`dict.clear` is called at
the lookup stage. Patch by Mikhail Efimov and Inada Naoki.
- gh-140517: Fixed a reference leak when iterating over the result of
:func:`map` with ``strict=True`` when the input iterables have different
lengths. Patch by Mikhail Efimov.
- gh-140471: Fix potential buffer overflow in :class:`ast.AST` node
initialization when encountering malformed :attr:`~ast.AST._fields`
containing non-:class:`str`.
- gh-140431: Fix a crash in Python's :term:`garbage collector ` due to partially initialized :term:`coroutine` objects when
coroutine origin tracking depth is enabled
(:func:`sys.set_coroutine_origin_tracking_depth`).
Library
-------
- gh-140398: Fix memory leaks in :mod:`readline` functions
:func:`~readline.read_init_file`, :func:`~readline.read_history_file`,
:func:`~readline.write_history_file`, and
:func:`~readline.append_history_file` when :c:func:`PySys_Audit` fails.
Core and Builtins
-----------------
- gh-140406: Fix memory leak when an object's :meth:`~object.__hash__`
method returns an object that isn't an :class:`int`.
- gh-140358: Restore elapsed time and unreachable object count in GC debug
output. These were inadvertently removed during a refactor of ``gc.c``.
The debug log now again reports elapsed collection time and the number of
unreachable objects. Contributed by Pål Grønås Drange.
- gh-140306: Fix memory leaks in cross-interpreter channel operations and
shared namespace handling.
- gh-140301: Fix memory leak of ``PyConfig`` in subinterpreters.
- gh-140257: Fix data race between interpreter_clear() and take_gil() on
eval_breaker during finalization with daemon threads.
- gh-139951: Fixes a regression in GC performance for a growing heap
composed mostly of small tuples.
* Counts number of actually tracked objects, instead of trackable objects.
This ensures that untracking tuples has the desired effect of reducing GC overhead.
* Does not track most untrackable tuples during creation.
This prevents large numbers of small tuples causing excessive GCs.
- gh-140104: Fix a bug with exception handling in the JIT. Patch by Ken Jin.
Bug reported by Daniel Diniz.
- gh-140061: Fixing the checking of whether an object is uniquely referenced
to ensure free-threaded compatibility. Patch by Sergey Miryanov.
- gh-140067: Fix memory leak in sub-interpreter creation.
- gh-140000: Fix potential memory leak when a reference cycle exists between
an instance of :class:`typing.TypeAliasType`, :class:`typing.TypeVar`,
:class:`typing.ParamSpec`, or :class:`typing.TypeVarTuple` and its
``__name__`` attribute. Patch by Mikhail Efimov.
- gh-139914: Restore support for HP PA-RISC, which has an upwards-growing
stack.
- gh-139988: Fix a memory leak when failing to create a
:class:`~typing.Union` type. Patch by Bénédikt Tran.
- gh-139748: Fix reference leaks in error branches of functions accepting
path strings or bytes such as :func:`compile` and :func:`os.system`. Patch
by Bénédikt Tran.
- gh-139516: Fix lambda colon erroneously start format spec in f-string in
tokenizer.
- gh-139640: :func:`ast.parse` no longer emits syntax warnings for
``return``/``break``/``continue`` in ``finally`` (see :pep:`765`) -- they
are only emitted during compilation.
- gh-139640: Fix swallowing some syntax warnings in different modules if
they accidentally have the same message and are emitted from the same
line. Fix duplicated warnings in the ``finally`` block.
- gh-63161: Support non-UTF-8 shebang and comments in Python source files if
non-UTF-8 encoding is specified. Detect decoding error in comments for
default (UTF-8) encoding. Show the line and position of decoding error for
default encoding in a traceback. Show the line containing the coding
cookie when it conflicts with the BOM in a traceback.
Library
-------
- gh-116738: Make :mod:`mmap` thread-safe on the :term:`free threaded ` build.
Core and Builtins
-----------------
- gh-138558: Fix handling of unusual t-string annotations in annotationlib.
Patch by Dave Peck.
- gh-134466: Don't run PyREPL in a degraded environment where setting
termios attributes is not allowed.
- gh-138944: Fix :exc:`SyntaxError` message when invalid syntax appears on
the same line as a valid ``import ... as ...`` or ``from ... import ... as
...`` statement. Patch by Brian Schubert.
- gh-105487: Remove non-existent :meth:`~object.__copy__`,
:meth:`~object.__deepcopy__`, and :attr:`~type.__bases__` from the
:meth:`~object.__dir__` entries of :class:`types.GenericAlias`.
- gh-69605: Fix some standard library submodules missing from the
:term:`REPL` auto-completion of imports.
Library
-------
- gh-116738: Make :mod:`cProfile` thread-safe on the :term:`free threaded
` build.
- gh-138004: On Solaris/Illumos platforms, thread names are now encoded as
ASCII to avoid errors on systems (e.g. OpenIndiana) that don't support
non-ASCII names.
Core and Builtins
-----------------
- gh-137433: Fix a potential deadlock in the :term:`free threading` build
when daemon threads enable or disable profiling or tracing while the main
thread is shutting down the interpreter.
- gh-137400: Fix a crash in the :term:`free threading` build when disabling
profiling or tracing across all threads with
:c:func:`PyEval_SetProfileAllThreads` or
:c:func:`PyEval_SetTraceAllThreads` or their Python equivalents
:func:`threading.settrace_all_threads` and
:func:`threading.setprofile_all_threads`.
- gh-58124: Fix name of the Python encoding in Unicode errors of the code
page codec: use "cp65000" and "cp65001" instead of "CP_UTF7" and "CP_UTF8"
which are not valid Python code names. Patch by Victor Stinner.
- gh-132657: Improve performance of :class:`frozenset` by removing locks in
the free-threading build.
- gh-133400: Fixed Ctrl+D (^D) behavior in _pyrepl module to match old
pre-3.13 REPL behavior.
- gh-128640: Fix a crash when using threads inside of a subinterpreter.
C API
-----
- gh-137422: Fix :term:`free threading` race condition in
:c:func:`PyImport_AddModuleRef`. It was previously possible for two calls
to the function return two different objects, only one of which was stored
in :data:`sys.modules`.
- gh-140042: Removed the sqlite3_shutdown call that could cause closing
connections for sqlite when used with multiple sub interpreters.
- gh-141042: Make qNaN in :c:func:`PyFloat_Pack2` and
:c:func:`PyFloat_Pack4`, if while conversion to a narrower precision
floating-point format --- the remaining after truncation payload will be
zero. Patch by Sergey B Kirpichev.
- gh-140487: Fix :c:macro:`Py_RETURN_NOTIMPLEMENTED` in limited C API 3.11
and older: don't treat ``Py_NotImplemented`` as immortal. Patch by Victor
Stinner.
- gh-140153: Fix :c:func:`Py_REFCNT` definition on limited C API 3.11-3.13.
Patch by Victor Stinner.
- gh-139653: Add :c:func:`PyUnstable_ThreadState_SetStackProtection` and
:c:func:`PyUnstable_ThreadState_ResetStackProtection` functions to set the
stack protection base address and stack protection size of a Python thread
state. Patch by Victor Stinner.
Build
-----
- gh-141808: Do not generate the jit stencils twice in case of PGO builds on
Windows.
- gh-141784: Fix ``_remote_debugging_module.c`` compilation on 32-bit Linux.
Include Python.h before system headers to make sure that
``_remote_debugging_module.c`` uses the same types (ABI) than Python.
Patch by Victor Stinner.
- gh-140768: Warn when the WASI SDK version doesn't match what's supported.
- gh-140513: Generate a clear compilation error when
``_Py_TAIL_CALL_INTERP`` is enabled but either ``preserve_none`` or
``musttail`` is not supported.
- gh-140189: iOS builds were added to CI.
- gh-138489: When cross-compiling for WASI by ``build_wasm`` or
``build_emscripten``, the ``build-details.json`` step is now included in
the build process, just like with native builds.
This fixes the ``libinstall`` task which requires the
``build-details.json`` file during the process.
- gh-137618: ``PYTHON_FOR_REGEN`` now requires Python 3.10 to Python 3.15.
Patch by Adam Turner.
- gh-123681: Check the ``strftime()`` behavior at runtime instead of at the
compile time to support cross-compiling. Remove the internal macro
``_Py_NORMALIZE_CENTURY``.
What's New in Python 3.14.0 final?
==================================
*Release date: 2025-10-07*
macOS
-----
- gh-124111: Update macOS installer to use Tcl/Tk 8.6.17.
- gh-139573: Updated bundled version of OpenSSL to 3.0.18.
Windows
-------
- gh-139573: Updated bundled version of OpenSSL to 3.0.18.
Tools/Demos
-----------
- gh-139330: SBOM generation tool didn't cross-check the version and
checksum values against the ``Modules/expat/refresh.sh`` script, leading
to the values becoming out-of-date during routine updates.
- gh-132006: XCframeworks now include privacy manifests to satisfy Apple App
Store submission requirements.
- gh-138171: A script for building an iOS XCframework was added. As part of
this change, the top level ``iOS`` folder has been moved to be a
subdirectory of the ``Apple`` folder.
Security
--------
- gh-139400: :mod:`xml.parsers.expat`: Make sure that parent Expat parsers
are only garbage-collected once they are no longer referenced by
subparsers created by
:meth:`~xml.parsers.expat.xmlparser.ExternalEntityParserCreate`. Patch by
Sebastian Pipping.
Library
-------
- gh-139312: Upgrade bundled libexpat to 2.7.3
What's New in Python 3.14.0 release candidate 3?
================================================
*Release date: 2025-09-18*
Windows
-------
- gh-138896: Fix error installing C runtime on non-updated Windows machines
Tools/Demos
-----------
- gh-137873: The iOS test runner has been simplified, resolving some issues
that have been observed using the runner in GitHub Actions and Azure
Pipelines test environments.
Security
--------
- gh-135661: Fix CDATA section parsing in :class:`html.parser.HTMLParser`
according to the HTML5 standard: ``] ]>`` and ``]] >`` no longer end the
CDATA section. Add private method ``_set_support_cdata()`` which can be
used to specify how to parse ``<[CDATA[`` --- as a CDATA section in
foreign content (SVG or MathML) or as a bogus comment in the HTML
namespace.
Library
-------
- gh-138998: Update bundled libexpat to 2.7.2
- gh-118803: Add back :class:`collections.abc.ByteString` and
:class:`typing.ByteString`. Both had been removed in prior alpha, beta and
release candidates for Python 3.14, but their removal has now been
postponed to Python 3.17.
- gh-137226: Fix :func:`typing.get_type_hints` calls on generic
:class:`typing.TypedDict` classes defined with string annotations.
- gh-138804: Raise :exc:`TypeError` instead of :exc:`AttributeError` when an
argument of incorrect type is passed to :func:`shlex.quote`. This restores
the behavior of the function prior to 3.14.
- gh-128636: Fix crash in PyREPL when os.environ is overwritten with an
invalid value for mac
- gh-138514: Raise :exc:`ValueError` when a multi-character string is passed
to the *echo_char* parameter of :func:`getpass.getpass`. Patch by Benjamin
Johnson.
- gh-138515: :mod:`email` is added to Emscripten build.
- gh-99948: :func:`ctypes.util.find_library` now works in Emscripten build.
- gh-138253: Add the *block* parameter in the :meth:`!put` and :meth:`!get`
methods of the :mod:`concurrent.interpreters` queues for compatibility
with the :class:`queue.Queue` interface.
- gh-138133: Prevent infinite traceback loop when sending CTRL^C to Python
through ``strace``.
- gh-134869: Fix an issue where pressing Ctrl+C during tab completion in the
REPL would leave the autocompletion menu in a corrupted state.
- gh-90548: Fix ``musl`` detection for :func:`platform.libc_ver` on Alpine
Linux if compiled with --strip-all.
- gh-136134: :meth:`!SMTP.auth_cram_md5` now raises an
:exc:`~smtplib.SMTPException` instead of a :exc:`ValueError` if Python has
been built without MD5 support. In particular, :class:`~smtplib.SMTP`
clients will not attempt to use this method even if the remote server is
assumed to support it. Patch by Bénédikt Tran.
- gh-136134: :meth:`IMAP4.login_cram_md5 ` now
raises an :exc:`IMAP4.error ` if CRAM-MD5
authentication is not supported. Patch by Bénédikt Tran.
- gh-134953: Expand ``_colorize`` theme with ``keyword_constant`` and
implement in :term:`repl`.
Core and Builtins
-----------------
- gh-71810: Raise :exc:`OverflowError` for ``(-1).to_bytes()`` for signed
conversions when bytes count is zero. Patch by Sergey B Kirpichev.
- gh-138192: Fix :mod:`contextvars` initialization so that all
subinterpreters are assigned the :attr:`~contextvars.Token.MISSING` value.
- gh-138479: Fix a crash when a generic object's ``__typing_subst__``
returns an object that isn't a :class:`tuple`.
- gh-138372: Fix :exc:`SyntaxWarning` emitted for erroneous subscript
expressions involving :ref:`template string literals `. Patch
by Brian Schubert.
- gh-138318: The default REPL now avoids highlighting built-in names (for
instance :class:`set` or :func:`format`) when they are used as attribute
names (for instance in ``value.set`` or ``text.format``).
- gh-138349: Fix crash in certain cases where a module contains both a
module-level annotation and a comprehension.
- gh-137384: Fix a crash when using the :mod:`warnings` module in a
finalizer at shutdown. Patch by Kumar Aditya.
- gh-137883: Fix runaway recursion when calling a function with keyword
arguments.
- gh-137079: Fix keyword typo recognition when parsing files. Patch by Pablo
Galindo.
- gh-137728: Fix the JIT's handling of many local variables. This previously
caused a segfault.
- gh-137576: Fix for incorrect source code being shown in tracebacks from
the Basic REPL when :envvar:`PYTHONSTARTUP` is given. Patch by Adam Hartz.
What's New in Python 3.14.0 release candidate 2?
================================================
*Release date: 2025-08-14*
macOS
-----
- gh-137450: macOS installer shell path management improvements: separate
the installer ``Shell profile updater`` postinstall script from the
``Update Shell Profile.command`` to enable more robust error handling.
- gh-137134: Update macOS installer to ship with SQLite version 3.50.4.
Windows
-------
- gh-137134: Update Windows installer to ship with SQLite 3.50.4.
Library
-------
- gh-137426: Remove the code deprecation of
``importlib.abc.ResourceLoader``. It is documented as deprecated, but left
for backwards compatibility with other classes in ``importlib.abc``.
- gh-137282: Fix tab completion and :func:`dir` on
:mod:`concurrent.futures`.
- gh-137257: Bump the version of pip bundled in ensurepip to version 25.2
- gh-137226: Fix behavior of :meth:`annotationlib.ForwardRef.evaluate` when
the *type_params* parameter is passed and the name of a type param is also
present in an enclosing scope.
- gh-130522: Fix unraisable :exc:`TypeError` raised during
:term:`interpreter shutdown` in the :mod:`threading` module.
- gh-137059: Fix handling of file URLs with a Windows drive letter in the
URL authority by :func:`urllib.request.url2pathname`. This fixes a
regression in earlier pre-releases of Python 3.14.
- gh-130577: :mod:`tarfile` now validates archives to ensure member offsets
are non-negative. (Contributed by Alexander Enrique Urieles Nieto in
:gh:`130577`.)
- gh-135228: When :mod:`dataclasses` replaces a class with a slotted
dataclass, the original class can now be garbage collected again. Earlier
changes in Python 3.14 caused this class to always remain in existence
together with the replacement class synthesized by :mod:`dataclasses`.
Documentation
-------------
- gh-136155: We are now checking for fatal errors in EPUB builds in CI.
Core and Builtins
-----------------
- gh-137400: Fix a crash in the :term:`free threading` build when disabling
profiling or tracing across all threads with
:c:func:`PyEval_SetProfileAllThreads` or
:c:func:`PyEval_SetTraceAllThreads` or their Python equivalents
:func:`threading.settrace_all_threads` and
:func:`threading.setprofile_all_threads`.
- gh-137314: Fixed a regression where raw f-strings incorrectly interpreted
escape sequences in format specifications. Raw f-strings now properly
preserve literal backslashes in format specs, matching the behavior from
Python 3.11. For example, ``rf"{obj:\xFF}"`` now correctly produces
``'\\xFF'`` instead of ``'ÿ'``. Patch by Pablo Galindo.
- gh-137308: A standalone docstring in a node body is optimized as a
:keyword:`pass` statement to ensure that the node's body is never empty.
There was a :exc:`ValueError` in :func:`compile` otherwise.
- gh-137288: Fix bug where some bytecode instructions of a boolean
expression are not associated with the correct exception handler.
- gh-134291: Remove some newer macOS API usage from the JIT compiler in
order to restore compatibility with older OSX 10.15 deployment targets.
- gh-131338: Disable computed stack limit checks on non-glibc linux
platforms to fix crashes on deep recursion.
- gh-136870: Fix data races while de-instrumenting bytecode of code objects
running concurrently in threads.
C API
-----
- gh-137573: Mark ``_PyOptimizer_Optimize`` as :c:macro:`Py_NO_INLINE` to
prevent stack overflow crashes on macOS.
Build
-----
- gh-132339: Add support for OpenSSL 3.5.
What's New in Python 3.14.0 release candidate 1?
================================================
*Release date: 2025-07-22*
Tools/Demos
-----------
- gh-136251: Fixes and usability improvements for
``Tools/wasm/emscripten/web_example``
Security
--------
- gh-135661: Fix parsing attributes with whitespaces around the ``=``
separator in :class:`html.parser.HTMLParser` according to the HTML5
standard.
- gh-118350: Fix support of escapable raw text mode (elements "textarea" and
"title") in :class:`html.parser.HTMLParser`.
Library
-------
- gh-136170: Removed the unreleased ``zipfile.ZipFile.data_offset`` property
added in 3.14.0a7 as it wasn't fully clear which behavior it should have
in some situations so the result was not always what a user might expect.
- gh-124621: pyrepl now works in Emscripten.
- gh-136874: Discard URL query and fragment in
:func:`urllib.request.url2pathname`.
- gh-130645: Enable color help by default in :mod:`argparse`.
- gh-136549: Fix signature of :func:`threading.excepthook`.
- gh-136523: Fix :class:`wave.Wave_write` emitting an unraisable when open
raises.
- gh-52876: Add missing ``keepends`` (default ``True``) parameter to
:meth:`!codecs.StreamReaderWriter.readline` and
:meth:`!codecs.StreamReaderWriter.readlines`.
- gh-136470: Correct :class:`concurrent.futures.InterpreterPoolExecutor`'s
default thread name.
- gh-136476: Fix a bug that was causing the ``get_async_stack_trace``
function to miss some frames in the stack trace.
- gh-136434: Fix docs generation of ``UnboundItem`` in
:mod:`concurrent.interpreters` when running with :option:`-OO`.
- gh-136380: Raises :exc:`AttributeError` when accessing
:class:`concurrent.futures.InterpreterPoolExecutor` and subinterpreters
are not available.
- gh-134759: Fix :exc:`UnboundLocalError` in
:func:`email.message.Message.get_payload` when the payload to decode is a
:class:`bytes` object. Patch by Kliment Lamonov.
- gh-134657: :mod:`asyncio`: Remove some private names from
``asyncio.__all__``.
Core and Builtins
-----------------
- gh-136801: Fix PyREPL syntax highlighting on match cases after multi-line
case. Contributed by Olga Matoula.
Library
-------
- gh-136421: Fix crash when initializing :mod:`datetime` concurrently.
Core and Builtins
-----------------
- gh-136541: Fix some issues with the perf trampolines on x86-64 and
aarch64. The trampolines were not being generated correctly for some
cases, which could lead to the perf integration not working correctly.
Patch by Pablo Galindo.
- gh-136517: Fixed a typo that prevented printing of uncollectable objects
when the :const:`gc.DEBUG_UNCOLLECTABLE` mode was set.
- gh-136525: Fix issue where per-thread bytecode was not instrumented for
newly created threads.
- gh-132661: ``Interpolation.expression`` now has a default, the empty
string.
- gh-132661: Reflect recent :pep:`750` change.
Disallow concatenation of ``string.templatelib.Template`` and
:class:`str`. Also, disallow implicit concatenation of t-string literals
with string or f-string literals.
Library
-------
- gh-116738: Make functions in :mod:`grp` thread-safe on the :term:`free
threaded ` build.
Core and Builtins
-----------------
- gh-135148: Fixed a bug where f-string debug expressions (using =) would
incorrectly strip out parts of strings containing escaped quotes and #
characters. Patch by Pablo Galindo.
- gh-133136: Limit excess memory usage in the :term:`free threading` build
when a large dictionary or list is resized and accessed by multiple
threads.
- gh-91153: Fix a crash when a :class:`bytearray` is concurrently mutated
during item assignment.
- gh-127971: Fix off-by-one read beyond the end of a string in string
search.
C API
-----
- gh-112068: Revert support of nullable arguments in :c:func:`PyArg_Parse`.
- gh-133296: New variants for the critical section API that accept one or
two :c:type:`PyMutex` pointers rather than :c:type:`PyObject` instances
are now public in the non-limited C API.
- gh-134009: Expose :c:func:`PyMutex_IsLocked` as part of the public C API.
Build
-----
- gh-135621: PyREPL no longer depends on the :mod:`curses` standard library.
Contributed by Łukasz Langa.
What's New in Python 3.14.0 beta 4?
===================================
*Release date: 2025-07-08*
Tools/Demos
-----------
- gh-135968: Stubs for ``strip`` are now provided as part of an iOS install.
- gh-133600: Backport file reorganization for Tools/wasm/wasi.
This should make backporting future code changes easier. It also
simplifies instructions around how to do WASI builds in the devguide.
Tests
-----
- gh-135966: The iOS testbed now handles the ``app_packages`` folder as a
site directory.
- gh-135494: Fix regrtest to support excluding tests from ``--pgo`` tests.
Patch by Victor Stinner.
Security
--------
- gh-136053: :mod:`marshal`: fix a possible crash when deserializing
:class:`slice` objects.
- gh-135661: Fix parsing start and end tags in
:class:`html.parser.HTMLParser` according to the HTML5 standard.
* Whitespaces no longer accepted between ```` and the tag name.
E.g. `` script>`` does not end the script section.
* Vertical tabulation (``\v``) and non-ASCII whitespaces no longer recognized
as whitespaces. The only whitespaces are ``\t\n\r\f`` and space.
* Null character (U+0000) no longer ends the tag name.
* Attributes and slashes after the tag name in end tags are now ignored,
instead of terminating after the first ``>`` in quoted attribute value.
E.g. ``"/>``.
* Multiple slashes and whitespaces between the last attribute and closing ``>``
are now ignored in both start and end tags. E.g. ````.
* Multiple ``=`` between attribute name and value are no longer collapsed.
E.g. ```` produces attribute "foo" with value "=bar".
* [Reverted in :gh:`136927`] Whitespaces between the ``=`` separator and attribute name or value are no
longer ignored. E.g. ```` produces two attributes "foo" and
"=bar", both with value None; ```` produces two attributes:
"foo" with value "" and "bar" with value None.
- gh-102555: Fix comment parsing in :class:`html.parser.HTMLParser`
according to the HTML5 standard. ``--!>`` now ends the comment. ``-- >``
no longer ends the comment. Support abnormally ended empty comments
``<-->`` and ``<--->``.
Library
-------
- gh-136286: Fix pickling failures for protocols 0 and 1 for many objects
realted to subinterpreters.
- gh-136316: Improve support for evaluating nested forward references in
:func:`typing.evaluate_forward_ref`.
- gh-85702: If ``zoneinfo._common.load_tzdata`` is given a package without a
resource a :exc:`zoneinfo.ZoneInfoNotFoundError` is raised rather than a
:exc:`PermissionError`. Patch by Victor Stinner.
- gh-136028: Fix parsing month names containing "İ" (U+0130, LATIN CAPITAL
LETTER I WITH DOT ABOVE) in :func:`time.strptime`. This affects locales
az_AZ, ber_DZ, ber_MA and crh_UA.
- gh-135995: In the palmos encoding, make byte ``0x9b`` decode to ``›``
(U+203A - SINGLE RIGHT-POINTING ANGLE QUOTATION MARK).
- gh-53203: Fix :func:`time.strptime` for ``%c`` and ``%x`` formats on
locales byn_ER, wal_ET and lzh_TW, and for ``%X`` format on locales ar_SA,
bg_BG and lzh_TW.
- gh-91555: An earlier change, which was introduced in 3.14.0b2, has been
reverted. It disabled logging for a logger during handling of log messages
for that logger. Since the reversion, the behaviour should be as it was
before 3.14.0b2.
- gh-135878: Fixes a crash of :class:`types.SimpleNamespace` on :term:`free
threading` builds, when several threads were calling its
:meth:`~object.__repr__` method at the same time.
- gh-135836: Fix :exc:`IndexError` in :meth:`asyncio.loop.create_connection`
that could occur when non-\ :exc:`OSError` exception is raised during
connection and socket's ``close()`` raises :exc:`!OSError`.
- gh-135836: Fix :exc:`IndexError` in :meth:`asyncio.loop.create_connection`
that could occur when the Happy Eyeballs algorithm resulted in an empty
exceptions list during connection attempts.
- gh-135855: Raise :exc:`TypeError` instead of :exc:`SystemError` when
:func:`!_interpreters.set___main___attrs` is passed a non-dict object.
Patch by Brian Schubert.
- gh-135815: :mod:`netrc`: skip security checks if :func:`os.getuid` is
missing. Patch by Bénédikt Tran.
- gh-135640: Address bug where it was possible to call
:func:`xml.etree.ElementTree.ElementTree.write` on an ElementTree object
with an invalid root element. This behavior blanked the file passed to
``write`` if it already existed.
- gh-135645: Added ``supports_isolated_interpreters`` field to
:data:`sys.implementation`.
- gh-135646: Raise consistent :exc:`NameError` exceptions in
:func:`annotationlib.ForwardRef.evaluate`
- gh-135557: Fix races on :mod:`heapq` updates and :class:`list` reads on
the :term:`free threaded ` build.
- gh-119180: Only fetch globals and locals if necessary in
:func:`annotationlib.get_annotations`
- gh-135561: Fix a crash on DEBUG builds when an HACL* HMAC routine fails.
Patch by Bénédikt Tran.
- gh-135487: Fix :meth:`!reprlib.Repr.repr_int` when given integers with
more than :func:`sys.get_int_max_str_digits` digits. Patch by Bénédikt
Tran.
- gh-135335: :mod:`multiprocessing`: Flush ``stdout`` and ``stderr`` after
preloading modules in the ``forkserver``.
- gh-135069: Fix the "Invalid error handling" exception in
:class:`!encodings.idna.IncrementalDecoder` to correctly replace the
'errors' parameter.
- gh-130662: +Accept leading zeros in precision and width fields for
+:class:`~decimal.Decimal` formatting, for example ``format(Decimal(1.25),
'.016f')``.
- gh-130662: Accept leading zeros in precision and width fields for
:class:`~fractions.Fraction` formatting, for example ``format(Fraction(1,
3), '.016f')``.
- gh-87790: Support underscore and comma as thousands separators in the
fractional part for :class:`~fractions.Fraction`'s formatting. Patch by
Sergey B Kirpichev.
- gh-87790: Support underscore and comma as thousands separators in the
fractional part for :class:`~decimal.Decimal`'s formatting. Patch by
Sergey B Kirpichev.
- gh-130664: Handle corner-case for :class:`~fractions.Fraction`'s
formatting: treat zero-padding (preceding the width field by a zero
(``'0'``) character) as an equivalent to a fill character of ``'0'`` with
an alignment type of ``'='``, just as in case of :class:`float`'s.
Documentation
-------------
- gh-136155: EPUB builds are fixed by excluding non-XHTML-compatible tags.
Core and Builtins
-----------------
- gh-109700: Fix memory error handling in :c:func:`PyDict_SetDefault`.
- gh-78465: Fix error message for ``cls.__new__(cls, ...)`` where ``cls`` is
not instantiable builtin or extension type (with ``tp_new`` set to
``NULL``).
- gh-129958: Differentiate between t-strings and f-strings in syntax error
for newlines in format specifiers of single-quoted interpolated strings.
- gh-135871: Non-blocking mutex lock attempts now return immediately when
the lock is busy instead of briefly spinning in the :term:`free threading`
build.
- gh-135106: Restrict the trashcan mechanism to GC'ed objects and untrack
them while in the trashcan to prevent the GC and trashcan mechanisms
conflicting.
- gh-135607: Fix potential :mod:`weakref` races in an object's destructor on
the :term:`free threaded ` build.
- gh-135608: Fix a crash in the JIT involving attributes of modules.
- gh-135543: Emit ``sys.remote_exec`` audit event when
:func:`sys.remote_exec` is called and migrate ``remote_debugger_script``
to ``cpython.remote_debugger_script``.
- gh-134280: Disable constant folding for ``~`` with a boolean argument.
This moves the deprecation warning from compile time to runtime.
C API
-----
- gh-135906: Fix compilation errors when compiling the internal headers with
a C++ compiler.
Build
-----
- gh-134273: Add support for configuring compiler flags for the JIT with
``CFLAGS_JIT``
What's New in Python 3.14.0 beta 3?
===================================
*Release date: 2025-06-17*
Windows
-------
- gh-135099: Fix a crash that could occur on Windows when a background
thread waits on a :c:type:`PyMutex` while the main thread is shutting down
the interpreter.
Tests
-----
- gh-132815: Fix test__opcode: add ``JUMP_BACKWARD`` to specialization
stats.
- gh-135489: Show verbose output for failing tests during PGO profiling step
with --enable-optimizations.
- gh-135120: Add :func:`!test.support.subTests`.
Security
--------
- gh-135462: Fix quadratic complexity in processing specially crafted input
in :class:`html.parser.HTMLParser`. End-of-file errors are now handled
according to the HTML5 specs -- comments and declarations are
automatically closed, tags are ignored.
- gh-135034: Fixes multiple issues that allowed ``tarfile`` extraction
filters (``filter="data"`` and ``filter="tar"``) to be bypassed using
crafted symlinks and hard links.
Addresses :cve:`2024-12718`, :cve:`2025-4138`, :cve:`2025-4330`, and
:cve:`2025-4517`.
Library
-------
- gh-65697: :class:`configparser`'s error message when attempting to write
an invalid key is now more helpful.
- gh-135497: Fix :func:`os.getlogin` failing for longer usernames on
BSD-based platforms.
- gh-135429: Fix the argument mismatch in ``_lsprof`` for ``PY_THROW``
event.
- gh-135368: Fix :class:`unittest.mock.Mock` generation on
:func:`dataclasses.dataclass` objects. Now all special attributes are set
as it was before :gh:`124429`.
- gh-133967: Do not normalize :mod:`locale` name 'C.UTF-8' to 'en_US.UTF-8'.
- gh-135321: Raise a correct exception for values greater than 0x7fffffff
for the ``BINSTRING`` opcode in the C implementation of :mod:`pickle`.
- gh-135276: Backported bugfixes in zipfile.Path from zipp 3.23. Fixed
``.name``, ``.stem`` and other basename-based properties on Windows when
working with a zipfile on disk.
- gh-135244: :mod:`uuid`: when the MAC address cannot be determined, the
48-bit node ID is now generated with a cryptographically-secure
pseudo-random number generator (CSPRNG) as per :rfc:`RFC 9562, §6.10.3
<9562#section-6.10-3>`. This affects :func:`~uuid.uuid1` and
:func:`~uuid.uuid6`.
- gh-134970: Fix the "unknown action" exception in
:meth:`argparse.ArgumentParser.add_argument_group` to correctly replace
the action class.
- gh-134718: :func:`ast.dump` now only omits ``None`` and ``[]`` values if
they are default values.
- gh-134939: Add the :mod:`concurrent.interpreters` module. See :pep:`734`.
- gh-134885: Fix possible crash in the :mod:`compression.zstd` module
related to setting parameter types. Patch by Jelle Zijlstra.
- gh-134857: Improve error report for :mod:`doctest`\ s run with
:mod:`unittest`. Remove :mod:`!doctest` module frames from tracebacks and
redundant newline character from a failure message.
- gh-128840: Fix parsing long IPv6 addresses with embedded IPv4 address.
- gh-134637: Fix performance regression in calling a :mod:`ctypes` function
pointer in :term:`free threading`.
- gh-134696: Built-in HACL* and OpenSSL implementations of hash function
constructors now correctly accept the same *documented* named arguments.
For instance, :func:`~hashlib.md5` could be previously invoked as
``md5(data=data)`` or ``md5(string=string)`` depending on the underlying
implementation but these calls were not compatible. Patch by Bénédikt
Tran.
- gh-134151: :mod:`email`: Fix :exc:`TypeError` in
:func:`email.utils.decode_params` when sorting :rfc:`2231` continuations
that contain an unnumbered section.
- gh-134210: :func:`curses.window.getch` now correctly handles signals.
Patch by Bénédikt Tran.
- gh-134152: :mod:`email`: Fix parsing of email message ID with invalid
domain.
- gh-133489: :func:`random.getrandbits` can now generate more that 2\
:sup:`31` bits. :func:`random.randbytes` can now generate more that 256
MiB.
- gh-132813: Improve error messages for incorrect types and values of
:class:`csv.Dialect` attributes.
- gh-132969: Prevent the :class:`~concurrent.futures.ProcessPoolExecutor`
executor thread, which remains running when :meth:`shutdown(wait=False)
`, from attempting to adjust the
pool's worker processes after the object state has already been reset
during shutdown. A combination of conditions, including a worker process
having terminated abormally, resulted in an exception and a potential hang
when the still-running executor thread attempted to replace dead workers
within the pool.
- gh-127081: Fix libc thread safety issues with :mod:`os` by replacing
``getlogin`` with ``getlogin_r`` re-entrant version.
- gh-131884: Fix formatting issues in :func:`json.dump` when both *indent*
and *skipkeys* are used.
- gh-130999: Avoid exiting the new REPL and offer suggestions even if there
are non-string candidates when errors occur.
Documentation
-------------
- gh-135171: Document that the :term:`iterator` for the leftmost
:keyword:`!for` clause in the generator expression is created immediately.
- bpo-45210: Document that error indicator may be set in tp_dealloc, and how
to avoid clobbering it.
Core and Builtins
-----------------
- gh-135496: Fix typo in the f-string conversion type error ("exclamanation"
-> "exclamation").
- gh-135371: Fixed :mod:`asyncio` debugging tools to properly display
internal coroutine call stacks alongside external task dependencies. The
``python -m asyncio ps`` and ``python -m asyncio pstree`` commands now
show complete execution context. Patch by Pablo Galindo.
Library
-------
- gh-127319: Set the ``allow_reuse_port`` class variable to ``False`` on the
XMLRPC, logging, and HTTP servers. This matches the behavior in prior
Python releases, which is to not allow port reuse.
Core and Builtins
-----------------
- gh-135171: Reverts the behavior of async generator expressions when
created with object w/o __aiter__ method to the pre-3.13 behavior of
raising a TypeError.
- gh-130077: Properly raise custom syntax errors when incorrect syntax
containing names that are prefixes of soft keywords is encountered. Patch
by Pablo Galindo.
- gh-135171: Reverts the behavior of generator expressions when created with
a non-iterable to the pre-3.13 behavior of raising a TypeError. It is no
longer possible to cause a crash in the debugger by altering the generator
expression's local variables. This is achieved by moving the ``GET_ITER``
instruction back to the creation of the generator expression and adding an
additional check to ``FOR_ITER``.
Library
-------
- gh-116738: Make methods in :mod:`heapq` thread-safe on the :term:`free
threaded ` build.
Core and Builtins
-----------------
- gh-134876: Add support to :pep:`768` remote debugging for Linux kernels
which don't have CONFIG_CROSS_MEMORY_ATTACH configured.
- gh-134889: Fix handling of a few opcodes that leave operands on the stack
when optimizing ``LOAD_FAST``.
Library
-------
- gh-134908: Fix crash when iterating over lines in a text file on the
:term:`free threaded ` build.
Core and Builtins
-----------------
- gh-132617: Fix :meth:`dict.update` modification check that could
incorrectly raise a "dict mutated during update" error when a different
dictionary was modified that happens to share the same underlying keys
object.
- gh-134679: Fix crash in the :term:`free threading` build's QSBR code that
could occur when changing an object's ``__dict__`` attribute.
- gh-127682: No longer call ``__iter__`` twice in list comprehensions. This
brings the behavior of list comprehensions in line with other forms of
iteration
- gh-133912: Fix the C API function ``PyObject_GenericSetDict`` to handle
extension classes with inline values.
C API
-----
- gh-134989: Fix ``Py_RETURN_NONE``, ``Py_RETURN_TRUE`` and
``Py_RETURN_FALSE`` macros in the limited C API 3.11 and older: don't
treat ``Py_None``, ``Py_True`` and ``Py_False`` as immortal. Patch by
Victor Stinner.
- gh-134989: Implement :c:func:`PyObject_DelAttr` and
:c:func:`PyObject_DelAttrString` as macros in the limited C API 3.12 and
older. Patch by Victor Stinner.
- gh-133968: Add :c:func:`PyUnicodeWriter_WriteASCII` function to write an
ASCII string into a :c:type:`PyUnicodeWriter`. The function is faster than
:c:func:`PyUnicodeWriter_WriteUTF8`, but has an undefined behavior if the
input string contains non-ASCII characters. Patch by Victor Stinner.
Build
-----
- gh-119132: Remove "experimental" tag from the CPython free-threading
build.
- gh-135497: Fix the detection of ``MAXLOGNAME`` in the ``configure.ac``
script.
- gh-134923: Windows builds with profile-guided optimization enabled now use
``/GENPROFILE`` and ``/USEPROFILE`` instead of deprecated ``/LTCG:``
options.
- gh-134774: Fix :c:macro:`Py_DEBUG` macro redefinition warnings on Windows
debug builds. Patch by Chris Eibl.
- gh-134632: Fixed ``build-details.json`` generation to use ``INCLUDEPY``,
in order to reference the ``pythonX.Y`` subdirectory of the include
directory, as required in :pep:`739`, instead of the top-level include
directory.
What's New in Python 3.14.0 beta 2?
===================================
*Release date: 2025-05-26*
Windows
-------
- gh-130727: Fix a race in internal calls into WMI that can result in an
"invalid handle" exception under high load. Patch by Chris Eibl.
- gh-76023: Make :func:`os.path.realpath` ignore Windows error 1005 when in
non-strict mode.
- gh-133779: Reverts the change to generate different :file:`pyconfig.h`
files based on compiler settings, as it was frequently causing extension
builds to break. In particular, the ``Py_GIL_DISABLED`` preprocessor
variable must now always be defined explicitly when compiling for the
experimental free-threaded runtime. The :func:`sysconfig.get_config_var`
function can be used to determine whether the current runtime was compiled
with that flag or not.
- gh-133626: Ensures packages are not accidentally bundled into the
traditional installer.
Tools/Demos
-----------
- gh-134215: :term:`REPL` import autocomplete only suggests private modules
when explicitly specified.
Tests
-----
- gh-133744: Fix multiprocessing interrupt test. Add an event to synchronize
the parent process with the child process: wait until the child process
starts sleeping. Patch by Victor Stinner.
- gh-133682: Fixed test case
``test.test_annotationlib.TestStringFormat.test_displays`` which ensures
proper handling of complex data structures (lists, sets, dictionaries, and
tuples) in string annotations.
- gh-133639: Fix ``TestPyReplAutoindent.test_auto_indent_default()`` doesn't
run ``input_code``.
Security
--------
- gh-133767: Fix use-after-free in the "unicode-escape" decoder with a
non-"strict" error handler.
- gh-128840: Short-circuit the processing of long IPv6 addresses early in
:mod:`ipaddress` to prevent excessive memory consumption and a minor
denial-of-service.
Library
-------
- gh-132710: If possible, ensure that :func:`uuid.getnode` returns the same
result even across different processes. Previously, the result was
constant only within the same process. Patch by Bénédikt Tran.
- gh-80334: :func:`multiprocessing.freeze_support` now checks for work on
any "spawn" start method platform rather than only on Windows.
- gh-134582: Fix tokenize.untokenize() round-trip errors related to
t-strings braces escaping
- gh-134546: Ensure :mod:`pdb` remote debugging script is readable by remote
Python process.
- gh-134451: Converted ``asyncio.tools.CycleFoundException`` from dataclass
to a regular exception type.
- gh-114177: Fix :mod:`asyncio` to not close subprocess pipes which would
otherwise error out when the event loop is already closed.
- gh-90871: Fixed an off by one error concerning the backlog parameter in
:meth:`~asyncio.loop.create_unix_server`. Contributed by Christian
Harries.
- gh-134323: Fix the :meth:`threading.RLock.locked` method.
- gh-86802: Fixed asyncio memory leak in cancelled shield tasks. For
shielded tasks where the shield was cancelled, log potential exceptions
through the exception handler. Contributed by Christian Harries.
- gh-134209: :mod:`curses`: The :meth:`curses.window.instr` and
:meth:`curses.window.getstr` methods now allocate their internal buffer on
the heap instead of the stack; in addition, the max buffer size is
increased from 1023 to 2047.
- gh-134235: Updated tab completion on REPL to include builtin modules.
Contributed by Tom Wang, Hunter Young
- gh-134152: Fixed :exc:`UnboundLocalError` that could occur during
:mod:`email` header parsing if an expected trailing delimiter is missing
in some contexts.
- gh-134168: :mod:`http.server`: Fix IPv6 address binding and
:option:`--directory ` handling when using HTTPS.
- gh-62184: Remove import of C implementation of :class:`io.FileIO` from
Python implementation which has its own implementation
- gh-133982: Emit :exc:`RuntimeWarning` in the Python implementation of
:mod:`io` when the :term:`file-like object ` is not closed
explicitly in the presence of multiple I/O layers.
- gh-133890: The :mod:`tarfile` module now handles :exc:`UnicodeEncodeError`
in the same way as :exc:`OSError` when cannot extract a member.
- gh-134097: Fix interaction of the new :term:`REPL` and :option:`-X
showrefcount <-X>` command line option.
- gh-133889: The generated directory listing page in
:class:`http.server.SimpleHTTPRequestHandler` now only shows the decoded
path component of the requested URL, and not the query and fragment.
- gh-134098: Fix handling paths that end with a percent-encoded slash
(``%2f`` or ``%2F``) in :class:`http.server.SimpleHTTPRequestHandler`.
- gh-132124: On POSIX-compliant systems,
:func:`!multiprocessing.util.get_temp_dir` now ignores :envvar:`TMPDIR`
(and similar environment variables) if the path length of ``AF_UNIX``
socket files exceeds the platform-specific maximum length when using the
:ref:`forkserver ` start method.
Patch by Bénédikt Tran.
- gh-134062: :mod:`ipaddress`: fix collisions in :meth:`~object.__hash__`
for :class:`~ipaddress.IPv4Network` and :class:`~ipaddress.IPv6Network`
objects.
- gh-133970: Make :class:`!string.templatelib.Template` and
:class:`!string.templatelib.Interpolation` generic.
- gh-71253: Raise :exc:`ValueError` in :func:`open` if *opener* returns a
negative file-descriptor in the Python implementation of :mod:`io` to
match the C implementation.
- gh-133960: Simplify and improve :func:`typing.evaluate_forward_ref`. It
now no longer raises errors on certain invalid types. In several
situations, it is now able to evaluate forward references that were
previously unsupported.
- gh-133925: Make the private class ``typing._UnionGenericAlias`` hashable.
- gh-133653: Fix :class:`argparse.ArgumentParser` with the *formatter_class*
argument. Fix TypeError when *formatter_class* is a custom subclass of
:class:`!HelpFormatter`. Fix TypeError when *formatter_class* is not a
subclass of :class:`!HelpFormatter` and non-standard *prefix_char* is
used. Fix support of colorizing when *formatter_class* is not a subclass
of :class:`!HelpFormatter`.
- gh-132641: Fixed a race in :func:`functools.lru_cache` under
free-threading.
- gh-133783: Fix bug with applying :func:`copy.replace` to :mod:`ast`
objects. Attributes that default to ``None`` were incorrectly treated as
required for manually created AST nodes.
- gh-133684: Fix bug where :func:`annotationlib.get_annotations` would
return the wrong result for certain classes that are part of a class
hierarchy where ``from __future__ import annotations`` is used.
- gh-77057: Fix handling of invalid markup declarations in
:class:`html.parser.HTMLParser`.
- gh-130328: Speedup pasting in ``PyREPL`` on Windows in a legacy console.
Patch by Chris Eibl.
- gh-133701: Fix bug where :class:`typing.TypedDict` classes defined under
``from __future__ import annotations`` and inheriting from another
``TypedDict`` had an incorrect ``__annotations__`` attribute.
- gh-133581: Improve unparsing of t-strings in :func:`ast.unparse` and
``from __future__ import annotations``. Empty t-strings now round-trip
correctly and formatting in interpolations is preserved. Patch by Jelle
Zijlstra.
- gh-133551: Support t-strings (:pep:`750`) in :mod:`annotationlib`. Patch
by Jelle Zijlstra.
- gh-133439: Fix dot commands with trailing spaces are mistaken for
multi-line SQL statements in the sqlite3 command-line interface.
- gh-132493: Avoid accessing ``__annotations__`` unnecessarily in
:func:`inspect.signature`.
- gh-132876: ``ldexp()`` on Windows doesn't round subnormal results before
Windows 11, but should. Python's :func:`math.ldexp` wrapper now does
round them, so results may change slightly, in rare cases of very small
results, on Windows versions before 11.
- gh-133009: :mod:`xml.etree.ElementTree`: Fix a crash in
:meth:`Element.__deepcopy__ ` when the element is
concurrently mutated. Patch by Bénédikt Tran.
- gh-91555: Ignore log messages generated during handling of log messages,
to avoid deadlock or infinite recursion. [NOTE: This change has since been
reverted.]
- gh-125028: :data:`functools.Placeholder` cannot be passed to
:func:`functools.partial` as a keyword argument.
- gh-62824: Fix aliases for ``iso8859_8`` encoding. Patch by Dave Goncalves.
- gh-86155: :meth:`html.parser.HTMLParser.close` no longer loses data when
the ``