Registro de cambios

Python next

Release date: XXXX-XX-XX

Windows

  • gh-133626: Ensures packages are not accidentally bundled into the traditional installer.

  • gh-133537: Avoid using console I/O in WinAPI partitions that don’t support it

  • gh-131942: Use the Python-specific Py_DEBUG macro rather than _DEBUG in Windows-related C code. Patch by Xuehai Pan.

Tests

  • 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-133623: Indicate through ssl.HAS_PSK_TLS13 whether the ssl module supports «External PSKs» in TLSv1.3, as described in RFC 9258. Patch by Will Childs-Klein.

Library

Core and Builtins

  • gh-133703: Fix hashtable in dict can be bigger than intended in some situations.

  • gh-132762: fromkeys() no longer loops forever when adding a small set of keys to a large base dict. Patch by Angela Liss.

  • gh-133541: Inconsistent indentation in user input crashed the new REPL when syntax highlighting was active. This is now fixed.

  • gh-133516: Raise ValueError when constants True, False or None are used as an identifier after NFKC normalization.

  • gh-131798: Split CALL_ISINSTANCE into several uops, allowing the JIT to remove some of them.

  • gh-133379: Correct usage of arguments in error messages.

C API

  • gh-133644: Remove deprecated Python initialization getter functions Py_Get*. Patch by Bénédikt Tran.

  • gh-133644: Remove deprecated alias PyImport_ImportModuleNoBlock() of PyImport_ImportModule(). Patch by Bénédikt Tran.

  • gh-133610: Remove deprecated functions PyUnicode_AsDecodedObject(), PyUnicode_AsDecodedUnicode(), PyUnicode_AsEncodedObject(), and PyUnicode_AsEncodedUnicode().

Build

  • gh-117088: AIX linker don’t support -h option, so avoid it through platform check

Python 3.14.0 beta 1

Release date: 2025-05-06

Windows

Tools/Demos

  • gh-130453: Allow passing multiple keyword arguments with the same function name in pygettext.

  • gh-130195: Add warning messages when pygettext unimplemented -a/--extract-all option is called.

Tests

  • gh-133131: The iOS testbed will now select the most recently released «SE-class» device for testing if a device isn’t explicitly specified.

  • gh-91048: Add ability to externally inspect all pending asyncio tasks, even if no task is currently entered on the event loop.

  • gh-109981: The test helper that counts the list of open file descriptors now uses the optimised /dev/fd approach on all Apple platforms, not just macOS. This avoids crashes caused by guarded file descriptors.

  • gh-132678: Add --prioritize to -m test. This option allows the user to specify which selected tests should execute first, even if the order is otherwise randomized. This is particularly useful for tests that run the longest.

  • gh-131290: Tests in Lib/test can now be correctly executed as standalone scripts.

Security

  • gh-115322: The underlying extension modules behind readline:, subprocess, and ctypes now raise audit events on previously uncovered code paths that could lead to file system access related to C function calling and external binary execution. The ctypes.call_function audit hook has also been fixed to use an unsigned value for its function pointer.

Library

IDLE

  • gh-112936: fix IDLE: no Shell menu item in single-process mode.

Documentation

  • gh-107006: Move documentation and example code for threading.local from its docstring to the official docs.

  • gh-125142: As part of the builtin help intro text, show the keyboard shortcuts for the new, non-basic REPL (F1, F2, and F3).

Core and Builtins

  • gh-133336: -J is no longer reserved for use by Jython. Patch by Adam Turner.

  • gh-133261: Fix bug where the cycle GC could untrack objects in the trashcan because they looked like they were immortal. When objects are added to the trashcan, we take care to ensure they keep a mortal reference count.

  • gh-133346: Added experimental color theming support to the _colorize module.

  • gh-132917: For the free-threaded build, check the process memory usage increase before triggering a full automatic garbage collection. If the memory used has not increased 10% since the last collection then defer it.

  • gh-91048: Add a new python -m asyncio ps PID command-line interface to inspect asyncio tasks in a running Python process. Displays a flat table of await relationships. A variant showing a tree view is also available as python -m asyncio pstree PID. Both are useful for debugging async code. Patch by Pablo Galindo, Łukasz Langa, Yury Selivanov, and Marta Gomez Macias.

  • gh-133304: Workaround NaN’s «canonicalization» in PyFloat_Pack4() and PyFloat_Unpack4() on RISC-V.

  • gh-133197: Improve SyntaxError error messages for incompatible string / bytes prefixes.

  • gh-133231: Add new utilities of observing JIT compilation: sys._jit.is_available(), sys._jit.is_enabled(), and sys._jit.is_active().

  • gh-133194: ast.parse() will no longer parse new PEP 758 syntax with older feature_version passed.

  • gh-131798: Split CALL_LEN into several uops allowing the JIT to remove them when optimizing. Patch by Diego Russo.

  • gh-131798: Use sym_new_type instead of sym_new_not_null for _BUILD_STRING, _BUILD_SET

  • gh-132942: Fix two races in the type lookup cache. This affected the free-threaded build and could cause crashes (apparently quite difficult to trigger).

  • gh-131798: Propagate the return type of _BINARY_OP_SUBSCR_TUPLE_INT in JIT. Patch by Tomas Roun

  • gh-132952: Speed up startup with the -S argument by importing the private _io module instead of io. This fixes a performance regression introduced earlier in Python 3.14 development and restores performance to the level of Python 3.13.

  • gh-131798: Allow the JIT to remove int guards after _CALL_LEN by setting the return type to int. Patch by Diego Russo

  • gh-131798: Split CALL_TUPLE_1 into several uops allowing the JIT to remove some of them. Patch by Tomas Roun

  • gh-131798: Split CALL_STR_1 into several uops allowing the JIT to remove some of them. Patch by Tomas Roun

  • gh-132825: Enhance unhashable key/element error messages for dict and set. Patch by Victor Stinner.

  • gh-131591: Reset any PEP 768 remote debugging pending call in children after os.fork() calls.

  • gh-132713: Fix repr(list) race condition: hold a strong reference to the item while calling repr(item). Patch by Victor Stinner.

  • gh-132661: Implement PEP 750 (Template Strings). Add new syntax for t-strings and implement new internal string.templatelib.Template and string.templatelib.Interpolation types.

  • gh-132479: Fix compiler crash in certain circumstances where multiple module-level annotations include comprehensions and other nested scopes.

  • gh-132747: Fix a crash when calling __get__() of a method with a None second argument.

  • gh-132744: Certain calls now check for runaway recursion and respect the system recursion limit.

  • gh-132449: Syntax errors that look like misspellings of Python keywords now provide a helpful fix suggestion for the typo. Contributed by Pablo Galindo Salgado.

  • gh-132737: Support profiling code that requires __main__, such as pickle.

  • gh-132639: Added PyLong_AsNativeBytes(), PyLong_FromNativeBytes() and PyLong_FromUnsignedNativeBytes() to the limited C API.

  • gh-100239: Add specialisation for BINARY_OP/SUBSCR on list and slice.

  • gh-132508: Uses tagged integers on the evaluation stack to represent the instruction offsets when reraising an exception. This avoids the need to box the integer which could fail in low memory conditions.

  • gh-124476: Fix decoding from the locale encoding in the C.UTF-8 locale.

  • gh-131927: Compiler warnings originating from the same module and line number are now only emitted once, matching the behaviour of warnings emitted from user code. This can also be configured with warnings filters.

  • gh-132457: Make staticmethod() and classmethod() generic.

  • gh-131798: Use sym_new_type instead of sym_new_not_null for _BUILD_LIST, _BUILD_SET, _BUILD_MAP

  • gh-131798: Split CALL_TYPE_1 into several uops allowing the JIT to remove some of them.

  • gh-132386: Fix crash when passing a dict subclass as the globals parameter to exec().

  • gh-127682: No longer call __iter__ twice when creating and executing a generator expression. Creating a generator expression from a non-interable will raise only when the generator expression is executed. This brings the behavior of generator expressions in line with other generators.

  • gh-132261: The internal storage for annotations and annotate functions on classes now uses different keys in the class dictionary. This eliminates various edge cases where access to the __annotate__ and __annotations__ attributes would behave unpredictably.

  • gh-132284: Don’t wrap base PyCFunction slots on class creation if not overridden.

  • gh-130415: Improve the JIT’s ability to remove unused constant and local variable loads, and fix an issue where deallocating unused values could cause JIT code to crash or behave incorrectly.

  • gh-126703: Fix possible use after free in cases where a method’s definition has the same lifetime as its self.

  • gh-132286: Fix that type.__annotate__ was not deleted, when type.__annotations__ was deleted.

  • gh-131798: Allow the JIT to remove an extra _TO_BOOL_BOOL instruction after _CONTAINS_OP_DICT by setting the return type to bool.

  • gh-124715: Prevents against stack overflows when calling Py_DECREF(). Third-party extension objects no longer need to use the «trashcan» mechanism, as protection is now built into the Py_DECREF() macro.

  • gh-131798: Allow the JIT compiler to remove some type checks for operations on lists, tuples, dictionaries, and sets.

  • gh-128398: Improve error message when an object supporting the synchronous (resp. asynchronous) context manager protocol is entered using async with (resp. with) instead of with (resp. async with). Patch by Bénédikt Tran.

  • gh-131798: Allow the JIT to remove unicode guards after _BINARY_OP_SUBSCR_STR_INT by setting the return type to string.

  • gh-131878: Handle uncaught exceptions in the main input loop for the new REPL.

  • gh-131878: Fix support of unicode characters with two or more codepoints on Windows in the new REPL.

  • gh-126835: Move constant folding to the peephole optimizer. Rename AST optimization related files (Python/ast_opt.c -> Python/ast_preprocess.c), structs (_PyASTOptimizeState -> _PyASTPreprocessState) and functions (_PyAST_Optimize -> _PyAST_Preprocess, _PyCompile_AstOptimize -> _PyCompile_AstPreprocess).

  • gh-114809: Add support for macOS multi-arch builds with the JIT enabled

  • gh-131507: PyREPL now supports syntax highlighing. Contributed by Łukasz Langa.

  • gh-130907: If the __annotations__ of a module object are accessed while the module is executing, return the annotations that have been defined so far, without caching them.

  • gh-130104: Three-argument pow() now try calling __rpow__() if necessary. Previously it was only called in two-argument pow() and the binary power operator.

  • gh-130070: Fixed an assertion error for exec() passed a string source and a non-None closure. Patch by Bartosz Sławecki.

  • gh-129958: Fix a bug that was allowing newlines inconsitently in format specifiers for single-quoted f-strings. Patch by Pablo Galindo.

  • gh-129858: elif statements that follow an else block now have a specific error message.

  • gh-69605: Add module autocomplete to PyREPL.

  • gh-128555: Add the sys.flags.thread_inherit_context flag.

  • gh-123539: Improve SyntaxError message for using import ... as and from ... import ... as with not a name.

  • gh-102567: -X importtime now accepts value 2, which indicates that an importtime entry should also be printed if an imported module has already been loaded. Patch by Noah Kim and Adam Turner.

  • gh-116436: Improve error message when TypeError occurs during dict.update()

  • gh-103997: String arguments passed to «-c» are now automatically dedented as if by textwrap.dedent(). This allows «python -c» invocations to be indented in shell scripts without causing indentation errors. (Patch by Jon Crall and Steven Sun)

  • gh-89562: Remove hostflags member from PySSLContext struct.

C API

Build

  • gh-113464: Use the cpython-bin-deps «externals» repository for Windows LLVM dependency management. Installing LLVM manually is no longer necessary for Windows JIT builds.

  • gh-133183: iOS compiler shims now include IPHONEOS_DEPLOYMENT_TARGET in target triples, ensuring that SDK version minimums are honored.

  • gh-133167: Fix compilation process with --enable-optimizations and --without-docstrings.

  • gh-133171: Since free-threaded builds do not support the experimental JIT compiler, prevent these configurations from being combined.

  • gh-132758: Fix building with tail call interpreter and pystats.

  • gh-132649: The PClayout script now allows passing --include-tcltk on Windows ARM64.

  • gh-132257: Change the default LTO flags on GCC to not pass -flto-partition=none, and allow parallelization of LTO. For newer GNU makes and GCC, this has a multiple factor speedup for LTO build times, with no noticeable loss in performance.

  • gh-132026: Fix use of undefined identifiers in platform triplet detection on MIPS Linux platforms.

Python 3.14.0 alpha 7

Release date: 2025-04-08

macOS

  • gh-124111: Update macOS installer to use Tcl/Tk 8.6.16.

  • gh-131423: Update macOS installer to use OpenSSL 3.0.16. Patch by Bénédikt Tran.

  • gh-131025: Update macOS installer to ship with SQLite 3.49.1.

Windows

  • gh-131423: Update bundled version of OpenSSL to 3.0.16. The new build also disables uplink support, which may be relevant to embedders but has no impact on normal use.

  • gh-131453: Some SND_* and MB_* constants are added to winsound.

  • gh-91349: Replaces our copy of zlib with zlib-ng, for performance improvements in zlib.

  • gh-131025: Update Windows installer to ship with SQLite 3.49.1.

Tools/Demos

  • gh-132121: Always escape non-printable Unicode characters in pygettext.

  • gh-131852: msgfmt no longer adds the POT-Creation-Date to generated .mo files for consistency with GNU msgfmt.

Tests

  • gh-131277: Allow to unset one or more environment variables at once via EnvironmentVarGuard.unset(). Patch by Bénédikt Tran.

  • gh-131050: test_ssl.test_dh_params is skipped if the underlying TLS library does not support finite-field ephemeral Diffie-Hellman.

Security

  • gh-131809: Update bundled libexpat to 2.7.1

  • gh-131261: Upgrade to libexpat 2.7.0

  • gh-121284: Fix bug in the folding of rfc2047 encoded-words when flattening an email message using a modern email policy. Previously when an encoded-word was too long for a line, it would be decoded, split across lines, and re-encoded. But commas and other special characters in the original text could be left unencoded and unquoted. This could theoretically be used to spoof header lines using a carefully constructed encoded-word if the resulting rendered email was transmitted or re-parsed.

Library

Documentation

Core and Builtins

  • gh-131798: Allow the JIT to remove an extra _TO_BOOL_BOOL instruction after _CONTAINS_OP_SET by setting the return type to bool.

  • gh-132011: Fix crash when calling list.append() as an unbound method.

  • gh-131998: Fix a crash when using an unbound method descriptor object in a function where a bound method descriptor was used.

  • gh-131591: Implement PEP 768 (Safe external debugger interface for CPython). Add a new sys.remote_exec() function to the sys module. This function schedules the execution of a Python file in a separate process. Patch by Pablo Galindo, Matt Wozniski and Ivona Stojanovic.

  • gh-131798: Allow JIT to omit str guard in truthiness test when str type is known.

  • gh-131833: Add support for optionally dropping grouping parentheses when using multiple exception types as per PEP 758. Patch by Pablo Galindo

  • gh-130924: Usage of a name in a function-scope annotation no longer triggers creation of a cell for that variable. This fixes a regression in earlier alphas of Python 3.14.

  • gh-131800: Improve the experimental JIT’s ability to remove type checks for certain subscripting operations.

  • gh-131738: Compiler emits optimized code for builtin any/all/tuple calls over a generator expression.

  • gh-131719: Fix missing NULL check in _PyMem_FreeDelayed in free-threaded build.

  • gh-131670: Fix anext() failing on sync __anext__() raising an exception.

  • gh-131666: Fix signature of anext_awaitable.close objects. Patch by Bénédikt Tran.

  • gh-130415: Optimize comparison of two constants in JIT builds

  • gh-129149: Add fast path for small and medium-size integers in PyLong_FromInt32(), PyLong_FromUInt32(), PyLong_FromInt64() and PyLong_FromUInt64(). Patch by Chris Eibl.

  • gh-130887: Optimize the AArch64 code generation for the JIT. Patch by Diego Russo

  • gh-130956: Optimize the AArch64 code generation for the JIT. Patch by Diego Russo

  • gh-130928: Fix error message when formatting bytes using the 'i' flag. Patch by Maxim Ageev.

  • gh-130935: Annotations at the class and module level that are conditionally defined are now only reflected in __annotations__ if the block they are in is executed. Patch by Jelle Zijlstra.

  • gh-130775: Do not crash on negative column and end_column in ast locations.

  • gh-130704: Optimize LOAD_FAST and its superinstruction form to reduce reference counting overhead. These instructions are replaced with faster variants that load borrowed references onto the operand stack when we can prove that the reference in the frame outlives the reference loaded onto the stack.

  • gh-88887: Fixing multiprocessing Resource Tracker process leaking, usually observed when running Python as PID 1.

  • gh-130115: Fix an issue with thread identifiers being sign-extended on some platforms.

  • gh-99108: Add support for built-in implementation of HMAC (RFC 2104) based on HACL*. Patch by Bénédikt Tran.

  • gh-130080: Implement PEP 765: Disallow return/break/continue that exit a finally block.

  • gh-129900: Fix return codes inside SystemExit not getting returned by the REPL.

  • gh-128632: Disallow __classdict__ as the name of a type parameter. Using this name would previously crash the interpreter in some circumstances.

  • gh-126703: Improve performance of builtin methods by using a freelist.

  • gh-126703: Improve performance of range by using a freelist.

C API

  • gh-131740: Update PyUnstable_GC_VisitObjects to traverse perm gen.

  • gh-131525: The PyTupleObject now caches the computed hash value in the new field ob_hash.

Build

  • gh-131865: The DTrace build now properly passes the CC and CFLAGS variables to the dtrace command when utilizing SystemTap on Linux.

  • gh-131675: Fix mimalloc library builds for 32-bit ARM targets.

  • gh-131691: clang-cl on Windows needs option /EHa to support SEH (structured exception handling) correctly. Fix by Chris Eibl.

  • gh-131278: Add optimizing flag WITH_COMPUTED_GOTOS to Windows builds for when using a compiler that supports it (currently clang-cl). Patch by Chris Eibl.

  • gh-130213: Update the vendored HACL* library to fix build issues with older clang compilers.

  • gh-130673: Fix potential KeyError when handling object sections during JIT building process.

Python 3.14.0 alpha 6

Release date: 2025-03-14

macOS

Windows

  • gh-131020: pylauncher correctly detects a BOM when searching for the shebang. Fix by Chris Eibl.

Tools/Demos

  • gh-130453: Make it possible to override default keywords in pygettext.

  • gh-85012: Correctly reset msgctxt when compiling messages in msgfmt.

  • gh-130453: Extend support for specifying custom keywords in pygettext.

  • gh-130195: Add warning messages when pygettext unimplemented -a/--extract-all option is called.

  • gh-130057: Add support for translator comments in pygettext.py.

  • gh-130025: The iOS testbed now correctly handles symlinks used as Python framework references.

  • gh-129911: Fix the keyword entry in the help output of pygettext.

Tests

  • gh-129200: Multiple iOS testbed runners can now be started at the same time without introducing an ambiguity over simulator ownership.

  • gh-130292: The iOS testbed will now run successfully on a machine that has not previously run Xcode tests (such as CI configurations).

  • gh-130293: The tests of terminal colorization are no longer sensitive to the value of the TERM variable in the testing environment.

  • gh-129401: Fix a flaky test in test_repr_rlock that checks the representation of multiprocessing.RLock.

  • gh-126332: Add unit tests for pyrepl.

Security

  • gh-127371: Avoid unbounded buffering for tempfile.SpooledTemporaryFile.writelines(). Previously, disk spillover was only checked after the lines iterator had been exhausted. This is now done after each line is written.

Library

Documentation

Core and Builtins

  • gh-131141: Fix data race in sys.monitoring instrumentation while registering callback.

  • gh-130804: Fix support of unicode characters on Windows in the new REPL.

  • gh-130932: Fix incorrect exception handling in _PyModule_IsPossiblyShadowing

  • gh-122029: sys.setprofile() and sys.settrace() will not generate a c_call event for INSTRUMENTED_CALL_FUNCTION_EX if the callable is a method with a C function wrapped, because we do not generate c_return event in such case.

  • gh-129964: Fix JIT crash on Windows on Arm. Patch by Diego Russo and Brandt Bucher.

  • gh-130851: Fix a crash in the free threading build when constructing a code object with co_consts that contains instances of types that are not otherwise generated by the bytecode compiler.

  • gh-128534: Ensure that both left and right branches have the same source for async for loops. Add these branches to the co_branches() iterator.

  • gh-130794: Fix memory leak in the free threaded build when resizing a shared list or dictionary from multiple short-lived threads.

  • gh-130415: Improve JIT understanding of integers in boolean context.

  • gh-130382: Fix PyRefTracer_DESTROY not being sent from Python/ceval.c Py_DECREF().

  • gh-130574: Renumber RESUME from 149 to 128.

  • gh-124878: Fix race conditions during runtime finalization that could lead to accessing freed memory.

  • gh-130415: Improve the experimental JIT’s ability to narrow boolean values based on the results of truthiness tests.

  • gh-130618: Fix a bug that was causing UnicodeDecodeError or SystemError to be raised when using f-strings with lambda expressions with non-ASCII characters. Patch by Pablo Galindo

  • gh-123044: Make sure that the location of branch targets in match cases is in the body, not the pattern.

  • gh-128534: Add branch monitoring (BRANCH_LEFT and BRANCH_RIGHT events) for async for loops.

  • gh-130163: Fix possible crashes related to concurrent change and use of the sys module attributes.

  • gh-122029: INSTRUMENTED_CALL_KW will expand the method before monitoring to reflect the actual behavior more accurately.

  • gh-130415: Improve JIT’s ability to optimize strings in boolean contexts.

  • gh-130396: Use actual stack limits (from pthread_getattr_np(3)) for linux, and other systems with _GNU_SOURCE defined, when determining limits for C stack protection.

  • gh-128396: Fix a crash that occurs when calling locals() inside an inline comprehension that uses the same local variable as the outer frame scope where the variable is a free or cell var.

  • gh-129107: Fix two more bytearray functions for free threading.

  • gh-127705: Use tagged references (_PyStackRef) for the default build as well as for the free-threading build. This has a small negative performance impact short-term but will enable larger speedups in the future and significantly reduce maintenance costs by allowing a single implementation of tagged references in the future.

  • gh-130094: Fix two race conditions involving concurrent imports that could lead to spurious failures with ModuleNotFoundError.

  • gh-129107: Make bytearray iterator safe under free threading.

  • gh-115802: Use the more efficient «medium» code model for JIT-compiled code on supported platforms.

  • gh-107956: A build-details.json file is now install in the platform-independent standard library directory (PEP 739 implementation).

  • gh-116042: Fix location for SyntaxErrors of invalid escapes in the tokenizer. Patch by Pablo Galindo

  • gh-91079: Change C stack overflow protection to consider the amount of stack consumed, rather than a counter. This allows deeper recursion in many cases, but remains safe.

  • gh-129715: Improve the experimental JIT’s handling of returns to unknown callers.

  • gh-129983: Fix data race in compile_template in sre.c.

  • gh-129967: Fix a race condition in the free threading build when repr(set) is called concurrently with set.clear().

  • gh-129953: The internal (evaluation) stack is now spilled to memory whenever execution escapes from the interpreter or JIT compiled code. This should have no observable effect in either Python or builtin extensions, but will allow various important optimizations in the future.

  • gh-129515: Clarify syntax error messages for conditional expressions when a statement is specified before an if or after an else keyword.

  • gh-129349: bytes.fromhex() and bytearray.fromhex() now accepts ASCII bytes and bytes-like objects.

  • gh-129149: Add fast path for medium-size integers in PyLong_FromSsize_t(). Patch by Chris Eibl.

  • gh-129107: Make the bytearray safe under free threading.

  • gh-128974: Fix a crash in UnicodeError.__str__ when custom attributes implement __str__() with side-effects. Patch by Bénédikt Tran.

  • gh-126085: typing.TypeAliasType now supports star unpacking.

  • gh-125331: from __future__ import barry_as_FLUFL now works in more contexts, including when it is used in files, with the -c flag, and in the REPL when there are multiple statements on the same line. Previously, it worked only on subsequent lines in the REPL, and when the appropriate flags were passed directly to compile(). Patch by Pablo Galindo.

  • gh-121464: Make concurrent iterations over the same enumerate() iterator safe under free-threading. See Strategy for Iterators in Free Threading.

  • gh-87790: Support underscore and comma as thousands separators in the fractional part for floating-point presentation types of the new-style string formatting (with format() or f-strings). Patch by Sergey B Kirpichev.

  • gh-124445: Fix specialization of generic aliases that are generic over a typing.ParamSpec and have been specialized with a nested type variable.

  • gh-120608: Adapt reversed() for use in the free-theading build. The reversed() is still not thread-safe in the sense that concurrent iterations may see the same object, but they will not corrupt the interpreter state.

  • gh-100388: Fix the platform._sys_version() method when __DATE__ is undefined at buildtime by changing default buildtime datetime string to the UNIX epoch.

  • bpo-44369: Improve syntax errors for incorrectly closed strings. Patch by Pablo Galindo

C API

Build

  • gh-131035: Use -flto=thin for faster build times using clang-cl on Windows. Patch by Chris Eibl.

  • gh-130740: Ensure that Python.h is included before stdbool.h unless pyconfig.h is included before or in some platform-specific contexts.

  • gh-130090: Building with PlatformToolset=ClangCL on Windows now supports PGO (profile guided optimization). Patch by Chris Eibl with invaluable support from Steve Dover.

  • gh-129819: Allow building the JIT with the tailcall interpreter.

  • gh-129989: Fix a bug where the tailcall interpreter was enabled when --without-tail-call-interp was provided to the configure script.

  • gh-129838: Don’t redefine _Py_NO_SANITIZE_UNDEFINED when compiling with a recent GCC version and undefined sanitizer enabled.

  • gh-82909: #pragma-based linking with python3*.lib can now be switched off with Py_NO_LINK_LIB. Patch by Jean-Christophe Fillion-Robin.

Python 3.14.0 alpha 5

Release date: 2025-02-11

macOS

  • gh-91132: Update macOS installer to use ncurses 6.5.

Tools/Demos

  • gh-129248: The iOS test runner now strips the log prefix from each line output by the test suite.

  • gh-104400: Fix several bugs in extraction by switching to an AST parser in pygettext.

Tests

  • gh-129386: Add test.support.reset_code, which can be used to reset various bytecode-level optimizations and local instrumentation for a function.

  • gh-128474: Disable test_embed test cases that segfault on BOLT instrument binaries. The tests are only disabled when BOLT is enabled.

  • gh-128003: Add an option --parallel-threads=N to the regression test runner that runs individual tests in multiple threads in parallel in order to find concurrency bugs. Note that most of the test suite is not yet reviewed for thread-safety or annotated with @thread_unsafe when necessary.

Security

  • gh-105704: When using urllib.parse.urlsplit() and urllib.parse.urlparse() host parsing would not reject domain names containing square brackets ([ and ]). Square brackets are only valid for IPv6 and IPvFuture hosts according to RFC 3986 Section 3.2.2.

  • gh-126108: Fix a possible NULL pointer dereference in PySys_AddWarnOptionUnicode().

  • gh-80222: Fix bug in the folding of quoted strings when flattening an email message using a modern email policy. Previously when a quoted string was folded so that it spanned more than one line, the surrounding quotes and internal escapes would be omitted. This could theoretically be used to spoof header lines using a carefully constructed quoted string if the resulting rendered email was transmitted or re-parsed.

  • gh-119511: Fix a potential denial of service in the imaplib module. When connecting to a malicious server, it could cause an arbitrary amount of memory to be allocated. On many systems this is harmless as unused virtual memory is only a mapping, but if this hit a virtual address size limit it could lead to a MemoryError or other process crash. On unusual systems or builds where all allocated memory is touched and backed by actual ram or storage it could’ve consumed resources doing so until similarly crashing.

Library

IDLE

  • gh-129873: Simplify displaying the IDLE doc by only copying the text section of idle.html to idlelib/help.html. Patch by Stan Ulbrych.

Documentation

Core and Builtins

  • gh-100239: Replace the opcode BINARY_SUBSCR and its family by BINARY_OP with oparg NB_SUBSCR.

  • gh-129732: Fixed a race in _Py_qsbr_reserve in the free threading build.

  • gh-129763: Remove the internal LLTRACE macro (use Py_DEBUG instead).

  • gh-129715: Improve JIT performance for generators.

  • gh-129643: Fix thread safety of PyList_Insert() in free-threading builds.

  • gh-129668: Fix race condition when raising MemoryError in the free threaded build.

  • gh-129643: Fix thread safety of PyList_SetItem() in free-threading builds. Patch by Kumar Aditya.

  • gh-128563: Fix an issue where the «lltrace» debug feature could have been incorrectly enabled for some frames.

  • gh-129393: On FreeBSD, sys.platform doesn’t contain the major version anymore. It is always 'freebsd', instead of 'freebsd13' or 'freebsd14'.

  • gh-129345: Fix null pointer dereference in syslog.openlog() when an audit hook raises an exception.

  • gh-129231: Improve memory layout of JIT traces. Patch by Diego Russo

  • gh-129149: Add fast path for medium-size integers in PyLong_FromUnsignedLong(), PyLong_FromUnsignedLongLong() and PyLong_FromSize_t().

  • gh-129201: The free-threaded version of the cyclic garbage collector has been optimized to conditionally use CPU prefetch instructions during the collection. This can reduce collection times by making it more likely that data is in the CPU cache when it is needed. The prefetch instructions are enabled if the number of long-lived objects (objects surviving a full collection) exceeds a threshold.

  • gh-129093: Fix f-strings such as f'{expr=}' sometimes not displaying the full expression when the expression contains !=.

  • gh-124363: Treat debug expressions in f-string as raw strings. Patch by Pablo Galindo

  • gh-128714: Fix the potential races in get/set dunder methods __annotations__, __annotate__ and __type_params__ for function object, and add related tests.

  • gh-128799: Add frame of except* to traceback when it wraps a naked exception.

  • gh-128842: Collect JIT memory stats using pystats. Patch by Diego Russo.

  • gh-100239: Specialize BINARY_OP for bitwise logical operations on compact ints.

  • gh-128910: Undocumented and unused private C-API functions _PyTrash_begin and _PyTrash_end are removed.

  • gh-128807: Add a marking phase to the free-threaded GC. This is similar to what was done in gh-126491. Since the free-threaded GC does not have generations and is not incremental, the marking phase looks for all objects reachable from known roots. The roots are objects known to not be garbage, like the module dictionary for sys. For most programs, this marking phase should make the GC a bit faster since typically less work is done per object.

  • gh-100239: Add opcode BINARY_OP_EXTEND which executes a pair of functions (guard and specialization functions) accessed from the inline cache.

  • gh-128563: A new type of interpreter has been added to CPython. This interpreter uses tail calls for its instruction handlers. Preliminary benchmark results suggest 7-11% geometric mean faster on pyperformance (depending on platform), and up to 30% faster on Python-intensive workloads. This interpreter currently only works on newer compilers, such as clang-19. Other compilers will continue using the old interpreter. Patch by Ken Jin, with ideas on how to implement this in CPython by Mark Shannon, Garret Gu, Haoran Xu, and Josh Haberman.

  • gh-126703: Improve performance of iterating over lists and tuples by using a freelist for the iterator objects.

  • gh-127953: The time to handle a LINE event in sys.monitoring (and sys.settrace) is now independent of the number of lines in the code object.

  • gh-128330: Restore terminal control characters on REPL exit.

  • gh-128016: Improved the SyntaxWarning message for invalid escape sequences to clarify that such sequences will raise a SyntaxError in future Python releases. The new message also suggests a potential fix, i.e., Did you mean "\\e"?.

  • gh-126004: Fix handling of UnicodeError.start and UnicodeError.end values in the codecs.replace_errors() error handler. Patch by Bénédikt Tran.

  • gh-126004: Fix handling of UnicodeError.start and UnicodeError.end values in the codecs.backslashreplace_errors() error handler. Patch by Bénédikt Tran.

  • gh-126004: Fix handling of UnicodeError.start and UnicodeError.end values in the codecs.xmlcharrefreplace_errors() error handler. Patch by Bénédikt Tran.

  • gh-127119: Slightly optimize the int deallocator.

  • gh-127349: Fixed the error when resizing terminal in Python REPL. Patch by Semyon Moroz.

  • gh-125723: Fix crash with gi_frame.f_locals when generator frames outlive their generator. Patch by Mikhail Efimov.

  • gh-126349: Add turtle.fill(), turtle.poly() and turtle.no_animation() context managers. Patch by Marie Roald and Yngve Mardal Moe.

  • gh-115911: If the current working directory cannot be determined due to permissions, then import will no longer raise PermissionError. Patch by Alex Willmer.

  • gh-112713: Added support for the Partitioned cookie flag in http.cookies.

C API

Build

  • gh-129660: Drop test_embed from PGO training, whose contribution in recent versions is considered to be ignorable.

  • gh-128902: Fix compile errors with Clang 9 and older due to lack of __attribute__((fallthrough)) support.

Python 3.14.0 alpha 4

Release date: 2025-01-14

macOS

  • gh-127592: Usage of the unified Apple System Log APIs was disabled when the minimum macOS version is earlier than 10.12.

Tools/Demos

  • gh-128152: Fix a bug where Argument Clinic’s C pre-processor parser tried to parse pre-processor directives inside C comments. Patch by Erlend Aasland.

Tests

  • gh-128690: Temporarily do not use test_embed in PGO profile builds until the problem with test_init_pyvenv_cfg failing in some configurations is resolved.

Library

Core and Builtins

  • gh-128078: Fix a SystemError when using anext() with a default tuple value. Patch by Bénédikt Tran.

  • gh-128717: Fix a crash when setting the recursion limit while other threads are active on the free threaded build.

  • gh-124483: Treat Py_DECREF and variants as escaping when generating opcode and uop metadata. This prevents the possibility of a __del__ method causing the JIT to behave incorrectly.

  • gh-126703: Improve performance of class methods by using a freelist.

  • gh-128137: Update PyASCIIObject layout to handle interned field with the atomic operation. Patch by Donghee Na.

  • gh-128192: Upgrade HTTP digest authentication algorithm for urllib.request by supporting SHA-256 digest authentication as specified in RFC 7616.

  • gh-126868: Increase usage of freelist for int allocation.

  • gh-114203: Optimize Py_BEGIN_CRITICAL_SECTION for simple recursive calls.

  • gh-127705: Adds stackref debugging when Py_STACKREF_DEBUG is set. Finds all double-closes and leaks, logging the origin and last borrow.

    Inspired by HPy’s debug mode. https://docs.hpyproject.org/en/latest/debug-mode.html

  • gh-128079: Fix a bug where except* does not properly check the return value of an ExceptionGroup’s split() function, leading to a crash in some cases. Now when split() returns an invalid object, except* raises a TypeError with the original raised ExceptionGroup object chained to it.

  • gh-128030: Avoid error from calling PyModule_GetFilenameObject on a non-module object when importing a non-existent symbol from a non-module object.

  • gh-128035: Indicate through ssl.HAS_PHA whether the ssl module supports TLSv1.3 post-handshake client authentication (PHA). Patch by Will Childs-Klein.

  • gh-127274: Add a new flag, CO_METHOD, to co_flags that indicates whether the code object belongs to a function defined in class scope.

  • gh-66409: During the path initialization, we now check if base_exec_prefix is the same as base_prefix before falling back to searching the Python interpreter directory.

  • gh-127970: We now use the location of the libpython runtime library used in the current process to determine sys.base_prefix on all platforms implementing the dladdr function defined by the UNIX standard — this includes Linux, Android, macOS, iOS, FreeBSD, etc. This was already the case on Windows and macOS Framework builds.

  • gh-127773: Do not use the type attribute cache for types with incompatible MRO.

  • gh-127903: Objects/unicodeobject.c: fix a crash on DEBUG builds in _copy_characters when there is nothing to copy.

  • gh-127809: Fix an issue where the experimental JIT may infer an incorrect result type for exponentiation (** and **=), leading to bugs or crashes.

  • gh-126862: Fix a possible overflow when a class inherits from an absurd number of super-classes. Reported by Valery Fedorenko. Patch by Bénédikt Tran.

C API

Build

  • gh-128627: For Emscripten builds the function pointer cast call trampoline now uses the wasm-gc ref.test instruction if it’s available instead of Wasm JS type reflection.

  • gh-128472: Skip BOLT optimization of functions using computed gotos, fixing errors on build with LLVM 19.

  • gh-115765: GNU Autoconf 2.72 is now required to generate configure. Patch by Erlend Aasland.

  • gh-123925: Fix building the curses module on platforms with libncurses but without libncursesw.

  • gh-90905: Add support for cross-compiling to x86_64 on aarch64/arm64 macOS.

  • gh-128321: Set LIBS instead of LDFLAGS when checking if sqlite3 library functions are available. This fixes the ordering of linked libraries during checks, which was incorrect when using a statically linked libsqlite3.

  • gh-100384: Error on unguarded-availability in macOS builds, preventing invalid use of symbols that are not available in older versions of the OS.

  • gh-128104: Remove Py_STRFTIME_C99_SUPPORT conditions in favor of requiring C99 strftime(3) specifier support at build time. When cross-compiling, there is no build time check and support is assumed.

  • gh-127951: Add option --pystats to the Windows build to enable performance statistics collection.

Python 3.14.0 alpha 3

Release date: 2024-12-17

Windows

  • gh-127353: Allow to force color output on Windows using environment variables. Patch by Andrey Efremov.

  • gh-125729: Makes the presence of the turtle module dependent on the Tcl/Tk installer option. Previously, the module was always installed but would be unusable without Tcl/Tk.

Tools/Demos

Tests

  • gh-127906: Test the limited C API in test_cppext. Patch by Victor Stinner.

  • gh-127637: Add tests for the dis command-line interface. Patch by Bénédikt Tran.

  • gh-126925: iOS test results are now streamed during test execution, and the deprecated xcresulttool is no longer used.

  • gh-127076: Disable strace based system call tests when LD_PRELOAD is set.

  • gh-127076: Filter out memory-related mmap, munmap, and mprotect calls from file-related ones when testing io behavior using strace.

Security

Library

Documentation

Core and Builtins

  • gh-127740: Fix error message in bytes.fromhex() when given an odd number of digits to properly indicate that an even number of hexadecimal digits is required.

  • gh-127058: PySequence_Tuple now creates the resulting tuple atomically, preventing partially created tuples being visible to the garbage collector or through gc.get_referrers()

  • gh-127599: Fix statistics for increments of object reference counts (in particular, when a reference count was increased by more than 1 in a single operation).

  • gh-127651: When raising ImportError for missing symbols in from imports, use __file__ in the error message if __spec__.origin is not a location

  • gh-127582: Fix non-thread-safe object resurrection when calling finalizers and watcher callbacks in the free threading build.

  • gh-127434: The iOS compiler shims can now accept arguments with spaces.

  • gh-127536: Add missing locks around some list assignment operations in the free threading build.

  • gh-127085: Fix race when exporting a buffer from a memoryview object on the free-threaded build.

  • gh-127238: Correct error message for sys.set_int_max_str_digits().

  • gh-113841: Fix possible undefined behavior division by zero in complex’s _Py_c_pow().

  • gh-127133: Calling argparse.ArgumentParser.add_argument_group() on an argument group, and calling argparse.ArgumentParser.add_argument_group() or argparse.ArgumentParser.add_mutually_exclusive_group() on a mutually exclusive group now raise exceptions. This nesting was never supported, often failed to work correctly, and was unintentionally exposed through inheritance. This functionality has been deprecated since Python 3.11.

  • gh-126491: Add a marking phase to the GC. All objects that can be transitively reached from builtin modules or the stacks are marked as reachable before cycle detection. This reduces the amount of work done by the GC by approximately half.

  • gh-127020: Fix a crash in the free threading build when PyCode_GetCode(), PyCode_GetVarnames(), PyCode_GetCellvars(), or PyCode_GetFreevars() were called from multiple threads at the same time.

  • gh-127010: Simplify GC tracking of dictionaries. All dictionaries are tracked when created, rather than being lazily tracked when a trackable object was added to them. This simplifies the code considerably and results in a slight speedup.

  • gh-126980: Fix __buffer__() of bytearray crashing when READ or WRITE are passed as flags.

  • gh-126937: Fix TypeError when a ctypes.Structure has a field size that doesn’t fit into an unsigned 16-bit integer. Instead, the maximum number of bits is sys.maxsize.

  • gh-126868: Increase performance of int by adding a freelist for compact ints.

  • gh-126881: Fix crash in finalization of dtoa state. Patch by Kumar Aditya.

  • gh-126892: Require cold or invalidated code to «warm up» before being JIT compiled again.

  • gh-126091: Ensure stack traces are complete when throwing into a generator chain that ends in a custom generator.

  • gh-126024: Optimize decoding of short UTF-8 sequences containing non-ASCII characters by approximately 15%.

  • gh-125420: Add memoryview.index() to memoryview objects. Patch by Bénédikt Tran.

  • gh-125420: Add memoryview.count() to memoryview objects. Patch by Bénédikt Tran.

  • gh-124470: Fix crash in free-threaded builds when replacing object dictionary while reading attribute on another thread

  • gh-69639: Implement mixed-mode arithmetic rules combining real and complex numbers as specified by C standards since C99. Patch by Sergey B Kirpichev.

  • gh-120010: Correct invalid corner cases which resulted in (nan+nanj) output in complex multiplication, e.g., (1e300+1j)*(nan+infj). Patch by Sergey B Kirpichev.

  • gh-109746: If _thread.start_new_thread() fails to start a new thread, it deletes its state from interpreter and thus avoids its repeated cleanup on finalization.

C API

Build

  • gh-127865: Fix build failure on systems without thread-locals support.

  • gh-127629: Emscripten builds now include ctypes support.

  • gh-127111: Updated the Emscripten web example to use ES6 modules and be built into a distinct web_example subfolder.

  • gh-115869: Make jit_stencils.h (which is produced during JIT builds) reproducible.

  • gh-126898: The Emscripten build of Python is now based on ES6 modules.

Python 3.14.0 alpha 2

Release date: 2024-11-19

Windows

  • gh-126911: Update credits command output.

  • gh-118973: Ensures the experimental free-threaded install includes the _tkinter module. The optional Tcl/Tk component must also be installed in order for the module to work.

  • gh-126497: Fixes venv failure due to missing redirector executables in experimental free-threaded installs.

  • gh-126074: Removed unnecessary DLLs from Windows embeddable package

  • gh-125315: Avoid crashing in platform due to slow WMI calls on some Windows machines.

  • gh-126084: Fix venvwlauncher to launch pythonw instead of python so no extra console window is created.

  • gh-125842: Fix a SystemError when sys.exit() is called with 0xffffffff on Windows.

  • gh-125550: Enable the Python Install Manager to detect Python 3.14 installs from the Windows Store.

  • gh-123803: All Windows code pages are now supported as «cpXXX» codecs on Windows.

Tools/Demos

  • gh-126807: Fix extraction warnings in pygettext.py caused by mistaking function definitions for function calls.

  • gh-126167: The iOS testbed was modified so that it can be used by third-party projects for testing purposes.

Tests

  • gh-126909: Fix test_os extended attribute tests to work on filesystems with 1 KiB xattr size limit.

  • gh-125730: Change make test to not run GUI tests by default. Use make ci to run tests with GUI tests instead.

  • gh-124295: Add translation tests to the argparse module.

Security

Library

Documentation

  • gh-126622: Added stub pages for removed modules explaining their removal, where to find replacements, and linking to the last Python version that supported them. Contributed by Ned Batchelder.

  • gh-125277: Require Sphinx 7.2.6 or later to build the Python documentation. Patch by Adam Turner.

  • gh-60712: Include the object type in the lists of documented types. Change by Furkan Onder and Martin Panter.

Core and Builtins

  • gh-126795: Increase the threshold for JIT code warmup. Depending on platform and workload, this can result in performance gains of 1-9% and memory savings of 3-5%.

  • gh-126341: Now ValueError is raised instead of SystemError when trying to iterate over a released memoryview object.

  • gh-126688: Fix a crash when calling os.fork() on some operating systems, including SerenityOS.

  • gh-126066: Fix importlib to not write an incomplete .pyc files when a ulimit or some other operating system mechanism is preventing the write to go through fully.

  • gh-126222: Do not include count of «peek» items in _PyUop_num_popped. This ensures that the correct number of items are popped from the stack when a micro-op exits with an error.

  • gh-126366: Fix crash when using yield from on an object that raises an exception in its __iter__.

  • gh-126209: Fix an issue with skip_file_prefixes parameter which resulted in an inconsistent behaviour between the C and Python implementations of warnings.warn(). Patch by Daehee Kim.

  • gh-126312: Fix crash during garbage collection on an object frozen by gc.freeze() on the free-threaded build.

  • gh-103951: Relax optimization requirements to allow fast attribute access to module subclasses.

  • gh-126072: Following gh-126101, for Objetos código like lambda, annotation and type alias, we no longer add None to its co_consts.

  • gh-126195: Improve JIT performance by 1.4% on macOS Apple Silicon by using platform-specific memory protection APIs. Patch by Diego Russo.

  • gh-126139: Provide better error location when attempting to use a future statement with an unknown future feature.

  • gh-126072: Add a new attribute in co_flags to indicate whether the first item in co_consts is the docstring. If a code object has no docstring, None will NOT be inserted.

  • gh-126076: Relocated objects such as tuple, bytes and str objects are properly tracked by tracemalloc and its associated hooks. Patch by Pablo Galindo.

  • gh-90370: Avoid temporary tuple creation for vararg in argument passing with Argument Clinic generated code (if arguments either vararg or positional-only).

  • gh-126018: Fix a crash in sys.audit() when passing a non-string as first argument and Python was compiled in debug mode.

  • gh-126012: The memoryview type now supports subscription, making it a generic type.

  • gh-125837: Adds LOAD_SMALL_INT and LOAD_CONST_IMMORTAL instructions. LOAD_SMALL_INT pushes a small integer equal to the oparg to the stack. LOAD_CONST_IMMORTAL does the same as LOAD_CONST but is more efficient for immortal objects. Removes RETURN_CONST instruction.

  • gh-125942: On Android, the errors setting of sys.stdout was changed from surrogateescape to backslashreplace.

  • gh-125859: Fix a crash in the free threading build when gc.get_objects() or gc.get_referrers() is called during an in-progress garbage collection.

  • gh-125868: It was possible in 3.14.0a1 only for attribute lookup to give the wrong value. This was due to an incorrect specialization in very specific circumstances. This is fixed in 3.14.0a2.

  • gh-125498: The JIT has been updated to leverage Clang 19’s new preserve_none attribute, which supports more platforms and is more useful than LLVM’s existing ghccc calling convention. This also removes the need to manually patch the calling convention in LLVM IR, simplifying the JIT compilation process.

  • gh-125703: Correctly honour tracemalloc hooks in specialized Py_DECREF paths. Patch by Pablo Galindo

  • gh-125593: Use color to highlight error locations in traceback from exception group

  • gh-125017: Fix crash on certain accesses to the __annotations__ of staticmethod and classmethod objects.

  • gh-125588: The Python PEG generator can now use f-strings in the grammar actions. Patch by Pablo Galindo

  • gh-125444: Fix illegal instruction for older Arm architectures. Patch by Diego Russo, testing by Ross Burton.

  • gh-118423: Add a new INSTRUCTION_SIZE macro to the cases generator which returns the current instruction size.

  • gh-125038: Fix crash when iterating over a generator expression after direct changes on gi_frame.f_locals. Patch by Mikhail Efimov.

  • gh-124855: Don’t allow the JIT and perf support to be active at the same time. Patch by Pablo Galindo

  • gh-123714: Update JIT compilation to use LLVM 19

  • gh-123930: Improve the error message when a script shadowing a module from the standard library causes ImportError to be raised during a «from» import. Similarly, improve the error message when a script shadowing a third party module attempts to «from» import an attribute from that third party module while still initialising.

  • gh-119793: The map() built-in now has an optional keyword-only strict flag like zip() to check that all the iterables are of equal length. Patch by Wannes Boeykens.

  • gh-118950: Fix bug where SSLProtocol.connection_lost wasn’t getting called when OSError was thrown on writing to socket.

  • gh-113570: Fixed a bug in reprlib.repr where it incorrectly called the repr method on shadowed Python built-in types.

C API

Build

  • gh-126691: Removed the --with-emscripten-target configure flag. We unified the node and browser options and the same build can now be used, independent of target runtime.

  • gh-123877: Use wasm32-wasip1 as the target triple for WASI instead of wasm32-wasi. The latter will eventually be reclaimed for WASI 1.0 while CPython currently only supports WASI preview1.

  • gh-126458: Disable SIMD support for HACL under WASI.

  • gh-89640: Hard-code float word ordering as little endian on WASM.

  • gh-126206: make clinic now runs Argument Clinic using the --force option, thus forcefully regenerating generated code.

  • gh-126187: Introduced Tools/wasm/emscripten.py to simplify doing Emscripten builds.

  • gh-124932: For cross builds, there is now support for having a different install prefix than the host_prefix used by getpath.py. This is set to / by default for Emscripten, on other platforms the default behavior is the same as before.

  • gh-125946: The minimum supported Android version is now 7.0 (API level 24).

  • gh-125940: The Android build now supports 16 KB page sizes.

  • gh-89640: Improve detection of float word ordering on Linux when link-time optimizations are enabled.

  • gh-124928: Emscripten builds now require node >= 18.

  • gh-115382: Fix cross compile failures when the host and target SOABIs match.

Python 3.14.0 alpha 1

Release date: 2024-10-15

macOS

  • gh-124448: Update bundled Tcl/Tk in macOS installer to 8.6.15.

  • gh-123797: Check for runtime availability of ptsname_r function on macos.

  • gh-123418: Updated macOS installer build to use OpenSSL 3.0.15.

Windows

  • gh-124487: Increases Windows required OS and API level to Windows 10.

  • gh-124609: Fix _Py_ThreadId for Windows builds using MinGW. Patch by Tony Roberts.

  • gh-124448: Updated bundled Tcl/Tk to 8.6.15.

  • gh-124254: Ensures experimental free-threaded binaries remain installed when updating.

  • gh-123915: Ensure that Tools\msi\buildrelease.bat uses different directories for AMD64 and ARM64 builds.

  • gh-123418: Updated Windows build to use OpenSSL 3.0.15.

  • gh-123476: Add support for socket.TCP_QUICKACK on Windows platforms.

  • gh-122573: The Windows build of CPython now requires 3.10 or newer.

  • gh-100256: mimetypes no longer fails when it encounters an inaccessible registry key.

  • gh-119679: Ensures correct import libraries are included in Windows installs.

  • gh-119690: Adds Unicode support and fixes audit events for _winapi.CreateNamedPipe.

  • gh-111201: Add support for new pyrepl on Windows

  • gh-119070: Fixes py.exe handling of shebangs like /usr/bin/env python3.12, which were previously interpreted as python3.exe instead of python3.12.exe.

  • gh-117505: Fixes an issue with the Windows installer not running ensurepip in a fully isolated environment. This could cause unexpected interactions with the user site-packages.

  • gh-118209: Avoid crashing in mmap on Windows when the mapped memory is inaccessible due to file system errors or access violations.

  • gh-79846: Makes ssl.create_default_context() ignore invalid certificates in the Windows certificate store

Tools/Demos

  • gh-123418: Update GitHub CI workflows to use OpenSSL 3.0.15 and multissltests to use 3.0.15, 3.1.7, and 3.2.3.

Tests

  • gh-125041: Re-enable skipped tests for zlib on the s390x architecture: only skip checks of the compressed bytes, which can be different between zlib’s software implementation and the hardware-accelerated implementation.

  • gh-124378: Updated test_ttk to pass with Tcl/Tk 8.6.15.

  • gh-124213: Detect whether the test suite is running inside a systemd-nspawn container with --suppress-sync=true option, and skip the test_os and test_mmap tests that are failing in this scenario.

  • gh-124190: Add capability to ignore entire files or directories in check warning CI tool

  • gh-121921: Update Lib/test/crashers/bogus_code_obj.py so that it crashes properly again.

  • gh-112301: Add tooling to check for changes in compiler warnings. Patch by Nate Ohlson.

  • gh-59022: Add tests for pkgutil.extend_path(). Patch by Andreas Stocker.

  • gh-99242: os.getloadavg() may throw OSError when running regression tests under certain conditions (e.g. chroot). This error is now caught and ignored, since reporting load average is optional.

  • gh-121084: Fix test_typing random leaks. Clear typing ABC caches when running tests for refleaks (-R option): call _abc_caches_clear() on typing abstract classes and their subclasses. Patch by Victor Stinner.

  • gh-121160: Add a test for readline.set_history_length(). Note that this test may fail on readline libraries.

  • gh-121200: Fix test_expanduser_pwd2() of test_posixpath. Call getpwnam() to get pw_dir, since it can be different than getpwall() pw_dir. Patch by Victor Stinner.

  • gh-121188: When creating the JUnit XML file, regrtest now escapes characters which are invalid in XML, such as the chr(27) control character used in ANSI escape sequences. Patch by Victor Stinner.

  • gh-120801: Cleaned up fixtures for importlib.metadata tests and consolidated behavior with “test.support.os_helper”.

  • gh-119727: Add --single-process command line option to Python test runner (regrtest). Patch by Victor Stinner.

  • gh-119273: Python test runner no longer runs tests using TTY (ex: test_ioctl) in a process group (using setsid()). Previously, tests using TTY were skipped. Patch by Victor Stinner.

  • gh-119050: regrtest test runner: Add XML support to the refleak checker (-R option). Patch by Victor Stinner.

  • gh-101525: Skip test_gdb if the binary is relocated by BOLT. Patch by Donghee Na.

  • gh-107562: Test certificates have been updated to expire far in the future. This allows testing Y2038 with system time set to after that, so that actual Y2038 issues can be exposed, and not masked by expired certificate errors.

Security

  • gh-125140: Remove the current directory from sys.path when using PyREPL.

  • gh-123678: Upgrade libexpat to 2.6.3

  • gh-112301: Enable compiler options that warn of potential security vulnerabilities.

  • gh-122792: Changed IPv4-mapped ipaddress.IPv6Address to consistently use the mapped IPv4 address value for deciding properties. Properties which have their behavior fixed are is_multicast, is_reserved, is_link_local, is_global, and is_unspecified.

  • gh-112301: Add ability to ignore warnings per file with warning count in warning checking tooling. Patch by Nate Ohlson.

  • gh-112301: Add macOS warning tracking to warning check tooling. Patch by Nate Ohlson.

  • gh-122133: Authenticate the socket connection for the socket.socketpair() fallback on platforms where AF_UNIX is not available like Windows.

    Patch by Gregory P. Smith <greg@krypto.org> and Seth Larson <seth@python.org>. Reported by Ellie <el@horse64.org>

  • gh-121957: Fixed missing audit events around interactive use of Python, now also properly firing for python -i, as well as for python -m asyncio. The events in question are cpython.run_stdin and cpython.run_startup.

  • gh-112301: Enable runtime protections for glibc to abort execution when unsafe behavior is encountered, for all platforms except Windows.

  • gh-121285: Remove backtracking from tarfile header parsing for hdrcharset, PAX, and GNU sparse headers.

  • gh-112301: Add default compiler options to improve security. Enable -Wimplicit-fallthrough, -fstack-protector-strong, -Wtrampolines.

  • gh-118773: Fixes creation of ACLs in os.mkdir() on Windows to work correctly on non-English machines.

  • gh-118486: os.mkdir() on Windows now accepts mode of 0o700 to restrict the new directory to the current user. This fixes CVE 2024-4030 affecting tempfile.mkdtemp() in scenarios where the base temporary directory is more permissive than the default.

Library

IDLE

  • gh-122392: Increase currently inadequate vertical spacing for the IDLE browsers (path, module, and stack) on high-resolution monitors.

  • gh-112938: Fix uninteruptable hang when Shell gets rapid continuous output.

  • gh-122482: Change About IDLE to direct users to discuss.python.org instead of the now unused idle-dev email and mailing list.

  • gh-78889: Stop Shell freezes by blocking user access to non-method sys.stdout.shell attributes, which are all private.

  • gh-120083: Add explicit black IDLE Hovertip foreground color needed for recent macOS. Fixes Sonoma showing unreadable white on pale yellow. Patch by John Riggles.

  • gh-120104: Fix padding in config and search dialog windows in IDLE.

Documentation

  • gh-124872: Added definitions for context, current context, and context management protocol, updated related definitions to be consistent, and expanded the documentation for contextvars.Context.

  • gh-125018: The importlib.metadata documentation now includes semantic cross-reference targets for the significant documented APIs. This means intersphinx references like importlib.metadata.version() will now work as expected.

  • gh-124720: Update «Using Python on a Mac» section of the «Python Setup and Usage» document and include information on installing free-threading support.

  • gh-124457: Remove coverity scan from the CPython repo. It has not been used since 2020 and is currently unmaintained.

  • gh-116622: Add an Android platform guide, and flag modules not available on Android.

  • gh-123976: Refresh docs around custom providers.

  • gh-70870: Clarified the dual usage of the term «free variable» (both the formal meaning of any reference to names defined outside the local scope, and the narrower pragmatic meaning of nonlocal variables named in co_freevars).

  • gh-121277: Writers of CPython’s documentation can now use next as the version for the versionchanged, versionadded, deprecated directives.

  • gh-117765: Improved documentation for unittest.mock.patch.dict()

  • gh-121749: Fix documentation for PyModule_AddObjectRef().

  • gh-120012: Clarify the behaviours of multiprocessing.Queue.empty() and multiprocessing.SimpleQueue.empty() on closed queues. Patch by Bénédikt Tran.

  • gh-119574: Added some missing environment variables to the output of --help-env.

  • bpo-34008: The Py_Main() documentation moved from the «Very High Level API» section to the «Initialization and Finalization» section.

    Also make it explicit that we expect Py_Main to typically be called instead of Py_Initialize rather than after it (since Py_Main makes its own call to Py_Initialize). Document that calling both is supported but is version dependent on which settings will be applied correctly.

Core and Builtins

  • gh-124375: Fix a crash in the free threading build when the GC runs concurrently with a new thread starting.

  • gh-125221: Fix possible race condition when calling __reduce_ex__() for the first time in the free threading build.

  • gh-125174: Make the handling of reference counts of immortal objects more robust. Immortal objects with reference counts that deviate from their original reference count by up to a billion (half a billion on 32 bit builds) are still counted as immortal.

  • gh-125039: Make this_instr and prev_instr const in cases generator.

  • gh-125008: Fix tokenize.untokenize() producing invalid syntax for double braces preceded by certain escape characters.

  • gh-124871: Fix compiler bug (in some versions of 3.13) where an assertion fails during reachability analysis.

  • gh-123378: Fix a crash in the __str__() method of UnicodeError objects when the UnicodeError.start and UnicodeError.end values are invalid or out-of-range. Patch by Bénédikt Tran.

  • gh-118093: Improve the experimental JIT compiler’s ability to stay «on trace» when encountering highly-biased branches.

  • gh-124642: Fixed scalability issue in free-threaded builds for lock-free reads from dictionaries in multi-threaded scenarios

  • gh-116510: Fix a crash caused by immortal interned strings being shared between sub-interpreters that use basic single-phase init. In that case, the string can be used by an interpreter that outlives the interpreter that created and interned it. For interpreters that share obmalloc state, also share the interned dict with the main interpreter.

  • gh-116510: Fix a bug that can cause a crash when sub-interpreters use «basic» single-phase extension modules. Shared objects could refer to PyGC_Head nodes that had been freed as part of interpreter cleanup.

  • gh-119180: The __main__ module no longer always contains an __annotations__ dictionary in its global namespace.

  • gh-124547: When deallocating an object with inline values whose __dict__ is still live: if memory allocation for the inline values fails, clear the dictionary. Prevents an interpreter crash.

  • gh-124513: Fix a crash in FrameLocalsProxy constructor: check the number of arguments. Patch by Victor Stinner.

  • gh-124442: Fix nondeterminism in compilation by sorting the value of __static_attributes__. Patch by kp2pml30.

  • gh-124285: Fix bug where bool(a) can be invoked more than once during the evaluation of a compound boolean expression.

  • gh-123856: Fix PyREPL failure when a keyboard interrupt is triggered after using a history search

  • gh-65961: Deprecate the setting and using __package__ and __cached__.

  • gh-119726: The JIT now generates more efficient code for calls to C functions resulting in up to 0.8% memory savings and 1.5% speed improvement on AArch64. Patch by Diego Russo.

  • gh-122878: Use the pager binary, if available (e.g. on Debian and derivatives), to display REPL help().

  • gh-124188: Fix reading and decoding a line from the source file with non-UTF-8 encoding for syntax errors raised in the compiler.

  • gh-124027: Support <page up>, <page down>, and <delete> keys in the Python REPL when $TERM is set to vt100.

  • gh-124022: Fix bug where docstring is removed from classes in interactive mode.

  • gh-123958: docstrings are now removed from the optimized AST in optimization level 2.

  • gh-123923: The f_executable field in the internal _PyInterpreterFrame struct now uses a tagged pointer. Profilers and debuggers that uses this field should clear the least significant bit to recover the PyObject* pointer.

  • gh-77894: Fix possible crash in the garbage collector when it tries to break a reference loop containing a memoryview object. Now a memoryview object can only be cleared if there are no buffers that refer it.

  • gh-120221: asyncio REPL is now again properly recognizing KeyboardInterrupts. Display of exceptions raised in secondary threads is fixed.

  • gh-119310: Allow the new interactive shell to read history files written with the editline library that use unicode-escaped entries. Patch by aorcajo and Łukasz Langa.

  • gh-123572: Fix key mappings for various F-keys in Windows for the new REPL. Patch by devdanzin

  • gh-123614: Add turtle.save() to easily save Turtle drawings as PostScript files. Patch by Marie Roald and Yngve Mardal Moe.

  • gh-123339: Setting the __module__ attribute for a class now removes the __firstlineno__ item from the type’s dict, so they will no longer be inconsistent.

  • gh-119034: Change <page up> and <page down> keys of the Python REPL to history search forward/backward. Patch by Victor Stinner.

  • gh-123562: Improve SyntaxError message for using case ... as ... with not a name.

  • gh-123545: Fix a double decref in rare cases on experimental JIT builds.

  • gh-123484: Fix _Py_DebugOffsets for long objects to be relative to the start of the object rather than the start of a subobject.

  • gh-123446: Fix empty function name in TypeError when builtin magic methods are used without the required args.

  • gh-123440: Improve SyntaxError message for using except as with not a name.

  • gh-116017: Improved JIT memory consumption by periodically freeing memory used by infrequently-executed code. This change is especially likely to improve the memory footprint of long-running programs.

  • gh-123344: Add AST optimizations for type parameter defaults.

  • gh-123321: Prevent Parser/myreadline race condition from segfaulting on multi-threaded use. Patch by Bar Harel and Amit Wienner.

  • gh-123177: Fix a bug causing stray prompts to appear in the middle of wrapped lines in the new REPL.

  • gh-122982: Extend the deprecation period for bool inversion (~) by two years.

  • gh-123271: Make concurrent iterations over the same zip() iterator safe under free-threading.

  • gh-123275: Support -X gil=1 and PYTHON_GIL=1 on non-free-threaded builds.

  • gh-123177: Deactivate line wrap in the Apple Terminal via a ANSI escape code. Patch by Pablo Galindo

  • gh-123229: Fix valgrind warning by initializing the f-string buffers to 0 in the tokenizer. Patch by Pablo Galindo

  • gh-122298: Restore printout of GC stats when gc.set_debug(gc.DEBUG_STATS) is called. This feature was accidentally removed when implementing incremental GC.

  • gh-121804: Correctly show error locations when a SyntaxError is raised in the basic REPL. Patch by Sergey B Kirpichev.

  • gh-115776: Enables inline values (Python’s equivalent of hidden classes) on any class who’s instances are of a fixed size.

  • gh-123142: Fix too-wide source location in exception tracebacks coming from broken iterables in comprehensions.

  • gh-123048: Fix a bug where pattern matching code could emit a JUMP_FORWARD with no source location.

  • gh-118093: Break up CALL_ALLOC_AND_ENTER_INIT into micro-ops and relax requirement for exact args, in order to increase the amount of code supported by tier 2.

  • gh-123123: Fix displaying SyntaxError exceptions covering multiple lines. Patch by Pablo Galindo

  • gh-123083: Fix a potential use-after-free in STORE_ATTR_WITH_HINT.

  • gh-123022: Fix crash in free-threaded build when calling Py_Initialize() from a non-main thread.

  • gh-118093: Add three specializations for CALL_KW:

    • CALL_KW_PY for calls to Python functions

    • CALL_KW_BOUND_METHOD for calls to bound methods

    • CALL_KW_NON_PY for all other calls

  • gh-122821: Make sure that branches in while statements have consistent offsets for sys.monitoring. while statements are now compiled with a simple jump at the end of the body, instead of duplicating the test.

  • gh-122907: Building with HAVE_DYNAMIC_LOADING now works as well as it did in 3.12. Existing deficiences will be addressed separately. (See https://github.com/python/cpython/issues/122950.)

  • gh-122888: Fix crash on certain calls to str() with positional arguments of the wrong type. Patch by Jelle Zijlstra.

  • gh-118093: Improve the experimental JIT’s handling of polymorphic code.

  • gh-122697: Fixed memory leaks at interpreter shutdown in the free-threaded build, and also reporting of leaked memory blocks via -X showrefcount.

  • gh-116622: Fix Android stdout and stderr messages being truncated or lost.

  • gh-122527: Fix a crash that occurred when a PyStructSequence was deallocated after its type’s dictionary was cleared by the GC. The type’s tp_basicsize now accounts for non-sequence fields that aren’t included in the Py_SIZE of the sequence.

  • gh-122445: Add only fields which are modified via self.* to __static_attributes__.

  • gh-122417: In the free-threaded build, the reference counts for heap type objects are now partially stored in a distributed manner in per-thread arrays. This reduces contention on the heap type’s reference count fields when creating or destroying instances of the same type from multiple threads concurrently.

  • gh-116090: Fix an issue in JIT builds that prevented some for loops from correctly firing RAISE monitoring events.

  • gh-122300: Preserve AST nodes for f-string with single-element format specifiers. Patch by Pablo Galindo

  • gh-120906: frame.f_locals now supports arbitrary hashable objects as keys.

  • gh-122239: When a list, tuple or dict with too many elements is unpacked, show the actual length in the error message.

  • gh-122245: Detection of writes to __debug__ is moved from the compiler’s codegen stage to the symtable. This means that these errors are now detected even in code that is optimized away before codegen (such as assertions with the -O command line option).

  • gh-122234: Specializations for sums with float and complex inputs in sum() now always use compensated summation. Also, for integer items in above specializations: PyLong_AsDouble() is used, instead of PyLong_AsLongAndOverflow(). Patch by Sergey B Kirpichev.

  • gh-122208: Dictionary watchers now only deliver the PyDict_EVENT_ADDED event when the insertion is in a known good state to succeed.

  • gh-122160: Remove the BUILD_CONST_KEY_MAP opcode. Use BUILD_MAP instead.

  • gh-122029: Emit c_call events in sys.setprofile() when a PyMethodObject pointing to a PyCFunction is called.

  • gh-122026: Fix a bug that caused the tokenizer to not correctly identify mismatched parentheses inside f-strings in some situations. Patch by Pablo Galindo

  • gh-99108: Python’s hashlib now unconditionally uses the vendored HACL* library for Blake2. Python no longer accepts libb2 as an optional dependency for Blake2.

    We refreshed HACL* to the latest version, and now vendor HACL*”s 128-bit and 256-bit wide vector implementations for Blake2, which are used on x86/x64 toolchains when the required CPU features are available at runtime.

    HACL*”s 128-bit wide vector implementation of Blake2 can also run on ARM NEON and Power8, but lacking evidence of a performance gain, these are not enabled (yet).

  • gh-121999: The default extraction filter for the tarfile module is now set to 'data'.

  • gh-121860: Fix crash when rematerializing a managed dictionary after it was deleted.

  • gh-121795: Improve performance of set membership testing, set.remove() and set.discard() when the argument is a set.

  • gh-121814: Fixed the SegFault when PyEval_SetTrace() is used with no Python frame on stack.

  • gh-121295: Fix PyREPL console getting into a blocked state after interrupting a long paste

  • gh-121794: Fix bug in free-threaded Python where a resurrected object could lead to a negative ref count assertion failure.

  • gh-121657: Improve the SyntaxError message if the user tries to use yield from outside a function.

  • gh-121609: Fix pasting of characters containing unicode character joiners in the new REPL. Patch by Marta Gomez Macias

  • gh-121297: Previously, incorrect usage of await or asynchronous comprehensions in code removed by the -O option was not flagged by the Python compiler. Now, such code raises SyntaxError. Patch by Jelle Zijlstra.

  • gh-117482: Unexpected slot wrappers are no longer created for builtin static types in subinterpreters.

  • gh-121562: Optimized performance of hex_from_char by replacing switch-case with a lookup table

  • gh-121499: Fix a bug affecting how multi-line history was being rendered in the new REPL after interacting with the new screen cache. Patch by Pablo Galindo

  • gh-121497: Fix a bug that was preventing the REPL to correctly respect the history when an input hook was set. Patch by Pablo Galindo

  • gh-121012: Tier 2 execution now ensures that list iterators remain exhausted, once they become exhausted.

  • gh-121439: Allow tuples of length 20 in the freelist to be reused.

  • gh-121288: ValueError messages for list.index(), range.index(), deque.index(), deque.remove() and ShareableList.index() no longer contain the repr of the searched value (which can be arbitrary large) and are consistent with error messages for other index() and remove() methods.

  • gh-121368: Fix race condition in _PyType_Lookup in the free-threaded build due to a missing memory fence. This could lead to _PyType_Lookup returning incorrect results on arm64.

  • gh-121149: Added specialization for summation of complexes, this also improves accuracy of builtin sum() for such inputs. Patch by Sergey B Kirpichev.

  • gh-121130: Fix f-strings with debug expressions in format specifiers. Patch by Pablo Galindo

  • gh-121381: Remove subprocess._USE_VFORK escape hatch code and documentation. It was added just in case, and doesn’t have any known cases that require it.

  • gh-119726: Optimize code layout for calls to C functions from the JIT on AArch64. Patch by Diego Russo.

  • gh-121115: PyLong_AsNativeBytes() no longer uses __index__() methods by default. The Py_ASNATIVEBYTES_ALLOW_INDEX flag has been added to allow it.

  • gh-120838: Py_Finalize() and Py_FinalizeEx() now always run with the main interpreter active.

  • gh-113433: Subinterpreters now get cleaned up automatically during runtime finalization.

  • gh-119726: Improve the speed and memory use of C function calls from JIT code on AArch64. Patch by Diego Russo

  • gh-116017: Simplify the warmup mechanism used for «side exits» in JIT code, resulting in slightly better performance and slightly lower memory usage for most platforms.

  • gh-98442: Fix too wide source locations of the cleanup instructions of a with statement.

  • gh-120754: Reduce the number of system calls invoked when reading a whole file (ex. open('a.txt').read()). For a sample program that reads the contents of the 400+ .rst files in the cpython repository Doc folder, there is an over 10% reduction in system call count.

  • gh-119462: Make sure that invariants of type versioning are maintained: * Superclasses always have their version number assigned before subclasses * The version tag is always zero if the tag is not valid. * The version tag is always non-if the tag is valid.

  • gh-120437: Fix _CHECK_STACK_SPACE optimization problems introduced in gh-118322.

  • gh-120722: Correctly set the bytecode position on return instructions within lambdas. Patch by Jelle Zijlstra.

  • gh-120367: Fix bug where compiler creates a redundant jump during pseudo-op replacement. Can only happen with a synthetic AST that has a try on the same line as the instruction following the exception handler.

  • gh-120507: Remove the BEFORE_WITH and BEFORE_ASYNC_WITH instructions. Add the new LOAD_SPECIAL instruction. Generate code for with and async with statements using the new instruction.

  • gh-113993: Strings interned with sys.intern() are again garbage-collected when no longer used, as per the documentation. Strings interned with the C function PyUnicode_InternInPlace() are still immortal. Internals of the string interning mechanism have been changed. This may affect performance and identities of str objects.

  • gh-120485: Add an override of allow_reuse_port on classes subclassing socketserver.TCPServer where allow_reuse_address is also overridden.

  • gh-120384: Fix an array out of bounds crash in list_ass_subscript, which could be invoked via some specifically tailored input: including concurrent modification of a list object, where one thread assigns a slice and another clears it.

  • gh-120367: Fix crash in compiler on code with redundant NOPs and JUMPs which show up after exception handlers are moved to the end of the code.

  • gh-120380: Fix Python implementation of pickle.Pickler for bytes and bytearray objects when using protocol version 5. Patch by Bénédikt Tran.

  • gh-120397: Improve the throughput by up to two times for the str.count(), bytes.count() and bytearray.count() methods for counting single characters.

  • gh-120221: Deliver real signals on Ctrl-C and Ctrl-Z in the new REPL. Patch by Pablo Galindo

  • gh-120346: Respect PYTHON_BASIC_REPL when running in interactive inspect mode (python -i). Patch by Pablo Galindo

  • gh-93691: Fix source locations of instructions generated for the iterator of a for statement.

  • gh-120198: Fix a crash when multiple threads read and write to the same __class__ of an object concurrently.

  • gh-120298: Fix use-after free in list_richcompare_impl which can be invoked via some specifically tailored evil input.

  • gh-119666: Fix a compiler crash in the case where two comprehensions in class scope both reference __class__.

  • gh-119726: JIT: Re-use trampolines on AArch64 when creating stencils. Patch by Diego Russo

  • gh-120225: Fix crash in compiler on empty block at end of exception handler.

  • gh-93691: Fix source locations of instructions generated for with statements.

  • gh-120097: FrameLocalsProxy now subclasses collections.abc.Mapping and can be matched as a mapping in match statements

  • gh-120080: Direct call to the int.__round__() now accepts None as a valid argument.

  • gh-119933: Improve SyntaxError messages for invalid expressions in a type parameters bound, a type parameter constraint tuple or a default type parameter. Patch by Bénédikt Tran.

  • gh-119724: Reverted improvements to error messages for elif/else statements not matching any valid statements, which made in hard to locate the syntax errors inside those elif/else blocks.

  • gh-119879: String search is now slightly faster for certain cases. It now utilizes last character gap (good suffix rule) for two-way periodic needles.

  • gh-119842: Honor PyOS_InputHook() in the new REPL. Patch by Pablo Galindo

  • gh-119180: classmethod() and staticmethod() now wrap the __annotations__ and __annotate__ attributes of their underlying callable lazily. See PEP 649. Patch by Jelle Zijlstra.

  • gh-119821: Fix execution of annotation scopes within classes when globals is set to a non-dict. Patch by Jelle Zijlstra.

  • gh-118934: Make PyEval_GetLocals return borrowed reference

  • gh-119740: Remove the previously-deprecated delegation of int() to __trunc__().

  • gh-119689: Generate stack effect metadata for pseudo instructions from bytecodes.c.

  • gh-109218: complex() accepts now a string only as a positional argument. Passing a complex number as the «real» or «imag» argument is deprecated; it should only be passed as a single positional argument.

  • gh-119548: Add a clear command to the REPL. Patch by Pablo Galindo

  • gh-111999: Fix the signature of str.format_map().

  • gh-119560: An invalid assert in beta 1 has been removed. The assert would fail if PyState_FindModule() was used in an extension module’s init function before the module def had been initialized.

  • gh-119369: Fix deadlock during thread deletion in free-threaded build, which could occur when the GIL was enabled at runtime.

  • gh-119525: Fix deadlock involving _PyType_Lookup() cache in the free-threaded build when the GIL is dynamically enabled at runtime.

  • gh-119258: Eliminate type version guards in the tier two interpreter.

    Note that setting the tp_version_tag manually (which has never been supported) may result in crashes.

  • gh-119311: Fix bug where names are unexpectedly mangled in the bases of generic classes.

  • gh-119395: Fix bug where names appearing after a generic class are mangled as if they are in the generic class.

  • gh-119372: Correct invalid corner cases in complex division (resulted in (nan+nanj) output), e.g. 1/complex('(inf+infj)'). Patch by Sergey B Kirpichev.

  • gh-119180: Evaluation of annotations is now deferred. See PEP 649 for details.

  • gh-119180: Replace LOAD_ASSERTION_ERROR opcode with LOAD_COMMON_CONSTANT and add support for NotImplementedError.

  • gh-119213: Non-builtin modules built with argument clinic were crashing if used in a subinterpreter before the main interpreter. The objects that were causing the problem by leaking between interpreters carelessly have been fixed.

  • gh-119011: Fixes type.__type_params__ to return an empty tuple instead of a descriptor.

  • gh-118692: Avoid creating unnecessary StopIteration instances for monitoring.

  • gh-119180: Add an __annotate__ attribute to functions, classes, and modules as part of PEP 649. Patch by Jelle Zijlstra.

  • gh-119049: Fix displaying the source line for warnings created by the C API if the warnings module had not yet been imported.

  • gh-119057: Improve ZeroDivisionError error message. Now, all error messages are harmonized: all /, //, and % operations just use «division by zero» message. And 0 ** -1 operation uses «zero to a negative power».

  • gh-118844: Fix build failures when configuring with both --disable-gil and --enable-experimental-jit.

  • gh-118921: Add copy() method for FrameLocalsProxy which returns a snapshot dict for local variables.

  • gh-117657: Fix data races on the field that stores a pointer to the interpreter’s main thread that occur in free-threaded builds.

  • gh-118750: If the C version of the decimal module is available, int(str) now uses it to supply an asymptotically much faster conversion. However, this only applies if the string contains over about 2 million digits.

  • gh-118767: Using NotImplemented in a boolean context now raises TypeError. Contributed by Jelle Zijlstra.

  • gh-118561: Fix race condition in free-threaded build where list.extend() could expose uninitialised memory to concurrent readers.

  • gh-117139: Convert the Python evaluation stack to use internal stack references. The purpose is to support tagged pointers. In PEP 703, this will allow for its form of deferred reference counting. For both the default and free-threaded builds, this sets up the infrastructure for unboxed integers in the future.

  • gh-115801: Raise TypeError when passing a string to difflib.unified_diff() and difflib.context_diff().

  • gh-117558: Improve error messages when a string, bytes or bytearray object of length 1 is expected.

  • gh-117195: Avoid assertion failure for debug builds when calling object.__sizeof__(1)

  • gh-116022: Improve the __repr__() output of AST nodes.

  • gh-114091: Changed the error message for awaiting something that can’t be awaited from «object <type> can’t be used in an await expression» to «”<type>” object can’t be awaited».

  • gh-113190: Py_Finalize() now deletes all interned strings.

  • gh-84978: Add class methods float.from_number() and complex.from_number().

  • gh-95144: Improve the error message from a in b when b is not a container to mention the term «container».

  • bpo-24766: Fix handling of doc argument to subclasses of property.

C API

Build

  • gh-125269: Fix detection of whether -latomic is needed when cross-compiling CPython using the configure script.

  • gh-123990: Remove WITH_FREELISTS macro and --without-freelists build configuration

  • gh-124102: Update internal documentation under PCbuild, so it now correctly states that Windows requires VS2017 or later and Python 3.10 or later

  • gh-124043: Building using --with-trace-refs is (temporarily) disallowed when the GIL is disabled.

  • gh-123418: Updated Android build to use OpenSSL 3.0.15.

  • gh-123297: Propagate the value of LDFLAGS to LDCXXSHARED in sysconfig. Patch by Pablo Galindo

  • gh-121634: Allow for specifying the target compile triple for WASI.

  • gh-122578: Use WASI SDK 24 for testing.

  • gh-116622: Rename build variable MODULE_LDFLAGS back to LIBPYTHON, as it’s used by package build systems (e.g. Meson).

  • gh-118943: Fix an issue where the experimental JIT could be built several times by the make regen-all target, leading to possible race conditions on heavily parallelized builds.

  • gh-121996: Introduce ./configure –disable-safety and –enable-slower-safety options. Patch by Donghee Na.

  • gh-120522: Added a --with-app-store-compliance option to patch out known issues with macOS/iOS App Store review processes.

  • gh-120371: Support WASI SDK 22 by explicitly skipping functions that are just stubs in wasi-libc.

  • gh-121731: Fix mimalloc compile error on GNU/Hurd

  • gh-121487: Fix deprecation warning for ATOMIC_VAR_INIT in mimalloc.

  • gh-121467: Fix a Makefile bug that prevented mimalloc header files from being installed.

  • gh-121103: On POSIX systems, excluding macOS framework installs, the lib directory for the free-threaded build now includes a «t» suffix to avoid conflicts with a co-located default build installation.

  • gh-120831: The default minimum iOS version was increased to 13.0.

  • gh-121082: Fix build failure when the developer use --enable-pystats arguments in configuration command after #118450.

  • gh-120671: Fix failing configure tests due to a missing space when appending to CFLAGS.

  • gh-120602: Correctly handle LLVM installs with LLVM_VERSION_SUFFIX when building with --enable-experimental-jit.

  • gh-120688: On WASI in debug mode, Python is now built with compiler flag -O3 instead of -Og, to support more recursive calls. Patch by Victor Stinner.

  • gh-118943: Fix a possible race condition affecting parallel builds configured with --enable-experimental-jit, in which FileNotFoundError could be caused by another process already moving jit_stencils.h.new to jit_stencils.h.

  • gh-120326: On Windows, fix build error when --disable-gil and --experimental-jit options are combined.

  • gh-120291: Make the python-config shell script compatible with non-bash shells.

  • gh-113565: Improve curses and curses.panel dependency checks in configure.

  • gh-119729: On POSIX systems, the pkg-config (.pc) filenames now include the ABI flags, which may include debug («d») and free-threaded («t»). For example: * python-3.14.pc (default, non-debug build) * python-3.14d.pc (default, debug build) * python-3.14t.pc (free-threaded build)

  • gh-119400: make_ssl_certs, the script that prepares certificate data for the test suite, now allows specifying expiration dates.

  • gh-115119: Fall back to the bundled libmpdec if a system version cannot be found.

  • gh-119132: Update sys.version to identify whether the build is default build or free-threading build. Patch By Donghee Na.

  • gh-118836: Fix an AssertionError when building with --enable-experimental-jit and the compiler emits a SHT_NOTE section.

  • gh-118943: Fix a possible race condition affecting parallel builds configured with --enable-experimental-jit, in which compilation errors could be caused by an incompletely-generated header file.

Python 3.13.0 beta 1

Release date: 2024-05-08

Security

  • gh-116741: Update bundled libexpat to 2.6.2

  • gh-117233: Detect BLAKE2, SHA3, Shake, & truncated SHA512 support in the OpenSSL-ish libcrypto library at build time. This allows hashlib to be used with libraries that do not to support every algorithm that upstream OpenSSL does.

Core and Builtins

  • gh-118414: Add instrumented opcodes to YIELD_VALUE assertion for tracing cases.

  • gh-117953: When a builtin or extension module is imported for the first time, while a subinterpreter is active, the module’s init function is now run by the main interpreter first before import continues in the subinterpreter. Consequently, single-phase init modules now fail in an isolated subinterpreter without the init function running under that interpreter, whereas before it would run under the subinterpreter before failing, potentially leaving behind global state and callbacks and otherwise leaving the module in an inconsistent state.

  • gh-117549: Don’t use designated initializer syntax in inline functions in internal headers. They cause problems for C++ or MSVC users who aren’t yet using the latest C++ standard (C++20). While internal, pycore_backoff.h, is included (indirectly, via pycore_code.h) by some key 3rd party software that does so for speed.

  • gh-95382: Improve performance of json.dumps() and json.dump() when using the argument indent. Depending on the data the encoding using json.dumps() with indent can be up to 2 to 3 times faster.

  • gh-116322: In --disable-gil builds, the GIL will be enabled while loading C extension modules. If the module indicates that it supports running without the GIL, the GIL will be disabled once loading is complete. Otherwise, the GIL will remain enabled for the remainder of the interpreter’s lifetime. This behavior does not apply if the GIL has been explicitly enabled or disabled with PYTHON_GIL or -Xgil.

  • gh-118513: Fix incorrect UnboundLocalError when two comprehensions in the same function both reference the same name, and in one comprehension the name is bound while in the other it’s an implicit global.

  • gh-118518: Allow the Linux perf support to work without frame pointers using perf’s advanced JIT support. The feature is activated when using the PYTHON_PERF_JIT_SUPPORT environment variable or when running Python with -Xperf_jit. Patch by Pablo Galindo.

  • gh-117514: Add sys._is_gil_enabled() function that returns whether the GIL is currently enabled. In the default build it always returns True because the GIL is always enabled. In the free-threaded build, it may return True or False.

  • gh-118164: Break a loop between the Python implementation of the decimal module and the Python code for integer to string conversion. Also optimize integer to string conversion for values in the range from 9_000 to 135_000 decimal digits.

  • gh-118473: Fix sys.set_asyncgen_hooks() not to be partially set when raising TypeError.

  • gh-118465: Compiler populates the new __firstlineno__ field on a class with the line number of the first line of the class definition.

  • gh-118492: Fix an issue where the type cache can expose a previously accessed attribute when a finalizer is run.

  • gh-117714: update async_generator.athrow().close() and async_generator.asend().close() to close their section of the underlying async generator

  • gh-111201: The interactive interpreter is now implemented in Python, which allows for a number of new features like colors, multiline input, history viewing, and paste mode. Contributed by Pablo Galindo, Łukasz Langa and Lysandros Nikolaou based on code from the PyPy project.

  • gh-74929: Implement PEP 667: converted FrameType.f_locals and PyFrame_GetLocals() to return a write-through proxy object when the frame refers to a function or comprehension.

  • gh-116767: Fix crash in compiler on “async with” that has many context managers.

  • gh-118335: Change how to use the tier 2 interpreter. Instead of running Python with -X uops or setting the environment variable PYTHON_UOPS=1, this choice is now made at build time by configuring with --enable-experimental-jit=interpreter.

    Beware! This changes the environment variable to enable or disable micro-ops to PYTHON_JIT. The old PYTHON_UOPS is no longer used.

  • gh-118306: Update JIT compilation to use LLVM 18

  • gh-118160: Annotation scopes within classes can now contain comprehensions. However, such comprehensions are not inlined into their parent scope at runtime. Patch by Jelle Zijlstra.

  • gh-118272: Fix bug where generator.close does not free the generator frame’s locals.

  • gh-118216: Don’t consider __future__ imports with dots before the module name.

  • gh-118074: Make sure that the Executor objects in the COLD_EXITS array aren’t assumed to be GC-able (which would access bytes outside the object).

  • gh-107674: Lazy load frame line number to improve performance of tracing

  • gh-118082: Improve SyntaxError message for imports without names, like in from x import and import cases. It now points out to users that import expects at least one name after it.

  • gh-118090: Improve SyntaxError message for empty type param brackets.

  • gh-117958: Added a get_jit_code() method to access JIT compiled machine code from the UOp Executor when the experimental JIT is enabled. Patch by Anthony Shaw.

  • gh-117901: Add option for compiler’s codegen to save nested instruction sequences for introspection.

  • gh-116622: Redirect stdout and stderr to system log when embedded in an Android app.

  • gh-109118: annotation scope within class scopes can now contain lambdas.

  • gh-117894: Prevent agen.aclose() objects being re-used after .throw().

  • gh-117881: prevent concurrent access to an async generator via athrow().throw() or asend().throw()

  • gh-117536: Fix a RuntimeWarning when calling agen.aclose().throw(Exception).

  • gh-117755: Fix mimalloc allocator for huge memory allocation (around 8,589,934,592 GiB) on s390x. Patch by Victor Stinner.

  • gh-117750: Fix issue where an object’s dict would get out of sync with the object’s internal values when being cleared. obj.__dict__.clear() now clears the internal values, but leaves the dict attached to the object.

  • gh-117431: Improve the performance of the following bytes and bytearray methods by adapting them to the METH_FASTCALL calling convention:

    • count()

    • find()

    • index()

    • rfind()

    • rindex()

  • gh-117709: Speed up calls to str() with positional-only argument, by using the PEP 590 vectorcall calling convention. Patch by Erlend Aasland.

  • gh-117680: Give _PyInstructionSequence a Python interface and use it in tests.

  • gh-115776: Statically allocated objects are, by definition, immortal so must be marked as such regardless of whether they are in extension modules or not.

  • gh-117385: Remove unhandled PY_MONITORING_EVENT_BRANCH and PY_MONITORING_EVENT_EXCEPTION_HANDLED events from sys.settrace().

  • gh-116322: Extension modules may indicate to the runtime that they can run without the GIL. Multi-phase init modules do so by calling providing Py_MOD_GIL_NOT_USED for the Py_mod_gil slot, while single-phase init modules call PyUnstable_Module_SetGIL(mod, Py_MOD_GIL_NOT_USED) from their init function.

  • gh-116129: Implement PEP 696, adding support for defaults on type parameters. Patch by Jelle Zijlstra.

  • gh-93502: Add two new functions to the C-API, PyRefTracer_SetTracer() and PyRefTracer_GetTracer(), that allows to track object creation and destruction the same way the tracemalloc module does. Patch by Pablo Galindo

  • gh-107674: Improved the performance of sys.settrace() significantly

  • gh-95754: Improve the error message when a script shadowing a module from the standard library causes AttributeError to be raised. Similarly, improve the error message when a script shadowing a third party module attempts to access an attribute from that third party module while still initialising.

  • gh-99180: Elide uninformative traceback indicators in return and simple assignment statements. Patch by Pablo Galindo.

  • gh-105879: Allow the globals and locals arguments to exec() and eval() to be passed as keywords.

Library

  • gh-118418: A DeprecationWarning is now emitted if you fail to pass a value to the new type_params parameter of typing._eval_type() or typing.ForwardRef._evaluate(). (Using either of these private and undocumented functions is discouraged to begin with, but failing to pass a value to the type_params parameter may lead to incorrect behaviour on Python 3.12 or newer.)

  • gh-118660: Add an optional second type parameter to typing.ContextManager and typing.AsyncContextManager, representing the return types of __exit__() and __aexit__() respectively. This parameter defaults to bool | None.

  • gh-118650: The enum module allows method named _repr_* to be defined on Enum types.

  • gh-118648: Add type parameter defaults to typing.Generator and typing.AsyncGenerator.

  • gh-101137: Mime type text/x-rst is now supported by mimetypes.

  • gh-118164: The Python implementation of the decimal module could appear to hang in relatively small power cases (like 2**117) if context precision was set to a very high value. A different method to check for exactly representable results is used now that doesn’t rely on computing 10**precision (which could be effectively too large to compute).

  • gh-111744: breakpoint() and pdb.set_trace() now enter the debugger immediately after the call rather than before the next line is executed.

  • gh-118500: Add pdb support for zipapps

  • gh-118406: Add signature for sqlite3.Connection objects.

  • gh-101732: Use a Y2038 compatible openssl time function when available.

  • gh-118404: Fix inspect.signature() for non-comparable callables.

  • gh-118402: Fix inspect.signature() for the result of the functools.cmp_to_key() call.

  • gh-116622: On Android, sysconfig.get_platform now returns the format specified by PEP 738.

  • gh-118285: Allow to specify the signature of custom callable instances of extension type by the __text_signature__ attribute. Specify signatures of operator.attrgetter, operator.itemgetter, and operator.methodcaller instances.

  • gh-118314: Fix an edge case in binascii.a2b_base64() strict mode, where excessive padding is not detected when no padding is necessary.

  • gh-118271: Add the PhotoImage methods read() to read an image from a file and data() to get the image data. Add background and grayscale parameters to PhotoImage method write().

  • gh-118225: Add the PhotoImage method copy_replace() to copy a region from one image to other image, possibly with pixel zooming and/or subsampling. Add from_coords parameter to PhotoImage methods copy(), zoom() and subsample(). Add zoom and subsample parameters to PhotoImage method copy().

  • gh-118221: Fix a bug where sqlite3.Connection.iterdump() could fail if a custom row factory was used. Patch by Erlend Aasland.

  • gh-118013: Fix regression introduced in gh-103193 that meant that calling inspect.getattr_static() on an instance would cause a strong reference to that instance’s class to persist in an internal cache in the inspect module. This caused unexpected memory consumption if the class was dynamically created, the class held strong references to other objects which took up a significant amount of memory, and the cache contained the sole strong reference to the class. The fix for the regression leads to a slowdown in getattr_static(), but the function should still be significantly faster than it was in Python 3.11. Patch by Alex Waygood.

  • gh-118218: Speed up itertools.pairwise() in the common case by up to 1.8x.

  • gh-117486: Improve the behavior of user-defined subclasses of ast.AST. Such classes will now require no changes in the usual case to conform with the behavior changes of the ast module in Python 3.13. Patch by Jelle Zijlstra.

  • gh-90848: Fixed unittest.mock.create_autospec() to configure parent mock with keyword arguments.

  • gh-118168: Fix incorrect argument substitution when typing.Unpack is used with the builtin tuple. typing.Unpack now raises TypeError when used with certain invalid types. Patch by Jelle Zijlstra.

  • gh-118131: Add command-line interface for the random module. Patch by Hugo van Kemenade.

  • gh-118107: Fix zipimport reading of ZIP64 files with file entries that are too big or offset too far.

  • gh-102511: Fix os.path.normpath() for UNC paths on Windows. Speed up os.path.splitroot() with a native implementation.

  • gh-117535: Change the unknown filename of warnings from sys to <sys> to clarify that it’s not a real filename.

  • gh-114053: Fix erroneous NameError when calling typing.get_type_hints() on a class that made use of PEP 695 type parameters in a module that had from __future__ import annotations at the top of the file. Patch by Alex Waygood.

  • gh-116931: Add parameter fileobj check for tarfile.TarFile.addfile()

  • gh-117995: Don’t raise DeprecationWarning when a sequence of parameters is used to bind indexed, nameless placeholders. See also gh-100668.

  • gh-80361: Fix TypeError in email.message.Message.get_payload() when the charset is RFC 2231 encoded.

  • gh-86650: Fix IndexError when parse some emails with invalid Message-ID (including one-off addresses generated by Microsoft Outlook).

  • gh-117691: Improve the error messages emitted by tarfile deprecation warnings relating to PEP 706. If a filter argument is not provided to extract() or extractall, the deprecation warning now points to the line in the user’s code where the relevant function was called. Patch by Alex Waygood.

  • gh-115874: Fixed a possible segfault during garbage collection of _asyncio.FutureIter objects. Patch by Savannah Ostrowski.

  • gh-115060: Speed up pathlib.Path.glob() by omitting an initial is_dir() call. As a result of this change, glob() can no longer raise OSError.

  • gh-77102: site module now parses .pth file with UTF-8 first, and locale encoding if UnicodeDecodeError happened. It supported only locale encoding before.

  • gh-76785: We’ve exposed the low-level _interpreters module for the sake of the PyPI implementation of PEP 734. It was sometimes available as the _xxsubinterpreters module and was formerly used only for testing. For the most part, it should be considered an internal module, like _thread and _imp. See https://discuss.python.org/t/pep-734-multiple-interpreters-in-the-stdlib/41147/26.

  • gh-115060: Speed up pathlib.Path.glob() by not scanning directories for non-wildcard pattern segments.

  • gh-117727: Speed up pathlib.Path.iterdir() by using os.scandir() internally.

  • gh-117586: Speed up pathlib.Path.walk() by working with strings internally.

  • gh-117722: Change the new multi-separator support in asyncio.StreamReader.readuntil() to only accept tuples of separators rather than arbitrary iterables.

  • gh-117692: Fixes a bug when doctest.DocTestFinder was failing on wrapped builtin_function_or_method.

  • gh-117348: Largely restored import time performance of configparser by avoiding dataclasses.

  • gh-117641: Speedup os.path.commonpath() on Unix.

  • gh-117663: Fix _simple_enum to detect aliases when multiple arguments are present but only one is the member value.

  • gh-117636: Speedup os.path.join().

  • gh-117618: Support package.module as filename for break command of pdb

  • gh-102247: the status codes enum with constants in http.HTTPStatus are updated to include the names from RFC9110. This RFC includes some HTTP statuses previously only used for WEBDAV and assigns more generic names to them.

    The old constants are preserved for backwards compatibility.

  • gh-117607: Speedup os.path.relpath().

  • gh-117586: Speed up pathlib.Path.glob() by working with strings internally.

  • gh-117225: Add colour to doctest output. Patch by Hugo van Kemenade.

  • gh-117566: ipaddress.IPv6Address.is_loopback() will now return True for IPv4-mapped loopback addresses, i.e. addresses in the ::ffff:127.0.0.0/104 address space.

  • gh-117546: Fix issue where os.path.realpath() stopped resolving symlinks after encountering a symlink loop on POSIX.

  • gh-116720: Improved behavior of asyncio.TaskGroup when an external cancellation collides with an internal cancellation. For example, when two task groups are nested and both experience an exception in a child task simultaneously, it was possible that the outer task group would misbehave, because its internal cancellation was swallowed by the inner task group.

    In the case where a task group is cancelled externally and also must raise an ExceptionGroup, it will now call the parent task’s cancel() method. This ensures that a asyncio.CancelledError will be raised at the next await, so the cancellation is not lost.

    An added benefit of these changes is that task groups now preserve the cancellation count (asyncio.Task.cancelling()).

    In order to handle some corner cases, asyncio.Task.uncancel() may now reset the undocumented _must_cancel flag when the cancellation count reaches zero.

  • gh-117516: Add typing.TypeIs, implementing PEP 742. Patch by Jelle Zijlstra.

  • gh-117503: Fix support of non-ASCII user names in bytes paths in os.path.expanduser() on Posix.

  • gh-117394: os.path.ismount() is now 2-3 times faster if the user has permissions.

  • gh-117313: Only treat '\n', '\r' and '\r\n' as line separators in re-folding the email messages. Preserve control characters '\v', '\f', '\x1c', '\x1d' and '\x1e' and Unicode line separators '\x85', '\u2028' and '\u2029' as is.

  • gh-117142: Convert _ctypes to multi-phase initialisation (PEP 489).

  • gh-66543: Add the mimetypes.guess_file_type() function which works with file path. Passing file path instead of URL in guess_type() is soft deprecated.

  • gh-68583: webbrowser CLI: replace getopt with argparse, add long options. Patch by Hugo van Kemenade.

  • gh-116871: Name suggestions for AttributeError and ImportError now only include underscored names if the original name was underscored.

  • gh-116023: Don’t show empty fields (value None or []) in ast.dump() by default. Add show_empty=False parameter to optionally show them.

  • gh-115961: Added name and mode attributes for compressed and archived file-like objects in modules bz2, lzma, tarfile and zipfile. The value of the mode attribute of gzip.GzipFile was changed from integer (1 or 2) to string ('rb' or 'wb'). The value of the mode attribute of the readable file-like object returned by zipfile.ZipFile.open() was changed from 'r' to 'rb'.

  • gh-82062: Fix inspect.signature() to correctly handle parameter defaults on methods in extension modules that use names defined in the module namespace.

  • gh-83856: Honor atexit for all multiprocessing start methods

  • gh-113081: Print colorized exception just like built-in traceback in pdb

  • gh-112855: Speed up pickling of pathlib.PurePath objects. Patch by Barney Gale.

  • gh-111744: Support opcode events in bdb

  • gh-109617: ncurses: fixed a crash that could occur on macOS 13 or earlier when Python was built with Apple Xcode 15’s SDK.

  • gh-83151: Enabled arbitrary statements and evaluations in pdb shell to access the local variables of the current frame, which made it possible for multi-scope code like generators or nested function to work.

  • gh-110209: Add __class_getitem__() to types.GeneratorType and types.CoroutineType for type hinting purposes. Patch by James Hilton-Balfe.

  • gh-108191: The types.SimpleNamespace now accepts an optional positional argument which specifies initial values of attributes as a dict or an iterable of key-value pairs.

  • gh-62090: Fix assertion errors caused by whitespace in metavars or SUPPRESS-ed groups in argparse by simplifying usage formatting. Patch by Ali Hamdan.

  • gh-102402: Adjust logging.LogRecord to use time.time_ns() and fix minor bug related to floating-point math.

  • gh-100242: Bring pure Python implementation functools.partial.__new__ more in line with the C-implementation by not just always checking for the presence of the attribute 'func' on the first argument of partial. Instead, both the Python version and the C version perform an isinstance(func, partial) check on the first argument of partial.

  • gh-99730: HEAD requests are no longer upgraded to GET request during redirects in urllib.

  • gh-66410: Setting the tkinter module global wantobjects to 2 before creating the Tk object or call the wantobjects() method of the Tk object with argument 2 makes now arguments to callbacks registered in the tkinter module to be passed as various Python objects (int, float, bytes, tuple), depending on their internal representation in Tcl, instead of always str. tkinter.wantobjects is now set to 2 by default.

  • bpo-40943: Fix several IndexError when parse emails with truncated Message-ID, address, routes, etc, e.g. example@.

  • bpo-39324: Add mime type mapping for .md <-> text/markdown

  • bpo-18108: shutil.chown() now supports dir_fd and follow_symlinks keyword arguments.

  • bpo-30988: Fix parsing of emails with invalid address headers having a leading or trailing dot. Patch by tsufeki.

  • bpo-32839: Add the after_info() method for Tkinter widgets.

Documentation

  • gh-117928: The minimum Sphinx version required for the documentation is now 6.2.1.

Build

  • gh-118734: Fixes Windows build when invoked directly (not through the build.bat script) without specifying a value for UseTIER2.

  • gh-115119: The configure option --with-system-libmpdec now defaults to yes. The bundled copy of libmpdecimal will be removed in Python 3.15.

  • gh-117845: Fix building against recent libedit versions by detecting readline hook signatures in configure.

  • gh-116622: A testbed project was added to run the test suite on Android.

  • gh-117645: Increase WASI stack size from 512 KiB to 8 MiB and the initial memory from 10 MiB to 20 MiB. Patch by Victor Stinner.

  • gh-115119: configure now uses pkg-config to detect decimal dependencies if the --with-system-libmpdec option is given.

Windows

  • gh-115119: Update Windows installer to use libmpdecimal 4.0.0.

  • gh-118486: os.mkdir() now accepts mode of 0o700 to restrict the new directory to the current user.

  • gh-118347: Fixes launcher updates not being installed.

  • gh-118293: The multiprocessing module now passes the STARTF_FORCEOFFFEEDBACK flag when spawning processes to tell Windows not to change the mouse cursor.

  • gh-115009: Update Windows installer to use SQLite 3.45.3.

  • gh-90329: Suppress the warning displayed on virtual environment creation when the requested and created paths differ only by a short (8.3 style) name. Warnings will continue to be shown if a junction or symlink in the path caused the venv to be created in a different location than originally requested.

  • gh-117786: Fixes virtual environments not correctly launching when created from a Store install.

macOS

  • gh-115119: Update macOS installer to use libmpdecimal 4.0.0.

  • gh-114099: iOS preprocessor symbol usage was made compatible with older macOS SDKs.

  • gh-115009: Update macOS installer to use SQLite 3.45.3.

  • gh-91629: Use ~/.config/fish/conf.d configs and fish_add_path to set PATH when installing for the Fish shell.

IDLE

  • bpo-34774: Use user-selected color theme for Help => IDLE Doc.

C API

Python 3.13.0 alpha 6

Release date: 2024-04-09

Core and Builtins

  • gh-117494: Refactored the instruction sequence data structure out of compile.c into instruction_sequence.c.

  • gh-116968: Introduce a unified 16-bit backoff counter type (_Py_BackoffCounter), shared between the Tier 1 adaptive specializer and the Tier 2 optimizer. The API used for adaptive specialization counters is changed but the behavior is (supposed to be) identical.

    The behavior of the Tier 2 counters is changed:

    • There are no longer dynamic thresholds (we never varied these).

    • All counters now use the same exponential backoff.

    • The counter for JUMP_BACKWARD starts counting down from 16.

    • The temperature in side exits starts counting down from 64.

  • gh-117431: Improve the performance of the following bytes and bytearray methods by adapting them to the METH_FASTCALL calling convention:

    • endswith()

    • startswith()

  • gh-117431: Improve the performance of the following str methods by adapting them to the METH_FASTCALL calling convention:

  • gh-117411: Move PyFutureFeatures to an internal header and make it private.

  • gh-109120: Added handle of incorrect star expressions, e.g f(3, *). Patch by Grigoryev Semyon

  • gh-117266: Fix crashes for certain user-created subclasses of ast.AST. Such classes are now expected to set the _field_types attribute.

  • gh-99108: Updated the hashlib built-in HACL* project C code from upstream that we use for many implementations when they are not present via OpenSSL in a given build. This also avoids the rare potential for a C symbol name one definition rule linking issue.

  • gh-117108: Change the old space bit of objects in the young generation from 0 to gcstate->visited, so that any objects created during GC will have the old bit set correctly if they get moved into the old generation.

  • gh-117108: The cycle GC now chooses the size of increments based on the total heap size, instead of the rate of object creation. This ensures that it can keep up with growing heaps.

  • gh-116735: For INSTRUMENTED_CALL_FUNCTION_EX, set arg0 to sys.monitoring.MISSING instead of None for CALL event.

  • gh-113964: Starting new threads and process creation through os.fork() are now only prevented once all non-daemon threads exit.

  • gh-116626: Ensure INSTRUMENTED_CALL_FUNCTION_EX always emits CALL

  • gh-116554: list.sort() now exploits more cases of partial ordering, particularly those with long descending runs with sub-runs of equal values. Those are recognized as single runs now (previously, each block of repeated values caused a new run to be created).

  • gh-114099: Added a Loader that can discover extension modules in an iOS-style Frameworks folder.

  • gh-115775: Compiler populates the new __static_attributes__ field on a class with the names of attributes of this class which are accessed through self.X from any function in its body.

  • gh-115776: The array of values, the PyDictValues struct is now embedded in the object during allocation. This provides better performance in the common case, and does not degrade as much when the object’s __dict__ is materialized.

  • gh-108362: Implement an incremental cyclic garbage collector. By collecting the old generation in increments, there is no need for a full heap scan. This can hugely reduce maximum pause time for programs with large heaps.

    Reduce the number of generations from three to two. The old generation is split into two spaces, «visited» and «pending».

    Collection happens in two steps:: * An increment is formed from the young generation and a small part of the pending space. * This increment is scanned and the survivors moved to the end of the visited space.

    When the collecting space becomes empty, the two spaces are swapped.

  • gh-109870: Dataclasses now calls exec() once per dataclass, instead of once per method being added. This can speed up dataclass creation by up to 20%.

  • gh-97901: Mime type text/rtf is now supported by mimetypes.

  • bpo-24612: Improve the SyntaxError that happens when “not” appears after an operator. Patch by Pablo Galindo

Library

  • gh-117648: Improve performance of os.path.join() and os.path.expanduser().

  • gh-117584: Raise TypeError for non-paths in posixpath.relpath().

  • gh-117467: Preserve mailbox ownership when rewriting in mailbox.mbox.flush(). Patch by Tony Mountifield.

  • gh-114848: Raise FileNotFoundError when getcwd() returns “(unreachable)”, which can happen on Linux >= 2.6.36 with glibc < 2.27.

  • gh-117459: asyncio.asyncio.run_coroutine_threadsafe() now keeps the traceback of CancelledError, TimeoutError and InvalidStateError which are raised in the coroutine.

  • gh-117381: Fix error message for ntpath.commonpath().

  • gh-117337: Deprecate undocumented glob.glob0() and glob.glob1() functions. Use glob.glob() and pass a directory to its root_dir argument instead.

  • gh-117349: Optimise several functions in os.path.

  • gh-117348: Refactored configparser.RawConfigParser._read() to reduce cyclometric complexity and improve comprehensibility.

  • gh-117335: Raise TypeError for non-sequences for ntpath.commonpath().

  • gh-66449: configparser.ConfigParser now accepts unnamed sections before named ones, if configured to do so.

  • gh-88014: In documentation of gzip.GzipFile in module gzip, explain data type of optional constructor argument mtime, and recommend mtime = 0 for generating deterministic streams.

  • gh-117310: Fixed an unlikely early & extra Py_DECREF triggered crash in ssl when creating a new _ssl._SSLContext if CPython was built implausibly such that the default cipher list is empty or the SSL library it was linked against reports a failure from its C SSL_CTX_set_cipher_list() API.

  • gh-117294: A DocTestCase now reports as skipped if all examples in the doctest are skipped.

  • gh-98966: In subprocess, raise a more informative message when stdout=STDOUT.

  • gh-117225: doctest: only print «and X failed» when non-zero, don’t pluralise «1 items». Patch by Hugo van Kemenade.

  • gh-117205: Speed up compileall.compile_dir() by 20% when using multiprocessing by increasing chunksize.

  • gh-117178: Fix regression in lazy loading of self-referential modules, introduced in gh-114781.

  • gh-112383: Fix dis module’s handling of ENTER_EXECUTOR instructions.

  • gh-117182: Lazy-loading of modules that modify their own __class__ no longer reverts the __class__ to types.ModuleType.

  • gh-117084: Fix zipfile extraction for directory entries with the name containing backslashes on Windows.

  • gh-117114: Make os.path.isdevdrive() available on all platforms. For those that do not offer Dev Drives, it will always return False.

  • gh-117110: Fix a bug that prevents subclasses of typing.Any to be instantiated with arguments. Patch by Chris Fu.

  • gh-109653: Deferred select imports in importlib.metadata and importlib.resources for a 14% speedup.

  • gh-70647: Start the deprecation period for the current behavior of datetime.datetime.strptime() and time.strptime() which always fails to parse a date string with a ValueError involving a day of month such as strptime("02-29", "%m-%d") when a year is not specified and the date happen to be February 29th. This should help avoid users finding new bugs every four years due to a natural mistaken assumption about the API when parsing partial date values.

  • gh-116987: Fixed inspect.findsource() for class code objects.

  • gh-114099: Modify standard library to allow for iOS platform differences.

  • gh-90872: On Windows, subprocess.Popen.wait() no longer calls WaitForSingleObject() with a negative timeout: pass 0 ms if the timeout is negative. Patch by Victor Stinner.

  • gh-116957: configparser: Don’t leave ConfigParser values in an invalid state (stored as a list instead of a str) after an earlier read raised DuplicateSectionError or DuplicateOptionError.

  • gh-115538: _io.WindowsConsoleIO now emit a warning if a boolean value is passed as a filedescriptor argument.

  • gh-90095: Ignore empty lines and comments in .pdbrc

  • gh-106531: Refreshed zipfile._path from zipp 3.18, providing better compatibility for PyPy, better glob performance for deeply nested zipfiles, and providing internal access to CompleteDirs.inject for use in other tests (like importlib.resources).

  • gh-63207: On Windows, time.time() now uses the GetSystemTimePreciseAsFileTime() clock to have a resolution better than 1 us, instead of the GetSystemTimeAsFileTime() clock which has a resolution of 15.6 ms. Patch by Victor Stinner.

  • gh-116764: Restore support of None and other false values in urllib.parse functions parse_qs() and parse_qsl(). Also, they now raise a TypeError for non-zero integers and non-empty sequences.

  • gh-116811: In PathFinder.invalidate_caches, delegate to MetadataPathFinder.invalidate_caches.

  • gh-116647: Fix recursive child in dataclasses

  • gh-113171: Fixed various false positives and false negatives in

    Also in the corresponding ipaddress.IPv4Network and ipaddress.IPv6Network attributes.

  • gh-63283: In encodings.idna, any capitalization of the ACE prefix (xn--) is now acceptable. Patch by Pepijn de Vos and Zackery Spytz.

  • gh-71042: Add platform.android_ver(), which provides device and OS information on Android.

  • gh-73468: Added new math.fma() function, wrapping C99’s fma() operation: fused multiply-add function. Patch by Mark Dickinson and Victor Stinner.

  • gh-116608: The importlib.resources functions is_resource(), open_binary(), open_text(), path(), read_binary(), and read_text() are un-deprecated, and support subdirectories via multiple positional arguments. The contents() function also allows subdirectories, but remains deprecated.

  • gh-116484: Change automatically generated tkinter.Checkbutton widget names to avoid collisions with automatically generated tkinter.ttk.Checkbutton widget names within the same parent widget.

  • gh-114314: In ctypes, ctype data is now stored in type objects directly rather than in a dict subclass. This is an internal change that should not affect usage.

  • gh-116401: Fix blocking os.fwalk() and shutil.rmtree() on opening named pipe.

  • gh-71052: Implement ctypes.util.find_library() on Android.

  • gh-90535: Fix support of interval values > 1 in logging.TimedRotatingFileHandler for when='MIDNIGHT' and when='Wx'.

  • gh-113308: Remove some internal protected parts from uuid: _has_uuid_generate_time_safe, _netbios_getnode, _ipconfig_getnode, and _load_system_functions. They were unused.

  • gh-115627: Fix the ssl module error handling of connection terminate by peer. It now throws an OSError with the appropriate error code instead of an EOFError.

  • gh-114847: Speed up os.path.realpath() on non-Windows platforms.

  • gh-114271: Fix a race in threading.Thread.join().

    threading._MainThread now always represents the main thread of the main interpreter.

    PyThreadState.on_delete and PyThreadState.on_delete_data have been removed.

  • gh-113538: Add asyncio.Server.close_clients() and asyncio.Server.abort_clients() methods which allow to more forcefully close an asyncio server.

  • gh-85287: Changes Unicode codecs to return UnicodeEncodeError or UnicodeDecodeError, rather than just UnicodeError.

  • gh-113548: pdb now allows CLI arguments to pdb -m.

  • gh-112948: Make completion of pdb similar to Python REPL

  • gh-105866: Fixed _get_slots bug which caused error when defining dataclasses with slots and a weakref_slot.

  • gh-96471: Add asyncio.Queue termination with shutdown() method.

  • gh-89739: The zipimport module can now read ZIP64 files.

  • bpo-33533: asyncio.as_completed() now returns an object that is both an asynchronous iterator and plain iterator. The new asynchronous iteration pattern allows for easier correlation between prior tasks and their completed results. This is a closer match to concurrent.futures.as_completed()”s iteration pattern. Patch by Justin Arthur.

  • bpo-27578: inspect.getsource() (and related functions) work with empty module files, returning '\n' (or reasonable equivalent) instead of raising OSError. Patch by Kernc.

  • bpo-37141: Accept an iterable of separators in asyncio.StreamReader.readuntil(), stopping when one of them is encountered.

  • gh-66543: Make mimetypes.guess_type() properly parsing of URLs with only a host name, URLs containing fragment or query, and filenames with only a UNC sharepoint on Windows. Based on patch by Dong-hee Na.

  • bpo-15010: unittest.TestLoader.discover() now saves the original value of unittest.TestLoader._top_level_dir and restores it at the end of the call.

Documentation

  • gh-115977: Remove compatibility references to Emscripten.

  • gh-114099: Add an iOS platform guide, and flag modules not available on iOS.

  • gh-91565: Changes to documentation files and config outputs to reflect the new location for reporting bugs - i.e. GitHub rather than bugs.python.org.

Tests

  • gh-83434: Disable JUnit XML output (--junit-xml=FILE command line option) in regrtest when hunting for reference leaks (-R option). Patch by Victor Stinner.

  • gh-117187: Fix XML tests for vanilla Expat <2.6.0.

  • gh-116333: Tests of TLS related things (error codes, etc) were updated to be more lenient about specific error message strings and behaviors as seen in the BoringSSL and AWS-LC forks of OpenSSL.

  • gh-117089: Consolidated tests for importlib.metadata in their own metadata package.

  • gh-115979: Update test_importlib so that it passes under WASI SDK 21.

  • gh-112536: Add –tsan to test.regrtest for running TSAN tests in reasonable execution times. Patch by Donghee Na.

  • gh-116307: Added import helper isolated_modules as CleanImport does not remove modules imported during the context. Use it in importlib.resources tests to avoid leaving mod around to impede importlib.metadata tests.

Build

  • gh-114736: Have WASI builds use WASI SDK 21.

  • gh-115983: Skip building test modules that must be built as shared under WASI.

  • gh-71052: Add Android build script and instructions.

Windows

  • gh-117267: Ensure DirEntry.stat().st_ctime behaves consistently with os.stat() during the deprecation period of st_ctime by containing the same value as st_birthtime. After the deprecation period, st_ctime will be the metadata change time (or unavailable through DirEntry), and only st_birthtime will contain the creation time.

  • gh-116195: Improves performance of os.getppid() by using an alternate system API when available. Contributed by vxiiduu.

  • gh-88494: On Windows, time.monotonic() now uses the QueryPerformanceCounter() clock to have a resolution better than 1 us, instead of the GetTickCount64() clock which has a resolution of 15.6 ms. Patch by Victor Stinner.

  • gh-116773: Fix instances of <_overlapped.Overlapped object at 0xXXX> still has pending operation at deallocation, the process may crash.

  • gh-91227: Fix the asyncio ProactorEventLoop implementation so that sending a datagram to an address that is not listening does not prevent receiving any more datagrams.

  • gh-115119: Switched from vendored libmpdecimal code to a separately-hosted external package in the cpython-source-deps repository when building the _decimal module.

C API

  • gh-117642: Fix PEP 737 implementation for %#T and %#N.

  • gh-87193: _PyBytes_Resize() can now be called for bytes objects with reference count > 1, including 1-byte bytes objects. It creates a new bytes object and destroys the old one if it has reference count > 1.

  • gh-117021: Fix integer overflow in PyLong_AsPid() on non-Windows 64-bit platforms.

  • gh-115756: PyCode_GetFirstFree() is an ustable API now and has been renamed to PyUnstable_Code_GetFirstFree(). (Contributed by Bogdan Romanyuk in gh-115781)

  • gh-116869: Add test_cext test: build a C extension to check if the Python C API emits C compiler warnings. Patch by Victor Stinner.

  • gh-116869: Make the C API compatible with -Werror=declaration-after-statement compiler flag again. Patch by Victor Stinner.

  • gh-116936: Add PyType_GetModuleByDef() to the limited C API. Patch by Victor Stinner.

  • gh-116809: Restore removed private _PyErr_ChainExceptions1() function. Patch by Victor Stinner.

  • gh-115754: In the limited C API version 3.13, getting Py_None, Py_False, Py_True, Py_Ellipsis and Py_NotImplemented singletons is now implemented as function calls at the stable ABI level to hide implementation details. Getting these constants still return borrowed references. Patch by Victor Stinner.

  • gh-115754: Add Py_GetConstant() and Py_GetConstantBorrowed() functions to get constants. For example, Py_GetConstant(Py_CONSTANT_ZERO) returns a strong reference to the constant zero. Patch by Victor Stinner.

  • gh-111696: Add support for %T, %T#, %N and %N# formats to PyUnicode_FromFormat(): format the fully qualified name of an object type and of a type: call PyType_GetModuleName(). See PEP 737 for more information. Patch by Victor Stinner.

  • gh-111696: Add PyType_GetModuleName() function to get the type’s module name. Equivalent to getting the type.__module__ attribute. Patch by Eric Snow and Victor Stinner.

  • gh-111696: Add PyType_GetFullyQualifiedName() function to get the type’s fully qualified name. Equivalent to f"{type.__module__}.{type.__qualname__}", or type.__qualname__ if type.__module__ is not a string or is equal to "builtins". Patch by Victor Stinner.

  • gh-85283: The fcntl, grp, pwd, termios, _statistics and _testconsole C extensions are now built with the limited C API. Patch by Victor Stinner.

  • gh-111140: Add additional flags to PyLong_AsNativeBytes() and PyLong_FromNativeBytes() to allow the caller to determine how to handle edge cases around values that fill the entire buffer.

  • gh-113024: Add PyObject_GenericHash() function.

Python 3.13.0 alpha 5

Release date: 2024-03-12

Security

Core and Builtins

  • gh-116604: Respect the status of the garbage collector when indirect calls are made via PyErr_CheckSignals() and the evaluation breaker. Patch by Pablo Galindo

  • gh-112087: list is now compatible with the implementation of PEP 703.

  • gh-116381: Add specialization for CONTAINS_OP.

  • gh-116296: Fix possible refleak in object.__reduce__() internal error handling.

  • gh-115823: Properly calculate error ranges in the parser when raising SyntaxError exceptions caused by invalid byte sequences. Patch by Pablo Galindo

  • gh-115778: Add tierN annotation for instruction definition in interpreter DSL.

  • gh-115733: Fix crash when calling next() on exhausted list iterators.

  • gh-115700: The regen-cases build stage now works on Windows.

  • gh-115347: Fix bug where docstring was replaced by a redundant NOP when Python is run with -OO.

  • gh-115323: Make error message more meaningful for when bytearray.extend() is called with a str object.

  • gh-112175: Every PyThreadState now has its own eval_breaker, allowing specific threads to be interrupted.

  • gh-115154: Fix a bug that was causing the tokenize.untokenize() function to handle unicode named literals incorrectly. Patch by Pablo Galindo

  • gh-112433: Add ability to force alignment of ctypes.Structure by way of the new _align_ attribute on the class.

  • gh-104090: The multiprocessing resource tracker now exits with non-zero status code if a resource leak was detected. It still exits with status code 0 otherwise.

  • gh-105858: Improve the constructors for ast nodes. Arguments of list types now default to an empty list if omitted, and optional fields default to None. AST nodes now have an __annotations__ attribute with the expected types of their attributes. Passing unrecognized extra arguments to AST nodes is deprecated and will become an error in Python 3.15. Omitting a required argument to an AST node is deprecated and will become an error in Python 3.15. Patch by Jelle Zijlstra.

  • gh-101860: Expose __name__ attribute on property.

  • gh-96497: Fix incorrect resolution of mangled class variables used in assignment expressions in comprehensions.

Library

  • gh-116600: Fix repr() for global Flag members.

  • gh-116349: platform.java_ver() is deprecated and will be removed in 3.15. It was largely untested, had a confusing API, and was only useful for Jython support.

  • gh-116143: Fix a race in pydoc _start_server, eliminating a window in which _start_server can return a thread that is «serving» but without a docserver set.

  • gh-116127: typing: implement PEP 705 which adds typing.ReadOnly support to typing.TypedDict.

  • gh-116325: typing: raise SyntaxError instead of AttributeError on forward references as empty strings.

  • gh-115957: When asyncio.TaskGroup.create_task is called on an inactive asyncio.TaskGroup, the given coroutine will be closed (which prevents a RuntimeWarning).

  • gh-115978: Disable preadv(), readv(), pwritev(), and writev() on WASI.

    Under wasmtime for WASI 0.2, these functions don’t pass test_posix (https://github.com/bytecodealliance/wasmtime/issues/7830).

  • gh-88352: Fix the computation of the next rollover time in the logging.TimedRotatingFileHandler handler. computeRollover() now always returns a timestamp larger than the specified time and works correctly during the DST change. doRollover() no longer overwrite the already rolled over file, saving from data loss when run at midnight or during repeated time at the DST change.

  • gh-87115: Set __main__.__spec__ to None when running a script with pdb

  • gh-76511: Fix UnicodeEncodeError in email.Message.as_string() that results when a message that claims to be in the ascii character set actually has non-ascii characters. Non-ascii characters are now replaced with the U+FFFD replacement character, like in the replace error handler.

  • gh-89547: Add support for nested typing special forms like Final[ClassVar[int]].

  • gh-65824: Improve the less prompt in pydoc.

  • gh-116040: [Enum] fix by-value calls when second value is falsey; e.g. Cardinal(1, 0)

  • gh-115821: [Enum] Improve error message when calling super().__new__() in custom __new__.

  • gh-85644: Use the XDG_CURRENT_DESKTOP environment variable in webbrowser to check desktop. Prefer it to the deprecated GNOME_DESKTOP_SESSION_ID for GNOME detection.

  • gh-75988: Fixed unittest.mock.create_autospec() to pass the call through to the wrapped object to return the real result.

  • gh-115881: Fix issue where ast.parse() would incorrectly flag conditional context managers (such as with (x() if y else z()): ...) as invalid syntax if feature_version=(3, 8) was passed. This reverts changes to the grammar made as part of gh-94949.

  • gh-115886: Fix silent truncation of the name with an embedded null character in multiprocessing.shared_memory.SharedMemory.

  • gh-115532: Add kernel density estimation to the statistics module.

  • gh-115714: On WASI, the time module no longer get process time using times() or CLOCK_PROCESS_CPUTIME_ID, system API is that is unreliable and is likely to be removed from WASI. The affected clock functions fall back to calling clock().

  • gh-115809: Improve algorithm for computing which rolled-over log files to delete in logging.TimedRotatingFileHandler. It is now reliable for handlers without namer and with arbitrary deterministic namer that leaves the datetime part in the file name unmodified.

  • gh-74668: urllib.parse functions parse_qs() and parse_qsl() now support bytes arguments containing raw and percent-encoded non-ASCII data.

  • gh-67044: csv.writer() now always quotes or escapes '\r' and '\n', regardless of lineterminator value.

  • gh-115712: Restore support of space delimiter with skipinitialspace=True in csv. csv.writer() now quotes empty fields if delimiter is a space and skipinitialspace is true and raises exception if quoting is not possible.

  • gh-112364: Fixed ast.unparse() to handle format_spec with ", ' or \\. Patched by Frank Hoffmann.

  • gh-112997: Stop logging potentially sensitive callback arguments in asyncio unless debug mode is active.

  • gh-114914: Fix an issue where an abandoned StreamWriter would not be garbage collected.

  • gh-111358: Fix a bug in asyncio.BaseEventLoop.shutdown_default_executor() to ensure the timeout passed to the coroutine behaves as expected.

  • gh-115618: Fix improper decreasing the reference count for None argument in property methods getter(), setter() and deleter().

  • gh-112720: Refactor dis.ArgResolver to make it possible to subclass and change the way jump args are interpreted.

  • gh-112006: Fix inspect.unwrap() for types with the __wrapper__ data descriptor. Fix inspect.Signature.from_callable() for builtins classmethod() and staticmethod().

  • gh-101293: Support callables with the __call__() method and types with __new__() and __init__() methods set to class methods, static methods, bound methods, partial functions, and other types of methods and descriptors in inspect.Signature.from_callable().

  • gh-103092: Isolate _lsprof (apply PEP 687).

  • gh-113942: pydoc no longer skips global functions implemented as builtin methods, such as MethodDescriptorType and WrapperDescriptorType.

  • gh-115256: Added DeprecationWarning when accessing the tarfile attribute of TarInfo objects. The attribute is never used internally and is only attached to TarInfos when the tarfile is opened in write-mode, not read-mode. The attribute creates an unnecessary reference cycle which may cause corruption when not closing the handle after writing a tarfile.

  • gh-115197: urllib.request no longer resolves the hostname before checking it against the system’s proxy bypass list on macOS and Windows.

  • gh-113812: DatagramTransport.sendto() will now send zero-length datagrams if called with an empty bytes object. The transport flow control also now accounts for the datagram header when calculating the buffer size.

  • gh-114763: Protect modules loaded with importlib.util.LazyLoader from race conditions when multiple threads try to access attributes before the loading is complete.

  • gh-114709: posixpath.commonpath() now raises a ValueError exception when passed an empty iterable. Previously, IndexError was raised.

    posixpath.commonpath() now raises a TypeError exception when passed None. Previously, ValueError was raised.

  • gh-114610: Fix bug where pathlib.PurePath.with_stem() converted a non-empty path suffix to a stem when given an empty stem argument. It now raises ValueError, just like pathlib.PurePath.with_suffix() does when called on a path with an empty stem, given a non-empty suffix argument.

  • gh-107361: Add ssl.VERIFY_X509_PARTIAL_CHAIN and VERIFY_X509_STRICT to the default SSL context created with ssl.create_default_context().

  • gh-112281: Allow creating union of types for typing.Annotated with unhashable metadata.

  • gh-111775: Fix importlib.resources.simple.ResourceHandle.open() for text mode, added missed stream argument.

  • gh-90095: Make .pdbrc and -c work with any valid pdb commands.

  • gh-107625: Raise configparser.ParsingError from read() and read_file() methods of configparser.ConfigParser if a key without a corresponding value is continued (that is, followed by an indented line).

  • gh-107155: Fix incorrect output of help(x) where x is a lambda function, which has an __annotations__ dictionary attribute with a "return" key.

  • gh-57141: Add option for non-shallow comparisons to filecmp.dircmp like filecmp.cmp(). Original patch by Steven Ward. Enhanced by Tobias Rautenkranz

  • gh-69990: Profile.print_stats() has been improved to accept multiple sort arguments. Patched by Chiu-Hsiang Hsu and Furkan Onder.

  • gh-104061: Add socket.SO_BINDTOIFINDEX constant.

  • gh-60346: Fix ArgumentParser inconsistent with parse_known_args.

  • gh-102389: Add windows_31j to aliases for cp932 codec

  • gh-72249: functools.partial`s of :func:`repr() has been improved to include the module name. Patched by Furkan Onder and Anilyka Barry.

  • gh-100985: Update HTTPSConnection to consistently wrap IPv6 Addresses when using a proxy.

  • gh-100884: email: fix misfolding of comma in address-lists over multiple lines in combination with unicode encoding.

  • gh-95782: Fix io.BufferedReader.tell(), io.BufferedReader.seek(), _pyio.BufferedReader.tell(), io.BufferedRandom.tell(), io.BufferedRandom.seek() and _pyio.BufferedRandom.tell() being able to return negative offsets.

  • gh-96310: Fix a traceback in argparse when all options in a mutually exclusive group are suppressed.

  • gh-93205: Fixed a bug in logging.handlers.TimedRotatingFileHandler where multiple rotating handler instances pointing to files with the same name but different extensions would conflict and not delete the correct files.

  • bpo-31116: Add Z85 encoding to base64.

  • bpo-44865: Add missing call to localization function in argparse.

  • bpo-43952: Fix multiprocessing.connection.Listener.accept() to accept empty bytes as authkey. Not accepting empty bytes as key causes it to hang indefinitely.

  • bpo-42125: linecache: get module name from __spec__ if available. This allows getting source code for the __main__ module when a custom loader is used.

  • bpo-41122: Failing to pass arguments properly to functools.singledispatchmethod() now throws a TypeError instead of hitting an index out of bounds internally.

  • bpo-40818: The asyncio REPL now runs sys.__interactivehook__ on startup. The default implementation of sys.__interactivehook__ provides auto-completion to the asyncio REPL. Patch contributed by Rémi Lapeyre.

  • bpo-33775: Add “default” and “version” help text for localization in argparse.

Documentation

Tests

  • gh-71052: Add test exclusions to support running the test suite on Android.

  • gh-71052: Enable test_concurrent_futures on platforms that support threading but not multiprocessing.

  • gh-115796: Make “_testinternalcapi.assemble_code_object” construct the exception table for the code object.

  • gh-115720: Leak tests (-R, --huntrleaks) now show a summary of the number of leaks found in each iteration.

  • gh-115122: Add --bisect option to regrtest test runner: run failed tests with test.bisect_cmd to identify failing tests. Patch by Victor Stinner.

  • gh-115596: Fix ProgramPriorityTests in test_os permanently changing the process priority.

  • gh-115556: On Windows, commas passed in arguments to Tools\buildbot\test.bat and PCbuild\\rt.bat are now properly handled.

  • gh-115420: Fix translation of exception handler targets by _testinternalcapi.optimize_cfg.

  • gh-115376: Fix segfault in _testinternalcapi.compiler_codegen on bad input.

Build

  • gh-116313: Get WASI builds to work under wasmtime 18 w/ WASI 0.2/preview2 primitives.

  • gh-71052: Change Android’s sys.platform from "linux" to "android".

  • gh-116117: Backport libb2’s PR #42 to fix compiling CPython on 32-bit Windows with clang-cl.

  • gh-71052: Fix several Android build issues

  • gh-114099: A testbed project was added to run the test suite on iOS.

  • gh-115350: Fix building ctypes module with -DWIN32_LEAN_AND_MEAN defined

  • gh-111225: Link extension modules against libpython on Android.

  • gh-115737: The install name for libPython is now correctly set for non-framework macOS builds.

  • gh-114099: Makefile targets were added to support compiling an iOS-compatible framework build.

Windows

  • gh-116012: Ensure the value of GetLastError() is preserved across GIL operations.

  • gh-115582: Building extensions intended for free-threaded builds of CPython now require compiling with /DPy_GIL_DISABLED manually when using a regular install. This is expected to change in future releases.

  • gh-115554: The installer now has more strict rules about updating the Python Install Manager. In general, most users only have a single launcher installed and will see no difference. When multiple launchers have been installed, the option to install the launcher is disabled until all but one have been removed. Downgrading the launcher (which was never allowed) is now more obviously blocked.

  • gh-115543: Python Install Manager can now detect Python 3.13 when installed from the Microsoft Store, and will install Python 3.12 by default when PYLAUNCHER_ALLOW_INSTALL is set.

macOS

  • gh-116145: Update macOS installer to Tcl/Tk 8.6.14.

IDLE

  • gh-88516: On macOS show a proxy icon in the title bar of editor windows to match platform behaviour.

Tools/Demos

  • gh-100176: Remove outdated Tools/{io,cc,string}bench

  • bpo-45101: Add consistency in usage message IO between 2 versions of python-config.

C API

  • gh-114626: Add again _PyCFunctionFastWithKeywords name, removed in Python 3.13 alpha 4 by mistake. Keep the old private _PyCFunctionFastWithKeywords name (Python 3.7) as an alias to the new public name PyCFunctionFastWithKeywords (Python 3.13a4). Patch by Victor Stinner.

  • gh-111418: Add PyHASH_MODULUS, PyHASH_BITS, PyHASH_INF and PyHASH_IMAG C macros. Patch by Sergey B Kirpichev.

Python 3.13.0 alpha 4

Release date: 2024-02-15

Security

Core and Builtins

  • gh-112087: For an empty reverse iterator for list will be reduced to reversed(). Patch by Donghee Na

  • gh-114570: Add PythonFinalizationError exception. This exception derived from RuntimeError is raised when an operation is blocked during the Python finalization. Patch by Victor Stinner.

  • gh-114695: Add sys._clear_internal_caches(), which clears all internal performance-related caches (and deprecate the less-general sys._clear_type_cache() function).

  • gh-114828: Fix compilation crashes in uncommon code examples using super() inside a comprehension in a class body.

  • gh-112069: Adapt set and frozenset methods to Argument Clinic.

  • gh-115011: Setters for members with an unsigned integer type now support the same range of valid values for objects that has a __index__() method as for int.

  • gh-114887: Changed socket type validation in create_datagram_endpoint() to accept all non-stream sockets. This fixes a regression in compatibility with raw sockets.

  • gh-114944: Fixes a race between PyParkingLot_Park and _PyParkingLot_UnparkAll.

  • gh-113462: Limit the number of versions that a single class can use. Prevents a few wayward classes using up all the version numbers.

  • gh-76763: The chr() builtin function now always raises ValueError for values outside the valid range. Previously it raised OverflowError for very large or small values.

  • gh-114806: No longer specialize calls to classes, if those classes have metaclasses. Fixes bug where the __call__ method of the metaclass was not being called.

  • gh-107944: Improve error message for function calls with bad keyword arguments via getargs

  • gh-112529: The free-threaded build no longer allocates space for the PyGC_Head structure in objects that support cyclic garbage collection. A number of other fields and data structures are used as replacements, including ob_gc_bits, ob_tid, and mimalloc internal data structures.

  • gh-114456: Lower the recursion limit under a debug build of WASI.

  • gh-114083: Compiler applies folding of LOAD_CONST with following instruction in a separate pass before other optimisations. This enables jump threading in certain circumstances.

  • gh-114388: Fix a RuntimeWarning emitted when assign an integer-like value that is not an instance of int to an attribute that corresponds to a C struct member of type T_UINT and T_ULONG. Fix a double RuntimeWarning emitted when assign a negative integer value to an attribute that corresponds to a C struct member of type T_UINT.

  • gh-114265: Compiler propagates line numbers before optimization, leading to more optimization opportunities and removing the need for the guarantee_lineno_for_exits hack.

  • gh-112529: The free-threaded build now has its own thread-safe GC implementation that uses mimalloc to find GC tracked objects. It is non-generational, unlike the existing GC implementation.

  • gh-114050: Fix segmentation fault caused by an incorrect format string in TypeError exception when more than two arguments are passed to int.

  • gh-112354: The END_FOR instruction now pops only one value. This is to better support side exits in loops.

  • gh-113884: Make queue.SimpleQueue thread safe when the GIL is disabled.

  • gh-114058: Implement the foundations of the Tier 2 redundancy eliminator.

  • gh-113939: frame.clear(): Clear frame.f_locals as well, and not only the fast locals. This is relevant once frame.f_locals was accessed, which would contain also references to all the locals.

  • gh-112050: Convert collections.deque to use Argument Clinic.

  • gh-112050: Make methods on collections.deque thread-safe when the GIL is disabled.

  • gh-113464: Add an option (--enable-experimental-jit for configure-based builds or --experimental-jit for PCbuild-based ones) to build an experimental just-in-time compiler, based on copy-and-patch

  • gh-113055: Make interp->obmalloc a pointer. For interpreters that share state with the main interpreter, this points to the same static memory structure. For interpreters with their own obmalloc state, it is heap allocated. Add free_obmalloc_arenas() which will free the obmalloc arenas and radix tree structures for interpreters with their own obmalloc state.

  • gh-55664: Add warning when creating type using a namespace dictionary with non-string keys. Patched by Daniel Urban and Furkan Onder.

  • gh-104530: Use native Win32 condition variables.

Library

  • gh-115392: Fix a bug in doctest where incorrect line numbers would be reported for decorated functions.

  • gh-114563: Fix several format() bugs when using the C implementation of Decimal: * memory leak in some rare cases when using the z format option (coerce negative 0) * incorrect output when applying the z format option to type F (fixed-point with capital NAN / INF) * incorrect output when applying the # format option (alternate form)

  • gh-102840: Fix confused traceback when floordiv, mod, or divmod operations happens between instances of fractions.Fraction and complex.

  • gh-115165: Most exceptions are now ignored when attempting to set the __orig_class__ attribute on objects returned when calling typing generic aliases (including generic aliases created using typing.Annotated). Previously only AttributeError was ignored. Patch by Dave Shawley.

  • gh-112903: Fix «issubclass() arg 1 must be a class» errors in certain cases of multiple inheritance with generic aliases (regression in early 3.13 alpha releases).

  • gh-115133: Fix tests for XMLPullParser with Expat 2.6.0.

  • gh-115059: io.BufferedRandom.read1() now flushes the underlying write buffer.

  • gh-79382: Trailing ** no longer allows to match files and non-existing paths in recursive glob().

  • gh-67837: Avoid race conditions in the creation of directories during concurrent extraction in tarfile and zipfile.

  • gh-115060: Speed up pathlib.Path.glob() by removing redundant regex matching.

  • gh-97928: Partially revert the behavior of tkinter.Text.count(). By default it preserves the behavior of older Python versions, except that setting wantobjects to 0 no longer has effect. Add a new parameter return_ints: specifying return_ints=True makes Text.count() always returning the single count as an integer instead of a 1-tuple or None.

  • gh-114628: When csv.Error is raised when handling TypeError, do not print the TypeError traceback.

  • gh-85984: Added _POSIX_VDISABLE from C’s <unistd.h> to termios.

  • gh-114965: Update bundled pip to 24.0

  • gh-114959: tarfile no longer ignores errors when trying to extract a directory on top of a file.

  • gh-114894: Add array.array.clear().

  • gh-114071: Support tuple subclasses using auto() for enum member value.

  • gh-109475: Fix support of explicit option value «–» in argparse (e.g. --option=--).

  • gh-49766: Fix date-datetime comparison. Now the special comparison methods like __eq__ and __lt__ return NotImplemented if one of comparands is date and other is datetime instead of ignoring the time part and the time zone or forcefully return «not equal» or raise TypeError. It makes comparison of date and datetime subclasses more symmetric and allows to change the default behavior by overriding the special comparison methods in subclasses.

  • gh-110190: Fix ctypes structs with array on Windows ARM64 platform by setting MAX_STRUCT_SIZE to 32 in stgdict. Patch by Diego Russo

  • gh-114678: Ensure that deprecation warning for “N” specifier in Decimal format is not raised for cases where “N” appears in other places in the format specifier. Based on patch by Stefan Krah.

  • gh-70303: Return both files and directories from pathlib.Path.glob() if a pattern ends with «**». Previously only directories were returned.

  • gh-109653: Improve import time of importlib.metadata and email.utils.

  • gh-113280: Fix a leak of open socket in rare cases when error occurred in ssl.SSLSocket creation.

  • gh-77749: email.policy.EmailPolicy.fold() now always encodes non-ASCII characters in headers if utf8 is false.

  • gh-83383: Synchronization of the dbm.dumb database is now no-op if there was no modification since opening or last synchronization. The directory file for a newly created empty dbm.dumb database is now created immediately after opening instead of deferring this until synchronizing or closing.

  • gh-91602: Add filter keyword-only parameter to sqlite3.Connection.iterdump() for filtering database objects to dump. Patch by Mariusz Felisiak.

  • gh-112451: Prohibit subclassing pure-Python datetime.timezone. This is consistent with C-extension implementation. Patch by Mariusz Felisiak.

  • gh-69893: Add the close() method for the iterator returned by xml.etree.ElementTree.iterparse().

  • gh-109653: Reduce the import time of threading module by ~50%. Patch by Daniel Hollas.

  • gh-114492: Make the result of termios.tcgetattr() reproducible on Alpine Linux. Previously it could leave a random garbage in some fields.

  • gh-114315: Make threading.Lock a real class, not a factory function. Add __new__ to _thread.lock type.

  • gh-100414: Add dbm.sqlite3 as a backend to dbm, and make it the new default dbm backend. Patch by Raymond Hettinger and Erlend E. Aasland.

  • gh-113267: Revert changes in gh-106584 which made calls of TestResult methods startTest() and stopTest() unbalanced.

  • gh-75128: Ignore an OSError in asyncio.BaseEventLoop.create_server() when IPv6 is available but the interface cannot actually support it.

  • gh-114423: _DummyThread entries in threading._active are now automatically removed when the related thread dies.

  • gh-114257: Dismiss the FileNotFound error in ctypes.util.find_library() and just return None on Linux.

  • gh-114321: Expose more platform specific constants in the fcntl module on Linux, macOS, FreeBSD and NetBSD.

  • gh-114328: The tty.setcbreak() and new tty.cfmakecbreak() no longer clears the terminal input ICRLF flag. This fixes a regression introduced in 3.12 that no longer matched how OSes define cbreak mode in their stty(1) manual pages.

  • gh-114281: Remove type hints from Lib/asyncio/staggered.py. The annotations in the typeshed project should be used instead.

  • gh-101438: Avoid reference cycle in ElementTree.iterparse. The iterator returned by ElementTree.iterparse may hold on to a file descriptor. The reference cycle prevented prompt clean-up of the file descriptor if the returned iterator was not exhausted.

  • gh-114198: The signature for the __replace__ method on dataclasses now has the first argument named self, rather than obj.

  • gh-104522: OSError raised when run a subprocess now only has filename attribute set to cwd if the error was caused by a failed attempt to change the current directory.

  • gh-114149: Enum: correctly handle tuple subclasses in custom __new__.

  • gh-83648: Support deprecation of options, positional arguments and subcommands in argparse.

  • gh-114087: Speed up dataclasses.asdict up to 1.35x.

  • gh-109534: Fix a reference leak in asyncio.selector_events.BaseSelectorEventLoop when SSL handshakes fail. Patch contributed by Jamie Phan.

  • gh-79634: Accept path-like objects as patterns in pathlib.Path.glob() and rglob().

  • gh-112202: Ensure that a asyncio.Condition.notify() call does not get lost if the awakened Task is simultaneously cancelled or encounters any other error.

  • gh-113951: Fix the behavior of tag_unbind() methods of tkinter.Text and tkinter.Canvas classes with three arguments. Previously, widget.tag_unbind(tag, sequence, funcid) destroyed the current binding for sequence, leaving sequence unbound, and deleted the funcid command. Now it removes only funcid from the binding for sequence, keeping other commands, and deletes the funcid command. It leaves sequence unbound only if funcid was the last bound command.

  • gh-97959: Fix rendering class methods, bound methods, method and function aliases in pydoc. Class methods no longer have «method of builtins.type instance» note. Corresponding notes are now added for class and unbound methods. Method and function aliases now have references to the module or the class where the origin was defined if it differs from the current. Bound methods are now listed in the static methods section. Methods of builtin classes are now supported as well as methods of Python classes.

  • gh-113796: Add more validation checks in the csv.Dialect constructor. ValueError is now raised if the same character is used in different roles.

  • gh-113732: Fix support of QUOTE_NOTNULL and QUOTE_STRINGS in csv.reader().

  • gh-113225: Speed up pathlib.Path.walk() by using os.DirEntry.path where possible.

  • gh-89039: When replace() method is called on a subclass of datetime, date or time, properly call derived constructor. Previously, only the base class’s constructor was called.

    Also, make sure to pass non-zero fold values when creating subclasses in various methods. Previously, fold was silently ignored.

  • gh-112919: Speed-up datetime.datetime.replace(), datetime.date.replace() and datetime.time.replace().

  • gh-59013: Set breakpoint on the first executable line of the function, instead of the line of function definition when the user do break func using pdb

  • gh-112343: Improve handling of pdb convenience variables to avoid replacing string contents.

  • gh-112240: Add option to calendar module CLI to specify the weekday to start each week. Patch by Steven Ward.

  • gh-111741: Recognise image/webp as a standard format in the mimetypes module.

  • gh-43457: Fix the tkinter widget method wm_attributes(). It now accepts the attribute name without the minus prefix to get window attributes and allows to specify attributes and values to set as keyword arguments. Add new optional keyword argument return_python_dict: calling w.wm_attributes(return_python_dict=True) returns the attributes as a dict instead of a tuple. Calling w.wm_attributes() now returns a tuple instead of string if wantobjects was set to 0.

  • gh-82626: Many functions now emit a warning if a boolean value is passed as a file descriptor argument.

  • gh-111051: Added check for file modification during debugging with pdb

  • gh-110345: Show the Tcl/Tk patchlevel (rather than version) in tkinter._test().

  • gh-38807: Fix race condition in trace. Instead of checking if a directory exists and creating it, directly call os.makedirs() with the kwarg exist_ok=True.

  • gh-75705: Set unixfrom envelope in mailbox.mbox and mailbox.MMDF.

  • gh-106233: Fix stacklevel in InvalidTZPathWarning during zoneinfo module import.

  • gh-105102: Allow ctypes.Union to be nested in ctypes.Structure when the system endianness is the opposite of the classes.

  • gh-104282: Fix null pointer dereference in lzma._decode_filter_properties() due to improper handling of BCJ filters with properties of zero length. Patch by Radislav Chugunov.

  • gh-96471: Add queue.Queue termination with shutdown().

  • gh-101599: Changed argparse flag options formatting to remove redundancy.

  • gh-85984: Add POSIX pseudo-terminal functions os.posix_openpt(), os.grantpt(), os.unlockpt(), and os.ptsname().

  • gh-102512: When os.fork() is called from a foreign thread (aka _DummyThread), the type of the thread in a child process is changed to _MainThread. Also changed its name and daemonic status, it can be now joined.

  • gh-88569: Add os.path.isreserved(), which identifies reserved pathnames such as «NUL», «AUX» and «CON». This function is only available on Windows.

    Deprecate pathlib.PurePath.is_reserved().

  • bpo-38364: The inspect functions isgeneratorfunction, iscoroutinefunction, isasyncgenfunction now support functools.partialmethod wrapped functions the same way they support functools.partial.

Documentation

  • gh-115233: Fix an example for LoggerAdapter in the Logging Cookbook.

  • gh-114123: Move the csv module docstring to the csv module instead of reexporting it from the internal _csv module, and remove __doc__ from csv.__all__.

    Move csv.__version__ to the csv module instead of reexporting it from the internal _csv module, and remove __version__ from csv.__all__.

Tests

  • gh-114099: Added test exclusions required to run the test suite on iOS.

  • gh-105089: Fix test.test_zipfile.test_core.TestWithDirectory.test_create_directory_with_write test in AIX by doing a bitwise AND of 0xFFFF on mode , so that it will be in sync with zinfo.external_attr

Build

  • gh-115167: Avoid vendoring vcruntime140_threads.dll when building with Visual Studio 2022 version 17.8.

  • gh-113632: Promote WASI to a tier 2 platform and drop Emscripten from tier 3 in configure.ac.

  • gh-114099: configure and Makefile were refactored to accommodate framework builds on Apple platforms other than macOS.

  • gh-114875: Add getgrent() as a prerequisite for building the grp module.

Windows

  • gh-115049: Fixes py.exe launcher failing when run as users without user profiles.

  • gh-115009: Update Windows installer to use SQLite 3.45.1.

  • gh-109991: Update Windows build to use OpenSSL 3.0.13.

  • gh-111239: Update Windows builds to use zlib v1.3.1.

  • gh-100107: The py.exe launcher will no longer attempt to run the Microsoft Store redirector when launching a script containing a /usr/bin/env shebang

  • gh-112984: Adds free-threaded binaries to Windows installer as an optional component.

  • gh-89240: Allows multiprocessing to create pools of greater than 62 processes.

macOS

  • gh-115009: Update macOS installer to use SQLite 3.45.1.

  • gh-109991: Update macOS installer to use OpenSSL 3.0.13.

  • gh-114490: Add Mach-O linkage support for platform.architecture().

  • gh-87804: On macOS the result of os.statvfs and os.fstatvfs now correctly report the size of very large disks, in previous versions the reported number of blocks was wrong for disks with at least 2**32 blocks.

IDLE

  • gh-96905: In idlelib code, stop redefining built-ins “dict” and “object”.

  • gh-103820: Revise IDLE bindings so that events from mouse button 4/5 on non-X11 windowing systems (i.e. Win32 and Aqua) are not mistaken for scrolling.

Tools/Demos

  • gh-113516: Don’t set LDSHARED when building for WASI.

  • gh-109991: Update GitHub CI workflows to use OpenSSL 3.0.13 and multissltests to use 1.1.1w, 3.0.13, 3.1.5, and 3.2.1.

  • gh-115015: Fix a bug in Argument Clinic that generated incorrect code for methods with no parameters that use the METH_METHOD | METH_FASTCALL | METH_KEYWORDS calling convention. Only the positional parameter count was checked; any keyword argument passed would be silently accepted.

C API

Python 3.13.0 alpha 3

Release date: 2024-01-17

Security

  • gh-113659: Skip .pth files with names starting with a dot or hidden file attribute.

  • gh-112302: Created a Software Bill-of-Materials document and tooling for tracking dependencies.

Core and Builtins

  • gh-107901: Compiler duplicates basic blocks that have an eval breaker check, no line number, and multiple predecessors.

  • gh-107901: A jump leaving an exception handler back to normal code no longer checks the eval breaker.

  • gh-113655: Set the C recursion limit to 4000 on Windows, and 10000 on Linux/OSX. This seems to be near the sweet spot to maintain safety, but not compromise backwards compatibility.

  • gh-113710: Add typed stack effects to the interpreter DSL, along with various instruction annotations.

  • gh-77046: On Windows, file descriptors wrapping Windows handles are now created non inheritable by default (PEP 446). Patch by Zackery Spytz and Victor Stinner.

  • gh-113853: Guarantee that all executors make progress. This then guarantees that tier 2 execution always makes progress.

  • gh-113753: Fix an issue where the finalizer of PyAsyncGenASend objects might not be called if they were allocated from a free list.

  • gh-107901: Compiler changed so that synthetic jumps which are not at loop end no longer check the eval breaker.

  • gh-113703: Fix a regression in the codeop module that was causing it to incorrectly identify incomplete f-strings. Patch by Pablo Galindo

  • gh-89811: Check for a valid tp_version_tag before performing bytecode specializations that rely on this value being usable.

  • gh-111488: Changed error message in case of no “in” keyword after “for” in list comprehensions

  • gh-113657: Fix an issue that caused important instruction pointer updates to be optimized out of tier two traces.

  • gh-113603: Fixed bug where a redundant NOP is not removed, causing an assertion to fail in the compiler in debug mode.

  • gh-113602: Fix an error that was causing the parser to try to overwrite existing errors and crashing in the process. Patch by Pablo Galindo

  • gh-113486: No longer issue spurious PY_UNWIND events for optimized calls to classes.

  • gh-113297: Fix segfault in the compiler on with statement with 19 context managers.

  • gh-113212: Improve super error messages.

  • gh-111375: Only use NULL in the exception stack to indicate an exception was handled. Patch by Carey Metcalfe.

  • gh-112215: Increase the C recursion limit by a factor of 3 for non-debug builds, except for webassembly and s390 platforms which are unchanged. This mitigates some regressions in 3.12 with deep recursion mixing builtin (C) and Python code.

  • gh-113054: Fixed bug where a redundant NOP is not removed, causing an assertion to fail in the compiler in debug mode.

  • gh-106905: Use per AST-parser state rather than global state to track recursion depth within the AST parser to prevent potential race condition due to simultaneous parsing.

    The issue primarily showed up in 3.11 by multithreaded users of ast.parse(). In 3.12 a change to when garbage collection can be triggered prevented the race condition from occurring.

  • gh-108866: Change the API and contract of _PyExecutorObject to return the next_instr pointer, instead of the frame, and to always execute at least one instruction.

  • gh-90350: Optimize builtin functions min() and max().

  • gh-112943: Correctly compute end column offsets for multiline tokens in the tokenize module. Patch by Pablo Galindo

  • gh-112125: Fix None.__ne__(None) returning NotImplemented instead of False.

  • gh-74616: input() now raises a ValueError when output on the terminal if the prompt contains embedded null characters instead of silently truncating it.

  • gh-112716: Fix SystemError in the import statement and in __reduce__() methods of builtin types when __builtins__ is not a dict.

  • gh-112730: Use color to highlight error locations in tracebacks. Patch by Pablo Galindo

  • gh-112625: Fixes a bug where a bytearray object could be cleared while iterating over an argument in the bytearray.join() method that could result in reading memory after it was freed.

  • gh-112660: Do not clear unexpected errors during formatting error messages for ImportError and AttributeError for modules.

  • gh-105967: Workaround a bug in Apple’s macOS platform zlib library where zlib.crc32() and binascii.crc32() could produce incorrect results on multi-gigabyte inputs. Including when using zipfile on zips containing large data.

  • gh-95754: Provide a better error message when accessing invalid attributes on partially initialized modules. The origin of the module being accessed is now included in the message to help with the common issue of shadowing other modules.

  • gh-112217: Add check for the type of __cause__ returned from calling the type T in raise from T.

  • gh-111058: Change coro.cr_frame/gen.gi_frame to return None after the coroutine/generator has been closed. This fixes a bug where getcoroutinestate() and getgeneratorstate() return the wrong state for a closed coroutine/generator.

  • gh-112388: Fix an error that was causing the parser to try to overwrite tokenizer errors. Patch by pablo Galindo

  • gh-112387: Fix error positions for decoded strings with backwards tokenize errors. Patch by Pablo Galindo

  • gh-99606: Make code generated for an empty f-string identical to the code of an empty normal string.

  • gh-112367: Avoid undefined behaviour when using the perf trampolines by not freeing the code arenas until shutdown. Patch by Pablo Galindo

  • gh-112320: The Tier 2 translator now tracks the confidence level for staying «on trace» (i.e. not exiting back to the Tier 1 interpreter) for branch instructions based on the number of bits set in the branch «counter». Trace translation ends when the confidence drops below 1/3rd.

  • gh-109598: PyComplex_RealAsDouble()/PyComplex_ImagAsDouble() now tries to convert an object to a complex instance using its __complex__() method before falling back to the __float__() method. Patch by Sergey B Kirpichev.

  • gh-94606: Fix UnicodeEncodeError when email.message.get_payload() reads a message with a Unicode surrogate character and the message content is not well-formed for surrogateescape encoding. Patch by Sidney Markowitz.

  • bpo-21861: Use the object’s actual class name in _io.FileIO.__repr__(), _io._WindowsConsoleIO() and _io.TextIOWrapper.__repr__(), to make these methods subclass friendly.

  • bpo-45369: Remove LibreSSL workarounds as per PEP 644.

  • bpo-34392: Added sys._is_interned().

Library

  • gh-114077: Fix possible OverflowError in socket.socket.sendfile() when pass count larger than 2 GiB on 32-bit platform.

  • gh-111803: plistlib now supports loading more deeply nested lists in binary format.

  • gh-114014: Fixed a bug in fractions.Fraction where an invalid string using d in the decimals part creates a different error compared to other invalid letters/characters. Patch by Jeremiah Gabriel Pascual.

  • gh-108364: sqlite3.Connection.iterdump() now ensures that foreign key support is disabled before dumping the database schema, if there is any foreign key violation. Patch by Erlend E. Aasland and Mariusz Felisiak.

  • gh-113971: The zipfile.ZipInfo previously protected ._compresslevel attribute has been made public as .compress_level with the old _compresslevel name remaining available as a property to retain compatibility.

  • gh-113877: Fix tkinter method winfo_pathname() on 64-bit Windows.

  • gh-113868: Added mmap.MAP_NORESERVE, mmap.MAP_NOEXTEND, mmap.MAP_HASSEMAPHORE, mmap.MAP_NOCACHE, mmap.MAP_JIT, mmap.MAP_RESILIENT_CODESIGN, mmap.MAP_RESILIENT_MEDIA, mmap.MAP_32BIT, mmap.MAP_TRANSLATED_ALLOW_EXECUTE, mmap.MAP_UNIX03 and mmap.MAP_TPRO. All of them are mmap(2) flags on macOS.

  • gh-113848: asyncio.TaskGroup() and asyncio.timeout() context managers now handle CancelledError subclasses as well as exact CancelledError.

  • gh-113661: unittest runner: Don’t exit 5 if tests were skipped. The intention of exiting 5 was to detect issues where the test suite wasn’t discovered at all. If we skipped tests, it was correctly discovered.

  • gh-96037: Insert TimeoutError in the context of the exception that was raised during exiting an expired asyncio.timeout() block.

  • gh-113781: Silence unraisable AttributeError when warnings are emitted during Python finalization.

  • gh-113238: Add Anchor to importlib.resources (in order for the code to comply with the documentation)

  • gh-111693: asyncio.Condition.wait() now re-raises the same CancelledError instance that may have caused it to be interrupted. Fixed race condition in asyncio.Semaphore.acquire() when interrupted with a CancelledError.

  • gh-113791: Add CLOCK_MONOTONIC_RAW_APPROX and CLOCK_UPTIME_RAW_APPROX to time on macOS. These are clocks available on macOS 10.12 or later.

  • gh-112932: Restore the ability for zipfile to extractall from zip files with a «/» directory entry in them as is commonly added to zips by some wiki or bug tracker data exporters.

  • gh-113568: Raise deprecation warnings from pathlib.PurePath and not its private base class PurePathBase.

  • gh-113594: Fix UnicodeEncodeError in email when re-fold lines that contain unknown-8bit encoded part followed by non-unknown-8bit encoded part.

  • gh-113538: In asyncio.StreamReaderProtocol.connection_made(), there is callback that logs an error if the task wrapping the «connected callback» fails. This callback would itself fail if the task was cancelled. Prevent this by checking whether the task was cancelled first. If so, close the transport but don’t log an error.

  • gh-113626: Add support for the allow_code argument in the marshal module. Passing allow_code=False prevents serialization and de-serialization of code objects which is incompatible between Python versions.

  • gh-85567: Fix resource warnings for unclosed files in pickle and pickletools command line interfaces.

  • gh-113537: Support loads str in plistlib.loads().

  • gh-89850: Add default implementations of pickle.Pickler.persistent_id() and pickle.Unpickler.persistent_load() methods in the C implementation. Calling super().persistent_id() and super().persistent_load() in subclasses of the C implementation of pickle.Pickler and pickle.Unpickler classes no longer causes infinite recursion.

  • gh-113569: Indicate if there were no actual calls in unittest assert_has_calls() failure.

  • gh-101225: Increase the backlog for multiprocessing.connection.Listener objects created by multiprocessing.manager and multiprocessing.resource_sharer to significantly reduce the risk of getting a connection refused error when creating a multiprocessing.connection.Connection to them.

  • gh-113568: Raise audit events from pathlib.Path and not its private base class PathBase.

  • gh-113543: Make sure that webbrowser.MacOSXOSAScript sends webbrowser.open audit event.

  • gh-113028: When a second reference to a string appears in the input to pickle, and the Python implementation is in use, we are guaranteed that a single copy gets pickled and a single object is shared when reloaded. Previously, in protocol 0, when a string contained certain characters (e.g. newline) it resulted in duplicate objects.

  • gh-113421: Fix multiprocessing logger for %(filename)s.

  • gh-111784: Fix segfaults in the _elementtree module. Fix first segfault during deallocation of _elementtree.XMLParser instances by keeping strong reference to pyexpat module in module state for capsule lifetime. Fix second segfault which happens in the same deallocation process by keeping strong reference to _elementtree module in XMLParser structure for _elementtree module lifetime.

  • gh-113407: Fix import of unittest.mock when CPython is built without docstrings.

  • gh-113320: Fix regression in Python 3.12 where Protocol classes that were not marked as runtime-checkable would be unnecessarily introspected, potentially causing exceptions to be raised if the protocol had problematic members. Patch by Alex Waygood.

  • gh-53502: Add a new option aware_datetime in plistlib to loads or dumps aware datetime.

  • gh-113358: Fix rendering tracebacks with exceptions with a broken __getattr__

  • gh-113214: Fix an AttributeError during asyncio SSL protocol aborts in SSL-over-SSL scenarios.

  • gh-113246: Update bundled pip to 23.3.2.

  • gh-87264: Fixed tarfile list() method to show file type.

  • gh-112182: asyncio.futures.Future.set_exception() now transforms StopIteration into RuntimeError instead of hanging or other misbehavior. Patch contributed by Jamie Phan.

  • gh-113225: Speed up pathlib.Path.glob() by using os.DirEntry.path where possible.

  • gh-113149: Improve error message when a JSON array or object contains a trailing comma. Patch by Carson Radtke.

  • gh-113117: The subprocess module can now use the os.posix_spawn() function with close_fds=True on platforms where posix_spawn_file_actions_addclosefrom_np is available. Patch by Jakub Kulik.

  • gh-113199: Make http.client.HTTPResponse.read1 and http.client.HTTPResponse.readline close IO after reading all data when content length is known. Patch by Illia Volochii.

  • gh-113191: Add support of os.fchmod() and a file descriptor in os.chmod() on Windows.

  • gh-113188: Fix shutil.copymode() and shutil.copystat() on Windows. Previously they worked differently if dst is a symbolic link: they modified the permission bits of dst itself rather than the file it points to if follow_symlinks is true or src is not a symbolic link, and did not modify the permission bits if follow_symlinks is false and src is a symbolic link.

  • gh-113119: os.posix_spawn() now accepts env=None, which makes the newly spawned process use the current process environment. Patch by Jakub Kulik.

  • gh-113202: Add a strict option to batched() in the itertools module.

  • gh-61648: Detect line numbers of properties in doctests.

  • gh-113175: Sync with importlib_metadata 7.0, including improved type annotations, fixed issue with symlinked packages in package_distributions, added EntryPoints.__repr__, introduced the diagnose script, added Distribution.origin property, and removed deprecated EntryPoint access by numeric index (tuple behavior).

  • gh-59616: Add support of os.lchmod() and the follow_symlinks argument in os.chmod() on Windows. Note that the default value of follow_symlinks in os.lchmod() is False on Windows.

  • gh-112559: signal.signal() and signal.getsignal() no longer call repr on callable handlers. asyncio.run() and asyncio.Runner.run() no longer call repr on the task results. Patch by Yilei Yang.

  • gh-112962: dis module functions add cache information to the Instruction instance rather than creating fake Instruction instances to represent the cache entries.

  • gh-112989: Reduce overhead to connect sockets with asyncio SelectorEventLoop.

  • gh-112970: Use closefrom() on Linux where available (e.g. glibc-2.34), rather than only FreeBSD.

  • gh-110190: Fix ctypes structs with array on PPC64LE platform by setting MAX_STRUCT_SIZE to 64 in stgdict. Patch by Diego Russo.

  • gh-112540: The statistics.geometric_mean() function now returns zero for datasets containing a zero. Formerly, it would raise an exception.

  • gh-87286: Added LOG_FTP, LOG_NETINFO, LOG_REMOTEAUTH, LOG_INSTALL, LOG_RAS, and LOG_LAUNCHD tot the syslog module, all of them constants on used on macOS.

  • gh-112800: Fix asyncio SubprocessTransport.close() not to throw PermissionError when used with setuid executables.

  • gh-51944: Add the following constants to the termios module. These values are present in macOS system headers: ALTWERASE, B14400, B28800, B7200, B76800, CCAR_OFLOW, CCTS_OFLOW, CDSR_OFLOW, CDTR_IFLOW, CIGNORE, CRTS_IFLOW, EXTPROC, IUTF8, MDMBUF, NL2, NL3, NOKERNINFO, ONOEOT, OXTABS, VDSUSP, VSTATUS.

  • gh-79325: Fix an infinite recursion error in tempfile.TemporaryDirectory() cleanup on Windows.

  • gh-94692: shutil.rmtree() now only catches OSError exceptions. Previously a symlink attack resistant version of shutil.rmtree() could ignore or pass to the error handler arbitrary exception when invalid arguments were provided.

  • gh-112736: The use of del-safe symbols in subprocess was refactored to allow for use in cross-platform build environments.

  • gh-112727: Speed up pathlib.Path.absolute(). Patch by Barney Gale.

  • gh-74690: Speedup issubclass() checks against simple runtime-checkable protocols by around 6%. Patch by Alex Waygood.

  • gh-74690: Speedup isinstance() checks by roughly 20% for runtime-checkable protocols that only have one callable member. Speedup issubclass() checks for these protocols by roughly 10%. Patch by Alex Waygood.

  • gh-112645: Remove deprecation error on passing onerror to shutil.rmtree().

  • gh-112640: Add kwdefaults parameter to types.FunctionType to set default keyword argument values.

  • gh-112622: Ensure name parameter is passed to event loop in asyncio.create_task().

  • gh-112618: Fix a caching bug relating to typing.Annotated. Annotated[str, True] is no longer identical to Annotated[str, 1].

  • gh-112334: Fixed a performance regression in 3.12’s subprocess on Linux where it would no longer use the fast-path vfork() system call when it could have due to a logic bug, instead falling back to the safe but slower fork().

    Also fixed a second 3.12.0 potential security bug. If a value of extra_groups=[] was passed to subprocess.Popen or related APIs, the underlying setgroups(0, NULL) system call to clear the groups list would not be made in the child process prior to exec().

    This was identified via code inspection in the process of fixing the first bug.

  • gh-110190: Fix ctypes structs with array on Arm platform by setting MAX_STRUCT_SIZE to 32 in stgdict. Patch by Diego Russo.

  • gh-81194: Fix a crash in socket.if_indextoname() with specific value (UINT_MAX). Fix an integer overflow in socket.if_indextoname() on 64-bit non-Windows platforms.

  • gh-112578: Fix a spurious RuntimeWarning when executing the zipfile module.

  • gh-112516: Update the bundled copy of pip to version 23.3.1.

  • gh-112510: Add readline.backend for the backend readline uses (editline or readline)

  • gh-112328: [Enum] Make EnumDict, EnumDict.member_names, EnumType._add_alias_ and EnumType._add_value_alias_ public.

  • gh-112509: Fix edge cases that could cause a key to be present in both the __required_keys__ and __optional_keys__ attributes of a typing.TypedDict. Patch by Jelle Zijlstra.

  • gh-101336: Add keep_alive keyword parameter for AbstractEventLoop.create_server() and BaseEventLoop.create_server().

  • gh-63284: Added support for TLS-PSK (pre-shared key) mode to the ssl module.

  • gh-112414: Fix regression in Python 3.12 where calling repr() on a module that had been imported using a custom loader could fail with AttributeError. Patch by Alex Waygood.

  • gh-112358: Revert change to struct.Struct initialization that broke some cases of subclassing.

  • gh-112405: Optimize pathlib.PurePath.relative_to(). Patch by Alex Waygood.

  • gh-94722: Fix bug where comparison between instances of DocTest fails if one of them has None as its lineno.

  • gh-112361: Speed up a small handful of pathlib methods by removing some temporary objects.

  • gh-112345: Improve error message when trying to call issubclass() against a typing.Protocol that has non-method members. Patch by Randolf Scholz.

  • gh-112137: Change dis output to display no-lineno as «–» instead of «None».

  • gh-112332: Deprecate the exc_type field of traceback.TracebackException. Add exc_type_str to replace it.

  • gh-81620: Add extra tests for random.binomialvariate()

  • gh-112292: Fix a crash in readline when imported from a sub interpreter. Patch by Anthony Shaw

  • gh-77621: Slightly improve the import time of the pathlib module by deferring some imports. Patch by Barney Gale.

  • gh-112137: Change dis output to display logical labels for jump targets instead of offsets.

  • gh-112139: Add Signature.format() to format signatures to string with extra options. And use it in pydoc to render more readable signatures that have new lines between parameters.

  • gh-112105: Make readline.set_completer_delims() work with libedit

  • gh-106922: Display multiple lines with traceback when errors span multiple lines.

  • gh-111874: When creating a typing.NamedTuple class, ensure __set_name__() is called on all objects that define __set_name__ and exist in the values of the NamedTuple class’s class dictionary. Patch by Alex Waygood.

  • gh-68166: Add support of the «vsapi» element type in tkinter.ttk.Style.element_create().

  • gh-110275: Named tuple’s methods _replace() and __replace__() now raise TypeError instead of ValueError for invalid keyword arguments.

  • gh-99367: Do not mangle sys.path[0] in pdb if safe_path is set

  • gh-111615: Fix a regression caused by a fix to gh-93162 whereby you couldn’t configure a QueueHandler without specifying handlers.

  • gh-75666: Fix the behavior of tkinter widget’s unbind() method with two arguments. Previously, widget.unbind(sequence, funcid) destroyed the current binding for sequence, leaving sequence unbound, and deleted the funcid command. Now it removes only funcid from the binding for sequence, keeping other commands, and deletes the funcid command. It leaves sequence unbound only if funcid was the last bound command.

  • gh-67790: Implement basic formatting support (minimum width, alignment, fill) for fractions.Fraction.

  • gh-111049: Fix crash during garbage collection of the io.BytesIO buffer object.

  • gh-102980: Redirect the output of interact command of pdb to the same channel as the debugger. Add tests and improve docs.

  • gh-102988: email.utils.getaddresses() and email.utils.parseaddr() now return ('', '') 2-tuples in more situations where invalid email addresses are encountered instead of potentially inaccurate values. Add optional strict parameter to these two functions: use strict=False to get the old behavior, accept malformed inputs. getattr(email.utils, 'supports_strict_parsing', False) can be use to check if the strict parameter is available. Patch by Thomas Dwyer and Victor Stinner to improve the CVE 2023-27043 fix.

  • gh-52161: cmd.Cmd.do_help() now cleans docstrings with inspect.cleandoc() before writing them. Patch by Filip Łapkiewicz.

  • gh-82300: Add track parameter to multiprocessing.shared_memory.SharedMemory that allows using shared memory blocks without having to register with the POSIX resource tracker that automatically releases them upon process exit.

  • gh-110109: Add private pathlib._PurePathBase class: a base class for pathlib.PurePath that omits certain magic methods. It may be made public (along with _PathBase) in future.

  • gh-109858: Protect zipfile from «quoted-overlap» zipbomb. It now raises BadZipFile when try to read an entry that overlaps with other entry or central directory.

  • gh-109786: Fix possible reference leaks and crash when re-enter the __next__() method of itertools.pairwise.

  • gh-91539: Small (10 - 20%) and trivial performance improvement of urllib.request.getproxies_environment(), typically useful when there are many environment variables to go over.

  • gh-103363: Add follow_symlinks keyword-only argument to pathlib.Path.owner() and group(), defaulting to True.

  • gh-102130: Support tab completion in cmd for editline.

  • gh-99437: runpy.run_path() now decodes path-like objects, making sure __file__ and sys.argv[0] of the module being run are always strings.

  • gh-104003: Add warnings.deprecated(), a decorator to mark deprecated functions to static type checkers and to warn on usage of deprecated classes and functions. See PEP 702. Patch by Jelle Zijlstra.

  • gh-103708: Make hardcoded python name, a configurable parameter so that different implementations of python can override it instead of making huge diffs in sysconfig.py

  • gh-66515: mailbox.MH now supports folders that do not contain a .mh_sequences file (e.g. Claws Mail IMAP-cache folders). Patch by Serhiy Storchaka.

  • gh-83162: Renamed re.error to PatternError for clarity, and kept re.error for backward compatibility. Patch by Matthias Bussonnier and Adam Chhina.

  • gh-91133: Fix a bug in tempfile.TemporaryDirectory cleanup, which now no longer dereferences symlinks when working around file system permission errors.

  • bpo-43153: On Windows, tempfile.TemporaryDirectory previously masked a PermissionError with NotADirectoryError during directory cleanup. It now correctly raises PermissionError if errors are not ignored. Patch by Andrei Kulakov and Ken Jin.

  • bpo-32731: getpass.getuser() now raises OSError for all failures rather than ImportError on systems lacking the pwd module or KeyError if the password database is empty.

  • bpo-34321: mmap.mmap now has a trackfd parameter on Unix; if it is False, the file descriptor specified by fileno will not be duplicated.

  • bpo-35332: The shutil.rmtree() function now ignores errors when calling os.close() when ignore_errors is True, and os.close() no longer retried after error.

  • bpo-35928: io.TextIOWrapper now correctly handles the decoding buffer after read() and write().

  • bpo-26791: shutil.move() now moves a symlink into a directory when that directory is the target of the symlink. This provides the same behavior as the mv shell command. The previous behavior raised an exception. Patch by Jeffrey Kintscher.

  • bpo-41422: Fixed memory leaks of pickle.Pickler and pickle.Unpickler involving cyclic references via the internal memo mapping.

  • bpo-19821: The pydoc.ispackage() function has been deprecated.

  • bpo-40262: The ssl.SSLSocket.recv_into() method no longer requires the buffer argument to implement __len__ and supports buffers with arbitrary item size.

  • bpo-39912: warnings.filterwarnings() and warnings.simplefilter() now raise appropriate exceptions instead of AssertionError. Patch contributed by Rémi Lapeyre.

  • bpo-37260: Fixed a race condition in shutil.rmtree() in which directory entries removed by another process or thread while shutil.rmtree() is running can cause it to raise FileNotFoundError. Patch by Jeffrey Kintscher.

  • bpo-36959: Fix some error messages for invalid ISO format string combinations in strptime() that referred to directives not contained in the format string. Patch by Gordon P. Hemsley.

  • bpo-18060: Fixed a class inheritance issue that can cause segfaults when deriving two or more levels of subclasses from a base class of Structure or Union.

  • bpo-29779: Add a new PYTHON_HISTORY environment variable to set the location of a .python_history file.

  • bpo-21360: mailbox.Maildir now ignores files with a leading dot.

Documentation

  • gh-111699: Relocate smtpd deprecation notice to its own section rather than under locale in What’s New in Python 3.12 document

  • gh-110746: Improved markup for valid options/values for methods ttk.treeview.column and ttk.treeview.heading, and for Layouts.

  • gh-95649: Document that the asyncio module contains code taken from v0.16.0 of the uvloop project, as well as the required MIT licensing information.

Tests

  • gh-111798: Disable test_super_deep() from test_call under pydebug builds on WASI; the stack depth is too small to make the test useful.

  • gh-111801: Lower the recursion limit in test_isinstance for test_infinitely_many_bases(). This prevents a stack overflow on a pydebug build of WASI.

  • gh-111802: Specify a low recursion depth for test_bad_getattr() in test.pickletester to avoid exhausting the stack under a pydebug build for WASI.

  • gh-44626: Fix os.path.isabs() incorrectly returning True when given a path that starts with exactly one (back)slash on Windows.

    Fix pathlib.PureWindowsPath.is_absolute() incorrectly returning False for some paths beginning with two (back)slashes.

  • gh-113633: Use module state for the _testcapi extension module.

  • gh-109980: Fix test_tarfile_vs_tar in test_shutil for macOS, where system tar can include more information in the archive than shutil.make_archive.

  • gh-112769: The tests now correctly compare zlib version when zlib.ZLIB_RUNTIME_VERSION contains non-integer suffixes. For example zlib-ng defines the version as 1.3.0.zlib-ng.

  • gh-112334: Adds a regression test to verify that vfork() is used when expected by subprocess on vfork enabled POSIX systems (Linux).

  • gh-108927: Fixed order dependence in running tests in the same process when a test that has submodules (e.g. test_importlib) follows a test that imports its submodule (e.g. test_importlib.util) and precedes a test (e.g. test_unittest or test_compileall) that uses that submodule.

  • bpo-40648: Test modes that file can get with chmod() on Windows.

Build

  • gh-114013: Fix Tools/wasm/wasi.py to not include the path to python.wasm as part of HOSTRUNNER. The environment variable is meant to specify how to run the WASI host only, having python.wasm and relevant flags appended to the HOSTRUNNER. This fixes make test work.

  • gh-113258: Changed the Windows build to write out generated frozen modules into the build tree instead of the source tree.

  • gh-112305: Fixed the check-clean-src step performed on out of tree builds to detect errant $(srcdir)/Python/frozen_modules/*.h files and recommend appropriate source tree cleanup steps to get a working build again.

  • gh-112536: Add support for thread sanitizer (TSAN)

  • gh-112867: Fix the build for the case that WITH_PYMALLOC_RADIX_TREE=0 set.

  • gh-103065: Introduce Tools/wasm/wasi.py to simplify doing a WASI build.

  • bpo-11102: The os.major(), os.makedev(), and os.minor() functions are now available on HP-UX v3.

  • bpo-36351: Do not set ipv6type when cross-compiling.

Windows

  • gh-114096: Process privileges that are activated for creating directory junctions are now restored afterwards, avoiding behaviour changes in other parts of the program.

  • gh-111877: os.stat() calls were returning incorrect time values for files that could not be accessed directly.

  • gh-111973: Update Windows installer to use SQLite 3.44.2.

  • gh-113009: multiprocessing: On Windows, fix a race condition in Process.terminate(): no longer set the returncode attribute to always call WaitForSingleObject() in Process.wait(). Previously, sometimes the process was still running after TerminateProcess() even if GetExitCodeProcess() is not STILL_ACTIVE. Patch by Victor Stinner.

  • gh-86179: Fixes path calculations when launching Python on Windows through a symlink.

  • gh-71383: Update Tcl/Tk in Windows installer to 8.6.13 with a patch to suppress incorrect ThemeChanged warnings.

  • gh-111650: Ensures the Py_GIL_DISABLED preprocessor variable is defined in pyconfig.h so that extension modules written in C are able to use it.

  • gh-112278: Reduce the time cost for some functions in platform on Windows if current user has no permission to the WMI.

  • gh-73427: Deprecate sys._enablelegacywindowsfsencoding(). Use PYTHONLEGACYWINDOWSFSENCODING instead. Patch by Inada Naoki.

  • gh-87868: Correctly sort and remove duplicate environment variables in _winapi.CreateProcess().

  • bpo-37308: Fix mojibake in mmap.mmap when using a non-ASCII tagname argument on Windows.

macOS

  • gh-113666: Add the following constants to module stat: UF_SETTABLE, UF_TRACKED, UF_DATAVAULT, SF_SUPPORTED, SF_SETTABLE, SF_SYNTHETIC, SF_RESTRICTED, SF_FIRMLINK and SF_DATALESS. The values UF_SETTABLE, SF_SUPPORTED, SF_SETTABLE and SF_SYNTHETIC are only available on macOS.

  • gh-113536: os.waitid() is now available on macOS

  • gh-110459: Running configure ... --with-openssl-rpath=X/Y/Z no longer fails to detect OpenSSL on macOS.

  • gh-74573: Document that dbm.ndbm can silently corrupt DBM files on updates when exceeding undocumented platform limits, and can crash (segmentation fault) when reading such a corrupted file. (FB8919203)

  • gh-65701: The freeze tool doesn’t work with framework builds of Python. Document this and bail out early when running the tool with such a build.

  • gh-87277: webbrowser: Don’t look for X11 browsers on macOS. Those are generally not used and probing for them can result in starting XQuartz even if it isn’t used otherwise.

  • gh-111973: Update macOS installer to use SQLite 3.44.2.

  • gh-108269: Set CFBundleAllowMixedLocalizations to true in the Info.plist for the framework, embedded Python.app and IDLE.app with framework installs on macOS. This allows applications to pick up the user’s preferred locale when that’s different from english.

  • gh-102362: Make sure the result of sysconfig.get_plaform() includes at least a major and minor versions, even if MACOSX_DEPLOYMENT_TARGET is set to only a major version during build to match the format expected by pip.

  • gh-110017: Disable a signal handling stress test on macOS due to a bug in macOS (FB13453490).

  • gh-110820: Make sure the preprocessor definitions for ALIGNOF_MAX_ALIGN_T, SIZEOF_LONG_DOUBLE and HAVE_GCC_ASM_FOR_X64 are correct for Universal 2 builds on macOS.

  • gh-109981: Use /dev/fd on macOS to determine the number of open files in test.support.os_helper.fd_count to avoid a crash with «guarded» file descriptors when probing for open files.

IDLE

  • gh-72284: Improve the lists of features, editor key bindings, and shell key bingings in the IDLE doc.

  • gh-113903: Fix rare failure of test.test_idle, in test_configdialog.

  • gh-113729: Fix the «Help -> IDLE Doc» menu bug in 3.11.7 and 3.12.1.

  • gh-113269: Fix test_editor hang on macOS Catalina.

  • gh-112898: Fix processing unsaved files when quitting IDLE on macOS.

  • bpo-13586: Enter the selected text when opening the «Replace» dialog.

C API

Python 3.13.0 alpha 2

Release date: 2023-11-22

Core and Builtins

  • gh-112243: Don’t include comments in f-string debug expressions. Patch by Pablo Galindo

  • gh-112287: Slightly optimize the Tier 2 (uop) interpreter by only loading oparg and operand when needed. Also double the trace size limit again, to 512 this time.

  • gh-112266: Change docstrings of __dict__ and __weakref__.

  • gh-111807: Lower the max parser stack depth to 1000 under WASI debug builds.

  • gh-111798: When Python is built in debug mode, set the C recursion limit to 500 instead of 1500. A debug build is likely built with low optimization level which implies higher stack memory usage than a release build. Patch by Victor Stinner.

  • gh-106529: Enable translating unspecialized FOR_ITER to Tier 2.

  • gh-111916: Make hashlib related modules thread-safe without the GIL

  • gh-81137: Deprecate assignment to a function’s __code__ field when the new code object is of a mismatched type (e.g., from a generator to a plain function).

  • gh-79932: Raise exception if frame.clear() is called on a suspended frame.

  • gh-81925: Implement native thread ids for GNU KFreeBSD.

  • gh-111843: Use exponential backoff to reduce the number of failed tier 2 optimization attempts by over 99%.

  • gh-110829: Joining a thread now ensures the underlying OS thread has exited. This is required for safer fork() in multi-threaded processes.

  • gh-109369: Make sure that tier 2 traces are de-optimized if the code is instrumented

  • gh-111772: Specialize slot loads and stores for _Py_T_OBJECT as well as Py_T_OBJECT_EX

  • gh-111666: Speed up BaseExceptionGroup.derive(), BaseExceptionGroup.subgroup(), and BaseExceptionGroup.split() by changing how they parse passed arguments.

  • gh-111654: Fix runtime crash when some error happens in opcode LOAD_FROM_DICT_OR_DEREF.

  • gh-111623: Add support for sharing tuples between interpreters using the cross-interpreter API. Patch by Anthony Shaw.

  • gh-111354: The oparg of YIELD_VALUE is now 1 if the instruction is part of a yield-from or await, and 0 otherwise.

    The SUSPENDED frame state is now split into SUSPENDED and SUSPENDED_YIELD_FROM. This simplifies the code in _PyGen_yf.

  • gh-111520: Merge the Tier 1 (bytecode) and Tier 2 (micro-ops) interpreters together, moving the Tier 2 interpreter loop and switch into _PyEval_EvalFrameDefault() in Python/ceval.c. The Python/executor.c file is gone. Also the TIER_ONE and TIER_TWO macros are now handled by the code generator.

    Beware! This changes the environment variables to enable micro-ops and their debugging to PYTHON_UOPS and PYTHON_LLTRACE.

  • gh-109181: Speed up Traceback object creation by lazily compute the line number. Patch by Pablo Galindo

  • gh-111420: Allow type comments in parenthesized with statements

  • gh-111438: Add support for sharing floats between interpreters using the cross-interpreter API. Patch by Anthony Shaw.

  • gh-111435: Add support for sharing of True and False between interpreters using the cross-interpreter API. Patch by Anthony Shaw.

  • gh-102388: Fix a bug where iso2022_jp_3 and iso2022_jp_2004 codecs read out of bounds

  • gh-111366: Fix an issue in the codeop that was causing SyntaxError exceptions raised in the presence of invalid syntax to not contain precise error messages. Patch by Pablo Galindo

  • gh-111380: Fix a bug that was causing SyntaxWarning to appear twice when parsing if invalid syntax is encountered later. Patch by Pablo galindo

  • gh-111374: Added a new environment variable PYTHON_FROZEN_MODULES. It determines whether or not frozen modules are ignored by the import machinery, equivalent of the -X frozen_modules command-line option.

  • gh-111354: Remove oparg from YIELD_VALUE. Change oparg of RESUME to include information about the except-depth. These changes make it possible to simplify the code in generator close.

  • gh-94438: Fix a regression that prevented jumping across is None and is not None when debugging. Patch by Savannah Ostrowski.

  • gh-67224: Show source lines in tracebacks when using the -c option when running Python. Patch by Pablo Galindo

  • gh-111123: Fix a bug where a global declaration in an except block is rejected when the global is used in the else block.

  • gh-110938: Fix error messages for indented blocks with functions and classes with generic type parameters. Patch by Pablo Galindo

  • gh-109214: Remove unnecessary instruction pointer updates before returning from frames.

  • gh-110912: Correctly display the traceback for MemoryError exceptions using the traceback module. Patch by Pablo Galindo

  • gh-109894: Fixed crash due to improperly initialized static MemoryError in subinterpreter.

  • gh-110892: Return NULL for PyTrace_RETURN events caused by an exception

  • gh-110864: Fix argument parsing by _PyArg_UnpackKeywordsWithVararg for functions defining pos-or-keyword, vararg, and kw-only parameters.

  • gh-109094: Replace prev_instr on the interpreter frame by instr_ptr which points to the beginning of the instruction that is currently executing (or will execute once the frame resumes).

  • gh-110805: Allow the repl to show source code and complete tracebacks. Patch by Pablo Galindo

  • gh-110722: Add PYTHON_PRESITE=package.module to import a module early in the interpreter lifecycle before site.py is executed. Python needs to be built in debug mode for this option to exist.

  • gh-110481: Implement biased reference counting in --disable-gil builds.

  • gh-110543: Fix regression in Python 3.12 where types.CodeType.replace() would produce a broken code object if called on a module or class code object that contains a comprehension. Patch by Jelle Zijlstra.

  • gh-89519: Removed chained classmethod descriptors (introduced in bpo-19072). This can no longer be used to wrap other descriptors such as property. The core design of this feature was flawed and caused a number of downstream problems. To «pass-through» a classmethod, consider using the __wrapped__ attribute that was added in Python 3.10.

  • gh-103615: Use local events for opcode tracing

  • bpo-46657: Add mimalloc memory allocator support.

  • gh-106718: When PyConfig.stdlib_dir is explicitly set, it’s now respected and won’t be overridden by PyConfig.home.

  • gh-106905: Fix incorrect SystemError about AST constructor recursion depth mismatch.

  • gh-100445: Improve error message for unterminated strings with escapes.

  • bpo-45759: Improved error messages for elif/else statements not matching any valid statements. Patch by Jeremiah Vivian.

Library

Tests

  • gh-111808: Make the default value of test.support.infinite_recursion() to be conditional based on whether optimizations were used when compiling the interpreter. This helps with platforms like WASI whose stack size is greatly restricted in debug builds.

  • gh-110722: Gathering line coverage of standard libraries within the regression test suite is now precise, as well as much faster. Patch by Łukasz Langa.

  • gh-110367: Make regrtest --verbose3 option compatible with --huntrleaks -jN options. The ./python -m test -j1 -R 3:3 --verbose3 command now works as expected. Patch by Victor Stinner.

  • gh-111165: Remove no longer used functions run_unittest() and run_doctest() from the test.support module.

  • gh-110932: Fix regrtest if the SOURCE_DATE_EPOCH environment variable is defined: use the variable value as the random seed. Patch by Victor Stinner.

  • gh-110995: test_gdb: Fix detection of gdb built without Python scripting support. Patch by Victor Stinner.

  • gh-110918: Test case matching patterns specified by options --match, --ignore, --matchfile and --ignorefile are now tested in the order of specification, and the last match determines whether the test case be run or ignored.

  • gh-108747: Add unit test for usercustomize and sitecustomize hooks from site.

Build

  • gh-96954: Make make regen-unicodedata work for out-of-tree builds of CPython.

  • gh-112088: Add Tools/build/regen-configure.sh script to regenerate the configure with an Ubuntu container image. The quay.io/tiran/cpython_autoconf:271 container image (tiran/cpython_autoconf) is no longer used. Patch by Victor Stinner.

  • gh-111046: For wasi-threads, memory is now exported to fix compatibility issues with some wasm runtimes.

  • gh-110828: AIX 32bit needs -latomic to build the _testcapi extension module.

  • gh-85283: The errno, md5, resource, winsound, _ctypes_test, _multiprocessing.posixshmem, _scproxy, _stat, _testimportmultiple and _uuid C extensions are now built with the limited C API. Patch by Victor Stinner.

Windows

  • gh-111856: Fixes fstat() on file systems that do not support file ID requests. This includes FAT32 and exFAT.

  • gh-111293: Fix os.DirEntry.inode dropping higher 64 bits of a file id on some filesystems on Windows.

  • gh-110913: WindowsConsoleIO now correctly chunks large buffers without splitting up UTF-8 sequences.

macOS

  • gh-59703: For macOS framework builds, in getpath.c use the system dladdr function to find the path to the shared library rather than depending on deprecated macOS APIs.

  • gh-110950: Update macOS installer to include an upstream Tcl/Tk fix for the Secure coding is not enabled for restorable state! warning encountered in Tkinter on macOS 14 Sonoma.

  • gh-111015: Ensure that IDLE.app and Python Launcher.app are installed with appropriate permissions on macOS builds.

  • gh-71383: Update macOS installer to include an upstream Tcl/Tk fix for the ttk::ThemeChanged error encountered in Tkinter.

  • gh-92603: Update macOS installer to include a fix accepted by upstream Tcl/Tk for a crash encountered after the first tkinter.Tk() instance is destroyed.

IDLE

  • bpo-35668: Add docstrings to the IDLE debugger module. Fix two bugs: initialize Idb.botframe (should be in Bdb); in Idb.in_rpc_code, check whether prev_frame is None before trying to use it. Greatly expand test_debugger.

Tools/Demos

  • gh-111903: Argument Clinic now supports the @critical_section directive that instructs Argument Clinic to generate a critical section around the function call, which locks the self object in --disable-gil builds. Patch by Sam Gross.

C API

  • gh-112026: Add again the private _PyThreadState_UncheckedGet() function as an alias to the new public PyThreadState_GetUnchecked() function. Patch by Victor Stinner.

  • gh-112026: Restore the removed _PyDict_GetItemStringWithError() function. It is used by numpy. Patch by Victor Stinner.

  • gh-112026: Restore removed private C API functions, macros and structures which have no simple replacement for now:

    • _PyDict_GetItem_KnownHash()

    • _PyDict_NewPresized()

    • _PyHASH_BITS

    • _PyHASH_IMAG

    • _PyHASH_INF

    • _PyHASH_MODULUS

    • _PyHASH_MULTIPLIER

    • _PyLong_Copy()

    • _PyLong_FromDigits()

    • _PyLong_New()

    • _PyLong_Sign()

    • _PyObject_CallMethodId()

    • _PyObject_CallMethodNoArgs()

    • _PyObject_CallMethodOneArg()

    • _PyObject_CallOneArg()

    • _PyObject_EXTRA_INIT

    • _PyObject_FastCallDict()

    • _PyObject_GetAttrId()

    • _PyObject_Vectorcall()

    • _PyObject_VectorcallMethod()

    • _PyStack_AsDict()

    • _PyThread_CurrentFrames()

    • _PyUnicodeWriter structure

    • _PyUnicodeWriter_Dealloc()

    • _PyUnicodeWriter_Finish()

    • _PyUnicodeWriter_Init()

    • _PyUnicodeWriter_Prepare()

    • _PyUnicodeWriter_PrepareKind()

    • _PyUnicodeWriter_WriteASCIIString()

    • _PyUnicodeWriter_WriteChar()

    • _PyUnicodeWriter_WriteLatin1String()

    • _PyUnicodeWriter_WriteStr()

    • _PyUnicodeWriter_WriteSubstring()

    • _PyUnicode_AsString()

    • _PyUnicode_FromId()

    • _PyVectorcall_Function()

    • _Py_IDENTIFIER()

    • _Py_c_abs()

    • _Py_c_diff()

    • _Py_c_neg()

    • _Py_c_pow()

    • _Py_c_prod()

    • _Py_c_quot()

    • _Py_c_sum()

    • _Py_static_string()

    • _Py_static_string_init()

    Patch by Victor Stinner.

  • gh-112026: Add again <ctype.h> and <unistd.h> includes in Python.h, but don’t include them in the limited C API version 3.13 and newer. Patch by Victor Stinner.

  • gh-111956: Add internal-only one-time initialization API: _PyOnceFlag and _PyOnceFlag_CallOnce.

  • gh-111262: Add PyDict_Pop() and PyDict_PopString() functions: remove a key from a dictionary and optionally return the removed value. This is similar to dict.pop(), but without the default value and not raising KeyError if the key missing. Patch by Stefan Behnel and Victor Stinner.

  • gh-111863: Rename Py_NOGIL to Py_GIL_DISABLED. Patch by Hugo van Kemenade.

  • gh-111138: Add PyList_Extend() and PyList_Clear() functions: similar to Python list.extend() and list.clear() methods. Patch by Victor Stinner.

  • gh-108765: On Windows, Python.h no longer includes the <stddef.h> standard header file. If needed, it should now be included explicitly. Patch by Victor Stinner.

  • gh-111569: Implement «Python Critical Sections» from PEP 703. These are macros to help replace the GIL with per-object locks in the --disable-gil build of CPython. The macros are no-ops in the default build.

  • gh-111506: In the limited C API version 3.13, Py_SET_REFCNT() function is now implemented as an opaque function call. Patch by Victor Stinner.

  • gh-108082: Add PyErr_FormatUnraisable() function.

  • gh-110964: Move the undocumented private _PyArg functions and _PyArg_Parser structure to internal C API (pycore_modsupport.h). Patch by Victor Stinner.

  • gh-110815: Support non-ASCII keyword names in PyArg_ParseTupleAndKeywords().

  • gh-109587: Introduced PyUnstable_PerfTrampoline_CompileCode(), PyUnstable_PerfTrampoline_SetPersistAfterFork() and PyUnstable_CopyPerfMapFile(). These functions allow extension modules to initialize trampolines eagerly, after the application is «warmed up». This makes it possible to have perf-trampolines running in an always-enabled fashion.

  • gh-85283: Add the PySys_Audit() function to the limited C API. Patch by Victor Stinner.

  • gh-85283: Add PyMem_RawMalloc(), PyMem_RawCalloc(), PyMem_RawRealloc() and PyMem_RawFree() to the limited C API. Patch by Victor Stinner.

  • gh-106672: Functions PyDict_GetItem(), PyDict_GetItemString(), PyMapping_HasKey(), PyMapping_HasKeyString(), PyObject_HasAttr(), PyObject_HasAttrString(), and PySys_GetObject(), which clear all errors occurred during calling the function, report now them using sys.unraisablehook().

  • gh-67565: Remove redundant C-contiguity check in getargs.c, binascii, ssl and Argument Clinic. Patched by Stefan Krah and Furkan Onder

Python 3.13.0 alpha 1

Release date: 2023-10-13

Security

  • gh-108310: Fixed an issue where instances of ssl.SSLSocket were vulnerable to a bypass of the TLS handshake and included protections (like certificate verification) and treating sent unencrypted data as if it were post-handshake TLS encrypted data. Security issue reported as CVE 2023-40217 by Aapo Oksman. Patch by Gregory P. Smith.

  • gh-107774: PEP 669 specifies that sys.monitoring.register_callback will generate an audit event. Pre-releases of Python 3.12 did not generate the audit event. This is now fixed.

  • gh-102988: Reverted the email.utils security improvement change released in 3.12beta4 that unintentionally caused email.utils.getaddresses to fail to parse email addresses with a comma in the quoted name field. See gh-106669.

  • gh-99108: Refresh our new HACL* built-in hashlib code from upstream. Built-in SHA2 should be faster and an issue with SHA3 on 32-bit platforms is fixed.

  • gh-102509: Start initializing ob_digit during creation of PyLongObject objects. Patch by Illia Volochii.

Core and Builtins

  • gh-110782: Fix crash when typing.TypeVar is constructed with a keyword argument. Patch by Jelle Zijlstra.

  • gh-110752: Reset ceval.eval_breaker in interpreter_clear()

  • gh-110721: Use the traceback implementation for the default PyErr_Display() functionality. Patch by Pablo Galindo

  • gh-110696: Fix incorrect error message for invalid argument unpacking. Patch by Pablo Galindo

  • gh-104169: Split the tokenizer into two separate directories: - One part includes the actual lexeme producing logic and lives in Parser/lexer. - The second part wraps the lexer according to the different tokenization modes we have (string, utf-8, file, interactive, readline) and lives in Parser/tokenizer.

  • gh-110688: Remove undocumented test_c_api method from set, which was only defined for testing purposes under Py_DEBUG. Now we have proper CAPI tests.

  • gh-104584: Fix a reference leak when running with PYTHONUOPS or -X uops enabled.

  • gh-110514: Add PY_THROW to sys.setprofile() events

  • gh-110489: Optimise math.ceil() when the input is exactly a float, resulting in about a 10% improvement.

  • gh-110455: Guard assert(tstate->thread_id > 0) with #ifndef HAVE_PTHREAD_STUBS. This allows for for pydebug builds to work under WASI which (currently) lacks thread support.

  • gh-110309: Remove unnecessary empty constant nodes in the ast of f-string specs.

  • gh-110259: Correctly identify the format spec in f-strings (with single or triple quotes) that have multiple lines in the expression part and include a formatting spec. Patch by Pablo Galindo

  • gh-110237: Fix missing error checks for calls to PyList_Append in _PyEval_MatchClass.

  • gh-110164: regrtest: If the SOURCE_DATE_EPOCH environment variable is defined, regrtest now disables tests randomization. Patch by Victor Stinner.

  • gh-109889: Fix the compiler’s redundant NOP detection algorithm to skip over NOPs with no line number when looking for the next instruction’s lineno.

  • gh-109853: sys.path[0] is now set correctly for subinterpreters.

  • gh-109923: Set line number on the POP_TOP that follows a RETURN_GENERATOR.

  • gh-105716: Subinterpreters now correctly handle the case where they have threads running in the background. Before, such threads would interfere with cleaning up and destroying them, as well as prevent running another script.

  • gh-109369: The internal eval_breaker and supporting flags, plus the monitoring version have been merged into a single atomic integer to speed up checks.

  • gh-109823: Fix bug where compiler does not adjust labels when removing an empty basic block which is a jump target.

  • gh-109793: The main thread no longer exits prematurely when a subinterpreter is cleaned up during runtime finalization. The bug was a problem particularly because, when triggered, the Python process would always return with a 0 exitcode, even if it failed.

  • gh-109719: Fix missing jump target labels when compiler reorders cold/warm blocks.

  • gh-109595: Add -X cpu_count command line option to override return results of os.cpu_count() and os.process_cpu_count(). This option is useful for users who need to limit CPU resources of a container system without having to modify the container (application code). Patch by Donghee Na.

  • gh-109627: Fix bug where the compiler does not assign a new jump target label to a duplicated small exit block.

  • gh-109596: Fix some tokens in the grammar that were incorrectly marked as soft keywords. Also fix some repeated rule names and ensure that repeated rules are not allowed. Patch by Pablo Galindo

  • gh-109496: On a Python built in debug mode, Py_DECREF() now calls _Py_NegativeRefcount() if the object is a dangling pointer to deallocated memory: memory filled with 0xDD «dead byte» by the debug hook on memory allocators. The fix is to check the reference count before checking for _Py_IsImmortal(). Patch by Victor Stinner.

  • gh-107265: Deopt opcodes hidden by the executor when base opcode is needed

  • gh-109371: Deopted instructions correctly for tool initialization and modified the incorrect assertion in instrumentation, when a previous tool already sets INSTRUCTION events

  • gh-105658: Fix bug where the line trace of an except block ending with a conditional includes an excess event with the line of the conditional expression.

  • gh-109219: Fix compiling type param scopes that use a name which is also free in an inner scope.

  • gh-109351: Fix crash when compiling an invalid AST involving a named (walrus) expression.

  • gh-109341: Fix crash when compiling an invalid AST involving a ast.TypeAlias.

  • gh-109195: Fix source location for the LOAD_* instruction preceding a LOAD_SUPER_ATTR to load the super global (or shadowing variable) so that it encompasses only the name super and not the following parentheses.

  • gh-109256: Opcode IDs for specialized opcodes are allocated in their own range to improve stability of the IDs for the “real” opcodes.

  • gh-109216: Fix possible memory leak in BUILD_MAP.

  • gh-109207: Fix a SystemError in __repr__ of symtable entry object.

  • gh-109179: Fix bug where the C traceback display drops notes from SyntaxError.

  • gh-109118: Disallow nested scopes (lambdas, generator expressions, and comprehensions) within PEP 695 annotation scopes that are nested within classes.

  • gh-109156: Add tests for de-instrumenting instructions while keeping the instrumentation for lines

  • gh-109114: Relax the detection of the error message for invalid lambdas inside f-strings to not search for arbitrary replacement fields to avoid false positives. Patch by Pablo Galindo

  • gh-105848: Add a new CALL_KW opcode, used for calls containing keyword arguments. Also, fix a possible crash when jumping over method calls in a debugger.

  • gh-109052: Use the base opcode when comparing code objects to avoid interference from instrumentation

  • gh-109118: Fix interpreter crash when a NameError is raised inside the type parameters of a generic class.

  • gh-88943: Improve syntax error for non-ASCII character that follows a numerical literal. It now points on the invalid non-ASCII character, not on the valid numerical literal.

  • gh-108976: Fix crash that occurs after de-instrumenting a code object in a monitoring callback.

  • gh-108732: Make iteration variables of module- and class-scoped comprehensions visible to pdb and other tools that use frame.f_locals again.

  • gh-108959: Fix caret placement for error locations for subscript and binary operations that involve non-semantic parentheses and spaces. Patch by Pablo Galindo

  • gh-104584: Fix a crash when running with PYTHONUOPS or -X uops enabled and an error occurs during optimization.

  • gh-108727: Define tp_dealloc for CounterOptimizer_Type. This fixes a segfault on deallocation.

  • gh-108520: Fix multiprocessing.synchronize.SemLock.__setstate__() to properly initialize multiprocessing.synchronize.SemLock._is_fork_ctx. This fixes a regression when passing a SemLock across nested processes.

    Rename multiprocessing.synchronize.SemLock.is_fork_ctx to multiprocessing.synchronize.SemLock._is_fork_ctx to avoid exposing it as public API.

  • gh-108654: Restore locals shadowed by an inlined comprehension if the comprehension raises an exception.

  • gh-108488: Change the initialization of inline cache entries so that the cache entry for JUMP_BACKWARD is initialized to zero, instead of the adaptive_counter_warmup() value used for all other instructions. This counter, unique among instructions, counts up from zero.

  • gh-108716: Turn off deep-freezing of code objects. Modules are still frozen, so that a file system search is not needed for common modules.

  • gh-108614: Add RESUME_CHECK instruction, to avoid having to handle instrumentation, signals, and contexts switches in the tier 2 execution engine.

  • gh-108487: Move an assert that would cause a spurious crash in a devious case that should only trigger deoptimization.

  • gh-106176: Use a WeakValueDictionary to track the lists containing the modules each thread is currently importing. This helps avoid a reference leak from keeping the list around longer than necessary. Weakrefs are used as GC can’t interrupt the cleanup.

  • gh-105481: The regen-opcode build stage was removed and its work is now done in regen-cases.

  • gh-107901: Fix missing line number on JUMP_BACKWARD at the end of a for loop.

  • gh-108113: The compile() built-in can now accept a new flag, ast.PyCF_OPTIMIZED_AST, which is similar to ast.PyCF_ONLY_AST except that the returned AST is optimized according to the value of the optimize argument.

    ast.parse() now accepts an optional argument optimize which is passed on to the compile() built-in. This makes it possible to obtain an optimized AST.

  • gh-107971: Opcode IDs are generated from bytecodes.c instead of being hard coded in opcode.py.

  • gh-107944: Improve error message for function calls with bad keyword arguments. Patch by Pablo Galindo

  • gh-108390: Raise an exception when setting a non-local event (RAISE, EXCEPTION_HANDLED, etc.) in sys.monitoring.set_local_events.

    Fixes crash when tracing in recursive calls to Python classes.

  • gh-108035: Remove the _PyCFrame struct, moving the pointer to the current interpreter frame back to the threadstate, as it was for 3.10 and earlier. The _PyCFrame existed as a performance optimization for tracing. Since PEP 669 has been implemented, this optimization no longer applies.

  • gh-91051: Fix abort / segfault when using all eight type watcher slots, on platforms where char is signed by default.

  • gh-106581: Fix possible assertion failures and missing instrumentation events when PYTHONUOPS or -X uops is enabled.

  • gh-107526: Revert converting vars, dir, next, getattr, and iter to argument clinic.

  • gh-84805: Autogenerate signature for METH_NOARGS and METH_O extension functions.

  • gh-107758: Make the dump_stack() routine used by the lltrace feature (low-level interpreter debugging) robust against recursion by ensuring that it never calls a __repr__ method implemented in Python. Also make the similar output for Tier-2 uops appear on stdout (instead of stderr), to match the lltrace code in ceval.c.

  • gh-107659: Add docstrings for ctypes.pointer() and ctypes.POINTER().

  • gh-105848: Modify the bytecode so that the actual callable for a CALL is at a consistent position on the stack (regardless of whether or not bound-method-calling optimizations are active).

  • gh-107674: Fixed performance regression in sys.settrace.

  • gh-107724: In pre-release versions of 3.12, up to rc1, the sys.monitoring callback function for the PY_THROW event was missing the third, exception argument. That is now fixed.

  • gh-84436: Skip reference count modifications for many known immortal objects.

  • gh-107596: Specialize subscripting str objects by int indexes.

  • gh-107080: Trace refs builds (--with-trace-refs) were crashing when used with isolated subinterpreters. The problematic global state has been isolated to each interpreter. Other fixing the crashes, this change does not affect users.

  • gh-107557: Generate the cases needed for the barebones tier 2 abstract interpreter for optimization passes in CPython.

  • gh-106608: Make _PyUOpExecutorObject variable length.

  • gh-100964: Clear generators” exception state after return to break reference cycles.

  • gh-107455: Improve error messages when converting an incompatible type to ctypes.c_char_p, ctypes.c_wchar_p and ctypes.c_void_p.

  • gh-107263: Increase C recursion limit for functions other than the main interpreter from 800 to 1500. This should allow functions like list.__repr__ and json.dumps to handle all the inputs that they could prior to 3.12

  • gh-104584: Fix an issue which caused incorrect inline caches to be read when running with PYTHONUOPS or -X uops enabled.

  • gh-104432: Fix potential unaligned memory access on C APIs involving returned sequences of char * pointers within the grp and socket modules. These were revealed using a -fsaniziter=alignment build on ARM macOS. Patch by Christopher Chavez.

  • gh-106078: Isolate _decimal (apply PEP 687). Patch by Charlie Zhao.

  • gh-106898: Add the exception as the third argument to PY_UNIND callbacks in sys.monitoring. This makes the PY_UNWIND callback consistent with the other exception handling callbacks.

  • gh-106895: Raise a ValueError when a monitoring callback function returns DISABLE for events that cannot be disabled locally.

  • gh-106897: Add a RERAISE event to sys.monitoring, which occurs when an exception is reraise, either explicitly by a plain raise statement, or implicitly in an except or finally block.

  • gh-77377: Ensure that multiprocessing synchronization objects created in a fork context are not sent to a different process created in a spawn context. This changes a segfault into an actionable RuntimeError in the parent process.

  • gh-106931: Statically allocated string objects are now interned globally instead of per-interpreter. This fixes a situation where such a string would only be interned in a single interpreter. Normal string objects are unaffected.

  • gh-104621: Unsupported modules now always fail to be imported.

  • gh-107122: Add dbm.ndbm.ndbm.clear() to dbm.ndbm. Patch By Donghee Na.

  • gh-107122: Add dbm.gnu.gdbm.clear() to dbm.gnu. Patch By Donghee Na.

  • gh-107015: The ASYNC and AWAIT tokens are removed from the Grammar, which removes the possibility of making async and await soft keywords when using feature_version<7 in ast.parse().

  • gh-106917: Fix classmethod-style super() method calls (i.e., where the second argument to super(), or the implied second argument drawn from self/cls in the case of zero-arg super, is a type) when the target of the call is not a classmethod.

  • gh-105699: Python no longer crashes due an infrequent race when initializing per-interpreter interned strings. The crash would manifest when the interpreter was finalized.

  • gh-105699: Python no longer crashes due to an infrequent race in setting Py_FileSystemDefaultEncoding and Py_FileSystemDefaultEncodeErrors (both deprecated), when simultaneously initializing two isolated subinterpreters. Now they are only set during runtime initialization.

  • gh-106908: Fix various hangs, reference leaks, test failures, and tracing/introspection bugs when running with PYTHONUOPS or -X uops enabled.

  • gh-106092: Fix a segmentation fault caused by a use-after-free bug in frame_dealloc when the trashcan delays the deallocation of a PyFrameObject.

  • gh-106485: Reduce the number of materialized instances dictionaries by dematerializing them when possible.

  • gh-106719: No longer suppress arbitrary errors in the __annotations__ getter and setter in the type and module types.

  • gh-106723: Propagate frozen_modules to multiprocessing spawned process interpreters.

  • gh-104909: Split LOAD_ATTR_INSTANCE_VALUE into micro-ops.

  • gh-104909: Split LOAD_GLOBAL specializations into micro-ops.

  • gh-106597: A new debug structure of offsets has been added to the _PyRuntimeState that will help out-of-process debuggers and profilers to obtain the offsets to relevant interpreter structures in a way that is agnostic of how Python was compiled and that doesn’t require copying the headers. Patch by Pablo Galindo

  • gh-106487: Allow the count argument of str.replace() to be a keyword. Patch by Hugo van Kemenade.

  • gh-96844: Improve error message of list.remove(). Patch by Donghee Na.

  • gh-81283: Compiler now strips indents from docstrings. It reduces pyc file size 5% when the module is heavily documented. This change affects to __doc__ so tools like doctest will be affected.

  • gh-106396: When the format specification of an f-string expression is empty, the parser now generates an empty ast.JoinedStr node for it instead of an one-element ast.JoinedStr with an empty string ast.Constant.

  • gh-100288: Specialize LOAD_ATTR for non-descriptors on the class. Adds LOAD_ATTR_NONDESCRIPTOR_WITH_VALUES and LOAD_ATTR_NONDESCRIPTOR_NO_DICT.

  • gh-106008: Fix possible reference leaks when failing to optimize comparisons with None in the bytecode compiler.

  • gh-106145: Make end_lineno and end_col_offset required on type_param ast nodes.

  • gh-106213: Changed the way that Emscripten call trampolines work for compatibility with Wasm/JS Promise integration.

  • gh-106182: sys.getfilesystemencoding() and sys.getfilesystemencodeerrors now return interned Unicode object.

  • gh-106210: Removed Emscripten import trampoline as it was no longer necessary for Pyodide.

  • gh-104584: Added a new, experimental, tracing optimizer and interpreter (a.k.a. «tier 2»). This currently pessimizes, so don’t use yet – this is infrastructure so we can experiment with optimizing passes. To enable it, pass -Xuops or set PYTHONUOPS=1. To get debug output, set PYTHONUOPSDEBUG=N where N is a debug level (0-4, where 0 is no debug output and 4 is excessively verbose).

  • gh-105775: LOAD_CLOSURE is now a pseudo-op.

  • gh-105730: Allow any callable other than type objects as the condition predicate in BaseExceptionGroup.split() and BaseExceptionGroup.subgroup().

  • gh-105979: Fix crash in _imp.get_frozen_object() due to improper exception handling.

  • gh-106003: Add a new TO_BOOL instruction, which performs boolean conversions for POP_JUMP_IF_TRUE, POP_JUMP_IF_FALSE, and UNARY_NOT (which all expect exact bool values now). Also, modify the oparg of COMPARE_OP to include an optional «boolean conversion» flag.

  • gh-98931: Ensure custom SyntaxError error messages are raised for invalid imports with multiple targets. Patch by Pablo Galindo

  • gh-105724: Improve assert error messages by providing exact error range.

  • gh-105908: Fixed bug where gh-99111 breaks future import barry_as_FLUFL in the Python REPL.

  • gh-105840: Fix possible crashes when specializing function calls with too many __defaults__.

  • gh-105831: Fix an f-string bug, where using a debug expression (the = sign) that appears in the last line of a file results to the debug buffer that holds the expression text being one character too small.

  • gh-105800: Correctly issue SyntaxWarning in f-strings if invalid sequences are used. Patch by Pablo Galindo

  • gh-105340: Include the comprehension iteration variable in locals() inside a module- or class-scope comprehension.

  • gh-105331: Raise ValueError if the delay argument to asyncio.sleep() is a NaN (matching time.sleep()).

  • gh-105587: The runtime can’t guarantee that immortal objects will not be mutated by Extensions. Thus, this modifies _PyStaticObject_CheckRefcnt to warn instead of asserting.

  • gh-105564: Don’t include artificil newlines in the line attribute of tokens in the APIs of the tokenize module. Patch by Pablo Galindo

  • gh-105549: Tokenize separately NUMBER and NAME tokens that are not ambiguous. Patch by Pablo Galindo.

  • gh-105588: Fix an issue that could result in crashes when compiling malformed ast nodes.

  • gh-100987: Allow objects other than code objects as the «executable» in internal frames. In the long term, this can help tools like Cython and PySpy interact more efficiently. In the shorter term, it allows us to perform some optimizations more simply.

  • gh-105375: Fix bugs in the builtins module where exceptions could end up being overwritten.

  • gh-105375: Fix bug in the compiler where an exception could end up being overwritten.

  • gh-105375: Improve error handling in PyUnicode_BuildEncodingMap() where an exception could end up being overwritten.

  • gh-105486: Change the repr of ParamSpec list of args in types.GenericAlias.

  • gh-105678: Break the MAKE_FUNCTION instruction into two parts, MAKE_FUNCTION which makes the function and SET_FUNCTION_ATTRIBUTE which sets the attributes on the function. This makes the stack effect of MAKE_FUNCTION regular to ease optimization and code generation.

  • gh-105435: Fix spurious newline character if file ends on a comment without a newline. Patch by Pablo Galindo

  • gh-105390: Correctly raise tokenize.TokenError exceptions instead of SyntaxError for tokenize errors such as incomplete input. Patch by Pablo Galindo

  • gh-105259: Don’t include newline character for trailing NEWLINE tokens emitted in the tokenize module. Patch by Pablo Galindo

  • gh-104635: Eliminate redundant STORE_FAST instructions in the compiler. Patch by Donghee Na and Carl Meyer.

  • gh-105324: Fix the main function of the tokenize module when reading from sys.stdin. Patch by Pablo Galindo

  • gh-33092: Simplify and speed up interpreter for f-strings. Removes FORMAT_VALUE opcode. Add CONVERT_VALUE, FORMAT_SIMPLE and FORMAT_WITH_SPEC opcode. Compiler emits more efficient sequence for each format expression.

  • gh-105229: Remove remaining two-codeunit superinstructions. All remaining superinstructions only take a single codeunit, simplifying instrumentation and quickening.

  • gh-105235: Prevent out-of-bounds memory access during mmap.find() calls.

  • gh-98963: Restore the ability for a subclass of property to define __slots__ or otherwise be dict-less by ignoring failures to set a docstring on such a class. This behavior had regressed in 3.12beta1. An AttributeError where there had not previously been one was disruptive to existing code.

  • gh-104812: The «pending call» machinery now works for all interpreters, not just the main interpreter, and runs in all threads, not just the main thread. Some calls are still only done in the main thread, ergo in the main interpreter. This change does not affect signal handling nor the existing public C-API (Py_AddPendingCall()), which both still only target the main thread. The new functionality is meant strictly for internal use for now, since consequences of its use are not well understood yet outside some very restricted cases. This change brings the capability in line with the intention when the state was made per-interpreter several years ago.

  • gh-105194: Do not escape with backslashes f-string format specifiers. Patch by Pablo Galindo

  • gh-105229: Replace some dynamic superinstructions with single instruction equivalents.

  • gh-105162: Fixed bug in generator.close()/throw() where an inner iterator would be ignored when the outer iterator was instrumented.

  • gh-105164: Ensure annotations are set up correctly if the only annotation in a block is within a match block. Patch by Jelle Zijlstra.

  • gh-105148: Make _PyASTOptimizeState internal to ast_opt.c. Make _PyAST_Optimize take two integers instead of a pointer to this struct. This avoids the need to include pycore_compile.h in ast_opt.c.

  • gh-104799: Attributes of ast nodes that are lists now default to the empty list if omitted. This means that some code that previously raised TypeError when the AST node was used will now proceed with the empty list instead. Patch by Jelle Zijlstra.

  • gh-105111: Remove the old trashcan macros Py_TRASHCAN_SAFE_BEGIN and Py_TRASHCAN_SAFE_END. They should be replaced by the new macros Py_TRASHCAN_BEGIN and Py_TRASHCAN_END.

  • gh-105035: Fix super() calls on types with custom tp_getattro implementation (e.g. meta-types.)

  • gh-105017: Show CRLF lines in the tokenize string attribute in both NL and NEWLINE tokens. Patch by Marta Gómez.

  • gh-105013: Fix handling of multiline parenthesized lambdas in inspect.getsource(). Patch by Pablo Galindo

  • gh-105017: Do not include an additional final NL token when parsing files having CRLF lines. Patch by Marta Gómez.

  • gh-104976: Ensure that trailing DEDENT tokenize.TokenInfo objects emitted by the tokenize module are reported as in Python 3.11. Patch by Pablo Galindo

  • gh-104972: Ensure that the line attribute in tokenize.TokenInfo objects in the tokenize module are always correct. Patch by Pablo Galindo

  • gh-104955: Fix signature for the new __release_buffer__() slot. Patch by Jelle Zijlstra.

  • gh-104690: Starting new threads and process creation through os.fork() during interpreter shutdown (such as from atexit handlers) is no longer supported. It can lead to race condition between the main Python runtime thread freeing thread states while internal threading routines are trying to allocate and use the state of just created threads. Or forked children trying to use the mid-shutdown runtime and thread state in the child process.

  • gh-104879: Fix crash when accessing the __module__ attribute of type aliases defined outside a module. Patch by Jelle Zijlstra.

  • gh-104825: Tokens emitted by the tokenize module do not include an implicit \n character in the line attribute anymore. Patch by Pablo Galindo

  • gh-104770: If a generator returns a value upon being closed, the value is now returned by generator.close().

  • gh-89091: Raise RuntimeWarning for unawaited async generator methods like asend(), athrow() and aclose(). Patch by Kumar Aditya.

  • gh-96663: Add a better, more introspect-able error message when setting attributes on classes without a __dict__ and no slot member for the attribute.

  • gh-93627: Update the Python pickle module implementation to match the C implementation of the pickle module. For objects setting reduction methods like __reduce_ex__() or __reduce__() to None, pickling will result in a TypeError.

  • gh-101006: Improve error handling when read marshal data.

  • gh-91095: Specializes calls to most Python classes. Specifically, any class that inherits from object, or another Python class, and does not override __new__.

    The specialized instruction does the following:

    1. Creates the object (by calling object.__new__)

    2. Pushes a shim frame to the frame stack (to cleanup after __init__)

    3. Pushes the frame for __init__ to the frame stack

    Speeds up the instantiation of most Python classes.

Library

  • gh-110786: sysconfig’s CLI now ignores BrokenPipeError, making it exit normally if its output is being piped and the pipe closes.

  • gh-103480: The sysconfig module is now a package, instead of a single-file module.

  • gh-110733: Micro-optimization: Avoid calling min(), max() in BaseEventLoop._run_once().

  • gh-94597: Added asyncio.EventLoop for use with the asyncio.run() loop_factory kwarg to avoid calling the asyncio policy system.

  • gh-110682: runtime-checkable protocols used to consider __match_args__ a protocol member in __instancecheck__ if it was present on the protocol. Now, this attribute is ignored if it is present.

  • gh-110488: Fix a couple of issues in pathlib.PurePath.with_name(): a single dot was incorrectly considered a valid name, and in PureWindowsPath, a name with an NTFS alternate data stream, like a:b, was incorrectly considered invalid.

  • gh-110590: Fix a bug in _sre.compile() where TypeError would be overwritten by OverflowError when the code argument was a list of non-ints.

  • gh-65052: Prevent pdb from crashing when trying to display undisplayable objects

  • gh-110519: Deprecation warning about non-integer number in gettext now always refers to the line in the user code where gettext function or method is used. Previously it could refer to a line in gettext code.

  • gh-89902: Deprecate non-standard format specifier «N» for decimal.Decimal. It was not documented and only supported in the C implementation.

  • gh-110378: contextmanager() and asynccontextmanager() context managers now close an invalid underlying generator object that yields more then one value.

  • gh-106670: In pdb, set convenience variable $_exception for post mortem debugging.

  • gh-110365: Fix termios.tcsetattr() bug that was overwriting existing errors during parsing integers from term list.

  • gh-109653: Slightly improve the import time of several standard-library modules by deferring imports of warnings within those modules. Patch by Alex Waygood.

  • gh-110273: dataclasses.replace() now raises TypeError instead of ValueError if specify keyword argument for a field declared with init=False or miss keyword argument for required InitVar field.

  • gh-110249: Add --inline-caches flag to dis command line.

  • gh-109653: Fix a Python 3.12 regression in the import time of random. Patch by Alex Waygood.

  • gh-110222: Add support of struct sequence objects in copy.replace(). Patched by Xuehai Pan.

  • gh-109649: multiprocessing, concurrent.futures, compileall: Replace os.cpu_count() with os.process_cpu_count() to select the default number of worker threads and processes. Get the CPU affinity if supported. Patch by Victor Stinner.

  • gh-110150: Fix base case handling in statistics.quantiles. Now allows a single data point.

  • gh-110036: On Windows, multiprocessing Popen.terminate() now catches PermissionError and get the process exit code. If the process is still running, raise again the PermissionError. Otherwise, the process terminated as expected: store its exit code. Patch by Victor Stinner.

  • gh-110038: Fixed an issue that caused KqueueSelector.select() to not return all the ready events in some cases when a file descriptor is registered for both read and write.

  • gh-110045: Update the symtable module to support the new scopes introduced by PEP 695.

  • gh-88402: Add new variables to sysconfig.get_config_vars() on Windows: LIBRARY, LDLIBRARY, LIBDIR, SOABI, and Py_NOGIL.

  • gh-109631: re functions such as re.findall(), re.split(), re.search() and re.sub() which perform short repeated matches can now be interrupted by user.

  • gh-109653: Reduce the import time of email.utils by around 43%. This results in the import time of email.message falling by around 18%, which in turn reduces the import time of importlib.metadata by around 6%. Patch by Alex Waygood.

  • gh-109818: Fix reprlib.recursive_repr() not copying __type_params__ from decorated function.

  • gh-109047: concurrent.futures: The executor manager thread now catches exceptions when adding an item to the call queue. During Python finalization, creating a new thread can now raise RuntimeError. Catch the exception and call terminate_broken() in this case. Patch by Victor Stinner.

  • gh-109782: Ensure the signature of os.path.isdir() is identical on all platforms. Patch by Amin Alaee.

  • gh-109653: Improve import time of functools by around 13%. Patch by Alex Waygood.

  • gh-109590: shutil.which() will prefer files with an extension in PATHEXT if the given mode includes os.X_OK on win32. If no PATHEXT match is found, a file without an extension in PATHEXT can be returned. This change will have shutil.which() act more similarly to previous behavior in Python 3.11.

  • gh-109653: Reduce the import time of enum by over 50%. Patch by Alex Waygood.

  • gh-109593: Avoid deadlocking on a reentrant call to the multiprocessing resource tracker. Such a reentrant call, though unlikely, can happen if a GC pass invokes the finalizer for a multiprocessing object such as SemLock.

  • gh-109653: Reduce the import time of typing by around a third. Patch by Alex Waygood.

  • gh-109649: Add os.process_cpu_count() function to get the number of logical CPUs usable by the calling thread of the current process. Patch by Victor Stinner.

  • gh-74481: Add set_error_mode related constants in msvcrt module in Python debug build.

  • gh-109613: Fix os.stat() and os.DirEntry.stat(): check for exceptions. Previously, on Python built in debug mode, these functions could trigger a fatal Python error (and abort the process) when a function succeeded with an exception set. Patch by Victor Stinner.

  • gh-109599: Expose the type of PyCapsule objects as types.CapsuleType.

  • gh-109109: You can now get the raw TLS certificate chains from TLS connections via ssl.SSLSocket.get_verified_chain() and ssl.SSLSocket.get_unverified_chain() methods.

    Contributed by Mateusz Nowak.

  • gh-109559: Update unicodedata database to Unicode 15.1.0.

  • gh-109543: Remove unnecessary hasattr() check during typing.TypedDict creation.

  • gh-109495: Remove unnecessary extra __slots__ in datetime's pure python implementation to reduce memory size, as they are defined in the superclass. Patch by James Hilton-Balfe

  • gh-109461: logging: Use a context manager for lock acquisition.

  • gh-109096: http.server.CGIHTTPRequestHandler has been deprecated for removal in 3.15. Its design is old and the web world has long since moved beyond CGI.

  • gh-109409: Fix error when it was possible to inherit a frozen dataclass from multiple parents some of which were possibly not frozen.

  • gh-109375: The pdb alias command now prevents registering aliases without arguments.

  • gh-109319: Deprecate the dis.HAVE_ARGUMENT field in favour of dis.hasarg.

  • gh-107219: Fix a race condition in concurrent.futures. When a process in the process pool was terminated abruptly (while the future was running or pending), close the connection write end. If the call queue is blocked on sending bytes to a worker process, closing the connection write end interrupts the send, so the queue can be closed. Patch by Victor Stinner.

  • gh-66143: The codecs.CodecInfo object has been made copyable and pickleable. Patched by Robert Lehmann and Furkan Onder.

  • gh-109187: pathlib.Path.resolve() now treats symlink loops like other errors: in strict mode, OSError is raised, and in non-strict mode, no exception is raised.

  • gh-50644: Attempts to pickle or create a shallow or deep copy of codecs streams now raise a TypeError. Previously, copying failed with a RecursionError, while pickling produced wrong results that eventually caused unpickling to fail with a RecursionError.

  • gh-109174: Add support of types.SimpleNamespace in copy.replace().

  • gh-109164: pdb: Replace getopt with argparse for parsing command line arguments.

  • gh-109151: Enable readline editing features in the sqlite3 command-line interface (python -m sqlite3).

  • gh-108987: Fix _thread.start_new_thread() race condition. If a thread is created during Python finalization, the newly spawned thread now exits immediately instead of trying to access freed memory and lead to a crash. Patch by Victor Stinner.

  • gh-108682: Enum: require names=() or type=... to create an empty enum using the functional syntax.

  • gh-109033: Exceptions raised by os.utime builtin function now include the related filename

  • gh-108843: Fix an issue in ast.unparse() when unparsing f-strings containing many quote types.

  • gh-108469: ast.unparse() now supports new f-string syntax introduced in Python 3.12. Note that the f-string quotes are reselected for simplicity under the new syntax. (Patch by Steven Sun)

  • gh-108751: Add copy.replace() function which allows to create a modified copy of an object. It supports named tuples, dataclasses, and many other objects.

  • gh-108682: Enum: raise TypeError if super().__new__() is called from a custom __new__.

  • gh-108278: Deprecate passing the callback callable by keyword for the following sqlite3.Connection APIs:

    The affected parameters will become positional-only in Python 3.15.

    Patch by Erlend E. Aasland.

  • gh-105829: Fix concurrent.futures.ProcessPoolExecutor deadlock

  • gh-108295: Fix crashes related to use of weakrefs on typing.TypeVar.

  • gh-108463: Make expressions/statements work as expected in pdb

  • gh-108277: Add os.timerfd_create(), os.timerfd_settime(), os.timerfd_gettime(), os.timerfd_settime_ns(), and os.timerfd_gettime_ns() to provide a low level interface for Linux’s timer notification file descriptor.

  • gh-107811: tarfile: extraction of members with overly large UID or GID (e.g. on an OS with 32-bit id_t) now fails in the same way as failing to set the ID.

  • gh-64662: Fix support for virtual tables in sqlite3.Connection.iterdump(). Patch by Aviv Palivoda.

  • gh-108111: Fix a regression introduced in gh-101251 for 3.12, resulting in an incorrect offset calculation in gzip.GzipFile.seek().

  • gh-108294: time.sleep() now raises an auditing event.

  • gh-108278: Deprecate passing name, number of arguments, and the callable as keyword arguments, for the following sqlite3.Connection APIs:

    The affected parameters will become positional-only in Python 3.15.

    Patch by Erlend E. Aasland.

  • gh-108322: Speed-up NormalDist.samples() by using the inverse CDF method instead of calling random.gauss().

  • gh-83417: Add the ability for venv to create a .gitignore file which causes the created environment to be ignored by Git. It is on by default when venv is called via its CLI.

  • gh-105736: Harmonized the pure Python version of OrderedDict with the C version. Now, both versions set up their internal state in __new__. Formerly, the pure Python version did the set up in __init__.

  • gh-108083: Fix bugs in the constructor of sqlite3.Connection and sqlite3.Connection.close() where exceptions could be leaked. Patch by Erlend E. Aasland.

  • gh-107932: Fix dis module to properly report and display bytecode that do not have source lines.

  • gh-105539: sqlite3 now emits an ResourceWarning if a sqlite3.Connection object is not closed explicitly. Patch by Erlend E. Aasland.

  • gh-107995: The __module__ attribute on instances of functools.cached_property is now set to the name of the module in which the cached_property is defined, rather than «functools». This means that doctests in cached_property docstrings are now properly collected by the doctest module. Patch by Tyler Smart.

  • gh-107963: Fix multiprocessing.set_forkserver_preload() to check the given list of modules names. Patch by Donghee Na.

  • gh-106242: Fixes os.path.normpath() to handle embedded null characters without truncating the path.

  • gh-81555: xml.dom.minidom now only quotes " in attributes.

  • gh-50002: xml.dom.minidom now preserves whitespaces in attributes.

  • gh-93057: Passing more than one positional argument to sqlite3.connect() and the sqlite3.Connection constructor is deprecated. The remaining parameters will become keyword-only in Python 3.15. Patch by Erlend E. Aasland.

  • gh-76913: Add merge_extra parameter/feature to logging.LoggerAdapter

  • gh-107913: Fix possible losses of errno and winerror values in OSError exceptions if they were cleared or modified by the cleanup code before creating the exception object.

  • gh-107845: tarfile.data_filter() now takes the location of symlinks into account when determining their target, so it will no longer reject some valid tarballs with LinkOutsideDestinationError.

  • gh-107812: Extend socket’s netlink support to the FreeBSD platform.

  • gh-107805: Fix signatures of module-level generated functions in turtle.

  • gh-107782: pydoc is now able to show signatures which are not representable in Python, e.g. for getattr and dict.pop.

  • gh-56166: Deprecate passing optional arguments maxsplit, count and flags in module-level functions re.split(), re.sub() and re.subn() as positional. They should only be passed by keyword.

  • gh-107710: Speed up logging.getHandlerNames().

  • gh-107715: Fix doctest.DocTestFinder.find() in presence of class names with special characters. Patch by Gertjan van Zwieten.

  • gh-100814: Passing a callable object as an option value to a Tkinter image now raises the expected TclError instead of an AttributeError.

  • gh-72684: Add tkinter widget methods: tk_busy_hold(), tk_busy_configure(), tk_busy_cget(), tk_busy_forget(), tk_busy_current(), and tk_busy_status().

  • gh-106684: Raise ResourceWarning when asyncio.StreamWriter is not closed leading to memory leaks. Patch by Kumar Aditya.

  • gh-107465: Add pathlib.Path.from_uri() classmethod.

  • gh-107077: Seems that in some conditions, OpenSSL will return SSL_ERROR_SYSCALL instead of SSL_ERROR_SSL when a certification verification has failed, but the error parameters will still contain ERR_LIB_SSL and SSL_R_CERTIFICATE_VERIFY_FAILED. We are now detecting this situation and raising the appropriate ssl.SSLCertVerificationError. Patch by Pablo Galindo

  • gh-107576: Fix types.get_original_bases() to only return __orig_bases__ if it is present on cls directly. Patch by James Hilton-Balfe.

  • gh-105481: Remove opcode.is_pseudo, opcode.MIN_PSEUDO_OPCODE and opcode.MAX_PSEUDO_OPCODE, which were added in 3.12, were never documented and were not intended to be used externally.

  • gh-105481: opcode.ENABLE_SPECIALIZATION (which was added in 3.12 but never documented or intended for external usage) is moved to _opcode.ENABLE_SPECIALIZATION where tests can access it.

  • gh-107396: tarfiles; Fixed use before assignment of self.exception for gzip decompression

  • gh-107409: Set __wrapped__ attribute in reprlib.recursive_repr().

  • gh-107406: Implement new __repr__() method for struct.Struct. Now it returns Struct(<format repr>).

  • gh-107369: Optimize textwrap.indent(). It is ~30% faster for large input. Patch by Inada Naoki.

  • gh-78722: Fix issue where pathlib.Path.iterdir() did not raise OSError until iterated.

  • gh-105578: Deprecate typing.AnyStr in favor of the new Type Parameter syntax. See PEP 695.

  • gh-62519: Make gettext.pgettext() search plural definitions when translation is not found.

  • gh-107089: Shelves opened with shelve.open() have a much faster clear() method. Patch by James Cave.

  • gh-82500: Fix overflow on 32-bit systems with asyncio os.sendfile() implementation.

  • gh-83006: Document behavior of shutil.disk_usage() for non-mounted filesystems on Unix.

  • gh-65495: Use lowercase mail from and rcpt to in smptlib.SMTP.

  • gh-106186: Do not report MultipartInvariantViolationDefect defect when the email.parser.Parser class is used to parse emails with headersonly=True.

  • gh-105002: Fix invalid result from PurePath.relative_to() method when attempting to walk a «..» segment in other with walk_up enabled. A ValueError exception is now raised in this case.

  • gh-106739: Add the rtype_cache to the warning message (as an addition to the type of leaked objects and the number of leaked objects already included in the message) to make debugging leaked objects easier when the multiprocessing resource tracker process finds leaked objects at shutdown. This helps more quickly identify what was leaked and/or why the leaked object was not properly cleaned up.

  • gh-106751: Optimize SelectSelector.select() for many iteration case. Patch By Donghee Na.

  • gh-106751: Optimize _PollLikeSelector.select() for many iteration case.

  • gh-106751: Optimize KqueueSelector.select() for many iteration case. Patch By Donghee Na.

  • gh-106831: Fix potential missing NULL check of d2i_SSL_SESSION result in _ssl.c.

  • gh-105481: The various opcode lists in the dis module are now generated from bytecodes.c instead of explicitly constructed in opcode.py.

  • gh-106727: Make inspect.getsource() smarter for class for same name definitions

  • gh-106789: Remove import of pprint from sysconfig.

  • gh-105726: Added __slots__ to contextlib.AbstractContextManager and contextlib.AbstractAsyncContextManager so that child classes can use __slots__.

  • gh-106774: Update the bundled copy of pip to version 23.2.1.

  • gh-106751: selectors: Optimize EpollSelector.select() code by moving some code outside of the loop.

  • gh-106752: Fixed several bugs in zipfile.Path, including: in zipfile.Path.match(), Windows separators are no longer honored (and never were meant to be); Fixed name/suffix/suffixes/stem operations when no filename is present and the Path is not at the root of the zipfile; Reworked glob for performance and more correct matching behavior.

  • gh-105293: Remove call to SSL_CTX_set_session_id_context during client side context creation in the ssl module.

  • gh-106734: Disable tab completion in multiline mode of pdb

  • gh-105481: Expose opcode metadata through _opcode.

  • gh-106670: Add the new exceptions command to the Pdb debugger. It makes it possible to move between chained exceptions when using post mortem debugging.

  • gh-106602: Add __copy__ and __deepcopy__ in enum

  • gh-106664: selectors: Add _SelectorMapping.get() method and optimize _SelectorMapping.__getitem__().

  • gh-106628: Speed up parsing of emails by about 20% by not compiling a new regular expression for every single email.

  • gh-89427: Set the environment variable VIRTUAL_ENV_PROMPT at venv activation, even when VIRTUAL_ENV_DISABLE_PROMPT is set.

  • gh-106530: Revert a change to colorsys.rgb_to_hls() that caused division by zero for certain almost-white inputs. Patch by Terry Jan Reedy.

  • gh-106584: Fix exit code for unittest if all tests are skipped. Patch by Egor Eliseev.

  • gh-106566: Optimize (?!) (pattern which always fails) in regular expressions.

  • gh-106554: selectors: Reduce Selector overhead by using a dict.get() to lookup file descriptors.

  • gh-106558: Remove ref cycle in callers of convert_to_error() by deleting result from scope in a finally block.

  • gh-100502: Add pathlib.PurePath.pathmod class attribute that stores the implementation of os.path used for low-level path operations: either posixpath or ntpath.

  • gh-106527: Reduce overhead to add and remove asyncio readers and writers.

  • gh-106524: Fix crash in _sre.template() with templates containing invalid group indices.

  • gh-106531: Removed _legacy and the names it provided from importlib.resources: Resource, contents, is_resource, open_binary, open_text, path, read_binary, and read_text.

  • gh-106052: re module: fix the matching of possessive quantifiers in the case of a subpattern containing backtracking.

  • gh-106510: Improve debug output for atomic groups in regular expressions.

  • gh-106503: Fix ref cycle in asyncio._SelectorSocketTransport by removing _write_ready in close.

  • gh-105497: Fix flag mask inversion when unnamed flags exist.

  • gh-90876: Prevent multiprocessing.spawn from failing to import in environments where sys.executable is None. This regressed in 3.11 with the addition of support for path-like objects in multiprocessing.

  • gh-106403: Instances of typing.TypeVar, typing.ParamSpec, typing.ParamSpecArgs, typing.ParamSpecKwargs, and typing.TypeVarTuple once again support weak references, fixing a regression introduced in Python 3.12.0 beta 1. Patch by Jelle Zijlstra.

  • gh-89812: Add private pathlib._PathBase class, which provides experimental support for virtual filesystems, and may be made public in a future version of Python.

  • gh-106292: Check for an instance-dict cached value in the __get__() method of functools.cached_property(). This better matches the pre-3.12 behavior and improves compatibility for users subclassing functools.cached_property() and adding a __set__() method.

  • gh-106350: Detect possible memory allocation failure in the libtommath function mp_init() used by the _tkinter module.

  • gh-106330: Fix incorrect matching of empty paths in pathlib.PurePath.match(). This bug was introduced in Python 3.12.0 beta 1.

  • gh-106309: Deprecate typing.no_type_check_decorator(). No major type checker ever added support for this decorator. Patch by Alex Waygood.

  • gh-102541: Make pydoc.doc() catch bad module ImportError when output stream is not None.

  • gh-106263: Fix crash when calling repr with a manually constructed SignalDict object. Patch by Charlie Zhao.

  • gh-106236: Replace assert statements with raise RuntimeError in threading, so that _DummyThread cannot be joined even with -OO.

  • gh-106238: Fix rare concurrency bug in lock acquisition by the logging package.

  • gh-106152: Added PY_THROW event hook for cProfile for generators

  • gh-106075: Added asyncio.taskgroups.__all__ to asyncio.__all__ for export in star imports.

  • gh-104527: Zipapp will now skip over appending an archive to itself.

  • gh-106046: Improve the error message from os.fspath() if called on an object where __fspath__ is set to None. Patch by Alex Waygood.

  • gh-105987: Fix crash due to improper reference counting in asyncio eager task factory internal routines.

  • gh-105974: Fix bug where a typing.Protocol class that had one or more non-callable members would raise TypeError when issubclass() was called against it, even if it defined a custom __subclasshook__ method. The behaviour in Python 3.11 and lower – which has now been restored – was not to raise TypeError in these situations if a custom __subclasshook__ method was defined. Patch by Alex Waygood.

  • gh-96145: Reverted addition of json.AttrDict.

  • gh-89812: Add pathlib.UnsupportedOperation, which is raised instead of NotImplementedError when a path operation isn’t supported.

  • gh-105808: Fix a regression introduced in gh-101251 for 3.12, causing gzip.GzipFile.flush() to not flush the compressor (nor pass along the zip_mode argument).

  • gh-105481: stack_effect() no longer raises an exception if an oparg is provided for an opcode that doesn’t use its arg, or when it is not provided for an opcode that does use it. In the latter case, the stack effect is returned for oparg=0.

  • gh-104799: Enable ast.unparse() to unparse function and class definitions created without the new type_params field from PEP 695. Patch by Jelle Zijlstra.

  • gh-105793: Add follow_symlinks keyword-only argument to pathlib.Path.is_dir() and is_file(), defaulting to True.

  • gh-105570: Deprecate two methods of creating typing.TypedDict classes with 0 fields using the functional syntax: TD = TypedDict("TD") and TD = TypedDict("TD", None). Both will be disallowed in Python 3.15. To create a TypedDict class with 0 fields, either use class TD(TypedDict): pass or TD = TypedDict("TD", {}).

  • gh-105745: Fix webbrowser.Konqueror.open method.

  • gh-105733: ctypes: Deprecate undocumented ctypes.SetPointerType() and ctypes.ARRAY() functions. Patch by Victor Stinner.

  • gh-105687: Remove deprecated re.template, re.T, re.TEMPLATE, sre_constans.SRE_FLAG_TEMPLATE.

  • gh-105684: Supporting asyncio.Task.set_name() is now mandatory for third party task implementations. The undocumented _set_task_name() function (deprecated since 3.8) has been removed. Patch by Kumar Aditya.

  • gh-105375: Fix a bug in _Unpickler_SetInputStream() where an exception could end up being overwritten in case of failure.

  • gh-105626: Change the default return value of http.client.HTTPConnection.get_proxy_response_headers() to be None and not {}.

  • gh-105375: Fix bugs in sys where exceptions could end up being overwritten because of deferred error handling.

  • gh-105605: Harden pyexpat error handling during module initialisation to prevent exceptions from possibly being overwritten, and objects from being dereferenced twice.

  • gh-105375: Fix bug in decimal where an exception could end up being overwritten.

  • gh-105375: Fix bugs in _datetime where exceptions could be overwritten in case of module initialisation failure.

  • gh-105375: Fix bugs in _ssl initialisation which could lead to leaked references and overwritten exceptions.

  • gh-105375: Fix a bug in array.array where an exception could end up being overwritten.

  • gh-105375: Fix bugs in _ctypes where exceptions could end up being overwritten.

  • gh-105375: Fix a bug in the posix module where an exception could be overwritten.

  • gh-105375: Fix bugs in _elementtree where exceptions could be overwritten.

  • gh-105375: Fix bugs in zoneinfo where exceptions could be overwritten.

  • gh-105375: Fix bugs in errno where exceptions could be overwritten.

  • gh-105566: Deprecate creating a typing.NamedTuple class using keyword arguments to denote the fields (NT = NamedTuple("NT", x=int, y=str)). This will be disallowed in Python 3.15. Use the class-based syntax or the functional syntax instead.

    Two methods of creating NamedTuple classes with 0 fields using the functional syntax are also deprecated, and will be disallowed in Python 3.15: NT = NamedTuple("NT") and NT = NamedTuple("NT", None). To create a NamedTuple class with 0 fields, either use class NT(NamedTuple): pass or NT = NamedTuple("NT", []).

  • gh-105545: Remove deprecated in 3.11 webbrowser.MacOSXOSAScript._name attribute.

  • gh-105497: Fix flag inversion when alias/mask members exist.

  • gh-105509: typing.Annotated is now implemented as an instance of typing._SpecialForm rather than a class. This should have no user-facing impact for users of the typing module public API.

  • gh-105375: Fix bugs in pickle where exceptions could be overwritten.

  • gh-70303: Emit FutureWarning from pathlib.Path.glob() and rglob() if the given pattern ends with «**». In a future Python release, patterns with this ending will match both files and directories. Add a trailing slash to only match directories.

  • gh-105375: Fix a bug in sqlite3 where an exception could be overwritten in the collation callback.

  • gh-105382: Remove cafile, capath and cadefault parameters of the urllib.request.urlopen() function, deprecated in Python 3.6. Patch by Victor Stinner.

  • gh-105376: logging: Remove undocumented and untested Logger.warn() and LoggerAdapter.warn() methods and logging.warn() function. Deprecated since Python 3.3, they were aliases to the logging.Logger.warning() method, logging.LoggerAdapter.warning() method and logging.warning() function. Patch by Victor Stinner.

  • gh-105332: Revert pickling method from by-name back to by-value.

  • gh-104554: Add RTSPS scheme support in urllib.parse

  • gh-105292: Add option to traceback.format_exception_only() to recurse into the nested exception of a BaseExceptionGroup.

  • gh-105280: Fix bug where isinstance([], collections.abc.Mapping) could evaluate to True if garbage collection happened at the wrong time. The bug was caused by changes to the implementation of typing.Protocol in Python 3.12.

  • gh-80480: array: Add 'w' typecode that represents Py_UCS4.

  • gh-105239: Fix longstanding bug where issubclass(object, typing.Protocol) would evaluate to True in some edge cases. Patch by Alex Waygood.

  • gh-104310: In the beta 1 release we added a utility function for extension module authors, to use when testing their module for support in multiple interpreters or under a per-interpreter GIL. The name of that function has changed from allowing_all_extensions to _incompatible_extension_module_restrictions. The default for the «disable_check» argument has change from True to False, to better match the new function name.

  • gh-105080: Fixed inconsistent signature on derived classes for inspect.signature()

  • gh-105144: Fix a recent regression in the typing module. The regression meant that doing class Foo(X, typing.Protocol), where X was a class that had abc.ABCMeta as its metaclass, would then cause subsequent isinstance(1, X) calls to erroneously raise TypeError. Patch by Alex Waygood.

  • gh-62948: The io.IOBase finalizer now logs the close() method errors with sys.unraisablehook. Previously, errors were ignored silently by default, and only logged in Python Development Mode or on Python built on debug mode. Patch by Victor Stinner.

  • gh-105096: wave: Deprecate the getmark(), setmark() and getmarkers() methods of the wave.Wave_read and wave.Wave_write classes. They will be removed in Python 3.15. Patch by Victor Stinner.

  • gh-104992: Remove the untested and undocumented unittest.TestProgram.usageExit() method, deprecated in Python 3.11. Patch by Hugo van Kemenade.

  • gh-104996: Improve performance of pathlib.PurePath initialisation by deferring joining of paths when multiple arguments are given.

  • gh-101588: Deprecate undocumented copy/deepcopy/pickle support for itertools.

  • gh-103631: Fix pathlib.PurePosixPath(pathlib.PureWindowsPath(...)) not converting path separators to restore 3.11 compatible behavior.

  • gh-104947: Make comparisons between pathlib.PureWindowsPath objects consistent across Windows and Posix to match 3.11 behavior.

  • gh-104773: PEP 594: Remove the audioop module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the aifc module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the uu module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104935: Fix bugs with the interaction between typing.runtime_checkable() and typing.Generic that were introduced by the PEP 695 implementation. Patch by Jelle Zijlstra.

  • gh-104773: PEP 594: Remove the crypt module and its private _crypt extension, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the nis module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104898: Add missing __slots__ to os.PathLike.

  • gh-104773: PEP 594: Remove the xdrlib module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the nntplib module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104886: Remove the undocumented configparser.LegacyInterpolation class, deprecated in the docstring since Python 3.2, and with a deprecation warning since Python 3.11. Patch by Hugo van Kemenade.

  • gh-104786: Remove kwargs-based typing.TypedDict creation

  • gh-104876: Remove the turtle.RawTurtle.settiltangle() method, deprecated in docs since Python 3.1 and with a deprecation warning since Python 3.11. Patch by Hugo van Kemenade.

  • gh-104773: PEP 594: Removed the msilib package, deprecated in Python 3.11.

  • gh-104773: PEP 594: Remove the spwd module, deprecated in Python 3.11: the python-pam project can be used instead. Patch by Victor Stinner.

  • gh-75552: Removed the tkinter.tix module, deprecated since Python 3.6.

  • gh-104773: PEP 594: Remove the chunk module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the mailcap module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the sunau module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104780: PEP 594: Remove the ossaudiodev module, deprecated in Python 3.11. Patch Victor Stinner.

  • gh-104773: PEP 594: Remove the pipes module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104873: Add typing.get_protocol_members() to return the set of members defining a typing.Protocol. Add typing.is_protocol() to check whether a class is a typing.Protocol. Patch by Jelle Zijlstra.

  • gh-104874: Document the __name__ and __supertype__ attributes of typing.NewType. Patch by Jelle Zijlstra.

  • gh-104835: Removed the following unittest functions, deprecated in Python 3.11:

    • unittest.findTestCases()

    • unittest.makeSuite()

    • unittest.getTestCaseNames()

    Use TestLoader methods instead:

    Patch by Hugo van Kemenade.

  • gh-104804: Remove the untested and undocumented webbrowser MacOSX class, deprecated in Python 3.11. Patch by Hugo van Kemenade.

  • gh-83863: Support for using pathlib.Path objects as context managers has been removed. Before Python 3.9, exiting the context manager marked a path as «closed», which caused some (but not all!) methods to raise when called. Since Python 3.9, using a path as a context manager does nothing.

  • gh-104799: Adjust the location of the (see PEP 695) type_params field on ast.ClassDef, ast.AsyncFunctionDef, and ast.FunctionDef to better preserve backward compatibility. Patch by Jelle Zijlstra

  • gh-104797: Allow typing.Protocol classes to inherit from collections.abc.Buffer. Patch by Jelle Zijlstra.

  • gh-104783: Remove locale.resetlocale() function deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104780: Remove the 2to3 program and the lib2to3 module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the telnetlib module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the imghdr module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the cgi and cgitb modules, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104773: PEP 594: Remove the sndhdr module, deprecated in Python 3.11. Patch by Victor Stinner.

  • gh-104372: On Linux where subprocess can use the vfork() syscall for faster spawning, prevent the parent process from blocking other threads by dropping the GIL while it waits for the vfork’ed child process exec() outcome. This prevents spawning a binary from a slow filesystem from blocking the rest of the application.

  • gh-99108: We now release the GIL around built-in hashlib computations of reasonable size for the SHA families and MD5 hash functions, matching what our OpenSSL backed hash computations already does.

  • gh-102613: Improve performance of pathlib.Path.glob() when expanding a pattern with a non-terminal «**» component by filtering walked paths through a regular expression, rather than calling os.scandir() more than once on each directory.

  • gh-104399: Prepare the _tkinter module for building with Tcl 9.0 and future libtommath by replacing usage of deprecated functions mp_to_unsigned_bin_n() and mp_unsigned_bin_size() when necessary.

  • gh-102676: Add fields start_offset, cache_offset, end_offset, baseopname, baseopcode, jump_target and oparg to dis.Instruction.

  • gh-103558: Fixed parent argument validation mechanism of argparse. Improved test coverage.

  • gh-103464: Provide helpful usage messages when parsing incorrect pdb commands.

  • gh-103384: Generalize the regex pattern BaseConfigurator.INDEX_PATTERN to allow spaces and non-alphanumeric characters in keys.

  • gh-103124: Added multiline statement support for pdb

  • gh-101162: Forbid using builtins.issubclass() with types.GenericAlias as the first argument.

  • gh-103200: Fix cache repopulation semantics of zipimport.invalidate_caches(). The cache is now repopulated upon retrieving files with an invalid cache, not when the cache is invalidated.

  • gh-100061: Fix a bug that causes wrong matches for regular expressions with possessive qualifier.

  • gh-77609: Add follow_symlinks argument to pathlib.Path.glob() and rglob(), defaulting to false.

  • gh-102541: Hide traceback in help() prompt, when import failed.

  • gh-102120: Added a stream mode to tarfile that allows for reading archives without caching info about the inner files.

  • gh-102029: Deprecate passing any arguments to threading.RLock().

  • gh-88233: Refactored zipfile._strip_extra to use higher level abstractions for extras instead of a heavy-state loop.

  • gh-102024: Reduce calls of _idle_semaphore.release() in concurrent.futures.thread._worker().

  • gh-73435: Add support for recursive wildcards in pathlib.PurePath.match().

  • gh-84867: unittest.TestLoader no longer loads test cases from exact unittest.TestCase and unittest.FunctionTestCase classes.

  • gh-99203: Restore following CPython <= 3.10.5 behavior of shutil.make_archive(): do not create an empty archive if root_dir is not a directory, and, in that case, raise FileNotFoundError or NotADirectoryError regardless of format choice. Beyond the brought-back behavior, the function may now also raise these exceptions in dry_run mode.

  • gh-80480: Emit DeprecationWarning for array’s 'u' type code, deprecated in docs since Python 3.3.

  • gh-94924: unittest.mock.create_autospec() now properly returns coroutine functions compatible with inspect.iscoroutinefunction()

  • gh-94777: Fix hanging multiprocessing ProcessPoolExecutor when a child process crashes while data is being written in the call queue.

  • gh-92871: Remove the typing.io and typing.re namespaces, deprecated since Python 3.8. All items are still available from the main typing module.

  • bpo-43633: Improve the textual representation of IPv4-mapped IPv6 addresses (RFC 4291 Sections 2.2, 2.5.5.2) in ipaddress. Patch by Oleksandr Pavliuk.

  • bpo-44850: Improve performance of operator.methodcaller() using the PEP 590 vectorcall convention. Patch by Anthony Lee and Pieter Eendebak.

  • bpo-44185: unittest.mock.mock_open() will call the close() method of the file handle mock when it is exiting from the context manager. Patch by Samet Yaslan.

  • bpo-40988: Improve performance of functools.singledispatchmethod by caching the generated dispatch wrapper. Optimization suggested by frederico. Patch by @mental32, Alex Waygood and Pieter Eendebak.

  • bpo-41768: unittest.mock speccing no longer calls class properties. Patch by Melanie Witt.

  • bpo-18319: Ensure gettext(msg) retrieve translations even if a plural form exists. In other words: gettext(msg) == ngettext(msg, '', 1).

  • bpo-17013: Add ThreadingMock to unittest.mock that can be used to create Mock objects that can wait until they are called. Patch by Karthikeyan Singaravelan and Mario Corchero.

Documentation

Tests

  • gh-110647: Fix test_stress_modifying_handlers() of test_signal. Patch by Victor Stinner.

  • gh-103053: Fix test_tools.test_freeze on FreeBSD: run «make distclean» instead of «make clean» in the copied source directory to remove also the «python» program. Patch by Victor Stinner.

  • gh-110167: Fix a deadlock in test_socket when server fails with a timeout but the client is still running in its thread. Don’t hold a lock to call cleanup functions in doCleanups(). One of the cleanup function waits until the client completes, whereas the client could deadlock if it called addCleanup() in such situation. Patch by Victor Stinner.

  • gh-110388: Add tests for tty.

  • gh-81002: Add tests for termios.

  • gh-110367: regrtest: When using worker processes (-jN) with –verbose3 option, regrtest can now display the worker output even if a worker process does crash. Previously, sys.stdout and sys.stderr were replaced and so the worker output was lost on a crash. Patch by Victor Stinner.

  • gh-110267: Add tests for pickling and copying PyStructSequence objects. Patched by Xuehai Pan.

  • gh-110171: libregrtest now always sets and shows random.seed, so tests are more reproducible. Use --randseed flag to pass the explicit random seed for tests.

  • gh-110152: Remove Tools/scripts/run_tests.py and make hostrunnertest. Just run ./python -m test --slow-ci, make buildbottest or make test instead. Python test runner (regrtest) now handles cross-compilation and HOSTRUNNER. It also adds options to Python such fast -u -E -W default -bb when --fast-ci or --slow-ci option is used. Patch by Victor Stinner.

  • gh-110031: Skip test_threading tests using thread+fork if Python is built with Address Sanitizer (ASAN). Patch by Victor Stinner.

  • gh-110088: Fix test_asyncio timeouts: don’t measure the maximum duration, a test should not measure a CI performance. Only measure the minimum duration when a task has a timeout or delay. Add CLOCK_RES to test_asyncio.utils. Patch by Victor Stinner.

  • gh-109974: Fix race conditions in test_threading lock tests. Wait until a condition is met rather than using time.sleep() with a hardcoded number of seconds. Patch by Victor Stinner.

  • gh-110033: Fix test_interprocess_signal() of test_signal. Make sure that the subprocess.Popen object is deleted before the test raising an exception in a signal handler. Otherwise, Popen.__del__() can get the exception which is logged as Exception ignored in: ... and the test fails. Patch by Victor Stinner.

  • gh-109594: Fix test_timeout() of test_concurrent_futures.test_wait. Remove the future which may or may not complete depending if it takes longer than the timeout or not. Keep the second future which does not complete before wait() timeout. Patch by Victor Stinner.

  • gh-109972: Split test_gdb.py file into a test_gdb package made of multiple tests, so tests can now be run in parallel. Patch by Victor Stinner.

  • gh-109566: regrtest: When --fast-ci or --slow-ci option is used, regrtest now replaces the current process with a new process to add -u -W default -bb -E options to Python. Patch by Victor Stinner.

  • gh-109748: Fix test_zippath_from_non_installed_posix() of test_venv: don’t copy __pycache__/ sub-directories, because they can be modified by other Python tests running in parallel. Patch by Victor Stinner.

  • gh-109739: regrtest: Fix reference leak check on Windows. Disable the load tracker on Windows in the reference leak check mode (-R option). Patch by Victor Stinner.

  • gh-109276: regrtest: When a test fails with «env changed» and the –rerun option is used, the test is now re-run in verbose mode in a fresh process. Patch by Victor Stinner.

  • gh-103053: Skip test_freeze_simple_script() of test_tools.test_freeze if Python is built with ./configure --enable-optimizations, which means with Profile Guided Optimization (PGO): it just makes the test too slow. The freeze tool is tested by many other CIs with other (faster) compiler flags. Patch by Victor Stinner.

  • gh-109580: Skip test_perf_profiler if Python is built with ASAN, MSAN or UBSAN sanitizer. Python does crash randomly in this test on such build. Patch by Victor Stinner.

  • gh-109566: regrtest: Add --fast-ci and --slow-ci options. --fast-ci uses a default timeout of 10 minutes and -u all,-cpu (skip slowest tests). --slow-ci uses a default timeout of 20 minutes and -u all (run all tests). Patch by Victor Stinner.

  • gh-109425: libregrtest now decodes stdout of test worker processes with the «backslashreplace» error handler to log corrupted stdout, instead of failing with an error and not logging the stdout. Patch by Victor Stinner.

  • gh-109396: Fix test_socket.test_hmac_sha1() in FIPS mode. Use a longer key: FIPS mode requires at least of at least 112 bits. The previous key was only 32 bits. Patch by Victor Stinner.

  • gh-104736: Fix test_gdb on Python built with LLVM clang 16 on Linux ppc64le (ex: Fedora 38). Search patterns in gdb «bt» command output to detect when gdb fails to retrieve the traceback. For example, skip a test if Backtrace stopped: frame did not save the PC is found. Patch by Victor Stinner.

  • gh-109276: libregrtest now calls random.seed() before running each test file when -r/--randomize command line option is used. Moreover, it’s also called in worker processes. It should help to make tests more deterministic. Previously, it was only called once in the main process before running all test files and it was not called in worker processes. Patch by Victor Stinner.

  • gh-109276: libregrtest now uses a separated file descriptor to write test result as JSON. Previously, if a test wrote debug messages late around the JSON, the main test process failed to parse JSON. Patch by Victor Stinner.

  • gh-108996: Fix and enable test_msvcrt.

  • gh-109237: Fix test_site.test_underpth_basic() when the working directory contains at least one non-ASCII character: encode the ._pth file to UTF-8 and enable the UTF-8 Mode to use UTF-8 for the child process stdout. Patch by Victor Stinner.

  • gh-109230: Fix test_pyexpat.test_exception(): it can now be run from a directory different than Python source code directory. Before, the test failed in this case. Skip the test if Modules/pyexpat.c source is not available. Skip also the test on Python implementations other than CPython. Patch by Victor Stinner.

  • gh-108996: Add tests for msvcrt.

  • gh-109015: Fix test_asyncio, test_imaplib and test_socket tests on FreeBSD if the TCP blackhole is enabled (sysctl net.inet.tcp.blackhole). Skip the few tests which failed with ETIMEDOUT which such non standard configuration. Currently, the FreeBSD GCP image enables TCP and UDP blackhole (sysctl net.inet.tcp.blackhole=2 and sysctl net.inet.udp.blackhole=1). Patch by Victor Stinner.

  • gh-91960: Skip test_gdb if gdb is unable to retrieve Python frame objects: if a frame is <optimized out>. When Python is built with «clang -Og», gdb can fail to retrieve the frame parameter of _PyEval_EvalFrameDefault(). In this case, tests like py_bt() are likely to fail. Without getting access to Python frames, python-gdb.py is mostly clueless on retrieving the Python traceback. Moreover, test_gdb is no longer skipped on macOS if Python is built with Clang. Patch by Victor Stinner.

  • gh-108962: Skip test_tempfile.test_flags() if chflags() fails with «OSError: [Errno 45] Operation not supported» (ex: on FreeBSD 13). Patch by Victor Stinner.

  • gh-91960: FreeBSD 13.2 CI coverage for pull requests is now provided by Cirrus-CI (a hosted CI service that supports Linux, macOS, Windows, and FreeBSD).

  • gh-89392: Removed support of test_main() function in tests. They now always use normal unittest test runner.

  • gh-108851: Fix test_tomllib recursion tests for WASI buildbots: reduce the recursion limit and compute the maximum nested array/dict depending on the current available recursion limit. Patch by Victor Stinner.

  • gh-108851: Add get_recursion_available() and get_recursion_depth() functions to the test.support module. Patch by Victor Stinner.

  • gh-108834: Add --fail-rerun option option to regrtest: if a test failed when then passed when rerun in verbose mode, exit the process with exit code 2 (error), instead of exit code 0 (success). Patch by Victor Stinner.

  • gh-108834: Rename regrtest --verbose2 option (-w) to --rerun. Keep --verbose2 as a deprecated alias. Patch by Victor Stinner.

  • gh-108834: When regrtest reruns failed tests in verbose mode (./python -m test --rerun), tests are now rerun in fresh worker processes rather than being executed in the main process. If a test does crash or is killed by a timeout, the main process can detect and handle the killed worker process. Tests are rerun in parallel if the -jN option is used to run tests in parallel. Patch by Victor Stinner.

  • gh-108822: regrtest now computes statistics on all tests: successes, failures and skipped. test_netrc, test_pep646_syntax and test_xml_etree now return results in their test_main() function. Patch by Victor Stinner and Alex Waygood.

  • gh-108794: The doctest.DocTestRunner.run() method now counts the number of skipped tests. Add doctest.DocTestRunner.skips and doctest.TestResults.skipped attributes. Patch by Victor Stinner.

  • gh-108388: Convert test_concurrent_futures to a package of 7 sub-tests. Patch by Victor Stinner.

  • gh-108388: Split test_multiprocessing_fork, test_multiprocessing_forkserver and test_multiprocessing_spawn into test packages. Each package is made of 4 sub-tests: processes, threads, manager and misc. It allows running more tests in parallel and so reduce the total test duration. Patch by Victor Stinner.

  • gh-105776: Fix test_cppext when the C compiler command -std=c11 option: remove -std= options from the compiler command. Patch by Victor Stinner.

  • gh-107652: Set up CIFuzz to run fuzz targets in GitHub Actions. Patch by Illia Volochii.

  • gh-107237: test_logging: Fix test_udp_reconnection() by increasing the timeout from 100 ms to 5 minutes (LONG_TIMEOUT). Patch by Victor Stinner.

  • gh-107178: Add the C API test for functions in the Mapping Protocol, the Sequence Protocol and some functions in the Object Protocol.

  • gh-106714: test_capi: Fix test_no_FatalError_infinite_loop() to no longer write a coredump, by using test.support.SuppressCrashReport. Patch by Victor Stinner.

  • gh-104090: Avoid creating a reference to the test object in collectedDurations().

  • gh-106752: Moved tests for zipfile.Path into Lib/test/test_zipfile/_path. Made zipfile._path a package.

  • gh-106690: Add .coveragerc to cpython repository for use with coverage package.

  • gh-101634: When running the Python test suite with -jN option, if a worker stdout cannot be decoded from the locale encoding report a failed testn so the exitcode is non-zero. Patch by Victor Stinner.

  • gh-105084: When the Python build is configured --with-wheel-pkg-dir, tests requiring the setuptools and wheel wheels will search for the wheels in WHEEL_PKG_DIR.

  • gh-81005: String tests are modified to reflect that str and unicode are merged in Python 3. Patch by Daniel Fortunov.

  • gh-103186: Suppress and assert expected RuntimeWarnings in test_sys_settrace.py

  • gh-69714: Add additional tests to calendar to achieve full test coverage.

Build

  • gh-103053: «make check-clean-src» now also checks if the «python» program is found in the source directory: fail with an error if it does exist. Patch by Victor Stinner.

  • gh-109191: Fix compile error when building with recent versions of libedit.

  • gh-110276: No longer ignore PROFILE_TASK failure silently: command used by Profile Guided Optimization (PGO). Patch by Victor Stinner.

  • gh-109566: Remove make testall target: use make buildbottest instead. Patch by Victor Stinner.

  • gh-109740: The experimental --disable-gil configure flag now includes «t» (for «threaded») in extension ABI tags.

  • gh-109054: Fix building the _testcapi extension on Linux AArch64 which requires linking to libatomic when <cpython/pyatomic.h> is used: the _Py_atomic_or_uint64() function requires libatomic __atomic_fetch_or_8() on this platform. The configure script now checks if linking to libatomic is needed and generates a new LIBATOMIC variable used to build the _testcapi extension. Patch by Victor Stinner.

  • gh-63760: Fix Solaris build: no longer redefine the gethostname() function. Solaris defines the function since 2005. Patch by Victor Stinner, original patch by Jakub Kulík.

  • gh-108740: Fix a race condition in make regen-all. The deepfreeze.c source and files generated by Argument Clinic are now generated or updated before generating «global objects». Previously, some identifiers may miss depending on the order in which these files were generated. Patch by Victor Stinner.

  • gh-108634: Python built with configure --with-trace-refs (tracing references) is now ABI compatible with Python release build and debug build. Patch by Victor Stinner.

  • gh-85283: The _stat C extension is now built with the limited C API. Patch by Victor Stinner.

  • gh-108447: Fix x86_64 GNU/Hurd build

  • gh-107814: When calling find_python.bat with -q it did not properly silence the output of nuget. That is now fixed.

  • gh-105481: Remove the make target regen-opcode-targets, merge its work into regen-opcode which repeats most of the calculation. This simplifies the code for the build and reduces code duplication.

  • gh-106881: Check for linux/limits.h before including it in Modules/posixmodule.c.

  • gh-95855: Refactor platform triplet detection code and add detection for MIPS soft float and musl libc.

  • gh-106962: Detect MPI compilers in configure.

  • gh-106118: Fix compilation for platforms without O_CLOEXEC. The issue was introduced with Python 3.12b1 in gh-103295. Patch by Erlend Aasland.

  • gh-105875: SQLite 3.15.2 or newer is required to build the sqlite3 extension module. Patch by Erlend Aasland.

  • gh-90005: Fix a regression in configure where we could end up unintentionally linking with libbsd.

  • gh-102404: Document how to perform a WASI build on Linux. Also add Tools/wasm/build_wasi.sh as a reference implementation of the docs.

  • gh-89886: Autoconf 2.71 and aclocal 1.16.4 is now required to regenerate configure.

  • gh-104692: Include commoninstall as a prerequisite for bininstall

    This ensures that commoninstall is completed before bininstall is started when parallel builds are used (make -j install), and so the python3 symlink is only installed after all standard library modules are installed.

  • gh-101538: Add experimental wasi-threads support. Patch by Takashi Yamamoto.

Windows

  • gh-110437: Allows overriding the source of VC redistributables so that releases can be guaranteed to never downgrade between updates.

  • gh-109286: Update Windows installer to use SQLite 3.43.1.

  • gh-82367: os.path.realpath() now resolves MS-DOS style file names even if the file is not accessible. Patch by Moonsik Park.

  • gh-109991: Update Windows build to use OpenSSL 3.0.11.

  • gh-106242: Fixes realpath() to behave consistently when passed a path containing an embedded null character on Windows. In strict mode, it now raises OSError instead of the unexpected ValueError, and in non-strict mode will make the path absolute.

  • gh-83180: Changes the Python Install Manager to prefer an active virtual environment when the launched script has a shebang line using a Unix-like virtual command, even if the command requests a specific version of Python.

  • gh-106844: Fix integer overflow and truncating by the null character in _winapi.LCMapStringEx() which affects ntpath.normcase().

  • gh-105436: Ensure that an empty environment block is terminated by two null characters, as is required by Windows.

  • gh-105146: Updated the links at the end of the installer to point to Discourse rather than the mailing lists.

  • gh-103646: When installed from the Microsoft Store, pip no longer defaults to per-user installs. However, as the install directory is unwritable, it should automatically decide to do a per-user install anyway. This should resolve issues when pip is passed an option that conflicts with --user.

  • gh-88745: Improve performance of shutil.copy2() by using the operating system’s CopyFile2 function. This may result in subtle changes to metadata copied along with some files, bringing them in line with normal OS behavior.

  • gh-104820: Fixes stat() and related functions on file systems that do not support file ID requests. This includes FAT32 and exFAT.

  • gh-104803: Add os.path.isdevdrive() to detect whether a path is on a Windows Dev Drive. Returns False on platforms that do not support Dev Drive, and is absent on non-Windows platforms.

macOS

  • gh-109286: Update macOS installer to use SQLite 3.43.1.

  • gh-109991: Update macOS installer to use OpenSSL 3.0.11.

  • gh-99079: Update macOS installer to use OpenSSL 3.0.9.

IDLE

  • gh-104719: Remove IDLE’s modification of tokenize.tabsize and test other uses of tokenize data and methods.

Tools/Demos

  • gh-109991: Update GitHub CI workflows to use OpenSSL 3.0.11 and multissltests to use 1.1.1w, 3.0.11, and 3.1.3.

  • gh-108494: Argument Clinic now has a partial support of the Limited API: see documentation in the Python Developer’s Guide Patch by Victor Stinner.

  • gh-107704: It is now possible to deprecate passing keyword arguments for keyword-or-positional parameters with Argument Clinic, using the new / [from X.Y] syntax. (To be read as «positional-only from Python version X.Y».) See documentation in the Python Developer’s Guide for more information.

  • gh-107880: Argument Clinic can now clone __init__() and __new__() methods.

  • gh-104683: Add --exclude option to Argument Clinic CLI.

  • gh-95065: Argument Clinic now supports overriding automatically generated signature by using directive @text_signature. See documentation in the Python Developer’s Guide

  • gh-107609: Fix duplicate module check in Argument Clinic. Previously, a duplicate definition would incorrectly be silently accepted. Patch by Erlend E. Aasland.

  • gh-107467: The Argument Clinic command-line tool now prints to stderr instead of stdout on failure.

  • gh-106970: Fix bugs in the Argument Clinic destination <name> clear command; the destination buffers would never be cleared, and the destination directive parser would simply continue to the fault handler after processing the command. Patch by Erlend E. Aasland.

  • gh-106706: Change bytecode syntax for families to remove redundant name matching pseudo syntax.

  • gh-106359: Argument Clinic now explicitly forbids «kwarg splats» in function calls used as annotations.

  • gh-103186: freeze now fetches CONFIG_ARGS from the original CPython instance the Makefile uses to call utility scripts. Patch by Ijtaba Hussain.

  • gh-95065: It is now possible to deprecate passing parameters positionally with Argument Clinic, using the new * [from X.Y] syntax. (To be read as «keyword-only from Python version X.Y».) See documentation in the Python Developer’s Guide for more information. Patch by Erlend E. Aasland with help from Alex Waygood, Nikita Sobolev, and Serhiy Storchaka.

C API

Python 3.12.0 beta 1

Release date: 2023-05-22

Security

  • gh-99889: Fixed a security in flaw in uu.decode() that could allow for directory traversal based on the input if no out_file was specified.

  • gh-104049: Do not expose the local on-disk location in directory indexes produced by http.client.SimpleHTTPRequestHandler.

  • gh-99108: Upgrade built-in hashlib SHA3 implementation to a verified implementation from the HACL* project. Used when OpenSSL is not present or lacks SHA3.

  • gh-102153: urllib.parse.urlsplit() now strips leading C0 control and space characters following the specification for URLs defined by WHATWG in response to CVE 2023-24329. Patch by Illia Volochii.

Core and Builtins

  • gh-102856: Implement PEP 701 changes in the tokenize module. Patch by Marta Gómez Macías and Pablo Galindo Salgado

  • gh-104615: Fix wrong ordering of assignments in code like a, a = x, y. Contributed by Carl Meyer.

  • gh-104572: Improve syntax error message for invalid constructs in PEP 695 contexts and in annotations when from __future__ import annotations is active.

  • gh-104482: Fix three error handling bugs in ast.c’s validation of pattern matching statements.

  • gh-102818: Do not add a frame to the traceback in the sys.setprofile and sys.settrace trampoline functions. This ensures that frames are not duplicated if an exception is raised in the callback function, and ensures that frames are not omitted if a C callback is used and that does not add the frame.

  • gh-104405: Fix an issue where some bytecode instructions could ignore PEP 523 when «inlining» calls.

  • gh-103082: Change behavior of sys.monitoring.events.LINE events in sys.monitoring: Line events now occur when a new line is reached dynamically, instead of using a static approximation, as before. This makes the behavior very similar to that of «line» events in sys.settrace. This should ease porting of tools from 3.11 to 3.12.

  • gh-104263: Fix float("nan") to produce a quiet NaN on platforms (like MIPS) where the meaning of the signalling / quiet bit is inverted from its usual meaning. Also introduce a new macro Py_INFINITY matching C99’s INFINITY, and refactor internals to rely on C99’s NAN and INFINITY macros instead of hard-coding bit patterns for infinities and NaNs. Thanks Sebastian Berg.

  • gh-99113: Multi-phase init extension modules may now indicate that they support running in subinterpreters that have their own GIL. This is done by using Py_MOD_PER_INTERPRETER_GIL_SUPPORTED as the value for the Py_mod_multiple_interpreters module def slot. Otherwise the module, by default, cannot be imported in such subinterpreters. (This does not affect the main interpreter or subinterpreters that do not have their own GIL.) In addition to the isolation that multi-phase init already normally requires, support for per-interpreter GIL involves one additional constraint: thread-safety. If the module has external (linked) dependencies and those libraries have any state that isn’t thread-safe then the module must do the additional work to add thread-safety. This should be an uncommon case.

  • gh-99113: The GIL is now (optionally) per-interpreter. This is the fundamental change for PEP 684. This is all made possible by virtue of the isolated state of each interpreter in the process. The behavior of the main interpreter remains unchanged. Likewise, interpreters created using Py_NewInterpreter() are not affected. To get an interpreter with its own GIL, call Py_NewInterpreterFromConfig().

  • gh-104108: Multi-phase init extension modules may now indicate whether or not they actually support multiple interpreters. By default such modules are expected to support use in multiple interpreters. In the uncommon case that one does not, it may use the new Py_mod_multiple_interpreters module def slot. A value of 0 means the module does not support them. 1 means it does. The default is 1.

  • gh-104142: Fix an issue where list or tuple repetition could fail to respect PEP 683.

  • gh-104078: Improve the performance of PyObject_HasAttrString()

  • gh-104066: Improve the performance of hasattr() for module objects with a missing attribute.

  • gh-104028: Reduce object creation while calling callback function from gc. Patch by Donghee Na.

  • gh-104018: Disallow the «z» format specifier in %-format of bytes objects.

  • gh-102213: Fix performance loss when accessing an object’s attributes with __getattr__ defined.

  • gh-103895: Improve handling of edge cases in showing Exception.__notes__. Ensures that the messages always end with a newline and that string/bytes are not exploded over multiple lines. Patch by Carey Metcalfe.

  • gh-103907: Don’t modify the refcounts of known immortal objects (True, False, and None) in the main interpreter loop.

  • gh-103899: Provide a helpful hint in the TypeError message when accidentally calling a module object that has a callable attribute of the same name (such as dis.dis() or datetime.datetime).

  • gh-103845: Remove both line and instruction instrumentation before adding new ones for monitoring, to avoid newly added instrumentation being removed immediately.

  • gh-103763: Implement PEP 695, adding syntactic support for generic classes, generic functions, and type aliases.

    A new type X = ... syntax is added for type aliases, which resolves at runtime to an instance of the new class typing.TypeAliasType. The value is lazily evaluated and is accessible through the .__value__ attribute. This is implemented as a new AST node ast.TypeAlias.

    New syntax (class X[T]: ..., def func[T](): ...) is added for defining generic functions and classes. This is implemented as a new type_params attribute on the AST nodes for classes and functions. This node holds instances of the new AST classes ast.TypeVar, ast.ParamSpec, and ast.TypeVarTuple.

    typing.TypeVar, typing.ParamSpec, typing.ParamSpecArgs, typing.ParamSpecKwargs, typing.TypeVarTuple, and typing.Generic are now implemented in C rather than Python.

    There are new bytecode instructions LOAD_LOCALS, LOAD_CLASSDICT_OR_GLOBAL, and LOAD_CLASSDICT_OR_DEREF to support correct resolution of names in class namespaces.

    Patch by Eric Traut, Larry Hastings, and Jelle Zijlstra.

  • gh-103801: Adds three minor linting fixes to the wasm module caught that were caught by ruff.

  • gh-103793: Optimized asyncio Task creation by deferring expensive string formatting (task name generation) from Task creation to the first time get_name is called. This makes asyncio benchmarks up to 5% faster.

  • gh-102310: Change the error range for invalid bytes literals.

  • gh-103590: Do not wrap a single exception raised from a try-except* construct in an ExceptionGroup.

  • gh-103650: Change the perf map format to remove the “0x” prefix from the addresses

  • gh-102856: Implement the required C tokenizer changes for PEP 701. Patch by Pablo Galindo Salgado, Lysandros Nikolaou, Batuhan Taskaya, Marta Gómez Macías and sunmy2019.

  • gh-100530: Clarify the error message raised when the called part of a class pattern isn’t actually a class.

  • gh-101517: Fix bug in line numbers of instructions emitted for except*.

  • gh-103492: Clarify SyntaxWarning with literal is comparison by specifying which literal is problematic, since comparisons using is with e.g. None and bool literals are idiomatic.

  • gh-87729: Add LOAD_SUPER_ATTR (and a specialization for super().method()) to speed up super().method() and super().attr. This makes super().method() roughly 2.3x faster and brings it within 20% of the performance of a simple method call. Patch by Vladimir Matveev and Carl Meyer.

  • gh-103488: Change the internal offset distinguishing yield and return target addresses, so that the instruction pointer is correct for exception handling and other stack unwinding.

  • gh-82012: The bitwise inversion operator (~) on bool is deprecated. It returns the bitwise inversion of the underlying int representation such that bool(~True) == True, which can be confusing. Use not for logical negation of bools. In the rare case that you really need the bitwise inversion of the underlying int, convert to int explicitly ~int(x).

  • gh-77757: Exceptions raised in a typeobject’s __set_name__ method are no longer wrapped by a RuntimeError. Context information is added to the exception as a PEP 678 note.

  • gh-103333: AttributeError now retains the name attribute when pickled and unpickled.

  • gh-103242: Migrate set_ecdh_curve() method not to use deprecated OpenSSL APIs. Patch by Donghee Na.

  • gh-103323: We’ve replaced our use of _PyRuntime.tstate_current with a thread-local variable. This is a fairly low-level implementation detail, and there should be no change in behavior.

  • gh-84436: The implementation of PEP-683 which adds Immortal Objects by using a fixed reference count that skips reference counting to make objects truly immutable.

  • gh-102700: Allow built-in modules to be submodules. This allows submodules to be statically linked into a CPython binary.

  • gh-103082: Implement PEP 669 Low Impact Monitoring for CPython.

  • gh-88691: Reduce the number of inline CACHE entries for CALL.

  • gh-102500: Make the buffer protocol accessible in Python code using the new __buffer__ and __release_buffer__ magic methods. See PEP 688 for details. Patch by Jelle Zijlstra.

  • gh-97933: PEP 709: inline list, dict and set comprehensions to improve performance and reduce bytecode size.

  • gh-99184: Bypass instance attribute access of __name__ in repr of weakref.ref.

  • gh-98003: Complex function calls are now faster and consume no C stack space.

  • bpo-39610: len() for 0-dimensional memoryview objects (such as memoryview(ctypes.c_uint8(42))) now raises a TypeError. Previously this returned 1, which was not consistent with mem_0d[0] raising an IndexError.

  • bpo-31821: Fix pause_reading() to work when called from connection_made() in asyncio.

Library

  • gh-104600: functools.update_wrapper() now sets the __type_params__ attribute (added by PEP 695).

  • gh-104340: When an asyncio pipe protocol loses its connection due to an error, and the caller doesn’t await wait_closed() on the corresponding StreamWriter, don’t log a warning about an exception that was never retrieved. After all, according to the StreamWriter.close() docs, the wait_closed() call is optional («not mandatory»).

  • gh-104555: Fix issue where an issubclass() check comparing a class X against a runtime-checkable protocol Y with non-callable members would not cause TypeError to be raised if an isinstance() call had previously been made comparing an instance of X to Y. This issue was present in edge cases on Python 3.11, but became more prominent in 3.12 due to some unrelated changes that were made to runtime-checkable protocols. Patch by Alex Waygood.

  • gh-104372: Refactored the _posixsubprocess internals to avoid Python C API usage between fork and exec when marking pass_fds= file descriptors inheritable.

  • gh-104484: Added case_sensitive argument to pathlib.PurePath.match()

  • gh-75367: Fix data descriptor detection in inspect.getattr_static().

  • gh-104536: Fix a race condition in the internal multiprocessing.process cleanup logic that could manifest as an unintended AttributeError when calling process.close().

  • gh-103857: Update datetime deprecations” stracktrace to point to the calling line

  • gh-101520: Move the core functionality of the tracemalloc module in the Python/ folder, leaving just the module wrapper in Modules/.

  • gh-104392: Remove undocumented and unused _paramspec_tvars attribute from some classes in typing.

  • gh-102613: Fix issue where pathlib.Path.glob() raised RecursionError when walking deep directory trees.

  • gh-103000: Improve performance of dataclasses.asdict() for the common case where dict_factory is dict. Patch by David C Ellis.

  • gh-104301: Allow leading whitespace in disambiguated statements in pdb.

  • gh-104139: Teach urllib.parse.unsplit() to retain the "//" when assembling itms-services://?action=generate-bugs style Apple Platform Deployment URLs.

  • gh-104307: socket.getnameinfo() now releases the GIL while contacting the DNS server

  • gh-104310: Users may now use importlib.util.allowing_all_extensions() (a context manager) to temporarily disable the strict compatibility checks for importing extension modules in subinterpreters.

  • gh-87695: Fix issue where pathlib.Path.glob() raised OSError when it encountered a symlink to an overly long path.

  • gh-104265: Prevent possible crash by disallowing instantiation of the _csv.Reader and _csv.Writer types. The regression was introduced in 3.10.0a4 with PR 23224 (bpo-14935). Patch by Radislav Chugunov.

  • gh-102613: Improve performance of pathlib.Path.glob() when expanding recursive wildcards (»**») by merging adjacent wildcards and de-duplicating results only when necessary.

  • gh-65772: Remove unneeded comments and code in turtle.py.

  • gh-90208: Fixed issue where pathlib.Path.glob() returned incomplete results when it encountered a PermissionError. This method now suppresses all OSError exceptions, except those raised from calling is_dir() on the top-level path.

  • gh-104144: Optimize asyncio.TaskGroup when using asyncio.eager_task_factory(). Skip scheduling a done callback if a TaskGroup task completes eagerly.

  • gh-104144: Optimize asyncio.gather() when using asyncio.eager_task_factory() to complete eagerly if all fututres completed eagerly. Avoid scheduling done callbacks for futures that complete eagerly.

  • gh-104114: Fix issue where pathlib.Path.glob() returns paths using the case of non-wildcard segments for corresponding path segments, rather than the real filesystem case.

  • gh-104104: Improve performance of pathlib.Path.glob() by using re.IGNORECASE to implement case-insensitive matching.

  • gh-104102: Improve performance of pathlib.Path.glob() when evaluating patterns that contain '../' segments.

  • gh-103822: Update the return type of weekday to the newly added Day attribute

  • gh-103629: Update the repr of typing.Unpack according to PEP 692.

  • gh-103963: Make dis display the names of the args for CALL_INTRINSIC_*.

  • gh-104035: Do not ignore user-defined __getstate__ and __setstate__ methods for slotted frozen dataclasses.

  • gh-103987: In mmap, fix several bugs that could lead to access to memory-mapped files after they have been invalidated.

  • gh-103977: Improve import time of platform module.

  • gh-88773: Added turtle.teleport() to the turtle module to move a turtle to a new point without tracing a line, visible or invisible. Patch by Liam Gersten.

  • gh-103935: Use io.open_code() for files to be executed instead of raw open()

  • gh-68968: Fixed garbled output of assertEqual() when an input lacks final newline.

  • gh-100370: Fix potential OverflowError in sqlite3.Connection.blobopen() for 32-bit builds. Patch by Erlend E. Aasland.

  • gh-102628: Substitute CTRL-D with CTRL-Z in sqlite3 CLI banner when running on Windows.

  • gh-103636: Module-level attributes January and February are deprecated from calendar.

  • gh-103583: Isolate _multibytecodec and codecs extension modules. Patches by Erlend E. Aasland.

  • gh-103848: Add checks to ensure that [ bracketed ] hosts found by urllib.parse.urlsplit() are of IPv6 or IPvFuture format.

  • gh-103872: Update the bundled copy of pip to version 23.1.2.

  • gh-99944: Make dis display the value of oparg of KW_NAMES.

  • gh-74940: The C.UTF-8 locale is no longer converted to en_US.UTF-8, enabling the use of UTF-8 encoding on systems which have no locales installed.

  • gh-103861: Fix zipfile.Zipfile creating invalid zip files when force_zip64 was used to add files to them. Patch by Carey Metcalfe.

  • gh-103857: Deprecated datetime.datetime.utcnow() and datetime.datetime.utcfromtimestamp(). (Patch by Paul Ganssle)

  • gh-103839: Avoid compilation error due to tommath.h not being found when building Tkinter against Tcl 8.7 built with bundled libtommath.

  • gh-103791: contextlib.suppress now supports suppressing exceptions raised as part of an ExceptionGroup. If other exceptions exist on the group, they are re-raised in a group that does not contain the suppressed exceptions.

  • gh-90750: Use datetime.datetime.fromisocalendar() in the implementation of datetime.datetime.strptime(), which should now accept only valid ISO dates. (Patch by Paul Ganssle)

  • gh-103685: Prepare tkinter.Menu.index() for Tk 8.7 so that it does not raise TclError: expected integer but got "" when it should return None.

  • gh-81403: urllib.request.CacheFTPHandler no longer raises URLError if a cached FTP instance is reused. ftplib’s endtransfer method calls voidresp to drain the connection to handle FTP instance reuse properly.

  • gh-103699: Add __orig_bases__ to non-generic TypedDicts, call-based TypedDicts, and call-based NamedTuples. Other TypedDicts and NamedTuples already had the attribute.

  • gh-103693: Add convenience variable feature to pdb

  • gh-92248: Deprecate type, choices, and metavar parameters of argparse.BooleanOptionalAction.

  • gh-89415: Add socket constants for source-specific multicast. Patch by Reese Hyde.

  • gh-103673: socketserver gains ForkingUnixStreamServer and ForkingUnixDatagramServer classes. Patch by Jay Berry.

  • gh-103636: Added Enum for months and days in the calendar module.

  • gh-84976: Create a new Lib/_pydatetime.py file that defines the Python version of the datetime module, and make datetime import the contents of the new library only if the C implementation is missing. Currently, the full Python implementation is defined and then deleted if the C implementation is not available, slowing down import datetime unnecessarily.

  • gh-103596: Attributes/methods are no longer shadowed by same-named enum members, although they may be shadowed by enum.property’s.

  • gh-103584: Updated importlib.metadata with changes from importlib_metadata 5.2 through 6.5.0, including: Support installed-files.txt for Distribution.files when present. PackageMetadata now stipulates an additional get method allowing for easy querying of metadata keys that may not be present. packages_distributions now honors packages and modules with Python modules that not .py sources (e.g. .pyc, .so). Expand protocol for PackageMetadata.get_all to match the upstream implementation of email.message.Message.get_all in python/typeshed#9620. Deprecated use of Distribution without defining abstract methods. Deprecated expectation that PackageMetadata.__getitem__ will return None for missing keys. In the future, it will raise a KeyError.

  • gh-103578: Fixed a bug where pdb crashes when reading source file with different encoding by replacing io.open() with io.open_code(). The new method would also call into the hook set by PyFile_SetOpenCodeHook().

  • gh-103556: Now creating inspect.Signature objects with positional-only parameter with a default followed by a positional-or-keyword parameter without one is impossible.

  • gh-103559: Update the bundled copy of pip to version 23.1.1.

  • gh-103548: Improve performance of pathlib.Path.absolute() and cwd() by joining paths only when necessary. Also improve performance of pathlib.PurePath.is_absolute() on Posix by skipping path parsing and normalization.

  • gh-103538: Remove _tkinter module code guarded by definition of the TK_AQUA macro which was only needed for Tk 8.4.7 or earlier and was never actually defined by any build system or documented for manual use.

  • gh-103533: Update cProfile to use PEP 669 API

  • gh-103525: Fix misleading exception message when mixed str and bytes arguments are supplied to pathlib.PurePath and Path.

  • gh-103489: Add getconfig() and setconfig() to Connection to make configuration changes to a database connection. Patch by Erlend E. Aasland.

  • gh-103365: Set default Flag boundary to STRICT and fix bitwise operations.

  • gh-103472: Avoid a potential ResourceWarning in http.client.HTTPConnection by closing the proxy / tunnel’s CONNECT response explicitly.

  • gh-103462: Fixed an issue with using writelines() in asyncio to send very large payloads that exceed the amount of data that can be written in one call to socket.socket.send() or socket.socket.sendmsg(), resulting in the remaining buffer being left unwritten.

  • gh-103449: Fix a bug in doc string generation in dataclasses.dataclass().

  • gh-103092: Isolate _collections (apply PEP 687). Patch by Erlend E. Aasland.

  • gh-103357: Added support for logging.Formatter defaults parameter to logging.config.dictConfig() and logging.config.fileConfig(). Patch by Bar Harel.

  • gh-103092: Adapt the winreg extension module to PEP 687.

  • gh-74690: The performance of isinstance() checks against runtime-checkable protocols has been considerably improved for protocols that only have a few members. To achieve this improvement, several internal implementation details of the typing module have been refactored, including typing._ProtocolMeta.__instancecheck__, typing._is_callable_members_only, and typing._get_protocol_attrs. Patches by Alex Waygood.

  • gh-74690: The members of a runtime-checkable protocol are now considered «frozen» at runtime as soon as the class has been created. See «What’s new in Python 3.12» for more details.

  • gh-103256: Fixed a bug that caused hmac to raise an exception when the requested hash algorithm was not available in OpenSSL despite being available separately as part of hashlib itself. It now falls back properly to the built-in. This could happen when, for example, your OpenSSL does not include SHA3 support and you want to compute hmac.digest(b'K', b'M', 'sha3_256').

  • gh-102778: Support sys.last_exc in idlelib.

  • gh-103285: Improve performance of ast.get_source_segment().

  • gh-103225: Fix a bug in pdb when displaying line numbers of module-level source code.

  • gh-103092: Adapt the msvcrt extension module to PEP 687.

  • gh-103092: Adapt the winsound extension module to PEP 687.

  • gh-93910: Remove deprecation of enum member.member access.

  • gh-102978: Fixes unittest.mock.patch() not enforcing function signatures for methods decorated with @classmethod or @staticmethod when patch is called with autospec=True.

  • gh-103092: Isolate _socket (apply PEP 687). Patch by Erlend E. Aasland.

  • gh-100479: Add pathlib.PurePath.with_segments(), which creates a path object from arguments. This method is called whenever a derivative path is created, such as from pathlib.PurePath.parent. Subclasses may override this method to share information between path objects.

  • gh-103220: Fix issue where os.path.join() added a slash when joining onto an incomplete UNC drive with a trailing slash on Windows.

  • gh-103204: Fixes http.server accepting HTTP requests with HTTP version numbers preceded by “+”, or “-”, or with digit-separating “_” characters. The length of the version numbers is also constrained.

  • gh-75586: Fix various Windows-specific issues with shutil.which.

  • gh-103193: Improve performance of inspect.getattr_static(). Patch by Alex Waygood.

  • gh-103176: sys._current_exceptions() now returns a mapping from thread-id to an exception instance, rather than to a (typ, exc, tb) tuple.

  • gh-103143: Polish the help messages and docstrings of pdb.

  • gh-103015: Add entrypoint keyword-only parameter to sqlite3.Connection.load_extension(), for overriding the SQLite extension entry point. Patch by Erlend E. Aasland.

  • gh-103000: Improve performance of dataclasses.astuple() and dataclasses.asdict() in cases where the contents are common Python types.

  • gh-102953: The extraction methods in tarfile, and shutil.unpack_archive(), have a new a filter argument that allows limiting tar features than may be surprising or dangerous, such as creating files outside the destination directory. See Extraction filters for details.

  • gh-97696: Implemented an eager task factory in asyncio. When used as a task factory on an event loop, it performs eager execution of coroutines. Coroutines that are able to complete synchronously (e.g. return or raise without blocking) are returned immediately as a finished task, and the task is never scheduled to the event loop. If the coroutine blocks, the (pending) task is scheduled and returned.

  • gh-81079: Add case_sensitive keyword-only argument to pathlib.Path.glob() and rglob().

  • gh-101819: Isolate the io extension module by applying PEP 687. Patch by Kumar Aditya, Victor Stinner, and Erlend E. Aasland.

  • gh-91896: Deprecate collections.abc.ByteString

  • gh-101362: Speed up pathlib.Path construction by omitting the path anchor from the internal list of path parts.

  • gh-102114: Functions in the dis module that accept a source code string as argument now print a more concise traceback when the string contains a syntax or indentation error.

  • gh-62432: The unittest runner will now exit with status code 5 if no tests were run. It is common for test runner misconfiguration to fail to find any tests, this should be an error.

  • gh-78079: Fix incorrect normalization of UNC device path roots, and partial UNC share path roots, in pathlib.PurePath. Pathlib no longer appends a trailing slash to such paths.

  • gh-85984: Add tty.cfmakeraw() and tty.cfmakecbreak() to tty and modernize, the behavior of tty.setraw() and tty.setcbreak() to use POSIX.1-2017 Chapter 11 «General Terminal Interface» flag masks by default.

  • gh-101688: Implement types.get_original_bases() to provide further introspection for types.

  • gh-101640: argparse.ArgumentParser now catches errors when writing messages, such as when sys.stderr is None. Patch by Oleg Iarygin.

  • gh-83861: Fix datetime.astimezone method return value when invoked on a naive datetime instance that represents local time falling in a timezone transition gap. PEP 495 requires that instances with fold=1 produce earlier times than those with fold=0 in this case.

  • gh-89550: Decrease execution time of some gzip file writes by 15% by adding more appropriate buffering.

  • gh-95299: Remove the bundled setuptools wheel from ensurepip, and stop installing setuptools in environments created by venv.

  • gh-99353: Respect the http.client.HTTPConnection .debuglevel flag in urllib.request.AbstractHTTPHandler when its constructor parameter debuglevel is not set. And do the same for *HTTPS*.

  • gh-98040: Remove the long-deprecated imp module.

  • gh-97850: Deprecate pkgutil.find_loader() and pkgutil.get_loader() in favor of importlib.util.find_spec().

  • gh-94473: Flatten arguments in tkinter.Canvas.coords(). It now accepts not only x1, y1, x2, y2, ... and [x1, y1, x2, y2, ...], but also (x1, y1), (x2, y2), ... and [(x1, y1), (x2, y2), ...].

  • gh-98040: Remove more deprecated importlib APIs: find_loader(), find_module(), importlib.abc.Finder, pkgutil.ImpImporter, pkgutil.ImpLoader.

  • gh-96522: Fix potential deadlock in pty.spawn()

  • gh-96534: Support divert(4) added in FreeBSD 14.

  • gh-87474: Fix potential file descriptor leaks in subprocess.Popen.

  • gh-94906: Support multiple steps in math.nextafter(). Patch by Shantanu Jain and Matthias Gorgens.

  • gh-51574: Make tempfile.mkdtemp() return absolute paths when its dir parameter is relative.

  • gh-94518: Convert private _posixsubprocess.fork_exec() to use Argument Clinic.

  • gh-92184: When creating zip files using zipfile, os.altsep, if not None, will always be treated as a path separator even when it is not /. Patch by Carey Metcalfe.

  • bpo-46797: Deprecation warnings are now emitted for ast.Num, ast.Bytes, ast.Str, ast.NameConstant and ast.Ellipsis. These have been documented as deprecated since Python 3.8, and will be removed in Python 3.14.

  • bpo-44844: Enables webbrowser to detect and launch Microsoft Edge browser.

  • bpo-45606: Fixed the bug in pathlib.Path.glob() – previously a dangling symlink would not be found by this method when the pattern is an exact match, but would be found when the pattern contains a wildcard or the recursive wildcard (**). With this change, a dangling symlink will be found in both cases.

  • bpo-23041: Add QUOTE_STRINGS and QUOTE_NOTNULL to the suite of csv module quoting styles.

  • bpo-24964: Added http.client.HTTPConnection.get_proxy_response_headers() that provides access to the HTTP headers on a proxy server response to the CONNECT request.

  • bpo-17258: multiprocessing now supports stronger HMAC algorithms for inter-process connection authentication rather than only HMAC-MD5.

  • bpo-39744: Make asyncio.subprocess.Process.communicate() close the subprocess’s stdin even when called with input=None.

  • bpo-22708: http.client CONNECT method tunnel improvements: Use HTTP 1.1 protocol; send a matching Host: header with CONNECT, if one is not provided; convert IDN domain names to Punycode. Patch by Michael Handler.

Documentation

  • gh-67056: Document that the effect of registering or unregistering an atexit cleanup function from within a registered cleanup function is undefined.

  • gh-103629: Mention the new way of typing **kwargs with Unpack and TypedDict introduced in PEP 692.

  • gh-48241: Clarifying documentation about the url parameter to urllib.request.urlopen and urllib.request.Request needing to be encoded properly.

  • gh-86094: Add support for Unicode Path Extra Field in ZipFile. Patch by Yeojin Kim and Andrea Giudiceandrea

  • gh-99202: Fix extension type from documentation for compiling in C++20 mode

Tests

  • gh-104494: Update test_pack_configure_in and test_place_configure_in for changes to error message formatting in Tk 8.7.

  • gh-104461: Run test_configure_screen on X11 only, since the DISPLAY environment variable and -screen option for toplevels are not useful on Tk for Win32 or Aqua.

  • gh-86275: Added property-based tests to the zoneinfo tests, along with stubs for the hypothesis interface. (Patch by Paul Ganssle)

  • gh-103329: Regression tests for the behaviour of unittest.mock.PropertyMock were added.

  • gh-102795: fix use of poll in test_epoll’s test_control_and_wait

  • gh-75729: Fix the os.spawn* tests failing on Windows when the working directory or interpreter path contains spaces.

Build

  • gh-101282: BOLT optimization is now applied to the libpython shared library if building a shared library. BOLT instrumentation and application settings can now be influenced via the BOLT_INSTRUMENT_FLAGS and BOLT_APPLY_FLAGS configure variables.

  • gh-99017: PYTHON_FOR_REGEN now require Python 3.10 or newer.

  • gh-104490: Define .PHONY / virtual make targets consistently and properly.

  • gh-104106: Add gcc fallback of mkfifoat/mknodat for macOS. Patch by Donghee Na.

  • gh-103532: The TKINTER_PROTECT_LOADTK macro is no longer defined or used in the _tkinter module. It was previously only defined when building against Tk 8.4.13 and older, but Tk older than 8.5.12 has been unsupported since gh-91152.

  • gh-99069: Extended workaround defining static_assert when missing from the libc headers to all clang and gcc builds. In particular, this fixes building on macOS <= 10.10.

  • gh-100220: Changed the default value of the SHELL Makefile variable from /bin/sh to /bin/sh -e to ensure that complex recipes correctly fail after an error. Previously, make install could fail to install some files and yet return a successful result.

  • gh-90656: Add platform triplets for 64-bit LoongArch:

    • loongarch64-linux-gnusf

    • loongarch64-linux-gnuf32

    • loongarch64-linux-gnu

    Patch by Zhang Na.

Windows

  • gh-104623: Update Windows installer to use SQLite 3.42.0.

  • gh-82814: Fix a potential [Errno 13] Permission denied when using shutil.copystat() within Windows Subsystem for Linux (WSL) on a mounted filesystem by adding errno.EACCES to the list of ignored errors within the internal implementation.

  • gh-103088: Fix virtual environment activate script having incorrect line endings for Cygwin.

  • gh-103088: Fixes venvs not working in bash on Windows across different disks

  • gh-102997: Update Windows installer to use SQLite 3.41.2.

  • gh-88013: Fixed a bug where TypeError was raised when calling ntpath.realpath() with a bytes parameter in some cases.

macOS

  • gh-99834: Update macOS installer to Tcl/Tk 8.6.13.

  • gh-104623: Update macOS installer to SQLite 3.42.0.

  • gh-103545: Add os.PRIO_DARWIN_THREAD, os.PRIO_DARWIN_PROCESS, os.PRIO_DARWIN_BG and os.PRIO_DARWIN_NONUI. These can be used with os.setpriority to run the process at a lower priority and make use of the efficiency cores on Apple Silicon systems.

  • gh-104180: Support reading SOCKS proxy configuration from macOS System Configuration. Patch by Sam Schott.

  • gh-60436: update curses textbox to additionally handle backspace using the curses.ascii.DEL key press.

  • gh-102997: Update macOS installer to SQLite 3.41.2.

IDLE

  • gh-104499: Fix completions for Tk Aqua 8.7 (currently blank).

  • gh-104496: About prints both tcl and tk versions if different (expected someday).

  • gh-88496: Fix IDLE test hang on macOS.

Tools/Demos

  • gh-104389: Argument Clinic C converters now accept the unused keyword, for wrapping a parameter with Py_UNUSED. Patch by Erlend E. Aasland.

C API

Python 3.12.0 alpha 7

Release date: 2023-04-04

Core and Builtins

  • gh-102192: Deprecated _PyErr_ChainExceptions in favour of _PyErr_ChainExceptions1.

  • gh-89987: Reduce the number of inline CACHE entries for BINARY_SUBSCR.

  • gh-102859: Removed JUMP_IF_FALSE_OR_POP and JUMP_IF_TRUE_OR_POP instructions.

  • gh-101975: Fixed stacktop value on tracing entries to avoid corruption on garbage collection.

  • gh-102778: Add sys.last_exc and deprecate sys.last_type, sys.last_value and sys.last_traceback, which hold the same information in its legacy form.

  • gh-100982: Replace all occurrences of COMPARE_AND_BRANCH with COMPARE_OP.

  • gh-102701: Fix overflow when creating very large dict.

  • gh-102755: Add PyErr_DisplayException() which takes just an exception instance, to replace the legacy PyErr_Display() which takes the (typ, exc, tb) triplet.

  • gh-102594: Add note to exception raised in PyErr_SetObject when normalization fails.

  • gh-90997: Shrink the number of inline CACHE entries used by LOAD_GLOBAL.

  • gh-102491: Improve import time of platform by removing IronPython version parsing. The IronPython version parsing was not functional (see https://github.com/IronLanguages/ironpython3/issues/1667).

  • gh-101291: Rearrage bits in first field (after header) of PyLongObject. * Bits 0 and 1: 1 - sign. I.e. 0 for positive numbers, 1 for zero and 2 for negative numbers. * Bit 2 reserved (probably for the immortal bit) * Bits 3+ the unsigned size.

    This makes a few operations slightly more efficient, and will enable a more compact and faster 2s-complement representation of most ints in future.

  • gh-102397: Fix segfault from race condition in signal handling during garbage collection. Patch by Kumar Aditya.

  • gh-102406: codecs encoding/decoding errors now get the context information (which operation and which codecs) attached as PEP 678 notes instead of through chaining a new instance of the exception.

  • gh-102281: Fix potential nullptr dereference and use of uninitialized memory in fileutils. Patch by Max Bachmann.

  • gh-102300: Reuse operands with refcount of 1 in float specializations of BINARY_OP.

  • gh-102213: Fix performance loss when accessing an object’s attributes with __getattr__ defined.

  • gh-102255: Improve build support for the Xbox. Patch by Max Bachmann.

  • gh-102027: Fix SSE2 and SSE3 detection in _blake2 internal module. Patch by Max Bachmann.

  • gh-101865: Deprecate co_lnotab in code objects, schedule it for removal in Python 3.14

  • bpo-1635741: Adapt _pickle to PEP 687. Patch by Mohamed Koubaa and Erlend Aasland.

Library

Documentation

Tests

  • gh-102980: Improve test coverage on pdb.

  • gh-102537: Adjust the error handling strategy in test_zoneinfo.TzPathTest.python_tzpath_context. Patch by Paul Ganssle.

  • gh-101377: Improved test_locale_calendar_formatweekday of calendar.

Build

  • gh-102973: Add a dev container (along with accompanying Dockerfile) for development purposes.

  • gh-102711: Fix -Wstrict-prototypes compiler warnings.

Windows

  • gh-102690: Update webbrowser to fall back to Microsoft Edge instead of Internet Explorer.

  • gh-99726: Improves correctness of stat results for Windows, and uses faster API when available

Tools/Demos

C API

  • gh-102013: Add a new (unstable) C-API function for iterating over GC’able objects using a callback: PyUnstable_VisitObjects.

Python 3.12.0 alpha 6

Release date: 2023-03-07

Security

  • gh-99108: Replace builtin hashlib implementations of MD5 and SHA1 with verified ones from the HACL* project.

  • gh-101727: Updated the OpenSSL version used in Windows and macOS binary release builds to 1.1.1t to address CVE 2023-0286, CVE 2022-4303, and CVE 2022-4303 per the OpenSSL 2023-02-07 security advisory.

  • gh-99108: Replace the builtin hashlib implementations of SHA2-384 and SHA2-512 originally from LibTomCrypt with formally verified, side-channel resistant code from the HACL* project. The builtins remain a fallback only used when OpenSSL does not provide them.

  • gh-101283: subprocess.Popen now uses a safer approach to find cmd.exe when launching with shell=True. Patch by Eryk Sun, based on a patch by Oleg Iarygin.

Core and Builtins

  • gh-102493: Fix regression in semantics of normalisation in PyErr_SetObject.

  • gh-102416: Do not memoize incorrectly automatically generated loop rules in the parser. Patch by Pablo Galindo.

  • gh-102356: Fix a bug that caused a crash when deallocating deeply nested filter objects. Patch by Marta Gómez Macías.

  • gh-102336: Cleanup Windows 7 specific special handling. Patch by Max Bachmann.

  • gh-102250: Fixed a segfault occurring when the interpreter calls a __bool__ method that raises.

  • gh-102126: Fix deadlock at shutdown when clearing thread states if any finalizer tries to acquire the runtime head lock. Patch by Kumar Aditya.

  • gh-102027: Use GetCurrentProcessId on Windows when getpid is unavailable. Patch by Max Bachmann.

  • gh-102056: Fix error handling bugs in interpreter’s exception printing code, which could cause a crash on infinite recursion.

  • gh-100982: Restrict the scope of the FOR_ITER_RANGE instruction to the scope of the original FOR_ITER instruction, to allow instrumentation.

  • gh-101967: Fix possible segfault in positional_only_passed_as_keyword function, when new list created.

  • gh-101952: Fix possible segfault in BUILD_SET opcode, when new set created.

  • gh-74895: socket.getaddrinfo no longer raises OverflowError for int port values outside of the C long range. Out of range values are left up to the underlying string based C library API to report. A socket.gaierror SAI_SERVICE may occur instead, or no error at all as not all platform C libraries generate an error.

  • gh-101799: Add CALL_INTRINSIC_2 and use it instead of PREP_RERAISE_STAR.

  • gh-101857: Fix xattr support detection on Linux systems by widening the check to linux, not just glibc. This fixes support for musl.

  • gh-84783: Make the slice object hashable. Patch by Will Bradshaw and Furkan Onder.

  • gh-87849: Change the SEND instruction to leave the receiver on the stack. This allows the specialized form of SEND to skip the chain of C calls and jump directly to the RESUME in the generator or coroutine.

  • gh-101765: Fix SystemError / segmentation fault in iter __reduce__ when internal access of builtins.__dict__ keys mutates the iter object.

  • gh-101430: Update tracemalloc to handle presize of object properly. Patch by Donghee Na.

  • gh-101696: Invalidate type version tag in _PyStaticType_Dealloc for static types, avoiding bug where a false cache hit could crash the interpreter. Patch by Kumar Aditya.

  • gh-101632: Adds a new RETURN_CONST instruction.

  • gh-100719: Remove gi_code field from generator (and coroutine and async generator) objects as it is redundant. The frame already includes a reference to the code object.

  • gh-98627: When an interpreter is configured to check (and only then), importing an extension module will now fail when the extension does not support multiple interpreters (i.e. doesn’t implement PEP 489 multi-phase init). This does not apply to the main interpreter, nor to subinterpreters created with Py_NewInterpreter().

Library

Documentation

Tests

  • gh-102019: Fix deadlock on shutdown if test_current_{exception,frames} fails. Patch by Jacob Bower.

  • gh-85984: Utilize new «winsize» functions from termios in pty tests.

  • gh-89792: test_tools now copies up to 10x less source data to a temporary directory during the freeze test by ignoring git metadata and other artifacts. It also limits its python build parallelism based on os.cpu_count instead of hard coding it as 8 cores.

Build

  • gh-99942: On Android, in a static build, python-config in embed mode no longer incorrectly reports a library to link to.

  • gh-99942: On Android, python.pc now correctly reports the library to link to, the same as python-config.sh.

  • gh-100221: Fix creating install directories in make sharedinstall if they exist outside DESTDIR already.

  • gh-96821: Explicitly mark C extension modules that need defined signed integer overflow, and add a configure option --with-strict-overflow. Patch by Matthias Görgens and Shantanu Jain.

Windows

  • gh-102344: Implement winreg.QueryValue using QueryValueEx and winreg.SetValue using SetValueEx. Patch by Max Bachmann.

  • gh-101881: Handle read and write operations on non-blocking pipes properly on Windows.

  • gh-101881: Add support for the os.get_blocking() and os.set_blocking() functions on Windows.

  • gh-101849: Ensures installer will correctly upgrade existing py.exe launcher installs.

  • gh-101763: Updates copy of libffi bundled with Windows installs to 3.4.4.

  • gh-101759: Update Windows installer to SQLite 3.40.1.

  • gh-101614: Correctly handle extensions built against debug binaries that reference python3_d.dll.

  • gh-101196: The functions os.path.isdir, os.path.isfile, os.path.islink and os.path.exists are now 13% to 28% faster on Windows, by making fewer Win32 API calls.

macOS

  • gh-101759: Update macOS installer to SQLite 3.40.1.

C API

  • gh-101907: Removes use of non-standard C++ extension in public header files.

  • gh-99293: Document that the Py_TPFLAGS_VALID_VERSION_TAG is an internal feature, should not be used, and will be removed.

  • gh-101578: Add PyErr_GetRaisedException() and PyErr_SetRaisedException() for saving and restoring the current exception. These functions return and accept a single exception object, rather than the triple arguments of the now-deprecated PyErr_Fetch() and PyErr_Restore(). This is less error prone and a bit more efficient.

    Add PyException_GetArgs() and PyException_SetArgs() as convenience functions for retrieving and modifying the args passed to the exception’s constructor.

  • gh-91744: Introduced the Unstable C API tier, marking APi that is allowed to change in minor releases without a deprecation period. See PEP 689 for details.

Python 3.12.0 alpha 5

Release date: 2023-02-07

Security

  • gh-99108: Replace the builtin hashlib implementations of SHA2-224 and SHA2-256 originally from LibTomCrypt with formally verified, side-channel resistant code from the HACL* project. The builtins remain a fallback only used when OpenSSL does not provide them.

Core and Builtins

  • gh-92173: Fix the defs and kwdefs arguments to PyEval_EvalCodeEx() and a reference leak in that function.

  • gh-59956: The GILState API is now partially compatible with subinterpreters. Previously, PyThreadState_GET() and PyGILState_GetThisThreadState() would get out of sync, causing inconsistent behavior and crashes.

  • gh-101400: Fix wrong lineno in exception message on continue or break which are not in a loop. Patch by Donghee Na.

  • gh-101372: Fix is_normalized() to properly handle the UCD 3.2.0 cases. Patch by Donghee Na.

  • gh-101266: Fix sys.getsizeof() reporting for int subclasses.

  • gh-101291: Refactor the PyLongObject struct into a normal Python object header and a PyLongValue struct.

  • gh-101046: Fix a possible memory leak in the parser when raising MemoryError. Patch by Pablo Galindo

  • gh-101037: Fix potential memory underallocation issue for instances of int subclasses with value zero.

  • gh-100762: Record the (virtual) exception block depth in the oparg of YIELD_VALUE. Use this to avoid the expensive throw() when closing generators (and coroutines) that can be closed trivially.

  • gh-100982: Adds a new COMPARE_AND_BRANCH instruction. This is a bit more efficient when performing a comparison immediately followed by a branch, and restores the design intent of PEP 659 that specializations are local to a single instruction.

  • gh-100942: Fixed segfault in property.getter/setter/deleter that occurred when a property subclass overrode the __new__ method to return a non-property instance.

  • gh-100923: Remove the mask cache entry for the COMPARE_OP instruction and embed the mask into the oparg.

  • gh-100892: Fix race while iterating over thread states in clearing threading.local. Patch by Kumar Aditya.

  • gh-91351: Fix a case where re-entrant imports could corrupt the import deadlock detection code and cause a KeyError to be raised out of importlib/_bootstrap. In addition to the straightforward cases, this could also happen when garbage collection leads to a warning being emitted – as happens when it collects an open socket or file)

  • gh-100726: Optimize construction of range object for medium size integers.

  • gh-100712: Added option to build cpython with specialization disabled, by setting ENABLE_SPECIALIZATION=False in opcode, followed by make regen-all.

  • bpo-32780: Inter-field padding is now inserted into the PEP3118 format strings obtained from ctypes.Structure objects, reflecting their true representation in memory.

Library

  • gh-101541: [Enum] - fix psuedo-flag creation

  • gh-101570: Upgrade pip wheel bundled with ensurepip (pip 23.0)

  • gh-101323: Fix a bug where errors where not thrown by zlib._ZlibDecompressor if encountered during decompressing.

  • gh-101317: Add ssl_shutdown_timeout parameter for asyncio.StreamWriter.start_tls().

  • gh-101326: Fix regression when passing None as second or third argument to FutureIter.throw.

  • gh-92123: Adapt the _elementtree extension module to multi-phase init (PEP 489). Patches by Erlend E. Aasland.

  • gh-100795: Avoid potential unexpected freeaddrinfo call (double free) in socket when when a libc getaddrinfo() implementation leaves garbage in an output pointer when returning an error. Original patch by Sergey G. Brester.

  • gh-101143: Remove unused references to TimerHandle in asyncio.base_events.BaseEventLoop._add_callback.

  • gh-101144: Make zipfile.Path.open() and zipfile.Path.read_text() also accept encoding as a positional argument. This was the behavior in Python 3.9 and earlier. 3.10 introduced a regression where supplying it as a positional argument would lead to a TypeError.

  • gh-94518: Group-related variables of _posixsubprocess module are renamed to stress that supplementary group affinity is added to a fork, not replace the inherited ones. Patch by Oleg Iarygin.

  • gh-101015: Fix typing.get_type_hints() on '*tuple[...]' and *tuple[...]. It must not drop the Unpack part.

  • gh-101000: Add os.path.splitroot(), which splits a path into a 3-item tuple (drive, root, tail). This new function is used by pathlib to improve the performance of path construction by up to a third.

  • gh-100573: Fix a Windows asyncio bug with named pipes where a client doing os.stat() on the pipe would cause an error in the server that disabled serving future requests.

  • gh-39615: warnings.warn() now has the ability to skip stack frames based on code filename prefix rather than only a numeric stacklevel via the new skip_file_prefixes keyword argument.

  • gh-100750: pass encoding kwarg to subprocess in platform

  • gh-100160: Emit a deprecation warning in asyncio.DefaultEventLoopPolicy.get_event_loop() if there is no current event loop set and it decides to create one.

  • gh-96290: Fix handling of partial and invalid UNC drives in ntpath.splitdrive(), and in ntpath.normpath() on non-Windows systems. Paths such as “\server” and “\” are now considered by splitdrive() to contain only a drive, and consequently are not modified by normpath() on non-Windows systems. The behaviour of normpath() on Windows systems is unaffected, as native OS APIs are used. Patch by Eryk Sun, with contributions by Barney Gale.

  • gh-99952: Fix a reference undercounting issue in ctypes.Structure with from_param() results larger than a C pointer.

  • gh-67790: Add float-style formatting support for fractions.Fraction instances.

  • gh-99266: Preserve more detailed error messages in ctypes.

  • gh-86682: Ensure runtime-created collections have the correct module name using the newly added (internal) sys._getframemodulename().

  • gh-88597: uuid now has a command line interface. Try python -m uuid -h.

  • gh-60580: ctypes.wintypes.BYTE definition changed from c_byte to c_ubyte to match Windows SDK. Patch by Anatoly Techtonik and Oleg Iarygin.

  • gh-94518: _posixsubprocess now initializes all UID and GID variables using a reserved -1 value instead of a separate flag. Patch by Oleg Iarygin.

  • bpo-38941: The xml.etree.ElementTree module now emits DeprecationWarning when testing the truth value of an xml.etree.ElementTree.Element. Before, the Python implementation emitted FutureWarning, and the C implementation emitted nothing.

  • bpo-40077: Convert elementtree types to heap types. Patch by Erlend E. Aasland.

  • bpo-29847: Fix a bug where pathlib.Path accepted and ignored keyword arguments. Patch provided by Yurii Karabas.

  • gh-77772: ctypes.CDLL, ctypes.OleDLL, ctypes.WinDLL, and ctypes.PyDLL now accept path-like objects as their name argument. Patch by Robert Hoelzl.

Documentation

  • gh-88324: Reword subprocess to emphasize default behavior of stdin, stdout, and stderr arguments. Remove inaccurate statement about child file handle inheritance.

Tests

  • gh-101334: test_tarfile has been updated to pass when run as a high UID.

Build

  • gh-101282: Update BOLT configuration not to use deprecated usage of --split functions. Patch by Donghee Na.

  • gh-101522: Allow overriding Windows dependencies versions and paths using MSBuild properties.

  • gh-77532: Minor fixes to allow building with PlatformToolset=ClangCL on Windows.

  • gh-101152: In accordance with PEP 699, the ma_version_tag field in PyDictObject is deprecated for extension modules. Accessing this field will generate a compiler warning at compile time. This field will be removed in Python 3.14.

  • gh-100340: Allows -Wno-int-conversion for wasm-sdk 17 and onwards, thus enables building WASI builds once against the latest sdk.

  • gh-101060: Conditionally add -fno-reorder-blocks-and-partition in configure. Effectively fixes --enable-bolt when using Clang, as this appears to be a GCC-only flag.

  • gh-98705: __bool__ is defined in AIX system header files which breaks the build in AIX, so undefine it.

  • gh-98636: Fix a regression in detecting gdbm_compat library for the _gdbm module build.

  • gh-96305: _aix_support now uses a simple code to get platform details rather than the now non-existent _bootsubprocess during bootstrap.

Windows

  • gh-101543: Ensure the install path in the registry is only used when the standard library hasn’t been located in any other way.

  • gh-101467: The py.exe launcher now correctly filters when only a single runtime is installed. It also correctly handles prefix matches on tags so that -3.1 does not match 3.11, but would still match 3.1-32.

  • gh-99834: Updates bundled copy of Tcl/Tk to 8.6.13.0

  • gh-101135: Restore ability to launch older 32-bit versions from the py.exe launcher when both 32-bit and 64-bit installs of the same version are available.

  • gh-82052: Fixed an issue where writing more than 32K of Unicode output to the console screen in one go can result in mojibake.

  • gh-100320: Ensures the PythonPath registry key from an install is used when launching from a different copy of Python that relies on an existing install to provide a copy of its modules and standard library.

  • gh-100247: Restores support for the py.exe launcher finding shebang commands in its configuration file using the full command name.

Python 3.12.0 alpha 4

Release date: 2023-01-10

Core and Builtins

  • gh-100776: Fix misleading default value in input()”s __text_signature__.

  • gh-99005: Remove UNARY_POSITIVE, ASYNC_GEN_WRAP and LIST_TO_TUPLE, replacing them with intrinsics.

  • gh-99005: Add new CALL_INTRINSIC_1 instruction. Remove IMPORT_STAR, PRINT_EXPR and STOPITERATION_ERROR, replacing them with the CALL_INTRINSIC_1 instruction.

  • gh-100288: Remove the LOAD_ATTR_METHOD_WITH_DICT specialized instruction. Stats show it is not useful.

  • gh-100720: Added _PyFrame_NumSlotsForCodeObject, which returns the number of slots needed in a frame for a given code object.

  • gh-100719: Removed the co_nplaincellvars field from the code object, as it is redundant.

  • gh-100637: Fix int.__sizeof__() calculation to include the 1-element ob_digit array for 0 and False.

  • gh-100649: Update the native_thread_id field of PyThreadState after fork.

  • gh-100126: Fix an issue where «incomplete» frames could be briefly visible to C code while other frames are being torn down, possibly resulting in corruption or hard crashes of the interpreter while running finalizers.

  • gh-87447: Fix SyntaxError on comprehension rebind checking with names that are not actually redefined.

    Now reassigning b in [(b := 1) for a, b.prop in some_iter] is allowed. Reassigning a is still disallowed as per PEP 572.

  • gh-100268: Add int.is_integer() to improve duck type compatibility between int and float.

  • gh-100425: Improve the accuracy of sum() with compensated summation.

  • gh-100374: Fix incorrect result and delay in socket.getfqdn(). Patch by Dominic Socular.

  • gh-100357: Convert vars, dir, next, getattr, and iter to argument clinic.

  • gh-100117: Improve the output of codeobject.co_lines() by emitting only one entry for each line range.

  • gh-90043: Handle NaNs when specializing COMPARE_OP for float values.

  • gh-100222: Redefine the _Py_CODEUNIT typedef as a union to describe its layout to the C compiler, avoiding type punning and improving clarity.

  • gh-99955: Internal compiler functions (in compile.c) now consistently return -1 on error and 0 on success.

  • gh-100188: The BINARY_SUBSCR_LIST_INT and BINARY_SUBSCR_TUPLE_INT instructions are no longer used for negative integers because those instructions always miss when encountering negative integers.

  • gh-99110: Initialize frame->previous in frameobject.c to fix a segmentation fault when accessing frames created by PyFrame_New().

  • gh-94155: Improved the hashing algorithm for code objects, mitigating some hash collisions.

  • gh-99540: None now hashes to a constant value. This is not a requirements change.

  • gh-100143: When built with --enable-pystats, stats collection is now off by default. To enable it early at startup, pass the -Xpystats flag. Stats are now always dumped, even if switched off.

  • gh-100146: Improve BUILD_LIST opcode so that it works similarly to the BUILD_TUPLE opcode, by stealing references from the stack rather than repeatedly using stack operations to set list elements. Implementation details are in a new private API _PyList_FromArraySteal().

  • gh-100110: Specialize FOR_ITER for tuples.

  • gh-100050: Honor existing errors obtained when searching for mismatching parentheses in the tokenizer. Patch by Pablo Galindo

  • gh-92216: Improve the performance of hasattr() for type objects with a missing attribute.

  • gh-99582: Freeze zipimport module into _bootstrap_python.

  • gh-99554: Pack debugging location tables more efficiently during bytecode compilation.

  • gh-98522: Add an internal version number to code objects, to give better versioning of inner functions and comprehensions, and thus better specialization of those functions. This change is invisible to both Python and C extensions.

  • gh-94603: Improve performance of list.pop for small lists.

  • gh-89051: Add ssl.OP_LEGACY_SERVER_CONNECT

  • bpo-32782: ctypes arrays of length 0 now report a correct itemsize when a memoryview is constructed from them, rather than always giving a value of 0.

Library

Documentation

Tests

  • gh-100454: Start running SSL tests with OpenSSL 3.1.0-beta1.

  • gh-100086: The Python test runner (libregrtest) now logs Python build information like «debug» vs «release» build, or LTO and PGO optimizations. Patch by Victor Stinner.

  • gh-93018: Make two tests forgiving towards host system libexpat with backported security fixes applied.

Build

  • gh-100540: Removed the --with-system-ffi configure option; libffi must now always be supplied by the system on all non-Windows platforms. The option has had no effect on non-Darwin platforms for several releases, and in 3.11 only had the non-obvious effect of invoking pkg-config to find libffi and never setting -DUSING_APPLE_OS_LIBFFI. Now on Darwin platforms configure will first check for the OS libffi and then fall back to the same processing as other platforms if it is not found.

  • gh-88267: Avoid exporting Python symbols in linked Windows applications when the core is built as static.

  • bpo-41916: Allow override of ac_cv_cxx_thread so that cross compiled python can set -pthread for CXX.

Windows

  • gh-100180: Update Windows installer to OpenSSL 1.1.1s

  • gh-99191: Use _MSVC_LANG >= 202002L instead of less-precise _MSC_VER >=1929 to more accurately test for C++20 support in PC/_wmimodule.cpp.

  • gh-79218: Define MS_WIN64 for Mingw-w64 64bit, fix cython compilation failure.

  • gh-99941: Ensure that asyncio.Protocol.data_received() receives an immutable bytes object (as documented), instead of bytearray.

  • bpo-43984: winreg.SetValueEx() now leaves the target value untouched in the case of conversion errors. Previously, -1 would be written in case of such errors.

  • bpo-34816: hasattr(ctypes.windll, 'nonexistant') now returns False instead of raising OSError.

macOS

  • gh-100180: Update macOS installer to OpenSSL 1.1.1s

  • gh-100540: Removed obsolete dlfcn.h shim from the _ctypes extension module, which has not been necessary since Mac OS X 10.2.

Tools/Demos

  • bpo-45256: Fix a bug that caused an AttributeError to be raised in python-gdb.py when py-locals is used without a frame.

  • gh-100342: Add missing NULL check for possible allocation failure in *args parsing in Argument Clinic.

C API

  • gh-99947: Raising SystemError on import will now have its cause be set to the original unexpected exception.

  • gh-99240: In argument parsing, after deallocating newly allocated memory, reset its pointer to NULL.

  • gh-98724: The Py_CLEAR, Py_SETREF and Py_XSETREF macros now only evaluate their arguments once. If an argument has side effects, these side effects are no longer duplicated. Patch by Victor Stinner.

Python 3.12.0 alpha 3

Release date: 2022-12-06

Security

  • gh-100001: python -m http.server no longer allows terminal control characters sent within a garbage request to be printed to the stderr server log.

    This is done by changing the http.server BaseHTTPRequestHandler .log_message method to replace control characters with a \xHH hex escape before printing.

  • gh-87604: Avoid publishing list of active per-interpreter audit hooks via the gc module

Core and Builtins

  • gh-99891: Fix a bug in the tokenizer that could cause infinite recursion when showing syntax warnings that happen in the first line of the source. Patch by Pablo Galindo

  • gh-91054: Add PyCode_AddWatcher() and PyCode_ClearWatcher() APIs to register callbacks to receive notification on creation and destruction of code objects.

  • gh-99729: Fix an issue that could cause frames to be visible to Python code as they are being torn down, possibly leading to memory corruption or hard crashes of the interpreter.

  • gh-99708: Fix bug where compiler crashes on an if expression with an empty body block.

  • gh-99578: Fix a reference bug in _imp.create_builtin() after the creation of the first sub-interpreter for modules builtins and sys. Patch by Victor Stinner.

  • gh-99581: Fixed a bug that was causing a buffer overflow if the tokenizer copies a line missing the newline character from a file that is as long as the available tokenizer buffer. Patch by Pablo galindo

  • gh-99553: Fix bug where an ExceptionGroup subclass can wrap a BaseException.

  • gh-99547: Add a function to os.path to check if a path is a junction: isjunction. Add similar functionality to pathlib.Path as is_junction.

  • gh-99370: Fix zip path for venv created from a non-installed python on POSIX platforms.

  • gh-99377: Add audit events for thread creation and clear operations.

  • gh-98686: Remove the BINARY_OP_GENERIC and COMPARE_OP_GENERIC «specializations».

  • gh-99298: Remove the remaining error paths for attribute specializations, and refuse to specialize attribute accesses on types that haven’t had PyType_Ready() called on them yet.

  • gh-99127: Allow some features of syslog to the main interpreter only. Patch by Donghee Na.

  • gh-91053: Optimizing interpreters and JIT compilers may need to invalidate internal metadata when functions are modified. This change adds the ability to provide a callback that will be invoked each time a function is created, modified, or destroyed.

  • gh-90994: Improve error messages when there’s a syntax error with call arguments. The following three cases are covered: - No value is assigned to a named argument, eg foo(a=). - A value is assigned to a star argument, eg foo(*args=[0]). - A value is assigned to a double-star keyword argument, eg foo(**kwarg={'a': 0}).

  • bpo-45026: Optimize the range object iterator. It is now smaller, faster iteration of ranges containing large numbers. Smaller pickles, faster unpickling.

  • bpo-31718: Raise ValueError instead of SystemError when methods of uninitialized io.IncrementalNewlineDecoder objects are called. Patch by Oren Milman.

  • bpo-38031: Fix a possible assertion failure in io.FileIO when the opener returns an invalid file descriptor.

Library

  • gh-100001: Also escape s in the http.server BaseHTTPRequestHandler.log_message so that it is technically possible to parse the line and reconstruct what the original data was. Without this a xHH is ambiguous as to if it is a hex replacement we put in or the characters r»x» came through in the original request line.

  • gh-99957: Add frozen_default parameter to typing.dataclass_transform().

  • gh-79033: Fix asyncio.Server.wait_closed() to actually do what the docs promise – wait for all existing connections to complete, after closing the server.

  • gh-51524: Fix bug when calling trace.CoverageResults with valid infile.

  • gh-99645: Fix a bug in handling class cleanups in unittest.TestCase. Now addClassCleanup() uses separate lists for different TestCase subclasses, and doClassCleanups() only cleans up the particular class.

  • gh-99508: Fix TypeError in Lib/importlib/_bootstrap_external.py while calling _imp.source_hash().

  • gh-66285: Fix asyncio to not share event loop and signal wakeupfd in forked processes. Patch by Kumar Aditya.

  • gh-97001: Release the GIL when calling termios APIs to avoid blocking threads.

  • gh-92647: Use final status of an enum to determine lookup or creation branch of functional API.

  • gh-99388: Add loop_factory parameter to asyncio.run() to allow specifying a custom event loop factory. Patch by Kumar Aditya.

  • gh-99341: Fix ast.increment_lineno() to also cover ast.TypeIgnore when changing line numbers.

  • gh-99382: Check the number of arguments in substitution in user generics containing a TypeVarTuple and one or more TypeVar.

  • gh-99379: Fix substitution of ParamSpec followed by TypeVarTuple in generic aliases.

  • gh-99344: Fix substitution of TypeVarTuple and ParamSpec together in user generics.

  • gh-99284: Remove _use_broken_old_ctypes_structure_semantics_ old untested and undocumented hack from ctypes.

  • gh-99201: Fix IndexError when initializing the config variables on Windows if HAVE_DYNAMIC_LOADING is not set.

  • gh-99240: Fix double-free bug in Argument Clinic str_converter by extracting memory clean up to a new post_parsing section.

  • gh-64490: Fix refcount error when arguments are packed to tuple in Argument Clinic.

  • gh-99029: pathlib.PurePath.relative_to() now treats naked Windows drive paths as relative. This brings its behaviour in line with other parts of pathlib.

  • gh-98253: The implementation of the typing module is now more resilient to reference leaks in binary extension modules.

    Previously, a reference leak in a typed C API-based extension module could leak internals of the typing module, which could in turn introduce leaks in essentially any other package with typed function signatures. Although the typing package is not the original source of the problem, such non-local dependences exacerbate debugging of large-scale projects, and the implementation was therefore changed to reduce harm by providing better isolation.

  • gh-98458: Fix infinite loop in unittest when a self-referencing chained exception is raised

  • gh-93453: asyncio.get_event_loop() and many other asyncio functions like asyncio.ensure_future(), asyncio.shield() or asyncio.gather(), and also the get_event_loop() method of asyncio.BaseDefaultEventLoopPolicy now raise a RuntimeError if called when there is no running event loop and the current event loop was not set. Previously they implicitly created and set a new current event loop. DeprecationWarning is no longer emitted if there is no running event loop but the current event loop was set.

  • gh-97966: On uname_result, restored expectation that _fields and _asdict would include all six properties including processor.

  • gh-98248: Provide informative error messages in struct.pack() when its integral arguments are not in range.

  • gh-98108: zipfile.Path is now pickleable if its initialization parameters were pickleable (e.g. for file system paths).

  • gh-98098: Created packages from zipfile and test_zipfile modules, separating zipfile.Path functionality.

  • gh-82836: Fix is_private properties in the ipaddress module. Previously non-private networks (0.0.0.0/0) would return True from this method; now they correctly return False.

  • gh-96828: Add an OP_ENABLE_KTLS option for enabling the use of the kernel TLS (kTLS). Patch by Illia Volochii.

  • gh-88863: To avoid apparent memory leaks when asyncio.open_connection() raises, break reference cycles generated by local exception and future instances (which has exception instance as its member var). Patch by Dong Uk, Kang.

  • gh-91078: TarFile.next() now returns None when called on an empty tarfile.

  • bpo-47220: Document the optional callback parameter of WeakMethod. Patch by Géry Ogam.

  • bpo-44817: Ignore WinError 53 (ERROR_BAD_NETPATH), 65 (ERROR_NETWORK_ACCESS_DENIED) and 161 (ERROR_BAD_PATHNAME) when using ntpath.realpath().

  • bpo-41260: Rename the fmt parameter of the pure Python implementation of datetime.date.strftime() to format.

  • bpo-15999: All built-in functions now accept arguments of any type instead of just bool and int for boolean parameters.

Documentation

  • gh-99931: Use sphinxext-opengraph to generate OpenGraph metadata.

  • gh-89682: Reworded docstring of the default __contains__ to clarify that it returns a bool.

  • gh-88330: Improved the description of what a resource is in importlib.resources docs.

  • gh-92892: Document that calling variadic functions with ctypes requires special care on macOS/arm64 (and possibly other platforms).

  • bpo-41825: Restructured the documentation for the os.wait* family of functions, and improved the docs for os.waitid() with more explanation of the possible argument constants.

Tests

  • gh-99892: Skip test_normalization() of test_unicodedata if it fails to download NormalizationTest.txt file from pythontest.net. Patch by Victor Stinner.

  • gh-99934: Correct test_marsh on (32 bit) x86: test_deterministic sets was failing.

  • gh-99741: We’ve implemented multi-phase init (PEP 489/630/687) for the internal (for testing) _xxsubinterpreters module.

  • gh-99659: Optional big memory tests in test_sqlite3 now catch the correct sqlite.DataError exception type in case of too large strings and/or blobs passed.

  • gh-99593: Cover the Unicode C API with tests.

  • gh-96002: Add functional test for Argument Clinic.

Build

  • gh-99086: Fix -Wimplicit-int, -Wstrict-prototypes, and -Wimplicit-function-declaration compiler warnings in configure checks.

  • gh-99337: Fix a compilation issue with GCC 12 on macOS.

  • gh-99289: Add a COMPILEALL_OPTS variable in Makefile to override compileall options (default: -j0) in make install. Also merged the compileall commands into a single command building .pyc files for the all optimization levels (0, 1, 2) at once. Patch by Victor Stinner.

  • gh-98872: Fix a possible fd leak in Programs/_freeze_module.c introduced in Python 3.11.

  • gh-88226: Always define TARGET_* labels in Python/ceval.c, even if USE_COMPUTED_GOTOS is disabled. This allows breakpoints to be set at those labels in (for instance) gdb.

Windows

macOS

  • gh-87235: On macOS python3 /dev/fd/9 9</path/to/script.py failed for any script longer than a couple of bytes.

  • gh-98940: Fix Mac/Extras.install.py file filter bug.

Tools/Demos

  • gh-64490: Argument Clinic varargs bugfixes

    • Fix out-of-bounds error in _PyArg_UnpackKeywordsWithVararg().

    • Fix incorrect check which allowed more than one varargs in clinic.py.

    • Fix miscalculation of noptargs in generated code.

    • Do not generate noptargs when there is a vararg argument and no optional argument.

C API

  • gh-98680: PyBUF_* constants were marked as part of Limited API of Python 3.11+. These were available in 3.11.0 with Py_LIMITED_API defined for 3.11, and are necessary to use the buffer API.

  • gh-99612: Fix PyUnicode_DecodeUTF8Stateful() for ASCII-only data: *consumed was not set.

  • gh-47146: The structmember.h header is deprecated. Its non-deprecated contents are now available just by including Python.h, with a Py_ prefix added if it was missing. (Deprecated contents are T_OBJECT, T_NONE, and no-op flags.) Patch by Petr Viktorin, based on earlier work by Alexander Belopolsky and Matthias Braun.

Python 3.12.0 alpha 2

Release date: 2022-11-14

Security

  • gh-98433: The IDNA codec decoder used on DNS hostnames by socket or asyncio related name resolution functions no longer involves a quadratic algorithm. This prevents a potential CPU denial of service if an out-of-spec excessive length hostname involving bidirectional characters were decoded. Some protocols such as urllib http 3xx redirects potentially allow for an attacker to supply such a name.

    Individual labels within an IDNA encoded DNS name will now raise an error early during IDNA decoding if they are longer than 1024 unicode characters given that each decoded DNS label must be 63 or fewer characters and the entire decoded DNS name is limited to 255. Only an application presenting a hostname or label consisting primarily of RFC 3454 section 3.1 «Nothing» characters to be removed would run into of this new limit. See also RFC 5894 section 6 and RFC 3491.

  • gh-98739: Update bundled libexpat to 2.5.0

Core and Builtins

  • gh-81057: The docs clearly say that PyImport_Inittab, PyImport_AppendInittab(), and PyImport_ExtendInittab() should not be used after Py_Initialize() has been called. We now enforce this for the two functions. Additionally, the runtime now uses an internal copy of PyImport_Inittab, to guard against modification.

  • gh-99298: Fix an issue that could potentially cause incorrect error handling for some bytecode instructions.

  • gh-99254: The compiler now removes all unused constants from code objects (except the first one, which may be a docstring).

  • gh-99205: Fix an issue that prevented PyThreadState and PyInterpreterState memory from being freed properly.

  • gh-81057: The 18 global C variables holding the state of the allocators have been moved to _PyRuntimeState. This is a strictly internal change with no change in behavior.

  • gh-99181: Fix failure in except* with unhashable exceptions.

  • gh-99204: Fix calculation of sys._base_executable when inside a POSIX virtual environment using copies of the python binary when the base installation does not provide the executable name used by the venv. Calculation will fall back to alternative names («python<MAJOR>», «python<MAJOR>.<MINOR>»).

  • gh-96055: Update faulthandler to emit an error message with the proper unexpected signal number. Patch by Donghee Na.

  • gh-99153: Fix location of SyntaxError for a try block with both except and except*.

  • gh-98686: Merge the adaptive opcode logic into each instruction’s unquickened variant, and merge the logic in EXTENDED_ARG_QUICK into EXTENDED_ARG. With these changes, the quickening that happens at code object creation is now only responsible for initializing warmup counters and inserting superinstructions.

  • gh-99103: Fix the error reporting positions of specialized traceback anchors when the source line contains Unicode characters.

  • gh-99139: Improve the error suggestion for NameError exceptions for instances. Now if a NameError is raised in a method and the instance has an attribute that’s exactly equal to the name in the exception, the suggestion will include self.<NAME> instead of the closest match in the method scope. Patch by Pablo Galindo

  • gh-98401: Octal escapes with value larger than 0o377 (ex: "\477"), deprecated in Python 3.11, now produce a SyntaxWarning, instead of DeprecationWarning. In a future Python version they will be eventually a SyntaxError. Patch by Victor Stinner.

  • gh-98401: A backslash-character pair that is not a valid escape sequence now generates a SyntaxWarning, instead of DeprecationWarning. For example, re.compile("\d+\.\d+") now emits a SyntaxWarning ("\d" is an invalid escape sequence), use raw strings for regular expression: re.compile(r"\d+\.\d+"). In a future Python version, SyntaxError will eventually be raised, instead of SyntaxWarning. Patch by Victor Stinner.

  • gh-96793: Handle StopIteration and StopAsyncIteration raised in generator or coroutines in the bytecode, rather than in wrapping C code.

  • gh-98931: Improve the SyntaxError error message when the user types import x from y instead of from y import x. Patch by Pablo Galindo

  • gh-98852: Fix subscription of type aliases containing bare generic types or types like TypeVar: for example tuple[A, T][int] and tuple[TypeVar, T][int], where A is a generic type, and T is a type variable.

  • gh-98925: Lower the recursion depth for marshal on WASI to support (in-development) wasmtime 2.0.

  • gh-98783: Fix multiple crashes in debug mode when str subclasses are used instead of str itself.

  • gh-98811: Use complete source locations to simplify detection of __future__ imports which are not at the beginning of the file. Also corrects the offset in the exception raised in one case, which was off by one and impeded highlighting.

  • gh-96793: Add specialization of FOR_ITER for generators. Saves multiple layers of dispatch and checking to get from the FOR_ITER instruction in the caller to the RESUME in the generator.

  • gh-98762: Fix source locations of match sub-patterns.

  • gh-98586: Added the methods PyObject_Vectorcall() and PyObject_VectorcallMethod() to the Limited API along with the auxiliary macro constant PY_VECTORCALL_ARGUMENTS_OFFSET.

    The availability of these functions enables more efficient PEP 590 vector calls from binary extension modules that avoid argument boxing/unboxing overheads.

  • gh-99257: Fix an issue where member descriptors (such as those for __slots__) could behave incorrectly or crash instead of raising a TypeError when accessed via an instance of an invalid type.

  • gh-93143: Rather than changing co_code, the interpreter will now display a RuntimeWarning and assign None to any fast locals that are left unbound after jumps or del statements executed while tracing.

  • gh-96421: When calling into Python code from C code, through PyEval_EvalFrameEx() or a related C-API function, a shim frame in inserted into the call stack. This occurs in the _PyEval_EvalFrameDefault() function. The extra frame should be invisible to all Python and most C extensions, but out-of-process profilers and debuggers need to be aware of it. These shim frames can be detected by checking frame->owner == FRAME_OWNED_BY_CSTACK.

    Extensions implementing their own interpreters using PEP 523 need to be aware of this shim frame and the changes to the semantics of RETURN_VALUE, YIELD_VALUE, and RETURN_GENERATOR, which now clear the frame.

  • gh-98415: Fix detection of MAC addresses for uuid on certain OSs. Patch by Chaim Sanders

  • gh-98686: Quicken all code objects, and specialize adaptive bytecode instructions more aggressively.

  • gh-92119: Print exception class name instead of its string representation when raising errors from ctypes calls.

  • gh-91058: ImportError raised from failed from <module> import <name> now include suggestions for the value of <name> based on the available names in <module>. Patch by Pablo Galindo

  • gh-96793: The FOR_ITER now leaves the iterator on the stack on termination of the loop. This is to assist specialization of loops for generators.

  • gh-90716: Add _pylong.py module. It includes asymptotically faster algorithms that can be used for operations on integers with many digits. It is used by longobject.c to speed up some operations.

  • gh-95389: Expose ETH_P_ALL and some of the ETHERTYPE_* constants in socket. Patch by Noam Cohen.

  • gh-93696: Allow pdb to locate source for frozen modules in the standard library.

Library

  • gh-99418: Fix bug in urllib.parse.urlparse() that causes URL schemes that begin with a digit, a plus sign, or a minus sign to be parsed incorrectly.

  • gh-94597: Deprecate asyncio.AbstractChildWatcher to be removed in Python 3.14. Patch by Kumar Aditya.

  • gh-99305: Improve performance of secrets.token_hex().

  • gh-74044: Fixed bug where inspect.signature() reported incorrect arguments for decorated methods.

  • gh-99275: Fix SystemError in ctypes when exception was not set during __initsubclass__.

  • gh-99277: Remove older version of _SSLProtocolTransport.get_write_buffer_limits in asyncio.sslproto

  • gh-99248: fix negative numbers failing in verify()

  • gh-99155: Fix statistics.NormalDist pickle with 0 and 1 protocols.

  • gh-93464: enum.auto() is now correctly activated when combined with other assignment values. E.g. ONE = auto(), 'some text' will now evaluate as (1, 'some text').

  • gh-99134: Update the bundled copy of pip to version 22.3.1.

  • gh-92584: Remove the distutils package. It was deprecated in Python 3.10 by PEP 632 «Deprecate distutils module». For projects still using distutils and cannot be updated to something else, the setuptools project can be installed: it still provides distutils. Patch by Victor Stinner.

  • gh-98999: Now _pyio is consistent with _io in raising ValueError when executing methods over closed buffers.

  • gh-83004: Clean up refleak on failed module initialisation in _zoneinfo

  • gh-83004: Clean up refleaks on failed module initialisation in _pickle

  • gh-83004: Clean up refleak on failed module initialisation in _io.

  • gh-98897: Fix memory leak in math.dist() when both points don’t have the same dimension. Patch by Kumar Aditya.

  • gh-98878: Use the frame bound builtins when offering a name suggestion in traceback to prevent crashing when __builtins__ is not a dict.

  • gh-98139: In importlib._bootstrap, enhance namespace package repr to <module 'x' (namespace) from ['path']>.

  • gh-90352: Fix _SelectorDatagramTransport to inherit from DatagramTransport in asyncio. Patch by Kumar Aditya.

  • gh-98793: Fix argument typechecks in _overlapped.WSAConnect() and _overlapped.Overlapped.WSASendTo() functions.

  • gh-98744: Prevent crashing in traceback when retrieving the byte-offset for some source files that contain certain unicode characters.

  • gh-98740: Fix internal error in the re module which in very rare circumstances prevented compilation of a regular expression containing a conditional expression without the «else» branch.

  • gh-98703: Fix asyncio.StreamWriter.drain() to call protocol.connection_lost callback only once on Windows.

  • gh-98624: Add a mutex to unittest.mock.NonCallableMock to protect concurrent access to mock attributes.

  • gh-98658: The array.array class now supports subscripting, making it a generic type.

  • gh-98284: Improved TypeError message for undefined abstract methods of a abc.ABC instance. The names of the missing methods are surrounded by single-quotes to highlight them.

  • gh-96151: Allow BUILTINS to be a valid field name for frozen dataclasses.

  • gh-98086: Make sure patch.dict() can be applied on async functions.

  • gh-72719: Remove modules asyncore and asynchat, which were deprecated by PEP 594.

  • gh-96192: Fix handling of bytes path-like objects in os.ismount().

  • gh-94172: ftplib: Remove the FTP_TLS.ssl_version class attribute: use the context parameter instead. Patch by Victor Stinner

  • gh-94172: Remove the keyfile and certfile parameters from the ftplib, imaplib, poplib and smtplib modules, and the key_file, cert_file and check_hostname parameters from the http.client module, all deprecated since Python 3.6. Use the context parameter (ssl_context in imaplib) instead. Patch by Victor Stinner.

  • gh-83638: Add the autocommit attribute to sqlite3.Connection and the autocommit parameter to sqlite3.connect() to control PEP 249-compliant transaction handling. Patch by Erlend E. Aasland.

  • gh-92452: Fixed a race condition that could cause sysconfig.get_config_var() to incorrectly return None in multi-threaded programs.

  • gh-91803: Fix an error when using a method of objects mocked with unittest.mock.create_autospec() after it was sealed with unittest.mock.seal() function.

  • bpo-38523: shutil.copytree() now applies the ignore_dangling_symlinks argument recursively.

  • bpo-40358: Add walk_up argument in pathlib.PurePath.relative_to().

  • bpo-36267: Fix IndexError in argparse.ArgumentParser when a store_true action is given an explicit argument.

Documentation

  • gh-98832: Changes wording of docstring for pathlib.Path.iterdir().

  • gh-97966: Update uname docs to clarify the special nature of the platform attribute and to indicate when it became late-bound.

Tests

  • gh-98903: The Python test suite now fails with exit code 4 if no tests ran. It should help detecting typos in test names and test methods.

  • gh-98713: Fix a bug in the typing tests where a test relying on CPython-specific implementation details was not decorated with @cpython_only and was not skipped on other implementations.

  • gh-87390: Add tests for star-unpacking with PEP 646, and some other miscellaneous PEP 646 tests.

  • gh-96853: Added explicit coverage of Py_Initialize (and hence Py_InitializeEx) back to the embedding tests (all other embedding tests migrated to Py_InitializeFromConfig in Python 3.11)

  • bpo-34272: Some C API tests were moved into the new Lib/test/test_capi/ directory.

Build

  • gh-99086: Fix -Wimplicit-int compiler warning in configure check for PTHREAD_SCOPE_SYSTEM.

  • gh-99016: Fix build with PYTHON_FOR_REGEN=python3.8.

  • gh-97731: Specify the full path to the source location for make docclean (needed for cross-builds).

  • gh-98949: Drop unused build dependency on readelf.

  • gh-98989: Use python3.11, if available, for regeneration and freezing.

  • gh-98831: Add new tooling, in Tools/cases_generator, to generate the interpreter switch statement from a list of opcode definitions. This only affects adding, modifying or removing instruction definitions. The instruction definitions now live in Python/bytecodes.c, in the form of a custom DSL (under development). The tooling reads this file and writes Python/generated_cases.c.h, which is then included by Python/ceval.c to provide most of the cases of the main interpreter switch.

  • gh-98817: Remove PCbuild/lib.pyproj: it’s not used for anything, is only a minor convenience for Visual Studio users (who probably mostly don’t even know about it), and it takes a lot of maintenance effort to keep updated.

  • gh-98776: Fix make regen-test-levenshtein for out-of-tree builds.

  • gh-98707: Don’t use vendored libmpdec headers if --with-system-libmpdec is passed to configure. Don’t use vendored libexpat headers if --with-system-expat is passed to configure.

Windows

  • gh-98689: Update Windows builds to zlib v1.2.13. v1.2.12 has CVE 2022-37434, but the vulnerable inflateGetHeader API is not used by Python.

  • gh-98790: Assumes that a missing DLLs directory means that standard extension modules are in the executable’s directory.

  • gh-98745: Update py.exe launcher to install 3.11 by default and 3.12 on request.

  • gh-98692: Fix the Python Install Manager ignoring unrecognized shebang lines instead of treating them as local paths

  • gh-94328: Update Windows installer to use SQLite 3.39.4.

macOS

  • gh-94328: Update macOS installer to SQLite 3.39.4.

C API

  • gh-98724: The Py_CLEAR, Py_SETREF and Py_XSETREF macros now only evaluate their argument once. If the argument has side effects, these side effects are no longer duplicated. Patch by Victor Stinner.

  • gh-98978: Fix use-after-free in Py_SetPythonHome(NULL), Py_SetProgramName(NULL) and _Py_SetProgramFullPath(NULL) function calls. Issue reported by Benedikt Reinartz. Patch by Victor Stinner.

  • gh-98410: Add getbufferproc and releasebufferproc to the stable API.

  • gh-98610: Some configurable capabilities of sub-interpreters have changed. They always allow subprocesses (subprocess) now, whereas before subprocesses could be optionally disallowed for a sub-interpreter. Instead os.exec() can now be disallowed. Disallowing daemon threads is now supported. Disallowing all threads is still allowed, but is never done by default. Note that the optional restrictions are only available through _Py_NewInterpreterFromConfig(), which isn’t a public API. They do not affect the main interpreter, nor Py_NewInterpreter().

  • gh-98608: A _PyInterpreterConfig has been added and _Py_NewInterpreter() has been renamed to _Py_NewInterpreterFromConfig(). The «isolated_subinterpreters» argument is now a granular config that captures the previous behavior. Note that this is all «private» API.

  • gh-96853: Py_InitializeEx now correctly calls PyConfig_Clear after initializing the interpreter (the omission didn’t cause a memory leak only because none of the dynamically allocated config fields are populated by the wrapper function)

  • gh-91248: Add PyFrame_GetVar() and PyFrame_GetVarString() functions to get a frame variable by its name. Patch by Victor Stinner.

Python 3.12.0 alpha 1

Release date: 2022-10-25

Security

  • gh-97616: Fix multiplying a list by an integer (list *= int): detect the integer overflow when the new allocated length is close to the maximum size. Issue reported by Jordan Limor. Patch by Victor Stinner.

  • gh-97514: On Linux the multiprocessing module returns to using filesystem backed unix domain sockets for communication with the forkserver process instead of the Linux abstract socket namespace. Only code that chooses to use the «forkserver» start method is affected.

    Abstract sockets have no permissions and could allow any user on the system in the same network namespace (often the whole system) to inject code into the multiprocessing forkserver process. This was a potential privilege escalation. Filesystem based socket permissions restrict this to the forkserver process user as was the default in Python 3.8 and earlier.

    This prevents Linux CVE 2022-42919.

  • gh-87389: http.server: Fix an open redirection vulnerability in the HTTP server when an URI path starts with //. Vulnerability discovered, and initial fix proposed, by Hamza Avvan.

  • gh-79096: LWPCookieJar and MozillaCookieJar create files with file mode 600 instead of 644 (Microsoft Windows is not affected)

  • gh-92888: Fix memoryview use after free when accessing the backing buffer in certain cases.

  • gh-68966: The deprecated mailcap module now refuses to inject unsafe text (filenames, MIME types, parameters) into shell commands. Instead of using such text, it will warn and act as if a match was not found (or for test commands, as if the test failed).

Core and Builtins

  • gh-98374: Suppress ImportError for invalid query for help() command. Patch by Donghee Na.

  • gh-98461: Fix source location in bytecode for list, set and dict comprehensions as well as generator expressions.

  • gh-98354: Added unicode check for name attribute of spec argument passed in _imp.create_builtin() function.

  • gh-98398: Fix source location of “assert” bytecodes.

  • gh-98390: Fix location of sub-expressions of boolean expressions, by reducing their scope to that of the sub-expression.

  • gh-98254: Modules from the standard library are now potentially suggested as part of the error messages displayed by the interpreter when an NameError is raised to the top level. Patch by Pablo Galindo

  • gh-97997: Add running column offset to the tokenizer state to avoid calculating AST column information with pointer arithmetic.

  • gh-97973: Modify the tokenizer to return all necessary information the parser needs to set location information in the AST nodes, so that the parser does not have to calculate those doing pointer arithmetic.

  • gh-96078: os.sched_yield() now release the GIL while calling sched_yield(2). Patch by Donghee Na.

  • gh-97955: Migrate zoneinfo to Argument Clinic.

  • gh-97912: The compiler now avoids quadratic behavior when finding which instructions should use the LOAD_FAST_CHECK opcode.

  • gh-97002: Fix an issue where several frame objects could be backed by the same interpreter frame, possibly leading to corrupted memory and hard crashes of the interpreter.

  • gh-97943: Bugfix: PyFunction_GetAnnotations() should return a borrowed reference. It was returning a new reference.

  • gh-97922: The Garbage Collector now runs only on the eval breaker mechanism of the Python bytecode evaluation loop instead on object allocations. The GC can also run when PyErr_CheckSignals() is called so C extensions that need to run for a long time without executing any Python code also have a chance to execute the GC periodically.

  • gh-65961: When __package__ is different than __spec__.parent, raise a DeprecationWarning instead of ImportWarning.

    Also remove importlib.util.set_package() which was scheduled for removal.

  • gh-97850: Long deprecated, module_repr() should now be completely eradicated.

  • gh-86298: In cases where warnings.warn_explicit() consults the module’s loader, an DeprecationWarning is issued when m.__loader__ differs from m.__spec__.loader.

  • gh-97779: Ensure that all Python frame objects are backed by «complete» frames.

  • gh-91052: Add API for subscribing to modification events on selected dictionaries.

  • gh-97752: Fix possible data corruption or crashes when accessing the f_back member of newly-created generator or coroutine frames.

  • gh-97591: Fixed a missing incref/decref pair in Exception.__setstate__(). Patch by Ofey Chan.

  • gh-97670: Remove the sys.getdxp() function and the Tools/scripts/analyze_dxp.py script. DXP stands for «dynamic execution pairs». They were related to DYNAMIC_EXECUTION_PROFILE and DXPAIRS macros which have been removed in Python 3.11. Python can now be built with ./configure --enable-pystats to gather statistics on Python opcodes. Patch by Victor Stinner.

  • gh-94526: Fix the Python path configuration used to initialized sys.path at Python startup. Paths are no longer encoded to UTF-8/strict to avoid encoding errors if it contains surrogate characters (bytes paths are decoded with the surrogateescape error handler). Patch by Victor Stinner.

  • gh-96670: The parser now raises SyntaxError when parsing source code containing null bytes. Patch by Pablo Galindo

  • gh-96975: Fix a crash occurring when PyEval_GetFrame() is called while the topmost Python frame is in a partially-initialized state.

  • gh-96848: Fix command line parsing: reject -X int_max_str_digits option with no value (invalid) when the PYTHONINTMAXSTRDIGITS environment variable is set to a valid limit. Patch by Victor Stinner.

  • gh-95921: Fix overly-broad source position information for chained comparisons used as branching conditions.

  • gh-96821: Fix undefined behaviour in audioop.c.

  • gh-96821: Fix undefined behaviour in _testcapimodule.c.

  • gh-95778: When ValueError is raised if an integer is larger than the limit, mention the sys.set_int_max_str_digits() function in the error message. Patch by Victor Stinner.

  • gh-96387: At Python exit, sometimes a thread holding the GIL can wait forever for a thread (usually a daemon thread) which requested to drop the GIL, whereas the thread already exited. To fix the race condition, the thread which requested the GIL drop now resets its request before exiting. Issue discovered and analyzed by Mingliang ZHAO. Patch by Victor Stinner.

  • gh-96864: Fix a possible assertion failure, fatal error, or SystemError if a line tracing event raises an exception while opcode tracing is enabled.

  • gh-95778: The PyLong_FromString function was refactored to make it more maintainable and extensible.

  • gh-96678: Fix undefined behaviour in C code of null pointer arithmetic.

  • gh-96754: Make sure that all frame objects created are created from valid interpreter frames. Prevents the possibility of invalid frames in backtraces and signal handlers.

  • gh-90997: Improve the performance of reading and writing inline bytecode caches on some platforms.

  • gh-96751: Remove dead code from CALL_FUNCTION_EX opcode.

  • gh-90751: memoryview now supports half-floats. Patch by Donghee Na and Antoine Pitrou.

  • gh-96678: Fix case of undefined behavior in ceval.c

  • gh-64373: Convert _functools to argument clinic.

  • gh-96641: Do not expose KeyWrapper in _functools.

  • gh-96636: Ensure that tracing, sys.setrace(), is turned on immediately. In pre-release versions of 3.11, some tracing events might have been lost when turning on tracing in a __del__ method or interrupt.

  • gh-96572: Fix use after free in trace refs build mode. Patch by Kumar Aditya.

  • gh-96611: When loading a file with invalid UTF-8 inside a multi-line string, a correct SyntaxError is emitted.

  • gh-96612: Make sure that incomplete frames do not show up in tracemalloc traces.

  • gh-90230: Fix compiler warnings and test failures when building with --enable-pystats.

  • gh-96587: Correctly raise SyntaxError on exception groups (PEP 654) on python versions prior to 3.11

  • gh-96569: Remove two cases of undefined behavior, by adding NULL checks.

  • gh-96582: Fix possible NULL pointer dereference in _PyThread_CurrentFrames. Patch by Kumar Aditya.

  • gh-91079: Separate Python recursion checking from C recursion checking which reduces the chance of C stack overflow and allows the recursion limit to be increased safely.

  • gh-93911: Fix an issue that could prevent LOAD_ATTR from specializing properly when accessing properties.

  • gh-96348: Emit a DeprecationWarning when throw(), throw() or athrow() are called with more than one argument.

  • gh-95196: Disable incorrect pickling of the C implemented classmethod descriptors.

  • gh-96364: Fix text signatures of list.__getitem__ and dict.__getitem__.

  • gh-96352: Fix AttributeError missing name and obj attributes in object.__getattribute__(). Patch by Philip Georgi.

  • gh-93554: Change the jump opcodes so that all conditional jumps are forward jumps. Backward jumps are converted by the assembler into a conditional forward jump whose target is the fallthrough block (and with a reversed condition), followed by an unconditional backward jump. For example:

    POP_JUMP_IF_TRUE BACKWARD_TARGET becomes POP_JUMP_IF_FALSE NEXT_BLOCK; JUMP BACKWARD_TARGET.

    All the directed conditional jump opcodes were removed: POP_JUMP_FORWARD_IF_TRUE, POP_JUMP_BACKWARD_IF_TRUE, POP_JUMP_FORWARD_IF_FALSE, POP_JUMP_BACKWARD_IF_FALSE, POP_JUMP_FORWARD_IF_NONE, POP_JUMP_BACKWARD_IF_NONE, POP_JUMP_FORWARD_IF_NOT_NONE, POP_JUMP_BACKWARD_IF_NOT_NONE.

    The corresponding opcodes without direction are no longer pseudo-instructions, and they implement the forward conditional jumps.

  • gh-96268: Loading a file with invalid UTF-8 will now report the broken character at the correct location.

  • gh-96237: The internal field _PyInterpreterFrame.f_func is renamed to _PyInterpreterFrame.f_funcobj and may be any object. The f_globals and f_builtin fields may hold junk values.

    It is safest to treat the _PyInterpreterFrame struct as opaque.

  • gh-96187: Fixed a bug that caused _PyCode_GetExtra to return garbage for negative indexes. Patch by Pablo Galindo

  • gh-96143: Add a new -X perf Python command line option as well as sys.activate_stack_trampoline() and sys.deactivate_stack_trampoline() function in the sys module that allows to set/unset the interpreter in a way that the Linux perf profiler can detect Python calls. The new sys.is_stack_trampoline_active() function allows to query the state of the perf trampoline. Design by Pablo Galindo. Patch by Pablo Galindo and Christian Heimes with contributions from Gregory P. Smith [Google] and Mark Shannon.

  • gh-96071: Fix a deadlock in PyGILState_Ensure() when allocating new thread state. Patch by Kumar Aditya.

  • gh-96046: PyType_Ready() now initializes ht_cached_keys and performs additional checks to ensure that type objects are properly configured. This avoids crashes in 3rd party packages that don’t use regular API to create new types.

  • gh-96005: On WASI ENOTCAPABLE is now mapped to PermissionError. The errno modules exposes the new error number. getpath.py now ignores PermissionError when it cannot open landmark files pybuilddir.txt and pyenv.cfg.

  • gh-93678: Added test a harness for direct unit tests of the compiler’s optimization stage. The _testinternalcapi.optimize_cfg() function runs the optimiser on a sequence of instructions. The CfgOptimizationTestCase class in test.support has utilities for invoking the optimizer and checking the output.

  • gh-95245: Reduces the size of a «simple» Python object from 8 to 6 words by moving the weakreflist pointer into the pre-header directly before the object’s dict/values pointer.

  • gh-90997: Compile virtual try/except blocks to handle exceptions raised during close() or throw() calls through a suspended frame.

  • gh-95977: Optimized calling __get__() with vectorcall. Patch by Kumar Aditya.

  • gh-91210: Improve error message when a parameter without a default value follows one with a default value, and show the same message, even when the non-default/default sequence is preceded by positional-only parameters.

  • gh-95922: Fixed bug where the compiler’s eliminate_empty_basic_blocks function ignores the last block of the code unit.

  • gh-95818: Skip over incomplete frames in PyThreadState_GetFrame().

  • gh-95876: Fix format string in _PyPegen_raise_error_known_location that can lead to memory corruption on some 64bit systems. The function was building a tuple with i (int) instead of n (Py_ssize_t) for Py_ssize_t arguments.

  • gh-95605: Fix misleading contents of error message when converting an all-whitespace string to float.

  • gh-95150: Update code object hashing and equality to consider all debugging and exception handling tables. This fixes an issue where certain non-identical code objects could be «deduplicated» during compilation.

  • gh-91146: Reduce allocation size of list from str.split() and str.rsplit(). Patch by Donghee Na and Inada Naoki.

  • gh-87092: Create a “jump target label” abstraction in the compiler so that the compiler’s codegen stage does not work directly with basic blocks. This prepares the code for changes to the underlying CFG generation mechanism.

  • gh-95355: _PyPegen_Parser_New now properly detects token memory allocation errors. Patch by Honglin Zhu.

  • gh-90081: Run Python code in tracer/profiler function at full speed. Fixes slowdown in earlier versions of 3.11.

  • gh-95324: Emit a warning in debug mode if an object does not call PyObject_GC_UnTrack() before deallocation. Patch by Pablo Galindo.

  • gh-95245: Merge managed dict and values pointer into a single tagged pointer to save one word in the pre-header.

  • gh-93678: Add cfg_builder struct and refactor the relevant code so that a cfg can be constructed without an instance of the compiler struct.

  • gh-95185: Prevented crashes in the AST constructor when compiling some absurdly long expressions like "+0"*1000000. RecursionError is now raised instead. Patch by Pablo Galindo

  • gh-93351: ast.AST node positions are now validated when provided to compile() and other related functions. If invalid positions are detected, a ValueError will be raised.

  • gh-94438: Fix an issue that caused extended opcode arguments and some conditional pops to be ignored when calculating valid jump targets for assignments to the f_lineno attribute of frame objects. In some cases, this could cause inconsistent internal state, resulting in a hard crash of the interpreter.

  • gh-95060: Undocumented PyCode_Addr2Location function now properly returns when addrq argument is less than zero.

  • gh-95113: Replace all EXTENDED_ARG_QUICK instructions with basic EXTENDED_ARG instructions in unquickened code. Consumers of non-adaptive bytecode should be able to handle extended arguments the same way they were handled in CPython 3.10 and older.

  • gh-91409: Fix incorrect source location info caused by certain optimizations in the bytecode compiler.

  • gh-95023: Implement os.setns() and os.unshare() for Linux. Patch by Noam Cohen.

  • gh-94036: Fix incorrect source location info for some multi-line attribute accesses and method calls.

  • gh-94938: Fix error detection in some builtin functions when keyword argument name is an instance of a str subclass with overloaded __eq__ and __hash__. Previously it could cause SystemError or other undesired behavior.

  • gh-94996: ast.parse() will no longer parse function definitions with positional-only params when passed feature_version less than (3, 8). Patch by Shantanu Jain.

  • gh-94739: Allow jumping within, out of, and across exception handlers in the debugger.

  • gh-94949: ast.parse() will no longer parse parenthesized context managers when passed feature_version less than (3, 9). Patch by Shantanu Jain.

  • gh-94947: ast.parse() will no longer parse assignment expressions when passed feature_version less than (3, 8). Patch by Shantanu Jain.

  • gh-91256: Ensures the program name is known for help text during interpreter startup.

  • gh-94869: Fix the column offsets for some expressions in multi-line f-strings ast nodes. Patch by Pablo Galindo.

  • gh-94893: Fix an issue where frame object manipulations could corrupt inline bytecode caches.

  • gh-94822: Fix an issue where lookups of metaclass descriptors may be ignored when an identically-named attribute also exists on the class itself.

  • gh-91153: Fix an issue where a bytearray item assignment could crash if it’s resized by the new value’s __index__() method.

  • gh-90699: Fix reference counting bug in bool.__repr__(). Patch by Kumar Aditya.

  • gh-94694: Fix an issue that could cause code with multi-line method lookups to have misleading or incorrect column offset information. In some cases (when compiling a hand-built AST) this could have resulted in a hard crash of the interpreter.

  • gh-93252: Fix an issue that caused internal frames to outlive failed Python function calls, possibly resulting in memory leaks or hard interpreter crashes.

  • gh-94215: Fix an issue where exceptions raised by line-tracing events would cause frames to be left in an invalid state, possibly resulting in a hard crash of the interpreter.

  • gh-92228: Disable the compiler’s inline-small-exit-blocks optimization for exit blocks that are associated with source code lines. This fixes a bug where the debugger cannot tell where an exception handler ends and the following code block begins.

  • gh-94485: Line number of a module’s RESUME instruction is set to 0 as specified in PEP 626.

  • gh-94438: Account for instructions that can push NULL to the stack when setting line number in a frame. Prevents some (unlikely) crashes.

  • gh-91719: Reload opcode when raising unknown opcode error in the interpreter main loop, for C compilers to generate dispatching code independently.

  • gh-94329: Compile and run code with unpacking of extremely large sequences (1000s of elements). Such code failed to compile. It now compiles and runs correctly.

  • gh-94360: Fixed a tokenizer crash when reading encoded files with syntax errors from stdin with non utf-8 encoded text. Patch by Pablo Galindo

  • gh-88116: Fix an issue when reading line numbers from code objects if the encoded line numbers are close to INT_MIN. Patch by Pablo Galindo

  • gh-94262: Don’t create frame objects for incomplete frames. Prevents the creation of generators and closures from being observable to Python and C extensions, restoring the behavior of 3.10 and earlier.

  • gh-94192: Fix error for dictionary literals with invalid expression as value.

  • gh-87995: types.MappingProxyType instances are now hashable if the underlying mapping is hashable.

  • gh-93883: Revise the display strategy of traceback enhanced error locations. The indicators are only shown when the location doesn’t span the whole line.

  • gh-94163: Add BINARY_SLICE and STORE_SLICE instructions for more efficient handling and better specialization of slicing operations, where the slice is explicit in the source code.

  • gh-94021: Fix unreachable code warning in Python/specialize.c.

  • gh-93911: Specialize LOAD_ATTR for objects with custom __getattribute__.

  • gh-93955: Improve performance of attribute lookups on objects with custom __getattribute__ and __getattr__. Patch by Ken Jin.

  • gh-93911: Specialize LOAD_ATTR for property() attributes.

  • gh-93678: Refactor compiler optimisation code so that it no longer needs the struct assembler and struct compiler passed around. Instead, each function takes the CFG and other data that it actually needs. This will make it possible to test this code directly.

  • gh-93841: When built with -enable-pystats, sys._stats_on(), sys._stats_off(), sys._stats_clear() and sys._stats_dump() functions have been added to enable gathering stats for parts of programs.

  • gh-93516: Store offset of first traceable instruction in code object to avoid having to recompute it for each instruction when tracing.

  • gh-93516: Lazily create a table mapping bytecode offsets to line numbers to speed up calculation of line numbers when tracing.

  • gh-89828: types.GenericAlias no longer relays the __class__ attribute. For example, isinstance(list[int], type) no longer returns True.

  • gh-93678: Refactor the compiler to reduce boilerplate and repetition.

  • gh-93671: Fix some exponential backtrace case happening with deeply nested sequence patterns in match statements. Patch by Pablo Galindo

  • gh-93662: Make sure that the end column offsets are correct in multi-line method calls. Previously, the end column could precede the column offset.

  • gh-93461: importlib.invalidate_caches() now drops entries from sys.path_importer_cache with a relative path as name. This solves a caching issue when a process changes its current working directory.

    FileFinder no longer inserts a dot in the path, e.g. /egg/./spam is now /egg/spam.

  • gh-93621: Change order of bytecode instructions emitted for with and async with to reduce the number of entries in the exception table.

  • gh-93533: Reduce the size of the inline cache for LOAD_METHOD by 2 bytes.

  • gh-93444: Removed redundant fields from the compiler’s basicblock struct: b_nofallthrough, b_exit, b_return. They can be easily calculated from the opcode of the last instruction of the block.

  • gh-93429: LOAD_METHOD instruction has been removed. It was merged back into LOAD_ATTR.

  • gh-93418: Fixed an assert where an f-string has an equal sign “=” following an expression, but there’s no trailing brace. For example, f»{i=».

  • gh-93382: Cache the result of PyCode_GetCode() function to restore the O(1) lookup of the co_code attribute.

  • gh-93359: Ensure that custom ast nodes without explicit end positions can be compiled. Patch by Pablo Galindo.

  • gh-93356: Code for exception handlers is emitted at the end of the code unit’s bytecode. This avoids one jump when no exception is raised.

  • gh-93354: Use exponential backoff for specialization counters in the interpreter. Can reduce the number of failed specializations significantly and avoid slowdown for those parts of a program that are not suitable for specialization.

  • gh-93283: Improve error message for invalid syntax of conversion character in f-string expressions.

  • gh-93345: Fix a crash in substitution of a TypeVar in nested generic alias after TypeVarTuple.

  • gh-93223: When a bytecode instruction jumps to an unconditional jump instruction, the first instruction can often be optimized to target the unconditional jump’s target directly. For tracing reasons, this would previously only occur if both instructions have the same line number. This also now occurs if the unconditional jump is artificial, i.e., if it has no associated line number.

  • gh-84694: The --experimental-isolated-subinterpreters configure option and EXPERIMENTAL_ISOLATED_SUBINTERPRETERS macro have been removed.

  • gh-91924: Fix __lltrace__ debug feature if the stdout encoding is not UTF-8. Patch by Victor Stinner.

  • gh-93040: Wraps unused parameters in Objects/obmalloc.c with Py_UNUSED.

  • gh-93143: Avoid NULL checks for uninitialized local variables by determining at compile time which variables must be initialized.

  • gh-93061: Backward jumps after async for loops are no longer given dubious line numbers.

  • gh-93065: Fix contextvars HAMT implementation to handle iteration over deep trees.

    The bug was discovered and fixed by Eli Libman. See MagicStack/immutables#84 for more details.

  • gh-93012: Added the new function PyType_FromMetaclass(), which generalizes the existing PyType_FromModuleAndSpec() using an additional metaclass argument. This is useful for language binding tools, where it can be used to intercept type-related operations like subclassing or static attribute access by specifying a metaclass with custom slots.

    Importantly, PyType_FromMetaclass() is available in the Limited API, which provides a path towards migrating more binding tools onto the Stable ABI.

  • gh-93021: Fix the __text_signature__ for __get__() methods implemented in C. Patch by Jelle Zijlstra.

  • gh-89914: The operand of the YIELD_VALUE instruction is set to the stack depth. This is done to help frame handling on yield and may assist debuggers.

  • gh-92955: Fix memory leak in code object’s lines and positions iterators as they were not finalized at exit. Patch by Kumar Aditya.

  • gh-92930: Fixed a crash in _pickle.c from mutating collections during __reduce__ or persistent_id.

  • gh-90690: The PRECALL instruction has been removed. It offered only a small advantage for specialization and is not needed in the vast majority of cases.

  • gh-92914: Always round the allocated size for lists up to the nearest even number.

  • gh-92858: Improve error message for some suites with syntax error before “:”

  • gh-90473: Decrease default recursion limit on WASI to address limited call stack size.

  • gh-92804: Fix memory leak in memoryview iterator as it was not finalized at exit. Patch by Kumar Aditya.

  • gh-92777: Specialize LOAD_METHOD for objects with lazy dictionaries. Patch by Ken Jin.

  • gh-92658: Add support for connecting and binding to Hyper-V sockets on Windows Hyper-V hosts and guests.

  • gh-92236: Remove spurious «LINE» event when starting a generator or coroutine, visible tracing functions implemented in C.

  • gh-91102: _warnings.warn_explicit() is ported to Argument Clinic.

  • gh-92619: Make the compiler duplicate an exit block only if none of its instructions have a lineno (previously only the first instruction in the block was checked, leading to unnecessarily duplicated blocks).

  • gh-88750: The deprecated debug build only PYTHONTHREADDEBUG environment variable no longer does anything.

  • gh-92261: Fix hang when trying to iterate over a typing.Union.

  • gh-91432: Specialized the FOR_ITER opcode using the PEP 659 machinery

  • gh-91399: Removed duplicate “{0, 0, 0, 0, 0, 0}” entry in “Objects/unicodetype_db.h”.

  • gh-91578: Updates the error message for abstract class.

  • bpo-47091: Improve performance of repetition of list and tuple by using memcpy to copy data and performing the reference increments in one step.

  • bpo-46142: Make --help output shorter by moving some info to the new --help-env and --help-xoptions command-line options. Also add --help-all option to print complete usage.

  • bpo-42316: Document some places where an assignment expression needs parentheses.

Library

  • gh-89237: Fix hang on Windows in subprocess.wait_closed() in asyncio with ProactorEventLoop. Patch by Kumar Aditya.

  • gh-97928: tkinter.Text.count() raises now an exception for options starting with «-» instead of silently ignoring them.

  • gh-98393: The os module no longer accepts bytes-like paths, like bytearray and memoryview types: only the exact bytes type is accepted for bytes strings. Patch by Victor Stinner.

  • gh-98363: Added itertools.batched() to batch data into lists of a given length with the last list possibly being shorter than the others.

  • gh-98331: Update the bundled copies of pip and setuptools to versions 22.3 and 65.5.0 respectively.

  • gh-98307: A createSocket() method was added to SysLogHandler.

  • gh-96035: Fix bug in urllib.parse.urlparse() that causes certain port numbers containing whitespace, underscores, plus and minus signs, or non-ASCII digits to be incorrectly accepted.

  • gh-98257: Make sys.setprofile() and sys.settrace() functions reentrant. They can no long fail with: RuntimeError("Cannot install a trace function while another trace function is being installed"). Patch by Victor Stinner.

  • gh-98251: Allow venv to pass along PYTHON* variables to ensurepip and pip when they do not impact path resolution

  • gh-94597: Deprecated asyncio.AbstractEventLoopPolicy.get_child_watcher() and asyncio.AbstractEventLoopPolicy.set_child_watcher() methods to be removed in Python 3.14. Patch by Kumar Aditya.

  • gh-98178: On macOS, fix a crash in syslog.syslog() in multi-threaded applications. On macOS, the libc syslog() function is not thread-safe, so syslog.syslog() no longer releases the GIL to call it. Patch by Victor Stinner.

  • gh-44098: Release the GIL when creating mmap.mmap objects on Unix.

  • gh-87730: Wrap network errors consistently in urllib FTP support, so the test suite doesn’t fail when a network is available but the public internet is not reachable.

  • gh-94597: The child watcher classes MultiLoopChildWatcher, FastChildWatcher and SafeChildWatcher are deprecated and will be removed in Python 3.14. Patch by Kumar Aditya.

  • gh-98023: Change default child watcher to PidfdChildWatcher on Linux systems which supports it. Patch by Kumar Aditya.

  • gh-90985: Earlier in 3.11 we deprecated asyncio.Task.cancel("message"). We realized we were too harsh, and have undeprecated it.

  • gh-65961: Do not rely solely on __cached__ on modules; code will also support __spec__.cached.

  • gh-97646: Replace deprecated application/javascript with text/javascript in mimetypes. See RFC 9239. Patch by Noam Cohen.

  • gh-97930: Apply changes from importlib_resources 5.8 and 5.9: Traversable.joinpath provides a concrete implementation. as_file now supports directories of resources.

  • gh-97850: Remove deprecated importlib.util.set_loader() and importlib.util.module_for_loader() from importlib.util.

  • gh-97837: Change deprecate warning message in unittest from

    It is deprecated to return a value!=None

    to

    It is deprecated to return a value that is not None from a test case

  • gh-97825: Fixes AttributeError when subprocess.check_output() is used with argument input=None and either of the arguments encoding or errors are used.

  • gh-97008: NameError and AttributeError spelling suggestions provided since gh-82711 are now also emitted by the pure Python traceback module. Tests for those suggestions now exercise both implementations to ensure they are equivalent. Patch by Carl Friedrich Bolz-Tereick and Łukasz Langa.

  • gh-97799: dataclass now uses inspect.get_annotations() to examine the annotations on class objects.

  • gh-97781: Removed deprecated interfaces in importlib.metadata (entry points accessed as dictionary, implicit dictionary construction of sequence of EntryPoint objects, mutablility of EntryPoints result, access of entry point by index). entry_points now has a simpler, more straightforward API (returning EntryPoints).

  • gh-96827: Avoid spurious tracebacks from asyncio when default executor cleanup is delayed until after the event loop is closed (e.g. as the result of a keyboard interrupt).

  • gh-95534: gzip.GzipFile.read() reads 10% faster.

  • gh-97592: Avoid a crash in the C version of asyncio.Future.remove_done_callback() when an evil argument is passed.

  • gh-97639: Remove tokenize.NL check from tabnanny.

  • gh-97545: Make Semaphore run faster.

  • gh-73588: Fix generation of the default name of tkinter.Checkbutton. Previously, checkbuttons in different parent widgets could have the same short name and share the same state if arguments «name» and «variable» are not specified. Now they are globally unique.

  • gh-96865: fix Flag to use boundary CONFORM

    This restores previous Flag behavior of allowing flags with non-sequential values to be combined; e.g.

    class Skip(Flag): TWO = 2 EIGHT = 8

    Skip.TWO | Skip.EIGHT -> <Skip.TWO|EIGHT: 10>

  • gh-97005: Update bundled libexpat to 2.4.9

  • gh-85760: Fix race condition in asyncio where process_exited() called before the pipe_data_received() leading to inconsistent output. Patch by Kumar Aditya.

  • gh-96704: Pass the correct contextvars.Context when a asyncio exception handler is called on behalf of a task or callback handle. This adds a new Task method, get_context, and also a new Handle method with the same name. If this method is not found on a task object (perhaps because it is a third-party library that does not yet provide this method), the context prevailing at the time the exception handler is called is used.

  • gh-96819: Fixed check in multiprocessing.resource_tracker that guarantees that the length of a write to a pipe is not greater than PIPE_BUF.

  • gh-95865: Reduce urllib.parse.quote_from_bytes() memory use on large values.

    Contributed by Dennis Sweeney.

  • gh-96741: Corrected type annotation for dataclass attribute pstats.FunctionProfile.ncalls to be str.

  • gh-96734: Update unicodedata database to Unicode 15.0.0.

  • gh-96735: Fix undefined behaviour in struct.unpack().

  • gh-46412: Improve performance of bool(db) for large ndb/gdb databases. Previously this would call len(db) which would iterate over all keys – the answer (empty or not) is known after the first key.

  • gh-96652: Fix the faulthandler implementation of faulthandler.register(signal, chain=True) if the sigaction() function is not available: don’t call the previous signal handler if it’s NULL. Patch by Victor Stinner.

  • gh-68163: Correct conversion of numbers.Rational’s to float.

  • gh-96538: Speed up bisect.bisect() functions by taking advantage of type-stability.

  • gh-96465: Fraction hashes are now cached.

  • gh-96079: In typing, fix missing field name and incorrect __module__ in _AnnotatedAlias.

  • gh-96415: Remove types._cell_factory from module namespace.

  • gh-95987: Fix repr of Any subclasses.

  • gh-96388: Work around missing socket functions in socket’s __repr__.

  • gh-96385: Fix TypeVarTuple.__typing_prepare_subst__. TypeError was not raised when using more than one TypeVarTuple, like [*T, *V] in type alias substitutions.

  • gh-96142: Add match_args, kw_only, slots, and weakref_slot to _DataclassParams.

  • gh-96073: In inspect, fix overeager replacement of «typing.» in formatting annotations.

  • gh-89258: Added a getChildren() method to logging.Logger, to get the immediate child loggers of a logger.

  • gh-96346: Use double caching for compiled RE patterns.

  • gh-96349: Fixed a minor performance regression in threading.Event.__init__()

  • gh-90467: Fix asyncio.streams.StreamReaderProtocol to keep a strong reference to the created task, so that it’s not garbage collected

  • gh-96172: Fix a bug in unicodedata: east_asian_width used to return the wrong value for unassigned characters; and for yet unassigned, but reserved characters.

  • gh-96159: Fix a performance regression in logging TimedRotatingFileHandler. Only check for special files when the rollover time has passed.

  • gh-96175: Fix unused localName parameter in the Attr class in xml.dom.minidom.

  • gh-96145: Add AttrDict to JSON module for use with object_hook.

  • gh-96052: Fix handling compiler warnings (SyntaxWarning and DeprecationWarning) in codeop.compile_command() when checking for incomplete input. Previously it emitted warnings and raised a SyntaxError. Now it always returns None for incomplete input without emitting any warnings.

  • gh-96125: Fix incorrect condition that causes sys.thread_info.name to be wrong on pthread platforms.

  • gh-96019: Fix a bug in the makeunicodedata.py script leading to about 13 KiB of space saving in the unicodedata module, specifically the character decomposition data.

  • gh-95463: Remove an incompatible change from bpo-28080 that caused a regression that ignored the utf8 in ZipInfo.flag_bits. Patch by Pablo Galindo.

  • gh-69142: Add %:z strftime format code (generates tzoffset with colons as separator), see strftime() and strptime() Behavior.

  • gh-95899: Fix asyncio.Runner to call asyncio.set_event_loop() only once to avoid calling attach_loop() multiple times on child watchers. Patch by Kumar Aditya.

  • gh-95736: Fix unittest.IsolatedAsyncioTestCase to set event loop before calling setup functions. Patch by Kumar Aditya.

  • gh-95865: Speed up urllib.parse.quote_from_bytes() by replacing a list comprehension with map().

  • gh-95861: Add support for computing Spearman’s correlation coefficient to the existing statistics.correlation() function.

  • gh-95804: Fix logging shutdown handler so it respects MemoryHandler.flushOnClose.

  • gh-95704: When a task catches asyncio.CancelledError and raises some other error, the other error should generally not silently be suppressed.

  • gh-95149: The HTTPStatus enum offers a couple of properties to indicate the HTTP status category e.g. HTTPStatus.OK.is_success.

  • gh-95609: Update bundled pip to 22.2.2.

  • gh-95289: Fix asyncio.TaskGroup to propagate exception when asyncio.CancelledError was replaced with another exception by a context manager. Patch by Kumar Aditya and Guido van Rossum.

  • gh-94909: Fix incorrect joining of relative Windows paths with drives in pathlib.PurePath initializer.

  • gh-95385: Faster json.dumps() when sorting of keys is not requested (default).

  • gh-83901: Improve Signature.bind error message for missing keyword-only arguments.

  • gh-95339: Update bundled pip to 22.2.1.

  • gh-95045: Fix GC crash when deallocating _lsprof.Profiler by untracking it before calling any callbacks. Patch by Kumar Aditya.

  • gh-95231: Fail gracefully if EPERM or ENOSYS is raised when loading crypt methods. This may happen when trying to load MD5 on a Linux kernel with FIPS enabled.

  • gh-95097: Fix asyncio.run() for asyncio.Task implementations without uncancel() method. Patch by Kumar Aditya.

  • gh-95087: Fix IndexError in parsing invalid date in the email module.

  • gh-95199: Upgrade bundled setuptools to 63.2.0.

  • gh-95194: Upgrade bundled pip to 22.2.

  • gh-93899: Fix check for existence of os.EFD_CLOEXEC, os.EFD_NONBLOCK and os.EFD_SEMAPHORE flags on older kernel versions where these flags are not present. Patch by Kumar Aditya.

  • gh-95166: Fix concurrent.futures.Executor.map() to cancel the currently waiting on future on an error - e.g. TimeoutError or KeyboardInterrupt.

  • gh-95132: Fix a sqlite3 regression where *args and **kwds were incorrectly relayed from connect() to the Connection factory. The regression was introduced in 3.11a1 with PR 24421 (gh-85128). Patch by Erlend E. Aasland.

  • gh-93157: Fix fileinput module didn’t support errors option when inplace is true.

  • gh-91212: Fixed flickering of the turtle window when the tracer is turned off. Patch by Shin-myoung-serp.

  • gh-95077: Add deprecation warning for enum member.member access (e.g. Color.RED.BLUE). Remove EnumMeta.__getattr__.

  • gh-95109: Ensure that timeouts scheduled with asyncio.Timeout that have already expired are delivered promptly.

  • gh-95105: wsgiref.types.InputStream.__iter__() should return Iterator[bytes], not Iterable[bytes]. Patch by Shantanu Jain.

  • gh-95066: Replaced assert with exception in ast.parse(), when feature_version has an invalid major version. Patch by Shantanu Jain.

  • gh-77617: Add sqlite3 command-line interface. Patch by Erlend Aasland.

  • gh-95005: Replace _PyAccu with _PyUnicodeWriter in JSON encoder and StringIO and remove the _PyAccu implementation.

  • gh-90085: Remove -c/--clock and -t/--time CLI options of timeit. The options had been deprecated since Python 3.3 and the functionality was removed in Python 3.7. Patch by Shantanu Jain.

  • gh-94857: Fix refleak in _io.TextIOWrapper.reconfigure. Patch by Kumar Aditya.

  • gh-94821: Fix binding of unix socket to empty address on Linux to use an available address from the abstract namespace, instead of «0».

  • gh-94736: Fix crash when deallocating an instance of a subclass of _multiprocessing.SemLock. Patch by Kumar Aditya.

  • gh-81620: Add random.binomialvariate().

  • gh-74116: Allow asyncio.StreamWriter.drain() to be awaited concurrently by multiple tasks. Patch by Kumar Aditya.

  • gh-87822: When called with capture_locals=True, the traceback module functions swallow exceptions raised from calls to repr() on local variables of frames. This is in order to prioritize the original exception over rendering errors. An indication of the failure is printed in place of the missing value. (Patch by Simon-Martin Schroeder).

  • gh-88050: Fix asyncio subprocess transport to kill process cleanly when process is blocked and avoid RuntimeError when loop is closed. Patch by Kumar Aditya.

  • gh-94637: SSLContext.set_default_verify_paths() now releases the GIL around SSL_CTX_set_default_verify_paths call. The function call performs I/O and CPU intensive work.

  • gh-94309: Deprecate aliases typing.Hashable and typing.Sized

  • gh-92546: An undocumented python -m pprint benchmark is moved into pprint suite of pyperformance. Patch by Oleg Iarygin.

  • gh-94607: Fix subclassing complex generics with type variables in typing. Previously an error message saying Some type variables ... are not listed in Generic[...] was shown. typing no longer populates __parameters__ with the __parameters__ of a Python class.

  • gh-94619: Remove the long-deprecated module_repr() from importlib.

  • gh-93910: The ability to access the other values of an enum on an enum (e.g. Color.RED.BLUE) has been restored in order to fix a performance regression.

  • gh-93896: Fix asyncio.run() and unittest.IsolatedAsyncioTestCase to always the set event loop as it was done in Python 3.10 and earlier. Patch by Kumar Aditya.

  • gh-94343: Allow setting the attributes of reprlib.Repr during object initialization

  • gh-94382: Port static types of _multiprocessing module to heap types. Patch by Kumar Aditya.

  • gh-78724: Fix crash in struct.Struct when it was not completely initialized by initializing it in __new__(). Patch by Kumar Aditya.

  • gh-94510: Re-entrant calls to sys.setprofile() and sys.settrace() now raise RuntimeError. Patch by Pablo Galindo.

  • gh-92336: Fix bug where linecache.getline() fails on bad files with UnicodeDecodeError or SyntaxError. It now returns an empty string as per the documentation.

  • gh-94398: Once a asyncio.TaskGroup has started shutting down (i.e., at least one task has failed and the task group has started cancelling the remaining tasks), it should not be possible to add new tasks to the task group.

  • gh-94383: xml.etree: Remove the ElementTree.Element.copy() method of the pure Python implementation, deprecated in Python 3.10, use the copy.copy() function instead. The C implementation of xml.etree has no copy() method, only a __copy__() method. Patch by Victor Stinner.

  • gh-94379: zipimport: Remove find_loader() and find_module() methods, deprecated in Python 3.10: use the find_spec() method instead. See PEP 451 for the rationale. Patch by Victor Stinner.

  • gh-94352: shlex.split(): Passing None for s argument now raises an exception, rather than reading sys.stdin. The feature was deprecated in Python 3.9. Patch by Victor Stinner.

  • gh-94318: Strip trailing spaces in pydoc text output.

  • gh-89988: Fix memory leak in pickle.Pickler when looking up dispatch_table. Patch by Kumar Aditya.

  • gh-90016: Deprecate sqlite3 default adapters and converters. Patch by Erlend E. Aasland.

  • gh-94254: Fixed types of struct module to be immutable. Patch by Kumar Aditya.

  • gh-93259: Now raise ValueError when None or an empty string are passed to Distribution.from_name (and other callers).

  • gh-74696: shutil.make_archive() now passes the root_dir argument to custom archivers which support it.

  • gh-94216: The dis module now has the opcodes for pseudo instructions (those which are used by the compiler during code generation but then removed or replaced by real opcodes before the final bytecode is emitted).

  • gh-93096: Removed undocumented python -m codecs. Use python -m unittest test.test_codecs.EncodedFileTest instead.

  • gh-94207: Made _struct.Struct GC-tracked in order to fix a reference leak in the _struct module.

  • gh-93096: Removed undocumented -t argument of python -m base64. Use python -m unittest test.test_base64.LegacyBase64TestCase.test_encodebytes instead.

  • gh-94226: Remove the locale.format() function, deprecated in Python 3.7: use locale.format_string() instead. Patch by Victor Stinner.

  • gh-94199: Remove the ssl.match_hostname() function. The ssl.match_hostname() was deprecated in Python 3.7. OpenSSL performs hostname matching since Python 3.7, Python no longer uses the ssl.match_hostname() function. Patch by Victor Stinner.

  • gh-94214: Document the context object used in the venv.EnvBuilder class, and add the new environment’s library path to it.

  • gh-94199: Remove the ssl.wrap_socket() function, deprecated in Python 3.7: instead, create a ssl.SSLContext object and call its ssl.SSLContext.wrap_socket method. Any package that still uses ssl.wrap_socket() is broken and insecure. The function neither sends a SNI TLS extension nor validates server hostname. Code is subject to CWE 295 Improper Certificate Validation. Patch by Victor Stinner.

  • gh-94199: Remove the ssl.RAND_pseudo_bytes() function, deprecated in Python 3.6: use os.urandom() or ssl.RAND_bytes() instead. Patch by Victor Stinner.

  • gh-94199: hashlib: Remove the pure Python implementation of hashlib.pbkdf2_hmac(), deprecated in Python 3.10. Python 3.10 and newer requires OpenSSL 1.1.1 (PEP 644): this OpenSSL version provides a C implementation of pbkdf2_hmac() which is faster. Patch by Victor Stinner.

  • gh-94196: gzip: Remove the filename attribute of gzip.GzipFile, deprecated since Python 2.6, use the name attribute instead. In write mode, the filename attribute added '.gz' file extension if it was not present. Patch by Victor Stinner.

  • gh-94182: run the asyncio.PidfdChildWatcher on the running loop, this allows event loops to run subprocesses when there is no default event loop running on the main thread

  • gh-94169: Remove io.OpenWrapper and _pyio.OpenWrapper, deprecated in Python 3.10: just use open() instead. The open() (io.open()) function is a built-in function. Since Python 3.10, _pyio.open() is also a static method. Patch by Victor Stinner.

  • gh-91742: Fix pdb crash after jump caused by a null pointer dereference. Patch by Kumar Aditya.

  • gh-94101: Manual instantiation of ssl.SSLSession objects is no longer allowed as it lead to misconfigured instances that crashed the interpreter when attributes where accessed on them.

  • gh-84753: inspect.iscoroutinefunction(), inspect.isgeneratorfunction(), and inspect.isasyncgenfunction() now properly return True for duck-typed function-like objects like instances of unittest.mock.AsyncMock.

    This makes inspect.iscoroutinefunction() consistent with the behavior of asyncio.iscoroutinefunction(). Patch by Mehdi ABAAKOUK.

  • gh-94028: Fix a regression in the sqlite3 where statement objects were not properly cleared and reset after use in cursor iters. The regression was introduced by PR 27884 in Python 3.11a1. Patch by Erlend E. Aasland.

  • gh-93973: Add keyword argument all_errors to asyncio.create_connection so that multiple connection errors can be raised as an ExceptionGroup.

  • gh-93963: Officially deprecate from importlib.abc classes moved to importlib.resources.abc.

  • gh-93858: Prevent error when activating venv in nested fish instances.

  • gh-93820: Pickle enum.Flag by name.

  • gh-93847: Fix repr of enum of generic aliases.

  • gh-91404: Revert the re memory leak when a match is terminated by a signal or memory allocation failure as the implemented fix caused a major performance regression.

  • gh-83499: Fix double closing of file description in tempfile.

  • gh-93820: Fixed a regression when copy.copy()-ing enum.Flag with multiple flag members.

  • gh-79512: Fixed names and __module__ value of weakref classes ReferenceType, ProxyType, CallableProxyType. It makes them pickleable.

  • gh-91389: Fix an issue where dis utilities could report missing or incorrect position information in the presence of CACHE entries.

  • gh-93626: Set __future__.annotations to have a None mandatoryRelease to indicate that it is currently “TBD”.

  • gh-90473: Emscripten and WASI have no home directory and cannot provide PEP 370 user site directory.

  • gh-90494: copy.copy() and copy.deepcopy() now always raise a TypeError if __reduce__() returns a tuple with length 6 instead of silently ignore the 6th item or produce incorrect result.

  • gh-90549: Fix a multiprocessing bug where a global named resource (such as a semaphore) could leak when a child process is spawned (as opposed to forked).

  • gh-93521: Fixed a case where dataclasses would try to add __weakref__ into the __slots__ for a dataclass that specified weakref_slot=True when it was already defined in one of its bases. This resulted in a TypeError upon the new class being created.

  • gh-79579: sqlite3 now correctly detects DML queries with leading comments. Patch by Erlend E. Aasland.

  • gh-93421: Update sqlite3.Cursor.rowcount when a DML statement has run to completion. This fixes the row count for SQL queries like UPDATE ... RETURNING. Patch by Erlend E. Aasland.

  • gh-93475: Expose FICLONE and FICLONERANGE constants in fcntl. Patch by Illia Volochii.

  • gh-93370: Deprecate version and version_info.

  • gh-91810: Suppress writing an XML declaration in open files in ElementTree.write() with encoding='unicode' and xml_declaration=None.

  • gh-91162: Support splitting of unpacked arbitrary-length tuple over TypeVar and TypeVarTuple parameters. For example:

    • A[T, *Ts][*tuple[int, ...]] -> A[int, *tuple[int, ...]]

    • A[*Ts, T][*tuple[int, ...]] -> A[*tuple[int, ...], int]

  • gh-93353: Fix the importlib.resources.as_file() context manager to remove the temporary file if destroyed late during Python finalization: keep a local reference to the os.remove() function. Patch by Victor Stinner.

  • gh-83658: Make multiprocessing.Pool raise an exception if maxtasksperchild is not None or a positive int.

  • gh-93312: Add os.PIDFD_NONBLOCK flag to open a file descriptor for a process with os.pidfd_open() in non-blocking mode. Patch by Kumar Aditya.

  • gh-88123: Implement Enum.__contains__ that returns True or False to replace the deprecated behaviour that would sometimes raise a TypeError.

  • gh-93297: Make asyncio task groups prevent child tasks from being GCed

  • gh-85308: Changed argparse.ArgumentParser to use filesystem encoding and error handler instead of default text encoding to read arguments from file (e.g. fromfile_prefix_chars option). This change affects Windows; argument file should be encoded with UTF-8 instead of ANSI Codepage.

  • gh-93156: Accessing the pathlib.PurePath.parents sequence of an absolute path using negative index values produced incorrect results.

  • gh-93162: Add the ability for logging.config.dictConfig() to usefully configure QueueHandler and QueueListener as a pair, and add logging.getHandlerByName() and logging.getHandlerNames() APIs to allow access to handlers by name.

  • gh-93243: The smtpd module was removed per the schedule in PEP 594.

  • gh-92886: Replace assert statements with raise AssertionError() in BaseHandler so that the tested behaviour is maintained running with optimizations (-O).

  • gh-90155: Fix broken asyncio.Semaphore when acquire is cancelled.

  • gh-90817: The locale.resetlocale() function is deprecated and will be removed in Python 3.13. Use locale.setlocale(locale.LC_ALL, "") instead. Patch by Victor Stinner.

  • gh-91513: Added taskName attribute to logging module for use with asyncio tasks.

  • gh-74696: shutil.make_archive() no longer temporarily changes the current working directory during creation of standard .zip or tar archives.

  • gh-92728: The re.template() function and the corresponding re.TEMPLATE and re.T flags are restored after they were removed in 3.11.0b1, but they are now deprecated, so they might be removed from Python 3.13.

  • gh-93033: Search in some strings (platform dependent i.e [U+0xFFFF, U+0x0100] on Windows or [U+0xFFFFFFFF, U+0x00010000] on Linux 64-bit) are now up to 10 times faster.

  • gh-89973: Fix re.error raised in fnmatch if the pattern contains a character range with upper bound lower than lower bound (e.g. [c-a]). Now such ranges are interpreted as empty ranges.

  • gh-93044: No longer convert the database argument of sqlite3.connect() to bytes before passing it to the factory.

  • gh-93010: In a very special case, the email package tried to append the nonexistent InvalidHeaderError to the defect list. It should have been InvalidHeaderDefect.

  • gh-92986: Fix ast.unparse() when ImportFrom.level is None

  • gh-92932: Now dis() and get_instructions() handle operand values for instructions prefixed by EXTENDED_ARG_QUICK. Patch by Sam Gross and Donghee Na.

  • gh-92675: Fix venv.ensure_directories() to accept pathlib.Path arguments in addition to str paths. Patch by David Foster.

  • gh-87901: Removed the encoding argument from os.popen() that was added in 3.11b1.

  • gh-91922: Fix function sqlite.connect() and the sqlite.Connection constructor on non-UTF-8 locales. Also, they now support bytes paths non-decodable with the current FS encoding.

  • gh-92869: Added c_time_t to ctypes, which has the same size as the time_t type in C.

  • gh-92839: Fixed crash resulting from calling bisect.insort() or bisect.insort_left() with the key argument not equal to None.

  • gh-90473: subprocess now fails early on Emscripten and WASI platforms to work around missing os.pipe() on WASI.

  • gh-89325: Removed many old deprecated unittest features: TestCase method aliases, undocumented and broken TestCase method assertDictContainsSubset, undocumented TestLoader.loadTestsFromModule parameter use_load_tests, and an underscored alias of the TextTestResult class.

  • gh-92734: Allow multi-element reprs emitted by reprlib to be pretty-printed using configurable indentation.

  • gh-92671: Fixed ast.unparse() for empty tuples in the assignment target context.

  • gh-91581: utcfromtimestamp() no longer attempts to resolve fold in the pure Python implementation, since the fold is never 1 in UTC. In addition to being slightly faster in the common case, this also prevents some errors when the timestamp is close to datetime.min. Patch by Paul Ganssle.

  • gh-86388: Removed randrange() functionality deprecated since Python 3.10. Formerly, randrange(10.0) losslessly converted to randrange(10). Now, it raises a TypeError. Also, the exception raised for non-integral values such as randrange(10.5) or randrange(“10”) has been changed from ValueError to TypeError.

  • gh-90385: Add pathlib.Path.walk() as an alternative to os.walk().

  • gh-92550: Fix pathlib.Path.rglob() for empty pattern.

  • gh-92591: Allow logging filters to return a logging.LogRecord instance so that filters attached to logging.Handlers can enrich records without side effects on other handlers.

  • gh-92445: Fix a bug in argparse where nargs="*" would raise an error instead of returning an empty list when 0 arguments were supplied if choice was also defined in parser.add_argument.

  • gh-92547: Remove undocumented sqlite3 features deprecated in Python 3.10:

    • sqlite3.enable_shared_cache()

    • sqlite3.OptimizedUnicode

    Patch by Erlend E. Aasland.

  • gh-92530: Fix an issue that occurred after interrupting threading.Condition.notify().

  • gh-92531: The statistics.median_grouped() function now always return a float. Formerly, it did not convert the input type when for sequences of length one.

  • gh-84131: The pathlib.Path deprecated method link_to has been removed. Use 3.10’s hardlink_to() method instead as its semantics are consistent with that of symlink_to().

  • gh-89336: Removed configparser module APIs: the SafeConfigParser class alias, the ParsingError.filename property and parameter, and the ConfigParser.readfp method, all of which were deprecated since Python 3.2.

  • gh-92391: Add __class_getitem__() to csv.DictReader and csv.DictWriter, allowing them to be parameterized at runtime. Patch by Marc Mueller.

  • gh-91968: Add SO_RTABLE and SO_USER_COOKIE constants to socket.

  • gh-91810: ElementTree method write() and function tostring() now use the text file’s encoding («UTF-8» if not available) instead of locale encoding in XML declaration when encoding="unicode" is specified.

  • gh-81790: os.path.splitdrive() now understands DOS device paths with UNC links (beginning \\?\UNC\). Contributed by Barney Gale.

  • gh-91760: Apply more strict rules for numerical group references and group names in regular expressions. Only sequence of ASCII digits is now accepted as a numerical reference. The group name in bytes patterns and replacement strings can now only contain ASCII letters and digits and underscore.

  • gh-90622: Worker processes for concurrent.futures.ProcessPoolExecutor are no longer spawned on demand (a feature added in 3.9) when the multiprocessing context start method is "fork" as that can lead to deadlocks in the child processes due to a fork happening while threads are running.

  • gh-91577: Move imports in SharedMemory methods to module level so that they can be executed late in python finalization.

  • gh-91581: Remove an unhandled error case in the C implementation of calls to datetime.fromtimestamp with no time zone (i.e. getting a local time from an epoch timestamp). This should have no user-facing effect other than giving a possibly more accurate error message when called with timestamps that fall on 10000-01-01 in the local time. Patch by Paul Ganssle.

  • gh-91539: Improve performance of urllib.request.getproxies_environment when there are many environment variables

  • gh-91524: Speed up the regular expression substitution (functions re.sub() and re.subn() and corresponding re.Pattern methods) for replacement strings containing group references by 2–3 times.

  • gh-91447: Fix findtext in the xml module to only give an empty string when the text attribute is set to None.

  • gh-91456: Deprecate current default auto() behavior: In 3.13 the default will be for for auto() to always return the largest member value incremented by 1, and to raise if incompatible value types are used.

  • bpo-47231: Fixed an issue with inconsistent trailing slashes in tarfile longname directories.

  • bpo-39064: zipfile.ZipFile now raises zipfile.BadZipFile instead of ValueError when reading a corrupt zip file in which the central directory offset is negative.

  • bpo-41287: Fix handling of the doc argument in subclasses of property().

  • gh-90005: ctypes dependency libffi is now detected with pkg-config.

  • bpo-32547: The constructors for DictWriter and DictReader now coerce the fieldnames argument to a list if it is an iterator.

  • bpo-35540: Fix dataclasses.asdict() crash when collections.defaultdict is present in the attributes.

  • bpo-47063: Add an index_pages parameter to support using non-default index page names.

  • bpo-47025: Drop support for bytes on sys.path.

  • bpo-46951: Order the contents of zipapp archives, to make builds more reproducible.

  • bpo-42777: Implement pathlib.Path.is_mount() for Windows paths.

  • bpo-46755: In QueueHandler, clear stack_info from LogRecord to prevent stack trace from being written twice.

  • bpo-45393: Fix the formatting for await x and not x in the operator precedence table when using the help() system.

  • bpo-46642: Improve error message when trying to subclass an instance of typing.TypeVar, typing.ParamSpec, typing.TypeVarTuple, etc. Based on patch by Gregory Beauregard.

  • bpo-46364: Restrict use of sockets instead of pipes for stdin of subprocesses created by asyncio to AIX platform only.

  • bpo-28249: Set doctest.DocTest.lineno to None when an object does not have __doc__.

  • bpo-46197: Fix ensurepip environment isolation for subprocess running pip.

  • bpo-45924: Fix asyncio incorrect traceback when future’s exception is raised multiple times. Patch by Kumar Aditya.

  • bpo-45046: Add support of context managers in unittest: methods enterContext() and enterClassContext() of class TestCase, method enterAsyncContext() of class IsolatedAsyncioTestCase and function unittest.enterModuleContext().

  • bpo-44173: Enable fast seeking of uncompressed unencrypted zipfile.ZipExtFile

  • bpo-42627: Fix incorrect parsing of Windows registry proxy settings

  • bpo-42047: Add threading.get_native_id() support for DragonFly BSD. Patch by David Carlier.

  • bpo-14243: The tempfile.NamedTemporaryFile function has a new optional parameter delete_on_close

  • bpo-41246: Give the same callback function for when the overlapped operation is done to the functions recv, recv_into, recvfrom, sendto, send and sendfile inside IocpProactor.

  • bpo-39264: Fixed collections.UserDict.get() to not call __missing__() when a value is not found. This matches the behavior of dict. Patch by Bar Harel.

  • bpo-38693: importlib now uses f-strings internally instead of str.format.

  • bpo-38267: Add timeout parameter to asyncio.loop.shutdown_default_executor(). The default value is None, which means the executor will be given an unlimited amount of time. When called from asyncio.Runner or asyncio.run(), the default timeout is 5 minutes.

  • bpo-34828: sqlite3.Connection.iterdump() now handles databases that use AUTOINCREMENT in one or more tables.

  • bpo-32990: Support reading wave files with the WAVE_FORMAT_EXTENSIBLE format in the wave module.

  • bpo-26253: Allow adjustable compression level for tarfile streams in tarfile.open().

Documentation

  • gh-85525: Remove extra row

  • gh-86404: Deprecated tools make suspicious and rstlint.py are now removed. They have been replaced by sphinx-lint.

  • gh-97741: Fix ! in c domain ref target syntax via a conf.py patch, so it works as intended to disable ref target resolution.

  • gh-96432: Fraction literals now support whitespace around the forward slash, Fraction('2 / 3').

  • gh-96098: Improve discoverability of the higher level concurrent.futures module by providing clearer links from the lower level threading and multiprocessing modules.

  • gh-95957: What’s New 3.11 now has instructions for how to provide compiler and linker flags for Tcl/Tk and OpenSSL on RHEL 7 and CentOS 7.

  • gh-95588: Clarified the conflicting advice given in the ast documentation about ast.literal_eval() being «safe» for use on untrusted input while at the same time warning that it can crash the process. The latter statement is true and is deemed unfixable without a large amount of work unsuitable for a bugfix. So we keep the warning and no longer claim that literal_eval is safe.

  • gh-91207: Fix stylesheet not working in Windows CHM htmlhelp docs and add warning that they are deprecated. Contributed by C.A.M. Gerlach.

  • gh-95454: Replaced incorrectly written true/false values in documentation. Patch by Robert O’Shea

  • gh-95451: Update library documentation with availability information on WebAssembly platforms wasm32-emscripten and wasm32-wasi.

  • gh-95415: Use consistent syntax for platform availability. The directive now supports a content body and emits a warning when it encounters an unknown platform.

  • gh-94321: Document the PEP 246 style protocol type sqlite3.PrepareProtocol.

  • gh-86128: Document a limitation in ThreadPoolExecutor where its exit handler is executed before any handlers in atexit.

  • gh-61162: Clarify sqlite3 behavior when Como usar la conexión con un administrador de contexto.

  • gh-87260: Align sqlite3 argument specs with the actual implementation.

  • gh-86986: The minimum Sphinx version required to build the documentation is now 3.2.

  • gh-88831: Augmented documentation of asyncio.create_task(). Clarified the need to keep strong references to tasks and added a code snippet detailing how to do this.

  • gh-86438: Clarify that -W and PYTHONWARNINGS are matched literally and case-insensitively, rather than as regular expressions, in warnings.

  • gh-93031: Update tutorial introduction output to use 3.10+ SyntaxError invalid range.

  • gh-92240: Added release dates for «What’s New in Python 3.X» for 3.0, 3.1, 3.2, 3.8 and 3.10

  • bpo-47161: Document that pathlib.PurePath does not collapse initial double slashes because they denote UNC paths.

  • bpo-40838: Document that inspect.getdoc(), inspect.getmodule(), and inspect.getsourcefile() might return None.

  • bpo-43689: The Differ documentation now also mentions other whitespace characters, which make it harder to understand the diff output.

  • bpo-38056: Overhaul the Manejadores de errores documentation in codecs.

  • bpo-13553: Document tkinter.Tk args.

Tests

  • gh-95027: On Windows, when the Python test suite is run with the -jN option, the ANSI code page is now used as the encoding for the stdout temporary file, rather than using UTF-8 which can lead to decoding errors. Patch by Victor Stinner.

  • gh-96624: Fixed the failure of repeated runs of test.test_unittest caused by side effects in test_dotted_but_module_not_loaded.

  • gh-95243: Mitigate the inherent race condition from using find_unused_port() in testSockName() by trying to find an unused port a few times before failing. Patch by Ross Burton.

  • gh-95573: Lib/test/test_asyncio/test_ssl.py exposed a bug in the macOS kernel where intense concurrent load on non-blocking sockets occasionally causes errno.ENOBUFS («No buffer space available») to be emitted. FB11063974 filed with Apple, in the mean time as a workaround buffer size used in tests on macOS is decreased to avoid intermittent failures. Patch by Fantix King.

  • gh-95280: Fix problem with test_ssl test_get_ciphers on systems that require perfect forward secrecy (PFS) ciphers.

  • gh-95212: Make multiprocessing test case test_shared_memory_recreate parallel-safe.

  • gh-95218: Move tests for importlib.resources into test_importlib.resources.

  • gh-93963: Updated tests to use preferred location for importlib.resources ABCs.

  • gh-94675: Add a regression test for re exponentional slowdown when using rjsmin.

  • gh-91330: Added more tests for dataclasses to cover behavior with data descriptor-based fields.

  • gh-94208: test_ssl is now checking for supported TLS version and protocols in more tests.

  • gh-94315: Tests now check for DAC override capability instead of relying on os.geteuid().

  • gh-54781: Rename test_tk to test_tkinter, and rename test_ttk_guionly to test_ttk. Patch by Victor Stinner.

  • gh-93839: Move Lib/ctypes/test/ to Lib/test/test_ctypes/. Patch by Victor Stinner.

  • gh-93951: In test_bdb.StateTestCase.test_skip, avoid including auxiliary importers.

  • gh-93957: Provide nicer error reporting from subprocesses in test_venv.EnsurePipTest.test_with_pip.

  • gh-93884: Add test cases for PyNumber_ToBase() that take a large number or a non-int object as parameter.

  • gh-93852: test_asyncio, test_logging, test_socket and test_socketserver now create AF_UNIX domains in the current directory to no longer fail with OSError("AF_UNIX path too long") if the temporary directory (the TMPDIR environment variable) is too long. Patch by Victor Stinner.

  • gh-93353: regrtest now checks if a test leaks temporary files or directories if run with -jN option. Patch by Victor Stinner.

  • gh-84461: run_tests.py now handles cross compiling env vars correctly and pass HOSTRUNNER to regression tests.

  • gh-93616: test_modulefinder now creates a temporary directory in ModuleFinderTest.setUp() instead of module scope.

  • gh-93575: Fix issue with test_unicode test_raiseMemError. The test case now use test.support.calcobjsize to calculate size of PyUnicode structs. sys.getsizeof() may return different size when string has UTF-8 memory.

  • gh-90473: WASI does not have a chmod(2) syscall. os.chmod() is now a dummy function on WASI. Skip all tests that depend on working os.chmod().

  • gh-90473: Skip tests on WASI that require symlinks with absolute paths.

  • gh-57539: Increase calendar test coverage for calendar.LocaleTextCalendar.formatweekday().

  • gh-90473: Skip symlink tests on WASI. wasmtime uses openat2(2) with RESOLVE_BENEATH flag, which prevents symlinks with absolute paths.

  • gh-89858: Fix test_embed for out-of-tree builds. Patch by Kumar Aditya.

  • gh-92886: Fixing tests that fail when running with optimizations (-O) in test_imaplib.py.

  • gh-92886: Fixing tests that fail when running with optimizations (-O) in test_zipimport.py

  • gh-92886: Fixing tests that fail when running with optimizations (-O) in test_py_compile.py

  • gh-92886: Fixing tests that fail when running with optimizations (-O) in test_sys_settrace.py.

  • gh-92886: Fixing tests that fail when running with optimizations (-O) in _test_multiprocessing.py

  • gh-92670: Skip test_shutil.TestCopy.test_copyfile_nonexistent_dir test on AIX as the test uses a trailing slash to force the OS consider the path as a directory, but on AIX the trailing slash has no effect and is considered as a file.

  • gh-92514: Remove unused test.support.BasicTestRunner. Patch by Jelle Zijlstra.

  • bpo-47016: Create a GitHub Actions workflow for verifying bundled pip and setuptools. Patch by Illia Volochii and Adam Turner.

Build

  • gh-96761: Fix the build process of clang compiler for _bootstrap_python if LTO optimization is applied. Patch by Matthias Görgens and Donghee Na.

  • gh-96883: wasm32-emscripten builds for browsers now include concurrent.futures for asyncio and unittest.mock.

  • gh-85936: CPython now uses the ThinLTO option as the default policy if the Clang compiler accepts the flag. Patch by Donghee Na.

  • gh-96729: Ensure that Windows releases built with Tools\msi\buildrelease.bat are upgradable to and from official Python releases.

  • gh-96269: Shared module targets now depend on new MODULE_DEPS variable, which includes EXPORTSYMS. This fixes a build order issue on unsupported AIX platform.

  • gh-84461: wasm32-emscripten platform no longer builds resource module, getresuid(), getresgid(), and their setters. The APIs are stubs and not functional.

  • gh-95973: Add a new --with-dsymutil configure option to link debug information in macOS. Patch by Pablo Galindo.

  • gh-90536: Use the BOLT post-link optimizer to improve performance, particularly on medium-to-large applications.

  • gh-93744: Remove the configure --with-cxx-main build option: it didn’t work for many years. Remove the MAINCC variable from configure and Makefile. Patch by Victor Stinner.

  • gh-94801: Fix a regression in configure script that caused some header checks to ignore custom CPPFLAGS. The regression was introduced in gh-94802.

  • gh-95145: wasm32-wasi builds no longer depend on WASIX’s pthread stubs. Python now has its own stubbed pthread API.

  • gh-95174: Python now detects missing dup function in WASI and works around some missing errno, select, and socket constants.

  • gh-95174: Python now skips missing socket functions and methods on WASI. WASI can only create sockets from existing fd / accept and has no netdb.

  • gh-95085: Platforms wasm32-unknown-emscripten and wasm32-unknown-wasi have been promoted to PEP 11 tier 3 platform support.

  • gh-94847: Fixed _decimal module build issue on GCC when compiling with LTO and pydebug. Debug builds no longer force inlining of functions.

  • gh-94841: Fix the possible performance regression of PyObject_Free() compiled with MSVC version 1932.

  • gh-94801: configure now uses custom flags like ZLIB_CFLAGS and ZLIB_LIBS when searching for headers and libraries.

  • gh-94773: deepfreeze.py now supports code object with frozensets that contain incompatible, unsortable types.

  • gh-94682: Build and test with OpenSSL 1.1.1q

  • gh-90005: Dependencies of readline and curses module are now detected in configure script with pkg-config. Only ncurses / ncursesw are detected automatically. The old curses library is not configured automatically. Workaround for missing termcap or tinfo library has been removed.

  • gh-90005: Fix building _ctypes extension without pkg-config.

  • gh-90005: _dbm module dependencies are now detected by configure.

  • gh-94404: makesetup now works around an issue with sed on macOS and uses correct CFLAGS for object files that end up in a shared extension. Module CFLAGS are used before PY_STDMODULE_CFLAGS to avoid clashes with system headers.

  • gh-93939: C extension modules are now built by configure and make instead of distutils and setup.py.

  • gh-93939: The 2to3, idle, and pydoc scripts are now generated and installed by Makefile instead of setup.py.

  • gh-94280: Updated pegen regeneration script on Windows to find and use Python 3.9 or higher. Prior to this, pegen regeneration already required 3.9 or higher, but the script may have used lower versions of Python.

  • gh-93584: Address race condition in Makefile when installing a PGO build. All test and install targets now depend on all target.

  • gh-93491: configure now detects and reports PEP 11 support tiers.

  • gh-69093: Fix Modules/Setup.stdlib.in rule for _sqlite3 extension.

  • gh-93207: va_start() with two parameters, like va_start(args, format), is now required to build Python. va_start() is no longer called with a single parameter. Patch by Kumar Aditya.

  • gh-93202: Python now always use the %zu and %zd printf formats to format a size_t or Py_ssize_t number. Building Python 3.12 requires a C11 compiler, so these printf formats are now always supported. Patch by Victor Stinner.

  • gh-90473: Disable pymalloc and increase stack size on wasm32-wasi.

  • bpo-34449: Drop invalid compiler switch -fPIC for HP aCC on HP-UX. Patch by Michael Osipov.

Windows

  • gh-98360: Fixes multiprocessing spawning child processes on Windows from a virtual environment to ensure that child processes that also use multiprocessing to spawn more children will recognize that they are in a virtual environment.

  • gh-98414: Fix py.exe launcher handling of -V:<company>/ option when default preferences have been set in environment variables or configuration files.

  • gh-97728: Fix possible crashes caused by the use of uninitialized variables when pass invalid arguments in os.system() on Windows and in Windows-specific modules (like winreg).

  • gh-90989: Made Python Install Manager install per-user by default (unless an all users install already exists), and clarify some text in the installer.

  • gh-97649: The Tools directory is no longer installed on Windows

  • gh-96965: Update libffi to 3.4.3

  • gh-96577: Fixes a potential buffer overrun in msilib.

  • gh-96559: Fixes the Windows launcher not using the compatible interpretation of default tags found in configuration files when no tag was passed to the command.

  • gh-94781: Fix pcbuild.proj to clean previous instances of output files in Python\deepfreeze and Python\frozen_modules directories on Windows. Patch by Charlie Zhao.

  • gh-89545: Updates platform code getting the Windows version to use native Windows Management Instrumentation (WMI) queries to determine OS version, type, and architecture.

  • gh-95733: Make certain requirements of the Windows Store package optional to allow installing on earlier updates of Windows.

  • gh-95656: Enable the enable_load_extension() sqlite3 API.

  • gh-95587: Fixes some issues where the Windows installer would incorrectly detect certain features of an existing install when upgrading.

  • gh-94399: Restores the behaviour of Python Install Manager for /usr/bin/env shebang lines, which will now search PATH for an executable matching the given command. If none is found, the usual search process is used.

  • gh-95445: Fixes the unsuccessful removal of the HTML document directory when uninstalling with Windows msi.

  • gh-95359: Fix Python Install Manager handling of py.ini commands (it was incorrectly expecting a py_ prefix on keys) and crashes when reading per-user configuration file.

  • gh-95285: Fix Python Install Manager handling of command lines where it is only passed a short executable name.

  • gh-90844: Allow virtual environments to correctly launch when they have spaces in the path.

  • gh-94772: Fix incorrect handling of shebang lines in py.exe launcher

  • gh-94018: zipfile will now remove trailing spaces from path components when extracting files on Windows.

  • gh-93824: Drag and drop of files onto Python files in Windows Explorer has been enabled for Windows ARM64.

  • gh-43414: os.get_terminal_size() now attempts to read the size from any provided handle, rather than only supporting file descriptors 0, 1 and 2.

  • gh-92817: Ensures that py.exe will prefer an active virtual environment over default tags specified with environment variables or through a py.ini file.

  • gh-92984: Explicitly disable incremental linking for non-Debug builds

  • gh-92841: asyncio no longer throws RuntimeError: Event loop is closed on interpreter exit after asynchronous socket activity. Patch by Oleg Iarygin.

  • bpo-46907: Update Windows installer to use SQLite 3.38.4.

  • gh-91061: Accept os.PathLike for the argument to winsound.PlaySound

  • bpo-42658: Support native Windows case-insensitive path comparisons by using LCMapStringEx instead of str.lower() in ntpath.normcase(). Add LCMapStringEx to the _winapi module.

  • bpo-38704: Prevent installation on unsupported Windows versions.

macOS

  • gh-97897: The macOS 13 SDK includes support for the mkfifoat and mknodat system calls. Using the dir_fd option with either os.mkfifo() or os.mknod() could result in a segfault if cpython is built with the macOS 13 SDK but run on an earlier version of macOS. Prevent this by adding runtime support for detection of these system calls («weaklinking») as is done for other newer syscalls on macOS.

IDLE

  • gh-97527: Fix a bug in the previous bugfix that caused IDLE to not start when run with 3.10.8, 3.12.0a1, and at least Microsoft Python 3.10.2288.0 installed without the Lib/test package. 3.11.0 was never affected.

  • gh-65802: Document handling of extensions in Save As dialogs.

  • gh-95191: Include prompts when saving Shell (interactive input and output).

  • gh-95511: Fix the Shell context menu copy-with-prompts bug of copying an extra line when one selects whole lines.

  • gh-95471: In the Edit menu, move Select All and add a new separator.

  • gh-95411: Enable using IDLE’s module browser with .pyw files.

  • gh-89610: Add .pyi as a recognized extension for IDLE on macOS. This allows opening stub files by double clicking on them in the Finder.

Tools/Demos

  • gh-68686: Remove ptags and eptags scripts.

  • gh-97681: Remove the Tools/demo/ directory which contained old demo scripts. A copy can be found in the old-demos project. Patch by Victor Stinner.

  • gh-97669: Remove outdated example scripts of the Tools/scripts/ directory. A copy can be found in the old-demos project. Patch by Victor Stinner.

  • gh-95853: The wasm_build.py script now pre-builds Emscripten ports, checks for broken EMSDK versions, and warns about pkg-config env vars.

  • gh-95853: The new tool Tools/wasm/wasm_builder.py automates configure, compile, and test steps for building CPython on WebAssembly platforms.

  • gh-95731: Fix handling of module docstrings in Tools/i18n/pygettext.py.

  • gh-93939: Add script Tools/scripts/check_modules.py to check and validate builtin and shared extension modules. The script also handles Modules/Setup and will eventually replace setup.py.

  • gh-94538: Fix Argument Clinic output to custom file destinations. Patch by Erlend E. Aasland.

  • gh-94430: Allow parameters named module and self with custom C names in Argument Clinic. Patch by Erlend E. Aasland

  • gh-86087: The Tools/scripts/parseentities.py script used to parse HTML4 entities has been removed.

C API

Python 3.11.0 beta 1

Release date: 2022-05-06

Security

  • gh-57684: Add the -P command line option and the PYTHONSAFEPATH environment variable to not prepend a potentially unsafe path to sys.path. Patch by Victor Stinner.

Core and Builtins

  • gh-89519: Chaining classmethod descriptors (introduced in bpo-19072) is deprecated. It can no longer be used to wrap other descriptors such as property(). The core design of this feature was flawed, and it caused a number of downstream problems.

  • gh-92345: pymain_run_python() now imports readline and rlcompleter before sys.path is extended to include the current working directory of an interactive interpreter. Non-interactive interpreters are not affected.

  • bpo-43857: Improve the AttributeError message when deleting a missing attribute. Patch by Géry Ogam.

  • gh-92245: Make sure that PEP 523 is respected in all cases. In 3.11a7, specialization may have prevented Python-to-Python calls respecting PEP 523.

  • gh-92203: Add a closure keyword-only parameter to exec(). It can only be specified when exec-ing a code object that uses free variables. When specified, it must be a tuple, with exactly the number of cell variables referenced by the code object. closure has a default value of None, and it must be None if the code object doesn’t refer to any free variables.

  • gh-91173: Disable frozen modules in debug builds. Patch by Kumar Aditya.

  • gh-92114: Improve error message when subscript a type with __class_getitem__ set to None.

  • gh-92112: Fix crash triggered by an evil custom mro() on a metaclass.

  • gh-92063: The PRECALL_METHOD_DESCRIPTOR_FAST_WITH_KEYWORDS instruction now ensures methods are called only on objects of the correct type.

  • gh-92031: Deoptimize statically allocated code objects during Py_FINALIZE() so that future _PyCode_Quicken calls always start with unquickened code.

  • gh-92036: Fix a crash in subinterpreters related to the garbage collector. When a subinterpreter is deleted, untrack all objects tracked by its GC. To prevent a crash in deallocator functions expecting objects to be tracked by the GC, leak a strong reference to these objects on purpose, so they are never deleted and their deallocator functions are not called. Patch by Victor Stinner.

  • gh-92032: The interpreter can now autocomplete soft keywords, as of now match, case, and _ (wildcard pattern) from PEP 634.

  • gh-87999: The warning emitted by the Python parser for a numeric literal immediately followed by keyword has been changed from deprecation warning to syntax warning.

  • gh-91869: Fix an issue where specialized opcodes with extended arguments could produce incorrect tracing output or lead to assertion failures.

  • gh-91603: Speed up types.UnionType instantiation. Based on patch provided by Yurii Karabas.

  • gh-89373: If Python is built in debug mode, Python now ensures that deallocator functions leave the current exception unchanged. Patch by Victor Stinner.

  • gh-91632: Fix a minor memory leak at exit: release the memory of the generic_alias_iterator type. Patch by Donghee Na.

  • gh-81548: Octal escapes with value larger than 0o377 now produce a DeprecationWarning. In a future Python version they will be a SyntaxWarning and eventually a SyntaxError.

  • bpo-43950: Use a single compact table for line starts, ends and column offsets. Reduces memory consumption for location info by half

  • gh-91102: Use Argument Clinic for EncodingMap. Patch by Oleg Iarygin.

  • gh-91636: Fixed a crash in a garbage-collection edge-case, in which a PyFunction_Type.tp_clear function could leave a python function object in an inconsistent state.

  • gh-91603: Speed up isinstance() and issubclass() checks for types.UnionType. Patch by Yurii Karabas.

  • gh-91625: Fixed a bug in which adaptive opcodes ignored any preceding EXTENDED_ARGs on specialization failure.

  • gh-78607: The LLTRACE special build now looks for the name __lltrace__ defined in module globals, rather than the name __ltrace__, which had been introduced as a typo.

  • gh-91576: Speed up iteration of ascii strings by 50%. Patch by Kumar Aditya.

  • gh-89279: Improve interpreter performance on Windows by inlining a few specific macros.

  • gh-91502: Add a new _PyFrame_IsEntryFrame() API function, to check if a PyFrameObject is an entry frame. Patch by Pablo Galindo.

  • gh-91266: Refactor the bytearray strip methods strip, lstrip and rstrip to use a common implementation.

  • gh-91479: Replaced the __note__ field of BaseException (added in an earlier version of 3.11) with the final design of PEP 678. Namely, BaseException gets an add_note() method, and its __notes__ field is created when necessary.

  • gh-46055: Speed up right shift of negative integers, by removing unnecessary creation of temporaries. Original patch by Xinhang Xu, reworked by Mark Dickinson.

  • gh-91462: Make the interpreter’s low-level tracing (lltrace) feature output more readable by displaying opcode names (rather than just numbers), and by displaying stack contents before each opcode.

  • gh-89455: Fixed an uninitialized bool value in the traceback printing code path that was introduced by the initial bpo-45292 exception groups work.

  • gh-91421: Fix a potential integer overflow in _Py_DecodeUTF8Ex.

  • gh-91428: Add static const char *const _PyOpcode_OpName[256] = {...}; to opcode.h for debug builds to assist in debugging the Python interpreter. It is now more convenient to make various forms of debugging output more human-readable by including opcode names rather than just the corresponding decimal digits.

  • bpo-47120: Make POP_JUMP_IF_TRUE, POP_JUMP_IF_FALSE, POP_JUMP_IF_NONE and POP_JUMP_IF_NOT_NONE virtual, mapping to new relative jump opcodes.

  • bpo-45317: Add internal documentation explaining design of new (for 3.11) frame stack.

  • bpo-47197: ctypes used to mishandle void return types, so that for instance a function declared like ctypes.CFUNCTYPE(None, ctypes.c_int) would be called with signature int f(int) instead of void f(int). Wasm targets require function pointers to be called with the correct signatures so this led to crashes. The problem is now fixed.

  • bpo-47120: Make opcodes JUMP_IF_TRUE_OR_POP and JUMP_IF_FALSE_OR_POP relative rather than absolute.

  • bpo-47177: Replace the f_lasti member of the internal _PyInterpreterFrame structure with a prev_instr pointer, which reduces overhead in the main interpreter loop. The f_lasti attribute of Python-layer frame objects is preserved for backward-compatibility.

  • bpo-46961: Integer mod/remainder operations, including the three-argument form of pow(), now consistently return ints from the global small integer cache when applicable.

  • bpo-46962: Classes and functions that unconditionally declared their docstrings ignoring the --without-doc-strings compilation flag no longer do so.

    The classes affected are ctypes.UnionType, pickle.PickleBuffer, testcapi.RecursingInfinitelyError, and types.GenericAlias.

    The functions affected are 24 methods in ctypes.

    Patch by Oleg Iarygin.

  • bpo-46942: Use Argument Clinic for the types.MethodType constructor. Patch by Oleg Iarygin.

  • bpo-46764: Fix wrapping bound methods with @classmethod

  • bpo-43464: Optimize set.intersection() for non-set arguments.

  • bpo-46721: Optimize set.issuperset() for non-set argument.

  • bpo-46509: Add type-specialized versions of the Py_DECREF(), and use them for float, int, str, bool, and None to avoid pointer-chasing at runtime where types are known at C compile time.

  • bpo-46045: Do not use POSIX semaphores on NetBSD

  • bpo-36819: Fix crashes in built-in encoders with error handlers that return position less or equal than the starting position of non-encodable characters.

  • bpo-34093: marshal.dumps() uses FLAG_REF for all interned strings. This makes output more deterministic and helps reproducible build.

  • bpo-26579: Added object.__getstate__ which provides the default implementation of the __getstate__() method.

    Copying and pickling instances of subclasses of builtin types bytearray, set, frozenset, collections.OrderedDict, collections.deque, weakref.WeakSet, and datetime.tzinfo now copies and pickles instance attributes implemented as slots.

Library

  • gh-87901: Add the encoding parameter to os.popen().

  • gh-90997: Fix an issue where dis utilities may interpret populated inline cache entries as valid instructions.

  • gh-92332: Deprecate typing.Text (removal of the class is currently not planned). Patch by Alex Waygood.

  • gh-78157: Deprecate nested classes in enum definitions becoming members – in 3.13 they will be normal classes; add member and nonmember functions to allow control over results now.

  • gh-92356: Fixed a performance regression in ctypes function calls.

  • gh-90997: Show the actual named values stored in inline caches when show_caches=True is passed to dis utilities.

  • gh-92301: Prefer close_range() to iterating over procfs for file descriptor closing in subprocess for better performance.

  • gh-67248: Sort the miscellaneous topics in Cmd.do_help()

  • gh-92210: Port socket.__init__ to Argument Clinic. Patch by Cinder.

  • gh-80010: Add support for generalized ISO 8601 parsing to datetime.datetime.fromisoformat(), datetime.date.fromisoformat() and datetime.time.fromisoformat(). Patch by Paul Ganssle.

  • gh-92118: Fix a 3.11 regression in contextmanager(), which caused it to propagate exceptions with incorrect tracebacks.

  • gh-90887: Adding COPYFILE_STAT, COPYFILE_ACL and COPYFILE_XATTR constants for os.fcopyfile() available in macOs.

  • gh-91215: For @dataclass, add weakref_slot. The new parameter defaults to False. If true, and if slots=True, add a slot named "__weakref__", which will allow instances to be weakref’d. Contributed by Eric V. Smith

  • gh-85984: New function os.login_tty() for Unix.

  • gh-92128: Add __class_getitem__() to logging.LoggerAdapter and logging.StreamHandler, allowing them to be parameterized at runtime. Patch by Alex Waygood.

  • gh-92049: Forbid pickling constants re._constants.SUCCESS etc. Previously, pickling did not fail, but the result could not be unpickled.

  • gh-92062: inspect.Parameter now raises ValueError if name is a keyword, in addition to the existing check that it is an identifier.

  • gh-87390: Add an __unpacked__ attribute to types.GenericAlias. Patch by Jelle Zijlstra.

  • gh-88089: Add support for generic typing.NamedTuple.

  • gh-91996: New http.HTTPMethod enum to represent all the available HTTP request methods in a convenient way

  • gh-91984: Modified test strings in test_argparse.py to not contain trailing spaces before end of line.

  • gh-91952: Add encoding="locale" support to TextIOWrapper.reconfigure().

  • gh-91954: Add encoding and errors arguments to subprocess.getoutput() and subprocess.getstatusoutput().

  • bpo-47029: Always close the read end of the pipe used by multiprocessing.Queue after the last write of buffered data to the write end of the pipe to avoid BrokenPipeError at garbage collection and at multiprocessing.Queue.close() calls. Patch by Géry Ogam.

  • gh-91928: Add datetime.UTC alias for datetime.timezone.utc.

    Patch by Kabir Kwatra.

  • gh-68966: The mailcap module is now deprecated and will be removed in Python 3.13. See PEP 594 for the rationale and the mimetypes module for an alternative. Patch by Victor Stinner.

  • gh-91401: Provide a way to disable subprocess use of vfork() just in case it is ever needed and document the existing mechanism for posix_spawn().

  • gh-64783: Fix signal.NSIG value on FreeBSD to accept signal numbers greater than 32, like signal.SIGRTMIN and signal.SIGRTMAX. Patch by Victor Stinner.

  • gh-91910: Add missing f prefix to f-strings in error messages from the multiprocessing and asyncio modules.

  • gh-91860: Add typing.dataclass_transform(), implementing PEP 681. Patch by Jelle Zijlstra.

  • gh-91832: Add required attribute to argparse.Action repr output.

  • gh-91827: In the tkinter module add method info_patchlevel() which returns the exact version of the Tcl library as a named tuple similar to sys.version_info.

  • gh-84461: Add --enable-wasm-pthreads to enable pthreads support for WASM builds. Emscripten/node no longer has threading enabled by default. Include additional file systems.

  • gh-91821: Fix unstable test_from_tuple test in test_decimal.py.

  • gh-91217: Deprecate the xdrlib module.

  • gh-91217: Deprecate the uu module.

  • gh-91760: More strict rules will be applied for numerical group references and group names in regular expressions. For now, a deprecation warning is emitted for group references and group names which will be errors in future Python versions.

  • gh-84461: Add provisional sys._emscripten_info named tuple with build-time and run-time information about Emscripten platform.

  • gh-90623: signal.raise_signal() and os.kill() now check immediately for pending signals. Patch by Victor Stinner.

  • gh-91734: Fix OSS audio support on Solaris.

  • gh-90633: Include the passed value in the exception thrown by typing.assert_never(). Patch by Jelle Zijlstra.

  • gh-91700: Compilation of regular expression containing a conditional expression (?(group)...) now raises an appropriate re.error if the group number refers to not defined group. Previously an internal RuntimeError was raised.

  • gh-91231: Add an optional keyword shutdown_timeout parameter to the multiprocessing.BaseManager constructor. Kill the process if terminate() takes longer than the timeout. Patch by Victor Stinner.

  • gh-91621: Fix typing.get_type_hints() for collections.abc.Callable. Patch by Shantanu Jain.

  • gh-90568: Parsing \N escapes of Unicode Named Character Sequences in a regular expression raises now re.error instead of TypeError.

  • gh-91670: Remove deprecated SO config variable in sysconfig.

  • gh-91217: Deprecate the telnetlib module.

  • gh-91217: Deprecate the sunau module.

  • gh-91217: Deprecate the spwd module.

  • gh-91217: Deprecate the sndhdr module, as well as inline needed functionality for email.mime.MIMEAudio.

  • gh-91616: re module, fix fullmatch() mismatch when using Atomic Grouping or Possessive Quantifiers.

  • gh-91217: Deprecate the “pipes” module.

  • gh-91217: Deprecate the ossaudiodev module.

  • bpo-47256: re module, limit the maximum capturing group to 1,073,741,823 in 64-bit build, this increases the depth of backtracking.

  • gh-91217: Deprecate the nis module.

  • gh-91595: Fix the comparison of character and integer inside Tools.gdb.libpython.write_repr(). Patch by Yu Liu.

  • gh-74166: Add option to raise all errors from create_connection() in an ExceptionGroup when it fails to create a connection. The default remains to raise only the last error that had occurred when multiple addresses were tried.

  • gh-91487: Optimize asyncio UDP speed, over 100 times faster when transferring a large file.

  • gh-91575: Update case-insensitive matching in the re module to the latest Unicode version.

  • gh-90622: In concurrent.futures.process.ProcessPoolExecutor disallow the «fork» multiprocessing start method when the new max_tasks_per_child feature is used as the mix of threads+fork can hang the child processes. Default to using the safe «spawn» start method in that circumstance if no mp_context was supplied.

  • gh-89022: In sqlite3, SQLITE_MISUSE result codes are now mapped to InterfaceError instead of ProgrammingError. Also, more accurate exceptions are raised when binding parameters fail. Patch by Erlend E. Aasland.

  • gh-91526: Stop calling os.device_encoding(file.fileno()) in TextIOWrapper. It was complex, never documented, and didn’t work for most cases. (Patch by Inada Naoki.)

  • gh-88116: Change the frame-related functions in the inspect module to return a regular object (that is backwards compatible with the old tuple-like interface) that include the extended PEP 657 position information (end line number, column and end column). The affected functions are: inspect.getframeinfo(), inspect.getouterframes(), inspect.getinnerframes(), inspect.stack() and inspect.trace(). Patch by Pablo Galindo.

  • gh-69093: Add indexing and slicing support to sqlite3.Blob. Patch by Aviv Palivoda and Erlend E. Aasland.

  • gh-69093: Add context manager support to sqlite3.Blob. Patch by Aviv Palivoda and Erlend E. Aasland.

  • gh-91217: Deprecate nntplib.

  • gh-91217: Deprecate msilib.

  • gh-91404: Improve the performance of re matching by using computed gotos (or «threaded code») on supported platforms and removing expensive pointer indirections.

  • gh-91217: Deprecate the imghdr module.

  • gh-91217: Deprecate the crypt module.

  • gh-91276: Make space for longer opcodes in dis output.

  • bpo-47000: Make TextIOWrapper uses locale encoding when encoding="locale" is specified even in UTF-8 mode.

  • gh-91230: warnings.catch_warnings() now accepts arguments for warnings.simplefilter(), providing a more concise way to locally ignore warnings or convert them to errors.

  • gh-91217: Deprecate the chunk module.

  • gh-91498: Add the TCP_CONNECTION_INFO option (available on macOS) to socket.

  • bpo-47260: Fix os.closerange() potentially being a no-op in a Linux seccomp sandbox.

  • bpo-47087: Implement typing.Required and typing.NotRequired (PEP 655). Patch by David Foster and Jelle Zijlstra.

  • bpo-47061: Deprecate cgi and cgitb.

  • bpo-47061: Deprecate audioop.

  • bpo-47000: Add locale.getencoding() to get the current locale encoding. It is similar to locale.getpreferredencoding(False) but ignores the Python UTF-8 Mode.

  • bpo-42012: Add wsgiref.types, containing WSGI-specific types for static type checking.

  • bpo-47227: Suppress expression chaining for more re parsing errors.

  • bpo-47211: Remove undocumented and never working function re.template() and flag re.TEMPLATE. This was later reverted in 3.11.0b2 and deprecated instead.

  • bpo-47135: decimal.localcontext() now accepts context attributes via keyword arguments

  • bpo-43323: Fix errors in the email module if the charset itself contains undecodable/unencodable characters.

  • bpo-46841: Disassembly of quickened code.

  • bpo-46681: Forward gzip.compress() compresslevel to zlib.

  • bpo-45100: Add typing.get_overloads() and typing.clear_overloads(). Patch by Jelle Zijlstra.

  • bpo-44807: typing.Protocol no longer silently replaces __init__() methods defined on subclasses. Patch by Adrian Garcia Badaracco.

  • bpo-46787: Fix concurrent.futures.ProcessPoolExecutor exception memory leak

  • bpo-46720: Add support for path-like objects to multiprocessing.set_executable() for Windows to be on a par with Unix-like systems. Patch by Géry Ogam.

  • bpo-46696: Add SO_INCOMING_CPU constant to socket.

  • bpo-46053: Fix OSS audio support on NetBSD.

  • bpo-45639: image/avif and image/webp were added to mimetypes.

  • bpo-46285: Add command-line option -p/--protocol to module http.server which specifies the HTTP version to which the server is conformant (HTTP/1.1 conformant servers can now be run from the command-line interface of module http.server). Patch by Géry Ogam.

  • bpo-44791: Accept ellipsis as the last argument of typing.Concatenate.

  • bpo-46547: Remove variables leaking into pydoc.Helper class namespace.

  • bpo-46415: Fix ipaddress.ip_{address,interface,network} raising TypeError instead of ValueError if given invalid tuple as address parameter.

  • bpo-46075: CookieJar with DefaultCookiePolicy now can process cookies from localhost with domain=localhost explicitly specified in Set-Cookie header.

  • bpo-45995: Add a «z» option to the string formatting specification that coerces negative zero floating-point values to positive zero after rounding to the format precision. Contributed by John Belmonte.

  • bpo-26175: Fully implement the io.BufferedIOBase or io.TextIOBase interface for tempfile.SpooledTemporaryFile objects. This lets them work correctly with higher-level layers (like compression modules). Patch by Carey Metcalfe.

  • bpo-45138: Fix a regression in the sqlite3 trace callback where bound parameters were not expanded in the passed statement string. The regression was introduced in Python 3.10 by bpo-40318. Patch by Erlend E. Aasland.

  • bpo-44863: Allow TypedDict subclasses to also include Generic as a base class in class based syntax. Thereby allowing the user to define a generic TypedDict, just like a user-defined generic but with TypedDict semantics.

  • bpo-44587: Fix BooleanOptionalAction to not automatically add a default string. If a default string is desired, use a formatter to add it.

  • bpo-43827: All positional-or-keyword parameters to ABCMeta.__new__ are now positional-only to avoid conflicts with keyword arguments to be passed to __init_subclass__().

  • bpo-43218: Prevent creation of a venv whose path contains the PATH separator. This could affect the usage of the activate script. Patch by Dustin Rodrigues.

  • bpo-38435: Add a process_group parameter to subprocess.Popen to help move more things off of the unsafe preexec_fn parameter.

  • bpo-42066: Fix cookies getting sorted in CookieJar.__iter__() which is an extra behavior and not mentioned in RFC 2965 or Netscape cookie protocol. Now the cookies in CookieJar follows the order of the Set-Cookie header. Patch by Iman Kermani.

  • bpo-40617: Add create_window_function() to sqlite3.Connection for creating aggregate window functions. Patch by Erlend E. Aasland.

  • bpo-40676: Convert csv to use Argument Clinic for csv.field_size_limit(), csv.get_dialect(), csv.unregister_dialect() and csv.list_dialects().

  • bpo-39716: Raise an ArgumentError when the same subparser name is added twice to an argparse.ArgumentParser. This is consistent with the (default) behavior when the same option string is added twice to an ArgumentParser.

  • bpo-36073: Raise ProgrammingError instead of segfaulting on recursive usage of cursors in sqlite3 converters. Patch by Sergey Fedoseev.

  • bpo-34975: Adds a start_tls() method to StreamWriter, which upgrades the connection with TLS using the given SSLContext.

  • bpo-22276: Path methods glob() and rglob() return only directories if pattern ends with a pathname components separator (/ or sep). Patch by Eisuke Kawashima.

  • bpo-24905: Add blobopen() to sqlite3.Connection. sqlite3.Blob allows incremental I/O operations on blobs. Patch by Aviv Palivoda and Erlend E. Aasland.

Documentation

Tests

  • gh-92169: Use warnings_helper.import_deprecated() to import deprecated modules uniformly in tests. Patch by Hugo van Kemenade.

  • gh-84461: When multiprocessing is enabled, libregrtest can now use a Python executable other than sys.executable via the --python flag.

  • gh-91904: Fix initialization of PYTHONREGRTEST_UNICODE_GUARD which prevented running regression tests on non-UTF-8 locale.

  • gh-91752: Added @requires_zlib to test.test_tools.test_freeze.TestFreeze.

  • gh-91607: Fix test_concurrent_futures to test the correct multiprocessing start method context in several cases where the test logic mixed this up.

  • bpo-40280: Threading tests are now skipped on WASM targets without pthread support.

  • bpo-47109: Test for ctypes.macholib.dyld, ctypes.macholib.dylib, and ctypes.macholib.framework are brought from manual pre-unittest times to ctypes.test location and structure. Patch by Oleg Iarygin.

  • bpo-29890: Add tests for ipaddress.IPv4Interface and ipaddress.IPv6Interface construction with tuple arguments. Original patch and tests by louisom.

Build

  • gh-89452: gdbm-compat is now preferred over ndbm if both are available on the system. This allows avoiding the problematic ndbm.h on macOS.

  • gh-91731: Python is now built with -std=c11 compiler option, rather than -std=c99. Patch by Victor Stinner.

  • bpo-47152: Add script and make target for generating sre_constants.h.

  • bpo-47103: Windows PGInstrument builds now copy a required DLL into the output directory, making it easier to run the profile stage of a PGO build.

Windows

  • bpo-46907: Update Windows installer to use SQLite 3.38.3.

  • bpo-47239: Fixed –list and –list-paths output for Python Install Manager when used in an active virtual environment.

  • bpo-46907: Update Windows installer to use SQLite 3.38.2.

  • bpo-46785: Fix race condition between os.stat() and unlinking a file on Windows, by using errors codes returned by FindFirstFileW() when appropriate in win32_xstat_impl.

  • bpo-40859: Update Windows build to use xz-5.2.5

macOS

  • bpo-46907: Update macOS installer to SQLite 3.38.4.

Tools/Demos

  • gh-91583: Fix regression in the code generated by Argument Clinic for functions with the defining_class parameter.

  • gh-91575: Add script Tools/scripts/generate_re_casefix.py and the make target regen-re for generating additional data for case-insensitive matching according to the current Unicode version.

  • gh-91551: Remove the ancient Pynche color editor. It has moved to https://gitlab.com/warsaw/pynche

C API

  • gh-88279: Deprecate the C functions: PySys_SetArgv(), PySys_SetArgvEx(), PySys_SetPath(). Patch by Victor Stinner.

  • gh-92154: Added the PyCode_GetCode() function. This function does the equivalent of the Python code getattr(code_object, 'co_code').

  • gh-92173: Fix the closure argument to PyEval_EvalCodeEx().

  • gh-91320: Fix C++ compiler warnings about «old-style cast» (g++ -Wold-style-cast) in the Python C API. Use C++ reinterpret_cast<> and static_cast<> casts when the Python C API is used in C++. Patch by Victor Stinner.

  • gh-80527: Mark functions as deprecated by PEP 623: PyUnicode_AS_DATA(), PyUnicode_AS_UNICODE(), PyUnicode_GET_DATA_SIZE(), PyUnicode_GET_SIZE(). Patch by Victor Stinner.

  • gh-91768: Py_REFCNT(), Py_TYPE(), Py_SIZE() and Py_IS_TYPE() functions argument type is now PyObject*, rather than const PyObject*. Patch by Victor Stinner.

  • gh-91020: Add PyBytes_Type.tp_alloc to initialize PyBytesObject.ob_shash for bytes subclasses.

  • bpo-40421: Add PyFrame_GetLasti C-API function to access frame object’s f_lasti attribute safely from C code.

  • bpo-35134: Remove the Include/code.h header file. C extensions should only include the main <Python.h> header file. Patch by Victor Stinner.

  • bpo-47169: PyOS_CheckStack() is now exported in the Stable ABI on Windows.

  • bpo-47169: PyThread_get_thread_native_id() is excluded from the stable ABI on platforms where it doesn’t exist (like Solaris).

  • bpo-46343: Added PyErr_GetHandledException() and PyErr_SetHandledException() as simpler alternatives to PyErr_GetExcInfo() and PyErr_SetExcInfo().

    They are included in the stable ABI.

Python 3.11.0 alpha 7

Release date: 2022-04-05

Core and Builtins

  • bpo-47212: Raise IndentationError instead of SyntaxError for a bare except with no following indent. Improve SyntaxError locations for an un-parenthesized generator used as arguments. Patch by Matthieu Dartiailh.

  • bpo-47186: Replace JUMP_IF_NOT_EG_MATCH by CHECK_EG_MATCH + jump.

  • bpo-47176: Emscripten builds cannot handle signals in the usual way due to platform limitations. Python can now handle signals. To use, set Module.Py_EmscriptenSignalBuffer to be a single byte SharedArrayBuffer and set Py_EMSCRIPTEN_SIGNAL_HANDLING to 1. Writing a number into the SharedArrayBuffer will cause the corresponding signal to be raised into the Python thread.

  • bpo-47186: Replace JUMP_IF_NOT_EXC_MATCH by CHECK_EXC_MATCH + jump.

  • bpo-47120: Replace the absolute jump opcode JUMP_NO_INTERRUPT by the relative JUMP_BACKWARD_NO_INTERRUPT.

  • bpo-46841: Avoid unnecessary allocations when comparing code objects.

  • bpo-47182: Fix a crash when using a named unicode character like "\N{digit nine}" after the main interpreter has been initialized a second time.

  • bpo-47162: WebAssembly cannot deal with bad function pointer casts (different count or types of arguments). Python can now use call trampolines to mitigate the problem. Define PY_CALL_TRAMPOLINE to enable call trampolines.

  • bpo-46775: Some Windows system error codes(>= 10000) are now mapped into the correct errno and may now raise a subclass of OSError. Patch by Donghee Na.

  • bpo-47129: Improve error messages in f-string syntax errors concerning empty expressions.

  • bpo-47117: Fix a crash if we fail to decode characters in interactive mode if the tokenizer buffers are uninitialized. Patch by Pablo Galindo.

  • bpo-47127: Speed up calls to c functions with keyword arguments by 25% with specialization. Patch by Kumar Aditya.

  • bpo-47120: Replaced JUMP_ABSOLUTE by the relative jump JUMP_BACKWARD.

  • bpo-42197: PyFrame_FastToLocalsWithError() and PyFrame_LocalsToFast() are no longer called during profiling nor tracing. C code can access the f_locals attribute of PyFrameObject by calling PyFrame_GetLocals().

  • bpo-47070: Improve performance of array_inplace_repeat by reducing the number of invocations of memcpy. Refactor the repeat and inplace repeat methods of array, bytes, bytearray and unicodeobject to use the common _PyBytes_Repeat.

  • bpo-47053: Reduce de-optimization in the specialized BINARY_OP_INPLACE_ADD_UNICODE opcode.

  • bpo-47045: Remove the f_state field from the _PyInterpreterFrame struct. Add the owner field to the _PyInterpreterFrame struct to make ownership explicit to simplify clearing and deallocing frames and generators.

  • bpo-46968: Check for the existence of the «sys/auxv.h» header in faulthandler to avoid compilation problems in systems where this header doesn’t exist. Patch by Pablo Galindo

  • bpo-46329: Use low bit of LOAD_GLOBAL to indicate whether to push a NULL before the global. Helps streamline the call sequence a bit.

  • bpo-46841: Quicken bytecode in-place by storing it as part of the corresponding PyCodeObject.

  • bpo-47012: Speed up iteration of bytes and bytearray by 30%. Patch by Kumar Aditya.

  • bpo-47009: Improved the performance of list.append() and list comprehensions by optimizing for the common case, where no resize is needed. Patch by Dennis Sweeney.

  • bpo-47005: Improve performance of bytearray_repeat and bytearray_irepeat by reducing the number of invocations of memcpy.

  • bpo-46829: Deprecate passing a message into asyncio.Future.cancel() and asyncio.Task.cancel()

  • bpo-46993: Speed up bytearray creation from list and tuple by 40%. Patch by Kumar Aditya.

  • bpo-39829: Removed the __len__() call when initializing a list and moved initializing to list_extend. Patch by Jeremiah Pascual.

  • bpo-46944: Speed up throwing exception in generator with METH_FASTCALL calling convention. Patch by Kumar Aditya.

  • bpo-46841: Modify STORE_SUBSCR to use an inline cache entry (rather than its oparg) as an adaptive counter.

  • bpo-46841: Use inline caching for PRECALL and CALL, and remove the internal machinery for managing the (now unused) non-inline caches.

  • bpo-46881: Statically allocate and initialize the latin1 characters.

  • bpo-46838: Improve syntax errors for incorrect function definitions. Patch by Pablo Galindo

  • bpo-43721: Fix docstrings of getter, setter, and deleter to clarify that they create a new copy of the property.

  • bpo-43224: Make grammar changes required for PEP 646.

Library

  • bpo-47208: Allow vendors to override CTYPES_MAX_ARGCOUNT.

  • bpo-23689: re module: fix memory leak when a match is terminated by a signal or memory allocation failure. Patch by Ma Lin.

  • bpo-47167: Allow overriding a future compliance check in asyncio.Task.

  • bpo-47151: When subprocess tries to use vfork, it now falls back to fork if vfork returns an error. This allows use in situations where vfork isn’t allowed by the OS kernel.

  • bpo-47152: Convert the re module into a package. Deprecate modules sre_compile, sre_constants and sre_parse.

  • bpo-4833: Add ZipFile.mkdir()

  • bpo-27929: Fix asyncio.loop.sock_connect() to only resolve names for socket.AF_INET or socket.AF_INET6 families. Resolution may not make sense for other families, like socket.AF_BLUETOOTH and socket.AF_UNIX.

  • bpo-14265: Adds the fully qualified test name to unittest output

  • bpo-47061: Deprecate the aifc module.

  • bpo-39622: Handle Ctrl+C in asyncio programs to interrupt the main task.

  • bpo-47101: hashlib.algorithms_available now lists only algorithms that are provided by activated crypto providers on OpenSSL 3.0. Legacy algorithms are not listed unless the legacy provider has been loaded into the default OSSL context.

  • bpo-47099: All URLError exception messages raised in urllib.request.URLopener now contain a colon between ftp error and the rest of the message. Previously, open_ftp() missed the colon. Patch by Oleg Iarygin.

  • bpo-47099: Exception chaining is changed from Exception.with_traceback()/sys.exc_info() to PEP 3134. Patch by Oleg Iarygin.

  • bpo-47095: hashlib’s internal _blake2 module now prefers libb2 from https://www.blake2.net/ over Python’s vendored copy of blake2.

  • bpo-47098: The Keccak Code Package for hashlib’s internal _sha3 module has been replaced with tiny_sha3. The module is used as fallback when Python is built without OpenSSL.

  • bpo-47088: Implement typing.LiteralString, part of PEP 675. Patch by Jelle Zijlstra.

  • bpo-42885: Optimize re.search(), re.split(), re.findall(), re.finditer() and re.sub() for regular expressions starting with \A or ^.

  • bpo-23691: Protect the re.finditer() iterator from re-entering.

  • bpo-47067: Optimize calling GenericAlias objects by using PEP 590 vectorcall and by replacing PyObject_SetAttrString with PyObject_SetAttr.

  • bpo-28080: Add the metadata_encoding parameter in the zipfile.ZipFile constructor and the --metadata-encoding option in the zipfile CLI to allow reading zipfiles using non-standard codecs to encode the filenames within the archive.

  • bpo-47000: Make io.text_encoding() returns «utf-8» when UTF-8 mode is enabled.

  • bpo-42369: Fix thread safety of zipfile._SharedFile.tell() to avoid a «zipfile.BadZipFile: Bad CRC-32 for file» exception when reading a ZipFile from multiple threads.

  • bpo-38256: Fix binascii.crc32() when it is compiled to use zlib’c crc32 to work properly on inputs 4+GiB in length instead of returning the wrong result. The workaround prior to this was to always feed the function data in increments smaller than 4GiB or to just call the zlib module function.

    We also have binascii.crc32() release the GIL when computing on larger inputs as zlib.crc32() and hashlib do.

    This also boosts performance on Windows as it now uses the zlib crc32 implementation for binascii.crc32() for a 2-3x speedup.

    That the stdlib has a crc32 API in two modules is a known historical oddity. This moves us closer to a single implementation behind them.

  • bpo-47066: Global inline flags (e.g. (?i)) can now only be used at the start of the regular expressions. Using them not at the start of expression was deprecated since Python 3.6.

  • bpo-39394: A warning about inline flags not at the start of the regular expression now contains the position of the flag.

  • bpo-433030: Add support of atomic grouping ((?>...)) and possessive quantifiers (*+, ++, ?+, {m,n}+) in regular expressions.

  • bpo-47062: Implement asyncio.Runner context manager.

  • bpo-46382: dataclass() slots=True now correctly omits slots already defined in base classes. Patch by Arie Bovenberg.

  • bpo-47057: Use FASTCALL convention for FutureIter.throw()

  • bpo-47061: Deprecate the various modules listed by PEP 594:

    aifc, asynchat, asyncore, audioop, cgi, cgitb, chunk, crypt, imghdr, msilib, nntplib, nis, ossaudiodev, pipes, smtpd, sndhdr, spwd, sunau, telnetlib, uu, xdrlib

  • bpo-34790: Remove passing coroutine objects to asyncio.wait().

  • bpo-47039: Normalize repr() of asyncio future and task objects.

  • bpo-2604: Fix bug where doctests using globals would fail when run multiple times.

  • bpo-45150: Add hashlib.file_digest() helper for efficient hashing of file object.

  • bpo-34861: Made cumtime the default sorting key for cProfile

  • bpo-45997: Fix asyncio.Semaphore re-aquiring FIFO order.

  • bpo-47022: The asynchat, asyncore and smtpd modules have been deprecated since at least Python 3.6. Their documentation and deprecation warnings and have now been updated to note they will removed in Python 3.12 (PEP 594).

  • bpo-43253: Fix a crash when closing transports where the underlying socket handle is already invalid on the Proactor event loop.

  • bpo-40280: select.select() now passes NULL to select for each empty fdset.

  • bpo-47004: Apply bugfixes from importlib_metadata 4.11.3, including bugfix for EntryPoint.extras, which was returning match objects and not the extras strings.

  • bpo-46998: Allow subclassing of typing.Any. Patch by Shantanu Jain.

  • bpo-46995: Deprecate missing asyncio.Task.set_name() for third-party task implementations, schedule making it mandatory in Python 3.13.

  • bpo-46994: Accept explicit contextvars.Context in asyncio.create_task() and asyncio.loop.create_task().

  • bpo-46981: typing.get_args(typing.Tuple[()]) now returns () instead of ((),).

  • bpo-46968: Add os.sysconf_names['SC_MINSIGSTKSZ'].

  • bpo-46985: Upgrade pip wheel bundled with ensurepip (pip 22.0.4)

  • bpo-46968: faulthandler: On Linux 5.14 and newer, dynamically determine size of signal handler stack size CPython allocates using getauxval(AT_MINSIGSTKSZ). This changes allows for Python extension’s request to Linux kernel to use AMX_TILE instruction set on Sapphire Rapids Xeon processor to succeed, unblocking use of the ISA in frameworks.

  • bpo-46917: The math.nan value is now always available. Patch by Victor Stinner.

  • bpo-46955: Expose asyncio.base_events.Server as asyncio.Server. Patch by Stefan Zabka.

  • bpo-23325: The signal module no longer assumes that SIG_IGN and SIG_DFL are small int singletons.

  • bpo-46932: Update bundled libexpat to 2.4.7

  • bpo-46933: The pwd module is now optional. os.path.expanduser() returns the path when the pwd module is not available.

  • bpo-40059: PEP 680, the tomllib module. Adds support for parsing TOML.

  • bpo-464471: asyncio.timeout() and asyncio.timeout_at() context managers added. Patch by Tin Tvrtković and Andrew Svetlov.

  • bpo-46805: Added raw datagram socket functions for asyncio: sock_sendto(), sock_recvfrom() and sock_recvfrom_into().

  • bpo-46644: No longer require valid typeforms to be callable. This allows typing.Annotated to wrap typing.ParamSpecArgs and dataclasses.InitVar. Patch by Gregory Beauregard.

  • bpo-46581: Brings ParamSpec propagation for GenericAlias in line with Concatenate (and others).

  • bpo-45413: Define posix_venv and nt_venv sysconfig installation schemes to be used for bootstrapping new virtual environments. Add venv sysconfig installation scheme to get the appropriate one of the above. The schemes are identical to the pre-existing posix_prefix and nt install schemes. The venv module now uses the venv scheme to create new virtual environments instead of hardcoding the paths depending only on the platform. Downstream Python distributors customizing the posix_prefix or nt install scheme in a way that is not compatible with the install scheme used in virtual environments are encouraged not to customize the venv schemes. When Python itself runs in a virtual environment, sysconfig.get_default_scheme() and sysconfig.get_preferred_scheme() with key="prefix" returns venv.

  • bpo-43224: Implement support for PEP 646 in typing.py.

  • bpo-43224: Allow unpacking types.GenericAlias objects, e.g. *tuple[int, str].

  • bpo-46557: Warnings captured by the logging module are now logged without a format string to prevent systems that group logs by the msg argument from grouping captured warnings together.

  • bpo-41370: typing.get_type_hints() now supports evaluating strings as forward references in PEP 585 generic aliases.

  • bpo-46607: Add DeprecationWarning to LegacyInterpolation, deprecated in the docstring since Python 3.2. Will be removed in Python 3.13. Use BasicInterpolation or ExtendedInterpolation instead.

  • bpo-26120: pydoc now excludes __future__ imports from the module’s data items.

  • bpo-46480: Add typing.assert_type(). Patch by Jelle Zijlstra.

  • bpo-46421: Fix a unittest issue where if the command was invoked as python -m unittest and the filename(s) began with a dot (.), a ValueError is returned.

  • bpo-46245: Add optional parameter dir_fd in shutil.rmtree().

  • bpo-22859: unittest.TestProgram.usageExit() is marked as deprecated, to be removed in Python 3.13.

  • bpo-46170: Improve the error message when you try to subclass an instance of typing.NewType.

  • bpo-40296: Fix supporting generic aliases in pydoc.

  • bpo-20392: Fix inconsistency with uppercase file extensions in MimeTypes.guess_type(). Patch by Kumar Aditya.

  • bpo-46030: Add LOCAL_CREDS, LOCAL_CREDS_PERSISTENT and SCM_CREDS2 FreeBSD constants to the socket module.

  • bpo-44439: Fix .write() method of a member file in ZipFile, when the input data is an object that supports the buffer protocol, the file length may be wrong.

  • bpo-45171: Fix handling of the stacklevel argument to logging functions in the logging module so that it is consistent across all logging functions and, as advertised, similar to the stacklevel argument used in warn().

  • bpo-24959: Fix bug where unittest sometimes drops frames from tracebacks of exceptions raised in tests.

  • bpo-44859: Raise more accurate and PEP 249 compatible exceptions in sqlite3.

  • bpo-44493: Add missing terminated NUL in sockaddr_un’s length

    This was potentially observable when using non-abstract AF_UNIX datagram sockets to processes written in another programming language.

  • bpo-41930: Add serialize() and deserialize() support to sqlite3. Patch by Erlend E. Aasland.

  • bpo-33178: Added ctypes.BigEndianUnion and ctypes.LittleEndianUnion classes, as originally documented in the library docs but not yet implemented.

  • bpo-43352: Add an Barrier object in synchronization primitives of asyncio Lib in order to be consistent with Barrier from threading and multiprocessing libs*

  • bpo-35859: re module, fix a few bugs about capturing group. In rare cases, capturing group gets an incorrect string. Patch by Ma Lin.

Documentation

Tests

Build

  • bpo-40280: Add configure option --enable-wasm-dynamic-linking to enable dlopen and MAIN_MODULE / SIDE_MODULE on wasm32-emscripten.

  • bpo-46023: makesetup now detects and skips all duplicated module definitions. The first entry wins.

  • bpo-40280: Add SOABI wasm32-emscripten for Emscripten and wasm32-wasi for WASI on 32bit WASM as well as wasm64 counter parts.

  • bpo-47032: Ensure Windows install builds fail correctly with a non-zero exit code when part of the build fails.

  • bpo-47024: Update OpenSSL to 1.1.1n for macOS installers and all Windows builds.

  • bpo-46996: The tkinter package now requires Tcl/Tk version 8.5.12 or newer.

  • bpo-46973: Add regen-configure make target to regenerate configure script with Christian’s container image quay.io/tiran/cpython_autoconf:269.

  • bpo-46917: Building Python now requires support of IEEE 754 floating-point numbers. Patch by Victor Stinner.

  • bpo-45774: configure now verifies that all SQLite C APIs needed for the sqlite3 extension module are found.

Windows

  • bpo-47194: Update zlib to v1.2.12 to resolve CVE 2018-25032.

  • bpo-47171: Enables installing the py.exe launcher on Windows ARM64.

  • bpo-46566: Upgraded Python Install Manager to support a new -V:company/tag argument for full PEP 514 support and to detect ARM64 installs. The -64 suffix on arguments is deprecated, but still selects any non-32-bit install. Setting PYLAUNCHER_ALLOW_INSTALL and specifying a version that is not installed will attempt to install the requested version from the Microsoft Store.

  • bpo-47086: The installer for Windows now includes documentation as loose HTML files rather than a single compiled .chm file.

  • bpo-46907: Update Windows installer to use SQLite 3.38.1.

  • bpo-44549: Update bzip2 to 1.0.8 in Windows builds to mitigate CVE 2016-3189 and CVE 2019-12900.

  • bpo-46948: Prevent CVE 2022-26488 by ensuring the Add to PATH option in the Windows installer uses the correct path when being repaired.

macOS

  • bpo-46890: Fix a regression in the setting of sys._base_executable in framework builds, and thereby fix a regression in venv virtual environments with such builds.

  • bpo-46907: Update macOS installer to SQLite 3.38.1.

Tools/Demos

  • bpo-40280: Replace Emscripten’s limited shell with Katie Bell’s browser-ui REPL from python-wasm project.

C API

  • bpo-40421: Add PyFrame_GetBuiltins, PyFrame_GetGenerator and PyFrame_GetGlobals C-API functions to access frame object attributes safely from C code.

  • bpo-46850: Move the private _PyFrameEvalFunction type, and private _PyInterpreterState_GetEvalFrameFunc() and _PyInterpreterState_SetEvalFrameFunc() functions to the internal C API. The _PyFrameEvalFunction callback function type now uses the _PyInterpreterFrame type which is part of the internal C API. Patch by Victor Stinner.

  • bpo-46850: Move the private undocumented _PyEval_EvalFrameDefault() function to the internal C API. The function now uses the _PyInterpreterFrame type which is part of the internal C API. Patch by Victor Stinner.

  • bpo-46850: Remove the private undocumented function _PyEval_CallTracing() from the C API. Call the public sys.call_tracing() function instead. Patch by Victor Stinner.

  • bpo-46850: Remove the private undocumented function _PyEval_GetCoroutineOriginTrackingDepth() from the C API. Call the public sys.get_coroutine_origin_tracking_depth() function instead. Patch by Victor Stinner.

  • bpo-46850: Remove the following private undocumented functions from the C API:

    • _PyEval_GetAsyncGenFirstiter()

    • _PyEval_GetAsyncGenFinalizer()

    • _PyEval_SetAsyncGenFirstiter()

    • _PyEval_SetAsyncGenFinalizer()

    Call the public sys.get_asyncgen_hooks() and sys.set_asyncgen_hooks() functions instead. Patch by Victor Stinner.

  • bpo-46987: Remove private functions _PySys_GetObjectId() and _PySys_SetObjectId(). Patch by Donghee Na.

  • bpo-46906: Add new functions to pack and unpack C double (serialize and deserialize): PyFloat_Pack2(), PyFloat_Pack4(), PyFloat_Pack8(), PyFloat_Unpack2(), PyFloat_Unpack4() and PyFloat_Unpack8(). Patch by Victor Stinner.

Python 3.11.0 alpha 6

Release date: 2022-03-07

Core and Builtins

  • bpo-46940: Avoid overriding AttributeError metadata information for nested attribute access calls. Patch by Pablo Galindo.

  • bpo-46927: Include the type’s name in the error message for subscripting non-generic types.

  • bpo-46921: Support vectorcall for super(). Patch by Ken Jin.

  • bpo-46841: Fix incorrect handling of inline cache entries when specializing BINARY_OP.

  • bpo-46841: Use an oparg to simplify the construction of helpful error messages in GET_AWAITABLE.

  • bpo-46903: Make sure that str subclasses can be used as attribute names for instances with virtual dictionaries. Fixes regression in 3.11alpha

  • bpo-46841: Add more detailed specialization failure stats for COMPARE_OP followed by EXTENDED_ARG.

  • bpo-46891: Fix bug introduced during 3.11alpha where subclasses of types.ModuleType with __slots__ were not initialized correctly, resulting in an interpreter crash.

  • bpo-46841: Use inline caching for LOAD_ATTR, LOAD_METHOD, and STORE_ATTR.

  • bpo-46841: Use inline cache for BINARY_SUBSCR.

  • bpo-46841: Use inline caching for COMPARE_OP.

  • bpo-46864: Deprecate PyBytesObject.ob_shash. It will be removed in Python 3.13.

  • bpo-46841: Use inline caching for UNPACK_SEQUENCE.

  • bpo-46845: Reduces dict size by removing hash value from hash table when all inserted keys are Unicode. For example, sys.getsizeof(dict.fromkeys("abcdefg")) becomes 272 bytes from 352 bytes on 64bit platform.

  • bpo-46841: Use inline cache for LOAD_GLOBAL.

  • bpo-46852: Rename the private undocumented float.__set_format__() method to float.__setformat__() to fix a typo introduced in Python 3.7. The method is only used by test_float. Patch by Victor Stinner.

  • bpo-46852: Remove the undocumented private float.__set_format__() method, previously known as float.__setformat__() in Python 3.7. Its docstring said: «You probably don’t want to use this function. It exists mainly to be used in Python’s test suite.» Patch by Victor Stinner.

  • bpo-40116: Fix regression that dict.update(other) may don’t respect iterate order of other when other is key sharing dict.

  • bpo-46712: Share global string identifiers in deep-frozen modules.

  • bpo-46430: Fix memory leak in interned strings of deep-frozen modules.

  • bpo-46841: Store BINARY_OP caches inline using a new CACHE instruction.

  • bpo-45107: Specialize LOAD_METHOD for instances with a dict.

  • bpo-44337: Reduce the memory usage of specialized LOAD_ATTR and STORE_ATTR instructions.

  • bpo-46729: Add number of sub-exceptions to BaseException.__str__().

  • bpo-45885: Don’t un-adapt COMPARE_OP when collecting specialization stats.

  • bpo-46329: Fix specialization stats gathering for PRECALL instructions.

  • bpo-46794: Bump up the libexpat version into 2.4.6

  • bpo-46823: Implement a specialized combined opcode LOAD_FAST__LOAD_ATTR_INSTANCE_VALUE. Patch by Dennis Sweeney.

  • bpo-46820: Fix parsing a numeric literal immediately (without spaces) followed by «not in» keywords, like in 1not in x. Now the parser only emits a warning, not a syntax error.

  • bpo-46329: Move KW_NAMES before PRECALL instruction in call sequence. Change operand of CALL to match PRECALL for easier specialization.

  • bpo-46808: Remove the NEXT_BLOCK macro from compile.c, and make the compiler automatically generate implicit blocks when they are needed.

  • bpo-46329: Add PUSH_NULL instruction. This is used as a prefix when evaluating a callable, so that the stack has the same shape for methods and other calls. PRECALL_FUNCTION and PRECALL_METHOD are merged into a single PRECALL instruction.

    There is no change in semantics.

  • bpo-46762: Fix an assert failure in debug builds when a “<”, “>”, or “=” is the last character in an f-string that’s missing a closing right brace.

  • bpo-46730: Message of AttributeError caused by getting, setting or deleting a property without the corresponding function now mentions that the attribute is in fact a property and also specifies type of the class that it belongs to.

  • bpo-46724: Make sure that all backwards jumps use the JUMP_ABSOLUTE instruction, rather than JUMP_FORWARD with an argument of (2**32)+offset.

  • bpo-46732: Correct the docstring for the __bool__() method. Patch by Jelle Zijlstra.

  • bpo-46072: Add more detailed specialization failure statistics for BINARY_OP.

  • bpo-46707: Avoid potential exponential backtracking when producing some syntax errors involving lots of brackets. Patch by Pablo Galindo.

  • bpo-46323: ctypes now allocates memory on the stack instead of on the heap to pass arguments while calling a Python callback function. Patch by Donghee Na.

  • bpo-45923: Add a quickened form of RESUME that skips quickening checks.

  • bpo-46702: Specialize UNPACK_SEQUENCE for tuple and list unpackings.

  • bpo-46072: Opcode pair stats are now gathered with --enable-pystats. Defining DYNAMIC_EXECUTION_PROFILE or DXPAIRS no longer has any effect.

  • bpo-46675: Allow more than 16 items in a split dict before it is combined. The limit is now 254.

  • bpo-40479: Add a missing call to va_end() in Modules/_hashopenssl.c.

  • bpo-46323: Use PyObject_Vectorcall() while calling ctypes callback function. Patch by Donghee Na.

  • bpo-46615: When iterating over sets internally in setobject.c, acquire strong references to the resulting items from the set. This prevents crashes in corner-cases of various set operations where the set gets mutated.

  • bpo-45828: The bytecode compiler now attempts to apply runtime stack manipulations at compile-time (whenever it is feasible to do so).

  • bpo-30496: Fixed a minor portability issue in the implementation of PyLong_FromLong(), and added a fast path for single-digit integers to PyLong_FromLongLong().

Library

Documentation

  • bpo-42238: Doc/tools/rstlint.py has moved to its own repository and is now packaged on PyPI as sphinx-lint.

Tests

  • bpo-46913: Fix test_faulthandler.test_sigfpe() if Python is built with undefined behavior sanitizer (UBSAN): disable UBSAN on the faulthandler_sigfpe() function. Patch by Victor Stinner.

  • bpo-46760: Remove bytecode offsets from expected values in test.test_dis module. Reduces the obstacles to modifying the VM or compiler.

  • bpo-46708: Prevent default asyncio event loop policy modification warning after test_asyncio execution.

  • bpo-46678: The function make_legacy_pyc in Lib/test/support/import_helper.py no longer fails when PYTHONPYCACHEPREFIX is set to a directory on a different device from where tempfiles are stored.

  • bpo-46623: Skip test_pair() and test_speech128() of test_zlib on s390x since they fail if zlib uses the s390x hardware accelerator. Patch by Victor Stinner.

Build

  • bpo-46860: Respect --with-suffix when building on case-insensitive file systems.

  • bpo-46656: Building Python now requires a C11 compiler. Optional C11 features are not required. Patch by Victor Stinner.

  • bpo-46656: Building Python now requires support for floating-point Not-a-Number (NaN): remove the Py_NO_NAN macro. Patch by Victor Stinner.

  • bpo-46640: Building Python now requires a C99 <math.h> header file providing a NAN constant, or the __builtin_nan() built-in function. Patch by Victor Stinner.

  • bpo-46608: Exclude marshalled-frozen data if deep-freezing to save 300 KB disk space. This includes adding a new is_package field to _frozen. Patch by Kumar Aditya.

  • bpo-40280: Fix wasm32-emscripten test failures and platform issues. - Disable syscalls that are not supported or don’t work, e.g. wait, getrusage, prlimit, mkfifo, mknod, setres[gu]id, setgroups. - Use fd_count to count open fds. - Add more checks for subprocess and fork. - Add workarounds for missing _multiprocessing and failing socket.accept(). - Enable bzip2. - Disable large file support. - Disable signal.alarm.

  • bpo-46430: Intern strings in deep-frozen modules. Patch by Kumar Aditya.

Windows

  • bpo-46744: The default all users install directory for ARM64 is now under the native Program Files folder, rather than Program Files (Arm) which is intended for ARM (32-bit) files.

  • bpo-46567: Adds Tcl and Tk support for Windows ARM64. This also adds IDLE to the installation.

  • bpo-46638: Ensures registry virtualization is consistently disabled. For 3.10 and earlier, it remains enabled (some registry writes are protected), while for 3.11 and later it is disabled (registry modifications affect all applications).

IDLE

  • bpo-46630: Make query dialogs on Windows start with a cursor in the entry box.

  • bpo-45447: Apply IDLE syntax highlighting to .pyi files. Patch by Alex Waygood and Terry Jan Reedy.

C API

  • bpo-46748: Python’s public headers no longer import <stdbool.h>, leaving code that embeds/extends Python free to define bool, true and false.

  • bpo-46836: Move the PyFrameObject type definition (struct _frame) to the internal C API pycore_frame.h header file. Patch by Victor Stinner.

  • bpo-45459: Rename Include/buffer.h header file to Include/pybuffer.h to avoid conflicts with projects having an existing buffer.h header file. Patch by Victor Stinner.

  • bpo-45412: Remove the HAVE_PY_SET_53BIT_PRECISION macro (moved to the internal C API). Patch by Victor Stinner.

  • bpo-46613: Added function PyType_GetModuleByDef(), which allows access to module state when a method’s defining class is not available.

Python 3.11.0 alpha 5

Release date: 2022-02-03

Core and Builtins

  • bpo-45773: Remove two invalid «peephole» optimizations from the bytecode compiler.

  • bpo-46564: Do not create frame objects when creating super object. Patch by Kumar Aditya.

  • bpo-45885: Added more fined-grained specialization failure stats regarding the COMPARE_OP bytecode.

  • bpo-44977: The delegation of int() to __trunc__() is now deprecated. Calling int(a) when type(a) implements __trunc__() but not __int__() or __index__() now raises a DeprecationWarning.

  • bpo-46458: Reorder code emitted by the compiler for a try-except block so that the else block’s code immediately follows the try body (without a jump). This is more optimal for the happy path.

  • bpo-46527: Allow passing iterable as a keyword argument to enumerate() again. Patch by Jelle Zijlstra.

  • bpo-46528: Replace several stack manipulation instructions (DUP_TOP, DUP_TOP_TWO, ROT_TWO, ROT_THREE, ROT_FOUR, and ROT_N) with new COPY and SWAP instructions.

  • bpo-46329: Use two or three bytecodes to implement most calls.

    Calls without named arguments are implemented as a sequence of two instructions: PRECALL; CALL. Calls with named arguments are implemented as a sequence of three instructions: PRECALL; KW_NAMES; CALL. There are two different PRECALL instructions: PRECALL_FUNTION and PRECALL_METHOD. The latter pairs with LOAD_METHOD.

    This partition into pre-call and call allows better specialization, and thus better performance ultimately.

    There is no change in semantics.

  • bpo-46503: Fix an assert when parsing some invalid N escape sequences in f-strings.

  • bpo-46431: Improve error message on invalid calls to BaseExceptionGroup.__new__().

  • bpo-46476: Fix memory leak in code objects generated by deepfreeze. Patch by Kumar Aditya.

  • bpo-46481: Speed up calls to weakref.ref.__call__() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-46417: Fix a race condition on setting a type __bases__ attribute: the internal function add_subclass() now gets the PyTypeObject.tp_subclasses member after calling PyWeakref_NewRef() which can trigger a garbage collection which can indirectly modify PyTypeObject.tp_subclasses. Patch by Victor Stinner.

  • bpo-46417: python -X showrefcount now shows the total reference count after clearing and destroyed the main Python interpreter. Previously, it was shown before. Patch by Victor Stinner.

  • bpo-43683: Add ASYNC_GEN_WRAP opcode to wrap the value to be yielded in async generators. Removes the need to special case async generators in the YIELD_VALUE instruction.

  • bpo-46407: Optimize some modulo operations in Objects/longobject.c. Patch by Jeremiah Vivian.

  • bpo-46409: Add new RETURN_GENERATOR bytecode to make generators. Simplifies calling Python functions in the VM, as they no longer any need to special case generator functions.

    Also add JUMP_NO_INTERRUPT bytecode that acts like JUMP_ABSOLUTE, but does not check for interrupts.

  • bpo-46406: The integer division // implementation has been optimized to better let the compiler understand its constraints. It can be 20% faster on the amd64 platform when dividing an int by a value smaller than 2**30.

  • bpo-46383: Fix invalid signature of _zoneinfo’s module_free function to resolve a crash on wasm32-emscripten platform.

  • bpo-46361: Ensure that «small» integers created by int.from_bytes() and decimal.Decimal are properly cached.

  • bpo-46161: Fix the class building error when the arguments are constants and CALL_FUNCTION_EX is used.

  • bpo-46028: Fixes calculation of sys._base_executable when inside a virtual environment that uses symlinks with different binary names than the base environment provides.

  • bpo-46091: Correctly calculate indentation levels for lines with whitespace character that are ended by line continuation characters. Patch by Pablo Galindo

  • bpo-30512: Add CAN Socket support for NetBSD.

  • bpo-46045: Do not use POSIX semaphores on NetBSD

  • bpo-44024: Improve the TypeError message for non-string second arguments passed to the built-in functions getattr() and hasattr(). Patch by Géry Ogam.

Library

Documentation

  • bpo-46463: Fixes escape4chm.py script used when building the CHM documentation file

Tests

  • bpo-43478: Mocks can no longer be provided as the specs for other Mocks. As a result, an already-mocked object cannot be passed to mock.Mock(). This can uncover bugs in tests since these Mock-derived Mocks will always pass certain tests (e.g. isinstance) and builtin assert functions (e.g. assert_called_once_with) will unconditionally pass.

  • bpo-46616: Ensures test_importlib.test_windows cleans up registry keys after completion.

  • bpo-44359: test_ftplib now silently ignores socket errors to prevent logging unhandled threading exceptions. Patch by Victor Stinner.

  • bpo-46600: Fix test_gdb.test_pycfunction() for Python built with clang -Og. Tolerate inlined functions in the gdb traceback. Patch by Victor Stinner.

  • bpo-46542: Fix a Python crash in test_lib2to3 when using Python built in debug mode: limit the recursion limit. Patch by Victor Stinner.

  • bpo-46576: test_peg_generator now disables compiler optimization when testing compilation of its own C extensions to significantly speed up the testing on non-debug builds of CPython.

  • bpo-46542: Fix test_json tests checking for RecursionError: modify these tests to use support.infinite_recursion(). Patch by Victor Stinner.

  • bpo-13886: Skip test_builtin PTY tests on non-ASCII characters if the readline module is loaded. The readline module changes input() behavior, but test_builtin is not intended to test the readline module. Patch by Victor Stinner.

  • bpo-40280: Add test.support.requires_fork() decorators to mark tests that require a working os.fork().

  • bpo-40280: Add test.support.requires_subprocess() decorator to mark tests which require working subprocess module or os.spawn*. The wasm32-emscripten platform has no support for processes.

  • bpo-46126: Disable “descriptions” when running tests internally.

Build

  • bpo-46602: Tidied up configure.ac so that conftest.c is truncated rather than appended. This assists in the case where the “rm” of conftest.c fails to happen between tests. Downstream issues such as a clobbered SOABI can result.

  • bpo-46600: Fix the test checking if the C compiler supports -Og option in the ./configure script to also use -Og on clang which supports it. Patch by Victor Stinner.

  • bpo-38472: Fix GCC detection in setup.py when cross-compiling. The C compiler is now run with LC_ALL=C. Previously, the detection failed with a German locale.

  • bpo-46513: configure no longer uses AC_C_CHAR_UNSIGNED macro and pyconfig.h no longer defines reserved symbol __CHAR_UNSIGNED__.

  • bpo-46471: Use global singletons for single byte bytes objects in deepfreeze.

  • bpo-46443: Deepfreeze now uses cached small integers as it saves some space for common small integers.

  • bpo-46429: Merge all deep-frozen files into one for space savings. Patch by Kumar Aditya.

  • bpo-45569: The build now defaults to using 30-bit digits for Python integers. Previously either 15-bit or 30-bit digits would be selected, depending on the platform. 15-bit digits may still be selected using the --enable-big-digits=15 option to the configure script, or by defining PYLONG_BITS_IN_DIGIT in pyconfig.h.

  • bpo-45925: Update Windows installer to use SQLite 3.37.2.

  • bpo-43112: Detect musl libc as a separate SOABI (tagged as linux-musl).

Windows

  • bpo-33125: The traditional EXE/MSI based installer for Windows is now available for ARM64

  • bpo-46362: os.path.abspath(«C:CON») is now fixed to return «\.CON», not the same path. The regression was true of all legacy DOS devices such as COM1, LPT1, or NUL.

  • bpo-44934: The installer now offers a command-line only option to add the installation directory to the end of PATH instead of at the start.

macOS

  • bpo-45925: Update macOS installer to SQLite 3.37.2.

IDLE

  • bpo-45296: Clarify close, quit, and exit in IDLE. In the File menu, “Close” and “Exit” are now “Close Window” (the current one) and “Exit” is now “Exit IDLE” (by closing all windows). In Shell, “quit()” and “exit()” mean “close Shell”. If there are no other windows, this also exits IDLE.

C API

  • bpo-40170: Remove the PyHeapType_GET_MEMBERS() macro. It was exposed in the public C API by mistake, it must only be used by Python internally. Use the PyTypeObject.tp_members member instead. Patch by Victor Stinner.

  • bpo-40170: Move _Py_GetAllocatedBlocks() and _PyObject_DebugMallocStats() private functions to the internal C API. Patch by Victor Stinner.

  • bpo-46433: The internal function _PyType_GetModuleByDef now correctly handles inheritance patterns involving static types.

  • bpo-45459: Py_buffer and various Py_buffer related functions are now part of the limited API and stable ABI.

  • bpo-14916: Fixed bug in the tokenizer that prevented PyRun_InteractiveOne from parsing from the provided FD.

Python 3.11.0 alpha 4

Release date: 2022-01-13

Core and Builtins

  • bpo-46070: Py_EndInterpreter() now explicitly untracks all objects currently tracked by the GC. Previously, if an object was used later by another interpreter, calling PyObject_GC_UnTrack() on the object crashed if the previous or the next object of the PyGC_Head structure became a dangling pointer. Patch by Victor Stinner.

  • bpo-46347: Fix memory leak in PyEval_EvalCodeEx.

  • bpo-46339: Fix a crash in the parser when retrieving the error text for multi-line f-strings expressions that do not start in the first line of the string. Patch by Pablo Galindo

  • bpo-46331: Do not set line number of instruction storing doc-string. Fixes regression introduced in 3.11 alpha.

  • bpo-46314: Remove spurious «call» event when creating a lambda function that was accidentally introduced in 3.11a4.

  • bpo-46289: ASDL declaration of FormattedValue has changed to reflect conversion field is not optional.

  • bpo-46297: Fixed an interpreter crash on bootup with multiple PythonPaths set in the Windows registry. Patch by Derzsi Dániel.

  • bpo-46237: Fix the line number of tokenizer errors inside f-strings. Patch by Pablo Galindo.

  • bpo-46263: We always expect the «use_frozen_modules» config to be set, now that getpath.c was rewritten in pure Python and the logic improved.

  • bpo-46006: Fix a regression when a type method like __init__() is modified in a subinterpreter. Fix a regression in _PyUnicode_EqualToASCIIId() and type update_slot(). Revert the change which made the Unicode dictionary of interned strings compatible with subinterpreters: the internal interned dictionary is shared again by all interpreters. Patch by Victor Stinner.

  • bpo-45923: Add RESUME opcode. This is a logical no-op. It is emitted by the compiler anywhere a Python function can be entered. It is used by the interpreter to perform tracing and optimizer checks.

  • bpo-46208: Fix the regression of os.path.normpath(«A/../../B») not returning expected «../B» but «B».

  • bpo-46240: Correct the error message for unclosed parentheses when the tokenizer doesn’t reach the end of the source when the error is reported. Patch by Pablo Galindo

  • bpo-46009: Remove the GEN_START opcode.

  • bpo-46235: Certain sequence multiplication operations like [0] * 1_000 are now faster due to reference-counting optimizations. Patch by Dennis Sweeney.

  • bpo-46221: PREP_RERAISE_STAR no longer pushes lasti to the stack.

  • bpo-46202: Remove POP_EXCEPT_AND_RERAISE and replace it by an equivalent sequence of other opcodes.

  • bpo-46085: Fix iterator cache mechanism of OrderedDict.

  • bpo-46055: Speed up shifting operation involving integers less than PyLong_BASE. Patch by Xinhang Xu.

  • bpo-46110: Add a maximum recursion check to the PEG parser to avoid stack overflow. Patch by Pablo Galindo

  • bpo-46107: Fix bug where ExceptionGroup.split() and ExceptionGroup.subgroup() did not copy the exception group’s __note__ field to the parts.

  • bpo-45711: The interpreter state’s representation of handled exceptions (a.k.a exc_info, or _PyErr_StackItem) now has only the exc_value field, exc_type and exc_traceback have been removed as their values can be derived from exc_value.

  • bpo-44525: Replace the four call bytecode instructions which one pre-call instruction and two call instructions.

    Removes CALL_FUNCTION, CALL_FUNCTION_KW, CALL_METHOD and CALL_METHOD_KW.

    Adds CALL_NO_KW and CALL_KW call instructions, and PRECALL_METHOD prefix for pairing with LOAD_METHOD.

  • bpo-46039: Remove the YIELD_FROM instruction and replace it with the SEND instruction which performs the same operation, but without the loop.

  • bpo-45635: The code called from _PyErr_Display() was refactored to improve error handling. It now exits immediately upon an unrecoverable error.

  • bpo-46054: Fix parser error when parsing non-utf8 characters in source files. Patch by Pablo Galindo.

  • bpo-46042: Improve the location of the caret in SyntaxError exceptions emitted by the symbol table. Patch by Pablo Galindo.

  • bpo-46049: Ensure ._pth files work as intended on platforms other than Windows.

  • bpo-46048: Fixes parsing of ._pth files on startup so that single-character paths are correctly read.

  • bpo-37971: Fix a bug where the line numbers given in a traceback when a decorator application raised an exception were wrong.

  • bpo-46031: Add POP_JUMP_IF_NOT_NONE and POP_JUMP_IF_NONE opcodes to speed up conditional jumps.

  • bpo-45654: Deepfreeze runpy, patch by Kumar Aditya.

  • bpo-46025: Fix a crash in the atexit module involving functions that unregister themselves before raising exceptions. Patch by Pablo Galindo.

  • bpo-46000: Improve compatibility of the curses module with NetBSD curses.

  • bpo-44525: Specialize the CALL_FUNCTION instruction for calls to builtin types with a single argument. Speeds up range(x), list(x), and specifically type(obj).

  • bpo-42918: Fix bug where the built-in compile() function did not always raise a SyntaxError when passed multiple statements in “single” mode. Patch by Weipeng Hong.

  • bpo-45953: The main interpreter in _PyRuntimeState.interpreters is now statically allocated (as part of _PyRuntime). Likewise for the initial thread state of each interpreter. This means less allocation during runtime init, as well as better memory locality for these key state objects.

  • bpo-45292: Complete the PEP 654 implementation: add except*.

  • bpo-43413: Revert changes in set.__init__. Subclass of set needs to define a __init__() method if it defines a __new__() method with additional keyword parameters.

  • bpo-43931: Added the Py_Version constant which bears the same value as PY_VERSION_HEX. Patch by Gabriele N. Tornetta.

Library

  • bpo-46342: The @typing.final decorator now sets the __final__ attribute on the decorated object to allow runtime introspection. Patch by Jelle Zijlstra.

  • bpo-46328: Added the sys.exception() method which returns the active exception instance.

  • bpo-46307: Add string.Template.is_valid() and string.Template.get_identifiers() methods.

  • bpo-46306: Assume that types.CodeType always has types.CodeType.co_firstlineno in doctest.

  • bpo-40479: Fix hashlib usedforsecurity option to work correctly with OpenSSL 3.0.0 in FIPS mode.

  • bpo-46070: Fix possible segfault when importing the asyncio module from different sub-interpreters in parallel. Patch by Erlend E. Aasland.

  • bpo-46244: Removed __slots__ from typing.ParamSpec and typing.TypeVar. They served no purpose. Patch by Arie Bovenberg.

  • bpo-46278: Reflect context argument in AbstractEventLoop.call_*() methods. Loop implementations already support it.

  • bpo-46269: Remove special-casing of __new__ in enum.Enum.__dir__().

  • bpo-46266: Improve day constants in calendar.

    Now all constants (MONDAY … SUNDAY) are documented, tested, and added to __all__.

  • bpo-46257: Optimized the mean, variance, and stdev functions in the statistics module. If the input is an iterator, it is consumed in a single pass rather than eating memory by conversion to a list. The single pass algorithm is about twice as fast as the previous two pass code.

  • bpo-41011: Added two new variables to pyvenv.cfg which is generated by venv module: executable for the executable and command for the command line used to create the environment.

  • bpo-46239: Improve error message when importing asyncio.windows_events on non-Windows.

  • bpo-46238: Reuse _winapi constants in asyncio.windows_events.

  • bpo-46222: Adding SF_NOCACHE sendfile constant for FreeBSD for the posixmodule.

  • bpo-37295: Add fast path for 0 <= k <= n <= 67 for math.comb().

  • bpo-46176: Adding the MAP_STACK constant for the mmap module.

  • bpo-43424: Deprecate webbrowser.MacOSXOSAScript._name and use name instead.

  • bpo-45321: Added missing error codes to module xml.parsers.expat.errors.

  • bpo-46125: Refactor tests to test traversable API directly. Includes changes from importlib 5.4.0.

  • bpo-46118: Moved importlib.resources and its related functionality to a package.

  • bpo-37578: Add include_hidden parameter to glob() and iglob() to match hidden files and directories when using special characters like *, **, ? and [].

  • bpo-20369: concurrent.futures.wait() no longer blocks forever when given duplicate Futures. Patch by Kumar Aditya.

  • bpo-46105: Honor spec when generating requirement specs with urls and extras (importlib_metadata 4.8.3).

  • bpo-44893: EntryPoint objects are no longer tuples. Recommended means to access is by attribute (“.name”, “.group”) or accessor (“.load()”). Access by index is deprecated and will raise deprecation warning.

  • bpo-22815: Print unexpected successes together with failures and errors in summary in unittest.TextTestResult.

  • bpo-22047: Calling add_argument_group() on an argument group is deprecated. Calling add_argument_group() or add_mutually_exclusive_group() on a mutually exclusive group is deprecated.

    These features were never supported and do not always work correctly. The functions exist on the API by accident through inheritance and will be removed in the future.

  • bpo-26952: argparse raises ValueError with clear message when trying to render usage for an empty mutually exclusive group. Previously it raised a cryptic IndexError.

  • bpo-45615: Functions in the traceback module raise TypeError rather than AttributeError when an exception argument is not of type BaseException.

  • bpo-16594: Add allow allow_reuse_port flag in socketserver.

  • bpo-27718: Fix help for the signal module. Some functions (e.g. signal() and getsignal()) were omitted.

  • bpo-46032: The registry() method of functools.singledispatch() functions checks now the first argument or the first parameter annotation and raises a TypeError if it is not supported. Previously unsupported «types» were ignored (e.g. typing.List[int]) or caused an error at calling time (e.g. list[int]).

  • bpo-46014: Add ability to use typing.Union and types.UnionType as dispatch argument to functools.singledispatch. Patch provided by Yurii Karabas.

  • bpo-27062: Add __all__ to inspect, patch by Kumar Aditya.

  • bpo-46018: Ensure that math.expm1() does not raise on underflow.

  • bpo-46016: Adding F_DUP2FD and F_DUP2FD_CLOEXEC constants from FreeBSD into the fcntl module.

  • bpo-45755: typing generic aliases now reveal the class attributes of the original generic class when passed to dir(). This was the behavior up to Python 3.6, but was changed in 3.7-3.9.

  • bpo-45874: The empty query string, consisting of no query arguments, is now handled correctly in urllib.parse.parse_qsl. This caused problems before when strict parsing was enabled.

  • bpo-44674: Change how dataclasses disallows mutable default values. It used to use a list of known types (list, dict, set). Now it disallows unhashable objects to be defaults. It’s using unhashability as a proxy for mutability. Patch by Eric V. Smith, idea by Raymond Hettinger.

  • bpo-23882: Remove namespace package (PEP 420) support from unittest discovery. It was introduced in Python 3.4 but has been broken since Python 3.7.

  • bpo-25066: Added a __repr__() method to multiprocessing.Event objects, patch by Kumar Aditya.

  • bpo-45643: Added signal.SIGSTKFLT on platforms where this signal is defined.

  • bpo-44092: Fetch across rollback no longer raises InterfaceError. Instead we leave it to the SQLite library to handle these cases. Patch by Erlend E. Aasland.

  • bpo-42413: Replace concurrent.futures.TimeoutError and asyncio.TimeoutError with builtin TimeoutError, keep these names as deprecated aliases.

Documentation

Tests

  • bpo-46296: Add a test case for enum with _use_args_ == True and _member_type_ == object.

  • bpo-46205: Fix hang in runtest_mp due to race condition

  • bpo-46263: Fix test_capi on FreeBSD 14-dev: instruct jemalloc to not fill freed memory with junk byte.

  • bpo-46262: Cover ValueError path in tests for enum.Flag._missing_().

  • bpo-46150: Now fakename in test_pathlib.PosixPathTest.test_expanduser is checked to be non-existent.

  • bpo-46129: Rewrite asyncio.locks tests with unittest.IsolatedAsyncioTestCase usage.

  • bpo-23819: Fixed asyncio tests in python optimized mode. Patch by Kumar Aditya.

  • bpo-46114: Fix test case for OpenSSL 3.0.1 version. OpenSSL 3.0 uses 0xMNN00PP0L.

Build

  • bpo-44133: When Python is configured with --without-static-libpython, the Python static library (libpython.a) is no longer built. Patch by Victor Stinner.

  • bpo-44133: When Python is built without --enable-shared, the python program is now linked to object files, rather than being linked to the Python static library (libpython.a), to make sure that all symbols are exported. Previously, the linker omitted some symbols like the Py_FrozenMain() function. Patch by Victor Stinner.

  • bpo-40280: The configure script has a new option --with-emscripten-target to select browser or node as Emscripten build target.

  • bpo-46315: Added and fixed #ifdef HAVE_FEATURE checks for functionality that is not available on WASI platform.

  • bpo-45723: Fixed a regression in configure check for select.epoll().

  • bpo-46263: configure no longer sets MULTIARCH on FreeBSD platforms.

  • bpo-46106: Updated OpenSSL to 1.1.1m in Windows builds, macOS installer builds, and CI. Patch by Kumar Aditya.

  • bpo-46088: Automatically detect or install bootstrap Python runtime when building from Visual Studio.

  • bpo-46072: Add a –with-pystats configure option to turn on internal statistics gathering.

  • bpo-40280: A new directory Tools/wasm contains WebAssembly-related helpers like config.site override for wasm32-emscripten, wasm assets generator to bundle the stdlib, and a README.

  • bpo-46023: makesetup no longer builds extensions that have been marked as disabled. This allows users to disable modules in Modules/Setup.local.

  • bpo-45949: Use pure Python freeze_module for all but importlib bootstrap files. --with-freeze-module configure option is no longer needed for cross builds.

Windows

  • bpo-46217: Removed parameter that is unsupported on Windows 8.1 and early Windows 10 and may have caused build or runtime failures.

macOS

  • bpo-40477: The Python Launcher app for macOS now properly launches scripts and, if necessary, the Terminal app when running on recent macOS releases.

C API

Python 3.11.0 alpha 3

Release date: 2021-12-08

Core and Builtins

  • bpo-46009: Restore behavior from 3.9 and earlier when sending non-None to newly started generator. In 3.9 this did not affect the state of the generator. In 3.10.0 and 3.10.1 gen_func().send(0) is equivalent to gen_func().throw(TypeError(...) which exhausts the generator. In 3.10.2 onward, the behavior has been reverted to that of 3.9.

  • bpo-46004: Fix the SyntaxError location for errors involving for loops with invalid targets. Patch by Pablo Galindo

  • bpo-45711: _PyErr_ChainStackItem() no longer normalizes exc_info (including setting the traceback on the exception instance) because exc_info is always normalized.

  • bpo-45607: The __note__ field was added to BaseException. It is None by default but can be set to a string which is added to the exception’s traceback.

  • bpo-45947: Place pointers to dict and values immediately before GC header. This reduces number of dependent memory loads to access either dict or values from 3 to 1.

  • bpo-45915: is_valid_fd now uses faster fcntl(fd, F_GETFD) on Linux, macOS, and Windows.

  • bpo-44530: Reverts a change to the code.__new__ audit event from an earlier prerelease.

  • bpo-42268: Fail the configure step if the selected compiler doesn’t support memory sanitizer. Patch by Pablo Galindo

  • bpo-45711: The three values of exc_info are now always consistent with each other. In particular, the type and traceback fields are now derived from the exception instance. This impacts the return values of sys.exc_info() and PyErr_GetExcInfo() if the exception instance is modified while the exception is handled, as well as PyErr_SetExcInfo(), which now ignores the type and traceback arguments provided to it.

  • bpo-45727: Refine the custom syntax error that suggests that a comma may be missing to trigger only when the expressions are detected between parentheses or brackets. Patch by Pablo Galindo

  • bpo-45885: Specialized the COMPARE_OP opcode using the PEP 659 machinery.

  • bpo-45786: Allocate space for the interpreter frame in the frame object, to avoid an additional allocation when the frame object outlives the frame activation.

  • bpo-45614: Fix traceback display for exceptions with invalid module name.

  • bpo-45813: Fix crash when calling coro.cr_frame.clear() after coroutine has been freed.

  • bpo-45811: Improve the tokenizer errors when encountering invisible control characters in the parser. Patch by Pablo Galindo

  • bpo-45848: Allow the parser to obtain error lines directly from encoded files. Patch by Pablo Galindo

  • bpo-45709: Restore behavior from 3.10 when tracing an exception raised within a with statement.

  • bpo-44525: Adds new COPY_FREE_VARS opcode, to make copying of free variables from function to frame explicit. Helps optimization of calls to Python function.

  • bpo-45829: Specialize BINARY_SUBSCR for classes with a __getitem__ method implemented in Python

  • bpo-45826: Fixed a crash when calling .with_traceback(None) on NameError. This occurs internally in unittest.TestCase.assertRaises().

  • bpo-45822: Fixed a bug in the parser that was causing it to not respect PEP 263 coding cookies when no flags are provided. Patch by Pablo Galindo

  • bpo-45820: Fix a segfault when the parser fails without reading any input. Patch by Pablo Galindo

  • bpo-45636: Simplify the implementation of BINARY_OP by indexing into an array of function pointers (rather than switching on the oparg).

  • bpo-42540: Fix crash when os.fork() is called with an active non-default memory allocator.

  • bpo-45738: Fix computation of error location for invalid continuation characters in the parser. Patch by Pablo Galindo.

  • bpo-45636: Remove an existing «fast path» for old-style string formatting, since it no longer appears to have any measurable impact.

  • bpo-45753: Make recursion checks a bit more efficient by tracking amount of calls left before overflow.

  • bpo-45773: Fix a compiler hang when attempting to optimize certain jump patterns.

  • bpo-45764: The parser now gives a better error message when leaving out the opening parenthesis ( after a def-statement:

    >>> def f:
  File "<stdin>", line 1
    def f:
         ^
SyntaxError: expected '('

  • bpo-45609: Specialized the STORE_SUBSCR opcode using the PEP 659 machinery.

  • bpo-45636: Replace all numeric BINARY_* and INPLACE_* instructions with a single BINARY_OP implementation.

  • bpo-45582: Path calculation (known as getpath) has been reimplemented as a frozen Python module. This should have no visible impact, but may affect calculation of all paths referenced in sys and sysconfig.

  • bpo-45450: Improve the syntax error message for parenthesized arguments. Patch by Pablo Galindo.

Library

  • bpo-27946: Fix possible crash when getting an attribute of xml.etree.ElementTree.Element simultaneously with replacing the attrib dict.

  • bpo-45711: Make asyncio normalize exceptions as soon as they are captured with PyErr_Fetch(), and before they are stored as an exc_info triplet. This brings asyncio in line with the rest of the codebase, where an exc_info triplet is always normalized.

  • bpo-23819: Replaced asserts with exceptions in asyncio, patch by Kumar Aditya.

  • bpo-13236: unittest.TextTestResult and unittest.TextTestRunner flush now the output stream more often.

  • bpo-45917: Added math.exp2():, which returns 2 raised to the power of x.

  • bpo-37658: Fix issue when on certain conditions asyncio.wait_for() may allow a coroutine to complete successfully, but fail to return the result, potentially causing memory leaks or other issues.

  • bpo-45876: Improve the accuracy of stdev() and pstdev() in the statistics module. When the inputs are floats or fractions, the output is a correctly rounded float

  • bpo-44649: Handle dataclass(slots=True) with a field that has default a default value, but for which init=False.

  • bpo-45803: Added missing kw_only parameter to dataclasses.make_dataclass().

  • bpo-45837: The turtle.RawTurtle.settiltangle() is deprecated since Python 3.1, it now emits a deprecation warning and will be removed in Python 3.13.

    Use turtle.RawTurtle.tiltangle() instead.

    turtle.RawTurtle.tiltangle() was earlier incorrectly marked as deprecated, its docstring has been corrected.

    Patch by Hugo van Kemenade.

  • bpo-45831: faulthandler can now write ASCII-only strings (like filenames and function names) with a single write() syscall when dumping a traceback. It reduces the risk of getting an unreadable dump when two threads or two processes dump a traceback to the same file (like stderr) at the same time. Patch by Victor Stinner.

  • bpo-45828: sqlite C callbacks now use unraisable exceptions if callback tracebacks are enabled. Patch by Erlend E. Aasland.

  • bpo-41735: Fix thread lock in zlib.Decompress.flush() method before PyObject_GetBuffer.

  • bpo-45235: Reverted an argparse bugfix that caused regression in the handling of default arguments for subparsers. This prevented leaf level arguments from taking precedence over root level arguments.

  • bpo-45754: Fix a regression in Python 3.11a1 and 3.11a2 where sqlite3 incorrectly would use SQLITE_LIMIT_LENGTH when checking SQL statement lengths. Now, SQLITE_LIMIT_SQL_LENGTH is used. Patch by Erlend E. Aasland.

  • bpo-45766: Added proportional option to statistics.linear_regression().

  • bpo-45765: In importlib.metadata, fix distribution discovery for an empty path.

  • bpo-45757: Fix bug where dis produced an incorrect oparg when EXTENDED_ARG is followed by an opcode that does not use its argument.

  • bpo-45644: In-place JSON file formatting using python3 -m json.tool infile infile now works correctly, previously it left the file empty. Patch by Chris Wesseling.

  • bpo-45703: When a namespace package is imported before another module from the same namespace is created/installed in a different sys.path location while the program is running, calling the importlib.invalidate_caches() function will now also guarantee the new module is noticed.

  • bpo-45535: Improve output of dir() with Enums.

  • bpo-45664: Fix types.resolve_bases() and types.new_class() for types.GenericAlias instance as a base.

  • bpo-45663: Fix dataclasses.is_dataclass() for dataclasses which are subclasses of types.GenericAlias.

  • bpo-45662: Fix the repr of dataclasses.InitVar with a type alias to the built-in class, e.g. InitVar[list[int]].

  • bpo-43137: Launch GNOME web browsers via gio tool instead of obsolete gvfs-open

  • bpo-45429: On Windows, time.sleep() now uses a waitable timer which supports high-resolution timers. Patch by Donghee Na and Eryk Sun.

  • bpo-37295: Optimize math.comb() and math.perm().

  • bpo-45514: Deprecated legacy functions in importlib.resources.

  • bpo-45507: Add tests for truncated/missing trailers in gzip.decompress implementation.

  • bpo-45359: Implement PEP 585 for graphlib.TopologicalSorter.

  • bpo-44733: Add max_tasks_per_child to concurrent.futures.ProcessPoolExecutor. This allows users to specify the maximum number of tasks a single process should execute before the process needs to be restarted.

  • bpo-28806: Improve netrc library. netrc file no longer needs to contain all tokens. And if the login name is anonymous, security check is no longer need.

  • bpo-43498: Avoid a possible «RuntimeError: dictionary changed size during iteration» when adjusting the process count of ProcessPoolExecutor.

  • bpo-42158: Add MIME types for N-quads, N-triples, Notation3 and TriG to mimetypes.

  • bpo-30533: Add inspect.getmembers_static() , it return all members without triggering dynamic lookup via the descriptor protocol. Patch by Weipeng Hong.

Documentation

  • bpo-42238: make -C Doc suspicious will be removed soon in favor of make -C Doc check, mark it as deprecated.

  • bpo-45840: Improve cross-references in the documentation for the data model.

  • bpo-45640: Properly marked-up grammar tokens in the documentation are now clickable and take you to the definition of a given piece of grammar. Patch by Arthur Milchior.

  • bpo-45788: Link doc for sys.prefix to sysconfig doc on installation paths.

  • bpo-45772: socket.socket documentation is corrected to a class from a function.

  • bpo-45392: Update the docstring of the type built-in to remove a redundant line and to mention keyword arguments for the constructor.

  • bpo-45250: Update the documentation to note that CPython does not consistently require iterators to define __iter__.

  • bpo-25381: In the extending chapter of the extending doc, update a paragraph about the global variables containing exception information.

  • bpo-43905: Expanded astuple() and asdict() docs, warning about deepcopy being applied and providing a workaround.

Tests

  • bpo-45695: Out-of-tree builds with a read-only source directory are now tested by CI.

  • bpo-19460: Add new Test for Lib/email/mime/nonmultipart.py::MIMENonMultipart.

  • bpo-45835: Fix race condition in test_queue tests with multiple «feeder» threads.

  • bpo-45783: The test for the freeze tool now handles file moves and deletions.

  • bpo-45745: Remove the --findleaks command line option of regrtest: use the --fail-env-changed option instead. Since Python 3.7, it was a deprecated alias to the --fail-env-changed option.

  • bpo-45701: Add tests with tuple type with functools.lru_cache() to test_functools.

Build

  • bpo-44035: CI now verifies that autoconf files have been regenerated with a current and unpatched autoconf package.

  • bpo-45950: The build system now uses a _bootstrap_python interpreter for freezing and deepfreezing again. To speed up build process the build tools _bootstrap_python and _freeze_module are no longer build with LTO.

  • bpo-45881: The configure script now accepts --with-build-python and --with-freeze-module options to make cross compiling easier.

  • bpo-40280: Emscripten platform now uses .wasm suffix by default.

  • bpo-40280: Disable unusable core extension modules on WASM/Emscripten targets.

  • bpo-40280: configure now checks for socket shutdown function. The check makes it possible to disable SYS_shutdown with ac_cv_func_shutdown=no in CONFIG_SITE.

  • bpo-40280: configure now checks for functions fork1, getegid, geteuid, getgid, getppid, getuid, opendir, pipe, system, wait, ttyname.

  • bpo-33393: Update config.guess to 2021-06-03 and config.sub to 2021-08-14. Makefile now has an update-config target to make updating more convenient.

  • bpo-45866: make regen-all now produces the same output when run from a directory other than the source tree: when building Python out of the source tree. pegen now strips directory of the «generated by pygen from <FILENAME>» header Patch by Victor Stinner.

  • bpo-40280: configure now accepts machine wasm32 or wasm64 and OS wasi or emscripten for cross building, e.g. wasm32-unknown-emscripten, wasm32-wasi, or wasm32-unknown-wasi.

  • bpo-41498: Python now compiles on platforms without sigset_t. Several functions in signal are not available when sigset_t is missing.

    Based on patch by Roman Yurchak for pyodide.

  • bpo-45881: setup.py now uses CC from environment first to discover multiarch and cross compile paths.

  • bpo-45886: The _freeze_module program path can now be overridden on the command line, e.g. make FREEZE_MODULE=../x86_64/Program/_freeze_module.

  • bpo-45873: Get rid of the _bootstrap_python build step. The deepfreeze.py script is now run using $(PYTHON_FOR_REGEN) which can be Python 3.7 or newer (on Windows, 3.8 or newer).

  • bpo-45847: Port builtin hashlib extensions to PY_STDLIB_MOD macro and addext().

  • bpo-45723: Add autoconf helpers for saving and restoring environment variables:

    • SAVE_ENV: Save $CFLAGS, $LDFLAGS, $LIBS, and $CPPFLAGS.

    • RESTORE_ENV: Restore $CFLAGS, $LDFLAGS, $LIBS, and $CPPFLAGS.

    • WITH_SAVE_ENV([SCRIPT]): Run SCRIPT wrapped with SAVE_ENV and RESTORE_ENV.

    Patch by Erlend E. Aasland.

  • bpo-45573: Mandatory core modules, that are required to bootstrap Python, are now in Modules/Setup.bootstrap.

  • bpo-45573: configure now creates Modules/Setup.stdlib with conditionally enabled/disabled extension module lines. The file is not used, yet.

  • bpo-45573: configure now uses a unified format to set state, compiler flags, and linker flags in Makefile. The new macro PY_STDLIB_MOD sets three variables that are consumed by Modules/Setup and setup.py.

  • bpo-45816: Python now supports building with Visual Studio 2022 (MSVC v143, VS Version 17.0). Patch by Jeremiah Vivian.

  • bpo-45800: Settings for pyexpat C extension are now detected by configure. The bundled expat library is built in Makefile.

  • bpo-45798: Settings for decimal internal C extension are now detected by configure. The bundled libmpdec library is built in Makefile.

  • bpo-45723: configure has a new option --with-pkg-config to disable or require pkg-config.

  • bpo-45774: The build dependencies for sqlite3 are now detected by configure and pkg-config. Patch by Erlend E. Aasland.

  • bpo-45763: The build dependencies for zlib, bz2, and lzma are now detected by configure.

  • bpo-45747: gdbm and dbm build dependencies are now detected by configure.

  • bpo-45743: On macOS, the build system no longer passes search_paths_first to the linker. The flag has been the default since Xcode 4 / macOS 10.6.

  • bpo-45723: configure.ac is now compatible with autoconf 2.71. Deprecated checks STDC_HEADERS and AC_HEADER_TIME have been removed.

  • bpo-45723: configure now prints a warning when pkg-config is missing.

  • bpo-45731: configure --enable-loadable-sqlite-extensions is now handled by new PY_SQLITE_ENABLE_LOAD_EXTENSION macro instead of logic in setup.py.

  • bpo-45723: configure.ac now uses custom helper macros and AC_CACHE_CHECK to simplify and speed up configure runs.

  • bpo-45696: Skip the marshal step for frozen modules by generating C code that produces a set of ready-to-use code objects. This speeds up startup time by another 10% or more.

  • bpo-45561: Run smelly.py tool from $(srcdir).

Windows

  • bpo-46105: Fixed calculation of sys.path in a venv on Windows.

  • bpo-45901: When installed through the Microsoft Store and set as the default app for *.py files, command line arguments will now be passed to Python when invoking a script without explicitly launching Python (that is, script.py args rather than python script.py args).

  • bpo-45616: Fix Python Launcher’s ability to distinguish between versions 3.1 and 3.10 when either one is explicitly requested. Previously, 3.1 would be used if 3.10 was requested but not installed, and 3.10 would be used if 3.1 was requested but 3.10 was installed.

  • bpo-45850: Implement changes to build with deep-frozen modules on Windows. Note that we now require Python 3.10 as the «bootstrap» or «host» Python.

  • bpo-45732: Updates bundled Tcl/Tk to 8.6.12.

  • bpo-45720: Internal reference to shlwapi.dll was dropped to help improve startup time. This DLL will no longer be loaded at the start of every Python process.

macOS

  • bpo-45732: Update python.org macOS installer to use Tcl/Tk 8.6.12.

C API

  • bpo-39026: Fix Python.h to build C extensions with Xcode: remove a relative include from Include/cpython/pystate.h.

Python 3.11.0 alpha 2

Release date: 2021-11-05

Core and Builtins

  • bpo-45716: Improve the SyntaxError message when using True, None or False as keywords in a function call. Patch by Pablo Galindo.

  • bpo-45688: sys.stdlib_module_names now contains the macOS-specific module _scproxy.

  • bpo-45379: Clarify ImportError message when we try to explicitly import a frozen module but frozen modules are disabled.

  • bpo-44525: Specialize simple calls to Python functions (no starargs, keyword dict, or closure)

  • bpo-45530: Cases of sorting using tuples as keys may now be significantly faster in some cases. Patch by Tim Peters.

    The order of the result may differ from earlier releases if the tuple elements don’t define a total ordering (see Comparaciones de valor for information on total ordering). It’s generally true that the result of sorting simply isn’t well-defined in the absence of a total ordering on list elements.

  • bpo-45526: In obmalloc, set ADDRESS_BITS to not ignore any bits (ignored 16 before). That is safer in the case that the kernel gives user-space virtual addresses that span a range greater than 48 bits.

  • bpo-30570: Fixed a crash in issubclass() from infinite recursion when searching pathological __bases__ tuples.

  • bpo-45521: Fix a bug in the obmalloc radix tree code. On 64-bit machines, the bug causes the tree to hold 46-bits of virtual addresses, rather than the intended 48-bits.

  • bpo-45494: Fix parser crash when reporting errors involving invalid continuation characters. Patch by Pablo Galindo.

  • bpo-45445: Python now fails to initialize if it finds an invalid -X option in the command line. Patch by Pablo Galindo.

  • bpo-45340: Object attributes are held in an array instead of a dictionary. An object’s dictionary are created lazily, only when needed. Reduces the memory consumption of a typical Python object by about 30%. Patch by Mark Shannon.

  • bpo-45408: Fix a crash in the parser when reporting tokenizer errors that occur at the same time unclosed parentheses are detected. Patch by Pablo Galindo.

  • bpo-29410: Add SipHash13 for string hash algorithm and use it by default.

  • bpo-45385: Fix reference leak from descr_check. Patch by Donghee Na.

  • bpo-45367: Specialized the BINARY_MULTIPLY opcode to BINARY_MULTIPLY_INT and BINARY_MULTIPLY_FLOAT using the PEP 659 machinery.

  • bpo-21736: Frozen stdlib modules now have __file__ to the .py file they would otherwise be loaded from, if possible. For packages, __path__ now has the correct entry instead of being an empty list, which allows unfrozen submodules to be imported. These are set only if the stdlib directory is known when the runtime is initialized. Note that the file at __file__ is not guaranteed to exist. None of this affects non-stdlib frozen modules nor, for now, frozen modules imported using PyImport_ImportFrozenModule(). Also, at the moment co_filename is not updated for the module.

  • bpo-45020: For frozen stdlib modules, record the original module name as module.__spec__.loader_state.origname. If the value is different than module.__spec__.name then the module was defined as an alias in Tools/scripts/freeze_modules.py. If it is None then the module comes from a source file outside the stdlib.

  • bpo-45324: In FrozenImporter.find_spec(), we now preserve the information needed in exec_module() to load the module. This change mostly impacts internal details, rather than changing the importer’s behavior.

  • bpo-45292: Implement PEP 654. Add ExceptionGroup and BaseExceptionGroup. Update traceback display code.

  • bpo-40116: Change to the implementation of split dictionaries. Classes where the instances differ either in the exact set of attributes, or in the order in which those attributes are set, can still share keys. This should have no observable effect on users of Python or the C-API. Patch by Mark Shannon.

  • bpo-44050: Extensions that indicate they use global state (by setting m_size to -1) can again be used in multiple interpreters. This reverts to behavior of Python 3.8.

  • bpo-44525: Setup initial specialization infrastructure for the CALL_FUNCTION opcode. Implemented initial specializations for C function calls:

    • CALL_FUNCTION_BUILTIN_O for METH_O flag.

    • CALL_FUNCTION_BUILTIN_FAST for METH_FASTCALL flag without keywords.

    • CALL_FUNCTION_LEN for len(o).

    • CALL_FUNCTION_ISINSTANCE for isinstance(o, t).

  • bpo-44511: Improve the generated bytecode for class and mapping patterns.

  • bpo-43706: Speed up calls to enumerate() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

Library

  • bpo-45679: Fix caching of multi-value typing.Literal. Literal[True, 2] is no longer equal to Literal[1, 2].

  • bpo-42064: Convert sqlite3 to multi-phase initialisation (PEP 489). Patches by Erlend E. Aasland.

  • bpo-45438: Fix typing.Signature string representation for generic builtin types.

  • bpo-45613: sqlite3 now sets sqlite3.threadsafety based on the default threading mode the underlying SQLite library has been compiled with. Patch by Erlend E. Aasland.

  • bpo-45574: Fix warning about print_escape being unused.

  • bpo-45581: sqlite3.connect() now correctly raises MemoryError if the underlying SQLite API signals memory error. Patch by Erlend E. Aasland.

  • bpo-45557: pprint.pprint() now handles underscore_numbers correctly. Previously it was always setting it to False.

  • bpo-44019: Add operator.call() to operator.__all__. Patch by Kreusada.

  • bpo-42174: shutil.get_terminal_size() now falls back to sane values if the column or line count are 0.

  • bpo-35673: Improve the introspectability of the __loader__ attribute for namespace packages. importlib.machinery.NamespaceLoader is now public, and implements the importlib.abc.InspectLoader interface. _NamespaceLoader is kept for backward compatibility.

  • bpo-45515: Add references to zoneinfo in the datetime documentation, mostly replacing outdated references to dateutil.tz. Change by Paul Ganssle.

  • bpo-45475: Reverted optimization of iterating gzip.GzipFile, bz2.BZ2File, and lzma.LZMAFile (see bpo-43787) because it caused regression when user iterate them without having reference of them. Patch by Inada Naoki.

  • bpo-45489: Update ForwardRef to support | operator. Patch by Donghee Na.

  • bpo-42222: Removed deprecated support for float arguments in randrange().

  • bpo-45428: Fix a regression in py_compile when reading filenames from standard input.

  • bpo-45467: Fix incremental decoder and stream reader in the «raw-unicode-escape» codec. Previously they failed if the escape sequence was split.

  • bpo-45461: Fix incremental decoder and stream reader in the «unicode-escape» codec. Previously they failed if the escape sequence was split.

  • bpo-45239: Fixed email.utils.parsedate_tz() crashing with UnboundLocalError on certain invalid input instead of returning None. Patch by Ben Hoyt.

  • bpo-45417: Fix quadratic behaviour in the enum module: Creation of enum classes with a lot of entries was quadratic.

  • bpo-45249: Fix the behaviour of traceback.print_exc() when displaying the caret when the end_offset in the exception is set to 0. Patch by Pablo Galindo

  • bpo-45416: Fix use of asyncio.Condition with explicit asyncio.Lock objects, which was a regression due to removal of explicit loop arguments. Patch by Joongi Kim.

  • bpo-20028: Empty escapechar/quotechar is not allowed when initializing csv.Dialect. Patch by Vajrasky Kok and Donghee Na.

  • bpo-44904: Fix bug in the doctest module that caused it to fail if a docstring included an example with a classmethod property. Patch by Alex Waygood.

  • bpo-45406: Make inspect.getmodule() catch FileNotFoundError raised by inspect.getabsfile(), and return None to indicate that the module could not be determined.

  • bpo-45411: Add extensions for files containing subtitles - .srt & .vtt - to the mimetypes.py module.

  • bpo-10716: Migrated pydoc to HTML5 (without changing the look of it). Side effect is to update xmlrpc’s ServerHTMLDoc which now uses the CSS too. cgitb now relies less on pydoc (as it can’t use the CSS file).

  • bpo-27580: Add support of null characters in csv.

  • bpo-45262: Prevent use-after-free in asyncio. Make sure the cached running loop holder gets cleared on dealloc to prevent use-after-free in get_running_loop

  • bpo-45386: Make xmlrpc.client more robust to C runtimes where the underlying C strftime function results in a ValueError when testing for year formatting options.

  • bpo-20028: Improve error message of csv.Dialect when initializing. Patch by Vajrasky Kok and Donghee Na.

  • bpo-45343: Update bundled pip to 21.2.4 and setuptools to 58.1.0

  • bpo-45328: Fixed http.client.HTTPConnection to work properly in OSs that don’t support the TCP_NODELAY socket option.

  • bpo-45243: Add setlimit() and getlimit() to sqlite3.Connection for setting and getting SQLite limits by connection basis. Patch by Erlend E. Aasland.

  • bpo-45320: Removed from the inspect module:

    Patch by Hugo van Kemenade.

  • bpo-45192: Fix the tempfile._infer_return_type function so that the dir argument of the tempfile functions accepts an object implementing the os.PathLike protocol.

    Patch by Kyungmin Lee.

  • bpo-45160: When tracing a tkinter variable used by a ttk OptionMenu, callbacks are no longer made twice.

  • bpo-25625: Added non parallel-safe chdir() context manager to change the current working directory and then restore it on exit. Simple wrapper around chdir().

  • bpo-24139: Add support for SQLite extended result codes in sqlite3.Error. Patch by Erlend E. Aasland.

  • bpo-24444: Fixed an error raised in argparse help display when help for an option is set to 1+ blank spaces or when choices arg is an empty container.

  • bpo-44547: Implement Fraction.__int__, so that a fractions.Fraction instance f passes an isinstance(f, typing.SupportsInt) check.

  • bpo-40321: Adds support for HTTP 308 redirects to urllib. See RFC 7538 for details. Patch by Jochem Schulenklopper.

  • bpo-41374: Ensure that socket.TCP_* constants are exposed on Cygwin 3.1.6 and greater.

  • bpo-35970: Add help flag to the base64 module’s command line interface. Patch contributed by Robert Kuska.

Documentation

Tests

  • bpo-45678: Add tests for scenarios in which functools.singledispatchmethod is stacked on top of a method that has already been wrapped by two other decorators. Patch by Alex Waygood.

  • bpo-45578: Add tests for dis.distb()

  • bpo-45678: Add tests to ensure that functools.singledispatchmethod correctly wraps the attributes of the target function.

  • bpo-45668: PGO tests now pass when Python is built without test extension modules.

  • bpo-45577: Add subtests for all pickle protocols in test_zoneinfo.

  • bpo-45566: Fix test_frozen_pickle in test_dataclasses to check all pickle versions.

  • bpo-43592: test.libregrtest now raises the soft resource limit for the maximum number of file descriptors when the default is too low for our test suite as was often the case on macOS.

  • bpo-39679: Add more test cases for @functools.singledispatchmethod when combined with @classmethod or @staticmethod.

  • bpo-45410: When libregrtest spawns a worker process, stderr is now written into stdout to keep messages order. Use a single pipe for stdout and stderr, rather than two pipes. Previously, messages were out of order which made analysis of buildbot logs harder Patch by Victor Stinner.

  • bpo-45402: Fix test_tools.test_sundry() when Python is built out of tree: fix how the freeze_modules.py tool locates the _freeze_module program. Patch by Victor Stinner.

  • bpo-45403: Fix test_sys.test_stdlib_dir() when Python is built outside the source tree: compare normalized paths. Patch by Victor Stinner.

  • bpo-45400: Fix test_name_error_suggestions_do_not_trigger_for_too_many_locals() of test_exceptions if a directory name contains «a1» (like «Python-3.11.0a1»): use a stricter regular expression. Patch by Victor Stinner.

  • bpo-10572: Rename sqlite3 tests from test_sqlite to test_sqlite3, and relocate them to Lib/test/test_sqlite3. Patch by Erlend E. Aasland.

Build

  • bpo-43158: setup.py now uses values from configure script to build the _uuid extension module. Configure now detects util-linux’s libuuid, too.

  • bpo-45666: Fix warning of swprintf and %s usage in _testembed.c

  • bpo-45548: Modules/Setup and Modules/makesetup have been improved. The Setup file now contains working rules for all extensions. Outdated comments have been removed. Rules defined by makesetup track dependencies correctly.

  • bpo-45548: The math and cmath implementation now require a C99 compatible libm and no longer ship with workarounds for missing acosh, asinh, atanh, expm1, and log1p functions.

  • bpo-45595: setup.py and makesetup now track build dependencies on all Python header files and module specific header files.

  • bpo-45571: Modules/Setup now use PY_CFLAGS_NODIST instead of PY_CFLAGS to compile shared modules.

  • bpo-45570: pyexpat and _elementtree no longer define obsolete macros HAVE_EXPAT_CONFIG_H and USE_PYEXPAT_CAPI. XML_POOR_ENTROPY is now defined in expat_config.h.

  • bpo-43974: setup.py no longer defines Py_BUILD_CORE_MODULE. Instead every module, that uses the internal API, defines the macro.

  • bpo-45548: Fill in missing entries in Modules/Setup.

  • bpo-45532: Update sys.version to use main as fallback information. Patch by Jeong YunWon.

  • bpo-45536: The configure script now checks whether OpenSSL headers and libraries provide required APIs. Most common APIs are verified. The check detects outdated or missing OpenSSL. Failures do not stop configure.

  • bpo-45221: Fixed regression in handling of LDFLAGS and CPPFLAGS options where argparse.parse_known_args() could interpret an option as one of the built-in command line argument, for example -h for help.

  • bpo-45440: Building Python now requires a C99 <math.h> header file providing the following functions: copysign(), hypot(), isfinite(), isinf(), isnan(), round(). Patch by Victor Stinner.

  • bpo-45405: Prevent internal configure error when running configure with recent versions of non-Apple clang. Patch by David Bohman.

  • bpo-45433: Avoid linking libpython with libcrypt.

Windows

  • bpo-43652: Update Tcl/Tk to 8.6.11, actually this time. The previous update incorrectly included 8.6.10.

  • bpo-45337: venv now warns when the created environment may need to be accessed at a different path, due to redirections, links or junctions. It also now correctly installs or upgrades components when the alternate path is required.

  • bpo-43851: Build SQLite SQLITE_OMIT_AUTOINIT on Windows. Patch by Erlend E. Aasland.

macOS

  • bpo-44828: Avoid tkinter file dialog failure on macOS 12 Monterey when using the Tk 8.6.11 provided by python.org macOS installers. Patch by Marc Culler of the Tk project.

IDLE

  • bpo-45495: Add context keywords “case” and “match” to completions list.

C API

  • bpo-29103: PyType_FromSpec* now copies the class name from the spec to a buffer owned by the class, so the original can be safely deallocated. Patch by Petr Viktorin.

  • bpo-45522: The internal freelists for frame, float, list, dict, async generators, and context objects can now be disabled.

  • bpo-35134: Exclude PyWeakref_GET_OBJECT() from the limited C API. It never worked since the PyWeakReference structure is opaque in the limited C API.

  • bpo-35081: Move the interpreteridobject.h header file from Include/ to Include/internal/. It only provides private functions. Patch by Victor Stinner.

  • bpo-35134: The non-limited API files cellobject.h, classobject.h, context.h, funcobject.h, genobject.h and longintrepr.h have been moved to the Include/cpython directory. Moreover, the eval.h header file was removed. These files must not be included directly, as they are already included in Python.h: Include Files. If they have been included directly, consider including Python.h instead. Patch by Victor Stinner.

  • bpo-45474: The following items are no longer available when Py_LIMITED_API is defined:

    These are not part of the limited API.

    Patch by Victor Stinner.

  • bpo-45434: Remove the pystrhex.h header file. It only contains private functions. C extensions should only include the main <Python.h> header file. Patch by Victor Stinner.

  • bpo-45440: Remove the Py_FORCE_DOUBLE() macro. It was used by the Py_IS_INFINITY() macro. Patch by Victor Stinner.

  • bpo-45434: <Python.h> no longer includes the header files <stdlib.h>, <stdio.h>, <errno.h> and <string.h> when the Py_LIMITED_API macro is set to 0x030b0000 (Python 3.11) or higher. C extensions should explicitly include the header files after #include <Python.h>. Patch by Victor Stinner.

  • bpo-41123: Remove Py_UNICODE_COPY() and Py_UNICODE_FILL() macros, deprecated since Python 3.3. Use PyUnicode_CopyCharacters() or memcpy() (wchar_t* string), and PyUnicode_Fill() functions instead. Patch by Victor Stinner.

  • bpo-45412: Remove the following math macros using the errno variable:

    • Py_ADJUST_ERANGE1()

    • Py_ADJUST_ERANGE2()

    • Py_OVERFLOWED()

    • Py_SET_ERANGE_IF_OVERFLOW()

    • Py_SET_ERRNO_ON_MATH_ERROR()

    Patch by Victor Stinner.

  • bpo-45395: Custom frozen modules (the array set to PyImport_FrozenModules) are now treated as additions, rather than replacing all the default frozen modules. Frozen stdlib modules can still be disabled by setting the «code» field of the custom array entry to NULL.

  • bpo-43760: Add new PyThreadState_EnterTracing(), and PyThreadState_LeaveTracing() functions to the limited C API to suspend and resume tracing and profiling. Patch by Victor Stinner.

  • bpo-44220: PyStructSequence_UnnamedField is added to the Stable ABI.

Python 3.11.0 alpha 1

Release date: 2021-10-05

Security

  • bpo-42278: Replaced usage of tempfile.mktemp() with TemporaryDirectory to avoid a potential race condition.

  • bpo-44600: Fix incorrect line numbers while tracing some failed patterns in match statements. Patch by Charles Burkland.

  • bpo-41180: Add auditing events to the marshal module, and stop raising code.__init__ events for every unmarshalled code object. Directly instantiated code objects will continue to raise an event, and audit event handlers should inspect or collect the raw marshal data. This reduces a significant performance overhead when loading from .pyc files.

  • bpo-44394: Update the vendored copy of libexpat to 2.4.1 (from 2.2.8) to get the fix for the CVE 2013-0340 «Billion Laughs» vulnerability. This copy is most used on Windows and macOS.

  • bpo-43124: Made the internal putcmd function in smtplib sanitize input for presence of \r and \n characters to avoid (unlikely) command injection.

  • bpo-44022: http.client now avoids infinitely reading potential HTTP headers after a 100 Continue status response from the server.

Core and Builtins

  • bpo-43760: The number of hardware branches per instruction dispatch is reduced from two to one by adding a special instruction for tracing. Patch by Mark Shannon.

  • bpo-45061: Add a deallocator to the bool type to detect refcount bugs in C extensions which call Py_DECREF(Py_True) or Py_DECREF(Py_False) by mistake. Detect also refcount bugs when the empty tuple singleton or the Unicode empty string singleton is destroyed by mistake. Patch by Victor Stinner.

  • bpo-24076: sum() was further optimised for summing up single digit integers.

  • bpo-45190: Update Unicode databases to Unicode 14.0.0.

  • bpo-45167: Fix deepcopying of types.GenericAlias objects.

  • bpo-45155: int.to_bytes() and int.from_bytes() now take a default value of "big" for the byteorder argument. int.to_bytes() also takes a default value of 1 for the length argument.

  • bpo-44219: Release the GIL while performing isatty system calls on arbitrary file descriptors. In particular, this affects os.isatty(), os.device_encoding() and io.TextIOWrapper. By extension, io.open() in text mode is also affected. This change solves a deadlock in os.isatty(). Patch by Vincent Michel in bpo-44219.

  • bpo-44959: Added fallback to extension modules with “.sl” suffix on HP-UX

  • bpo-45121: Fix issue where Protocol.__init__ raises RecursionError when it’s called directly or via super(). Patch provided by Yurii Karabas.

  • bpo-44348: The deallocator function of the BaseException type now uses the trashcan mechanism to prevent stack overflow. For example, when a RecursionError instance is raised, it can be linked to another RecursionError through the __context__ attribute or the __traceback__ attribute, and then a chain of exceptions is created. When the chain is destroyed, nested deallocator function calls can crash with a stack overflow if the chain is too long compared to the available stack memory. Patch by Victor Stinner.

  • bpo-45123: Fix PyAiter_Check to only check for the __anext__ presence (not for __aiter__). Rename PyAiter_Check to PyAIter_Check, PyObject_GetAiter -> PyObject_GetAIter.

  • bpo-1514420: Interpreter no longer attempts to open files with names in angle brackets (like «<string>» or «<stdin>») when formatting an exception.

  • bpo-41031: Match C and Python code formatting of unprintable exceptions and exceptions in the __main__ module.

  • bpo-37330: open(), io.open(), codecs.open() and fileinput.FileInput no longer accept 'U' («universal newline») in the file mode. This flag was deprecated since Python 3.3. Patch by Victor Stinner.

  • bpo-45083: When the interpreter renders an exception, its name now has a complete qualname. Previously only the class name was concatenated to the module name, which sometimes resulted in an incorrect full name being displayed.

    (This issue impacted only the C code exception rendering, the traceback module was using qualname already).

  • bpo-34561: List sorting now uses the merge-ordering strategy from Munro and Wild’s powersort(). Unlike the former strategy, this is provably near-optimal in the entropy of the distribution of run lengths. Most uses of list.sort() probably won’t see a significant time difference, but may see significant improvements in cases where the former strategy was exceptionally poor. However, as these are all fast linear-time approximations to a problem that’s inherently at best quadratic-time to solve truly optimally, it’s also possible to contrive cases where the former strategy did better.

  • bpo-45056: Compiler now removes trailing unused constants from co_consts.

  • bpo-45020: Add a new command line option, «-X frozen_modules=[on|off]» to opt out of (or into) using optional frozen modules. This defaults to «on» (or «off» if it’s running out of the source tree).

  • bpo-45012: In posix, release GIL during stat(), lstat(), and fstatat() syscalls made by os.DirEntry.stat(). Patch by Stanisław Skonieczny.

  • bpo-45018: Fixed pickling of range iterators that iterated for over 2**32 times.

  • bpo-45000: A SyntaxError is now raised when trying to delete __debug__. Patch by Donghee Na.

  • bpo-44963: Implement send() and throw() methods for anext_awaitable objects. Patch by Pablo Galindo.

  • bpo-44962: Fix a race in WeakKeyDictionary, WeakValueDictionary and WeakSet when two threads attempt to commit the last pending removal. This fixes asyncio.create_task and fixes a data loss in asyncio.run where shutdown_asyncgens is not run

  • bpo-24234: Implement the __bytes__() special method on the bytes type, so a bytes object b passes an isinstance(b, typing.SupportsBytes) check.

  • bpo-24234: Implement the __complex__() special method on the complex type, so a complex number z passes an isinstance(z, typing.SupportsComplex) check.

  • bpo-44954: Fixed a corner case bug where the result of float.fromhex('0x.8p-1074') was rounded the wrong way.

  • bpo-44947: Refine the syntax error for trailing commas in import statements. Patch by Pablo Galindo.

  • bpo-44945: Specialize the BINARY_ADD instruction using the PEP 659 machinery. Adds five new instructions:

    • BINARY_ADD_ADAPTIVE

    • BINARY_ADD_FLOAT

    • BINARY_ADD_INT

    • BINARY_ADD_UNICODE

    • BINARY_ADD_UNICODE_INPLACE_FAST

  • bpo-44929: Fix some edge cases of enum.Flag string representation in the REPL. Patch by Pablo Galindo.

  • bpo-44914: Class version tags are no longer recycled.

    This means that a version tag serves as a unique identifier for the state of a class. We rely on this for effective specialization of the LOAD_ATTR and other instructions.

  • bpo-44698: Restore behaviour of complex exponentiation with integer-valued exponent of type float or complex.

  • bpo-44895: A debug variable PYTHONDUMPREFSFILE is added for creating a dump file which is generated by --with-trace-refs. Patch by Donghee Na.

  • bpo-44900: Add five superinstructions for PEP 659 quickening:

    • LOAD_FAST LOAD_FAST

    • STORE_FAST LOAD_FAST

    • LOAD_FAST LOAD_CONST

    • LOAD_CONST LOAD_FAST

    • STORE_FAST STORE_FAST

  • bpo-44889: Initial implementation of adaptive specialization of LOAD_METHOD. The following specialized forms were added:

    • LOAD_METHOD_CACHED

    • LOAD_METHOD_MODULE

    • LOAD_METHOD_CLASS

  • bpo-44890: Specialization stats are always collected in debug builds.

  • bpo-44885: Correct the ast locations of f-strings with format specs and repeated expressions. Patch by Pablo Galindo

  • bpo-44878: Remove the loop from the bytecode interpreter. All instructions end with a DISPATCH macro, so the loop is now redundant.

  • bpo-44878: Remove switch statement for interpreter loop when using computed gotos. This makes sure that we only have one dispatch table in the interpreter.

  • bpo-44874: Deprecate the old trashcan macros (Py_TRASHCAN_SAFE_BEGIN/Py_TRASHCAN_SAFE_END). They should be replaced by the new macros Py_TRASHCAN_BEGIN and Py_TRASHCAN_END.

  • bpo-44872: Use new trashcan macros (Py_TRASHCAN_BEGIN/END) in frameobject.c instead of the old ones (Py_TRASHCAN_SAFE_BEGIN/END).

  • bpo-33930: Fix segmentation fault with deep recursion when cleaning method objects. Patch by Augusto Goulart and Pablo Galindo.

  • bpo-25782: Fix bug where PyErr_SetObject hangs when the current exception has a cycle in its context chain.

  • bpo-44856: Fix reference leaks in the error paths of update_bases() and __build_class__. Patch by Pablo Galindo.

  • bpo-44826: Initial implementation of adaptive specialization of STORE_ATTR

    Three specialized forms of STORE_ATTR are added:

    • STORE_ATTR_SLOT

    • STORE_ATTR_SPLIT_KEYS

    • STORE_ATTR_WITH_HINT

  • bpo-44838: Fixed a bug that was causing the parser to raise an incorrect custom SyntaxError for invalid “if” expressions. Patch by Pablo Galindo.

  • bpo-44821: Create instance dictionaries (__dict__) eagerly, to improve regularity of object layout and assist specialization.

  • bpo-44792: Improve syntax errors for if expressions. Patch by Miguel Brito

  • bpo-34013: Generalize the invalid legacy statement custom error message (like the one generated when «print» is called without parentheses) to include more generic expressions. Patch by Pablo Galindo

  • bpo-44732: Rename types.Union to types.UnionType.

  • bpo-44725: Expose specialization stats in python via _opcode.get_specialization_stats().

  • bpo-44717: Improve AttributeError on circular imports of submodules.

  • bpo-44698: Fix undefined behaviour in complex object exponentiation.

  • bpo-44653: Support typing types in parameter substitution in the union type.

  • bpo-44676: Add ability to serialise types.Union objects. Patch provided by Yurii Karabas.

  • bpo-44633: Parameter substitution of the union type with wrong types now raises TypeError instead of returning NotImplemented.

  • bpo-44661: Update property_descr_set to use vectorcall if possible. Patch by Donghee Na.

  • bpo-44662: Add __module__ to types.Union. This also fixes types.Union issues with typing.Annotated. Patch provided by Yurii Karabas.

  • bpo-44655: Include the name of the type in unset __slots__ attribute errors. Patch by Pablo Galindo

  • bpo-44655: Don’t include a missing attribute with the same name as the failing one when offering suggestions for missing attributes. Patch by Pablo Galindo

  • bpo-44646: Fix the hash of the union type: it no longer depends on the order of arguments.

  • bpo-44636: Collapse union of equal types. E.g. the result of int | int is now int. Fix comparison of the union type with non-hashable objects. E.g. int | str == {} no longer raises a TypeError.

  • bpo-44611: On Windows, os.urandom(): uses BCryptGenRandom API instead of CryptGenRandom API which is deprecated from Microsoft Windows API. Patch by Donghee Na.

  • bpo-44635: Convert None to type(None) in the union type constructor.

  • bpo-26280: Implement adaptive specialization for BINARY_SUBSCR

    Three specialized forms of BINARY_SUBSCR are added:

    • BINARY_SUBSCR_LIST_INT

    • BINARY_SUBSCR_TUPLE_INT

    • BINARY_SUBSCR_DICT

  • bpo-44589: Mapping patterns in match statements with two or more equal literal keys will now raise a SyntaxError at compile-time.

  • bpo-44606: Fix __instancecheck__ and __subclasscheck__ for the union type.

  • bpo-42073: The @classmethod decorator can now wrap other classmethod-like descriptors.

  • bpo-41972: Tuned the string-searching algorithm of fastsearch.h to have a shorter inner loop for most cases.

  • bpo-44590: All necessary data for executing a Python function (local variables, stack, etc) is now kept in a per-thread stack. Frame objects are lazily allocated on demand. This increases performance by about 7% on the standard benchmark suite. Introspection and debugging are unaffected as frame objects are always available when needed. Patch by Mark Shannon.

  • bpo-44584: The threading debug (PYTHONTHREADDEBUG environment variable) is deprecated in Python 3.10 and will be removed in Python 3.12. This feature requires a debug build of Python. Patch by Victor Stinner.

  • bpo-43895: An obsolete internal cache of shared object file handles added in 1995 that attempted, but did not guarantee, that a .so would not be dlopen’ed twice to work around flaws in mid-1990s posix-ish operating systems has been removed from dynload_shlib.c.

  • bpo-44490: typing now searches for type parameters in types.Union objects. get_type_hints will also properly resolve annotations with nested types.Union objects. Patch provided by Yurii Karabas.

  • bpo-43950: Code objects can now provide the column information for instructions when available. This is levaraged during traceback printing to show the expressions responsible for errors.

    Contributed by Pablo Galindo, Batuhan Taskaya and Ammar Askar as part of PEP 657.

  • bpo-44562: Remove uses of PyObject_GC_Del() in error path when initializing types.GenericAlias.

  • bpo-41486: Fix a memory consumption and copying performance regression in earlier 3.10 beta releases if someone used an output buffer larger than 4GiB with zlib.decompress on input data that expands that large.

  • bpo-43908: Heap types with the Py_TPFLAGS_IMMUTABLETYPE flag can now inherit the PEP 590 vectorcall protocol. Previously, this was only possible for static types. Patch by Erlend E. Aasland.

  • bpo-44553: Implement GC methods for types.Union to break reference cycles and prevent memory leaks.

  • bpo-44490: Add __parameters__ attribute and __getitem__ operator to types.Union. Patch provided by Yurii Karabas.

  • bpo-44523: Remove the pass-through for hash() of weakref.proxy objects to prevent unintended consequences when the original referred object dies while the proxy is part of a hashable object. Patch by Pablo Galindo.

  • bpo-44483: Fix a crash in types.Union objects when creating a union of an object with bad __module__ field.

  • bpo-44486: Modules will always have a dictionary, even when created by types.ModuleType.__new__()

  • bpo-44472: Fix ltrace functionality when exceptions are raised. Patch by Pablo Galindo

  • bpo-12022: A TypeError is now raised instead of an AttributeError in with and async with statements for objects which do not support the context manager or asynchronous context manager protocols correspondingly.

  • bpo-44297: Make sure that the line number is set when entering a comprehension scope. This ensures that backtraces including generator expressions show the correct line number.

  • bpo-44456: Improve the syntax error when mixing positional and keyword patterns. Patch by Pablo Galindo.

  • bpo-44409: Fix error location information for tokenizer errors raised on initialization of the tokenizer. Patch by Pablo Galindo.

  • bpo-44396: Fix a possible crash in the tokenizer when raising syntax errors for unclosed strings. Patch by Pablo Galindo.

  • bpo-44376: Exact integer exponentiation (like i**2 or pow(i, 2)) with a small exponent is much faster, due to reducing overhead in such cases.

  • bpo-44313: Directly imported objects and modules (through import and from import statements) don’t generate LOAD_METHOD/CALL_METHOD for directly accessed objects on their namespace. They now use the regular LOAD_ATTR/CALL_FUNCTION.

  • bpo-44338: Implement adaptive specialization for LOAD_GLOBAL

    Two specialized forms of LOAD_GLOBAL are added:

    • LOAD_GLOBAL_MODULE

    • LOAD_GLOBAL_BUILTIN

  • bpo-44368: Improve syntax errors for invalid «as» targets. Patch by Pablo Galindo

  • bpo-44349: Fix an edge case when displaying text from files with encoding in syntax errors. Patch by Pablo Galindo.

  • bpo-44337: Initial implementation of adaptive specialization of LOAD_ATTR

    Four specialized forms of LOAD_ATTR are added:

    • LOAD_ATTR_SLOT

    • LOAD_ATTR_SPLIT_KEYS

    • LOAD_ATTR_WITH_HINT

    • LOAD_ATTR_MODULE

  • bpo-44335: Fix a regression when identifying incorrect characters in syntax errors. Patch by Pablo Galindo

  • bpo-43693: Computation of the offsets of cell variables is done in the compiler instead of at runtime. This reduces the overhead of handling cell and free variables, especially in the case where a variable is both an argument and cell variable.

  • bpo-44317: Improve tokenizer error with improved locations. Patch by Pablo Galindo.

  • bpo-44304: Fix a crash in the sqlite3 module that happened when the garbage collector clears sqlite.Statement objects. Patch by Pablo Galindo

  • bpo-44305: Improve error message for try blocks without except or finally blocks. Patch by Pablo Galindo.

  • bpo-43413: Constructors of subclasses of some builtin classes (e.g. tuple, list, frozenset) no longer accept arbitrary keyword arguments. [reverted in 3.11a4] Subclass of set can now define a __new__() method with additional keyword parameters without overriding also __init__().

  • bpo-43667: Improve Unicode support in non-UTF locales on Oracle Solaris. This issue does not affect other Solaris systems.

  • bpo-43693: A new opcode MAKE_CELL has been added that effectively moves some of the work done on function entry into the compiler and into the eval loop. In addition to creating the required cell objects, the new opcode converts relevant arguments (and other locals) to cell variables on function entry.

  • bpo-44232: Fix a regression in type() when a metaclass raises an exception. The C function type_new() must properly report the exception when a metaclass constructor raises an exception and the winner class is not the metaclass. Patch by Victor Stinner.

  • bpo-44201: Avoid side effects of checking for specialized syntax errors in the REPL that was causing it to ask for extra tokens after a syntax error had been detected. Patch by Pablo Galindo

  • bpo-43693: PyCodeObject gained co_fastlocalnames and co_fastlocalkinds as the authoritative source of fast locals info. Marshaled code objects have changed accordingly.

  • bpo-44184: Fix a crash at Python exit when a deallocator function removes the last strong reference to a heap type. Patch by Victor Stinner.

  • bpo-44187: Implement quickening in the interpreter. This offers no advantages as yet, but is an enabler of future optimizations. See PEP 659 for full explanation.

  • bpo-44180: The parser doesn’t report generic syntax errors that happen in a position further away that the one it reached in the first pass. Patch by Pablo Galindo

  • bpo-44168: Fix error message in the parser involving keyword arguments with invalid expressions. Patch by Pablo Galindo

  • bpo-44156: String caches in compile.c are now subinterpreter compatible.

  • bpo-44143: Fixed a crash in the parser that manifest when raising tokenizer errors when an existing exception was present. Patch by Pablo Galindo.

  • bpo-44032: Move “fast” locals and other variables from the frame object to a per-thread datastack.

  • bpo-44114: Fix incorrect dictkeys_reversed and dictitems_reversed function signatures in C code, which broke webassembly builds.

  • bpo-44110: Improve str.__getitem__() error message

  • bpo-26110: Add CALL_METHOD_KW opcode to speed up method calls with keyword arguments. Idea originated from PyPy. A side effect is executing CALL_METHOD is now branchless in the evaluation loop.

  • bpo-28307: Compiler now optimizes simple C-style formatting with literal format containing only format codes %s, %r and %a by converting them to f-string expressions.

  • bpo-43149: Correct the syntax error message regarding multiple exception types to not refer to «exception groups». Patch by Pablo Galindo

  • bpo-43822: The parser will prioritize tokenizer errors over custom syntax errors when raising exceptions. Patch by Pablo Galindo.

  • bpo-40222: «Zero cost» exception handling.

    • Uses a lookup table to determine how to handle exceptions.

    • Removes SETUP_FINALLY and POP_TOP block instructions, eliminating the runtime overhead of try statements.

    • Reduces the size of the frame object by about 60%.

    Patch by Mark Shannon

  • bpo-43918: Document the signature and default argument in the docstring of the new anext builtin.

  • bpo-43833: Emit a deprecation warning if the numeric literal is immediately followed by one of keywords: and, else, for, if, in, is, or. Raise a syntax error with more informative message if it is immediately followed by other keyword or identifier.

  • bpo-43879: Add native_thread_id to PyThreadState. Patch by Gabriele N. Tornetta.

  • bpo-43693: Compute cell offsets relative to locals in compiler. Allows the interpreter to treats locals and cells a single array, which is slightly more efficient. Also make the LOAD_CLOSURE opcode an alias for LOAD_FAST. Preserving LOAD_CLOSURE helps keep bytecode a bit more readable.

  • bpo-17792: More accurate error messages for access of unbound locals or free vars.

  • bpo-28146: Fix a confusing error message in str.format().

  • bpo-11105: When compiling ast.AST objects with recursive references through compile(), the interpreter doesn’t crash anymore instead it raises a RecursionError.

  • bpo-39091: Fix crash when using passing a non-exception to a generator’s throw() method. Patch by Noah Oxer

  • bpo-33346: Asynchronous comprehensions are now allowed inside comprehensions in asynchronous functions. Outer comprehensions implicitly become asynchronous.

Library

  • bpo-45371: Fix clang rpath issue in distutils. The UnixCCompiler now uses correct clang option to add a runtime library directory (rpath) to a shared library.

  • bpo-45329: Fix freed memory access in pyexpat.xmlparser when building it with an installed expat library <= 2.2.0.

  • bpo-41710: On Unix, if the sem_clockwait() function is available in the C library (glibc 2.30 and newer), the threading.Lock.acquire() method now uses the monotonic clock (time.CLOCK_MONOTONIC) for the timeout, rather than using the system clock (time.CLOCK_REALTIME), to not be affected by system clock changes. Patch by Victor Stinner.

  • bpo-1596321: Fix the threading._shutdown() function when the threading module was imported first from a thread different than the main thread: no longer log an error at Python exit.

  • bpo-45274: Fix a race condition in the Thread.join() method of the threading module. If the function is interrupted by a signal and the signal handler raises an exception, make sure that the thread remains in a consistent state to prevent a deadlock. Patch by Victor Stinner.

  • bpo-21302: In Unix operating systems, time.sleep() now uses the nanosleep() function, if clock_nanosleep() is not available but nanosleep() is available. nanosleep() allows to sleep with nanosecond precision.

  • bpo-21302: On Windows, time.sleep() now uses a waitable timer which has a resolution of 100 nanoseconds (10-7 seconds). Previously, it had a resolution of 1 millisecond (10-3 seconds). Patch by Benjamin Szőke and Victor Stinner.

  • bpo-45238: Fix unittest.IsolatedAsyncioTestCase.debug(): it runs now asynchronous methods and callbacks.

  • bpo-36674: unittest.TestCase.debug() raises now a unittest.SkipTest if the class or the test method are decorated with the skipping decorator.

  • bpo-45235: Fix an issue where argparse would not preserve values in a provided namespace when using a subparser with defaults.

  • bpo-45183: Have zipimport.zipimporter.find_spec() not raise an exception when the underlying zip file has been deleted and the internal cache has been reset via invalidate_cache().

  • bpo-45234: Fixed a regression in copyfile(), copy(), copy2() raising FileNotFoundError when source is a directory, which should raise IsADirectoryError

  • bpo-45228: Fix stack buffer overflow in parsing J1939 network address.

  • bpo-45225: use map function instead of genexpr in capwords.

  • bpo-42135: Fix typo: importlib.find_loader is really slated for removal in Python 3.12 not 3.10, like the others in PR 25169.

    Patch by Hugo van Kemenade.

  • bpo-20524: Improves error messages on .format() operation for str, float, int, and complex. New format now shows the problematic pattern and the object type.

  • bpo-45168: Change dis.dis() output to omit op arg values that cannot be resolved due to co_consts, co_names etc not being provided. Previously the oparg itself was repeated in the value field, which is not useful and can be confusing.

  • bpo-21302: In Unix operating systems, time.sleep() now uses the clock_nanosleep() function, if available, which allows to sleep for an interval specified with nanosecond precision.

  • bpo-45173: Remove from the configparser module: the SafeConfigParser class, the filename property of the ParsingError class, the readfp() method of the ConfigParser class, deprecated since Python 3.2.

    Patch by Hugo van Kemenade.

  • bpo-44987: Pure ASCII strings are now normalized in constant time by unicodedata.normalize(). Patch by Donghee Na.

  • bpo-35474: Calling mimetypes.guess_all_extensions() with strict=False no longer affects the result of the following call with strict=True. Also, mutating the returned list no longer affects the global state.

  • bpo-45166: typing.get_type_hints() now works with Final wrapped in ForwardRef.

  • bpo-45162: Remove many old deprecated unittest features:

    • «fail*» and «assert*» aliases of TestCase methods.

    • Broken from start TestCase method assertDictContainsSubset().

    • Ignored <unittest.TestLoader.loadTestsFromModule> TestLoader.loadTestsFromModule() parameter use_load_tests.

    • Old alias _TextTestResult of TextTestResult.

  • bpo-38371: Remove the deprecated split() method of _tkinter.TkappType. Patch by Erlend E. Aasland.

  • bpo-20499: Improve the speed and accuracy of statistics.pvariance().

  • bpo-45132: Remove __getitem__() methods of xml.dom.pulldom.DOMEventStream, wsgiref.util.FileWrapper and fileinput.FileInput, deprecated since Python 3.9.

    Patch by Hugo van Kemenade.

  • bpo-45129: Due to significant security concerns, the reuse_address parameter of asyncio.loop.create_datagram_endpoint(), disabled in Python 3.9, is now entirely removed. This is because of the behavior of the socket option SO_REUSEADDR in UDP.

    Patch by Hugo van Kemenade.

  • bpo-45124: The bdist_msi command, deprecated in Python 3.9, is now removed.

    Use bdist_wheel (wheel packages) instead.

    Patch by Hugo van Kemenade.

  • bpo-30856: unittest.TestResult methods addFailure(), addError(), addSkip() and addSubTest() are now called immediately after raising an exception in test or finishing a subtest. Previously they were called only after finishing the test clean up.

  • bpo-45034: Changes how error is formatted for struct.pack with 'H' and 'h' modes and too large / small numbers. Now it shows the actual numeric limits, while previously it was showing arithmetic expressions.

  • bpo-25894: unittest now always reports skipped and failed subtests separately: separate characters in default mode and separate lines in verbose mode. Also the test description is now output for errors in test method, class and module cleanups.

  • bpo-45081: Fix issue when dataclasses that inherit from typing.Protocol subclasses have wrong __init__. Patch provided by Yurii Karabas.

  • bpo-45085: The binhex module, deprecated in Python 3.9, is now removed. The following binascii functions, deprecated in Python 3.9, are now also removed:

    • a2b_hqx(), b2a_hqx();

    • rlecode_hqx(), rledecode_hqx().

    The binascii.crc_hqx() function remains available.

    Patch by Victor Stinner.

  • bpo-40360: The lib2to3 package is now deprecated and may not be able to parse Python 3.10 or newer. See the PEP 617 (New PEG parser for CPython). Patch by Victor Stinner.

  • bpo-45075: Rename traceback.StackSummary.format_frame() to traceback.StackSummary.format_frame_summary(). This method was added for 3.11 so it was not released yet.

    Updated code and docs to better distinguish frame and FrameSummary.

  • bpo-31299: Add option to completely drop frames from a traceback by returning None from a format_frame() override.

  • bpo-41620: run() now always return a TestResult instance. Previously it returned None if the test class or method was decorated with a skipping decorator.

  • bpo-45021: Fix a potential deadlock at shutdown of forked children when using concurrent.futures module

  • bpo-43913: Fix bugs in cleaning up classes and modules in unittest:

    • Functions registered with addModuleCleanup() were not called unless the user defines tearDownModule() in their test module.

    • Functions registered with addClassCleanup() were not called if tearDownClass is set to None.

    • Buffering in TestResult did not work with functions registered with addClassCleanup() and addModuleCleanup().

    • Errors in functions registered with addClassCleanup() and addModuleCleanup() were not handled correctly in buffered and debug modes.

    • Errors in setUpModule() and functions registered with addModuleCleanup() were reported in wrong order.

    • And several lesser bugs.

  • bpo-45030: Fix integer overflow in pickling and copying the range iterator.

  • bpo-45001: Made email date parsing more robust against malformed input, namely a whitespace-only Date: header. Patch by Wouter Bolsterlee.

  • bpo-45010: Remove support of special method __div__ in unittest.mock. It is not used in Python 3.

  • bpo-39218: Improve accuracy of variance calculations by using x*x instead of x**2.

  • bpo-43613: Improve the speed of gzip.compress() and gzip.decompress() by compressing and decompressing at once in memory instead of in a streamed fashion.

  • bpo-37596: Ensure that set and frozenset objects are always marshalled reproducibly.

  • bpo-44019: A new function operator.call has been added, such that operator.call(obj, *args, **kwargs) == obj(*args, **kwargs).

  • bpo-42255: webbrowser.MacOSX is deprecated and will be removed in Python 3.13. It is untested and undocumented and also not used by webbrowser itself. Patch by Donghee Na.

  • bpo-44955: Method stopTestRun() is now always called in pair with method startTestRun() for TestResult objects implicitly created in run(). Previously it was not called for test methods and classes decorated with a skipping decorator.

  • bpo-39039: tarfile.open raises ReadError when a zlib error occurs during file extraction.

  • bpo-44935: subprocess on Solaris now also uses os.posix_spawn() for better performance.

  • bpo-44911: IsolatedAsyncioTestCase will no longer throw an exception while cancelling leaked tasks. Patch by Bar Harel.

  • bpo-41322: Added DeprecationWarning for tests and async tests that return a value!=None (as this may indicate an improperly written test, for example a test written as a generator function).

  • bpo-44524: Make exception message more useful when subclass from typing special form alias. Patch provided by Yurii Karabas.

  • bpo-38956: argparse.BooleanOptionalAction’s default value is no longer printed twice when used with argparse.ArgumentDefaultsHelpFormatter.

  • bpo-44860: Fix the posix_user scheme in sysconfig to not depend on sys.platlibdir.

  • bpo-44859: Improve error handling in sqlite3 and raise more accurate exceptions.

    • MemoryError is now raised instead of sqlite3.Warning when memory is not enough for encoding a statement to UTF-8 in Connection.__call__() and Cursor.execute().

    • UnicodEncodeError is now raised instead of sqlite3.Warning when the statement contains surrogate characters in Connection.__call__() and Cursor.execute().

    • TypeError is now raised instead of ValueError for non-string script argument in Cursor.executescript().

    • ValueError is now raised for script containing the null character instead of truncating it in Cursor.executescript().

    • Correctly handle exceptions raised when getting boolean value of the result of the progress handler.

    • Add many tests covering different corner cases.

  • bpo-44581: Upgrade bundled pip to 21.2.3 and setuptools to 57.4.0

  • bpo-44849: Fix the os.set_inheritable() function on FreeBSD 14 for file descriptor opened with the O_PATH flag: ignore the EBADF error on ioctl(), fallback on the fcntl() implementation. Patch by Victor Stinner.

  • bpo-44605: The @functools.total_ordering() decorator now works with metaclasses.

  • bpo-44524: Fixed an issue wherein the __name__ and __qualname__ attributes of subscribed specialforms could be None.

  • bpo-44839: MemoryError raised in user-defined functions will now produce a MemoryError in sqlite3. OverflowError will now be converted to DataError. Previously OperationalError was produced in these cases.

  • bpo-44822: sqlite3 user-defined functions and aggregators returning strings with embedded NUL characters are no longer truncated. Patch by Erlend E. Aasland.

  • bpo-44801: Ensure that the ParamSpec variable in Callable can only be substituted with a parameters expression (a list of types, an ellipsis, ParamSpec or Concatenate).

  • bpo-44806: Non-protocol subclasses of typing.Protocol ignore now the __init__ method inherited from protocol base classes.

  • bpo-27275: collections.OrderedDict.popitem() and collections.OrderedDict.pop() no longer call __getitem__ and __delitem__ methods of the OrderedDict subclasses.

  • bpo-44793: Fix checking the number of arguments when subscribe a generic type with ParamSpec parameter.

  • bpo-44784: In importlib.metadata tests, override warnings behavior under expected DeprecationWarnings (importlib_metadata 4.6.3).

  • bpo-44667: The tokenize.tokenize() doesn’t incorrectly generate a NEWLINE token if the source doesn’t end with a new line character but the last line is a comment, as the function is already generating a NL token. Patch by Pablo Galindo

  • bpo-44771: Added importlib.simple module implementing adapters from a low-level resources reader interface to a TraversableResources interface. Legacy API (path, contents, …) is now supported entirely by the .files() API with a compatibility shim supplied for resource loaders without that functionality. Feature parity with importlib_resources 5.2.

  • bpo-44752: rcompleter does not call getattr() on property objects to avoid the side-effect of evaluating the corresponding method.

  • bpo-44747: Refactor usage of sys._getframe in typing module. Patch provided by Yurii Karabas.

  • bpo-42378: Fixes the issue with log file being overwritten when logging.FileHandler is used in atexit with filemode set to 'w'. Note this will cause the message in atexit not being logged if the log stream is already closed due to shutdown of logging.

  • bpo-44720: weakref.proxy objects referencing non-iterators now raise TypeError rather than dereferencing the null tp_iternext slot and crashing.

  • bpo-44704: The implementation of collections.abc.Set._hash() now matches that of frozenset.__hash__().

  • bpo-44666: Fixed issue in compileall.compile_file() when sys.stdout is redirected. Patch by Stefan Hölzl.

  • bpo-44688: sqlite3.Connection.create_collation() now accepts non-ASCII collation names. Patch by Erlend E. Aasland.

  • bpo-44690: Adopt binacii.a2b_base64’s strict mode in base64.b64decode.

  • bpo-42854: Fixed a bug in the _ssl module that was throwing OverflowError when using _ssl._SSLSocket.write() and _ssl._SSLSocket.read() for a big value of the len parameter. Patch by Pablo Galindo.

  • bpo-44686: Replace unittest.mock._importer with pkgutil.resolve_name.

  • bpo-44353: Make NewType.__call__ faster by implementing it in C. Patch provided by Yurii Karabas.

  • bpo-44682: Change the pdb commands directive to disallow setting commands for an invalid breakpoint and to display an appropriate error.

  • bpo-44353: Refactor typing.NewType from function into callable class. Patch provided by Yurii Karabas.

  • bpo-44678: Added a separate error message for discontinuous padding in binascii.a2b_base64 strict mode.

  • bpo-44524: Add missing __name__ and __qualname__ attributes to typing module classes. Patch provided by Yurii Karabas.

  • bpo-40897: Give priority to using the current class constructor in inspect.signature(). Patch by Weipeng Hong.

  • bpo-44638: Add a reference to the zipp project and hint as to how to use it.

  • bpo-44648: Fixed wrong error being thrown by inspect.getsource() when examining a class in the interactive session. Instead of TypeError, it should be OSError with appropriate error message.

  • bpo-44608: Fix memory leak in _tkinter._flatten() if it is called with a sequence or set, but not list or tuple.

  • bpo-44594: Fix an edge case of ExitStack and AsyncExitStack exception chaining. They will now match with block behavior when __context__ is explicitly set to None when the exception is in flight.

  • bpo-42799: In fnmatch, the cache size for compiled regex patterns (functools.lru_cache()) was bumped up from 256 to 32768, affecting functions: fnmatch.fnmatch(), fnmatch.fnmatchcase(), fnmatch.filter().

  • bpo-41928: Update shutil.copyfile() to raise FileNotFoundError instead of confusing IsADirectoryError when a path ending with a os.path.sep does not exist; shutil.copy() and shutil.copy2() are also affected.

  • bpo-44569: Added the StackSummary.format_frame() function in traceback. This allows users to customize the way individual lines are formatted in tracebacks without re-implementing logic to handle recursive tracebacks.

  • bpo-44566: handle StopIteration subclass raised from @contextlib.contextmanager generator

  • bpo-44558: Make the implementation consistency of indexOf() between C and Python versions. Patch by Donghee Na.

  • bpo-41249: Fixes TypedDict to work with typing.get_type_hints() and postponed evaluation of annotations across modules.

  • bpo-44554: Refactor argument processing in pdb.main() to simplify detection of errors in input loading and clarify behavior around module or script invocation.

  • bpo-34798: Break up paragraph about pprint.PrettyPrinter construction parameters to make it easier to read.

  • bpo-44539: Added support for recognizing JPEG files without JFIF or Exif markers.

  • bpo-44461: Fix bug with pdb’s handling of import error due to a package which does not have a __main__ module

  • bpo-43625: Fix a bug in the detection of CSV file headers by csv.Sniffer.has_header() and improve documentation of same.

  • bpo-44516: Update vendored pip to 21.1.3

  • bpo-42892: Fixed an exception thrown while parsing a malformed multipart email by email.message.EmailMessage.

  • bpo-44468: typing.get_type_hints() now finds annotations in classes and base classes with unexpected __module__. Previously, it skipped those MRO elements.

  • bpo-44491: Allow clearing the sqlite3 authorizer callback by passing None to set_authorizer(). Patch by Erlend E. Aasland.

  • bpo-43977: Set the proper Py_TPFLAGS_MAPPING and Py_TPFLAGS_SEQUENCE flags for subclasses created before a parent has been registered as a collections.abc.Mapping or collections.abc.Sequence.

  • bpo-44482: Fix very unlikely resource leak in glob in alternate Python implementations.

  • bpo-44466: The faulthandler module now detects if a fatal error occurs during a garbage collector collection. Patch by Victor Stinner.

  • bpo-44471: A TypeError is now raised instead of an AttributeError in contextlib.ExitStack.enter_context() and contextlib.AsyncExitStack.enter_async_context() for objects which do not support the context manager or asynchronous context manager protocols correspondingly.

  • bpo-44404: tkinter’s after() method now supports callables without the __name__ attribute.

  • bpo-41546: Make pprint (like the builtin print) not attempt to write to stdout when it is None.

  • bpo-44458: BUFFER_BLOCK_SIZE is now declared static, to avoid linking collisions when bz2, lmza or zlib are statically linked.

  • bpo-44464: Remove exception for flake8 in deprecated importlib.metadata interfaces. Sync with importlib_metadata 4.6.

  • bpo-44446: Take into account that lineno might be None in traceback.FrameSummary.

  • bpo-44439: Fix in bz2.BZ2File.write() / lzma.LZMAFile.write() methods, when the input data is an object that supports the buffer protocol, the file length may be wrong.

  • bpo-44434: _thread.start_new_thread() no longer calls PyThread_exit_thread() explicitly at the thread exit, the call was redundant. On Linux with the glibc, pthread_exit() aborts the whole process if dlopen() fails to open libgcc_s.so file (ex: EMFILE error). Patch by Victor Stinner.

  • bpo-42972: The _thread.RLock type now fully implement the GC protocol: add a traverse function and the Py_TPFLAGS_HAVE_GC flag. Patch by Victor Stinner.

  • bpo-44422: The threading.enumerate() function now uses a reentrant lock to prevent a hang on reentrant call. Patch by Victor Stinner.

  • bpo-38291: Importing typing.io or typing.re now prints a DeprecationWarning.

  • bpo-37880: argparse actions store_const and append_const each receive a default value of None when the const kwarg is not provided. Previously, this raised a TypeError.

  • bpo-44389: Fix deprecation of ssl.OP_NO_TLSv1_3

  • bpo-27827: pathlib.PureWindowsPath.is_reserved() now identifies a greater range of reserved filenames, including those with trailing spaces or colons.

  • bpo-44395: Fix as_string() to pass unixfrom properly. Patch by Donghee Na.

  • bpo-34266: Handle exceptions from parsing the arg of pdb’s run/restart command.

  • bpo-44362: Improve ssl module’s deprecation messages, error reporting, and documentation for deprecations.

  • bpo-44342: [Enum] Change pickling from by-value to by-name.

  • bpo-44356: [Enum] Allow multiple data-type mixins if they are all the same.

  • bpo-44351: Restore back parse_makefile() in distutils.sysconfig because it behaves differently than the similar implementation in sysconfig.

  • bpo-35800: smtpd.MailmanProxy is now removed as it is unusable without an external module, mailman. Patch by Donghee Na.

  • bpo-44357: Added a function that returns cube root of the given number math.cbrt()

  • bpo-44339: Change math.pow(±0.0, -math.inf) to return inf instead of raising ValueError. This brings the special-case handling of math.pow into compliance with the IEEE 754 standard.

  • bpo-44242: Remove missing flag check from Enum creation and move into a verify decorator.

  • bpo-44246: In importlib.metadata, restore compatibility in the result from Distribution.entry_points (EntryPoints) to honor expectations in older implementations and issuing deprecation warnings for these cases: A. EntryPoints objects are once again mutable, allowing for sort() and other list-based mutation operations. Avoid deprecation warnings by casting to a mutable sequence (e.g. list(dist.entry_points).sort()). B. EntryPoints results once again allow for access by index. To avoid deprecation warnings, cast the result to a Sequence first (e.g. tuple(dist.entry_points)[0]).

  • bpo-44246: In importlib.metadata.entry_points, de-duplication of distributions no longer requires loading the full metadata for PathDistribution objects, improving entry point loading performance by ~10x.

  • bpo-43858: Added a function that returns a copy of a dict of logging levels: logging.getLevelNamesMapping()

  • bpo-44260: The random.Random constructor no longer reads system entropy without need.

  • bpo-44254: On Mac, give turtledemo button text a color that works on both light or dark background. Programmers cannot control the latter.

  • bpo-44258: Support PEP 515 for Fraction’s initialization from string.

  • bpo-44235: Remove deprecated functions in the gettext. Patch by Donghee Na.

  • bpo-38693: Prefer f-strings to .format in importlib.resources.

  • bpo-33693: Importlib.metadata now prefers f-strings to .format.

  • bpo-44241: Incorporate minor tweaks from importlib_metadata 4.1: SimplePath protocol, support for Metadata 2.2.

  • bpo-43216: Remove the @asyncio.coroutine decorator enabling legacy generator-based coroutines to be compatible with async/await code; remove asyncio.coroutines.CoroWrapper used for wrapping legacy coroutine objects in the debug mode. The decorator has been deprecated since Python 3.8 and the removal was initially scheduled for Python 3.10. Patch by Illia Volochii.

  • bpo-44210: Make importlib.metadata._meta.PackageMetadata public.

  • bpo-43643: Declare readers.MultiplexedPath.name as a property per the spec.

  • bpo-27334: The sqlite3 context manager now performs a rollback (thus releasing the database lock) if commit failed. Patch by Luca Citi and Erlend E. Aasland.

  • bpo-4928: Documented existing behavior on POSIX: NamedTemporaryFiles are not deleted when creating process is killed with SIGKILL

  • bpo-44154: Optimize fractions.Fraction pickling for large components.

  • bpo-33433: For IPv4 mapped IPv6 addresses (RFC 4291 Section 2.5.5.2), the ipaddress.IPv6Address.is_private check is deferred to the mapped IPv4 address. This solves a bug where public mapped IPv4 addresses were considered private by the IPv6 check.

  • bpo-44150: Add optional weights argument to statistics.fmean().

  • bpo-44142: ast.unparse() will now drop the redundant parentheses when tuples used as assignment targets (e.g in for loops).

  • bpo-44145: hmac computations were not releasing the GIL while calling the OpenSSL HMAC_Update C API (a new feature in 3.9). This unintentionally prevented parallel computation as other hashlib algorithms support.

  • bpo-44095: zipfile.Path now supports zipfile.Path.stem, zipfile.Path.suffixes, and zipfile.Path.suffix attributes.

  • bpo-44077: It’s now possible to receive the type of service (ToS), a.k.a. differentiated services (DS), a.k.a. differentiated services code point (DSCP) and explicit congestion notification (ECN) IP header fields with socket.IP_RECVTOS.

  • bpo-37788: Fix a reference leak when a Thread object is never joined.

  • bpo-38908: Subclasses of typing.Protocol which only have data variables declared will now raise a TypeError when checked with isinstance unless they are decorated with runtime_checkable(). Previously, these checks passed silently. Patch provided by Yurii Karabas.

  • bpo-44098: typing.ParamSpec will no longer be found in the __parameters__ of most typing generics except in valid use locations specified by PEP 612. This prevents incorrect usage like typing.List[P][int]. This change means incorrect usage which may have passed silently in 3.10 beta 1 and earlier will now error.

  • bpo-44089: Allow subclassing csv.Error in 3.10 (it was allowed in 3.9 and earlier but was disallowed in early versions of 3.10).

  • bpo-44081: ast.unparse() now doesn’t use redundant spaces to separate lambda and the : if there are no parameters.

  • bpo-44061: Fix regression in previous release when calling pkgutil.iter_modules() with a list of pathlib.Path objects

  • bpo-44059: Register the SerenityOS Browser in the webbrowser module.

  • bpo-36515: The hashlib module no longer does unaligned memory accesses when compiled for ARM platforms.

  • bpo-40465: Remove random module features deprecated in Python 3.9.

  • bpo-44018: random.seed() no longer mutates bytearray inputs.

  • bpo-38352: Add IO, BinaryIO, TextIO, Match, and Pattern to typing.__all__. Patch by Jelle Zijlstra.

  • bpo-44002: urllib.parse now uses functool.lru_cache() for its internal URL splitting and quoting caches instead of rolling its own like its the “90s.

    The undocumented internal urllib.parse Quoted class API is now deprecated, for removal in 3.14.

  • bpo-43972: When http.server.SimpleHTTPRequestHandler sends a 301 (Moved Permanently) for a directory path not ending with /, add a Content-Length: 0 header. This improves the behavior for certain clients.

  • bpo-28528: Fix a bug in pdb where checkline() raises AttributeError if it is called after reset().

  • bpo-43853: Improved string handling for sqlite3 user-defined functions and aggregates:

    • It is now possible to pass strings with embedded null characters to UDFs

    • Conversion failures now correctly raise MemoryError

    Patch by Erlend E. Aasland.

  • bpo-43666: AIX: Lib/_aix_support.get_platform() may fail in an AIX WPAR. The fileset bos.rte appears to have a builddate in both LPAR and WPAR so this fileset is queried rather than bos.mp64. To prevent a similar situation (no builddate in ODM) a value (9988) sufficient for completing a build is provided. Patch by M Felt.

  • bpo-43650: Fix MemoryError in shutil.unpack_archive() which fails inside shutil._unpack_zipfile() on large files. Patch by Igor Bolshakov.

  • bpo-43612: zlib.compress() now accepts a wbits parameter which allows users to compress data as a raw deflate block without zlib headers and trailers in one go. Previously this required instantiating a zlib.compressobj. It also provides a faster alternative to gzip.compress when wbits=31 is used.

  • bpo-43392: importlib._bootstrap._find_and_load() now implements a two-step check to avoid locking when modules have been already imported and are ready. This improves performance of repeated calls to importlib.import_module() and importlib.__import__().

  • bpo-43318: Fix a bug where pdb does not always echo cleared breakpoints.

  • bpo-43234: Prohibit passing non-concurrent.futures.ThreadPoolExecutor executors to loop.set_default_executor() following a deprecation in Python 3.8. Patch by Illia Volochii.

  • bpo-43232: Prohibit previously deprecated potentially disruptive operations on asyncio.trsock.TransportSocket. Patch by Illia Volochii.

  • bpo-30077: Added support for Apple’s aifc/sowt pseudo-compression

  • bpo-42971: Add definition of errno.EQFULL for platforms that define this constant (such as macOS).

  • bpo-43086: Added a new optional strict_mode parameter to binascii.a2b_base64. When scrict_mode is set to True, the a2b_base64 function will accept only valid base64 content. More details about what «valid base64 content» is, can be found in the function’s documentation.

  • bpo-43024: Improve the help signature of traceback.print_exception(), traceback.format_exception() and traceback.format_exception_only().

  • bpo-33809: Add the traceback.TracebackException.print() method which prints the formatted exception information.

  • bpo-42862: sqlite3 now utilizes functools.lru_cache() to implement the connection statement cache. As a small optimisation, the default statement cache size has been increased from 100 to 128. Patch by Erlend E. Aasland.

  • bpo-41818: Soumendra Ganguly: add termios.tcgetwinsize(), termios.tcsetwinsize().

  • bpo-40497: subprocess.check_output() now raises ValueError when the invalid keyword argument check is passed by user code. Previously such use would fail later with a TypeError. Patch by Rémi Lapeyre.

  • bpo-37449: ensurepip now uses importlib.resources.files() traversable APIs

  • bpo-40956: Use Argument Clinic in sqlite3. Patches by Erlend E. Aasland.

  • bpo-41730: DeprecationWarning is now raised when importing tkinter.tix, which has been deprecated in documentation since Python 3.6.

  • bpo-20684: Remove unused _signature_get_bound_param function from inspect - by Anthony Sottile.

  • bpo-41402: Fix email.message.EmailMessage.set_content() when called with binary data and 7bit content transfer encoding.

  • bpo-32695: The compresslevel and preset keyword arguments of tarfile.open() are now both documented and tested.

  • bpo-41137: Use utf-8 encoding while reading .pdbrc files. Patch by Srinivas Reddy Thatiparthy

  • bpo-24391: Improved reprs of threading synchronization objects: Semaphore, BoundedSemaphore, Event and Barrier.

  • bpo-5846: Deprecated the following unittest functions, scheduled for removal in Python 3.13:

    • findTestCases()

    • makeSuite()

    • getTestCaseNames()

    Use TestLoader methods instead:

    Patch by Erlend E. Aasland.

  • bpo-40563: Support pathlike objects on dbm/shelve. Patch by Hakan Çelik and Henry-Joseph Audéoud.

  • bpo-34990: Fixed a Y2k38 bug in the compileall module where it would fail to compile files with a modification time after the year 2038.

  • bpo-39549: Whereas the code for reprlib.Repr had previously used a hardcoded string value of “…”, this PR updates it to use of a “fillvalue” attribute, whose value defaults to “…” and can be reset in either individual reprlib.Repr instances or in subclasses thereof.

  • bpo-37022: pdb now displays exceptions from repr() with its p and pp commands.

  • bpo-38840: Fix test___all__ on platforms lacking a shared memory implementation.

  • bpo-39359: Add one missing check that the password is a bytes object for an encrypted zipfile.

  • bpo-38741: configparser: using “]” inside a section header will no longer cut the section name short at the “]”

  • bpo-38415: Added missing behavior to contextlib.asynccontextmanager() to match contextlib.contextmanager() so decorated functions can themselves be decorators.

  • bpo-30256: Pass multiprocessing BaseProxy argument manager_owned through AutoProxy.

  • bpo-27513: email.utils.getaddresses() now accepts email.header.Header objects along with string values. Patch by Zackery Spytz.

  • bpo-16379: Add SQLite error code and name to sqlite3 exceptions. Patch by Aviv Palivoda, Daniel Shahaf, and Erlend E. Aasland.

  • bpo-26228: pty.spawn no longer hangs on FreeBSD, macOS, and Solaris.

  • bpo-33349: lib2to3 now recognizes async generators everywhere.

  • bpo-29298: Fix TypeError when required subparsers without dest do not receive arguments. Patch by Anthony Sottile.

Documentation

  • bpo-45216: Remove extra documentation listing methods in difflib. It was rendering twice in pydoc and was outdated in some places.

  • bpo-45024: collections.abc documentation has been expanded to explicitly cover how instance and subclass checks work, with additional doctest examples and an exhaustive list of ABCs which test membership purely by presence of the right special methods. Patch by Raymond Hettinger.

  • bpo-44957: Promote PEP 604 union syntax by using it where possible. Also, mention X | Y more prominently in section about Union and mention X | None at all in section about Optional.

  • bpo-16580: Added code equivalents for the int.to_bytes() and int.from_bytes() methods, as well as tests ensuring that these code equivalents are valid.

  • bpo-44903: Removed the othergui.rst file, any references to it, and the list of GUI frameworks in the FAQ. In their place I’ve added links to the Python Wiki page on GUI frameworks.

  • bpo-33479: Tkinter documentation has been greatly expanded with new «Architecture» and «Threading model» sections.

  • bpo-36700: base64 RFC references were updated to point to RFC 4648; a section was added to point users to the new «security considerations» section of the RFC.

  • bpo-44740: Replaced occurrences of uppercase «Web» and «Internet» with lowercase versions per the 2016 revised Associated Press Style Book.

  • bpo-44693: Update the definition of __future__ in the glossary by replacing the confusing word «pseudo-module» with a more accurate description.

  • bpo-35183: Add typical examples to os.path.splitext docs

  • bpo-30511: Clarify that shutil.make_archive() is not thread-safe due to reliance on changing the current working directory.

  • bpo-44561: Update of three expired hyperlinks in Doc/distributing/index.rst: «Project structure», «Building and packaging the project», and «Uploading the project to the Python Packaging Index».

  • bpo-44651: Delete entry «coercion» in Doc/glossary.rst for its outdated definition.

  • bpo-42958: Updated the docstring and docs of filecmp.cmp() to be more accurate and less confusing especially in respect to shallow arg.

  • bpo-44631: Refactored the repr() code of the _Environ (os module).

  • bpo-44613: importlib.metadata is no longer provisional.

  • bpo-44558: Match the docstring and python implementation of countOf() to the behavior of its c implementation.

  • bpo-44544: List all kwargs for textwrap.wrap(), textwrap.fill(), and textwrap.shorten(). Now, there are nav links to attributes of TextWrap, which makes navigation much easier while minimizing duplication in the documentation.

  • bpo-38062: Clarify that atexit uses equality comparisons internally.

  • bpo-40620: Convert examples in tutorial controlflow.rst section 4.3 to be interpreter-demo style.

  • bpo-43066: Added a warning to zipfile docs: filename arg with a leading slash may cause archive to be un-openable on Windows systems.

  • bpo-39452: Rewrote Doc/library/__main__.rst. Broadened scope of the document to explicitly discuss and differentiate between __main__.py in packages versus the __name__ == '__main__' expression (and the idioms that surround it).

  • bpo-13814: In the Design FAQ, answer «Why don’t generators support the with statement?»

  • bpo-27752: Documentation of csv.Dialect is more descriptive.

  • bpo-44453: Fix documentation for the return type of sysconfig.get_path().

  • bpo-44392: Added a new section in the C API documentation for types used in type hinting. Documented Py_GenericAlias and Py_GenericAliasType.

  • bpo-38291: Mark typing.io and typing.re as deprecated since Python 3.8 in the documentation. They were never properly supported by type checkers.

  • bpo-44322: Document that SyntaxError args have a details tuple and that details are adjusted for errors in f-string field replacement expressions.

  • bpo-42392: Document the deprecation and removal of the loop parameter for many functions and classes in asyncio.

  • bpo-44195: Corrected references to TraversableResources in docs. There is no TraversableReader.

  • bpo-41963: Document that ConfigParser strips off comments when reading configuration files.

  • bpo-44072: Correct where in the numeric ABC hierarchy ** support is added, i.e., in numbers.Complex, not numbers.Integral.

  • bpo-43558: Add the remark to dataclasses documentation that the __init__() of any base class has to be called in __post_init__(), along with a code example.

  • bpo-44025: Clarify when “_” in match statements is a keyword, and when not.

  • bpo-41706: Fix docs about how methods like __add__ are invoked when evaluating operator expressions.

  • bpo-41621: Document that collections.defaultdict parameter default_factory defaults to None and is positional-only.

  • bpo-41576: document BaseException in favor of bare except

  • bpo-21760: The description for __file__ fixed. Patch by Furkan Onder

  • bpo-39498: Add a «Security Considerations» index which links to standard library modules that have explicitly documented security considerations.

  • bpo-33479: Remove the unqualified claim that tkinter is threadsafe. It has not been true for several years and likely never was. An explanation of what is true may be added later, after more discussion, and possibly after patching _tkinter.c,

Tests

  • bpo-40173: Fix test.support.import_helper.import_fresh_module().

  • bpo-45280: Add a test case for empty typing.NamedTuple.

  • bpo-45269: Cover case when invalid markers type is supplied to c_make_encoder.

  • bpo-45128: Fix test_multiprocessing_fork failure due to test_logging and sys.modules manipulation.

  • bpo-45209: Fix UserWarning: resource_tracker warning in _test_multiprocessing._TestSharedMemory.test_shared_memory_cleaned_after_process_termination

  • bpo-45185: Enables TestEnumerations test cases in test_ssl suite.

  • bpo-45195: Fix test_readline.test_nonascii(): sometimes, the newline character is not written at the end, so don’t expect it in the output. Patch by Victor Stinner.

  • bpo-45156: Fixes infinite loop on unittest.mock.seal() of mocks created by create_autospec().

  • bpo-45125: Improves pickling tests and docs of SharedMemory and SharableList objects.

  • bpo-44860: Update test_sysconfig.test_user_similar() for the posix_user scheme: platlib doesn’t use sys.platlibdir. Patch by Victor Stinner.

  • bpo-45052: WithProcessesTestSharedMemory.test_shared_memory_basics test was ignored, because self.assertEqual(sms.size, sms2.size) line was failing. It is now removed and test is unskipped.

    The main motivation for this line to be removed from the test is that the size of SharedMemory is not ever guaranteed to be the same. It is decided by the platform.

  • bpo-44895: libregrtest now clears the type cache later to reduce the risk of false alarm when checking for reference leaks. Previously, the type cache was cleared too early and libregrtest raised a false alarm about reference leaks under very specific conditions. Patch by Irit Katriel and Victor Stinner.

  • bpo-45042: Fixes that test classes decorated with @hashlib_helper.requires_hashdigest were skipped all the time.

  • bpo-25130: Add calls of gc.collect() in tests to support PyPy.

  • bpo-45011: Made tests relying on the _asyncio C extension module optional to allow running on alternative Python implementations. Patch by Serhiy Storchaka.

  • bpo-44949: Fix auto history tests of test_readline: sometimes, the newline character is not written at the end, so don’t expect it in the output.

  • bpo-44891: Tests were added to clarify id() is preserved when obj * 1 is used on str and bytes objects. Patch by Nikita Sobolev.

  • bpo-44852: Add ability to wholesale silence DeprecationWarnings while running the regression test suite.

  • bpo-40928: Notify users running test_decimal regression tests on macOS of potential harmless «malloc can’t allocate region» messages spewed by test_decimal.

  • bpo-44734: Fixed floating-point precision issue in turtle tests.

  • bpo-44708: Regression tests, when run with -w, are now re-running only the affected test methods instead of re-running the entire test file.

  • bpo-42095: Added interop tests for Apple plists: generate plist files with Python plistlib and parse with Apple plutil; and the other way round.

  • bpo-44647: Added a permanent Unicode-valued environment variable to regression tests to ensure they handle this use case in the future. If your test environment breaks because of that, report a bug to us, and temporarily set PYTHONREGRTEST_UNICODE_GUARD=0 in your test environment.

  • bpo-44515: Adjust recently added contextlib tests to avoid assuming the use of a refcounted GC

  • bpo-44287: Fix asyncio test_popen() of test_windows_utils by using a longer timeout. Use military grade battle-tested test.support.SHORT_TIMEOUT timeout rather than a hardcoded timeout of 10 seconds: it’s 30 seconds by default, but it is made longer on slow buildbots. Patch by Victor Stinner.

  • bpo-44451: Reset DeprecationWarning filters in test.test_importlib.test_metadata_api.APITests.test_entry_points_by_index to avoid StopIteration error if DeprecationWarnings are ignored.

  • bpo-44363: Account for address sanitizer in test_capi. test_capi now passes when run GCC address sanitizer.

  • bpo-44364: Add non integral tests for math.sqrt() function.

  • bpo-43921: Fix test_ssl.test_wrong_cert_tls13(): use suppress_ragged_eofs=False, since read() can raise ssl.SSLEOFError on Windows. Patch by Victor Stinner.

  • bpo-43921: Fix test_pha_required_nocert() of test_ssl: catch two more EOF cases (when the recv() method returns an empty string). Patch by Victor Stinner.

  • bpo-44131: Add test_frozenmain to test_embed to test the Py_FrozenMain() C function. Patch by Victor Stinner.

  • bpo-31904: Ignore error string case in test_file_not_exists().

  • bpo-42083: Add test to check that PyStructSequence_NewType accepts a PyStructSequence_Desc with doc field set to NULL.

  • bpo-35753: Fix crash in doctest when doctest parses modules that include unwrappable functions by skipping those functions.

  • bpo-30256: Add test for nested queues when using multiprocessing shared objects AutoProxy[Queue] inside ListProxy and DictProxy

Build

  • bpo-45220: Avoid building with the Windows 11 SDK previews automatically. This may be overridden by setting the DefaultWindowsSDKVersion environment variable before building.

  • bpo-45020: Freeze stdlib modules that are imported during startup. This provides significant performance improvements to startup. If necessary, use the previously added «-X frozen_modules=off» commandline option to force importing the source modules.

  • bpo-45188: Windows builds now regenerate frozen modules as the first part of the build. Previously the regeneration was later in the build, which would require it to be restarted if any modules had changed.

  • bpo-45163: Fixes Haiku platform build.

  • bpo-45067: The ncurses function extended_color_content was introduced in 2017

    (https://invisible-island.net/ncurses/NEWS.html#index-t20170401). The

    ncurses-devel package in CentOS 7 had a older version ncurses resulted in compilation error. For compiling ncurses with extended color support, we verify the version of the ncurses library >= 20170401.

  • bpo-45019: Generate lines in relevant files for frozen modules. Up until now each of the files had to be edited manually. This change makes it easier to add to and modify the frozen modules.

  • bpo-44340: Add support for building with clang thin lto via –with-lto=thin/full. Patch by Donghee Na and Brett Holman.

  • bpo-44535: Enable building using a Visual Studio 2022 install on Windows.

  • bpo-43298: Improved error message when building without a Windows SDK installed.

  • bpo-44381: The Windows build now accepts EnableControlFlowGuard set to guard to enable CFG.

  • bpo-41282: Fix broken make install that caused standard library extension modules to be unnecessarily and incorrectly rebuilt during the install phase of cpython.

Windows

macOS

  • bpo-45007: Update macOS installer builds to use OpenSSL 1.1.1l.

  • bpo-34602: When building CPython on macOS with ./configure --with-undefined-behavior-sanitizer --with-pydebug, the stack size is now quadrupled to allow for the entire test suite to pass.

  • bpo-44848: Update macOS installer to use SQLite 3.36.0.

  • bpo-44689: ctypes.util.find_library() now works correctly on macOS 11 Big Sur even if Python is built on an older version of macOS. Previously, when built on older macOS systems, find_library was not able to find macOS system libraries when running on Big Sur due to changes in how system libraries are stored.

  • bpo-41972: The framework build’s user header path in sysconfig is changed to add a “pythonX.Y” component to match distutils’s behavior.

  • bpo-43109: Allow –with-lto configure option to work with Apple-supplied Xcode or Command Line Tools.

  • bpo-34932: Add socket.TCP_KEEPALIVE support for macOS. Patch by Shane Harvey.

IDLE

  • bpo-45296: On Windows, change exit/quit message to suggest Ctrl-D, which works, instead of <Ctrl-Z Return>, which does not work in IDLE.

  • bpo-45193: Make completion boxes appear on Ubuntu again.

  • bpo-40128: Mostly fix completions on macOS when not using tcl/tk 8.6.11 (as with 3.9). The added update_idletask call should be harmless and possibly helpful otherwise.

  • bpo-33962: Move the indent space setting from the Font tab to the new Windows tab. Patch by Mark Roseman and Terry Jan Reedy.

  • bpo-40468: Split the settings dialog General tab into Windows and Shell/ED tabs. Move help sources, which extend the Help menu, to the Extensions tab. Make space for new options and shorten the dialog. The latter makes the dialog better fit small screens.

  • bpo-41611: Avoid uncaught exceptions in AutoCompleteWindow.winconfig_event().

  • bpo-41611: Fix IDLE sometimes freezing upon tab-completion on macOS.

  • bpo-44010: Highlight the new match statement’s soft keywords: match, case, and _. However, this highlighting is not perfect and will be incorrect in some rare cases, including some _-s in case patterns.

  • bpo-44026: Include interpreter’s typo fix suggestions in message line for NameErrors and AttributeErrors. Patch by E. Paine.

Tools/Demos

  • bpo-44786: Fix a warning in regular expression in the c-analyzer script.

  • bpo-44967: pydoc now returns a non-zero status code when a module cannot be found.

  • bpo-44978: Allow the Argument Clinic tool to handle __complex__ special methods.

  • bpo-43425: Removed the “test2to3” demo project that demonstrated using lib2to3 to support Python 2.x and Python 3.x from a single source in a distutils package. Patch by Donghee Na

  • bpo-44074: Make patchcheck automatically detect the correct base branch name (previously it was hardcoded to “master”)

  • bpo-20291: Added support for variadic positional parameters in Argument Clinic.

C API

  • bpo-41710: The PyThread_acquire_lock_timed() function now clamps the timeout if it is too large, rather than aborting the process. Patch by Victor Stinner.

  • bpo-44687: BufferedReader.peek() no longer raises ValueError when the entire file has already been buffered.

  • bpo-45116: Add the Py_ALWAYS_INLINE macro to ask the compiler to always inline a static inline function. The compiler can ignore it and decides to not inline the function. Patch by Victor Stinner.

  • bpo-45094: Add the Py_NO_INLINE macro to disable inlining on a function. Patch by Victor Stinner.

  • bpo-45061: Add a deallocator to the bool type to detect refcount bugs in C extensions which call Py_DECREF(Py_True); or Py_DECREF(Py_False); by mistake. Patch by Victor Stinner.

  • bpo-42035: Add a new PyType_GetQualName() function to get type’s qualified name.

  • bpo-41103: Reverts removal of the old buffer protocol because they are part of stable ABI.

  • bpo-44751: Remove crypt.h include from the public Python.h header.

  • bpo-42747: The Py_TPFLAGS_HAVE_VERSION_TAG type flag now does nothing. The Py_TPFLAGS_HAVE_AM_SEND flag (which was added in 3.10) is removed. Both were unnecessary because it is not possible to have type objects with the relevant fields missing.

  • bpo-44530: Added the co_qualname to the PyCodeObject structure to propagate the qualified name from the compiler to code objects.

    Patch by Gabriele N. Tornetta

  • bpo-44441: Py_RunMain() now resets PyImport_Inittab to its initial value at exit. It must be possible to call PyImport_AppendInittab() or PyImport_ExtendInittab() at each Python initialization. Patch by Victor Stinner.

  • bpo-39947: Remove 4 private trashcan C API functions which were only kept for the backward compatibility of the stable ABI with Python 3.8 and older, since the trashcan API was not usable with the limited C API on Python 3.8 and older. The trashcan API was excluded from the limited C API in Python 3.9.

    Removed functions:

    • _PyTrash_deposit_object()

    • _PyTrash_destroy_chain()

    • _PyTrash_thread_deposit_object()

    • _PyTrash_thread_destroy_chain()

    The trashcan C API was never usable with the limited C API, since old trashcan macros accessed directly PyThreadState members like _tstate->trash_delete_nesting, whereas the PyThreadState structure is opaque in the limited C API.

    Exclude also the PyTrash_UNWIND_LEVEL constant from the C API.

    Patch by Victor Stinner.

  • bpo-40939: Removed documentation for the removed PyParser_* C API.

  • bpo-43795: The list in Contenido de la API limitada now shows the public name PyFrameObject rather than _frame. The non-existing entry _node no longer appears in the list.

  • bpo-44378: Py_IS_TYPE() no longer uses Py_TYPE() to avoid a compiler warning: no longer cast const PyObject* to PyObject*. Patch by Victor Stinner.

  • bpo-39573: Convert the Py_TYPE() and Py_SIZE() macros to static inline functions. The Py_SET_TYPE() and Py_SET_SIZE() functions must now be used to set an object type and size. Patch by Victor Stinner.

  • bpo-44263: The PyType_Ready() function now raises an error if a type is defined with the Py_TPFLAGS_HAVE_GC flag set but has no traverse function (PyTypeObject.tp_traverse). Patch by Victor Stinner.

  • bpo-43795: The undocumented function Py_FrozenMain() is removed from the Limited API.

  • bpo-44113: Deprecate the following functions to configure the Python initialization:

    • PySys_AddWarnOptionUnicode()

    • PySys_AddWarnOption()

    • PySys_AddXOption()

    • PySys_HasWarnOptions()

    • Py_SetPath()

    • Py_SetProgramName()

    • Py_SetPythonHome()

    • Py_SetStandardStreamEncoding()

    • _Py_SetProgramFullPath()

    Use the new PyConfig API of the Python Initialization Configuration instead (PEP 587).

  • bpo-44094: Remove PyErr_SetFromErrnoWithUnicodeFilename(), PyErr_SetFromWindowsErrWithUnicodeFilename(), and PyErr_SetExcFromWindowsErrWithUnicodeFilename(). They are not documented and have been deprecated since Python 3.3.

  • bpo-43795: PyCodec_Unregister() is now properly exported as a function in the Windows Stable ABI DLL.

  • bpo-44029: Remove deprecated Py_UNICODE APIs: PyUnicode_Encode, PyUnicode_EncodeUTF7, PyUnicode_EncodeUTF8, PyUnicode_EncodeUTF16, PyUnicode_EncodeUTF32, PyUnicode_EncodeLatin1, PyUnicode_EncodeMBCS, PyUnicode_EncodeDecimal, PyUnicode_EncodeRawUnicodeEscape, PyUnicode_EncodeCharmap, PyUnicode_EncodeUnicodeEscape, PyUnicode_TransformDecimalToASCII, PyUnicode_TranslateCharmap, PyUnicodeEncodeError_Create, PyUnicodeTranslateError_Create. See PEP 393 and PEP 624 for reference.

  • bpo-42035: Add a new PyType_GetName() function to get type’s short name.

Python 3.10.0 beta 1

Release date: 2021-05-03

Security

  • bpo-43434: Creating sqlite3.Connection objects now also produces sqlite3.connect and sqlite3.connect/handle auditing events. Previously these events were only produced by sqlite3.connect() calls. Patch by Erlend E. Aasland.

  • bpo-43998: The ssl module sets more secure cipher suites defaults. Ciphers without forward secrecy and with SHA-1 MAC are disabled by default. Security level 2 prohibits weak RSA, DH, and ECC keys with less than 112 bits of security. SSLContext defaults to minimum protocol version TLS 1.2. Settings are based on Hynek Schlawack’s research.

  • bpo-43882: The presence of newline or tab characters in parts of a URL could allow some forms of attacks.

    Following the controlling specification for URLs defined by WHATWG urllib.parse() now removes ASCII newlines and tabs from URLs, preventing such attacks.

  • bpo-43472: Ensures interpreter-level audit hooks receive the cpython.PyInterpreterState_New event when called through the _xxsubinterpreters module.

  • bpo-43362: Fix invalid free in _sha3 module. The issue was introduced in 3.10.0a1. Python 3.9 and earlier are not affected.

  • bpo-43762: Add audit events for sqlite3.connect/handle(), sqlite3.Connection.enable_load_extension(), and sqlite3.Connection.load_extension(). Patch by Erlend E. Aasland.

  • bpo-43756: Add new audit event glob.glob/2 to incorporate the new root_dir and dir_fd arguments added to glob.glob() and glob.iglob().

  • bpo-36384: ipaddress module no longer accepts any leading zeros in IPv4 address strings. Leading zeros are ambiguous and interpreted as octal notation by some libraries. For example the legacy function socket.inet_aton() treats leading zeros as octal notation. glibc implementation of modern inet_pton() does not accept any leading zeros. For a while the ipaddress module used to accept ambiguous leading zeros.

  • bpo-43075: Fix Regular Expression Denial of Service (ReDoS) vulnerability in urllib.request.AbstractBasicAuthHandler. The ReDoS-vulnerable regex has quadratic worst-case complexity and it allows cause a denial of service when identifying crafted invalid RFCs. This ReDoS issue is on the client side and needs remote attackers to control the HTTP server.

  • bpo-42800: Audit hooks are now fired for frame.f_code, traceback.tb_frame, and generator code/frame attribute access.

  • bpo-37363: Add audit events to the http.client module.

Core and Builtins

  • bpo-43977: Prevent classes being both a sequence and a mapping when pattern matching.

  • bpo-43977: Use tp_flags on the class object to determine if the subject is a sequence or mapping when pattern matching. Avoids the need to import collections.abc when pattern matching.

  • bpo-43892: Restore proper validation of complex literal value patterns when parsing match blocks.

  • bpo-43933: Set frame.f_lineno to the line number of the “with” kweyword when executing the call to __exit__.

  • bpo-43933: If the current position in a frame has no line number then set the f_lineno attribute to None, instead of -1, to conform to PEP 626. This should not normally be possible, but might occur in some unusual circumstances.

  • bpo-43963: Importing the _signal module in a subinterpreter has no longer side effects.

  • bpo-42739: The internal representation of line number tables is changed to not use sentinels, and an explicit length parameter is added to the out of process API function PyLineTable_InitAddressRange. This makes the handling of line number tables more robust in some circumstances.

  • bpo-43908: Make re types immutable. Patch by Erlend E. Aasland.

  • bpo-43908: Make the array.array type immutable. Patch by Erlend E. Aasland.

  • bpo-43901: Change class and module objects to lazy-create empty annotations dicts on demand. The annotations dicts are stored in the object’s __dict__ for backwards compatibility.

  • bpo-43892: Match patterns now use new dedicated AST nodes (MatchValue, MatchSingleton, MatchSequence, MatchStar, MatchMapping, MatchClass) rather than reusing expression AST nodes. MatchAs and MatchOr are now defined as pattern nodes rather than as expression nodes. Patch by Nick Coghlan.

  • bpo-42725: Usage of await/yield/yield from and named expressions within an annotation is now forbidden when PEP 563 is activated.

  • bpo-43754: When performing structural pattern matching (PEP 634), captured names are now left unbound until the entire pattern has matched successfully.

  • bpo-42737: Annotations for complex targets (everything beside simple names) no longer cause any runtime effects with from __future__ import annotations.

  • bpo-43914: SyntaxError exceptions raised by the interpreter will highlight the full error range of the expression that constitutes the syntax error itself, instead of just where the problem is detected. Patch by Pablo Galindo.

  • bpo-38605: Revert making from __future__ import annotations the default. This follows the Steering Council decision to postpone PEP 563 changes to at least Python 3.11. See the original email for more information regarding the decision: https://mail.python.org/archives/list/python-dev@python.org/thread/CLVXXPQ2T2LQ5MP2Y53VVQFCXYWQJHKZ/. Patch by Pablo Galindo.

  • bpo-43475: Hashes of NaN values now depend on object identity. Formerly, they always hashed to 0 even though NaN values are not equal to one another. Having the same hash for unequal values caused pile-ups in hash tables.

  • bpo-43859: Improve the error message for IndentationError exceptions. Patch by Pablo Galindo

  • bpo-41323: Constant tuple folding in bytecode optimizer now reuses tuple in constant table.

  • bpo-43846: Data stack usage is much reduced for large literal and call expressions.

  • bpo-38530: When printing NameError raised by the interpreter, PyErr_Display() will offer suggestions of similar variable names in the function that the exception was raised from. Patch by Pablo Galindo

  • bpo-43823: Improve syntax errors for invalid dictionary literals. Patch by Pablo Galindo.

  • bpo-43822: Improve syntax errors in the parser for missing commas between expressions. Patch by Pablo Galindo.

  • bpo-43798: ast.alias nodes now include source location metadata attributes e.g. lineno, col_offset.

  • bpo-43797: Improve SyntaxError error messages for invalid comparisons. Patch by Pablo Galindo.

  • bpo-43760: Move the flag for checking whether tracing is enabled to the C stack, from the heap. Should speed up dispatch in the interpreter.

  • bpo-43682: Static methods (@staticmethod) and class methods (@classmethod) now inherit the method attributes (__module__, __name__, __qualname__, __doc__, __annotations__) and have a new __wrapped__ attribute. Patch by Victor Stinner.

  • bpo-43751: Fixed a bug where anext(ait, default) would erroneously return None.

  • bpo-42128: __match_args__ is no longer allowed to be a list.

  • bpo-43683: Add GEN_START opcode. Marks start of generator, including async, or coroutine and handles sending values to a newly created generator or coroutine.

  • bpo-43105: Importlib now resolves relative paths when creating module spec objects from file locations.

  • bpo-43682: Static methods (@staticmethod) are now callable as regular functions. Patch by Victor Stinner.

  • bpo-42609: Prevented crashes in the AST validator and optimizer when compiling some absurdly long expressions like "+0"*1000000. RecursionError is now raised instead.

  • bpo-38530: When printing AttributeError, PyErr_Display() will offer suggestions of similar attribute names in the object that the exception was raised from. Patch by Pablo Galindo

Library

  • bpo-44015: In @dataclass(), raise a TypeError if KW_ONLY is specified more than once.

  • bpo-25478: Added a total() method to collections.Counter() to compute the sum of the counts.

  • bpo-43733: Change netrc.netrc to use UTF-8 encoding before using locale encoding.

  • bpo-43979: Removed an unnecessary list comprehension before looping from urllib.parse.parse_qsl(). Patch by Christoph Zwerschke and Donghee Na.

  • bpo-43993: Update bundled pip to 21.1.1.

  • bpo-43957: [Enum] Deprecate TypeError when non-member is used in a containment check; In 3.12 True or False will be returned instead, and containment will return True if the value is either a member of that enum or one of its members” value.

  • bpo-42904: For backwards compatibility with previous minor versions of Python, if typing.get_type_hints() receives no namespace dictionary arguments, typing.get_type_hints() will search through the global then local namespaces during evaluation of stringized type annotations (string forward references) inside a class.

  • bpo-43945: [Enum] Deprecate non-standard mixin format() behavior: in 3.12 the enum member, not the member’s value, will be used for format() calls.

  • bpo-41139: Deprecate undocumented cgi.log() API.

  • bpo-43937: Fixed the turtle module working with non-default root window.

  • bpo-43930: Update bundled pip to 21.1 and setuptools to 56.0.0

  • bpo-43907: Fix a bug in the pure-Python pickle implementation when using protocol 5, where bytearray instances that occur several time in the pickled object graph would incorrectly unpickle into repeated copies of the bytearray object.

  • bpo-43926: In importlib.metadata, provide a uniform interface to Description, allow for any field to be encoded with multiline values, remove continuation lines from multiline values, and add a .json property for easy access to the PEP 566 JSON-compatible form. Sync with importlib_metadata 4.0.

  • bpo-43920: OpenSSL 3.0.0: load_verify_locations() now returns a consistent error message when cadata contains no valid certificate.

  • bpo-43607: urllib can now convert Windows paths with \\?\ prefixes into URL paths.

  • bpo-43817: Add inspect.get_annotations(), which safely computes the annotations defined on an object. It works around the quirks of accessing the annotations from various types of objects, and makes very few assumptions about the object passed in. inspect.get_annotations() can also correctly un-stringize stringized annotations.

    inspect.signature(), inspect.from_callable(), and inspect.from_function() now call inspect.get_annotations() to retrieve annotations. This means inspect.signature() and inspect.from_callable() can now un-stringize stringized annotations, too.

  • bpo-43284: platform.win32_ver derives the windows version from sys.getwindowsversion().platform_version which in turn derives the version from kernel32.dll (which can be of a different version than Windows itself). Therefore change the platform.win32_ver to determine the version using the platform module’s _syscmd_ver private function to return an accurate version.

  • bpo-42854: The ssl module now uses SSL_read_ex and SSL_write_ex internally. The functions support reading and writing of data larger than 2 GB. Writing zero-length data no longer fails with a protocol violation error.

  • bpo-42333: Port _ssl extension module to multiphase initialization.

  • bpo-43880: ssl now raises DeprecationWarning for OP_NO_SSL/TLS* options, old TLS versions, old protocols, and other features that have been deprecated since Python 3.6, 3.7, or OpenSSL 1.1.0.

  • bpo-41559: PEP 612 is now implemented purely in Python; builtin types.GenericAlias objects no longer include typing.ParamSpec in __parameters__ (with the exception of collections.abc.Callable“s GenericAlias). This means previously invalid uses of ParamSpec (such as list[P]) which worked in earlier versions of Python 3.10 alpha, will now raise TypeError during substitution.

  • bpo-43867: The multiprocessing Server class now explicitly catches SystemExit and closes the client connection in this case. It happens when the Server.serve_client() method reaches the end of file (EOF).

  • bpo-40443: Remove unused imports: pyclbr no longer uses copy, and typing no longer uses ast. Patch by Victor Stinner.

  • bpo-43820: Remove an unneeded copy of the namespace passed to dataclasses.make_dataclass().

  • bpo-43787: Add __iter__() method to bz2.BZ2File, gzip.GzipFile, and lzma.LZMAFile. It makes iterating them about 2x faster. Patch by Inada Naoki.

  • bpo-43680: Deprecate io.OpenWrapper and _pyio.OpenWrapper: use io.open and _pyio.open instead. Until Python 3.9, _pyio.open was not a static method and builtins.open was set to OpenWrapper to not become a bound method when set to a class variable. _io.open is a built-in function whereas _pyio.open is a Python function. In Python 3.10, _pyio.open() is now a static method, and builtins.open() is now io.open().

  • bpo-43680: The Python _pyio.open() function becomes a static method to behave as io.open() built-in function: don’t become a bound method when stored as a class variable. It becomes possible since static methods are now callable in Python 3.10. Moreover, _pyio.OpenWrapper() becomes a simple alias to _pyio.open(). Patch by Victor Stinner.

  • bpo-41515: Fix KeyError raised in typing.get_type_hints() due to synthetic modules that don’t appear in sys.modules.

  • bpo-43776: When subprocess.Popen args are provided as a string or as pathlib.Path, the Popen instance repr now shows the right thing.

  • bpo-42248: [Enum] ensure exceptions raised in _missing__ are released

  • bpo-43744: fix issue with enum member name matching the start of a private variable name

  • bpo-43772: Fixed the return value of TypeVar.__ror__. Patch by Jelle Zijlstra.

  • bpo-43764: Add match_args parameter to @dataclass decorator to allow suppression of __match_args__ generation.

  • bpo-43799: OpenSSL 3.0.0: define OPENSSL_API_COMPAT 1.1.1 to suppress deprecation warnings. Python requires OpenSSL 1.1.1 APIs.

  • bpo-43478: Mocks can no longer be used as the specs for other Mocks. As a result, an already-mocked object cannot have an attribute mocked using autospec=True or be the subject of a create_autospec(...) call. This can uncover bugs in tests since these Mock-derived Mocks will always pass certain tests (e.g. isinstance()) and builtin assert functions (e.g. assert_called_once_with) will unconditionally pass.

  • bpo-43794: Add ssl.OP_IGNORE_UNEXPECTED_EOF constants (OpenSSL 3.0.0)

  • bpo-43785: Improve bz2.BZ2File performance by removing the RLock from BZ2File. This makes BZ2File thread unsafe in the face of multiple simultaneous readers or writers, just like its equivalent classes in gzip and lzma have always been. Patch by Inada Naoki.

  • bpo-43789: OpenSSL 3.0.0: Don’t call the password callback function a second time when first call has signaled an error condition.

  • bpo-43788: The header files for ssl error codes are now OpenSSL version-specific. Exceptions will now show correct reason and library codes. The make_ssl_data.py script has been rewritten to use OpenSSL’s text file with error codes.

  • bpo-43766: Implement PEP 647 in the typing module by adding TypeGuard.

  • bpo-25264: os.path.realpath() now accepts a strict keyword-only argument. When set to True, OSError is raised if a path doesn’t exist or a symlink loop is encountered.

  • bpo-43780: In importlib.metadata, incorporate changes from importlib_metadata 3.10: Add mtime-based caching during distribution discovery. Flagged use of dict result from entry_points() as deprecated.

  • gh-47383: The P.args and P.kwargs attributes of typing.ParamSpec are now instances of the new classes typing.ParamSpecArgs and typing.ParamSpecKwargs, which enables a more useful repr(). Patch by Jelle Zijlstra.

  • bpo-43731: Add an encoding parameter logging.fileConfig().

  • bpo-43712: Add encoding and errors parameters to fileinput.input() and fileinput.FileInput.

  • bpo-38659: A simple_enum decorator is added to the enum module to convert a normal class into an Enum. test_simple_enum added to test simple enums against a corresponding normal Enum. Standard library modules updated to use simple_enum.

  • bpo-43764: Fix an issue where __match_args__ generation could fail for some dataclasses.

  • bpo-43752: Fix sqlite3 regression for zero-sized blobs with converters, where b"" was returned instead of None. The regression was introduced by PR 24723. Patch by Erlend E. Aasland.

  • bpo-43655: tkinter dialog windows are now recognized as dialogs by window managers on macOS and X Window.

  • bpo-43723: The following threading methods are now deprecated and should be replaced:

    Patch by Jelle Zijlstra.

  • bpo-2135: Deprecate find_module() and find_loader() implementations in importlib and zipimport.

  • bpo-43534: turtle.textinput() and turtle.numinput() create now a transient window working on behalf of the canvas window.

  • bpo-43532: Add the ability to specify keyword-only fields to dataclasses. These fields will become keyword-only arguments to the generated __init__.

  • bpo-43522: Fix problem with hostname_checks_common_name. OpenSSL does not copy hostflags from struct SSL_CTX to struct SSL.

  • bpo-8978: Improve error message for tarfile.open() when lzma / bz2 are unavailable. Patch by Anthony Sottile.

  • bpo-42967: Allow bytes separator argument in urllib.parse.parse_qs and urllib.parse.parse_qsl when parsing str query strings. Previously, this raised a TypeError.

  • bpo-43296: Improve sqlite3 error handling: sqlite3_value_blob() errors that set SQLITE_NOMEM now raise MemoryError. Patch by Erlend E. Aasland.

  • bpo-43312: New functions sysconfig.get_preferred_scheme() and sysconfig.get_default_scheme() are added to query a platform for its preferred «user», «home», and «prefix» (default) scheme names.

  • bpo-43265: Improve sqlite3.Connection.backup() error handling. The error message for non-existent target database names is now unknown database <database name> instead of SQL logic error. Patch by Erlend E. Aasland.

  • bpo-41282: Install schemes in distutils.command.install are now loaded from sysconfig.

  • bpo-41282: distutils.sysconfig has been merged to sysconfig.

  • bpo-43176: Fixed processing of a dataclass that inherits from a frozen dataclass with no fields. It is now correctly detected as an error.

  • bpo-43080: pprint now has support for dataclasses.dataclass. Patch by Lewis Gaul.

  • bpo-39950: Add pathlib.Path.hardlink_to() method that supersedes link_to(). The new method has the same argument order as symlink_to().

  • bpo-42904: typing.get_type_hints() now checks the local namespace of a class when evaluating PEP 563 annotations inside said class.

  • bpo-42269: Add slots parameter to dataclasses.dataclass decorator to automatically generate __slots__ for class. Patch provided by Yurii Karabas.

  • bpo-39529: Deprecated use of asyncio.get_event_loop() without running event loop. Emit deprecation warning for asyncio functions which implicitly create a Future or Task objects if there is no running event loop and no explicit loop argument is passed: ensure_future(), wrap_future(), gather(), shield(), as_completed() and constructors of Future, Task, StreamReader, StreamReaderProtocol.

  • bpo-18369: Certificate and PrivateKey classes were added to the ssl module. Certificates and keys can now be loaded from memory buffer, too.

  • bpo-41486: Use a new output buffer management code for bz2 / lzma / zlib modules, and add .readall() function to _compression.DecompressReader class. These bring some performance improvements. Patch by Ma Lin.

  • bpo-31870: The ssl.get_server_certificate() function now has a timeout parameter.

  • bpo-41735: Fix thread locks in zlib module may go wrong in rare case. Patch by Ma Lin.

  • bpo-36470: Fix dataclasses with InitVars and replace(). Patch by Claudiu Popa.

  • bpo-40849: Expose X509_V_FLAG_PARTIAL_CHAIN ssl flag

  • bpo-35114: ssl.RAND_status() now returns a boolean value (as documented) instead of 1 or 0.

  • bpo-39906: pathlib.Path.stat() and chmod() now accept a follow_symlinks keyword-only argument for consistency with corresponding functions in the os module.

  • bpo-39899: os.path.expanduser() now refuses to guess Windows home directories if the basename of current user’s home directory does not match their username.

    pathlib.Path.expanduser() and home() now consistently raise RuntimeError exception when a home directory cannot be resolved. Previously a KeyError exception could be raised on Windows when the "USERNAME" environment variable was unset.

  • bpo-36076: Added SNI support to ssl.get_server_certificate().

  • bpo-38490: Covariance, Pearson’s correlation, and simple linear regression functionality was added to statistics module. Patch by Tymoteusz Wołodźko.

  • bpo-33731: Provide a locale.localize() function, which converts a normalized number string into a locale format.

  • bpo-32745: Fix a regression in the handling of ctypes” ctypes.c_wchar_p type: embedded null characters would cause a ValueError to be raised. Patch by Zackery Spytz.

Documentation

  • bpo-43987: Add «Annotations Best Practices» document as a new HOWTO.

  • bpo-43977: Document the new Py_TPFLAGS_MAPPING and Py_TPFLAGS_SEQUENCE type flags.

  • bpo-43959: The documentation on the PyContextVar C-API was clarified.

  • bpo-43938: Update dataclasses documentation to express that FrozenInstanceError is derived from AttributeError.

  • bpo-43778: Fix the Sphinx glossary_search extension: create the _static/ sub-directory if it doesn’t exist.

  • bpo-43755: Update documentation to reflect that unparenthesized lambda expressions can no longer be the expression part in an if clause in comprehensions and generator expressions since Python 3.9.

  • bpo-43739: Fixing the example code in Doc/extending/extending.rst to declare and initialize the pmodule variable to be of the right type.

Tests

  • bpo-43961: Fix test_logging.test_namer_rotator_inheritance() on Windows: use os.replace() rather than os.rename(). Patch by Victor Stinner.

  • bpo-43842: Fix a race condition in the SMTP test of test_logging. Don’t close a file descriptor (socket) from a different thread while asyncore.loop() is polling the file descriptor. Patch by Victor Stinner.

  • bpo-43843: test.libregrtest now marks a test as ENV_CHANGED (altered the execution environment) if a thread raises an exception but does not catch it. It sets a hook on threading.excepthook(). Use --fail-env-changed option to mark the test as failed. Patch by Victor Stinner.

  • bpo-43811: Tests multiple OpenSSL versions on GitHub Actions. Use ccache to speed up testing.

  • bpo-43791: OpenSSL 3.0.0: Disable testing of legacy protocols TLS 1.0 and 1.1. Tests are failing with TLSV1_ALERT_INTERNAL_ERROR.

Build

  • bpo-43567: Improved generated code refresh (AST/tokens/opcodes/keywords) on Windows.

  • bpo-43669: Implement PEP 644. Python now requires OpenSSL 1.1.1 or newer.

Windows

  • bpo-35306: Adds additional arguments to os.startfile() function.

  • bpo-43538: Avoid raising errors from pathlib.Path.exists() when passed an invalid filename.

  • bpo-38822: Fixed os.stat() failing on inaccessible directories with a trailing slash, rather than falling back to the parent directory’s metadata. This implicitly affected os.path.exists() and os.path.isdir().

  • bpo-26227: Fixed decoding of host names in socket.gethostbyaddr() and socket.gethostbyname_ex().

  • bpo-40432: Updated pegen regeneration script on Windows to find and use Python 3.8 or higher. Prior to this, pegen regeneration already required 3.8 or higher, but the script may have used lower versions of Python.

  • bpo-43745: Actually updates Windows release to OpenSSL 1.1.1k. Earlier releases were mislabelled and actually included 1.1.1i again.

  • bpo-43652: Update Tcl and Tk to 8.6.11 in Windows installer.

  • bpo-43492: Upgrade Windows installer to use SQLite 3.35.5.

  • bpo-30555: Fix WindowsConsoleIO errors in the presence of fd redirection. Patch by Segev Finer.

macOS

  • bpo-42119: Fix check for macOS SDK paths when building Python. Narrow search to match contents of SDKs, namely only files in /System/Library, /System/IOSSupport, and /usr other than /usr/local. Previously, anything under /System was assumed to be in an SDK which causes problems with the new file system layout in 10.15+ where user file systems may appear to be mounted under /System. Paths in /Library were also incorrectly treated as SDK locations.

  • bpo-43568: Drop support for MACOSX_DEPLOYMENT_TARGET < 10.3

  • bpo-44009: Provide «python3.x-intel64» executable to allow reliably forcing macOS universal2 framework builds to run under Rosetta 2 Intel-64 emulation on Apple Silicon Macs. This can be useful for testing or when universal2 wheels are not yet available.

  • bpo-43851: Build SQLite with SQLITE_OMIT_AUTOINIT on macOS. Patch by Erlend E. Aasland.

  • bpo-43492: Update macOS installer to use SQLite 3.35.4.

  • bpo-42235: Mac/BuildScript/build-installer.py will now use «–enable-optimizations» and --with-lto when building on macOS 10.15 or later.

IDLE

  • bpo-37903: Add mouse actions to the shell sidebar. Left click and optional drag selects one or more lines, as with the editor line number sidebar. Right click after selecting raises a context menu with “copy with prompts”. This zips together prompts from the sidebar with lines from the selected text.

  • bpo-43981: Fix reference leak in test_sidebar and test_squeezer. Patches by Terry Jan Reedy and Pablo Galindo

  • bpo-37892: Indent IDLE Shell input with spaces instead of tabs

  • bpo-43655: IDLE dialog windows are now recognized as dialogs by window managers on macOS and X Window.

  • bpo-37903: IDLE’s shell now shows prompts in a separate side-bar.

C API

  • bpo-43916: Add a new Py_TPFLAGS_DISALLOW_INSTANTIATION type flag to disallow creating type instances. Patch by Victor Stinner.

  • bpo-43774: Remove the now unused PYMALLOC_DEBUG macro. Debug hooks on memory allocators are now installed by default if Python is built in debug mode (if Py_DEBUG macro is defined). Moreover, they can now be used on Python build in release mode (ex: using PYTHONMALLOC=debug environment variable).

  • bpo-43962: _PyInterpreterState_IDIncref() now calls _PyInterpreterState_IDInitref() and always increments id_refcount. Previously, calling _xxsubinterpreters.get_current() could create an id_refcount inconsistency when a _xxsubinterpreters.InterpreterID object was deallocated. Patch by Victor Stinner.

  • bpo-28254: Add new C-API functions to control the state of the garbage collector: PyGC_Enable(), PyGC_Disable(), PyGC_IsEnabled(), corresponding to the functions in the gc module.

  • bpo-43908: Introduce Py_TPFLAGS_IMMUTABLETYPE flag for immutable type objects, and modify PyType_Ready() to set it for static types. Patch by Erlend E. Aasland.

  • bpo-43795: PyMem_Calloc() is now available in the limited C API (Py_LIMITED_API).

  • bpo-43868: PyOS_ReadlineFunctionPointer() is no longer exported by limited C API headers and by python3.dll on Windows. Like any function that takes FILE*, it is not part of the stable ABI.

  • bpo-43795: Stable ABI and limited API definitions are generated from a central manifest (PEP 652).

  • bpo-43753: Add the Py_Is(x, y) function to test if the x object is the y object, the same as x is y in Python. Add also the Py_IsNone(), Py_IsTrue(), Py_IsFalse() functions to test if an object is, respectively, the None singleton, the True singleton or the False singleton. Patch by Victor Stinner.

Python 3.10.0 alpha 7

Release date: 2021-04-05

Security

  • bpo-42988: CVE 2021-3426: Remove the getfile feature of the pydoc module which could be abused to read arbitrary files on the disk (directory traversal vulnerability). Moreover, even source code of Python modules can contain sensitive data like passwords. Vulnerability reported by David Schwörer.

  • bpo-43285: ftplib no longer trusts the IP address value returned from the server in response to the PASV command by default. This prevents a malicious FTP server from using the response to probe IPv4 address and port combinations on the client network.

    Code that requires the former vulnerable behavior may set a trust_server_pasv_ipv4_address attribute on their ftplib.FTP instances to True to re-enable it.

  • bpo-43439: Add audit hooks for gc.get_objects(), gc.get_referrers() and gc.get_referents(). Patch by Pablo Galindo.

Core and Builtins

  • bpo-27129: Update CPython bytecode magic number.

  • bpo-43672: Raise ImportWarning when calling find_loader().

  • bpo-43660: Fix crash that happens when replacing sys.stderr with a callable that can remove the object while an exception is being printed. Patch by Pablo Galindo.

  • bpo-27129: The bytecode interpreter uses instruction, rather byte, offsets internally. This reduces the number of EXTENDED_ARG instructions needed and streamlines instruction dispatch a bit.

  • bpo-40645: Fix reference leak in the _hashopenssl extension. Patch by Pablo Galindo.

  • bpo-42134: Calls to find_module() by the import system now raise ImportWarning.

  • bpo-41064: Improve the syntax error for invalid usage of double starred elements (“**”) in f-strings. Patch by Pablo Galindo.

  • bpo-43575: Speed up calls to map() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-42137: The import system now prefers using __spec__ for ModuleType.__repr__ over module_repr().

  • bpo-43452: Added micro-optimizations to _PyType_Lookup() to improve cache lookup performance in the common case of cache hits.

  • bpo-43555: Report the column offset for SyntaxError for invalid line continuation characters. Patch by Pablo Galindo.

  • bpo-43517: Fix misdetection of circular imports when using from pkg.mod import attr, which caused false positives in non-trivial multi-threaded code.

  • bpo-43497: Emit SyntaxWarnings for assertions with tuple constants, this is a regression introduced in python3.7

  • bpo-39316: Tracing now has correct line numbers for attribute accesses when the attribute is on a different line from the object. Improves debugging and profiling for multi-line method chains.

  • bpo-35883: Python no longer fails at startup with a fatal error if a command line argument contains an invalid Unicode character. The Py_DecodeLocale() function now escapes byte sequences which would be decoded as Unicode characters outside the [U+0000; U+10ffff] range.

  • bpo-43410: Fix a bug that was causing the parser to crash when emitting syntax errors when reading input from stdin. Patch by Pablo Galindo

  • bpo-43406: Fix a possible race condition where PyErr_CheckSignals tries to execute a non-Python signal handler.

  • bpo-42128: Add __match_args__ to struct sequence objects. Patch by Pablo Galindo.

  • bpo-43390: CPython now sets the SA_ONSTACK flag in PyOS_setsig for the VM’s default signal handlers. This is friendlier to other in-process code that an extension module or embedding use could pull in (such as Golang’s cgo) where tiny thread stacks are the norm and sigaltstack() has been used to provide for signal handlers. This is a no-op change for the vast majority of processes that don’t use sigaltstack.

  • bpo-43287: Speed up calls to filter() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-37448: Add a radix tree based memory map to track in-use obmalloc arenas. Use to replace the old implementation of address_in_range(). The radix tree approach makes it easy to increase pool sizes beyond the OS page size. Boosting the pool and arena size allows obmalloc to handle a significantly higher percentage of requests from its ultra-fast paths.

    It also has the advantage of eliminating the memory unsanitary behavior of the previous address_in_range(). The old address_in_range() was marked with the annotations _Py_NO_SANITIZE_ADDRESS, _Py_NO_SANITIZE_THREAD, and _Py_NO_SANITIZE_MEMORY. Those annotations are no longer needed.

    To disable the radix tree map, set a preprocessor flag as follows: -DWITH_PYMALLOC_RADIX_TREE=0.

    Co-authored-by: Tim Peters <tim.peters@gmail.com>

  • bpo-29988: Only handle asynchronous exceptions and requests to drop the GIL when returning from a call or on the back edges of loops. Makes sure that __exit__() is always called in with statements, even for interrupts.

Library

  • bpo-43720: Document various stdlib deprecations in imp, pkgutil, and importlib.util for removal in Python 3.12.

  • bpo-43433: xmlrpc.client.ServerProxy no longer ignores query and fragment in the URL of the server.

  • bpo-31956: The index() method of array.array now has optional start and stop parameters.

  • bpo-40066: Enum: adjust repr() to show only enum and member name (not value, nor angle brackets) and str() to show only member name. Update and improve documentation to match.

  • bpo-42136: Deprecate all module_repr() methods found in importlib as their use is being phased out by Python 3.12.

  • bpo-35930: Raising an exception raised in a «future» instance will create reference cycles.

  • bpo-41369: Finish updating the vendored libmpdec to version 2.5.1. Patch by Stefan Krah.

  • bpo-43422: Revert the _decimal C API which was added in bpo-41324.

  • bpo-43577: Fix deadlock when using ssl.SSLContext debug callback with ssl.SSLContext.sni_callback().

  • bpo-43571: It’s now possible to create MPTCP sockets with IPPROTO_MPTCP

  • bpo-43542: image/heic and image/heif were added to mimetypes.

  • bpo-40645: The hmac module now uses OpenSSL’s HMAC implementation when digestmod argument is a hash name or builtin hash function.

  • bpo-43510: Implement PEP 597: Add EncodingWarning warning, -X warn_default_encoding option, PYTHONWARNDEFAULTENCODING environment variable and encoding="locale" argument value.

  • bpo-43521: ast.unparse can now render NaNs and empty sets.

  • bpo-42914: pprint.pprint() gains a new boolean underscore_numbers optional argument to emit integers with thousands separated by an underscore character for improved readability (for example 1_000_000 instead of 1000000).

  • bpo-41361: rotate() calls are now slightly faster due to faster argument parsing.

  • bpo-43423: subprocess.communicate() no longer raises an IndexError when there is an empty stdout or stderr IO buffer during a timeout on Windows.

  • bpo-27820: Fixed long-standing bug of smtplib.SMTP where doing AUTH LOGIN with initial_response_ok=False will fail.

    The cause is that SMTP.auth_login _always_ returns a password if provided with a challenge string, thus non-compliant with the standard for AUTH LOGIN.

    Also fixes bug with the test for smtpd.

  • bpo-43445: Add frozen modules to sys.stdlib_module_names. For example, add "_frozen_importlib" and "_frozen_importlib_external" names.

  • bpo-43245: Add keyword arguments support to ChainMap.new_child().

  • bpo-29982: Add optional parameter ignore_cleanup_errors to tempfile.TemporaryDirectory() and allow multiple cleanup() attempts. Contributed by C.A.M. Gerlach.

  • bpo-43428: Include changes from importlib_metadata 3.7:

    Performance enhancements to distribution discovery.

    entry_points only returns unique distributions.

    Introduces new EntryPoints object for containing a set of entry points with convenience methods for selecting entry points by group or name. entry_points now returns this object if selection parameters are supplied but continues to return a dict object for compatibility. Users are encouraged to rely on the selection interface. The dict object result is likely to be deprecated in the future.

    Added packages_distributions function to return a mapping of packages to the distributions that provide them.

  • bpo-43332: Improves the networking efficiency of http.client when using a proxy via set_tunnel(). Fewer small send calls are made during connection setup.

  • bpo-43420: Improve performance of fractions.Fraction arithmetics for large components. Contributed by Sergey B. Kirpichev.

  • bpo-43356: Allow passing a signal number to _thread.interrupt_main().

  • bpo-43399: Fix ElementTree.extend not working on iterators when using the Python implementation

  • bpo-43369: Improve sqlite3 error handling: If sqlite3_column_text() and sqlite3_column_blob() set SQLITE_NOMEM, MemoryError is now raised. Patch by Erlend E. Aasland.

  • bpo-43368: Fix a regression introduced in PR 24562, where an empty bytestring was fetched as None instead of b'' in sqlite3. Patch by Mariusz Felisiak.

  • bpo-41282: Fixed stacklevel of DeprecationWarning emitted from import distutils.

  • bpo-42129: importlib.resources now honors namespace packages, merging resources from each location in the namespace as introduced in importlib_resources 3.2 and including incidental changes through 5.0.3.

  • bpo-43295: datetime.datetime.strptime() now raises ValueError instead of IndexError when matching 'z' with the %z format specifier.

  • bpo-43125: Return empty string if base64mime.body_encode receive empty bytes

  • bpo-43084: curses.window.enclose() returns now True or False (as was documented) instead of 1 or 0.

  • bpo-42994: Add MIME types for opus, AAC, 3gpp and 3gpp2

  • bpo-14678: Add an invalidate_caches() method to the zipimport.zipimporter class to support importlib.invalidate_caches(). Patch by Desmond Cheong.

  • bpo-42782: Fail fast in shutil.move() to avoid creating destination directories on failure.

  • bpo-40066: Enum’s repr() and str() have changed: repr() is now EnumClass.MemberName and str() is MemberName. Additionally, stdlib Enum’s whose contents are available as module attributes, such as RegexFlag.IGNORECASE, have their repr() as module.name, e.g. re.IGNORECASE.

  • bpo-26053: Fixed bug where the pdb interactive run command echoed the args from the shell command line, even if those have been overridden at the pdb prompt.

  • bpo-24160: Fixed bug where breakpoints did not persist across multiple debugger sessions in pdb’s interactive mode.

  • bpo-40701: When the tempfile.tempdir global variable is set to a value of type bytes, it is now handled consistently. Previously exceptions could be raised from some tempfile APIs when the directory did not already exist in this situation. Also ensures that the tempfile.gettempdir() and tempfile.gettempdirb() functions always return str and bytes respectively.

  • bpo-39342: Expose X509_V_FLAG_ALLOW_PROXY_CERTS as VERIFY_ALLOW_PROXY_CERTS to allow proxy certificate validation as explained in https://docs.openssl.org/1.1.1/man7/proxy-certificates/.

  • bpo-31861: Add builtins.aiter and builtins.anext. Patch by Joshua Bronson (@jab), Daniel Pope (@lordmauve), and Justin Wang (@justin39).

Documentation

Tests

  • bpo-37945: Fix test_getsetlocale_issue1813() of test_locale: skip the test if setlocale() fails. Patch by Victor Stinner.

  • bpo-41561: Add workaround for Ubuntu’s custom OpenSSL security level policy.

Build

  • bpo-43179: Introduce and correctly use ALIGNOF_X in place of SIZEOF_X for alignment-related code in optimized string routines. Patch by Jessica Clarke.

  • bpo-43631: Update macOS, Windows, and CI to OpenSSL 1.1.1k.

  • bpo-43617: Improve configure.ac: Check for presence of autoconf-archive package and remove our copies of M4 macros.

  • bpo-43466: The configure script now supports --with-openssl-rpath option.

  • bpo-43372: Use _freeze_importlib to generate code for the __hello__ module. This approach ensures the code matches the interpreter version. Previously, PYTHON_FOR_REGEN was used to generate the code, which might be wrong. The marshal format for code objects has changed with bpo-42246, commit 877df851. Update the code and the expected code sizes in ctypes test_frozentable.

Windows

  • bpo-43440: Build sqlite3 with the R*Tree module enabled. Patch by Erlend E. Aasland.

IDLE

  • bpo-42225: Document that IDLE can fail on Unix either from misconfigured IP masquerade rules or failure displaying complex colored (non-ascii) characters.

C API

  • bpo-43688: The limited C API is now supported if Python is built in debug mode (if the Py_DEBUG macro is defined). In the limited C API, the Py_INCREF() and Py_DECREF() functions are now implemented as opaque function calls, rather than accessing directly the PyObject.ob_refcnt member, if Python is built in debug mode and the Py_LIMITED_API macro targets Python 3.10 or newer. It became possible to support the limited C API in debug mode because the PyObject structure is the same in release and debug mode since Python 3.8 (see bpo-36465).

    The limited C API is still not supported in the --with-trace-refs special build (Py_TRACE_REFS macro).

    Patch by Victor Stinner.

  • bpo-43244: Remove the pyarena.h header file with functions:

    • PyArena_New()

    • PyArena_Free()

    • PyArena_Malloc()

    • PyArena_AddPyObject()

    These functions were undocumented, excluded from the limited C API, and were only used internally by the compiler. Patch by Victor Stinner.

  • bpo-43244: Remove the compiler and parser functions using struct _mod type, because the public AST C API was removed:

    • PyAST_Compile()

    • PyAST_CompileEx()

    • PyAST_CompileObject()

    • PyFuture_FromAST()

    • PyFuture_FromASTObject()

    • PyParser_ASTFromFile()

    • PyParser_ASTFromFileObject()

    • PyParser_ASTFromFilename()

    • PyParser_ASTFromString()

    • PyParser_ASTFromStringObject()

    These functions were undocumented and excluded from the limited C API. Patch by Victor Stinner.

  • bpo-43244: Remove ast.h, asdl.h, and Python-ast.h header files. These functions were undocumented and excluded from the limited C API. Most names defined by these header files were not prefixed by Py and so could create names conflicts. For example, Python-ast.h defined a Yield macro which was conflict with the Yield name used by the Windows <winbase.h> header. Use the Python ast module instead. Patch by Victor Stinner.

  • bpo-43541: Fix a PyEval_EvalCodeEx() regression: fix reference counting on builtins. Patch by Victor Stinner.

  • bpo-43244: Remove the symtable.h header file and the undocumented functions:

    • PyST_GetScope()

    • PySymtable_Build()

    • PySymtable_BuildObject()

    • PySymtable_Free()

    • Py_SymtableString()

    • Py_SymtableStringObject()

    The Py_SymtableString() function was part the stable ABI by mistake but it could not be used, because the symtable.h header file was excluded from the limited C API.

    The Python symtable module remains available and is unchanged.

    Patch by Victor Stinner.

  • bpo-43244: Remove the PyAST_Validate() function. It is no longer possible to build a AST object (mod_ty type) with the public C API. The function was already excluded from the limited C API (PEP 384). Patch by Victor Stinner.

Python 3.10.0 alpha 6

Release date: 2021-03-01

Security

  • bpo-42967: Fix web cache poisoning vulnerability by defaulting the query args separator to &, and allowing the user to choose a custom separator.

Core and Builtins

  • bpo-43321: Fix SystemError raised when PyArg_Parse*() is used with # but without PY_SSIZE_T_CLEAN defined.

  • bpo-36346: PyArg_Parse*() functions now emits DeprecationWarning when u or Z format is used. See PEP 623 for detail.

  • bpo-43277: Add a new PySet_CheckExact() function to the C-API to check if an object is an instance of set but not an instance of a subtype. Patch by Pablo Galindo.

  • bpo-42990: The types.FunctionType constructor now inherits the current builtins if the globals dictionary has no "__builtins__" key, rather than using {"None": None} as builtins: same behavior as eval() and exec() functions. Defining a function with def function(...): ... in Python is not affected, globals cannot be overridden with this syntax: it also inherits the current builtins. Patch by Victor Stinner.

  • bpo-42990: Functions have a new __builtins__ attribute which is used to look for builtin symbols when a function is executed, instead of looking into __globals__['__builtins__']. Patch by Mark Shannon and Victor Stinner.

  • bpo-43149: Improve the error message in the parser for exception groups without parentheses. Patch by Pablo Galindo.

  • bpo-43121: Fixed an incorrect SyntaxError message for missing comma in literals. Patch by Pablo Galindo.

  • bpo-42819: readline: Explicitly disable bracketed paste in the interactive interpreter, even if it’s set in the inputrc, is enabled by default (eg GNU Readline 8.1), or a user calls readline.read_init_file(). The Python REPL has not implemented bracketed paste support. Also, bracketed mode writes the "\x1b[?2004h" escape sequence into stdout which causes test failures in applications that don’t support it. It can still be explicitly enabled by calling readline.parse_and_bind("set enable-bracketed-paste on"). Patch by Dustin Rodrigues.

  • bpo-42808: Simple calls to type(object) are now faster due to the vectorcall calling convention. Patch by Dennis Sweeney.

  • bpo-42217: Make the compiler merges same co_code and co_linetable objects in a module like already did for co_consts.

  • bpo-41972: Substring search functions such as str1 in str2 and str2.find(str1) now sometimes use the «Two-Way» string comparison algorithm to avoid quadratic behavior on long strings.

  • bpo-42128: Implement PEP 634 (structural pattern matching). Patch by Brandt Bucher.

  • bpo-40692: In the concurrent.futures.ProcessPoolExecutor, validate that multiprocess.synchronize() is available on a given platform and rely on that check in the concurrent.futures test suite so we can run tests that are unrelated to ProcessPoolExecutor on those platforms.

  • bpo-38302: If object.__ipow__() returns NotImplemented, the operator will correctly fall back to object.__pow__() and object.__rpow__() as expected.

Library

  • bpo-43316: The python -m gzip command line application now properly fails when detecting an unsupported extension. It exits with a non-zero exit code and prints an error message to stderr.

  • bpo-43317: Set the chunk size for the gzip module main function to io.DEFAULT_BUFFER_SIZE. This is slightly faster than the 1024 bytes constant that was used previously.

  • bpo-43146: Handle None in single-arg versions of print_exception() and format_exception().

  • bpo-43260: Fix TextIOWrapper can not flush internal buffer forever after very large text is written.

  • bpo-43258: Prevent needless allocation of sqlite3 aggregate function context when no rows match an aggregate query. Patch by Erlend E. Aasland.

  • bpo-43251: Improve sqlite3 error handling: sqlite3_column_name() failures now result in MemoryError. Patch by Erlend E. Aasland.

  • bpo-40956: Fix segfault in sqlite3.Connection.backup() if no argument was provided. The regression was introduced by PR 23838. Patch by Erlend E. Aasland.

  • bpo-43172: The readline module now passes its tests when built directly against libedit. Existing irreconcilable API differences remain in readline.get_begidx() and readline.get_endidx() behavior based on libreadline vs libedit use.

  • bpo-43163: Fix a bug in codeop that was causing it to not ask for more input when multi-line snippets have unclosed parentheses. Patch by Pablo Galindo

  • bpo-43162: deprecate unsupported ability to access enum members as attributes of other enum members

  • bpo-43146: Fix recent regression in None argument handling in traceback module functions.

  • bpo-43102: The namedtuple __new__ method had its __builtins__ set to None instead of an actual dictionary. This created problems for introspection tools.

  • bpo-43106: Added O_EVTONLY, O_FSYNC, O_SYMLINK and O_NOFOLLOW_ANY for macOS. Patch by Donghee Na.

  • bpo-42960: Adds resource.RLIMIT_KQUEUES constant from FreeBSD to the resource module.

  • bpo-42151: Make the pure Python implementation of xml.etree.ElementTree behave the same as the C implementation (_elementree) regarding default attribute values (by not setting specified_attributes=1).

  • bpo-29753: In ctypes, now packed bitfields are calculated properly and the first item of packed bitfields is now shrank correctly.

Documentation

  • bpo-27646: Clarify that “yield from <expr>” works with any iterable, not just iterators.

  • bpo-36346: Update some deprecated unicode APIs which are documented as «will be removed in 4.0» to «3.12». See PEP 623 for detail.

Tests

  • bpo-43288: Fix test_importlib to correctly skip Unicode file tests if the filesystem does not support them.

Build

  • bpo-43174: Windows build now uses /utf-8 compiler option.

  • bpo-43103: Add a new configure --without-static-libpython option to not build the libpythonMAJOR.MINOR.a static library and not install the python.o object file.

  • bpo-13501: The configure script can now use libedit instead of readline with the command line option --with-readline=editline.

  • bpo-42603: Make configure script use pkg-config to detect the location of Tcl/Tk headers and libraries, used to build tkinter.

    On macOS, a Tcl/Tk configuration provided by pkg-config will be preferred over Tcl/Tk frameworks installed in /{System/,}Library/Frameworks. If both exist and the latter is preferred, the appropriate --with-tcltk-* configuration options need to be explicitly set.

  • bpo-39448: Add the «regen-frozen» makefile target that regenerates the code for the frozen __hello__ module.

Windows

macOS

  • bpo-41837: Update macOS installer build to use OpenSSL 1.1.1j.

IDLE

  • bpo-43283: Document why printing to IDLE’s Shell is often slower than printing to a system terminal and that it can be made faster by pre-formatting a single string before printing.

C API

  • bpo-43278: Always put compiler and system information on the first line of the REPL welcome message.

  • bpo-43270: Remove the private _PyErr_OCCURRED() macro: use the public PyErr_Occurred() function instead.

  • bpo-35134: Move odictobject.h, parser_interface.h, picklebufobject.h, pydebug.h, and pyfpe.h into the cpython/ directory. They must not be included directly, as they are already included by Python.h: Include Files.

  • bpo-35134: Move pyarena.h, pyctype.h, and pytime.h into the cpython/ directory. They must not be included directly, as they are already included by Python.h: Include Files.

  • bpo-40170: PyExceptionClass_Name() is now always declared as a function, in order to hide implementation details. The macro accessed PyTypeObject.tp_name directly. Patch by Erlend E. Aasland.

  • bpo-43239: The PyCFunction_New() function is now exported in the ABI when compiled with -fvisibility=hidden.

  • bpo-40170: PyIter_Check() is now always declared as a function, in order to hide implementation details. The macro accessed PyTypeObject.tp_iternext directly. Patch by Erlend E. Aasland.

  • bpo-40170: Convert PyDescr_IsData() macro to a function to hide implementation details: The macro accessed PyTypeObject.tp_descr_set directly. Patch by Erlend E. Aasland.

  • bpo-43181: Convert PyObject_TypeCheck() macro to a static inline function. Patch by Erlend E. Aasland.

Python 3.10.0 alpha 5

Release date: 2021-02-02

Security

Core and Builtins

  • bpo-42990: Refactor the PyEval_ family of functions.

    • An new function _PyEval_Vector is added to simplify calls to Python from C.

    • _PyEval_EvalCodeWithName is removed

    • PyEval_EvalCodeEx is retained as part of the API, but is not used internally

  • bpo-38631: Replace Py_FatalError() calls in the compiler with regular SystemError exceptions. Patch by Victor Stinner.

  • bpo-42997: Improve error message for missing «:» before blocks. Patch by Pablo Galindo.

  • bpo-43017: Improve error message in the parser when using un-parenthesised tuples in comprehensions. Patch by Pablo Galindo.

  • bpo-42986: Fix parser crash when reporting syntax errors in f-string with newlines. Patch by Pablo Galindo.

  • bpo-40176: Syntax errors for unterminated string literals now point to the start of the string instead of reporting EOF/EOL.

  • bpo-42927: The inline cache for LOAD_ATTR now also optimizes access to attributes defined by __slots__. This makes reading such attribute up to 30% faster.

  • bpo-42864: Improve error messages in the parser when parentheses are not closed. Patch by Pablo Galindo.

  • bpo-42924: Fix bytearray repetition incorrectly copying data from the start of the buffer, even if the data is offset within the buffer (e.g. after reassigning a slice at the start of the bytearray to a shorter byte string).

  • bpo-42882: Fix the _PyUnicode_FromId() function (_Py_IDENTIFIER(var) API) when Py_Initialize() / Py_Finalize() is called multiple times: preserve _PyRuntime.unicode_ids.next_index value.

  • bpo-42827: Fix a crash when working out the error line of a SyntaxError in some multi-line expressions.

  • bpo-42823: frame.f_lineno is correct even if frame.f_trace is set to True

  • bpo-37324: Remove deprecated aliases to Colecciones clases base abstractas from the collections module.

  • bpo-41994: Fixed possible leak in import when sys.modules is not a dict.

  • bpo-27772: In string formatting, preceding the width field by '0' no longer affects the default alignment for strings.

Library

  • bpo-43108: Fixed a reference leak in the curses module. Patch by Pablo Galindo

  • bpo-43077: Update the bundled pip to 21.0.1 and setuptools to 52.0.0.

  • bpo-41282: Deprecate distutils in documentation and add warning on import.

  • bpo-43014: Improve performance of tokenize by 20-30%. Patch by Anthony Sottile.

  • bpo-42323: Fix math.nextafter() for NaN on AIX.

  • bpo-42955: Add sys.stdlib_module_names, containing the list of the standard library module names. Patch by Victor Stinner.

  • bpo-42944: Fix random.Random.sample when counts argument is not None.

  • bpo-42934: Use TracebackException’s new compact param in TestResult to reduce time and memory consumed by traceback formatting.

  • bpo-42931: Add randbytes() to random.__all__.

  • bpo-38250: [Enum] Flags consisting of a single bit are now considered canonical, and will be the only flags returned from listing and iterating over a Flag class or a Flag member. Multi-bit flags are considered aliases; they will be returned from lookups and operations that result in their value. Iteration for both Flag and Flag members is in definition order.

  • bpo-42877: Added the compact parameter to the constructor of traceback.TracebackException to reduce time and memory for use cases that only need to call TracebackException.format() and TracebackException.format_exception_only().

  • bpo-42923: The Py_FatalError() function and the faulthandler module now dump the list of extension modules on a fatal error.

  • bpo-42848: Removed recursion from TracebackException to allow it to handle long exception chains.

  • bpo-42901: [Enum] move member creation from EnumMeta.__new__ to _proto_member.__set_name__, allowing members to be created and visible in __init_subclass__.

  • bpo-42780: Fix os.set_inheritable() for O_PATH file descriptors on Linux.

  • bpo-42866: Fix a reference leak in the getcodec() function of CJK codecs. Patch by Victor Stinner.

  • bpo-42846: Convert the 6 CJK codec extension modules (_codecs_cn, _codecs_hk, _codecs_iso2022, _codecs_jp, _codecs_kr and _codecs_tw) to the multiphase initialization API (PEP 489). Patch by Victor Stinner.

  • bpo-42851: remove __init_subclass__ support for Enum members

  • bpo-42834: Make internal caches of the _json module compatible with subinterpreters.

  • bpo-41748: Fix HTMLParser parsing rules for element attributes containing commas with spaces. Patch by Karl Dubost.

  • bpo-40810: Require SQLite 3.7.15 or newer. Patch by Erlend E. Aasland.

  • bpo-1635741: Convert the _multibytecodec extension module (CJK codecs) to multi-phase initialization (PEP 489). Patch by Erlend E. Aasland.

  • bpo-42802: The distutils bdist_wininst command deprecated in Python 3.8 has been removed. The distutils bdist_wheel command is now recommended to distribute binary packages on Windows.

  • bpo-24464: The undocumented built-in function sqlite3.enable_shared_cache is now deprecated, scheduled for removal in Python 3.12. Its use is strongly discouraged by the SQLite3 documentation. Patch by Erlend E. Aasland.

  • bpo-42384: Make pdb populate sys.path[0] exactly the same as regular python execution.

  • bpo-42383: Fix pdb: previously pdb would fail to restart the debugging target if it was specified using a relative path and the current directory changed.

  • bpo-42005: Fix CLI of cProfile and profile to catch BrokenPipeError.

  • bpo-41604: Don’t decrement the reference count of the previous user_ptr when set_panel_userptr fails.

  • bpo-41149: Allow executing callables that have a boolean value of False when passed to Threading.thread as the target. Patch contributed by Barney Stratford.

  • bpo-38307: Add an “end_lineno” attribute to the Class and Function objects that appear in the tree returned by pyclbr functions. This and the existing “lineno” attribute define the extent of class and def statements. Patch by Aviral Srivastava.

  • bpo-39273: The BUTTON5_* constants are now exposed in the curses module if available.

  • bpo-33289: Correct call to tkinter.colorchooser to return RGB triplet of ints instead of floats. Patch by Cheryl Sabella.

Documentation

  • bpo-40304: Fix doc for type(name, bases, dict). Patch by Boris Verkhovskiy and Éric Araujo.

  • bpo-42811: Updated importlib.util.resolve_name() doc to use __spec__.parent instead of __package__. (Thanks Yair Frid.)

Tests

  • bpo-40823: Use unittest.TestLoader().loadTestsFromTestCase() instead of unittest.makeSuite() in sqlite3 tests. Patch by Erlend E. Aasland.

  • bpo-40810: In sqlite3, fix CheckTraceCallbackContent for SQLite pre 3.7.15.

Build

  • bpo-43031: Pass --timeout=$(TESTTIMEOUT) option to the default profile task ./python -m test --pgo command.

  • bpo-36143: make regen-all now also runs regen-keyword. Patch by Victor Stinner.

  • bpo-42874: Removed the grep -q and -E flags in the tzpath validation section of the configure script to better accommodate users of some platforms (specifically Solaris 10).

  • bpo-31904: Add library search path by wr-cc in add_cross_compiling_paths() for VxWorks.

  • bpo-42856: Add --with-wheel-pkg-dir=PATH option to the ./configure script. If specified, the ensurepip module looks for setuptools and pip wheel packages in this directory: if both are present, these wheel packages are used instead of ensurepip bundled wheel packages.

    Some Linux distribution packaging policies recommend against bundling dependencies. For example, Fedora installs wheel packages in the /usr/share/python-wheels/ directory and don’t install the ensurepip._bundled package.

Windows

  • bpo-41837: Updated Windows installer to include OpenSSL 1.1.1i

  • bpo-42584: Upgrade Windows installer to use SQLite 3.34.0.

macOS

  • bpo-42504: Ensure that the value of sysconfig.get_config_var(“MACOSX_DEPLOYMENT_TARGET”) is always a string, even in when the value is parsable as an integer.

IDLE

  • bpo-43008: Make IDLE invoke sys.excepthook() in normal, 2-process mode. Patch by Ken Hilton.

  • bpo-33065: Fix problem debugging user classes with __repr__ method.

  • bpo-23544: Disable Debug=>Stack Viewer when user code is running or Debugger is active, to prevent hang or crash. Patch by Zackery Spytz.

  • bpo-32631: Finish zzdummy example extension module: make menu entries work; add docstrings and tests with 100% coverage.

C API

  • bpo-42979: When Python is built in debug mode (with C assertions), calling a type slot like sq_length (__len__() in Python) now fails with a fatal error if the slot succeeded with an exception set, or failed with no exception set. The error message contains the slot, the type name, and the current exception (if an exception is set). Patch by Victor Stinner.

  • bpo-43030: Fixed a compiler warning in Py_UNICODE_ISSPACE() on platforms with signed wchar_t.

Python 3.10.0 alpha 4

Release date: 2021-01-04

Core and Builtins

  • bpo-42814: Fix undefined behavior in Objects/genericaliasobject.c.

  • bpo-42806: Fix the column offsets for f-strings ast nodes surrounded by parentheses and for nodes that spawn multiple lines. Patch by Pablo Galindo.

  • bpo-40631: Fix regression where a single parenthesized starred expression was a valid assignment target.

  • bpo-27794: Improve the error message for failed writes/deletes to property objects. When possible, the attribute name is now shown. Patch provided by Yurii Karabas.

  • bpo-42745: Make the type attribute lookup cache per-interpreter. Patch by Victor Stinner.

  • bpo-42246: Jumps to jumps are not eliminated when it would break PEP 626.

  • bpo-42246: Make sure that the f_lasti and f_lineno attributes of a frame are set correctly when an exception is raised or re-raised. Required for PEP 626.

  • bpo-32381: The coding cookie (ex: # coding: latin1) is now ignored in the command passed to the -c command line option. Patch by Victor Stinner.

  • bpo-30858: Improve error location in expressions that contain assignments. Patch by Pablo Galindo and Lysandros Nikolaou.

  • bpo-42615: Remove jump commands made redundant by the deletion of unreachable bytecode blocks

  • bpo-42639: Make the atexit module state per-interpreter. It is now safe have more than one atexit module instance. Patch by Donghee Na and Victor Stinner.

  • bpo-32381: Fix encoding name when running a .pyc file on Windows: PyRun_SimpleFileExFlags() now uses the correct encoding to decode the filename.

  • bpo-42195: The __args__ of the parameterized generics for typing.Callable and collections.abc.Callable are now consistent. The __args__ for collections.abc.Callable are now flattened while typing.Callable’s have not changed. To allow this change, types.GenericAlias can now be subclassed and collections.abc.Callable’s __class_getitem__ will now return a subclass of types.GenericAlias. Tests for typing were also updated to not subclass things like Callable[..., T] as that is not a valid base class. Finally, both Callables no longer validate their argtypes, in Callable[[argtypes], resulttype] to prepare for PEP 612. Patch by Ken Jin.

  • bpo-40137: Convert functools module to use PyType_FromModuleAndSpec().

  • bpo-40077: Convert array to use heap types, and establish module state for these.

  • bpo-42008: Fix _random.Random() seeding.

  • bpo-1635741: Port the pyexpat extension module to multi-phase initialization (PEP 489).

  • bpo-40521: Make the Unicode dictionary of interned strings compatible with subinterpreters. Patch by Victor Stinner.

  • bpo-39465: Make _PyUnicode_FromId() function compatible with subinterpreters. Each interpreter now has an array of identifier objects (interned strings decoded from UTF-8). Patch by Victor Stinner.

Library

  • bpo-42257: Handle empty string in variable executable in platform.libc_ver()

  • bpo-42772: randrange() now raises a TypeError when step is specified without a stop argument. Formerly, it silently ignored the step argument.

  • bpo-42759: Fixed equality comparison of tkinter.Variable and tkinter.font.Font. Objects which belong to different Tcl interpreters are now always different, even if they have the same name.

  • bpo-42756: Configure LMTP Unix-domain socket to use socket global default timeout when a timeout is not explicitly provided.

  • bpo-23328: Allow / character in username, password fields on _PROXY envars.

  • bpo-42740: typing.get_args() and typing.get_origin() now support PEP 604 union types and PEP 612 additions to Callable.

  • bpo-42655: subprocess extra_groups is now correctly passed into setgroups() system call.

  • bpo-42727: EnumMeta.__prepare__ now accepts **kwds to properly support __init_subclass__

  • bpo-38308: Add optional weights to statistics.harmonic_mean().

  • bpo-42721: When simple query dialogs (tkinter.simpledialog), message boxes (tkinter.messagebox) or color choose dialog (tkinter.colorchooser) are created without arguments master and parent, and the default root window is not yet created, and NoDefaultRoot() was not called, a new temporal hidden root window will be created automatically. It will not be set as the default root window and will be destroyed right after closing the dialog window. It will help to use these simple dialog windows in programs which do not need other GUI.

  • bpo-25246: Optimized collections.deque.remove().

  • bpo-35728: Added a root parameter to tkinter.font.nametofont().

  • bpo-15303: tkinter supports now widgets with boolean value False.

  • bpo-42681: Fixed range checks for color and pair numbers in curses.

  • bpo-42685: Improved placing of simple query windows in Tkinter (such as tkinter.simpledialog.askinteger()). They are now centered at the center of the parent window if it is specified and shown, otherwise at the center of the screen.

  • bpo-9694: Argparse help no longer uses the confusing phrase, «optional arguments». It uses «options» instead.

  • bpo-1635741: Port the _thread extension module to the multiphase initialization API (PEP 489) and convert its static types to heap types.

  • bpo-37961: Fix crash in tracemalloc.Traceback.__repr__() (regressed in Python 3.9).

  • bpo-42630: tkinter functions and constructors which need a default root window raise now RuntimeError with descriptive message instead of obscure AttributeError or NameError if it is not created yet or cannot be created automatically.

  • bpo-42639: atexit._run_exitfuncs() now logs callback exceptions using sys.unraisablehook, rather than logging them directly into sys.stderr and raise the last exception.

  • bpo-42644: logging.disable will now validate the types and value of its parameter. It also now accepts strings representing the levels (as does logging.setLevel) instead of only the numerical values.

  • bpo-42639: At Python exit, if a callback registered with atexit.register() fails, its exception is now logged. Previously, only some exceptions were logged, and the last exception was always silently ignored.

  • bpo-36541: Fixed lib2to3.pgen2 to be able to parse PEP-570 positional only argument syntax.

  • bpo-42382: In importlib.metadata: - EntryPoint objects now expose a .dist object referencing the Distribution when constructed from a Distribution. - Add support for package discovery under package normalization rules. - The object returned by metadata() now has a formally defined protocol called PackageMetadata with declared support for the .get_all() method. - Synced with importlib_metadata 3.3.

  • bpo-41877: A check is added against misspellings of autospect, auto_spec and set_spec being passed as arguments to patch, patch.object and create_autospec.

  • bpo-39717: [tarfile] update nested exception raising to use from None or from e

  • bpo-41877: AttributeError for suspected misspellings of assertions on mocks are now pointing out that the cause are misspelled assertions and also what to do if the misspelling is actually an intended attribute name. The unittest.mock document is also updated to reflect the current set of recognised misspellings.

  • bpo-41559: Implemented PEP 612: added ParamSpec and Concatenate to typing. Patch by Ken Jin.

  • bpo-42385: StrEnum: fix _generate_next_value_ to return a str

  • bpo-31904: Define THREAD_STACK_SIZE for VxWorks.

  • bpo-34750: [Enum] _EnumDict.update() is now supported.

  • bpo-42517: Enum: private names do not become members / do not generate errors – they remain normal attributes

  • bpo-42678: Enum: call __init_subclass__ after members have been added

  • bpo-28964: ast.literal_eval() adds line number information (if available) in error message for malformed nodes.

  • bpo-42470: random.sample() no longer warns on a sequence which is also a set.

  • bpo-31904: posixpath.expanduser() returns the input path unchanged if user home directory is None on VxWorks.

  • bpo-42388: Fix subprocess.check_output(…, input=None) behavior when text=True to be consistent with that of the documentation and universal_newlines=True.

  • bpo-34463: Fixed discrepancy between traceback and the interpreter in formatting of SyntaxError with lineno not set (traceback was changed to match interpreter).

  • bpo-42393: Raise OverflowError instead of silent truncation in socket.ntohs() and socket.htons(). Silent truncation was deprecated in Python 3.7. Patch by Erlend E. Aasland

  • bpo-42222: Harmonized random.randrange() argument handling to match range().

    • The integer test and conversion in randrange() now uses operator.index().

    • Non-integer arguments to randrange() are deprecated.

    • The ValueError is deprecated in favor of a TypeError.

    • It now runs a little faster than before.

    (Contributed by Raymond Hettinger and Serhiy Storchaka.)

  • bpo-42163: Restore compatibility for uname_result around deepcopy and _replace.

  • bpo-42090: zipfile.Path.joinpath now accepts arbitrary arguments, same as pathlib.Path.joinpath.

  • bpo-1635741: Port the _csv module to the multi-phase initialization API (PEP 489).

  • bpo-42059: typing.TypedDict types created using the alternative call-style syntax now correctly respect the total keyword argument when setting their __required_keys__ and __optional_keys__ class attributes.

  • bpo-41960: Add globalns and localns parameters to the inspect.signature() and inspect.Signature.from_callable().

  • bpo-41907: fix format() behavior for IntFlag

  • bpo-41891: Ensure asyncio.wait_for waits for task completion

  • bpo-24792: Fixed bug where zipimporter sometimes reports an incorrect cause of import errors.

  • bpo-31904: Fix site and sysconfig modules for VxWorks RTOS which has no home directories.

  • bpo-41462: Add os.set_blocking() support for VxWorks RTOS.

  • bpo-40219: Lowered tkinter.ttk.LabeledScale dummy widget to prevent hiding part of the content label.

  • bpo-37193: Fixed memory leak in socketserver.ThreadingMixIn introduced in Python 3.7.

  • bpo-39068: Fix initialization race condition in a85encode() and b85encode() in base64. Patch by Brandon Stansbury.

Documentation

Tests

  • bpo-42794: Update test_nntplib to use official group name of news.aioe.org for testing. Patch by Donghee Na.

  • bpo-31904: Skip some asyncio tests on VxWorks.

  • bpo-42641: Enhance test_select.test_select(): it now takes 500 milliseconds rather than 10 seconds. Use Python rather than a shell to make the test more portable.

  • bpo-31904: Skip some tests in _test_all_chown_common() on VxWorks.

  • bpo-42199: Fix bytecode helper assertNotInBytecode.

  • bpo-41443: Add more attribute checking in test_posix.py

  • bpo-31904: Disable os.popen and impacted tests on VxWorks

  • bpo-41439: Port test_ssl and test_uuid to VxWorks RTOS.

Build

  • bpo-42692: Fix __builtin_available check on older compilers. Patch by Joshua Root.

  • bpo-27640: Added --disable-test-modules option to the configure script: don’t build nor install test modules. Patch by Xavier de Gaye, Thomas Petazzoni and Peixing Xin.

  • bpo-42604: Now all platforms use a value for the «EXT_SUFFIX» build variable derived from SOABI (for instance in freeBSD, «EXT_SUFFIX» is now «.cpython-310d.so» instead of «.so»). Previously only Linux, Mac and VxWorks were using a value for «EXT_SUFFIX» that included «SOABI».

  • bpo-42598: Fix implicit function declarations in configure which could have resulted in incorrect configuration checks. Patch contributed by Joshua Root.

  • bpo-31904: Enable libpython3.so for VxWorks.

  • bpo-29076: Add fish shell support to macOS installer.

macOS

  • bpo-42361: Update macOS installer build to use Tcl/Tk 8.6.11 (rc2, expected to be final release).

  • bpo-41837: Update macOS installer build to use OpenSSL 1.1.1i.

  • bpo-42584: Update macOS installer to use SQLite 3.34.0.

Tools/Demos

  • bpo-42726: Fixed Python 3 compatibility issue with gdb/libpython.py handling of attribute dictionaries.

  • bpo-42613: Fix freeze.py tool to use the prope config and library directories. Patch by Victor Stinner.

C API

  • bpo-42591: Export the Py_FrozenMain() function: fix a Python 3.9.0 regression. Python 3.9 uses -fvisibility=hidden and the function was not exported explicitly and so not exported.

  • bpo-32381: Remove the private _Py_fopen() function which is no longer needed. Use _Py_wfopen() or _Py_fopen_obj() instead. Patch by Victor Stinner.

  • bpo-1635741: Port resource extension module to module state

  • bpo-42111: Update the xxlimited module to be a better example of how to use the limited C API.

  • bpo-40052: Fix an alignment build warning/error in function PyVectorcall_Function(). Patch by Andreas Schneider, Antoine Pitrou and Petr Viktorin.

Python 3.10.0 alpha 3

Release date: 2020-12-07

Security

  • bpo-40791: Add volatile to the accumulator variable in hmac.compare_digest, making constant-time-defeating optimizations less likely.

Core and Builtins

  • bpo-42576: types.GenericAlias will now raise a TypeError when attempting to initialize with a keyword argument. Previously, this would cause the interpreter to crash if the interpreter was compiled with debug symbols. This does not affect interpreters compiled for release. Patch by Ken Jin.

  • bpo-42536: Several built-in and standard library types now ensure that their internal result tuples are always tracked by the garbage collector:

    Previously, they could have become untracked by a prior garbage collection. Patch by Brandt Bucher.

  • bpo-42500: Improve handling of exceptions near recursion limit. Converts a number of Fatal Errors in RecursionErrors.

  • bpo-42246: PEP 626: After a return, the f_lineno attribute of a frame is always the last line executed.

  • bpo-42435: Speed up comparison of bytes objects with non-bytes objects when option -b is specified. Speed up comparison of bytarray objects with non-buffer object.

  • bpo-1635741: Port the _warnings extension module to the multi-phase initialization API (PEP 489). Patch by Victor Stinner.

  • bpo-41686: On Windows, the SIGINT event, _PyOS_SigintEvent(), is now created even if Python is configured to not install signal handlers (if PyConfig.install_signal_handlers equals to 0, or Py_InitializeEx(0)).

  • bpo-42381: Allow assignment expressions in set literals and set comprehensions as per PEP 572. Patch by Pablo Galindo.

  • bpo-42202: Change function parameters annotations internal representation to tuple of strings. Patch provided by Yurii Karabas.

  • bpo-42374: Fix a regression introduced by the new parser, where an unparenthesized walrus operator was not allowed within generator expressions.

  • bpo-42316: Allow an unparenthesized walrus in subscript indexes.

  • bpo-42349: Make sure that the compiler front-end produces a well-formed control flow graph. Be more aggressive in the compiler back-end, as it is now safe to do so.

  • bpo-42296: On Windows, fix a regression in signal handling which prevented to interrupt a program using CTRL+C. The signal handler can be run in a thread different than the Python thread, in which case the test deciding if the thread can handle signals is wrong.

  • bpo-42332: types.GenericAlias objects can now be the targets of weakrefs.

  • bpo-42282: Optimise constant subexpressions that appear as part of named expressions (previously the AST optimiser did not descend into named expressions). Patch by Nick Coghlan.

  • bpo-42266: Fixed a bug with the LOAD_ATTR opcode cache that was not respecting monkey-patching a class-level attribute to make it a descriptor. Patch by Pablo Galindo.

  • bpo-40077: Convert queue to use heap types.

  • bpo-42246: Improved accuracy of line tracing events and f_lineno attribute of Frame objects. See PEP 626 for details.

  • bpo-40077: Convert mmap to use heap types.

  • bpo-42233: Allow GenericAlias objects to use union type expressions. This allows expressions like list[int] | dict[float, str] where previously a TypeError would have been thrown. This also fixes union type expressions not de-duplicating GenericAlias objects. (Contributed by Ken Jin in bpo-42233.)

  • bpo-26131: The import system triggers a ImportWarning when it falls back to using load_module().

Library

  • bpo-5054: CGIHTTPRequestHandler.run_cgi() HTTP_ACCEPT improperly parsed. Replace the special purpose getallmatchingheaders with generic get_all method and add relevant tests.

    Original Patch by Martin Panter. Modified by Senthil Kumaran.

  • bpo-42562: Fix issue when dis failed to parse function that has no line numbers. Patch provided by Yurii Karabas.

  • bpo-17735: inspect.findsource() now raises OSError instead of IndexError when co_lineno of a code object is greater than the file length. This can happen, for example, when a file is edited after it was imported. PR by Irit Katriel.

  • bpo-42116: Fix handling of trailing comments by inspect.getsource().

  • bpo-42532: Remove unexpected call of __bool__ when passing a spec_arg argument to a Mock.

  • bpo-38200: Added itertools.pairwise()

  • bpo-41818: Fix test_master_read() so that it succeeds on all platforms that either raise OSError or return b»» upon reading from master.

  • bpo-42487: ChainMap.__iter__ no longer calls __getitem__ on underlying maps

  • bpo-42482: TracebackException no longer holds a reference to the exception’s traceback object. Consequently, instances of TracebackException for equivalent but non-equal exceptions now compare as equal.

  • bpo-41818: Make test_openpty() avoid unexpected success due to number of rows and/or number of columns being == 0.

  • bpo-42392: Remove loop parameter from asyncio.subprocess and asyncio.tasks functions. Patch provided by Yurii Karabas.

  • bpo-42392: Remove loop parameter from asyncio.open_connection and asyncio.start_server functions. Patch provided by Yurii Karabas.

  • bpo-28468: Add platform.freedesktop_os_release() function to parse freedesktop.org os-release files.

  • bpo-42299: Removed the formatter module, which was deprecated in Python 3.4. It is somewhat obsolete, little used, and not tested. It was originally scheduled to be removed in Python 3.6, but such removals were delayed until after Python 2.7 EOL. Existing users should copy whatever classes they use into their code. Patch by Donghee Na and and Terry J. Reedy.

  • bpo-26131: Deprecate zipimport.zipimporter.load_module() in favour of exec_module().

  • bpo-41818: Updated tests for the pty library. test_basic() has been changed to test_openpty(); this additionally checks if slave termios and slave winsize are being set properly by pty.openpty(). In order to add support for FreeBSD, NetBSD, OpenBSD, and Darwin, this also adds test_master_read(), which demonstrates that pty.spawn() should not depend on an OSError to exit from its copy loop.

  • bpo-42392: Remove loop parameter from __init__ in all asyncio.locks and asyncio.Queue classes. Patch provided by Yurii Karabas.

  • bpo-15450: Make filecmp.dircmp respect subclassing. Now the filecmp.dircmp.subdirs behaves as expected when subclassing dircmp.

  • bpo-42413: The exception socket.timeout is now an alias of TimeoutError.

  • bpo-31904: Support signal module on VxWorks.

  • bpo-42406: We fixed an issue in pickle.whichmodule in which importing multiprocessing could change the how pickle identifies which module an object belongs to, potentially breaking the unpickling of those objects.

  • bpo-42403: Simplify the importlib external bootstrap code: importlib._bootstrap_external now uses regular imports to import builtin modules. When it is imported, the builtin __import__() function is already fully working and so can be used to import builtin modules like sys. Patch by Victor Stinner.

  • bpo-1635741: Convert _sre module types to heap types (PEP 384). Patch by Erlend E. Aasland.

  • bpo-42375: subprocess module update for DragonFlyBSD support.

  • bpo-41713: Port the _signal extension module to the multi-phase initialization API (PEP 489). Patch by Victor Stinner and Mohamed Koubaa.

  • bpo-37205: time.time(), time.perf_counter() and time.monotonic() functions can no longer fail with a Python fatal error, instead raise a regular Python exception on failure.

  • bpo-42328: Fixed tkinter.ttk.Style.map(). The function accepts now the representation of the default state as empty sequence (as returned by Style.map()). The structure of the result is now the same on all platform and does not depend on the value of wantobjects.

  • bpo-42345: Fix various issues with typing.Literal parameter handling (flatten, deduplicate, use type to cache key). Patch provided by Yurii Karabas.

  • bpo-37205: time.perf_counter() on Windows and time.monotonic() on macOS are now system-wide. Previously, they used an offset computed at startup to reduce the precision loss caused by the float type. Use time.perf_counter_ns() and time.monotonic_ns() added in Python 3.7 to avoid this precision loss.

  • bpo-42318: Fixed support of non-BMP characters in tkinter on macOS.

  • bpo-42350: Fix the threading.Thread class at fork: do nothing if the thread is already stopped (ex: fork called at Python exit). Previously, an error was logged in the child process.

  • bpo-42333: Port _ssl extension module to heap types.

  • bpo-42014: The onerror callback from shutil.rmtree now receives correct function when os.open fails.

  • bpo-42237: Fix os.sendfile() on illumos.

  • bpo-42308: Add threading.__excepthook__ to allow retrieving the original value of threading.excepthook() in case it is set to a broken or a different value. Patch by Mario Corchero.

  • bpo-42131: Implement PEP 451/spec methods on zipimport.zipimporter: find_spec(), create_module(), and exec_module().

    This also allows for the documented deprecation of find_loader(), find_module(), and load_module().

  • bpo-41877: Mock objects which are not unsafe will now raise an AttributeError if an attribute with the prefix asert, aseert, or assrt is accessed, in addition to this already happening for the prefixes assert or assret.

  • bpo-42264: sqlite3.OptimizedUnicode has been undocumented and obsolete since Python 3.3, when it was made an alias to str. It is now deprecated, scheduled for removal in Python 3.12.

  • bpo-42251: Added threading.gettrace() and threading.getprofile() to retrieve the functions set by threading.settrace() and threading.setprofile() respectively. Patch by Mario Corchero.

  • bpo-42249: Fixed writing binary Plist files larger than 4 GiB.

  • bpo-42236: On Unix, the os.device_encoding() function now returns 'UTF-8' rather than the device encoding if the Python UTF-8 Mode is enabled.

  • bpo-41754: webbrowser: Ignore NotADirectoryError when calling xdg-settings.

  • bpo-42183: Fix a stack overflow error for asyncio Task or Future repr().

    The overflow occurs under some circumstances when a Task or Future recursively returns itself.

  • bpo-42140: Improve asyncio.wait function to create the futures set just one time.

  • bpo-42133: Update various modules in the stdlib to fall back on __spec__.loader when __loader__ isn’t defined on a module.

  • bpo-26131: The load_module() methods found in importlib now trigger a DeprecationWarning.

  • bpo-39825: Windows: Change sysconfig.get_config_var('EXT_SUFFIX') to the expected full platform_tag.extension format. Previously it was hard-coded to .pyd, now it is compatible with distutils.sysconfig and will result in something like .cp38-win_amd64.pyd. This brings windows into conformance with the other platforms.

  • bpo-26389: The traceback.format_exception(), traceback.format_exception_only(), and traceback.print_exception() functions can now take an exception object as a positional-only argument.

  • bpo-41889: Enum: fix regression involving inheriting a multiply inherited enum

  • bpo-41861: Convert sqlite3 to use heap types (PEP 384). Patch by Erlend E. Aasland.

  • bpo-40624: Added support for the XPath != operator in xml.etree

  • bpo-28850: Fix pprint.PrettyPrinter.format() overrides being ignored for contents of small containers. The pprint._safe_repr() function was removed.

  • bpo-41625: Expose the splice() as os.splice() in the os module. Patch by Pablo Galindo

  • bpo-34215: Clarify the error message for asyncio.IncompleteReadError when expected is None.

  • bpo-41543: Add async context manager support for contextlib.nullcontext.

  • bpo-21041: pathlib.PurePath.parents now supports negative indexing. Patch contributed by Yaroslav Pankovych.

  • bpo-41332: Added missing connect_accepted_socket() method to asyncio.AbstractEventLoop.

  • bpo-12800: Extracting a symlink from a tarball should succeed and overwrite the symlink if it already exists. The fix is to remove the existing file or symlink before extraction. Based on patch by Chris AtLee, Jeffrey Kintscher, and Senthil Kumaran.

  • bpo-40968: urllib.request and http.client now send http/1.1 ALPN extension during TLS handshake when no custom context is supplied.

  • bpo-41001: Add os.eventfd() to provide a low level interface for Linux’s event notification file descriptor.

  • bpo-40816: Add AsyncContextDecorator to contextlib to support async context manager as a decorator.

  • bpo-40550: Fix time-of-check/time-of-action issue in subprocess.Popen.send_signal.

  • bpo-39411: Add an is_async identifier to pyclbr’s Function objects. Patch by Batuhan Taskaya

  • bpo-35498: Add slice support to pathlib.PurePath.parents.

Documentation

  • bpo-42238: Tentative to deprecate make suspicious by first removing it from the CI and documentation builds, but keeping it around for manual uses.

  • bpo-42153: Fix the URL for the IMAP protocol documents.

  • bpo-41028: Language and version switchers, previously maintained in every cpython branches, are now handled by docsbuild-script.

Tests

  • bpo-41473: Re-enable test_gdb on gdb 9.2 and newer: https://bugzilla.redhat.com/show_bug.cgi?id=1866884 bug is fixed in gdb 10.1.

  • bpo-42553: Fix test_asyncio.test_call_later() race condition: don’t measure asyncio performance in the call_later() unit test. The test failed randomly on the CI.

  • bpo-31904: Fix test_netrc on VxWorks: create temporary directories using temp_cwd().

  • bpo-31904: skip test_getaddrinfo_ipv6_scopeid_symbolic and test_getnameinfo_ipv6_scopeid_symbolic on VxWorks

  • bpo-31904: skip test_test of test_mailcap on VxWorks

  • bpo-31904: add shell requirement for test_pipes

  • bpo-31904: skip some tests related to fifo on VxWorks

  • bpo-31904: Fix test_doctest.py failures for VxWorks.

  • bpo-40754: Include _testinternalcapi module in Windows installer for test suite

  • bpo-41561: test_ssl: skip test_min_max_version_mismatch when TLS 1.0 is not available

  • bpo-31904: Fix os module failures for VxWorks RTOS.

  • bpo-31904: Fix fifo test cases for VxWorks RTOS.

Build

  • bpo-31904: remove libnet dependency from detect_socket() for VxWorks

  • bpo-42398: Fix a race condition in «make regen-all» when make -jN option is used to run jobs in parallel. The clinic.py script now only use atomic write to write files. Moveover, generated files are now left unchanged if the content does not change, to not change the file modification time.

  • bpo-41617: Fix building pycore_bitutils.h internal header on old clang version without __builtin_bswap16() (ex: Xcode 4.6.3 on Mac OS X 10.7). Patch by Joshua Root and Victor Stinner.

  • bpo-38823: It is no longer possible to build the _ctypes extension module without wchar_t type: remove CTYPES_UNICODE macro. Anyway, the wchar_t type is required to build Python. Patch by Victor Stinner.

  • bpo-42087: Support was removed for AIX 5.3 and below. See bpo-40680.

  • bpo-40998: Addressed three compiler warnings found by undefined behavior sanitizer (ubsan).

Windows

  • bpo-42120: Remove macro definition of copysign (to _copysign) in headers.

  • bpo-38506: The Windows launcher now properly handles Python 3.10 when listing installed Python versions.

macOS

  • bpo-42504: Fix build on macOS Big Sur when MACOSX_DEPLOYMENT_TARGET=11

  • bpo-41116: Ensure distutils.unixxcompiler.find_library_file can find system provided libraries on macOS 11.

  • bpo-41100: Add support for macOS 11 and Apple Silicon systems.

    It is now possible to build «Universal 2» binaries using «–enable-universalsdk –with-universal-archs=universal2».

    Binaries build on later macOS versions can be deployed back to older versions (tested up to macOS 10.9), when using the correct deployment target. This is tested using Xcode 11 and later.

  • bpo-42232: Added Darwin specific madvise options to mmap module.

  • bpo-38443: The --enable-universalsdk and --with-universal-archs options for the configure script now check that the specified architectures can be used.

IDLE

  • bpo-42508: Keep IDLE running on macOS. Remove obsolete workaround that prevented running files with shortcuts when using new universal2 installers built on macOS 11.

  • bpo-42426: Fix reporting offset of the RE error in searchengine.

  • bpo-42415: Get docstrings for IDLE calltips more often by using inspect.getdoc.

Tools/Demos

  • bpo-42212: The smelly.py script now also checks the Python dynamic library and extension modules, not only the Python static library. Make also the script more verbose: explain what it does.

  • bpo-36310: Allow Tools/i18n/pygettext.py to detect calls to gettext in f-strings.

C API

Python 3.10.0 alpha 2

Release date: 2020-11-03

Security

  • bpo-42103: Prevented potential DoS attack via CPU and RAM exhaustion when processing malformed Apple Property List files in binary format.

  • bpo-42051: The plistlib module no longer accepts entity declarations in XML plist files to avoid XML vulnerabilities. This should not affect users as entity declarations are not used in regular plist files.

Core and Builtins

  • bpo-42236: If the nl_langinfo(CODESET) function returns an empty string, Python now uses UTF-8 as the filesystem encoding. Patch by Victor Stinner.

  • bpo-42218: Fixed a bug in the PEG parser that was causing crashes in debug mode. Now errors are checked in left-recursive rules to avoid cases where such errors do not get handled in time and appear as long-distance crashes in other places.

  • bpo-42214: Fixed a possible crash in the PEG parser when checking for the “!=” token in the barry_as_flufl rule. Patch by Pablo Galindo.

  • bpo-42206: Propagate and raise the errors caused by PyAST_Validate() in the parser.

  • bpo-41796: The ast module internal state is now per interpreter. Patch by Victor Stinner.

  • bpo-42143: Fix handling of errors during creation of PyFunctionObject, which resulted in operations on uninitialized memory. Patch by Yonatan Goldschmidt.

  • bpo-41659: Fix a bug in the parser, where a curly brace following a primary didn’t fail immediately. This led to invalid expressions like a {b} to throw a SyntaxError with a wrong offset, or invalid expressions ending with a curly brace like a { to not fail immediately in the REPL.

  • bpo-42150: Fix possible buffer overflow in the new parser when checking for continuation lines. Patch by Pablo Galindo.

  • bpo-42123: Run the parser two times. On the first run, disable all the rules that only generate better error messages to gain performance. If there’s a parse failure, run the parser a second time with those enabled.

  • bpo-42093: The LOAD_ATTR instruction now uses new «per opcode cache» mechanism and it is about 36% faster now. Patch by Pablo Galindo and Yury Selivanov.

  • bpo-42030: Support for the legacy AIX-specific shared library loading support has been removed. All versions of AIX since 4.3 have supported and defaulted to using the common Unix mechanism instead.

  • bpo-41984: The garbage collector now tracks all user-defined classes. Patch by Brandt Bucher.

  • bpo-41993: Fixed potential issues with removing not completely initialized module from sys.modules when import fails.

  • bpo-41979: Star-unpacking is now allowed for with item’s targets in the PEG parser.

  • bpo-41974: Removed special methods __int__, __float__, __floordiv__, __mod__, __divmod__, __rfloordiv__, __rmod__ and __rdivmod__ of the complex class. They always raised a TypeError.

  • bpo-41902: Micro optimization when compute sq_item and mp_subscript of range. Patch by Donghee Na.

  • bpo-41894: When loading a native module and a load failure occurs, prevent a possible UnicodeDecodeError when not running in a UTF-8 locale by decoding the load error message using the current locale’s encoding.

  • bpo-41902: Micro optimization for range.index if step is 1. Patch by Donghee Na.

  • bpo-41435: Add sys._current_exceptions() function to retrieve a dictionary mapping each thread’s identifier to the topmost exception currently active in that thread at the time the function is called.

  • bpo-38605: Enable from __future__ import annotations (PEP 563) by default. The values found in __annotations__ dicts are now strings, for example {"x": "int"} instead of {"x": int}.

Library

  • bpo-35455: On Solaris, thread_time() is now implemented with gethrvtime() because clock_gettime(CLOCK_THREAD_CPUTIME_ID) is not always available. Patch by Jakub Kulik.

  • bpo-42233: The repr() of typing types containing Generic Alias Types previously did not show the parameterized types in the GenericAlias. They have now been changed to do so.

  • bpo-29566: binhex.binhex() consistently writes macOS 9 line endings.

  • bpo-26789: The logging.FileHandler class now keeps a reference to the builtin open() function to be able to open or reopen the file during Python finalization. Fix errors like: NameError: name 'open' is not defined. Patch by Victor Stinner.

  • bpo-42157: Removed the unicodedata.ucnhash_CAPI attribute which was an internal PyCapsule object. The related private _PyUnicode_Name_CAPI structure was moved to the internal C API. Patch by Victor Stinner.

  • bpo-42157: Convert the unicodedata extension module to the multiphase initialization API (PEP 489) and convert the unicodedata.UCD static type to a heap type. Patch by Mohamed Koubaa and Victor Stinner.

  • bpo-42146: Fix memory leak in subprocess.Popen() in case an uid (gid) specified in user (group, extra_groups) overflows uid_t (gid_t).

  • bpo-42103: InvalidFileException and RecursionError are now the only errors caused by loading malformed binary Plist file (previously ValueError and TypeError could be raised in some specific cases).

  • bpo-41490: In importlib.resources, .path method is more aggressive about releasing handles to zipfile objects early, enabling use-cases like certifi to leave the context open but delete the underlying zip file.

  • bpo-41052: Pickling heap types implemented in C with protocols 0 and 1 raises now an error instead of producing incorrect data.

  • bpo-42089: In importlib.metadata.PackageNotFoundError, make reference to the package metadata being missing to improve the user experience.

  • bpo-41491: plistlib: fix parsing XML plists with hexadecimal integer values

  • bpo-42065: Fix an incorrectly formatted error from _codecs.charmap_decode() when called with a mapped value outside the range of valid Unicode code points. PR by Max Bernstein.

  • bpo-41966: Fix pickling pure Python datetime.time subclasses. Patch by Dean Inwood.

  • bpo-19270: sched.scheduler.cancel() will now cancel the correct event, if two events with same priority are scheduled for the same time. Patch by Bar Harel.

  • bpo-28660: textwrap.wrap() now attempts to break long words after hyphens when break_long_words=True and break_on_hyphens=True.

  • bpo-35823: Use vfork() instead of fork() for subprocess.Popen() on Linux to improve performance in cases where it is deemed safe.

  • bpo-42043: Add support for zipfile.Path inheritance. zipfile.Path.is_file() now returns False for non-existent names. zipfile.Path objects now expose a .filename attribute and rely on that to resolve .name and .parent when the Path object is at the root of the zipfile.

  • bpo-42021: Fix possible ref leaks in sqlite3 module init.

  • bpo-39101: Fixed tests using IsolatedAsyncioTestCase from hanging on BaseExceptions.

  • bpo-41976: Fixed a bug that was causing ctypes.util.find_library() to return None when triying to locate a library in an environment when gcc>=9 is available and ldconfig is not. Patch by Pablo Galindo

  • bpo-41943: Fix bug where TestCase.assertLogs doesn’t correctly filter messages by level.

  • bpo-41923: Implement PEP 613, introducing typing.TypeAlias annotation.

  • bpo-41905: A new function in abc: update_abstractmethods to re-calculate an abstract class’s abstract status. In addition, dataclass has been changed to call this function.

  • bpo-23706: Added newline parameter to pathlib.Path.write_text().

  • bpo-41876: Tkinter font class repr uses font name

  • bpo-41831: str() for the type attribute of the tkinter.Event object always returns now the numeric code returned by Tk instead of the name of the event type.

  • bpo-39337: encodings.normalize_encoding() now ignores non-ASCII characters.

  • bpo-41747: Ensure all methods that generated from dataclasses.dataclass() objects now have the proper __qualname__ attribute referring to the class they belong to. Patch by Batuhan Taskaya.

  • bpo-30681: Handle exceptions caused by unparsable date headers when using email «default» policy. Patch by Tim Bell, Georges Toth

  • bpo-41586: Add F_SETPIPE_SZ and F_GETPIPE_SZ to fcntl module. Allow setting pipesize on subprocess.Popen.

  • bpo-41229: Add contextlib.aclosing for deterministic cleanup of async generators which is analogous to contextlib.closing for non-async generators. Patch by Joongi Kim and John Belmonte.

  • bpo-16396: Allow ctypes.wintypes to be imported on non-Windows systems.

  • bpo-4356: Add a key function to the bisect module.

  • bpo-40592: shutil.which() now ignores empty entries in PATHEXT instead of treating them as a match.

  • bpo-40492: Fix --outfile for cProfile / profile not writing the output file in the original directory when the program being profiled changes the working directory. PR by Anthony Sottile.

  • bpo-34204: The shelve module now uses pickle.DEFAULT_PROTOCOL by default instead of pickle protocol 3.

  • bpo-27321: Fixed KeyError exception when flattening an email to a string attempts to replace a non-existent Content-Transfer-Encoding header.

  • bpo-38976: The http.cookiejar module now supports the parsing of cookies in CURL-style cookiejar files through MozillaCookieJar on all platforms. Previously, such cookie entries would be silently ignored when loading a cookiejar with such entries.

    Additionally, the HTTP Only attribute is persisted in the object, and will be correctly written to file if the MozillaCookieJar object is subsequently dumped.

Documentation

  • bpo-42061: Document __format__ functionality for IP addresses.

  • bpo-41910: Document the default implementation of object.__eq__.

  • bpo-42010: Clarify that subscription expressions are also valid for certain classes and types in the standard library, and for user-defined classes and types if the classmethod __class_getitem__() is provided.

  • bpo-41805: Documented generic alias type and types.GenericAlias. Also added an entry in glossary for generic types.

  • bpo-39693: Fix tarfile’s extractfile documentation

  • bpo-39416: Document some restrictions on the default string representations of numeric classes.

Tests

  • bpo-41739: Fix test_logging.test_race_between_set_target_and_flush(): the test now waits until all threads complete to avoid leaking running threads.

  • bpo-41970: Avoid a test failure in test_lib2to3 if the module has already imported at the time the test executes. Patch by Pablo Galindo.

  • bpo-41944: Tests for CJK codecs no longer call eval() on content received via HTTP.

  • bpo-41306: Fixed a failure in test_tk.test_widgets.ScaleTest happening when executing the test with Tk 8.6.10.

Build

  • bpo-38980: Add -fno-semantic-interposition to both the compile and link line when building with --enable-optimizations. Patch by Victor Stinner and Pablo Galindo.

Windows

  • bpo-38439: Updates the icons for IDLE in the Windows Store package.

  • bpo-38252: Use 8-byte step to detect ASCII sequence in 64-bit Windows build.

  • bpo-39107: Update Tcl and Tk to 8.6.10 in Windows installer.

  • bpo-41557: Update Windows installer to use SQLite 3.33.0.

  • bpo-38324: Avoid Unicode errors when accessing certain locale data on Windows.

macOS

  • bpo-41471: Ignore invalid prefix lengths in system proxy excludes.

IDLE

  • bpo-33987: Mostly finish using ttk widgets, mainly for editor, settings, and searches. Some patches by Mark Roseman.

  • bpo-40511: Typing opening and closing parentheses inside the parentheses of a function call will no longer cause unnecessary «flashing» off and on of an existing open call-tip, e.g. when typed in a string literal.

  • bpo-38439: Add a 256×256 pixel IDLE icon to the Windows .ico file. Created by Andrew Clover. Remove the low-color gif variations from the .ico file.

C API

  • bpo-42157: The private _PyUnicode_Name_CAPI structure of the PyCapsule API unicodedata.ucnhash_CAPI has been moved to the internal C API. Patch by Victor Stinner.

  • bpo-42015: Fix potential crash in deallocating method objects when dynamically allocated PyMethodDef’s lifetime is managed through the self argument of a PyCFunction.

  • bpo-40423: The subprocess module and os.closerange will now use the close_range(low, high, flags) syscall when it is available for more efficient closing of ranges of descriptors.

  • bpo-41845: PyObject_GenericGetDict() is available again in the limited API when targeting 3.10 or later.

  • bpo-40422: Add _Py_closerange function to provide performant closing of a range of file descriptors.

  • bpo-41986: Py_FileSystemDefaultEncodeErrors and Py_UTF8Mode are available again in limited API.

  • bpo-41756: Add PyIter_Send function to allow sending value into generator/coroutine/iterator without raising StopIteration exception to signal return.

  • bpo-41784: Added PyUnicode_AsUTF8AndSize to the limited C API.

Python 3.10.0 alpha 1

Release date: 2020-10-05

Security

  • bpo-41304: Fixes python3x._pth being ignored on Windows, caused by the fix for bpo-29778 (CVE 2020-15801).

  • bpo-41162: Audit hooks are now cleared later during finalization to avoid missing events.

  • bpo-29778: Ensure python3.dll is loaded from correct locations when Python is embedded (CVE 2020-15523).

  • bpo-41004: The __hash__() methods of ipaddress.IPv4Interface and ipaddress.IPv6Interface incorrectly generated constant hash values of 32 and 128 respectively. This resulted in always causing hash collisions. The fix uses hash() to generate hash values for the tuple of (address, mask length, network address).

  • bpo-39603: Prevent http header injection by rejecting control characters in http.client.putrequest(…).

Core and Builtins

  • bpo-41909: Fixed stack overflow in issubclass() and isinstance() when getting the __bases__ attribute leads to infinite recursion.

  • bpo-41922: Speed up calls to reversed() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-41873: Calls to float() are now faster due to the vectorcall calling convention. Patch by Dennis Sweeney.

  • bpo-41870: Speed up calls to bool() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-1635741: Port the _bisect module to the multi-phase initialization API (PEP 489).

  • bpo-39934: Correctly count control blocks in “except” in compiler. Ensures that a syntax error, rather a fatal error, occurs for deeply nested, named exception handlers.

  • bpo-41780: Fix __dir__() of types.GenericAlias. Patch by Batuhan Taskaya.

  • bpo-1635741: Port the _lsprof extension module to multi-phase initialization (PEP 489).

  • bpo-1635741: Port the cmath extension module to multi-phase initialization (PEP 489).

  • bpo-1635741: Port the _scproxy extension module to multi-phase initialization (PEP 489).

  • bpo-1635741: Port the termios extension module to multi-phase initialization (PEP 489).

  • bpo-1635741: Convert the _sha256 extension module types to heap types.

  • bpo-41690: Fix a possible stack overflow in the parser when parsing functions and classes with a huge amount of arguments. Patch by Pablo Galindo.

  • bpo-1635741: Port the _overlapped extension module to multi-phase initialization (PEP 489).

  • bpo-1635741: Port the _curses_panel extension module to multi-phase initialization (PEP 489).

  • bpo-1635741: Port the _opcode extension module to multi-phase initialization (PEP 489).

  • bpo-41681: Fixes the wrong error description in the error raised by using 2 , in format string in f-string and str.format().

  • bpo-41675: The implementation of signal.siginterrupt() now uses sigaction() (if it is available in the system) instead of the deprecated siginterrupt(). Patch by Pablo Galindo.

  • bpo-41670: Prevent line trace being skipped on platforms not compiled with USE_COMPUTED_GOTOS. Fixes issue where some lines nested within a try-except block were not being traced on Windows.

  • bpo-41654: Fix a crash that occurred when destroying subclasses of MemoryError. Patch by Pablo Galindo.

  • bpo-1635741: Port the zlib extension module to multi-phase initialization (PEP 489).

  • bpo-41631: The _ast module uses again a global state. Using a module state per module instance is causing subtle practical problems. For example, the Mercurial project replaces the __import__() function to implement lazy import, whereas Python expected that import _ast always return a fully initialized _ast module.

  • bpo-40077: Convert _operator to use PyType_FromSpec().

  • bpo-1653741: Port _sha3 to multi-phase init. Convert static types to heap types.

  • bpo-1635741: Port the _blake2 extension module to the multi-phase initialization API (PEP 489).

  • bpo-41533: Free the stack allocated in va_build_stack if do_mkstack fails and the stack is not a small_stack.

  • bpo-41531: Fix a bug that was dropping keys when compiling dict literals with more than 0xFFFF elements. Patch by Pablo Galindo.

  • bpo-41525: The output of python --help contains now only ASCII characters.

  • bpo-1635741: Port the _sha1, _sha512, and _md5 extension modules to multi-phase initialization API (PEP 489).

  • bpo-41431: Optimize dict_merge() for copying dict (e.g. dict(d) and {}.update(d)).

  • bpo-41428: Implement PEP 604. This supports (int | str) etc. in place of Union[str, int].

  • bpo-41340: Removed fallback implementation for strdup.

  • bpo-38156: Handle interrupts that come after EOF correctly in PyOS_StdioReadline.

  • bpo-41342: round() with integer argument is now faster (9–60%).

  • bpo-41334: Constructors str(), bytes() and bytearray() are now faster (around 30–40% for small objects).

  • bpo-41295: Resolve a regression in CPython 3.8.4 where defining «__setattr__» in a multi-inheritance setup and calling up the hierarchy chain could fail if builtins/extension types were involved in the base types.

  • bpo-41323: Bytecode optimizations are performed directly on the control flow graph. This will result in slightly more compact code objects in some circumstances.

  • bpo-41247: Always cache the running loop holder when running asyncio.set_running_loop.

  • bpo-41252: Fix incorrect refcounting in _ssl.c’s _servername_callback().

  • bpo-1635741: Port multiprocessing to multi-phase initialization

  • bpo-1635741: Port winapi to multiphase initialization

  • bpo-41215: Use non-NULL default values in the PEG parser keyword list to overcome a bug that was preventing Python from being properly compiled when using the XLC compiler. Patch by Pablo Galindo.

  • bpo-41218: Python 3.8.3 had a regression where compiling with ast.PyCF_ALLOW_TOP_LEVEL_AWAIT would aggressively mark list comprehension with CO_COROUTINE. Now only list comprehension making use of async/await will tagged as so.

  • bpo-1635741: Port faulthandler to multiphase initialization.

  • bpo-1635741: Port sha256 to multiphase initialization

  • bpo-41175: Guard against a NULL pointer dereference within bytearrayobject triggered by the bytearray() + bytearray() operation.

  • bpo-41100: add arm64 to the allowable Mac OS arches in mpdecimal.h

  • bpo-41094: Fix decoding errors with audit when open files with non-ASCII names on non-UTF-8 locale.

  • bpo-39960: The «hackcheck» that prevents sneaking around a type’s __setattr__() by calling the superclass method was rewritten to allow C implemented heap types.

  • bpo-41084: Prefix the error message with “f-string: “, when parsing an f-string expression which throws a SyntaxError.

  • bpo-40521: Empty frozensets are no longer singletons.

  • bpo-41076: Pre-feed the parser with the location of the f-string expression, not the f-string itself, which allows us to skip the shifting of the AST node locations after the parsing is completed.

  • bpo-41056: Fixes a reference to deallocated stack space during startup when constructing sys.path involving a relative symlink when code was supplied via -c. (discovered via Coverity)

  • bpo-41061: Fix incorrect expressions and asserts in hashtable code and tests.

  • bpo-41052: Opt out serialization/deserialization for _random.Random

  • bpo-40939: Rename PyPegen* functions to PyParser*, so that we can remove the old set of PyParser* functions that were using the old parser, but keep everything backwards-compatible.

  • bpo-35975: Stefan Behnel reported that cf_feature_version is used even when PyCF_ONLY_AST is not set. This is against the intention and against the documented behavior, so it’s been fixed.

  • bpo-40939: Remove the remaining files from the old parser and the symbol module.

  • bpo-40077: Convert _bz2 to use PyType_FromSpec().

  • bpo-41006: The encodings.latin_1 module is no longer imported at startup. Now it is only imported when it is the filesystem encoding or the stdio encoding.

  • bpo-40636: zip() now supports PEP 618’s strict parameter, which raises a ValueError if the arguments are exhausted at different lengths. Patch by Brandt Bucher.

  • bpo-1635741: Port _gdbm to multiphase initialization.

  • bpo-40985: Fix a bug that caused the SyntaxError text to be empty when a file ends with a line ending in a line continuation character (i.e. backslash). The error text should contain the text of the last line.

  • bpo-40958: Fix a possible buffer overflow in the PEG parser when gathering information for emitting syntax errors. Patch by Pablo Galindo.

  • bpo-1635741: Port _dbm to multiphase initialization.

  • bpo-40957: Fix refleak in _Py_fopen_obj() when PySys_Audit() fails

  • bpo-40950: Add a state to the nis module (PEP 3121) and apply the multiphase initialization. Patch by Donghee Na.

  • bpo-40947: The Python Path Configuration now takes PyConfig.platlibdir in account.

  • bpo-40939: Remove the old parser, the parser module and all associated support code, command-line options and environment variables. Patch by Pablo Galindo.

  • bpo-40847: Fix a bug where a line with only a line continuation character is not considered a blank line at tokenizer level. In such cases, more than a single NEWLINE token was emitted. The old parser was working around the issue, but the new parser threw a SyntaxError for valid input due to this. For example, an empty line following a line continuation character was interpreted as a SyntaxError.

  • bpo-40890: Each dictionary view now has a mapping attribute that provides a types.MappingProxyType wrapping the original dictionary. Patch contributed by Dennis Sweeney.

  • bpo-40889: Improved the performance of symmetric difference operations on dictionary item views. Patch by Dennis Sweeney.

  • bpo-40904: Fix possible segfault in the new PEG parser when parsing f-string containing yield statements with no value (f"{yield}"). Patch by Pablo Galindo

  • bpo-40903: Fixed a possible segfault in the new PEG parser when producing error messages for invalid assignments of the form p=p=. Patch by Pablo Galindo

  • bpo-40880: Fix invalid memory read in the new parser when checking newlines in string literals. Patch by Pablo Galindo.

  • bpo-40883: Fix memory leak in when parsing f-strings in the new parser. Patch by Pablo Galindo

  • bpo-40870: Raise ValueError when validating custom AST’s where the constants True, False and None are used within a ast.Name node.

  • bpo-40854: Allow overriding sys.platlibdir via a new PYTHONPLATLIBDIR environment variable.

  • bpo-40826: Fix GIL usage in PyOS_Readline(): lock the GIL to set an exception and pass the Python thread state when checking if there is a pending signal.

  • bpo-1635741: Port fcntl to multiphase initialization.

  • bpo-19468: Delete unnecessary instance check in importlib.reload(). Patch by Furkan Önder.

  • bpo-40824: Unexpected errors in calling the __iter__ method are no longer masked by TypeError in the in operator and functions contains(), indexOf() and countOf() of the operator module.

  • bpo-40792: Attributes start, stop and step of the range object now always has exact type int. Previously, they could have been an instance of a subclass of int.

  • bpo-40780: Fix a corner case where g-style string formatting of a float failed to remove trailing zeros.

  • bpo-38964: When there’s a SyntaxError in the expression part of an fstring, the filename attribute of the SyntaxError gets correctly set to the name of the file the fstring resides in.

  • bpo-40750: Support the «-d» debug flag in the new PEG parser. Patch by Pablo Galindo

  • bpo-40217: Instances of types created with PyType_FromSpecWithBases() will no longer automatically visit their class object when traversing references in the garbage collector. The user is expected to manually visit the object’s class. Patch by Pablo Galindo.

  • bpo-39573: Py_TYPE() is changed to the inline static function. Patch by Donghee Na.

  • bpo-40696: Fix a hang that can arise after generator.throw() due to a cycle in the exception context chain.

  • bpo-40521: Each interpreter now its has own free lists, singletons and caches:

    • Free lists: float, tuple, list, dict, frame, context, asynchronous generator, MemoryError.

    • Singletons: empty tuple, empty bytes string, empty Unicode string, single byte character, single Unicode (latin1) character.

    • Slice cache.

    They are no longer shared by all interpreters.

  • bpo-40679: Certain TypeError messages about missing or extra arguments now include the function’s qualified name. Patch by Dennis Sweeney.

  • bpo-29590: Make the stack trace correct after calling generator.throw() on a generator that has yielded from a yield from.

  • bpo-4022: Improve performance of generators by not raising internal StopIteration.

  • bpo-1635741: Port mmap to multiphase initialization.

  • bpo-1635741: Port _lzma to multiphase initialization.

  • bpo-37999: Builtin and extension functions that take integer arguments no longer accept Decimals, Fractions and other objects that can be converted to integers only with a loss (e.g. that have the __int__() method but do not have the __index__() method).

  • bpo-29882: Add int.bit_count(), counting the number of ones in the binary representation of an integer. Patch by Niklas Fiekas.

  • bpo-36982: Use ncurses extended color functions when available to support terminals with 256 colors, and add the new function curses.has_extended_color_support() to indicate whether extended color support is provided by the underlying ncurses library.

  • bpo-19569: Add the private macros _Py_COMP_DIAG_PUSH, _Py_COMP_DIAG_IGNORE_DEPR_DECLS, and _Py_COMP_DIAG_POP.

  • bpo-26680: The int type now supports the x.is_integer() method for compatibility with float.

Library

  • bpo-41900: C14N 2.0 serialisation in xml.etree.ElementTree failed for unprefixed attributes when a default namespace was defined.

  • bpo-41887: Strip leading spaces and tabs on ast.literal_eval(). Also document stripping of spaces and tabs for eval().

  • bpo-41773: Note in documentation that random.choices() doesn’t support non-finite weights, raise ValueError when given non-finite weights.

  • bpo-41840: Fix a bug in the symtable module that was causing module-scope global variables to not be reported as both local and global. Patch by Pablo Galindo.

  • bpo-41842: Add codecs.unregister() function to unregister a codec search function.

  • bpo-40564: In zipfile.Path, mutate the passed ZipFile object type instead of making a copy. Prevents issues when both the local copy and the caller’s copy attempt to close the same file handle.

  • bpo-40670: More reliable validation of statements in timeit.Timer. It now accepts «empty» statements (only whitespaces and comments) and rejects misindentent statements.

  • bpo-41833: The threading.Thread constructor now uses the target name if the target argument is specified but the name argument is omitted.

  • bpo-41817: fix tkinter.EventType Enum so all members are strings, and none are tuples

  • bpo-41810: types.EllipsisType, types.NotImplementedType and types.NoneType have been reintroduced, providing a new set of types readily interpretable by static type checkers.

  • bpo-41815: Fix SQLite3 segfault when backing up closed database. Patch contributed by Peter David McCormick.

  • bpo-41816: StrEnum added: it ensures that all members are already strings or string candidates

  • bpo-41517: fix bug allowing Enums to be extended via multiple inheritance

  • bpo-39587: use the correct mix-in data type when constructing Enums

  • bpo-41792: Add is_typeddict function to typing.py to check if a type is a TypedDict class

    Previously there was no way to check that without using private API. See the relevant issue in python/typing.

  • bpo-41789: Honor object overrides in Enum class creation (specifically, __str__, __repr__, __format__, and __reduce_ex__).

  • bpo-32218: enum.Flag and enum.IntFlag members are now iterable.

  • bpo-39651: Fix a race condition in the call_soon_threadsafe() method of asyncio.ProactorEventLoop: do nothing if the self-pipe socket has been closed.

  • bpo-1635741: Port the mashal extension module to the multi-phase initialization API (PEP 489).

  • bpo-1635741: Port the _string extension module to the multi-phase initialization API (PEP 489).

  • bpo-41732: Added an iterator to memoryview.

  • bpo-41720: Fixed turtle.Vec2D.__rmul__() for arguments which are not int or float.

  • bpo-41696: Fix handling of debug mode in asyncio.run(). This allows setting PYTHONASYNCIODEBUG or -X dev to enable asyncio debug mode when using asyncio.run().

  • bpo-41687: Fix implementation of sendfile to be compatible with Solaris.

  • bpo-41662: No longer override exceptions raised in __len__() of a sequence of parameters in sqlite3 with ProgrammingError.

  • bpo-39010: Restarting a ProactorEventLoop on Windows no longer logs spurious ConnectionResetErrors.

  • bpo-41638: ProgrammingError message for absent parameter in sqlite3 contains now the name of the parameter instead of its index when parameters are supplied as a dict.

  • bpo-41662: Fixed crash when mutate list of parameters during iteration in sqlite3.

  • bpo-41513: Improved the accuracy of math.hypot(). Internally, each step is computed with extra precision so that the result is now almost always correctly rounded.

  • bpo-41609: The pdb whatis command correctly reports instance methods as “Method” rather than “Function”.

  • bpo-39994: Fixed pprint’s handling of dict subclasses that override __repr__.

  • bpo-32751: When cancelling the task due to a timeout, asyncio.wait_for() will now wait until the cancellation is complete also in the case when timeout is <= 0, like it does with positive timeouts.

  • bpo-37658: asyncio.wait_for() now properly handles races between cancellation of itself and the completion of the wrapped awaitable.

  • bpo-40782: Change the method asyncio.AbstractEventLoop.run_in_executor to not be a coroutine.

  • bpo-41520: Fix codeop regression that prevented turning compile warnings into errors.

  • bpo-41528: turtle uses math module functions to convert degrees to radians and vice versa and to calculate vector norm

  • bpo-41513: Minor algorithmic improvement to math.hypot() and math.dist() giving small gains in speed and accuracy.

  • bpo-41503: Fixed a race between setTarget and flush in logging.handlers.MemoryHandler.

  • bpo-41497: Fix potential UnicodeDecodeError in dis module.

  • bpo-41467: On Windows, fix asyncio recv_into() return value when the socket/pipe is closed (BrokenPipeError): return 0 rather than an empty byte string (b'').

  • bpo-41425: Make tkinter doc example runnable.

  • bpo-41421: Make an algebraic simplification to random.paretovariate(). It now is slightly less subject to round-off error and is slightly faster. Inputs that used to cause ZeroDivisionError now cause an OverflowError instead.

  • bpo-41440: Add os.cpu_count() support for VxWorks RTOS.

  • bpo-41316: Fix the tarfile module to write only basename of TAR file to GZIP compression header.

  • bpo-41384: Raise TclError instead of TypeError when an unknown option is passed to tkinter.OptionMenu.

  • bpo-41317: Use add_done_callback() in asyncio.loop.sock_accept() to unsubscribe reader early on cancellation.

  • bpo-41364: Reduce import overhead of uuid.

  • bpo-35328: Set the environment variable VIRTUAL_ENV_PROMPT at venv activation.

  • bpo-41341: Recursive evaluation of typing.ForwardRef in get_type_hints.

  • bpo-41344: Prevent creating shared_memory.SharedMemory objects with size=0.

  • bpo-41333: collections.OrderedDict.pop() is now 2 times faster.

  • bpo-41288: Unpickling invalid NEWOBJ_EX opcode with the C implementation raises now UnpicklingError instead of crashing.

  • bpo-39017: Avoid infinite loop when reading specially crafted TAR files using the tarfile module (CVE 2019-20907).

  • bpo-41273: Speed up any transport using _ProactorReadPipeTransport by calling recv_into instead of recv, thus not creating a new buffer for each recv call in the transport’s read loop.

  • bpo-41235: Fix the error handling in ssl.SSLContext.load_dh_params().

  • bpo-41207: In distutils.spawn, restore expectation that DistutilsExecError is raised when the command is not found.

  • bpo-29727: Register array.array as a MutableSequence. Patch by Pablo Galindo.

  • bpo-39168: Remove the __new__ method of typing.Generic.

  • bpo-41194: Fix a crash in the _ast module: it can no longer be loaded more than once. It now uses a global state rather than a module state.

  • bpo-41195: Add read-only ssl.SSLContext.security_level attribute to retrieve the context’s security level.

  • bpo-41193: The write_history() atexit function of the readline completer now ignores any OSError to ignore error if the filesystem is read-only, instead of only ignoring FileNotFoundError and PermissionError.

  • bpo-41182: selector: use DefaultSelector based upon implementation

  • bpo-41161: The decimal module now requires libmpdec-2.5.0. Users of –with-system-libmpdec should update their system library.

  • bpo-40874: The decimal module now requires libmpdec-2.5.0.

  • bpo-41138: Fixed the trace module CLI for Python source files with non-UTF-8 encoding.

  • bpo-31082: Use the term «iterable» in the docstring for functools.reduce().

  • bpo-40521: Remove freelist from collections.deque().

  • bpo-31938: Fix default-value signatures of several functions in the select module - by Anthony Sottile.

  • bpo-41068: Fixed reading files with non-ASCII names from ZIP archive directly after writing them.

  • bpo-41058: pdb.find_function() now correctly determines the source file encoding.

  • bpo-41056: Invalid file descriptor values are now prevented from being passed to os.fpathconf. (discovered by Coverity)

  • bpo-41056: Fix a NULL pointer dereference within the ssl module during a MemoryError in the keylog callback. (discovered by Coverity)

  • bpo-41056: Fixed an instance where a MemoryError within the zoneinfo module might not be reported or not reported at its source. (found by Coverity)

  • bpo-41048: mimetypes.read_mime_types() function reads the rule file using UTF-8 encoding, not the locale encoding. Patch by Srinivas Reddy Thatiparthy.

  • bpo-41043: Fixed the use of glob() in the stdlib: literal part of the path is now always correctly escaped.

  • bpo-41025: Fixed an issue preventing the C implementation of zoneinfo.ZoneInfo from being subclassed.

  • bpo-35018: Add the xml.sax.handler.LexicalHandler class that is present in other SAX XML implementations.

  • bpo-41002: Improve performance of HTTPResponse.read with a given amount. Patch by Bruce Merry.

  • bpo-40448: ensurepip now disables the use of pip cache when installing the bundled versions of pip and setuptools. Patch by Krzysztof Konopko.

  • bpo-40967: Removed asyncio.Task.current_task() and asyncio.Task.all_tasks(). Patch contributed by Rémi Lapeyre.

  • bpo-40924: Ensure importlib.resources.path returns an extant path for the SourceFileLoader’s resource reader. Avoids the regression identified in master while a long-term solution is devised.

  • bpo-40955: Fix a minor memory leak in subprocess module when extra_groups was specified.

  • bpo-40855: The standard deviation and variance functions in the statistics module were ignoring their mu and xbar arguments.

  • bpo-40939: Use the new PEG parser when generating the stdlib keyword module.

  • bpo-23427: Add sys.orig_argv attribute: the list of the original command line arguments passed to the Python executable.

  • bpo-33689: Ignore empty or whitespace-only lines in .pth files. This matches the documentated behavior. Before, empty lines caused the site-packages dir to appear multiple times in sys.path. By Ido Michael, contributors Malcolm Smith and Tal Einat.

  • bpo-40884: Added a defaults parameter to logging.Formatter, to allow specifying default values for custom fields. Patch by Asaf Alon and Bar Harel.

  • bpo-40876: Clarify error message in the csv module.

  • bpo-39791: Refresh importlib.metadata from importlib_metadata 1.6.1.

  • bpo-40807: Stop codeop._maybe_compile, used by code.InteractiveInterpreter (and IDLE). from emitting each warning three times.

  • bpo-32604: Fix reference leak in the select module when the module is imported in a subinterpreter.

  • bpo-39791: Built-in loaders (SourceFileLoader and ZipImporter) now supply TraversableResources implementations for ResourceReader, and the fallback function has been removed.

  • bpo-39314: rlcompleter.Completer and the standard Python shell now close the parenthesis for functions that take no arguments. Patch contributed by Rémi Lapeyre.

  • bpo-17005: The topological sort functionality that was introduced initially in the functools module has been moved to a new graphlib module to better accommodate the new tools and keep the original scope of the functools module. Patch by Pablo Galindo

  • bpo-40834: Fix truncate when sending str object with_xxsubinterpreters.channel_send.

  • bpo-40755: Add rich comparisons to collections.Counter().

  • bpo-26407: Unexpected errors in calling the __iter__ method are no longer masked by TypeError in csv.reader(), csv.writer.writerow() and csv.writer.writerows().

  • bpo-39384: Fixed email.contentmanager to allow set_content() to set a null string.

  • bpo-40744: The sqlite3 module uses SQLite API functions that require SQLite v3.7.3 or higher. This patch removes support for older SQLite versions, and explicitly requires SQLite 3.7.3 both at build, compile and runtime. Patch by Sergey Fedoseev and Erlend E. Aasland.

  • bpo-40777: Initialize PyDateTime_IsoCalendarDateType.tp_base at run-time to avoid errors on some compilers.

  • bpo-38488: Update ensurepip to install pip 20.1.1 and setuptools 47.1.0.

  • bpo-40792: The result of operator.index() now always has exact type int. Previously, the result could have been an instance of a subclass of int.

  • bpo-40767: webbrowser now properly finds the default browser in pure Wayland systems by checking the WAYLAND_DISPLAY environment variable. Patch contributed by Jérémy Attali.

  • bpo-40791: hashlib.compare_digest() uses OpenSSL’s CRYPTO_memcmp() function when OpenSSL is available.

  • bpo-40795: ctypes module: If ctypes fails to convert the result of a callback or if a ctypes callback function raises an exception, sys.unraisablehook is now called with an exception set. Previously, the error was logged into stderr by PyErr_Print().

  • bpo-16995: Add base64.b32hexencode() and base64.b32hexdecode() to support the Base32 Encoding with Extended Hex Alphabet.

  • bpo-30008: Fix ssl code to be compatible with OpenSSL 1.1.x builds that use no-deprecated and --api=1.1.0.

  • bpo-30064: Fix asyncio loop.sock_* race condition issue

  • bpo-40759: Deprecate the symbol module.

  • bpo-40756: The second argument (extra) of LoggerAdapter.__init__ now defaults to None.

  • bpo-37129: Add a new os.RWF_APPEND flag for os.pwritev().

  • bpo-40737: Fix possible reference leak for sqlite3 initialization.

  • bpo-40726: Handle cases where the end_lineno is None on ast.increment_lineno().

  • bpo-40698: distutils upload creates SHA2-256 and Blake2b-256 digests. MD5 digests is skipped if platform blocks MD5.

  • bpo-40695: hashlib no longer falls back to builtin hash implementations when OpenSSL provides a hash digest and the algorithm is blocked by security policy.

  • bpo-9216: hashlib.new() passed usedforsecurity to OpenSSL EVP constructor _hashlib.new(). test_hashlib and test_smtplib handle strict security policy better.

  • bpo-40614: ast.parse() will not parse self documenting expressions in f-strings when passed feature_version is less than (3, 8).

  • bpo-40626: Add h5 file extension as MIME Type application/x-hdf5, as per HDF Group recommendation for HDF5 formatted data files. Patch contributed by Mark Schwab.

  • bpo-25920: On macOS, when building Python for macOS 10.4 and older, which wasn’t the case for python.org macOS installer, socket.getaddrinfo() no longer uses an internal lock to prevent race conditions when calling getaddrinfo() which is thread-safe since macOS 10.5. Python 3.9 requires macOS 10.6 or newer. The internal lock caused random hang on fork when another thread was calling socket.getaddrinfo(). The lock was also used on FreeBSD older than 5.3, OpenBSD older than 201311 and NetBSD older than 4.

  • bpo-40671: Prepare _hashlib for PEP 489 and use PyModule_AddType().

  • bpo-32309: Added a new coroutine asyncio.to_thread(). It is mainly used for running IO-bound functions in a separate thread to avoid blocking the event loop, and essentially works as a high-level version of run_in_executor() that can directly take keyword arguments.

  • bpo-36543: Restored the deprecated xml.etree.cElementTree module.

  • bpo-40611: MAP_POPULATE constant has now been added to the list of exported mmap module flags.

  • bpo-39881: PEP 554 for use in the test suite. (Patch By Joannah Nanjekye)

  • bpo-13097: ctypes now raises an ArgumentError when a callback is invoked with more than 1024 arguments.

  • bpo-39385: A new test assertion context-manager, unittest.assertNoLogs() will ensure a given block of code emits no log messages using the logging module. Contributed by Kit Yan Choi.

  • bpo-23082: Updated the error message and docs of PurePath.relative_to() to better reflect the function behaviour.

  • bpo-40318: Use SQLite3 trace v2 API, if it is available.

  • bpo-40105: ZipFile truncates files to avoid corruption when a shorter comment is provided in append («a») mode. Patch by Jan Mazur.

  • bpo-40084: Fix Enum.__dir__: dir(Enum.member) now includes attributes as well as methods.

  • bpo-31122: ssl.wrap_socket() now raises ssl.SSLEOFError rather than OSError when peer closes connection during TLS negotiation

  • bpo-39728: fix default _missing_ so a duplicate ValueError is not set as the __context__ of the original ValueError.

  • bpo-39244: Fixed multiprocessing.context.get_all_start_methods to properly return the default method first on macOS.

  • bpo-39040: Fix parsing of invalid mime headers parameters by collapsing whitespace between encoded words in a bare-quote-string.

  • bpo-38731: Add --quiet option to command-line interface of py_compile. Patch by Gregory Schevchenko.

  • bpo-35714: struct.error is now raised if there is a null character in a struct format string.

  • bpo-38144: Added the root_dir and dir_fd parameters in glob.glob().

  • bpo-26543: Fix IMAP4.noop() when debug mode is enabled (ex: imaplib.Debug = 3).

  • bpo-12178: csv.writer() now correctly escapes escapechar when input contains escapechar. Patch by Catalin Iacob, Berker Peksag, and Itay Elbirt.

  • bpo-36290: AST nodes are now raising TypeError on conflicting keyword arguments. Patch contributed by Rémi Lapeyre.

  • bpo-33944: Added site.py site-packages tracing in verbose mode.

  • bpo-35078: Refactor formatweekday, formatmonthname methods in LocaleHTMLCalendar and LocaleTextCalendar classes in calendar module to call the base class methods.This enables customizable CSS classes for LocaleHTMLCalendar. Patch by Srinivas Reddy Thatiparthy

  • bpo-29620: assertWarns() no longer raises a RuntimeException when accessing a module’s __warningregistry__ causes importation of a new module, or when a new module is imported in another thread. Patch by Kernc.

  • bpo-31844: Remove ParserBase.error() method from the private and undocumented _markupbase module. html.parser.HTMLParser is the only subclass of ParserBase and its error() implementation was deprecated in Python 3.4 and removed in Python 3.5.

  • bpo-34226: Fix cgi.parse_multipart without content_length. Patch by Roger Duran

  • bpo-33660: Fix pathlib.PosixPath to resolve a relative path located on the root directory properly.

  • bpo-28557: Improve the error message for a misbehaving rawio.readinto

  • bpo-26680: The d.is_integer() method is added to the Decimal type, for compatibility with other number types.

  • bpo-26680: The x.is_integer() method is incorporated into the abstract types of the numeric tower, Real, Rational and Integral, with appropriate default implementations.

Documentation

  • bpo-41428: Add documentation for PEP 604 (Allow writing union types as X | Y).

  • bpo-41774: In Programming FAQ «Sequences (Tuples/Lists)» section, add «How do you remove multiple items from a list».

  • bpo-35293: Fix RemovedInSphinx40Warning when building the documentation. Patch by Donghee Na.

  • bpo-37149: Change Shipman tkinter doc link from archive.org to TkDocs. (The doc has been removed from the NMT server.) The new link responds much faster and includes a short explanatory note.

  • bpo-41726: Update the refcounts info of PyType_FromModuleAndSpec.

  • bpo-41624: Fix the signature of typing.Coroutine.

  • bpo-40204: Enable Sphinx 3.2 c_allow_pre_v3 option and disable c_warn_on_allowed_pre_v3 option to make the documentation compatible with Sphinx 2 and Sphinx 3.

  • bpo-41045: Add documentation for debug feature of f-strings.

  • bpo-41314: Changed the release when from __future__ import annotations becomes the default from 4.0 to 3.10 (following a change in PEP 563).

  • bpo-40979: Refactored typing.rst, arranging more than 70 classes, functions, and decorators into new sub-sections.

  • bpo-40552: Fix in tutorial section 4.2. Code snippet is now correct.

  • bpo-39883: Make code, examples, and recipes in the Python documentation be licensed under the more permissive BSD0 license in addition to the existing Python 2.0 license.

  • bpo-37703: Updated Documentation to comprehensively elaborate on the behaviour of gather.cancel()

Tests

  • bpo-41939: Fix test_site.test_license_exists_at_url(): call urllib.request.urlcleanup() to reset the global urllib.request._opener. Patch by Victor Stinner.

  • bpo-41731: Make test_cmd_line_script pass with option “-vv”.

  • bpo-41602: Add tests for SIGINT handling in the runpy module.

  • bpo-41521: test.support: Rename blacklist parameter of check__all__() to not_exported.

  • bpo-41477: Make ctypes optional in test_genericalias.

  • bpo-41085: Fix integer overflow in the array.array.index() method on 64-bit Windows for index larger than 2**31.

  • bpo-41069: test.support.TESTFN and the current directory for tests when run via test.regrtest contain now non-ascii characters if possible.

  • bpo-38377: On Linux, skip tests using multiprocessing if the current user cannot create a file in /dev/shm/ directory. Add the skip_if_broken_multiprocessing_synchronize() function to the test.support module.

  • bpo-41009: Fix use of support.require_{linux|mac|freebsd}_version() decorators as class decorator.

  • bpo-41003: Fix test_copyreg when numpy is installed: test.pickletester now saves/restores warnings filters when importing numpy, to ignore filters installed by numpy.

  • bpo-40964: Disable remote imaplib tests, host cyrus.andrew.cmu.edu is blocking incoming connections.

  • bpo-40927: Fix test_binhex when run twice: it now uses import_fresh_module() to ensure that it raises DeprecationWarning each time.

  • bpo-17258: Skip some multiprocessing tests when MD5 hash digest is blocked.

  • bpo-31904: Increase LOOPBACK_TIMEOUT to 10 for VxWorks RTOS.

  • bpo-38169: Increase code coverage for SharedMemory and ShareableList

  • bpo-34401: Make test_gdb properly run on HP-UX. Patch by Michael Osipov.

Build

  • bpo-38249: Update Py_UNREACHABLE to use __builtin_unreachable() if only the compiler is able to use it. Patch by Donghee Na.

  • bpo-41617: Fix pycore_bitutils.h header file to support old clang versions: __builtin_bswap16() is not available in LLVM clang 3.0.

  • bpo-40204: Pin Sphinx version to 2.3.1 in Doc/Makefile.

  • bpo-36020: The C99 functions snprintf() and vsnprintf() are now required to build Python.

  • bpo-40684: make install now uses the PLATLIBDIR variable for the destination lib-dynload/ directory when ./configure --with-platlibdir is used.

  • bpo-40683: Fixed an issue where the zoneinfo module and its tests were not included when Python is installed with make.

Windows

  • bpo-41744: Fixes automatic import of props file when using the Nuget package.

  • bpo-41627: The user site directory for 32-bit now includes a -32 suffix to distinguish it from the 64-bit interpreter’s directory.

  • bpo-41526: Fixed layout of final page of the installer by removing the special thanks to Mark Hammond (with his permission).

  • bpo-41492: Fixes the description that appears in UAC prompts.

  • bpo-40948: Improve post-install message to direct people to the «py» command.

  • bpo-41412: The installer will now fail to install on Windows 7 and Windows 8. Further, the UCRT dependency is now always downloaded on demand.

  • bpo-40741: Update Windows release to include SQLite 3.32.3.

  • bpo-41142: msilib now supports creating CAB files with non-ASCII file path and adding files with non-ASCII file path to them.

  • bpo-41074: Fixed support of non-ASCII names in functions msilib.OpenDatabase() and msilib.init_database() and non-ASCII SQL in method msilib.Database.OpenView().

  • bpo-41039: Stable ABI redirection DLL (python3.dll) now uses #pragma comment(linker) for re-exporting.

  • bpo-40164: Updates Windows OpenSSL to 1.1.1g

  • bpo-39631: Changes the registered MIME type for .py files on Windows to text/x-python instead of text/plain.

  • bpo-40677: Manually define IO_REPARSE_TAG_APPEXECLINK in case some old Windows SDK doesn’t have it.

  • bpo-37556: Extend py.exe help to mention overrides via venv, shebang, environmental variables & ini files.

macOS

  • bpo-41557: Update macOS installer to use SQLite 3.33.0.

  • bpo-39580: Avoid opening Finder window if running installer from the command line. Patch contributed by Rick Heil.

  • bpo-41100: Fix configure error when building on macOS 11. Note that the current Python release was released shortly after the first developer preview of macOS 11 (Big Sur); there are other known issues with building and running on the developer preview. Big Sur is expected to be fully supported in a future bugfix release of Python 3.8.x and with 3.9.0.

  • bpo-40741: Update macOS installer to use SQLite 3.32.3.

  • bpo-41005: fixed an XDG settings issue not allowing macos to open browser in webbrowser.py

  • bpo-40741: Update macOS installer to use SQLite 3.32.2.

IDLE

  • bpo-41775: Use “IDLE Shell” as shell title

  • bpo-35764: Rewrite the Calltips doc section.

  • bpo-40181: In calltips, stop reminding that “/” marks the end of positional-only arguments.

  • bpo-41468: Improve IDLE run crash error message (which users should never see).

  • bpo-41373: Save files loaded with no line ending, as when blank, or different line endings, by setting its line ending to the system default. Fix regression in 3.8.4 and 3.9.0b4.

  • bpo-41300: Save files with non-ascii chars. Fix regression released in 3.9.0b4 and 3.8.4.

  • bpo-37765: Add keywords to module name completion list. Rewrite Completions section of IDLE doc.

  • bpo-41152: The encoding of stdin, stdout and stderr in IDLE is now always UTF-8.

  • bpo-41144: Make Open Module open a special module such as os.path.

  • bpo-39885: Make context menu Cut and Copy work again when right-clicking within a selection.

  • bpo-40723: Make test_idle pass when run after import.

C API

  • bpo-41936: Removed undocumented macros Py_ALLOW_RECURSION and Py_END_ALLOW_RECURSION and the recursion_critical field of the PyInterpreterState structure.

  • bpo-41692: The PyUnicode_InternImmortal() function is now deprecated and will be removed in Python 3.12: use PyUnicode_InternInPlace() instead. Patch by Victor Stinner.

  • bpo-41842: Add PyCodec_Unregister() function to unregister a codec search function.

  • bpo-41834: Remove the _Py_CheckRecursionLimit variable: it has been replaced by ceval.recursion_limit of the PyInterpreterState structure. Patch by Victor Stinner.

  • bpo-41689: Types created with PyType_FromSpec() now make any signature in their tp_doc slot accessible from __text_signature__.

  • bpo-41524: Fix bug in PyOS_mystrnicmp and PyOS_mystricmp that incremented pointers beyond the end of a string.

  • bpo-41324: Add a minimal decimal capsule API. The API supports fast conversions between Decimals up to 38 digits and their triple representation as a C struct.

  • bpo-30155: Add PyDateTime_DATE_GET_TZINFO() and PyDateTime_TIME_GET_TZINFO() macros for accessing the tzinfo attributes of datetime.datetime and datetime.time objects.

  • bpo-40170: Revert PyType_HasFeature() change: it reads again directly the PyTypeObject.tp_flags member when the limited C API is not used, rather than always calling PyType_GetFlags() which hides implementation details.

  • bpo-41123: Remove PyUnicode_AsUnicodeCopy.

  • bpo-41123: Removed PyLong_FromUnicode().

  • bpo-41123: Removed PyUnicode_GetMax().

  • bpo-41123: Removed Py_UNICODE_str* functions manipulating Py_UNICODE* strings.

  • bpo-41103: PyObject_AsCharBuffer(), PyObject_AsReadBuffer(), PyObject_CheckReadBuffer(), and PyObject_AsWriteBuffer() are removed. Please migrate to new buffer protocol; PyObject_GetBuffer() and PyBuffer_Release().

  • bpo-36346: Raises DeprecationWarning for PyUnicode_FromUnicode(NULL, size) and PyUnicode_FromStringAndSize(NULL, size) with size > 0.

  • bpo-36346: Mark Py_UNICODE_COPY, Py_UNICODE_FILL, PyUnicode_WSTR_LENGTH, PyUnicode_FromUnicode, PyUnicode_AsUnicode, and PyUnicode_AsUnicodeAndSize as deprecated in C. Remove Py_UNICODE_MATCH which was deprecated and broken since Python 3.3.

  • bpo-40989: The PyObject_INIT() and PyObject_INIT_VAR() macros become aliases to, respectively, PyObject_Init() and PyObject_InitVar() functions.

  • bpo-36020: On Windows, #include "pyerrors.h" no longer defines snprintf and vsnprintf macros.

  • bpo-40943: The PY_SSIZE_T_CLEAN macro must now be defined to use PyArg_ParseTuple() and Py_BuildValue() formats which use #: es#, et#, s#, u#, y#, z#, U# and Z#. See Parsing arguments and building values and the PEP 353.

  • bpo-40910: Export explicitly the Py_GetArgcArgv() function to the C API and document the function. Previously, it was exported implicitly which no longer works since Python is built with -fvisibility=hidden.

  • bpo-40724: Allow defining buffer slots in type specs.

  • bpo-40679: Fix a _PyEval_EvalCode() crash if qualname argument is NULL.

  • bpo-40839: Calling PyDict_GetItem() without GIL held had been allowed for historical reason. It is no longer allowed.

  • bpo-40826: PyOS_InterruptOccurred() now fails with a fatal error if it is called with the GIL released.

  • bpo-40792: The result of PyNumber_Index() now always has exact type int. Previously, the result could have been an instance of a subclass of int.

  • bpo-39573: Convert Py_REFCNT() and Py_SIZE() macros to static inline functions. They cannot be used as l-value anymore: use Py_SET_REFCNT() and Py_SET_SIZE() to set an object reference count and size. This change is backward incompatible on purpose, to prepare the C API for an opaque PyObject structure.

  • bpo-40703: The PyType_FromSpec*() functions no longer overwrite the type’s «__module__» attribute if it is set via «Py_tp_members» or «Py_tp_getset».

  • bpo-39583: Remove superfluous «extern C» declarations from Include/cpython/*.h.

Python 3.9.0 beta 1

Release date: 2020-05-19

Security

Core and Builtins

  • bpo-40663: Correctly generate annotations where parentheses are omitted but required (e.g: Type[(str, int, *other))].

  • bpo-40596: Fixed str.isidentifier() for non-canonicalized strings containing non-BMP characters on Windows.

  • bpo-40593: Improved syntax errors for invalid characters in source code.

  • bpo-40585: Fixed a bug when using codeop.compile_command() that was causing exceptions to be swallowed with the new parser. Patch by Pablo Galindo

  • bpo-40566: Apply PEP 573 to abc.

  • bpo-40502: Initialize n->n_col_offset. (Patch by Joannah Nanjekye)

  • bpo-40527: Fix command line argument parsing: no longer write errors multiple times into stderr.

  • bpo-1635741: Port errno to multiphase initialization (PEP 489).

  • bpo-40523: Add pass-throughs for hash() and reversed() to weakref.proxy objects. Patch by Pablo Galindo.

  • bpo-1635741: Port syslog to multiphase initialization (PEP 489).

  • bpo-40246: Reporting a specialised error message for invalid string prefixes, which was introduced in bpo-40246, is being reverted due to backwards compatibility concerns for strings that immediately follow a reserved keyword without whitespace between them. Constructs like bg="#d00" if clear else"#fca" were failing to parse, which is not an acceptable breakage on such short notice.

  • bpo-40417: Fix imp module deprecation warning when PyImport_ReloadModule is called. Patch by Robert Rouhani.

  • bpo-40408: Fixed support of nested type variables in GenericAlias (e.g. list[list[T]]).

  • bpo-1635741: Port _stat module to multiphase initialization (PEP 489).

  • bpo-29587: Enable implicit exception chaining when calling generator.throw().

  • bpo-40328: Add tools for generating mappings headers for CJKCodecs.

  • bpo-40228: Setting frame.f_lineno is now robust w.r.t. changes in the source-to-bytecode compiler

  • bpo-38880: Added the ability to list interpreters associated with channel ends in the internal subinterpreters module.

  • bpo-37986: Improve performance of PyLong_FromDouble() for values that fit into long.

Library

  • bpo-40662: Fixed ast.get_source_segment() for ast nodes that have incomplete location information. Patch by Irit Katriel.

  • bpo-40665: Convert bisect to use Argument Clinic.

  • bpo-40536: Added the available_timezones() function to the zoneinfo module. Patch by Paul Ganssle.

  • bpo-40645: The hmac.HMAC exposes internal implementation details. The attributes digest_cons, inner, and outer are deprecated and will be removed in the future.

  • bpo-40645: The internal module _hashlib wraps and exposes OpenSSL’s HMAC API. The new code will be used in Python 3.10 after the internal implementation details of the pure Python HMAC module are no longer part of the public API.

  • bpo-40637: Builtin hash modules can now be disabled or selectively enabled with configure --with-builtin-hashlib-hashes=sha3,blake1 or --without-builtin-hashlib-hashes.

  • bpo-37630: The hashlib module can now use SHA3 hashes and SHAKE XOF from OpenSSL when available.

  • bpo-40479: The hashlib now compiles with OpenSSL 3.0.0-alpha2.

  • bpo-40257: Revert changes to inspect.getdoc().

  • bpo-40607: When cancelling a task due to timeout, asyncio.wait_for() will now propagate the exception if an error happens during cancellation. Patch by Roman Skurikhin.

  • bpo-40612: Fix edge cases in SyntaxError formatting. If the offset is <= 0, no caret is printed. If the offset is > line length, the caret is printed pointing just after the last character.

  • bpo-40597: If text content lines are longer than policy.max_line_length, always use a content-encoding to make sure they are wrapped.

  • bpo-40571: Added functools.cache() as a simpler, more discoverable way to access the unbounded cache variant of lru_cache(maxsize=None).

  • bpo-40503: PEP 615, the zoneinfo module. Adds support for the IANA time zone database.

  • bpo-40397: Removed attributes __args__ and __parameters__ from special generic aliases like typing.List (not subscripted).

  • bpo-40549: Convert posixmodule.c («posix» or «nt» module) to the multiphase initialization (PEP 489).

  • bpo-31033: Add a msg argument to Future.cancel() and Task.cancel().

  • bpo-40541: Added an optional counts parameter to random.sample().

  • bpo-40515: The ssl and hashlib modules now actively check that OpenSSL is build with thread support. Python 3.7.0 made thread support mandatory and no longer works safely with a no-thread builds.

  • bpo-31033: When a asyncio.Task is cancelled, the exception traceback now chains all the way back to where the task was first interrupted.

  • bpo-40504: functools.lru_cache() objects can now be the targets of weakrefs.

  • bpo-40559: Fix possible memory leak in the C implementation of asyncio.Task.

  • bpo-40480: fnmatch.fnmatch() could take exponential time in the presence of multiple * pattern characters. This was repaired by generating more elaborate regular expressions to avoid futile backtracking.

  • bpo-40495: compileall is now able to use hardlinks to prevent duplicates in a case when .pyc files for different optimization levels have the same content.

  • bpo-40457: The ssl module now support OpenSSL builds without TLS 1.0 and 1.1 methods.

  • bpo-40355: Improve error reporting in ast.literal_eval() in the presence of malformed ast.Dict nodes instead of silently ignoring any non-conforming elements. Patch by Curtis Bucher.

  • bpo-40465: Deprecated the optional random argument to random.shuffle().

  • bpo-40459: platform.win32_ver() now produces correct ptype strings instead of empty strings.

  • bpo-39435: The first argument of pickle.loads() is now positional-only.

  • bpo-39305: Update nntplib to merge nntplib.NNTP and nntplib._NNTPBase. Patch by Donghee Na.

  • bpo-32494: Update dbm.gnu to use gdbm_count if possible when calling len(). Patch by Donghee Na.

  • bpo-40453: Add isolated=True keyword-only parameter to _xxsubinterpreters.create(). An isolated subinterpreter cannot spawn threads, spawn a child process or call os.fork().

  • bpo-40286: Remove _random.Random.randbytes(): the C implementation of randbytes(). Implement the method in Python to ease subclassing: randbytes() now directly reuses getrandbits().

  • bpo-40394: Added default arguments to difflib.SequenceMatcher.find_longest_match().

  • bpo-39995: Fix a race condition in concurrent.futures._ThreadWakeup: access to _ThreadWakeup is now protected with the shutdown lock.

  • bpo-30966: Process.shutdown(wait=True) of concurrent.futures now closes explicitly the result queue.

  • bpo-30966: Add a new close() method to the SimpleQueue class to explicitly close the queue.

  • bpo-39966: Revert bpo-25597. unittest.mock.MagicMock with wraps” set uses default return values for magic methods.

  • bpo-39791: Added files() function to importlib.resources with support for subdirectories in package data, matching backport in importlib_resources 1.5.

  • bpo-40375: imaplib.IMAP4.unselect() is added. Patch by Donghee Na.

  • bpo-40389: repr() now returns typing.Optional[T] when called for typing.Union of two types, one of which is NoneType.

  • bpo-40291: Add support for CAN_J1939 sockets (available on Linux 5.4+)

  • bpo-40273: types.MappingProxyType is now reversible.

  • bpo-39075: The repr for types.SimpleNamespace is now insertion ordered rather than alphabetical.

  • bpo-40192: On AIX, thread_time() is now implemented with thread_cputime() which has nanosecond resolution, rather than clock_gettime(CLOCK_THREAD_CPUTIME_ID) which has a resolution of 10 milliseconds. Patch by Batuhan Taskaya.

  • bpo-40025: Raise TypeError when _generate_next_value_ is defined after members. Patch by Ethan Onstott.

  • bpo-39058: In the argparse module, the repr for Namespace() and other argument holders now displayed in the order attributes were added. Formerly, it displayed in alphabetical order even though argument order is preserved the user visible parts of the module.

  • bpo-24416: The isocalendar() methods of datetime.date and datetime.datetime now return a named tuple instead of a tuple.

Documentation

  • bpo-34790: Add version of removal for explicit passing of coros to asyncio.wait()”s documentation

  • bpo-40561: Provide docstrings for webbrowser open functions.

  • bpo-40499: Mention that asyncio.wait() requires a non-empty set of awaitables.

  • bpo-39705: Tutorial example for sorted() in the Loop Techniques section is given a better explanation. Also a new example is included to explain sorted()”s basic behavior.

  • bpo-39435: Fix an incorrect signature for pickle.loads() in the docs

Tests

  • bpo-40055: distutils.tests now saves/restores warnings filters to leave them unchanged. Importing tests imports docutils which imports pkg_resources which adds a warnings filter.

  • bpo-40436: test_gdb and test.pythoninfo now check gdb command exit code.

Build

  • bpo-40653: Move _dirnameW out of HAVE_SYMLINK to fix a potential compiling issue.

  • bpo-40514: Add --with-experimental-isolated-subinterpreters build option to configure: better isolate subinterpreters, experimental build mode.

Windows

  • bpo-40650: Include winsock2.h in pytime.c for timeval.

  • bpo-40458: Increase reserved stack space to prevent overflow crash on Windows.

  • bpo-39148: Add IPv6 support to asyncio datagram endpoints in ProactorEventLoop. Change the raised exception for unknown address families to ValueError as it’s not coming from Windows API.

macOS

  • bpo-34956: When building Python on macOS from source, _tkinter now links with non-system Tcl and Tk frameworks if they are installed in /Library/Frameworks, as had been the case on older releases of macOS. If a macOS SDK is explicitly configured, by using --enable-universalsdk= or -isysroot, only the SDK itself is searched. The default behavior can still be overridden with --with-tcltk-includes and --with-tcltk-libs.

  • bpo-35569: Expose RFC 3542 IPv6 socket options.

Tools/Demos

  • bpo-40479: Update multissltest helper to test with latest OpenSSL 1.0.2, 1.1.0, 1.1.1, and 3.0.0-alpha.

  • bpo-40431: Fix a syntax typo in turtledemo that now raises a SyntaxError.

  • bpo-40163: Fix multissltest tool. OpenSSL has changed download URL for old releases. The multissltest tool now tries to download from current and old download URLs.

C API

  • bpo-39465: Remove the _PyUnicode_ClearStaticStrings() function from the C API.

  • bpo-38787: Add PyCFunction_CheckExact() macro for exact type checks now that we allow subtypes of PyCFunction, as well as PyCMethod_CheckExact() and PyCMethod_Check() for the new PyCMethod subtype.

  • bpo-40545: Declare _PyErr_GetTopmostException() with PyAPI_FUNC() to properly export the function in the C API. The function remains private (_Py) prefix.

  • bpo-40412: Nullify inittab_copy during finalization, preventing future interpreter initializations in an embedded situation from crashing. Patch by Gregory Szorc.

  • bpo-40429: The PyThreadState_GetFrame() function now returns a strong reference to the frame.

  • bpo-40428: Remove the following functions from the C API. Call PyGC_Collect() explicitly to free all free lists.

    • PyAsyncGen_ClearFreeLists()

    • PyContext_ClearFreeList()

    • PyDict_ClearFreeList()

    • PyFloat_ClearFreeList()

    • PyFrame_ClearFreeList()

    • PyList_ClearFreeList()

    • PySet_ClearFreeList()

    • PyTuple_ClearFreeList()

  • bpo-40421: New PyFrame_GetBack() function: get the frame next outer frame.

  • bpo-40421: New PyFrame_GetCode() function: return a borrowed reference to the frame code.

  • bpo-40217: Ensure that instances of types created with PyType_FromSpecWithBases() will visit its class object when traversing references in the garbage collector (implemented as an extension of the provided tp_traverse). Patch by Pablo Galindo.

  • bpo-38787: Module C state is now accessible from C-defined heap type methods (PEP 573). Patch by Marcel Plch and Petr Viktorin.

Python 3.9.0 alpha 6

Release date: 2020-04-27

Security

  • bpo-40121: Fixes audit events raised on creating a new socket.

  • bpo-39073: Disallow CR or LF in email.headerregistry.Address arguments to guard against header injection attacks.

  • bpo-39503: CVE 2020-8492: The AbstractBasicAuthHandler class of the urllib.request module uses an inefficient regular expression which can be exploited by an attacker to cause a denial of service. Fix the regex to prevent the catastrophic backtracking. Vulnerability reported by Ben Caller and Matt Schwager.

Core and Builtins

  • bpo-40313: Improve the performance of bytes.hex().

  • bpo-40334: Switch to a new parser, based on PEG. For more details see PEP 617. To temporarily switch back to the old parser, use -X oldparser or PYTHONOLDPARSER=1. In Python 3.10 we will remove the old parser completely, including the parser module (already deprecated) and anything that depends on it.

  • bpo-40267: Fix the tokenizer to display the correct error message, when there is a SyntaxError on the last input character and no newline follows. It used to be unexpected EOF while parsing, while it should be invalid syntax.

  • bpo-39522: Correctly unparse explicit u prefix for strings when postponed evaluation for annotations activated. Patch by Batuhan Taskaya.

  • bpo-40246: Report a specialized error message, invalid string prefix, when the tokenizer encounters a string with an invalid prefix.

  • bpo-40082: Fix the signal handler: it now always uses the main interpreter, rather than trying to get the current Python thread state.

  • bpo-37388: str.encode() and str.decode() no longer check the encoding and errors in development mode or in debug mode during Python finalization. The codecs machinery can no longer work on very late calls to str.encode() and str.decode().

  • bpo-40077: Fix possible refleaks in _json, memo of PyScannerObject should be traversed.

  • bpo-37207: Speed up calls to dict() by using the PEP 590 vectorcall calling convention.

  • bpo-40141: Add column and line information to ast.keyword nodes. Patch by Pablo Galindo.

  • bpo-1635741: Port resource to multiphase initialization (PEP 489).

  • bpo-1635741: Port math to multiphase initialization (PEP 489).

  • bpo-1635741: Port _uuid module to multiphase initialization (PEP 489).

  • bpo-40077: Convert json module to use PyType_FromSpec().

  • bpo-40067: Improve the error message for multiple star expressions in an assignment. Patch by Furkan Onder

  • bpo-1635741: Port _functools module to multiphase initialization (PEP 489). Patch by Paulo Henrique Silva.

  • bpo-1635741: Port operator module to multiphase initialization (PEP 489). Patch by Paulo Henrique Silva.

  • bpo-20526: Fix PyThreadState_Clear(). PyThreadState.frame is a borrowed reference, not a strong reference: PyThreadState_Clear() must not call Py_CLEAR(tstate->frame).

  • bpo-1635741: Port time module to multiphase initialization (PEP 489). Patch by Paulo Henrique Silva.

  • bpo-1635741: Port _weakref extension module to multiphase initialization (PEP 489).

  • bpo-40020: Fix a leak and subsequent crash in parsetok.c caused by realloc misuse on a rare codepath.

  • bpo-39939: Added str.removeprefix and str.removesuffix methods and corresponding bytes, bytearray, and collections.UserString methods to remove affixes from a string if present. See PEP 616 for a full description. Patch by Dennis Sweeney.

  • bpo-39481: Implement PEP 585. This supports list[int], tuple[str, …] etc.

  • bpo-32894: Support unparsing of infinity numbers in postponed annotations. Patch by Batuhan Taşkaya.

  • bpo-37207: Speed up calls to list() by using the PEP 590 vectorcall calling convention. Patch by Mark Shannon.

Library

  • bpo-40398: typing.get_args() now always returns an empty tuple for special generic aliases.

  • bpo-40396: Functions typing.get_origin(), typing.get_args() and typing.get_type_hints() support now generic aliases like list[int].

  • bpo-38061: Optimize the subprocess module on FreeBSD using closefrom(). A single close(fd) syscall is cheap, but when sysconf(_SC_OPEN_MAX) is high, the loop calling close(fd) on each file descriptor can take several milliseconds.

    The workaround on FreeBSD to improve performance was to load and mount the fdescfs kernel module, but this is not enabled by default.

    Initial patch by Ed Maste (emaste), Conrad Meyer (cem), Kyle Evans (kevans) and Kubilay Kocak (koobs): https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=242274

  • bpo-38061: On FreeBSD, os.closerange(fd_low, fd_high) now calls closefrom(fd_low) if fd_high is greater than or equal to sysconf(_SC_OPEN_MAX).

    Initial patch by Ed Maste (emaste), Conrad Meyer (cem), Kyle Evans (kevans) and Kubilay Kocak (koobs): https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=242274

  • bpo-40360: The lib2to3 module is pending deprecation due to PEP 617.

  • bpo-40138: Fix the Windows implementation of os.waitpid() for exit code larger than INT_MAX >> 8. The exit status is now interpreted as an unsigned number.

  • bpo-39942: Set «__main__» as the default module name when «__name__» is missing in typing.TypeVar. Patch by Weipeng Hong.

  • bpo-40275: The logging package is now imported lazily in unittest only when the assertLogs() assertion is used.

  • bpo-40275: The asyncio package is now imported lazily in unittest only when the IsolatedAsyncioTestCase class is used.

  • bpo-40330: In ShareableList.__setitem__(), check the size of a new string item after encoding it to utf-8, not before.

  • bpo-40148: Added pathlib.Path.with_stem() to create a new Path with the stem replaced.

  • bpo-40325: Deprecated support for set objects in random.sample().

  • bpo-40257: Improved help for the typing module. Docstrings are now shown for all special forms and special generic aliases (like Union and List). Using help() with generic alias like List[int] will show the help for the correspondent concrete type (list in this case).

  • bpo-40257: inspect.getdoc() no longer returns docstring inherited from the type of the object or from parent class if it is a class if it is not defined in the object itself. In pydoc the documentation string is now shown not only for class, function, method etc, but for any object that has its own __doc__ attribute.

  • bpo-40287: Fixed SpooledTemporaryFile.seek() to return the position.

  • bpo-40290: Added zscore() to statistics.NormalDist().

  • bpo-40282: Allow random.getrandbits(0) to succeed and to return 0.

  • bpo-40286: Add random.randbytes() function and random.Random.randbytes() method to generate random bytes.

  • bpo-40277: collections.namedtuple() now provides a human-readable repr for its field accessors.

  • bpo-40270: The included copy of sqlite3 on Windows is now compiled with the json extension. This allows the use of functions such as json_object.

  • bpo-29255: Wait in KqueueSelector.select when no fds are registered

  • bpo-40260: Ensure modulefinder uses io.open_code() and respects coding comments.

  • bpo-40234: Allow again to spawn daemon threads in subinterpreters (revert change which denied them).

  • bpo-39207: Workers in ProcessPoolExecutor are now spawned on demand, only when there are no available idle workers to reuse. This optimizes startup overhead and reduces the amount of lost CPU time to idle workers. Patch by Kyle Stanley.

  • bpo-40091: Fix a hang at fork in the logging module: the new private _at_fork_reinit() method is now used to reinitialize locks at fork in the child process.

  • bpo-40149: Implement traverse and clear slots in _abc._abc_data type.

  • bpo-40208: Remove deprecated symtable.SymbolTable.has_exec().

  • bpo-40196: Fix a bug in the symtable module that was causing incorrectly report global variables as local. Patch by Pablo Galindo.

  • bpo-40190: Add support for _SC_AIX_REALMEM to posix.sysconf().

  • bpo-40182: Removed the _field_types attribute of the typing.NamedTuple class.

  • bpo-36517: Multiple inheritance with typing.NamedTuple now raises an error instead of silently ignoring other types.

  • bpo-40126: Fixed reverting multiple patches in unittest.mock. Patcher’s __exit__() is now never called if its __enter__() is failed. Returning true from __exit__() silences now the exception.

  • bpo-40094: CGIHTTPRequestHandler of http.server now logs the CGI script exit code, rather than the CGI script exit status of os.waitpid(). For example, if the script is killed by signal 11, it now logs: «CGI script exit code -11.»

  • bpo-40108: Improve the error message when triying to import a module using runpy and incorrectly using the «.py» extension at the end of the module name. Patch by Pablo Galindo.

  • bpo-40094: Add os.waitstatus_to_exitcode() function: convert a wait status to an exit code.

  • bpo-40089: Fix threading._after_fork(): if fork was not called by a thread spawned by threading.Thread, threading._after_fork() now creates a _MainThread instance for _main_thread, instead of a _DummyThread instance.

  • bpo-40089: Add a private _at_fork_reinit() method to _thread.Lock, _thread.RLock, threading.RLock and threading.Condition classes: reinitialize the lock at fork in the child process, reset the lock to the unlocked state. Rename also the private _reset_internal_locks() method of threading.Event to _at_fork_reinit().

  • bpo-25780: Expose CAN_RAW_JOIN_FILTERS in the socket module.

  • bpo-39503: AbstractBasicAuthHandler of urllib.request now parses all WWW-Authenticate HTTP headers and accepts multiple challenges per header: use the realm of the first Basic challenge.

  • bpo-39812: Removed daemon threads from concurrent.futures by adding an internal threading._register_atexit(), which calls registered functions prior to joining all non-daemon threads. This allows for compatibility with subinterpreters, which don’t support daemon threads.

  • bpo-40050: Fix importlib._bootstrap_external: avoid creating a new winreg builtin module if it’s already available in sys.modules, and remove redundant imports.

  • bpo-40014: Fix os.getgrouplist(): if getgrouplist() function fails because the group list is too small, retry with a larger group list. On failure, the glibc implementation of getgrouplist() sets ngroups to the total number of groups. For other implementations, double the group list size.

  • bpo-40017: Add time.CLOCK_TAI constant if the operating system support it.

  • bpo-40016: In re docstring, clarify the relationship between inline and argument compile flags.

  • bpo-39953: Update internal table of OpenSSL error codes in the ssl module.

  • bpo-36144: Added PEP 584 operators to weakref.WeakValueDictionary.

  • bpo-36144: Added PEP 584 operators to weakref.WeakKeyDictionary.

  • bpo-38891: Fix linear runtime behaviour of the __getitem__ and __setitem__ methods in multiprocessing.shared_memory.ShareableList. This avoids quadratic performance when iterating a ShareableList. Patch by Thomas Krennwallner.

  • bpo-39682: Remove undocumented support for closing a pathlib.Path object via its context manager. The context manager magic methods remain, but they are now a no-op, making Path objects immutable.

  • bpo-36144: Added PEP 584 operators (| and |=) to collections.ChainMap.

  • bpo-39011: Normalization of line endings in ElementTree attributes was removed, as line endings which were replaced by entity numbers should be preserved in original form.

  • bpo-38410: Properly handle sys.audit() failures in sys.set_asyncgen_hooks().

  • bpo-36541: lib2to3 now recognizes named assignment expressions (the walrus operator, :=)

  • bpo-35967: In platform, delay the invocation of “uname -p” until the processor attribute is requested.

  • bpo-35113: inspect.getsource() now returns correct source code for inner class with same name as module level class. Decorators are also returned as part of source of the class. Patch by Karthikeyan Singaravelan.

  • bpo-33262: Deprecate passing None as an argument for shlex.split()”s s parameter. Patch by Zackery Spytz.

  • bpo-31758: Prevent crashes when using an uninitialized _elementtree.XMLParser object. Patch by Oren Milman.

Documentation

  • bpo-27635: The pickle documentation incorrectly claimed that __new__ isn’t called by default when unpickling.

  • bpo-39879: Updated Modelo de datos docs to include dict() insertion order preservation. Patch by Furkan Onder and Samy Lahfa.

  • bpo-38387: Document PyDoc_STRVAR macro in the C-API reference.

  • bpo-13743: Some methods within xml.dom.minidom.Element class are now better documented.

Tests

  • bpo-31904: Set expected default encoding in test_c_locale_coercion.py for VxWorks RTOS.

  • bpo-40162: Update Travis CI configuration to OpenSSL 1.1.1f.

  • bpo-40146: Update OpenSSL to 1.1.1f in Azure Pipelines.

  • bpo-40094: Add test.support.wait_process() function.

  • bpo-40003: test.bisect_cmd now copies Python command line options like -O or -W. Moreover, emit a warning if test.bisect_cmd is used with -w/--verbose2 option.

  • bpo-39380: Add the encoding in ftplib.FTP and ftplib.FTP_TLS to the constructor as keyword-only and change the default from latin-1 to utf-8 to follow RFC 2640.

  • bpo-39793: Use the same domain when testing make_msgid. Patch by Batuhan Taskaya.

  • bpo-1812: Fix newline handling in doctest.testfile when loading from a package whose loader has a get_data method. Patch by Peter Donis.

Build

  • bpo-38360: Support single-argument form of macOS -isysroot flag.

  • bpo-40158: Fix CPython MSBuild Properties in NuGet Package (build/native/python.props)

  • bpo-38527: Fix configure check on Solaris for «float word ordering»: sometimes, the correct «grep» command was not being used. Patch by Arnon Yaari.

Windows

  • bpo-40164: Updates Windows to OpenSSL 1.1.1f

  • bpo-8901: Ignore the Windows registry when the -E option is used.

macOS

  • bpo-38329: python.org macOS installers now update the Current version symlink of /Library/Frameworks/Python.framework/Versions for 3.9 installs. Previously, Current was only updated for Python 2.x installs. This should make it easier to embed Python 3 into other macOS applications.

  • bpo-40164: Update macOS installer builds to use OpenSSL 1.1.1g.

IDLE

  • bpo-38439: Add a 256×256 pixel IDLE icon to support more modern environments. Created by Andrew Clover. Delete the unused macOS idle.icns icon file.

  • bpo-38689: IDLE will no longer freeze when inspect.signature fails when fetching a calltip.

Tools/Demos

C API

Python 3.9.0 alpha 5

Release date: 2020-03-23

Security

  • bpo-38576: Disallow control characters in hostnames in http.client, addressing CVE 2019-18348. Such potentially malicious header injection URLs now cause a InvalidURL to be raised.

Core and Builtins

  • bpo-40010: Optimize pending calls in multithreaded applications. If a thread different than the main thread schedules a pending call (Py_AddPendingCall()), the bytecode evaluation loop is no longer interrupted at each bytecode instruction to check for pending calls which cannot be executed. Only the main thread can execute pending calls.

    Previously, the bytecode evaluation loop was interrupted at each instruction until the main thread executes pending calls.

  • bpo-1635741: Port _weakref extension module to multiphase initialization (PEP 489).

  • bpo-1635741: Port _collections module to multiphase initialization (PEP 489).

  • bpo-40010: Optimize signal handling in multithreaded applications. If a thread different than the main thread gets a signal, the bytecode evaluation loop is no longer interrupted at each bytecode instruction to check for pending signals which cannot be handled. Only the main thread of the main interpreter can handle signals.

    Previously, the bytecode evaluation loop was interrupted at each instruction until the main thread handles signals.

  • bpo-39984: If Py_AddPendingCall() is called in a subinterpreter, the function is now scheduled to be called from the subinterpreter, rather than being called from the main interpreter. Each subinterpreter now has its own list of scheduled calls.

  • bpo-1635741: Port _heapq module to multiphase initialization.

  • bpo-1635741: Port itertools module to multiphase initialization (PEP 489).

  • bpo-37207: Speed up calls to frozenset() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-39984: subinterpreters: Move _PyRuntimeState.ceval.tracing_possible to PyInterpreterState.ceval.tracing_possible: each interpreter now has its own variable.

  • bpo-37207: Speed up calls to set() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-1635741: Port _statistics module to multiphase initialization (PEP 489).

  • bpo-39968: Use inline function to replace extension modules” get_module_state macros.

  • bpo-39965: Correctly raise SyntaxError if await is used inside non-async functions and PyCF_ALLOW_TOP_LEVEL_AWAIT is set (like in the asyncio REPL). Patch by Pablo Galindo.

  • bpo-39562: Allow executing asynchronous comprehensions on the top level when the PyCF_ALLOW_TOP_LEVEL_AWAIT flag is given. Patch by Batuhan Taskaya.

  • bpo-37207: Speed up calls to tuple() by using the PEP 590 vectorcall calling convention. Patch by Donghee Na.

  • bpo-38373: Changed list overallocation strategy. It no longer overallocates if the new size is closer to overallocated size than to the old size and adds padding.

  • bpo-39926: Update Unicode database to Unicode version 13.0.0.

  • bpo-19466: Clear the frames of daemon threads earlier during the Python shutdown to call objects destructors. So «unclosed file» resource warnings are now emitted for daemon threads in a more reliable way.

  • bpo-38894: Fix a bug that was causing incomplete results when calling pathlib.Path.glob in the presence of symlinks that point to files where the user does not have read access. Patch by Pablo Galindo and Matt Wozniski.

  • bpo-39877: Fix PyEval_RestoreThread() random crash at exit with daemon threads. It now accesses the _PyRuntime variable directly instead of using tstate->interp->runtime, since tstate can be a dangling pointer after Py_Finalize() has been called. Moreover, the daemon thread now exits before trying to take the GIL.

  • bpo-39871: Fix a possible SystemError in math.{atan2,copysign,remainder}() when the first argument cannot be converted to a float. Patch by Zackery Spytz.

  • bpo-39776: Fix race condition where threads created by PyGILState_Ensure() could get a duplicate id.

    This affects consumers of tstate->id like the contextvar caching machinery, which could return invalid cached objects under heavy thread load (observed in embedded scenarios).

  • bpo-39778: Fixed a crash due to incorrect handling of weak references in collections.OrderedDict classes. Patch by Pablo Galindo.

  • bpo-1635741: Port audioop extension module to multiphase initialization (PEP 489).

  • bpo-39702: Relax decorator grammar restrictions to allow any valid expression (PEP 614).

  • bpo-38091: Tweak import deadlock detection code to not deadlock itself.

  • bpo-1635741: Port _locale extension module to multiphase initialization (PEP 489).

  • bpo-39087: Optimize PyUnicode_AsUTF8() and PyUnicode_AsUTF8AndSize() slightly when they need to create internal UTF-8 cache.

  • bpo-39520: Fix unparsing of ext slices with no items (foo[:,]). Patch by Batuhan Taskaya.

  • bpo-39220: Do not optimize annotations if “from __future__ import annotations” is used. Patch by Pablo Galindo.

  • bpo-35712: Using NotImplemented in a boolean context has been deprecated. Patch contributed by Josh Rosenberg.

  • bpo-22490: Don’t leak environment variable __PYVENV_LAUNCHER__ into the interpreter session on macOS.

Library

  • bpo-39830: Add zipfile.Path to __all__ in the zipfile module.

  • bpo-40000: Improved error messages for validation of ast.Constant nodes. Patch by Batuhan Taskaya.

  • bpo-39999: __module__ of the AST node classes is now set to «ast» instead of «_ast». Added docstrings for dummy AST node classes and deprecated attributes.

  • bpo-39991: uuid.getnode() now skips IPv6 addresses with the same string length than a MAC address (17 characters): only use MAC addresses.

  • bpo-39988: Deprecated ast.AugLoad and ast.AugStore node classes because they are no longer used.

  • bpo-39656: Ensure bin/python3.# is always present in virtual environments on POSIX platforms - by Anthony Sottile.

  • bpo-39969: Deprecated ast.Param node class because it’s no longer used. Patch by Batuhan Taskaya.

  • bpo-39360: Ensure all workers exit when finalizing a multiprocessing.Pool implicitly via the module finalization handlers of multiprocessing. This fixes a deadlock situation that can be experienced when the Pool is not properly finalized via the context manager or a call to multiprocessing.Pool.terminate. Patch by Batuhan Taskaya and Pablo Galindo.

  • bpo-35370: sys.settrace(), sys.setprofile() and _lsprof.Profiler.enable() now properly report PySys_Audit() error if «sys.setprofile» or «sys.settrace» audit event is denied.

  • bpo-39936: AIX: Fix _aix_support module when the subprocess is not available, when building Python from scratch. It now uses new private _bootsubprocess module, rather than having two implementations depending if subprocess is available or not. So _aix_support.aix_platform() result is now the same if subprocess is available or not.

  • bpo-36144: collections.OrderedDict now implements | and |= (PEP 584).

  • bpo-39652: The column name found in sqlite3.Cursor.description is now truncated on the first “[” only if the PARSE_COLNAMES option is set.

  • bpo-39915: Ensure unittest.mock.AsyncMock.await_args_list has call objects in the order of awaited arguments instead of using unittest.mock.Mock.call_args which has the last value of the call. Patch by Karthikeyan Singaravelan.

  • bpo-36144: Updated os.environ and os.environb to support PEP 584’s merge (|) and update (|=) operators.

  • bpo-38662: The ensurepip module now invokes pip via the runpy module. Hence it is no longer tightly coupled with the internal API of the bundled pip version, allowing easier updates to a newer pip version both internally and for distributors.

  • bpo-38075: Fix the random.Random.seed() method when a bool is passed as the seed.

  • bpo-39916: More reliable use of os.scandir() in Path.glob(). It no longer emits a ResourceWarning when interrupted.

  • bpo-39850: multiprocessing now supports abstract socket addresses (if abstract sockets are supported in the running platform). When creating arbitrary addresses (like when default-constructing multiprocessing.connection.Listener objects) abstract sockets are preferred to avoid the case when the temporary-file-generated address is too large for an AF_UNIX socket address. Patch by Pablo Galindo.

  • bpo-36287: ast.dump() no longer outputs optional fields and attributes with default values. The default values for optional fields and attributes of AST nodes are now set as class attributes (e.g. Constant.kind is set to None).

  • bpo-39889: Fixed ast.unparse() for extended slices containing a single element (e.g. a[i:j,]). Remove redundant tuples when index with a tuple (e.g. a[i, j]).

  • bpo-39828: Fix json.tool to catch BrokenPipeError. Patch by Donghee Na.

  • bpo-13487: Avoid a possible «RuntimeError: dictionary changed size during iteration» from inspect.getmodule() when it tried to loop through sys.modules.

  • bpo-39674: Revert «bpo-37330: open() no longer accept “U” in file mode». The «U» mode of open() is kept in Python 3.9 to ease transition from Python 2.7, but will be removed in Python 3.10.

  • bpo-28577: The hosts method on 32-bit prefix length IPv4Networks and 128-bit prefix IPv6Networks now returns a list containing the single Address instead of an empty list.

  • bpo-39826: Add getConnection method to logging HTTPHandler to enable custom connections.

  • bpo-39763: Reimplement distutils.spawn.spawn function with the subprocess module.

  • bpo-39794: Add –without-decimal-contextvar build option. This enables a thread-local rather than a coroutine local context.

  • bpo-36144: collections.defaultdict now implements | (PEP 584).

  • bpo-39517: Fix runpy.run_path() when using pathlike objects

  • bpo-39775: Change inspect.Signature.parameters back to collections.OrderedDict. This was changed to dict in Python 3.9.0a4.

  • bpo-39678: Refactor queue_manager in concurrent.futures.ProcessPoolExecutor to make it easier to maintain.

  • bpo-39764: Fix AttributeError when calling get_stack on a PyAsyncGenObject Task

  • bpo-39769: The compileall.compile_dir() function’s ddir parameter and the compileall command line flag -d no longer write the wrong pathname to the generated pyc file for submodules beneath the root of the directory tree being compiled. This fixes a regression introduced with Python 3.5.

  • bpo-36144: types.MappingProxyType objects now support the merge (|) operator from PEP 584.

  • bpo-38691: The importlib module now ignores the PYTHONCASEOK environment variable when the -E or -I command line options are being used.

  • bpo-39719: Remove tempfile.SpooledTemporaryFile.softspace() as files no longer have the softspace attribute in Python 3. Patch by Shantanu.

  • bpo-39667: Improve pathlib.Path compatibility on zipfile.Path and correct performance degradation as found in zipp 3.0.

  • bpo-39638: Keep ASDL signatures in the docstrings for AST nodes. Patch by Batuhan Taskaya

  • bpo-39639: Deprecated ast.Suite node class because it’s no longer used. Patch by Batuhan Taskaya.

  • bpo-39609: Add thread_name_prefix to default asyncio executor

  • bpo-39548: Fix handling of header in urllib.request.AbstractDigestAuthHandler when the optional qop parameter is not present.

  • bpo-39509: HTTP status codes 103 EARLY_HINTS and 425 TOO_EARLY are added to http.HTTPStatus. Patch by Donghee Na.

  • bpo-39507: Adding HTTP status 418 «I’m a Teapot» to HTTPStatus in http library. Patch by Ross Rhodes.

  • bpo-39495: Remove default value from attrs parameter of xml.etree.ElementTree.TreeBuilder.start() for consistency between Python and C implementations.

  • bpo-38971: Open issue in the BPO indicated a desire to make the implementation of codecs.open() at parity with io.open(), which implements a try/except to assure file stream gets closed before an exception is raised.

  • bpo-38641: Added starred expressions support to return and yield statements for lib2to3. Patch by Vlad Emelianov.

  • bpo-37534: When using minidom module to generate XML documents the ability to add Standalone Document Declaration is added. All the changes are made to generate a document in compliance with Extensible Markup Language (XML) 1.0 (Fifth Edition) W3C Recommendation (available here: https://www.w3.org/TR/xml/#sec-prolog-dtd).

  • bpo-34788: Add support for scoped IPv6 addresses to ipaddress. Patch by Oleksandr Pavliuk.

  • bpo-34822: Simplified AST for subscription. Simple indices are now represented by their value, extended slices are represented as tuples. ast classes Index and ExtSlice are considered deprecated and will be removed in future Python versions. In the meantime, Index(value) now returns a value itself, ExtSlice(slices) returns Tuple(slices, Load()).

Documentation

  • bpo-39868: Updated the Language Reference for PEP 572.

  • bpo-13790: Change “string” to “specification” in format doc.

  • bpo-17422: The language reference no longer restricts default class namespaces to dicts only.

  • bpo-39530: Fix misleading documentation about mixed-type numeric comparisons.

  • bpo-39718: Update token documentation to reflect additions in Python 3.8

  • bpo-39677: Changed operand name of MAKE_FUNCTION from argc to flags for module dis

Tests

  • bpo-40019: test_gdb now skips tests if it detects that gdb failed to read debug information because the Python binary is optimized.

  • bpo-27807: test_site.test_startup_imports() is now skipped if a path of sys.path contains a .pth file.

  • bpo-26067: Do not fail test_shutil test_chown test when uid or gid of user cannot be resolved to a name.

  • bpo-39855: test_subprocess.test_user() now skips the test on an user name if the user name doesn’t exist. For example, skip the test if the user «nobody» doesn’t exist on Linux.

Build

  • bpo-39761: Fix build with DTrace but without additional DFLAGS.

  • bpo-39763: setup.py now uses a basic implementation of the subprocess module if the subprocess module is not available: before required C extension modules are built.

  • bpo-1294959: Add --with-platlibdir option to the configure script: name of the platform-specific library directory, stored in the new sys.platlibdir attribute. It is used to build the path of platform-specific extension modules and the path of the standard library. It is equal to "lib" on most platforms. On Fedora and SuSE, it is equal to "lib64" on 64-bit platforms. Patch by Jan Matějek, Matěj Cepl, Charalampos Stratakis and Victor Stinner.

Windows

  • bpo-39930: Ensures the required vcruntime140.dll is included in install packages.

  • bpo-39847: Avoid hang when computer is hibernated whilst waiting for a mutex (for lock-related objects from threading) around 49-day uptime.

  • bpo-38597: distutils will no longer statically link vcruntime140.dll when a redistributable version is unavailable. All future releases of CPython will include a copy of this DLL to ensure distributed extensions can continue to load.

  • bpo-38380: Update Windows builds to use SQLite 3.31.1

  • bpo-39789: Update Windows release build machines to Visual Studio 2019 (MSVC 14.2).

  • bpo-34803: Package for nuget.org now includes repository reference and bundled icon image.

macOS

  • bpo-38380: Update macOS builds to use SQLite 3.31.1

IDLE

  • bpo-27115: For “Go to Line”, use a Query box subclass with IDLE standard behavior and improved error checking.

  • bpo-39885: Since clicking to get an IDLE context menu moves the cursor, any text selection should be and now is cleared.

  • bpo-39852: Edit «Go to line» now clears any selection, preventing accidental deletion. It also updates Ln and Col on the status bar.

  • bpo-39781: Selecting code context lines no longer causes a jump.

Tools/Demos

  • bpo-36184: Port python-gdb.py to FreeBSD. python-gdb.py now checks for «take_gil» function name to check if a frame tries to acquire the GIL, instead of checking for «pthread_cond_timedwait» which is specific to Linux and can be a different condition than the GIL.

  • bpo-38080: Added support to fix getproxies in the lib2to3.fixes.fix_urllib module. Patch by José Roberto Meza Cabrera.

C API

Python 3.9.0 alpha 4

Release date: 2020-02-25

Security

  • bpo-39184: Add audit events to functions in fcntl, msvcrt, os, resource, shutil, signal and syslog.

  • bpo-39401: Avoid unsafe DLL load at startup on Windows 7 and earlier.

  • bpo-39184: Add audit events to command execution functions in os and pty modules.

Core and Builtins

  • bpo-39382: Fix a use-after-free in the single inheritance path of issubclass(), when the __bases__ of an object has a single reference, and so does its first item. Patch by Yonatan Goldschmidt.

  • bpo-39573: Update clinic tool to use Py_IS_TYPE(). Patch by Donghee Na.

  • bpo-39619: Enable use of os.chroot() on HP-UX systems.

  • bpo-39573: Add Py_IS_TYPE() static inline function to check whether the object o type is type.

  • bpo-39606: Fix regression caused by fix for bpo-39386, that prevented calling aclose on an async generator that had already been closed or exhausted.

  • bpo-39579: Change the ending column offset of Attribute nodes constructed in ast_for_dotted_name to point at the end of the current node and not at the end of the last NAME node.

  • bpo-1635741: Port _crypt extension module to multiphase initialization (PEP 489).

  • bpo-1635741: Port _contextvars extension module to multiphase initialization (PEP 489).

  • bpo-39510: Fix segfault in readinto() method on closed BufferedReader.

  • bpo-39502: Fix time.localtime() on 64-bit AIX to support years before 1902 and after 2038. Patch by M Felt.

  • bpo-39492: Fix a reference cycle in the C Pickler that was preventing the garbage collection of deleted, pickled objects.

  • bpo-39453: Fixed a possible crash in list.__contains__() when a list is changed during comparing items. Patch by Donghee Na.

  • bpo-39434: floor division of float operation now has a better performance. Also the message of ZeroDivisionError for this operation is updated. Patch by Donghee Na.

  • bpo-1635741: Port _codecs extension module to multiphase initialization (PEP 489).

  • bpo-1635741: Port _bz2 extension module to multiphase initialization (PEP 489).

  • bpo-1635741: Port _abc extension module to multiphase initialization (PEP 489).

  • bpo-39320: Replace two complex bytecodes for building dicts with two simpler ones. The new bytecodes DICT_MERGE and DICT_UPDATE have been added The old bytecodes BUILD_MAP_UNPACK and BUILD_MAP_UNPACK_WITH_CALL have been removed.

  • bpo-39219: Syntax errors raised in the tokenizer now always set correct «text» and «offset» attributes.

  • bpo-36051: Drop the GIL during large bytes.join operations. Patch by Bruce Merry.

  • bpo-38960: Fix DTrace build issues on FreeBSD. Patch by David Carlier.

  • bpo-37207: Speed up calls to range() by about 30%, by using the PEP 590 vectorcall calling convention. Patch by Mark Shannon.

  • bpo-36144: dict (and collections.UserDict) objects now support PEP 584’s merge (|) and update (|=) operators. Patch by Brandt Bucher.

  • bpo-32856: Optimized the idiom for assignment a temporary variable in comprehensions. Now for y in [expr] in comprehensions is as fast as a simple assignment y = expr.

Library

  • bpo-30566: Fix IndexError when trying to decode an invalid string with punycode codec.

  • bpo-39649: Remove obsolete check for __args__ in bdb.Bdb.format_stack_entry.

  • bpo-39648: Expanded math.gcd() and math.lcm() to handle multiple arguments.

  • bpo-39681: Fix a regression where the C pickle module wouldn’t allow unpickling from a file-like object that doesn’t expose a readinto() method.

  • bpo-35950: Raise io.UnsupportedOperation in io.BufferedReader.truncate() when it is called on a read-only io.BufferedReader instance.

  • bpo-39479: Add math.lcm() function: least common multiple.

  • bpo-39674: Revert «Do not expose abstract collection classes in the collections module» change (bpo-25988). Aliases to ABC like collections.Mapping are kept in Python 3.9 to ease transition from Python 2.7, but will be removed in Python 3.10.

  • bpo-39104: Fix hanging ProcessPoolExcutor on shutdown(wait=False) when a task has failed pickling.

  • bpo-39627: Fixed TypedDict totality check for inherited keys.

  • bpo-39474: Fixed starting position of AST for expressions like (a)(b), (a)[b] and (a).b.

  • bpo-21016: The pydoc and trace modules now use the sysconfig module to get the path to the Python standard library, to support uncommon installation path like /usr/lib64/python3.9/ on Fedora. Patch by Jan Matějek.

  • bpo-39590: Collections.deque now holds strong references during deque.__contains__ and deque.count, fixing crashes.

  • bpo-39586: The distutils bdist_msi command is deprecated in Python 3.9, use bdist_wheel (wheel packages) instead.

  • bpo-39595: Improved performance of zipfile.Path for files with a large number of entries. Also improved performance and fixed minor issue as published with importlib_metadata 1.5.

  • bpo-39350: Fix regression in fractions.Fraction if the numerator and/or the denominator is an int subclass. The math.gcd() function is now used to normalize the numerator and denominator. math.gcd() always return a int type. Previously, the GCD type depended on numerator and denominator.

  • bpo-39567: Added audit for os.walk(), os.fwalk(), pathlib.Path.glob() and pathlib.Path.rglob().

  • bpo-39559: Remove unused, undocumented argument getters from uuid.getnode()

  • bpo-38149: sys.audit() is now called only once per call of glob.glob() and glob.iglob().

  • bpo-39546: Fix a regression in ArgumentParser where allow_abbrev=False was ignored for long options that used a prefix character other than «-«.

  • bpo-39450: Striped whitespace from docstring before returning it from unittest.case.shortDescription().

  • bpo-12915: A new function resolve_name has been added to the pkgutil module. This resolves a string of the form 'a.b.c.d' or 'a.b:c.d' to an object. In the example, a.b is a package/module and c.d is an object within that package/module reached via recursive attribute access.

  • bpo-39353: The binascii.crc_hqx() function is no longer deprecated.

  • bpo-39493: Mark typing.IO.closed as a property

  • bpo-39491: Add typing.Annotated and include_extras parameter to typing.get_type_hints() as part of PEP 593. Patch by Till Varoquaux, documentation by Till Varoquaux and Konstantin Kashin.

  • bpo-39485: Fix a bug in unittest.mock.create_autospec() that would complain about the wrong number of arguments for custom descriptors defined in an extension module returning functions.

  • bpo-38932: Mock fully resets child objects on reset_mock(). Patch by Vegard Stikbakke

  • bpo-39082: Allow AsyncMock to correctly patch static/class methods

  • bpo-39432: Implement PEP-489 algorithm for non-ascii «PyInit_…» symbol names in distutils to make it export the correct init symbol also on Windows.

  • bpo-18819: Omit devmajor and devminor fields for non-device files in tarfile archives, enabling bit-for-bit compatibility with GNU tar(1).

  • bpo-39349: Added a new cancel_futures parameter to concurrent.futures.Executor.shutdown() that cancels all pending futures which have not started running, instead of waiting for them to complete before shutting down the executor.

  • bpo-39274: bool(fraction.Fraction) now returns a boolean even if (numerator != 0) does not return a boolean (ex: numpy number).

  • bpo-34793: Remove support for with (await asyncio.lock): and with (yield from asyncio.lock):. The same is correct for asyncio.Condition and asyncio.Semaphore.

  • bpo-25597: Ensure, if wraps is supplied to unittest.mock.MagicMock, it is used to calculate return values for the magic methods instead of using the default return values. Patch by Karthikeyan Singaravelan.

  • bpo-36350: inspect.Signature.parameters and inspect.BoundArguments.arguments are now dicts instead of OrderedDicts. Patch contributed by Rémi Lapeyre.

  • bpo-35727: Fix sys.exit() and sys.exit(None) exit code propagation when used in multiprocessing.Process.

  • bpo-32173: * Add lazycache function to __all__. * Use dict.clear to clear the cache. * Refactoring getline function and checkcache function.

Documentation

  • bpo-17422: The language reference now specifies restrictions on class namespaces. Adapted from a patch by Ethan Furman.

  • bpo-39572: Updated documentation of total flag of TypedDict.

  • bpo-39654: In pyclbr doc, update “class” to “module” where appropriate and add readmodule comment. Patch by Hakan Çelik.

  • bpo-39153: Clarify refcounting semantics for the following functions: - PyObject_SetItem - PyMapping_SetItemString - PyDict_SetItem - PyDict_SetItemString

  • bpo-39392: Explain that when filling with turtle, overlap regions may be left unfilled.

  • bpo-39369: Update mmap readline method description. The fact that the readline method does update the file position should not be ignored since this might give the impression for the programmer that it doesn’t update it.

  • bpo-9056: Include subsection in TOC for PDF version of docs.

Tests

Build

  • bpo-39489: Remove COUNT_ALLOCS special build.

Windows

  • bpo-39553: Delete unused code related to SxS manifests.

  • bpo-39439: Honor the Python path when a virtualenv is active on Windows.

  • bpo-39393: Improve the error message when attempting to load a DLL with unresolved dependencies.

  • bpo-38883: home() and expanduser() on Windows now prefer USERPROFILE and no longer use HOME, which is not normally set for regular user accounts. This makes them again behave like os.path.expanduser(), which was changed to ignore HOME in 3.8, see bpo-36264.

  • bpo-39185: The build.bat script has additional options for very-quiet output (-q) and very-verbose output (-vv)

IDLE

  • bpo-39663: Add tests for pyparse find_good_parse_start().

  • bpo-39600: In the font configuration window, remove duplicated font names.

  • bpo-30780: Add remaining configdialog tests for buttons and highlights and keys tabs.

  • bpo-39388: IDLE Settings Cancel button now cancels pending changes

  • bpo-38792: Close an IDLE shell calltip if a KeyboardInterrupt or shell restart occurs. Patch by Zackery Spytz.

C API

  • bpo-35081: Move the bytes_methods.h header file to the internal C API as pycore_bytes_methods.h: it only contains private symbols (prefixed by _Py), except of the PyDoc_STRVAR_shared() macro.

  • bpo-35081: Move the dtoa.h header file to the internal C API as pycore_dtoa.h: it only contains private functions (prefixed by _Py). The math and cmath modules must now be compiled with the Py_BUILD_CORE macro defined.

  • bpo-39573: Add Py_SET_SIZE() function to set the size of an object.

  • bpo-39500: PyUnicode_IsIdentifier() does not call Py_FatalError() anymore if the string is not ready.

  • bpo-39573: Add Py_SET_TYPE() function to set the type of an object.

  • bpo-39573: Add a Py_SET_REFCNT() function to set the reference counter of an object.

  • bpo-39542: Convert PyType_HasFeature(), PyType_Check() and PyType_CheckExact() macros to static inline functions.

  • bpo-39542: In the limited C API, PyObject_INIT() and PyObject_INIT_VAR() are now defined as aliases to PyObject_Init() and PyObject_InitVar() to make their implementation opaque. It avoids to leak implementation details in the limited C API. Exclude the following functions from the limited C API: _Py_NewReference(), _Py_ForgetReference(), _PyTraceMalloc_NewReference() and _Py_GetRefTotal().

  • bpo-39542: Exclude trashcan mechanism from the limited C API: it requires access to PyTypeObject and PyThreadState structure fields, whereas these structures are opaque in the limited C API.

  • bpo-39511: The PyThreadState_Clear() function now calls the PyThreadState.on_delete callback. Previously, that happened in PyThreadState_Delete().

  • bpo-38076: Fix to clear the interpreter state only after clearing module globals to guarantee module state access from C Extensions during runtime destruction

  • bpo-39245: The Vectorcall API (PEP 590) was made public, adding the functions PyObject_Vectorcall, PyObject_VectorcallMethod, PyVectorcall_Function, PyObject_CallOneArg, PyObject_CallMethodNoArgs, PyObject_CallMethodOneArg, PyObject_FastCallDict, and the flag Py_TPFLAGS_HAVE_VECTORCALL.

Python 3.9.0 alpha 3

Release date: 2020-01-24

Core and Builtins

  • bpo-39427: Document all possibilities for the -X options in the command line help section. Patch by Pablo Galindo.

  • bpo-39421: Fix possible crashes when operating with the functions in the heapq module and custom comparison operators.

  • bpo-39386: Prevent double awaiting of async iterator.

  • bpo-17005: Add functools.TopologicalSorter to the functools module to offers functionality to perform topological sorting of graphs. Patch by Pablo Galindo, Tim Peters and Larry Hastings.

  • bpo-39320: Replace four complex bytecodes for building sequences with three simpler ones.

    The following four bytecodes have been removed:

    • BUILD_LIST_UNPACK

    • BUILD_TUPLE_UNPACK

    • BUILD_SET_UNPACK

    • BUILD_TUPLE_UNPACK_WITH_CALL

    The following three bytecodes have been added:

    • LIST_TO_TUPLE

    • LIST_EXTEND

    • SET_UPDATE

  • bpo-39336: Import loaders which publish immutable module objects can now publish immutable packages in addition to individual modules.

  • bpo-39322: Added a new function gc.is_finalized() to check if an object has been finalized by the garbage collector. Patch by Pablo Galindo.

  • bpo-39048: Improve the displayed error message when incorrect types are passed to async with statements by looking up the __aenter__() special method before the __aexit__() special method when entering an asynchronous context manager. Patch by Géry Ogam.

  • bpo-39235: Fix AST end location for lone generator expression in function call, e.g. f(i for i in a).

  • bpo-39209: Correctly handle multi-line tokens in interactive mode. Patch by Pablo Galindo.

  • bpo-1635741: Port _json extension module to multiphase initialization (PEP 489).

  • bpo-39216: Fix constant folding optimization for positional only arguments - by Anthony Sottile.

  • bpo-39215: Fix SystemError when nested function has annotation on positional-only argument - by Anthony Sottile.

  • bpo-39200: Correct the error message when calling the min() or max() with no arguments. Patch by Donghee Na.

  • bpo-39200: Correct the error message when trying to construct range objects with no arguments. Patch by Pablo Galindo.

  • bpo-39166: Fix incorrect line execution reporting in trace functions when tracing the last iteration of asynchronous for loops. Patch by Pablo Galindo.

  • bpo-39114: Fix incorrect line execution reporting in trace functions when tracing exception handlers with name binding. Patch by Pablo Galindo.

  • bpo-39156: Split the COMPARE_OP bytecode instruction into four distinct instructions.

    • COMPARE_OP for rich comparisons

    • IS_OP for “is” and “is not” tests

    • CONTAINS_OP for “in” and “is not” tests

    • JUMP_IF_NOT_EXC_MATCH for checking exceptions in “try-except” statements.

    This improves the clarity of the interpreter and should provide a modest speedup.

  • bpo-38588: Fix possible crashes in dict and list when calling PyObject_RichCompareBool().

  • bpo-13601: By default, sys.stderr is line-buffered now, even if stderr is redirected to a file. You can still make sys.stderr unbuffered by passing the -u command-line option or setting the PYTHONUNBUFFERED environment variable.

    (Contributed by Jendrik Seipp in bpo-13601.)

  • bpo-38610: Fix possible crashes in several list methods by holding strong references to list elements when calling PyObject_RichCompareBool().

  • bpo-32021: Include brotli .br encoding in mimetypes encodings_map

Library

  • bpo-39430: Fixed race condition in lazy imports in tarfile.

  • bpo-39413: The os.unsetenv() function is now also available on Windows.

  • bpo-39390: Fixed a regression with the ignore callback of shutil.copytree(). The argument types are now str and List[str] again.

  • bpo-39395: The os.putenv() and os.unsetenv() functions are now always available.

  • bpo-39406: If setenv() C function is available, os.putenv() is now implemented with setenv() instead of putenv(), so Python doesn’t have to handle the environment variable memory.

  • bpo-39396: Fix math.nextafter(-0.0, +0.0) on AIX 7.1.

  • bpo-29435: Allow tarfile.is_tarfile() to be used with file and file-like objects, like zipfile.is_zipfile(). Patch by William Woodruff.

  • bpo-39377: Removed encoding option from json.loads(). It has been deprecated since Python 3.1.

  • bpo-39389: Write accurate compression level metadata in gzip archives, rather than always signaling maximum compression.

  • bpo-39366: The previously deprecated xpath() and xgtitle() methods of nntplib.NNTP have been removed.

  • bpo-39357: Remove the buffering parameter of bz2.BZ2File. Since Python 3.0, it was ignored and using it was emitting DeprecationWarning. Pass an open file object, to control how the file is opened. The compresslevel parameter becomes keyword-only.

  • bpo-39353: Deprecate binhex4 and hexbin4 standards. Deprecate the binhex module and the following binascii functions: b2a_hqx(), a2b_hqx(), rlecode_hqx(), rledecode_hqx(), crc_hqx().

  • bpo-39351: Remove base64.encodestring() and base64.decodestring(), aliases deprecated since Python 3.1: use base64.encodebytes() and base64.decodebytes() instead.

  • bpo-39350: Remove fractions.gcd() function, deprecated since Python 3.5 (bpo-22486): use math.gcd() instead.

  • bpo-39329: LMTP constructor now has an optional timeout parameter. Patch by Donghee Na.

  • bpo-39313: Add a new exec_function option (–exec-function in the CLI) to RefactoringTool for making exec a function. Patch by Batuhan Taskaya.

  • bpo-39259: FTP_TLS and FTP_TLS now raise a ValueError if the given timeout for their constructor is zero to prevent the creation of a non-blocking socket. Patch by Donghee Na.

  • bpo-39259: SMTP and SMTP_SSL now raise a ValueError if the given timeout for their constructor is zero to prevent the creation of a non-blocking socket. Patch by Donghee Na.

  • bpo-39310: Add math.ulp(): return the value of the least significant bit of a float.

  • bpo-39297: Improved performance of importlib.metadata distribution discovery and resilients to inaccessible sys.path entries (importlib_metadata v1.4.0).

  • bpo-39259: NNTP and NNTP_SSL now raise a ValueError if the given timeout for their constructor is zero to prevent the creation of a non-blocking socket. Patch by Donghee Na.

  • bpo-38901: When you specify prompt=”.” or equivalently python -m venv –prompt . … the basename of the current directory is used to set the created venv’s prompt when it’s activated.

  • bpo-39288: Add math.nextafter(): return the next floating-point value after x towards y.

  • bpo-39259: POP3 and POP3_SSL now raise a ValueError if the given timeout for their constructor is zero to prevent the creation of a non-blocking socket. Patch by Donghee Na.

  • bpo-39242: Updated the Gmane domain from news.gmane.org to news.gmane.io which is used for examples of NNTP news reader server and nntplib tests.

  • bpo-35292: Proxy the SimpleHTTPRequestHandler.guess_type to mimetypes.guess_type so the mimetypes.init is called lazily to avoid unnecessary costs when http.server module is imported.

  • bpo-39239: The select.epoll.unregister() method no longer ignores the EBADF error.

  • bpo-38907: In http.server script, restore binding to IPv4 on Windows.

  • bpo-39152: Fix ttk.Scale.configure([name]) to return configuration tuple for name or all options. Giovanni Lombardo contributed part of the patch.

  • bpo-39198: If an exception were to be thrown in Logger.isEnabledFor (say, by asyncio timeouts or stopit) , the logging global lock may not be released appropriately, resulting in deadlock. This change wraps that block of code with try...finally to ensure the lock is released.

  • bpo-39191: Perform a check for running loop before starting a new task in loop.run_until_complete() to fail fast; it prevents the side effect of new task spawning before exception raising.

  • bpo-38871: Correctly parenthesize filter-based statements that contain lambda expressions in lib2to3. Patch by Donghee Na.

  • bpo-39142: A change was made to logging.config.dictConfig to avoid converting instances of named tuples to ConvertingTuple. It’s assumed that named tuples are too specialised to be treated like ordinary tuples; if a user of named tuples requires ConvertingTuple functionality, they will have to implement that themselves in their named tuple class.

  • bpo-39158: ast.literal_eval() now supports empty sets.

  • bpo-39129: Fix import path for asyncio.TimeoutError

  • bpo-39057: urllib.request.proxy_bypass_environment() now ignores leading dots and no longer ignores a trailing newline.

  • bpo-39056: Fixed handling invalid warning category in the -W option. No longer import the re module if it is not needed.

  • bpo-39055: base64.b64decode() with validate=True raises now a binascii.Error if the input ends with a single \n.

  • bpo-21600: Fix mock.patch.stopall() to stop active patches that were created with mock.patch.dict().

  • bpo-39019: Implement dummy __class_getitem__ for tempfile.SpooledTemporaryFile.

  • bpo-39019: Implement dummy __class_getitem__ for subprocess.Popen, subprocess.CompletedProcess

  • bpo-38914: Adjusted the wording of the warning issued by distutils” check command when the author and maintainer fields are supplied but no corresponding e-mail field (author_email or maintainer_email) is found. The wording now reflects the fact that these fields are suggested, but not required. Patch by Juergen Gmach.

  • bpo-38878: Fixed __subclasshook__ of os.PathLike to return a correct result upon inheritance. Patch by Bar Harel.

  • bpo-38615: IMAP4 and IMAP4_SSL now have an optional timeout parameter for their constructors. Also, the open() method now has an optional timeout parameter with this change. The overridden methods of IMAP4_SSL and IMAP4_stream were applied to this change. Patch by Donghee Na.

  • bpo-35182: Fixed Popen.communicate() subsequent call crash when the child process has already closed any piped standard stream, but still continues to be running. Patch by Andriy Maletsky.

  • bpo-38630: On Unix, subprocess.Popen.send_signal() now polls the process status. Polling reduces the risk of sending a signal to the wrong process if the process completed, the subprocess.Popen.returncode attribute is still None, and the pid has been reassigned (recycled) to a new different process.

  • bpo-38536: Removes trailing space in formatted currency with international=True and a locale with symbol following value. E.g. locale.currency(12.34, international=True) returned '12,34 EUR ' instead of '12,34 EUR'.

  • bpo-38473: Use signature from inner mock for autospecced methods attached with unittest.mock.attach_mock(). Patch by Karthikeyan Singaravelan.

  • bpo-38361: Fixed an issue where ident could include a leading path separator when syslog.openlog() was called without arguments.

  • bpo-38293: Add copy.copy() and copy.deepcopy() support to property() objects.

  • bpo-37958: Added the pstats.Stats.get_profile_dict() method to return the profile data as a StatsProfile instance.

  • bpo-28367: Termios magic constants for the following baud rates: - B500000 - B576000 - B921600 - B1000000 - B1152000 - B1500000 - B2000000 - B2500000 - B3000000 - B3500000 - B4000000 Patch by Andrey Smirnov

Documentation

  • bpo-39381: Mention in docs that asyncio.get_event_loop() implicitly creates new event loop only if called from the main thread.

  • bpo-38918: Add an entry for __module__ in the «function» & «method» sections of the inspect docs” Tipos y miembros table.

  • bpo-3530: In the ast module documentation, fix a misleading NodeTransformer example and add advice on when to use the fix_missing_locations function.

Build

  • bpo-39395: On non-Windows platforms, the setenv() and unsetenv() functions are now required to build Python.

  • bpo-39160: Updated the documentation in ./configure --help to show default values, reference documentation where required and add additional explanation where needed.

  • bpo-39144: The ctags and etags build targets both include Modules/_ctypes and Python standard library source files.

IDLE

  • bpo-39050: Make IDLE Settings dialog Help button work again.

  • bpo-34118: Tag memoryview, range, and tuple as classes, the same as list, etcetera, in the library manual built-in functions list.

  • bpo-32989: Add tests for editor newline_and_indent_event method. Remove dead code from pyparse find_good_parse_start method.

C API

  • bpo-39372: Clean header files of interfaces defined but with no implementation. The public API symbols being removed are: _PyBytes_InsertThousandsGroupingLocale, _PyBytes_InsertThousandsGrouping, _Py_InitializeFromArgs, _Py_InitializeFromWideArgs, _PyFloat_Repr, _PyFloat_Digits, _PyFloat_DigitsInit, PyFrame_ExtendStack, _PyAIterWrapper_Type, PyNullImporter_Type, PyCmpWrapper_Type, PySortWrapper_Type, PyNoArgsFunction.

  • bpo-39164: Add a private _PyErr_GetExcInfo() function to retrieve exception information of the specified Python thread state.

Python 3.9.0 alpha 2

Release date: 2019-12-18

Security

  • bpo-38945: Newline characters have been escaped when performing uu encoding to prevent them from overflowing into to content section of the encoded file. This prevents malicious or accidental modification of data during the decoding process.

  • bpo-37228: Due to significant security concerns, the reuse_address parameter of asyncio.loop.create_datagram_endpoint() is no longer supported. This is because of the behavior of SO_REUSEADDR in UDP. For more details, see the documentation for loop.create_datagram_endpoint(). (Contributed by Kyle Stanley, Antoine Pitrou, and Yury Selivanov in bpo-37228.)

  • bpo-38804: Fixes a ReDoS vulnerability in http.cookiejar. Patch by Ben Caller.

Core and Builtins

  • bpo-39028: Slightly improve the speed of keyword argument parsing with many kwargs by strengthening the assumption that kwargs are interned strings.

  • bpo-39080: Fix the value of end_col_offset for Starred Expression AST nodes when they are among the elements in the args attribute of Call AST nodes.

  • bpo-39031: When parsing an «elif» node, lineno and col_offset of the node now point to the «elif» keyword and not to its condition, making it consistent with the «if» node. Patch by Lysandros Nikolaou.

  • bpo-20443: In Python 3.9.0a1, sys.argv[0] was made an absolute path if a filename was specified on the command line. Revert this change, since most users expect sys.argv to be unmodified.

  • bpo-39008: PySys_Audit() now requires Py_ssize_t to be used for size arguments in the format string, regardless of whether PY_SSIZE_T_CLEAN was defined at include time.

  • bpo-38673: In REPL mode, don’t switch to PS2 if the line starts with comment or whitespace. Based on work by Batuhan Taşkaya.

  • bpo-38922: Calling replace on a code object now raises the code.__new__ audit event.

  • bpo-38920: Add audit hooks for when sys.excepthook() and sys.unraisablehook() are invoked.

  • bpo-38892: Improve documentation for audit events table and functions.

  • bpo-38852: Set the thread stack size to 8 Mb for debug builds on android platforms.

  • bpo-38858: Each Python subinterpreter now has its own «small integer singletons»: numbers in [-5; 257] range. It is no longer possible to change the number of small integers at build time by overriding NSMALLNEGINTS and NSMALLPOSINTS macros: macros should now be modified manually in pycore_pystate.h header file.

  • bpo-36854: The garbage collector state becomes per interpreter (PyInterpreterState.gc), rather than being global (_PyRuntimeState.gc).

  • bpo-38835: The PyFPE_START_PROTECT() and PyFPE_END_PROTECT() macros are empty: they have been doing nothing for the last year, so stop using them.

  • bpo-38328: Sped up the creation time of constant list and set displays. Patch by Brandt Bucher.

  • bpo-38707: MainThread.native_id is now correctly reset in child processes spawned using multiprocessing.Process, instead of retaining the parent’s value.

  • bpo-38629: Added __floor__ and __ceil__ methods to float object. Patch by Batuhan Taşkaya.

  • bpo-27145: int + int and int - int operators can now return small integer singletons. Patch by hongweipeng.

  • bpo-38021: Provide a platform tag for AIX that is sufficient for PEP425 binary distribution identification. Patch by Michael Felt.

  • bpo-35409: Ignore GeneratorExit exceptions when throwing an exception into the aclose coroutine of an asynchronous generator.

  • bpo-33387: Removed WITH_CLEANUP_START, WITH_CLEANUP_FINISH, BEGIN_FINALLY, END_FINALLY, CALL_FINALLY and POP_FINALLY bytecodes. Replaced with RERAISE and WITH_EXCEPT_START bytecodes. The compiler now generates different code for exceptional and non-exceptional branches for “with” and “try-except” statements. For “try-finally” statements the “finally” block is replicated for each exit from the “try” body.

Library

  • bpo-39033: Fix NameError in zipimport. Patch by Karthikeyan Singaravelan.

  • bpo-39022: Update importlib.metadata to include improvements from importlib_metadata 1.3 including better serialization of EntryPoints and improved documentation for custom finders.

  • bpo-39006: Fix asyncio when the ssl module is missing: only check for ssl.SSLSocket instance if the ssl module is available.

  • bpo-38708: Fix a potential IndexError in email parser when parsing an empty msg-id.

  • bpo-38698: Add a new InvalidMessageID token to email parser to represent invalid Message-ID headers. Also, add defects when there is remaining value after parsing the header.

  • bpo-38994: Implement __class_getitem__ for os.PathLike, pathlib.Path.

  • bpo-38979: Return class from ContextVar.__class_getitem__ to simplify subclassing.

  • bpo-38978: Implement __class_getitem__ on asyncio objects (Future, Task, Queue). Patch by Batuhan Taskaya.

  • bpo-38916: array.array: Remove tostring() and fromstring() methods. They were aliases to tobytes() and frombytes(), deprecated since Python 3.2.

  • bpo-38986: Make repr of C accelerated TaskWakeupMethWrapper the same as of pure Python version.

  • bpo-38982: Fix asyncio PidfdChildWatcher: handle waitpid() error. If waitpid() is called elsewhere, waitpid() call fails with ChildProcessError: use return code 255 in this case, and log a warning. It ensures that the pidfd file descriptor is closed if this error occurs.

  • bpo-38529: Drop too noisy asyncio warning about deletion of a stream without explicit .close() call.

  • bpo-27413: Added ability to pass through ensure_ascii options to json.dumps in the json.tool command-line interface.

  • bpo-38634: The readline module now detects if Python is linked to libedit at runtime on all platforms. Previously, the check was only done on macOS.

  • bpo-33684: Fix json.tool failed to read a JSON file with non-ASCII characters when locale encoding is not UTF-8.

  • bpo-38698: Prevent UnboundLocalError to pop up in parse_message_id.

    parse_message_id() was improperly using a token defined inside an exception handler, which was raising UnboundLocalError on parsing an invalid value. Patch by Claudiu Popa.

  • bpo-38927: Use python -m pip instead of pip to upgrade dependencies in venv.

  • bpo-26730: Fix SpooledTemporaryFile.rollover() might corrupt the file when it is in text mode. Patch by Serhiy Storchaka.

  • bpo-38881: random.choices() now raises a ValueError when all the weights are zero.

  • bpo-38876: Raise pickle.UnpicklingError when loading an item from memo for invalid input.

    The previous code was raising a KeyError for both the Python and C implementation. This was caused by the specified index of an invalid input which did not exist in the memo structure, where the pickle stores what objects it has seen. The malformed input would have caused either a BINGET or LONG_BINGET load from the memo, leading to a KeyError as the determined index was bogus. Patch by Claudiu Popa.

  • bpo-38688: Calling func:shutil.copytree to copy a directory tree from one directory to another subdirectory resulted in an endless loop and a RecursionError. A fix was added to consume an iterator and create the list of the entries to be copied, avoiding the recursion for newly created directories. Patch by Bruno P. Kinoshita.

  • bpo-38863: Improve is_cgi() function in http.server, which enables processing the case that cgi directory is a child of another directory other than root.

  • bpo-37838: typing.get_type_hints() properly handles functions decorated with functools.wraps().

  • bpo-38870: Expose ast.unparse() as a function of the ast module that can be used to unparse an ast.AST object and produce a string with code that would produce an equivalent ast.AST object when parsed. Patch by Pablo Galindo and Batuhan Taskaya.

  • bpo-38859: AsyncMock now returns StopAsyncIteration on the exhaustion of a side_effects iterable. Since PEP-479 its Impossible to raise a StopIteration exception from a coroutine.

  • bpo-38857: AsyncMock fix for return values that are awaitable types. This also covers side_effect iterable values that happened to be awaitable, and wraps callables that return an awaitable type. Before these awaitables were being awaited instead of being returned as is.

  • bpo-38834: typing.TypedDict subclasses now track which keys are optional using the __required_keys__ and __optional_keys__ attributes, to enable runtime validation by downstream projects. Patch by Zac Hatfield-Dodds.

  • bpo-38821: Fix unhandled exceptions in argparse when internationalizing error messages for arguments with nargs set to special (non-integer) values. Patch by Federico Bond.

  • bpo-38820: Make Python compatible with OpenSSL 3.0.0. ssl.SSLSocket.getpeercert() no longer returns IPv6 addresses with a trailing new line.

  • bpo-38811: Fix an unhandled exception in pathlib when os.link() is missing. Patch by Toke Høiland-Jørgensen.

  • bpo-38686: Added support for multiple qop values in urllib.request.AbstractDigestAuthHandler.

  • bpo-38712: Add the Linux-specific signal.pidfd_send_signal() function, which allows sending a signal to a process identified by a file descriptor rather than a pid.

  • bpo-38348: Add -i and --indent (indentation level), and --no-type-comments (type comments) command line options to ast parsing tool.

  • bpo-37523: Change zipfile.ZipExtFile to raise ValueError when trying to access the underlying file object after it has been closed. This new behavior is consistent with how accessing closed files is handled in other parts of Python.

  • bpo-38045: Improve the performance of enum._decompose() in enum. Patch by hongweipeng.

  • bpo-36820: Break cycle generated when saving an exception in socket.py, codeop.py and dyld.py as they keep alive not only the exception but user objects through the __traceback__ attribute. Patch by Mario Corchero.

  • bpo-36406: Handle namespace packages in doctest. Patch by Karthikeyan Singaravelan.

  • bpo-34776: Fix dataclasses to support forward references in type annotations

  • bpo-20928: ElementTree supports recursive XInclude processing. Patch by Stefan Behnel.

  • bpo-29636: Add whitespace options for formatting JSON with the json.tool CLI. The following mutually exclusive options are now supported: --indent for setting the indent level in spaces; --tab for indenting with tabs; --no-indent for suppressing newlines; and --compact for suppressing all whitespace. The default behavior remains the same as --indent=4.

Documentation

Tests

  • bpo-38546: Fix test_ressources_gced_in_workers() of test_concurrent_futures: explicitly stop the manager to prevent leaking a child process running in the background after the test completes.

  • bpo-38546: Multiprocessing and concurrent.futures tests now stop the resource tracker process when tests complete.

  • bpo-38614: Replace hardcoded timeout constants in tests with new test.support constants: LOOPBACK_TIMEOUT, INTERNET_TIMEOUT, SHORT_TIMEOUT and LONG_TIMEOUT. It becomes easier to adjust these four timeout constants for all tests at once, rather than having to adjust every single test file.

  • bpo-38547: Fix test_pty: if the process is the session leader, closing the master file descriptor raises a SIGHUP signal: simply ignore SIGHUP when running the tests.

  • bpo-38992: Fix a test for math.fsum() that was failing due to constant folding.

  • bpo-38991: test.support: run_python_until_end(), assert_python_ok() and assert_python_failure() functions no longer strip whitespaces from stderr. Remove test.support.strip_python_stderr() function.

  • bpo-38965: Fix test_faulthandler on GCC 10. Use the «volatile» keyword in faulthandler._stack_overflow() to prevent tail call optimization on any compiler, rather than relying on compiler specific pragma.

  • bpo-38875: test_capi: trashcan tests now require the test «cpu» resource.

  • bpo-38841: Skip asyncio test_create_datagram_endpoint_existing_sock_unix on platforms lacking a functional bind() for named unix domain sockets.

  • bpo-38692: Skip the test_posix.test_pidfd_open() test if os.pidfd_open() fails with a PermissionError. This situation can happen in a Linux sandbox using a syscall whitelist which doesn’t allow the pidfd_open() syscall yet.

  • bpo-38839: Fix some unused functions in tests. Patch by Adam Johnson.

  • bpo-38669: Raise TypeError when passing target as a string with unittest.mock.patch.object().

  • bpo-37957: test.regrtest now can receive a list of test patterns to ignore (using the -i/–ignore argument) or a file with a list of patterns to ignore (using the –ignore-file argument). Patch by Pablo Galindo.

Build

  • bpo-37404: asyncio now raises TypeError when calling incompatible methods with an ssl.SSLSocket socket. Patch by Ido Michael.

  • bpo-36500: Added an optional «regen» project to the Visual Studio solution that will regenerate all grammar, tokens, and opcodes.

Windows

  • bpo-39007: Add auditing events to functions in winreg.

  • bpo-33125: Add support for building and releasing Windows ARM64 packages.

macOS

  • bpo-37931: Fixed a crash on OSX dynamic builds that occurred when re-initializing the posix module after a Py_Finalize if the environment had changed since the previous import posix. Patch by Benoît Hudson.

IDLE

  • bpo-38944: Escape key now closes IDLE completion windows. Patch by Johnny Najera.

  • bpo-38943: Fix IDLE autocomplete windows not always appearing on some systems. Patch by Johnny Najera.

  • bpo-38862: “Strip Trailing Whitespace” on the Format menu removes extra newlines at the end of non-shell files.

  • bpo-38636: Fix IDLE Format menu tab toggle and file indent width. These functions (default shortcuts Alt-T and Alt-U) were mistakenly disabled in 3.7.5 and 3.8.0.

C API

  • bpo-38896: Remove PyUnicode_ClearFreeList() function: the Unicode free list has been removed in Python 3.3.

  • bpo-37340: Remove PyMethod_ClearFreeList() and PyCFunction_ClearFreeList() functions: the free lists of bound method objects have been removed.

  • bpo-38835: Exclude PyFPE_START_PROTECT() and PyFPE_END_PROTECT() macros of pyfpe.h from Py_LIMITED_API (stable API).

Python 3.9.0 alpha 1

Release date: 2019-11-19

Security

Core and Builtins

  • bpo-38631: Replace Py_FatalError() call with a regular RuntimeError exception in float.__getformat__().

  • bpo-38639: Optimized math.floor(), math.ceil() and math.trunc() for floats.

  • bpo-38640: Fixed a bug in the compiler that was causing to raise in the presence of break statements and continue statements inside always false while loops. Patch by Pablo Galindo.

  • bpo-38613: Optimized some set operations (e.g. |, ^, and -) of dict_keys. d.keys() | other was slower than set(d) | other but they are almost same performance for now.

  • bpo-28029: "".replace("", s, n) now returns s instead of an empty string for all non-zero n. There are similar changes for bytes and bytearray objects.

  • bpo-38535: Fixed line numbers and column offsets for AST nodes for calls without arguments in decorators.

  • bpo-38525: Fix a segmentation fault when using reverse iterators of empty dict objects. Patch by Donghee Na and Inada Naoki.

  • bpo-38465: bytearray, array and mmap objects allow now to export more than 2**31 buffers at a time.

  • bpo-38469: Fixed a bug where the scope of named expressions was not being resolved correctly in the presence of the global keyword. Patch by Pablo Galindo.

  • bpo-38437: Activate the GC_DEBUG macro for debug builds of the interpreter (when Py_DEBUG is set). Patch by Pablo Galindo.

  • bpo-38379: When the garbage collector makes a collection in which some objects resurrect (they are reachable from outside the isolated cycles after the finalizers have been executed), do not block the collection of all objects that are still unreachable. Patch by Pablo Galindo and Tim Peters.

  • bpo-38379: When cyclic garbage collection (gc) runs finalizers that resurrect unreachable objects, the current gc run ends, without collecting any cyclic trash. However, the statistics reported by collect() and get_stats() claimed that all cyclic trash found was collected, and that the resurrected objects were collected. Changed the stats to report that none were collected.

  • bpo-38392: In debug mode, PyObject_GC_Track() now calls tp_traverse() of the object type to ensure that the object is valid: test that objects visited by tp_traverse() are valid.

  • bpo-38210: Remove unnecessary intersection and update set operation in dictview with empty set. (Contributed by Donghee Na in bpo-38210.)

  • bpo-38402: Check the error from the system’s underlying crypt or crypt_r.

  • bpo-37474: On FreeBSD, Python no longer calls fedisableexcept() at startup to control the floating-point control mode. The call became useless since FreeBSD 6: it became the default mode.

  • bpo-38006: Fix a bug due to the interaction of weakrefs and the cyclic garbage collector. We must clear any weakrefs in garbage in order to prevent their callbacks from executing and causing a crash.

  • bpo-38317: Fix warnings options priority: PyConfig.warnoptions has the highest priority, as stated in the PEP 587.

  • bpo-38310: Predict BUILD_MAP_UNPACK_WITH_CALL -> CALL_FUNCTION_EX opcode pairs in the main interpreter loop. Patch by Brandt Bucher.

  • bpo-36871: Improve error handling for the assert_has_calls and assert_has_awaits methods of mocks. Fixed a bug where any errors encountered while binding the expected calls to the mock’s spec were silently swallowed, leading to misleading error output.

  • bpo-11410: Better control over symbol visibility is provided through use of the visibility attributes available in gcc >= 4.0, provided in a uniform way across POSIX and Windows. The POSIX build files have been updated to compile with -fvisibility=hidden, minimising exported symbols.

  • bpo-38219: Optimized the dict constructor and the update() method for the case when the argument is a dict.

  • bpo-38236: Python now dumps path configuration if it fails to import the Python codecs of the filesystem and stdio encodings.

  • bpo-38013: Allow to call async_generator_athrow().throw(...) even for non-started async generator helper. It fixes annoying warning at the end of asyncio.run() call.

  • bpo-38124: Fix an off-by-one error in PyState_AddModule that could cause out-of-bounds memory access.

  • bpo-38116: The select module is now PEP-384 compliant and no longer has static state

  • bpo-38113: ast module updated to PEP-384 and all statics removed

  • bpo-38076: The struct module is now PEP-384 compatible

  • bpo-38075: The random module is now PEP-384 compatible

  • bpo-38074: zlib module made PEP-384 compatible

  • bpo-38073: Make pwd extension module PEP-384 compatible

  • bpo-38072: grp module made PEP-384 compatible

  • bpo-38069: Make _posixsubprocess PEP-384 compatible

  • bpo-38071: Make termios extension module PEP-384 compatible

  • bpo-38005: Fixed comparing and creating of InterpreterID and ChannelID.

  • bpo-36946: Fix possible signed integer overflow when handling slices. Patch by hongweipeng.

  • bpo-37994: Fixed silencing arbitrary errors if an attribute lookup fails in several sites. Only AttributeError should be silenced.

  • bpo-8425: Optimize set difference_update for the case when the other set is much larger than the base set. (Suggested by Evgeny Kapun with code contributed by Michele Orrù).

  • bpo-37966: The implementation of is_normalized() has been greatly sped up on strings that aren’t normalized, by implementing the full normalization-quick-check algorithm from the Unicode standard.

  • bpo-37947: Adjust correctly the recursion level in the symtable generation for named expressions. Patch by Pablo Galindo.

  • bpo-37812: The CHECK_SMALL_INT macro used inside Object/longobject.c has been replaced with an explicit return at each call site.

  • bpo-37751: Fix codecs.lookup() to normalize the encoding name the same way than encodings.normalize_encoding(), except that codecs.lookup() also converts the name to lower case.

  • bpo-37830: Fixed compilation of break and continue in the finally block when the corresponding try block contains return with a non-constant value.

  • bpo-20490: Improve import error message for partially initialized module on circular from imports - by Anthony Sottile.

  • bpo-37840: Fix handling of negative indices in sq_item of bytearray. Patch by Sergey Fedoseev.

  • bpo-37802: Slightly improve performance of PyLong_FromUnsignedLong(), PyLong_FromUnsignedLongLong() and PyLong_FromSize_t(). Patch by Sergey Fedoseev.

  • bpo-37409: Ensure explicit relative imports from interactive sessions and scripts (having no parent package) always raise ImportError, rather than treating the current module as the package. Patch by Ben Lewis.

  • bpo-32912: Reverted bpo-32912: emitting SyntaxWarning instead of DeprecationWarning for invalid escape sequences in string and bytes literals.

  • bpo-37757: PEP 572: As described in the PEP, assignment expressions now raise SyntaxError when their interaction with comprehension scoping results in an ambiguous target scope.

    The TargetScopeError subclass originally proposed by the PEP has been removed in favour of just raising regular syntax errors for the disallowed cases.

  • bpo-36279: Fix potential use of uninitialized memory in os.wait3().

  • bpo-36311: Decoding bytes objects larger than 2GiB is faster and no longer fails when a multibyte characters spans a chunk boundary.

  • bpo-34880: The assert statement now works properly if the AssertionError exception is being shadowed. Patch by Zackery Spytz.

  • bpo-37340: Removed object cache (free_list) for bound method objects. Temporary bound method objects are less used than before thanks to the LOAD_METHOD opcode and the _PyObject_VectorcallMethod C API.

  • bpo-37648: Fixed minor inconsistency in list.__contains__(), tuple.__contains__() and a few other places. The collection’s item is now always at the left and the needle is on the right of ==.

  • bpo-37444: Update differing exception between builtins.__import__() and importlib.__import__().

  • bpo-37619: When adding a wrapper descriptor from one class to a different class (for example, setting __add__ = str.__add__ on an int subclass), an exception is correctly raised when the operator is called.

  • bpo-37593: Swap the positions of the posonlyargs and args parameters in the constructor of ast.parameters nodes.

  • bpo-37543: Optimized pymalloc for non PGO build.

  • bpo-37537: Compute allocated pymalloc blocks inside _Py_GetAllocatedBlocks(). This slows down _Py_GetAllocatedBlocks() but gives a small speedup to _PyObject_Malloc() and _PyObject_Free().

  • bpo-37467: Fix sys.excepthook() and PyErr_Display() if a filename is a bytes string. For example, for a SyntaxError exception where the filename attribute is a bytes string.

  • bpo-37433: Fix SyntaxError indicator printing too many spaces for multi-line strings - by Anthony Sottile.

  • bpo-37417: bytearray.extend() now correctly handles errors that arise during iteration. Patch by Brandt Bucher.

  • bpo-37414: The undocumented sys.callstats() function has been removed. Since Python 3.7, it was deprecated and always returned None. It required a special build option CALL_PROFILE which was already removed in Python 3.7.

  • bpo-37392: Remove sys.getcheckinterval() and sys.setcheckinterval() functions. They were deprecated since Python 3.2. Use sys.getswitchinterval() and sys.setswitchinterval() instead. Remove also check_interval field of the PyInterpreterState structure.

  • bpo-37388: In development mode and in debug build, encoding and errors arguments are now checked on string encoding and decoding operations. Examples: open(), str.encode() and bytes.decode().

    By default, for best performances, the errors argument is only checked at the first encoding/decoding error, and the encoding argument is sometimes ignored for empty strings.

  • bpo-37348: Optimized decoding short ASCII string with UTF-8 and ascii codecs. b"foo".decode() is about 15% faster. Patch by Inada Naoki.

  • bpo-24214: Improved support of the surrogatepass error handler in the UTF-8 and UTF-16 incremental decoders.

  • bpo-37330: open(), io.open(), codecs.open() and fileinput.FileInput no longer accept 'U' («universal newline») in the file mode. This flag was deprecated since Python 3.3.

  • bpo-35224: Reverse evaluation order of key: value in dict comprehensions as proposed in PEP 572. I.e. in {k: v for ...}, k will be evaluated before v.

  • bpo-37316: Fix the PySys_Audit() call in mmap.mmap.

  • bpo-37300: Remove an unnecessary Py_XINCREF in classobject.c.

  • bpo-37269: Fix a bug in the peephole optimizer that was not treating correctly constant conditions with binary operators. Patch by Pablo Galindo.

  • bpo-20443: Python now gets the absolute path of the script filename specified on the command line (ex: «python3 script.py»): the __file__ attribute of the __main__ module and sys.path[0] become an absolute path, rather than a relative path.

  • bpo-37257: Python’s small object allocator (obmalloc.c) now allows (no more than) one empty arena to remain available for immediate reuse, without returning it to the OS. This prevents thrashing in simple loops where an arena could be created and destroyed anew on each iteration.

  • bpo-37231: The dispatching of type slots to special methods (for example calling __mul__ when doing x * y) has been made faster.

  • bpo-36974: Implemented separate vectorcall functions for every calling convention of builtin functions and methods. This improves performance for calls.

  • bpo-37213: Handle correctly negative line offsets in the peephole optimizer. Patch by Pablo Galindo.

  • bpo-37219: Remove erroneous optimization for empty set differences.

  • bpo-15913: Implement PyBuffer_SizeFromFormat() function (previously documented but not implemented): call struct.calcsize(). Patch by Joannah Nanjekye.

  • bpo-36922: Slot functions optimize any callable with Py_TPFLAGS_METHOD_DESCRIPTOR instead of only instances of function.

  • bpo-36974: The slot tp_vectorcall_offset is inherited unconditionally to support super().__call__() when the base class uses vectorcall.

  • bpo-37160: threading.get_native_id() now also supports NetBSD.

  • bpo-37077: Add threading.get_native_id() support for AIX. Patch by M. Felt

  • bpo-36781: sum() has been optimized for boolean values.

  • bpo-34556: Add --upgrade-deps to venv module. Patch by Cooper Ry Lees

  • bpo-20523: pdb.Pdb supports ~/.pdbrc in Windows 7. Patch by Tim Hopper and Dan Lidral-Porter.

  • bpo-35551: Updated encodings: - Removed the «tis260» encoding, which was an alias for the nonexistent «tactis» codec. - Added «mac_centeuro» as an alias for the mac_latin2 encoding.

  • bpo-19072: The classmethod decorator can now wrap other descriptors such as property objects. Adapted from a patch written by Graham Dumpleton.

  • bpo-27575: Improve speed of dictview intersection by directly using set intersection logic. Patch by David Su.

  • bpo-30773: Prohibit parallel running of aclose() / asend() / athrow(). Fix ag_running to reflect the actual running status of the AG.

Library

  • bpo-36589: The curses.update_lines_cols() function now returns None instead of 1 on success.

  • bpo-38807: Update TypeError messages for os.path.join() to include os.PathLike objects as acceptable input types.

  • bpo-38724: Add a repr for subprocess.Popen objects. Patch by Andrey Doroschenko.

  • bpo-38786: pydoc now recognizes and parses HTTPS URLs. Patch by python273.

  • bpo-38785: Prevent asyncio from crashing if parent __init__ is not called from a constructor of object derived from asyncio.Future.

  • bpo-38723: pdb now uses io.open_code() to trigger auditing events.

  • bpo-27805: Allow opening pipes and other non-seekable files in append mode with open().

  • bpo-38438: Simplify the argparse usage message for nargs="*".

  • bpo-38761: WeakSet is now registered as a collections.abc.MutableSet.

  • bpo-38716: logging: change RotatingHandler namer and rotator to class-level attributes. This stops __init__ from setting them to None in the case where a subclass defines them with eponymous methods.

  • bpo-38713: Add os.P_PIDFD constant, which may be passed to os.waitid() to wait on a Linux process file descriptor.

  • bpo-38692: Add asyncio.PidfdChildWatcher, a Linux-specific child watcher implementation that polls process file descriptors.

  • bpo-38692: Expose the Linux pidfd_open syscall as os.pidfd_open().

  • bpo-38602: Added constants F_OFD_GETLK, F_OFD_SETLK and F_OFD_SETLKW to the fcntl module. Patch by Donghee Na.

  • bpo-38334: Fixed seeking backward on an encrypted zipfile.ZipExtFile.

  • bpo-38312: Add curses.get_escdelay(), curses.set_escdelay(), curses.get_tabsize(), and curses.set_tabsize() functions - by Anthony Sottile.

  • bpo-38586: Now fileConfig() correctly sets the .name of handlers loaded.

  • bpo-38565: Add new cache_parameters() method for functools.lru_cache() to better support pickling.

  • bpo-34679: asynci.ProactorEventLoop.close() now only calls signal.set_wakeup_fd() in the main thread.

  • bpo-31202: The case the result of pathlib.WindowsPath.glob() matches now the case of the pattern for literal parts.

  • bpo-36321: Remove misspelled attribute. The 3.8 changelog noted that this would be removed in 3.9.

  • bpo-38521: Fixed erroneous equality comparison in statistics.NormalDist().

  • bpo-38493: Added CLD_KILLED and CLD_STOPPED for si_code. Patch by Donghee Na.

  • bpo-38478: Fixed a bug in inspect.signature.bind() that was causing it to fail when handling a keyword argument with same name as positional-only parameter. Patch by Pablo Galindo.

  • bpo-33604: Fixed hmac.new and hmac.HMAC to raise TypeError instead of ValueError when the digestmod parameter, now required in 3.8, is omitted. Also clarified the hmac module documentation and docstrings.

  • bpo-38378: Parameters out and in of os.sendfile() was renamed to out_fd and in_fd.

  • bpo-38417: Added support for setting the umask in the child process to the subprocess module on POSIX systems.

  • bpo-38449: Revert PR 15522, which introduces a regression in mimetypes.guess_type() due to improper handling of filenames as urls.

  • bpo-38431: Fix __repr__ method for dataclasses.InitVar to support typing objects, patch by Samuel Colvin.

  • bpo-38109: Add missing stat.S_IFDOOR, stat.S_IFPORT, stat.S_IFWHT, stat.S_ISDOOR(), stat.S_ISPORT(), and stat.S_ISWHT() values to the Python implementation of stat.

  • bpo-38422: Clarify docstrings of pathlib suffix(es)

  • bpo-38405: Nested subclasses of typing.NamedTuple are now pickleable.

  • bpo-38332: Prevent KeyError thrown by _encoded_words.decode() when given an encoded-word with invalid content-type encoding from propagating all the way to email.message.get().

  • bpo-38371: Deprecated the split() method in _tkinter.TkappType in favour of the splitlist() method which has more consistent and predictable behavior.

  • bpo-38341: Add smtplib.SMTPNotSupportedError to the smtplib exported names.

  • bpo-38319: sendfile() used in socket and shutil modules was raising OverflowError for files >= 2GiB on 32-bit architectures. (patch by Giampaolo Rodola)

  • bpo-38242: Revert the new asyncio Streams API

  • bpo-13153: OS native encoding is now used for converting between Python strings and Tcl objects. This allows to display, copy and paste to clipboard emoji and other non-BMP characters. Converting strings from Tcl to Python and back now never fails (except MemoryError).

  • bpo-38019: Correctly handle pause/resume reading of closed asyncio unix pipe.

  • bpo-38163: Child mocks will now detect their type as either synchronous or asynchronous, asynchronous child mocks will be AsyncMocks and synchronous child mocks will be either MagicMock or Mock (depending on their parent type).

  • bpo-38161: Removes _AwaitEvent from AsyncMock.

  • bpo-38216: Allow the rare code that wants to send invalid http requests from the http.client library a way to do so. The fixes for bpo-30458 led to breakage for some projects that were relying on this ability to test their own behavior in the face of bad requests.

  • bpo-28286: Deprecate opening GzipFile for writing implicitly. Always specify the mode argument for writing.

  • bpo-38108: Any synchronous magic methods on an AsyncMock now return a MagicMock. Any asynchronous magic methods on a MagicMock now return an AsyncMock.

  • bpo-38265: Update the length parameter of os.pread() to accept Py_ssize_t instead of int.

  • bpo-38112: compileall has a higher default recursion limit and new command-line arguments for path manipulation, symlinks handling, and multiple optimization levels.

  • bpo-38248: asyncio: Fix inconsistent immediate Task cancellation

  • bpo-38237: The arguments for the builtin pow function are more descriptive. They can now also be passed in as keywords.

  • bpo-34002: Improve efficiency in parts of email package by changing while-pop to a for loop, using isdisjoint instead of set intersections.

  • bpo-38191: Constructors of NamedTuple and TypedDict types now accept arbitrary keyword argument names, including «cls», «self», «typename», «_typename», «fields» and «_fields».

  • bpo-38155: Add __all__ to datetime. Patch by Tahia Khan.

  • bpo-38185: Fixed case-insensitive string comparison in sqlite3.Row indexing.

  • bpo-38136: Changes AsyncMock call count and await count to be two different counters. Now await count only counts when a coroutine has been awaited, not when it has been called, and vice-versa. Update the documentation around this.

  • bpo-37828: Fix default mock name in unittest.mock.Mock.assert_called() exceptions. Patch by Abraham Toriz Cruz.

  • bpo-38175: Fix a memory leak in comparison of sqlite3.Row objects.

  • bpo-33936: _hashlib no longer calls obsolete OpenSSL initialization function with OpenSSL 1.1.0+.

  • bpo-34706: Preserve subclassing in inspect.Signature.from_callable.

  • bpo-38153: Names of hashing algorithms from OpenSSL are now normalized to follow Python’s naming conventions. For example OpenSSL uses sha3-512 instead of sha3_512 or blake2b512 instead of blake2b.

  • bpo-38115: Fix a bug in dis.findlinestarts() where it would return invalid bytecode offsets. Document that a code object’s co_lnotab can contain invalid bytecode offsets.

  • bpo-38148: Add slots to asyncio transport classes, which can reduce memory usage.

  • bpo-38142: The _hashlib OpenSSL wrapper extension module is now PEP-384 compliant.

  • bpo-9216: hashlib constructors now support usedforsecurity flag to signal that a hashing algorithm is not used in a security context.

  • bpo-36991: Fixes a potential incorrect AttributeError exception escaping ZipFile.extract() in some unsupported input error situations.

  • bpo-38134: Remove obsolete copy of PBKDF2_HMAC_fast. All supported OpenSSL versions contain a fast implementation.

  • bpo-38132: The OpenSSL hashlib wrapper uses a simpler implementation. Several Macros and pointless caches are gone. The hash name now comes from OpenSSL’s EVP. The algorithm name stays the same, except it is now always lower case.

  • bpo-38008: Fix parent class check in protocols to correctly identify the module that provides a builtin protocol, instead of assuming they all come from the collections.abc module

  • bpo-34037: For asyncio, add a new coroutine loop.shutdown_default_executor(). The new coroutine provides an API to schedule an executor shutdown that waits on the threadpool to finish closing. Also, asyncio.run() has been updated to utilize the new coroutine. Patch by Kyle Stanley.

  • bpo-37405: Fixed regression bug for socket.getsockname() for non-CAN_ISOTP AF_CAN address family sockets by returning a 1-tuple instead of string.

  • bpo-38121: Update parameter names on functions in importlib.metadata matching the changes in the 0.22 release of importlib_metadata.

  • bpo-38110: The os.closewalk() implementation now uses the libc fdwalk() API on platforms where it is available.

  • bpo-38093: Fixes AsyncMock so it doesn’t crash when used with AsyncContextManagers or AsyncIterators.

  • bpo-37488: Add warning to datetime.utctimetuple(), datetime.utcnow() and datetime.utcfromtimestamp() .

  • bpo-35640: Allow passing a path-like object as directory argument to the http.server.SimpleHTTPRequestHandler class. Patch by Géry Ogam.

  • bpo-38086: Update importlib.metadata with changes from importlib_metadata 0.21.

  • bpo-37251: Remove __code__ check in AsyncMock that incorrectly evaluated function specs as async objects but failed to evaluate classes with __await__ but no __code__ attribute defined as async objects.

  • bpo-38037: Fix reference counters in the signal module.

  • bpo-38066: Hide internal asyncio.Stream methods: feed_eof(), feed_data(), set_exception() and set_transport().

  • bpo-38059: inspect.py now uses sys.exit() instead of exit()

  • bpo-38049: Added command-line interface for the ast module.

  • bpo-37953: In typing, improved the __hash__ and __eq__ methods for ForwardReferences.

  • bpo-38026: Fixed inspect.getattr_static() used isinstance while it should avoid dynamic lookup.

  • bpo-35923: Update importlib.machinery.BuiltinImporter to use loader._ORIGIN instead of a hardcoded value. Patch by Donghee Na.

  • bpo-38010: In importlib.metadata sync with importlib_metadata 0.20, clarifying behavior of files() and fixing issue where only one requirement was returned for requires() on dist-info packages.

  • bpo-38006: weakref.WeakValueDictionary defines a local remove() function used as callback for weak references. This function was created with a closure. Modify the implementation to avoid the closure.

  • bpo-37995: Added the indent option to ast.dump() which allows it to produce a multiline indented output.

  • bpo-34410: Fixed a crash in the tee() iterator when re-enter it. RuntimeError is now raised in this case.

  • bpo-37140: Fix a ctypes regression of Python 3.8. When a ctypes.Structure is passed by copy to a function, ctypes internals created a temporary object which had the side effect of calling the structure finalizer (__del__) twice. The Python semantics requires a finalizer to be called exactly once. Fix ctypes internals to no longer call the finalizer twice.

  • bpo-37587: _json.scanstring is now up to 3x faster when there are many backslash escaped characters in the JSON string.

  • bpo-37834: Prevent shutil.rmtree exception when built on non-Windows system without fd system call support, like older versions of macOS.

  • bpo-10978: Semaphores and BoundedSemaphores can now release more than one waiting thread at a time.

  • bpo-37972: Subscripts to the unittest.mock.call objects now receive the same chaining mechanism as any other custom attributes, so that the following usage no longer raises a TypeError:

    call().foo().__getitem__('bar')

    Patch by blhsing

  • bpo-37965: Fix C compiler warning caused by distutils.ccompiler.CCompiler.has_function.

  • bpo-37964: Add F_GETPATH command to fcntl.

  • bpo-37960: repr() of buffered and text streams now silences only expected exceptions when get the value of «name» and «mode» attributes.

  • bpo-37961: Add a total_nframe field to the traces collected by the tracemalloc module. This field indicates the original number of frames before it was truncated.

  • bpo-37951: Most features of the subprocess module now work again in subinterpreters. Only preexec_fn is restricted in subinterpreters.

  • bpo-36205: Fix the rusage implementation of time.process_time() to correctly report the sum of the system and user CPU time.

  • bpo-37950: Fix ast.dump() when call with incompletely initialized node.

  • bpo-34679: Restores instantiation of Windows IOCP event loops from the non-main thread.

  • bpo-36917: Add default implementation of the ast.NodeVisitor.visit_Constant() method which emits a deprecation warning and calls corresponding methods visit_Num(), visit_Str(), etc.

  • bpo-37798: Update test_statistics.py to verify that the statistics module works well for both C and Python implementations. Patch by Donghee Na

  • bpo-26589: Added a new status code to the http module: 451 UNAVAILABLE_FOR_LEGAL_REASONS

  • bpo-37915: Fix a segmentation fault that appeared when comparing instances of datetime.timezone and datetime.tzinfo objects. Patch by Pablo Galindo.

  • bpo-32554: Deprecate having random.seed() call hash on arbitrary types.

  • bpo-9938: Add optional keyword argument exit_on_error for ArgumentParser.

  • bpo-37851: The faulthandler module no longer allocates its alternative stack at Python startup. Now the stack is only allocated at the first faulthandler usage.

  • bpo-32793: Fix a duplicated debug message when smtplib.SMTP.connect() is called.

  • bpo-37885: venv: Don’t generate unset variable warning on deactivate.

  • bpo-37868: Fix dataclasses.is_dataclass when given an instance that never raises AttributeError in __getattr__. That is, an object that returns something for __dataclass_fields__ even if it’s not a dataclass.

  • bpo-37811: Fix socket module’s socket.connect(address) function being unable to establish connection in case of interrupted system call. The problem was observed on all OSes which poll(2) system call can take only non-negative integers and -1 as a timeout value.

  • bpo-37863: Optimizations for Fraction.__hash__ suggested by Tim Peters.

  • bpo-21131: Fix faulthandler.register(chain=True) stack. faulthandler now allocates a dedicated stack of SIGSTKSZ*2 bytes, instead of just SIGSTKSZ bytes. Calling the previous signal handler in faulthandler signal handler uses more than SIGSTKSZ bytes of stack memory on some platforms.

  • bpo-37798: Add C fastpath for statistics.NormalDist.inv_cdf() Patch by Donghee Na

  • bpo-37804: Remove the deprecated method threading.Thread.isAlive(). Patch by Donghee Na.

  • bpo-37819: Add Fraction.as_integer_ratio() to match the corresponding methods in bool, int, float, and decimal.

  • bpo-14465: Add an xml.etree.ElementTree.indent() function for pretty-printing XML trees. Contributed by Stefan Behnel.

  • bpo-37810: Fix difflib ? hint in diff output when dealing with tabs. Patch by Anthony Sottile.

  • bpo-37772: In zipfile.Path, when adding implicit dirs, ensure that ancestral directories are added and that duplicates are excluded.

  • bpo-18578: Renamed and documented test.bytecode_helper as test.support.bytecode_helper. Patch by Joannah Nanjekye.

  • bpo-37785: Fix xgettext warnings in argparse.

  • bpo-34488: writelines() method of io.BytesIO is now slightly faster when many small lines are passed. Patch by Sergey Fedoseev.

  • bpo-37449: ensurepip now uses importlib.resources.read_binary() to read data instead of pkgutil.get_data(). Patch by Joannah Nanjekye.

  • bpo-28292: Mark calendar.py helper functions as being private. The follows PEP 8 guidance to maintain the style conventions in the module and it addresses a known case of user confusion.

  • bpo-18049: Add definition of THREAD_STACK_SIZE for AIX in Python/thread_pthread.h The default thread stacksize caused crashes with the default recursion limit Patch by M Felt

  • bpo-37742: The logging.getLogger() API now returns the root logger when passed the name “root”, whereas previously it returned a non-root logger named “root”. This could affect cases where user code explicitly wants a non-root logger named “root”, or instantiates a logger using logging.getLogger(__name__) in some top-level module called “root.py”.

  • bpo-37738: Fix the implementation of curses addch(str, color_pair): pass the color pair to setcchar(), instead of always passing 0 as the color pair.

  • bpo-37723: Fix performance regression on regular expression parsing with huge character sets. Patch by Yann Vaginay.

  • bpo-35943: The function PyImport_GetModule() now ensures any module it returns is fully initialized. Patch by Joannah Nanjekye.

  • bpo-32178: Fix IndexError in email package when trying to parse invalid address fields starting with :.

  • bpo-37268: The parser module is deprecated and will be removed in future versions of Python.

  • bpo-11953: Completing WSA* error codes in socket.

  • bpo-37685: Fixed comparisons of datetime.timedelta and datetime.timezone.

  • bpo-37697: Synchronize importlib.metadata with importlib_metadata 0.19, improving handling of EGG-INFO files and fixing a crash when entry point names contained colons.

  • bpo-37695: Correct curses.unget_wch() error message. Patch by Anthony Sottile.

  • bpo-37689: Add is_relative_to() in PurePath to determine whether or not one path is relative to another.

  • bpo-29553: Fixed argparse.ArgumentParser.format_usage() for mutually exclusive groups. Patch by Andrew Nester.

  • bpo-37691: Let math.dist() accept coordinates as sequences (or iterables) rather than just tuples.

  • bpo-37685: Fixed __eq__, __lt__ etc implementations in some classes. They now return NotImplemented for unsupported type of the other operand. This allows the other operand to play role (for example the equality comparison with ANY will return True).

  • bpo-37354: Make Activate.ps1 Powershell script static to allow for signing it.

  • bpo-37664: Update wheels bundled with ensurepip (pip 19.2.3 and setuptools 41.2.0)

  • bpo-37663: Bring consistency to venv shell activation scripts by always using __VENV_PROMPT__.

  • bpo-37642: Allowed the pure Python implementation of datetime.timezone to represent sub-minute offsets close to minimum and maximum boundaries, specifically in the ranges (23:59, 24:00) and (-23:59, 24:00). Patch by Ngalim Siregar

  • bpo-36161: In posix, use ttyname_r instead of ttyname for thread safety.

  • bpo-36324: Make internal attributes for statistics.NormalDist() private.

  • bpo-37555: Fix NonCallableMock._call_matcher returning tuple instead of _Call object when self._spec_signature exists. Patch by Elizabeth Uselton

  • bpo-29446: Make from tkinter import * import only the expected objects.

  • bpo-16970: Adding a value error when an invalid value in passed to nargs Patch by Robert Leenders

  • bpo-34443: Exceptions from enum now use the __qualname of the enum class in the exception message instead of the __name__.

  • bpo-37491: Fix IndexError when parsing email headers with unexpectedly ending bare-quoted string value. Patch by Abhilash Raj.

  • bpo-37587: Make json.loads faster for long strings. (Patch by Marco Paolini)

  • bpo-18378: Recognize «UTF-8» as a valid value for LC_CTYPE in locale._parse_localename.

  • bpo-37579: Return NotImplemented in Python implementation of __eq__ for timedelta and time when the other object being compared is not of the same type to match C implementation. Patch by Karthikeyan Singaravelan.

  • bpo-21478: Record calls to parent when autospecced object is attached to a mock using unittest.mock.attach_mock(). Patch by Karthikeyan Singaravelan.

  • bpo-37531: «python3 -m test -jN –timeout=TIMEOUT» now kills a worker process if it runs longer than TIMEOUT seconds.

  • bpo-37482: Fix serialization of display name in originator or destination address fields with both encoded words and special chars.

  • bpo-36993: Improve error reporting for corrupt zip files with bad zip64 extra data. Patch by Daniel Hillier.

  • bpo-37502: pickle.loads() no longer raises TypeError when the buffers argument is set to None

  • bpo-37520: Correct behavior for zipfile.Path.parent when the path object identifies a subdirectory.

  • bpo-18374: Fix the .col_offset attribute of nested ast.BinOp instances which had a too large value in some situations.

  • bpo-37424: Fixes a possible hang when using a timeout on subprocess.run() while capturing output. If the child process spawned its own children or otherwise connected its stdout or stderr handles with another process, we could hang after the timeout was reached and our child was killed when attempting to read final output from the pipes.

  • bpo-37421: Fix multiprocessing.util.get_temp_dir() finalizer: clear also the “tempdir” configuration of the current process, so next call to get_temp_dir() will create a new temporary directory, rather than reusing the removed temporary directory.

  • bpo-37481: The distutils bdist_wininst command is deprecated in Python 3.8, use bdist_wheel (wheel packages) instead.

  • bpo-37479: When Enum.__str__ is overridden in a derived class, the override will be used by Enum.__format__ regardless of whether mixin classes are present.

  • bpo-37440: http.client now enables TLS 1.3 post-handshake authentication for default context or if a cert_file is passed to HTTPSConnection.

  • bpo-37437: Update vendorized expat version to 2.2.7.

  • bpo-37428: SSLContext.post_handshake_auth = True no longer sets SSL_VERIFY_POST_HANDSHAKE verify flag for client connections. Although the option is documented as ignored for clients, OpenSSL implicitly enables cert chain validation when the flag is set.

  • bpo-37420: os.sched_setaffinity() now correctly handles errors that arise during iteration over its mask argument. Patch by Brandt Bucher.

  • bpo-37412: The os.getcwdb() function now uses the UTF-8 encoding on Windows, rather than the ANSI code page: see PEP 529 for the rationale. The function is no longer deprecated on Windows.

  • bpo-37406: The sqlite3 module now raises TypeError, rather than ValueError, if operation argument type is not str: execute(), executemany() and calling a connection.

  • bpo-29412: Fix IndexError in parsing a header value ending unexpectedly. Patch by Abhilash Raj.

  • bpo-36546: The dist argument for statistics.quantiles() is now positional only. The current name doesn’t reflect that the argument can be either a dataset or a distribution. Marking the parameter as positional avoids confusion and makes it possible to change the name later.

  • bpo-37394: Fix a bug that was causing the queue module to fail if the accelerator module was not available. Patch by Pablo Galindo.

  • bpo-37376: pprint now has support for types.SimpleNamespace. Patch by Carl Bordum Hansen.

  • bpo-26967: An ArgumentParser with allow_abbrev=False no longer disables grouping of short flags, such as -vv, but only disables abbreviation of long flags as documented. Patch by Zac Hatfield-Dodds.

  • bpo-37212: unittest.mock.call() now preserves the order of keyword arguments in repr output. Patch by Karthikeyan Singaravelan.

  • bpo-37372: Fix error unpickling datetime.time objects from Python 2 with seconds>=24. Patch by Justin Blanchard.

  • bpo-37345: Add formal support for UDPLITE sockets. Support was present before, but it is now easier to detect support with hasattr(socket, 'IPPROTO_UDPLITE') and there are constants defined for each of the values needed: socket.IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV, and UDPLITE_RECV_CSCOV. Patch by Gabe Appleton.

  • bpo-37358: Optimized functools.partial by using vectorcall.

  • bpo-37347: sqlite3.Connection.create_aggregate(), sqlite3.Connection.create_function(), sqlite3.Connection.set_authorizer(), sqlite3.Connection.set_progress_handler() sqlite3.Connection.set_trace_callback() methods lead to segfaults if some of these methods are called twice with an equal object but not the same. Now callbacks are stored more carefully. Patch by Aleksandr Balezin.

  • bpo-37163: The obj argument of dataclasses.replace() is positional-only now.

  • bpo-37085: Add the optional Linux SocketCAN Broadcast Manager constants, used as flags to configure the BCM behaviour, in the socket module. Patch by Karl Ding.

  • bpo-37328: HTMLParser.unescape is removed. It was undocumented and deprecated since Python 3.4.

  • bpo-37305: Add .webmanifest -> application/manifest+json to list of recognized file types and content type headers

  • bpo-37320: aifc.openfp() alias to aifc.open(), sunau.openfp() alias to sunau.open(), and wave.openfp() alias to wave.open() have been removed. They were deprecated since Python 3.7.

  • bpo-37315: Deprecated accepting floats with integral value (like 5.0) in math.factorial().

  • bpo-37312: _dummy_thread and dummy_threading modules have been removed. These modules were deprecated since Python 3.7 which requires threading support.

  • bpo-33972: Email with single part but content-type set to multipart/* doesn’t raise AttributeError anymore.

  • bpo-37280: Use threadpool for reading from file for sendfile fallback mode.

  • bpo-37279: Fix asyncio sendfile support when sendfile sends extra data in fallback mode.

  • bpo-19865: ctypes.create_unicode_buffer() now also supports non-BMP characters on platforms with 16-bit wchar_t (for example, Windows and AIX).

  • bpo-37266: In a subinterpreter, spawning a daemon thread now raises an exception. Daemon threads were never supported in subinterpreters. Previously, the subinterpreter finalization crashed with a Python fatal error if a daemon thread was still running.

  • bpo-37210: Allow pure Python implementation of pickle to work even when the C _pickle module is unavailable.

  • bpo-21872: Fix lzma: module decompresses data incompletely. When decompressing a FORMAT_ALONE format file, and it doesn’t have the end marker, sometimes the last one to dozens bytes can’t be output. Patch by Ma Lin.

  • bpo-35922: Fix RobotFileParser.crawl_delay() and RobotFileParser.request_rate() to return None rather than raise AttributeError when no relevant rule is defined in the robots.txt file. Patch by Rémi Lapeyre.

  • bpo-35766: Change the format of feature_version to be a (major, minor) tuple.

  • bpo-36607: Eliminate RuntimeError raised by asyncio.all_tasks() if internal tasks weak set is changed by another thread during iteration.

  • bpo-18748: _pyio.IOBase destructor now does nothing if getting the closed attribute fails to better mimic _io.IOBase finalizer.

  • bpo-36402: Fix a race condition at Python shutdown when waiting for threads. Wait until the Python thread state of all non-daemon threads get deleted (join all non-daemon threads), rather than just wait until non-daemon Python threads complete.

  • bpo-37206: Default values which cannot be represented as Python objects no longer improperly represented as None in function signatures.

  • bpo-37111: Added encoding and errors keyword parameters to logging.basicConfig.

  • bpo-12144: Ensure cookies with expires attribute are handled in CookieJar.make_cookies().

  • bpo-34886: Fix an unintended ValueError from subprocess.run() when checking for conflicting input and stdin or capture_output and stdout or stderr args when they were explicitly provided but with None values within a passed in **kwargs dict rather than as passed directly by name. Patch contributed by Rémi Lapeyre.

  • bpo-37173: The exception message for inspect.getfile() now correctly reports the passed class rather than the builtins module.

  • bpo-37178: Give math.perm() a one argument form that means the same as math.factorial().

  • bpo-37178: For math.perm(n, k), let k default to n, giving the same result as factorial.

  • bpo-37165: Converted _collections._count_elements to use the Argument Clinic.

  • bpo-34767: Do not always create a collections.deque in asyncio.Lock.

  • bpo-37158: Speed-up statistics.fmean() by switching from a function to a generator.

  • bpo-34282: Remove Enum._convert method, deprecated in 3.8.

  • bpo-37150: argparse._ActionsContainer.add_argument now throws error, if someone accidentally pass FileType class object instead of instance of FileType as type argument.

  • bpo-28724: The socket module now has the socket.send_fds() and socket.recv.fds() methods. Contributed by Joannah Nanjekye, Shinya Okano and Victor Stinner.

  • bpo-35621: Support running asyncio subprocesses when execution event loop in a thread on UNIX.

  • bpo-36520: Lengthy email headers with UTF-8 characters are now properly encoded when they are folded. Patch by Jeffrey Kintscher.

  • bpo-30835: Fixed a bug in email parsing where a message with invalid bytes in content-transfer-encoding of a multipart message can cause an AttributeError. Patch by Andrew Donnellan.

  • bpo-31163: pathlib.Path instance’s rename and replace methods now return the new Path instance.

  • bpo-25068: urllib.request.ProxyHandler now lowercases the keys of the passed dictionary.

  • bpo-26185: Fix repr() on empty ZipInfo object. Patch by Mickaël Schoentgen.

  • bpo-21315: Email headers containing RFC2047 encoded words are parsed despite the missing whitespace, and a defect registered. Also missing trailing whitespace after encoded words is now registered as a defect.

  • bpo-31904: Port test_datetime to VxWorks: skip zoneinfo tests on VxWorks

  • bpo-35805: Add parser for Message-ID header and add it to default HeaderRegistry. This should prevent folding of Message-ID using RFC 2048 encoded words.

  • bpo-36871: Ensure method signature is used instead of constructor signature of a class while asserting mock object against method calls. Patch by Karthikeyan Singaravelan.

  • bpo-35070: posix.getgrouplist() now works correctly when the user belongs to NGROUPS_MAX supplemental groups. Patch by Jeffrey Kintscher.

  • bpo-31783: Fix race condition in ThreadPoolExecutor when worker threads are created during interpreter shutdown.

  • bpo-36582: Fix UserString.encode() to correctly return bytes rather than a UserString instance.

  • bpo-32424: Deprecate xml.etree.ElementTree.Element.copy() in favor of copy.copy().

    Patch by Gordon P. Hemsley

  • bpo-36564: Fix infinite loop in email header folding logic that would be triggered when an email policy’s max_line_length is not long enough to include the required markup and any values in the message. Patch by Paul Ganssle

  • bpo-36543: Removed methods Element.getchildren(), Element.getiterator() and ElementTree.getiterator() and the xml.etree.cElementTree module.

  • bpo-36409: Remove the old plistlib API deprecated in Python 3.4

  • bpo-36302: distutils sorts source file lists so that Extension .so files build more reproducibly by default

  • bpo-36250: Ignore ValueError from signal with interaction in non-main thread.

  • bpo-36046: Added user, group and extra_groups parameters to the subprocess.Popen constructor. Patch by Patrick McLean.

  • bpo-32627: Fix compile error when _uuid headers conflicting included.

  • bpo-35800: Deprecate smtpd.MailmanProxy ready for future removal.

  • bpo-35168: shlex.shlex.punctuation_chars is now a read-only property.

  • bpo-8538: Add support for boolean actions like --foo and --no-foo to argparse. Patch contributed by Rémi Lapeyre.

  • bpo-20504: Fixes a bug in cgi module when a multipart/form-data request has no Content-Length header.

  • bpo-25988: The abstract base classes in collections.abc no longer are exposed in the regular collections module.

  • bpo-11122: Distutils won’t check for rpmbuild in specified paths only.

  • bpo-34775: Division handling of PurePath now returns NotImplemented instead of raising a TypeError when passed something other than an instance of str or PurePath. Patch by Roger Aiudi.

  • bpo-34749: binascii.a2b_base64() is now up to 2 times faster. Patch by Sergey Fedoseev.

  • bpo-34519: Add additional aliases for HP Roman 8. Patch by Michael Osipov.

  • bpo-28009: Fix uuid.getnode() on platforms with “.” as MAC Addr delimiter as well fix for MAC Addr format that omits a leading 0 in MAC Addr values. Currently, AIX is the only know platform with these settings. Patch by Michael Felt.

  • bpo-30618: Add readlink(). Patch by Girts Folkmanis.

  • bpo-32498: Made urllib.parse.unquote() accept bytes in addition to strings. Patch by Stein Karlsen.

  • bpo-33348: lib2to3 now recognizes expressions after * and ** like in f(*[] or []).

  • bpo-32689: Update shutil.move() function to allow for Path objects to be used as source argument. Patch by Emily Morehouse and Maxwell «5.13b» McKinnon.

  • bpo-32820: Added __format__ to IPv4 and IPv6 classes. Always outputs a fully zero-padded string. Supports b/x/n modifiers (bin/hex/native format). Native format for IPv4 is bin, native format for IPv6 is hex. Also supports “#” and “_” modifiers.

  • bpo-27657: Fix urllib.parse.urlparse() with numeric paths. A string like «path:80» is no longer parsed as a path but as a scheme («path») and a path («80»).

  • bpo-4963: Fixed non-deterministic behavior related to mimetypes extension mapping and module reinitialization.

Documentation

  • bpo-21767: Explicitly mention abc support in functools.singledispatch

  • bpo-38816: Provides more details about the interaction between fork() and CPython’s runtime, focusing just on the C-API. This includes cautions about where fork() should and shouldn’t be called.

  • bpo-38351: Modernize email examples from %-formatting to f-strings.

  • bpo-38778: Document the fact that RuntimeError is raised if os.fork() is called in a subinterpreter.

  • bpo-38592: Add Brazilian Portuguese to the language switcher at Python Documentation website.

  • bpo-38294: Add list of no-longer-escaped chars to re.escape documentation

  • bpo-38053: Modernized the plistlib documentation

  • bpo-26868: Fix example usage of PyModule_AddObject() to properly handle errors.

  • bpo-36797: Fix a dead link in the distutils API Reference.

  • bpo-37977: Warn more strongly and clearly about pickle insecurity

  • bpo-37979: Added a link to dateutil.parser.isoparse in the datetime.fromisoformat documentation. Patch by Paul Ganssle

  • bpo-12707: Deprecate info(), geturl(), getcode() methods in favor of the headers, url, and status properties, respectively, for HTTPResponse and addinfourl. Also deprecate the code attribute of addinfourl in favor of the status attribute. Patch by Ashwin Ramaswami

  • bpo-37937: Mention frame.f_trace in sys.settrace() docs.

  • bpo-37878: Make PyThreadState_DeleteCurrent() Internal.

  • bpo-37759: Beginning edits to Whatsnew 3.8

  • bpo-37726: Stop recommending getopt in the tutorial for command line argument parsing and promote argparse.

  • bpo-32910: Remove implementation-specific behaviour of how venv’s Deactivate works.

  • bpo-37256: Fix wording of arguments for Request in urllib.request

  • bpo-37284: Add a brief note to indicate that any new sys.implementation required attributes must go through the PEP process.

  • bpo-30088: Documented that mailbox.Maildir constructor doesn’t attempt to verify the maildir folder layout correctness. Patch by Sviatoslav Sydorenko.

  • bpo-37521: Fix importlib examples to insert any newly created modules via importlib.util.module_from_spec() immediately into sys.modules instead of after calling loader.exec_module().

    Thanks to Benjamin Mintz for finding the bug.

  • bpo-37456: Slash (“/”) is now part of syntax.

  • bpo-37487: Fix PyList_GetItem index description to include 0.

  • bpo-37149: Replace the dead link to the Tkinter 8.5 reference by John Shipman, New Mexico Tech, with a link to the archive.org copy.

  • bpo-37478: Added possible exceptions to the description of os.chdir().

  • bpo-34903: Documented that in datetime.datetime.strptime(), the leading zero in some two-digit formats is optional. Patch by Mike Gleen.

  • bpo-36260: Add decompression pitfalls to zipfile module documentation.

  • bpo-37004: In the documentation for difflib, a note was added explicitly warning that the results of SequenceMatcher’s ratio method may depend on the order of the input strings.

  • bpo-36960: Restructured the datetime docs in the interest of making them more user-friendly and improving readability. Patch by Brad Solomon.

  • bpo-36487: Make C-API docs clear about what the «main» interpreter is.

  • bpo-23460: The documentation for decimal string formatting using the :g specifier has been updated to reflect the correct exponential notation cutoff point. Original patch contributed by Tuomas Suutari.

  • bpo-35803: Document and test that tempfile functions may accept a path-like object for the dir argument. Patch by Anthony Sottile.

  • bpo-33944: Added a note about the intended use of code in .pth files.

  • bpo-34293: Fix the Doc/Makefile regarding PAPER environment variable and PDF builds

  • bpo-25237: Add documentation for tkinter modules

Tests

  • bpo-38614: Fix test_communicate() of test_asyncio.test_subprocess: use support.LONG_TIMEOUT (5 minutes), instead of just 1 minute.

  • bpo-38614: Add timeout constants to test.support: LOOPBACK_TIMEOUT, INTERNET_TIMEOUT, SHORT_TIMEOUT and LONG_TIMEOUT.

  • bpo-38502: test.regrtest now uses process groups in the multiprocessing mode (-jN command line option) if process groups are available: if os.setsid() and os.killpg() functions are available.

  • bpo-35998: Fix a race condition in test_asyncio.test_start_tls_server_1(). Previously, there was a race condition between the test main() function which replaces the protocol and the test ServerProto protocol which sends ANSWER once it gets HELLO. Now, only the test main() function is responsible to send data, ServerProto no longer sends data.

  • bpo-38470: Fix test_compileall.test_compile_dir_maxlevels() on Windows without long path support: only create 3 subdirectories instead of between 20 and 100 subdirectories.

  • bpo-37531: On timeout, regrtest no longer attempts to call popen.communicate() again: it can hang until all child processes using stdout and stderr pipes completes. Kill the worker process and ignores its output. Change also the faulthandler timeout of the main process from 1 minute to 5 minutes, for Python slowest buildbots.

  • bpo-38239: Fix test_gdb for Link Time Optimization (LTO) builds.

  • bpo-38275: test_ssl now handles disabled TLS/SSL versions better. OpenSSL’s crypto policy and run-time settings are recognized and tests for disabled versions are skipped. Tests also accept more TLS minimum_versions for platforms that override OpenSSL’s default with strict settings.

  • bpo-38271: The private keys for test_ssl were encrypted with 3DES in traditional PKCS#5 format. 3DES and the digest algorithm of PKCS#5 are blocked by some strict crypto policies. Use PKCS#8 format with AES256 encryption instead.

  • bpo-38270: test.support now has a helper function to check for availability of a hash digest function. Several tests are refactored avoid MD5 and use SHA256 instead. Other tests are marked to use MD5 and skipped when MD5 is disabled.

  • bpo-37123: Multiprocessing test test_mymanager() now also expects -SIGTERM, not only exitcode 0. BaseManager._finalize_manager() sends SIGTERM to the manager process if it takes longer than 1 second to stop, which happens on slow buildbots.

  • bpo-38212: Multiprocessing tests: increase test_queue_feeder_donot_stop_onexc() timeout from 1 to 60 seconds.

  • bpo-38117: Test with OpenSSL 1.1.1d

  • bpo-38018: Increase code coverage for multiprocessing.shared_memory.

  • bpo-37805: Add tests for json.dump(…, skipkeys=True). Patch by Donghee Na.

  • bpo-37531: Enhance regrtest multiprocess timeout: write a message when killing a worker process, catch popen.kill() and popen.wait() exceptions, put a timeout on the second call to popen.communicate().

  • bpo-37876: Add tests for ROT-13 codec.

  • bpo-36833: Added tests for PyDateTime_xxx_GET_xxx() macros of the C API of the datetime module. Patch by Joannah Nanjekye.

  • bpo-37558: Fix test_shared_memory_cleaned_after_process_termination name handling

  • bpo-37526: Add test.support.catch_threading_exception(): context manager catching threading.Thread exception using threading.excepthook().

  • bpo-37421: test_concurrent_futures now explicitly stops the ForkServer instance if it’s running.

  • bpo-37421: multiprocessing tests now stop the ForkServer instance if it’s running: close the «alive» file descriptor to ask the server to stop and then remove its UNIX address.

  • bpo-37421: test_distutils.test_build_ext() is now able to remove the temporary directory on Windows: don’t import the newly built C extension («xx») in the current process, but test it in a separated process.

  • bpo-37421: test_concurrent_futures now cleans up multiprocessing to remove immediately temporary directories created by multiprocessing.util.get_temp_dir().

  • bpo-37421: test_winconsoleio doesn’t leak a temporary file anymore: use tempfile.TemporaryFile() to remove it when the test completes.

  • bpo-37421: multiprocessing tests now explicitly call _run_finalizers() to immediately remove temporary directories created by tests.

  • bpo-37421: urllib.request tests now call urlcleanup() to remove temporary files created by urlretrieve() tests and to clear the _opener global variable set by urlopen() and functions calling indirectly urlopen().

  • bpo-37472: Remove Lib/test/outstanding_bugs.py.

  • bpo-37199: Fix test failures when IPv6 is unavailable or disabled.

  • bpo-19696: Replace deprecated method «random.choose» with «random.choice» in «test_pkg_import.py».

  • bpo-37335: Remove no longer necessary code from c locale coercion tests

  • bpo-37421: Fix test_shutil to no longer leak temporary files.

  • bpo-37411: Fix test_wsgiref.testEnviron() to no longer depend on the environment variables (don’t fail if «X» variable is set).

  • bpo-37400: Fix test_os.test_chown(): use os.getgroups() rather than grp.getgrall() to get groups. Rename also the test to test_chown_gid().

  • bpo-37359: Add –cleanup option to python3 -m test to remove test_python_* directories of previous failed jobs. Add «make cleantest» to run python3 -m test --cleanup.

  • bpo-37362: test_gdb no longer fails if it gets an «unexpected» message on stderr: it now ignores stderr. The purpose of test_gdb is to test that python-gdb.py commands work as expected, not to test gdb.

  • bpo-35998: Avoid TimeoutError in test_asyncio: test_start_tls_server_1()

  • bpo-37278: Fix test_asyncio ProactorLoopCtrlC: join the thread to prevent leaking a running thread and leaking a reference.

  • bpo-37261: Fix test.support.catch_unraisable_exception(): its __exit__() method now ignores unraisable exception raised when clearing its unraisable attribute.

  • bpo-37069: regrtest now uses sys.unraisablehook() to mark a test as «environment altered» (ENV_CHANGED) if it emits an «unraisable exception». Moreover, regrtest logs a warning in this case.

    Use python3 -m test --fail-env-changed to catch unraisable exceptions in tests.

  • bpo-37252: Fix assertions in test_close and test_events_mask_overflow devpoll tests.

  • bpo-37169: Rewrite _PyObject_IsFreed() unit tests.

  • bpo-37153: test_venv.test_multiprocessing() now explicitly calls pool.terminate() to wait until the pool completes.

  • bpo-34001: Make test_ssl pass with LibreSSL. LibreSSL handles minimum and maximum TLS version differently than OpenSSL.

  • bpo-36919: Make test_source_encoding.test_issue2301 implementation independent. The test will work now for both CPython and IronPython.

  • bpo-30202: Update test.test_importlib.test_abc to test find_spec().

  • bpo-28009: Modify the test_uuid logic to test when a program is available AND can be used to obtain a MACADDR as basis for an UUID. Patch by M. Felt

  • bpo-34596: Fallback to a default reason when unittest.skip() is uncalled. Patch by Naitree Zhu.

Build

  • bpo-38809: On Windows, build scripts will now recognize and use python.exe from an active virtual env.

  • bpo-38684: Fix _hashlib build when Blake2 is disabled, but OpenSSL supports it.

  • bpo-38468: Misc/python-config.in now uses getvar() for all still existing sysconfig.get_config_var() calls. Patch by Joannah Nanjekye.

  • bpo-37415: Fix stdatomic.h header check for ICC compiler: the ICC implementation lacks atomic_uintptr_t type which is needed by Python.

  • bpo-38301: In Solaris family, we must be sure to use -D_REENTRANT. Patch by Jesús Cea Avión.

  • bpo-36002: Locate llvm-profdata and llvm-ar binaries using AC_PATH_TOOL rather than AC_PATH_TARGET_TOOL.

  • bpo-37936: The .gitignore file systematically keeps «rooted», with a non-trailing slash, all the rules that are meant to apply to files in a specific place in the repo. Previously, when the intended file to ignore happened to be at the root of the repo, we’d most often accidentally also ignore files and directories with the same name anywhere in the tree.

  • bpo-37760: The Tools/unicode/makeunicodedata.py script, which is used for converting information from the Unicode Character Database into generated code and data used by the methods of str and by the unicodedata module, now handles each character’s data as a dataclass with named attributes, rather than a length-18 list of different fields.

  • bpo-37936: The .gitignore file no longer applies to any files that are in fact tracked in the Git repository. Patch by Greg Price.

  • bpo-37725: Change «clean» makefile target to also clean the program guided optimization (PGO) data. Previously you would have to use «make clean» and «make profile-removal», or «make clobber».

  • bpo-37707: Mark some individual tests to skip when –pgo is used. The tests marked increase the PGO task time significantly and likely don’t help improve optimization of the final executable.

  • bpo-36044: Reduce the number of unit tests run for the PGO generation task. This speeds up the task by a factor of about 15x. Running the full unit test suite is slow. This change may result in a slightly less optimized build since not as many code branches will be executed. If you are willing to wait for the much slower build, the old behavior can be restored using “./configure [..] PROFILE_TASK=»-m test –pgo-extended»”. We make no guarantees as to which PGO task set produces a faster build. Users who care should run their own relevant benchmarks as results can depend on the environment, workload, and compiler tool chain.

  • bpo-37468: make install no longer installs wininst-*.exe files used by distutils bdist_wininst: bdist_wininst only works on Windows.

  • bpo-37189: Many PyRun_XXX() functions like PyRun_String() were no longer exported in libpython38.dll by mistake. Export them again to fix the ABI compatibility.

  • bpo-25361: Enables use of SSE2 instructions in Windows 32-bit build.

  • bpo-36210: Update optional extension module detection for AIX. ossaudiodev and spwd are not applicable for AIX, and are no longer reported as missing. 3rd-party packaging of ncurses (with ASIS support) conflicts with officially supported AIX curses library, so configure AIX to use libcurses.a. However, skip trying to build _curses_panel.

    patch by M Felt

Windows

  • bpo-38589: Fixes HTML Help shortcut when Windows is not installed to C drive

  • bpo-38453: Ensure ntpath.realpath() correctly resolves relative paths.

  • bpo-38519: Restores the internal C headers that were missing from the nuget.org and Microsoft Store packages.

  • bpo-38492: Remove pythonw.exe dependency on the Microsoft C++ runtime.

  • bpo-38344: Fix error message in activate.bat

  • bpo-38359: Ensures pyw.exe launcher reads correct registry key.

  • bpo-38355: Fixes ntpath.realpath failing on sys.executable.

  • bpo-38117: Update bundled OpenSSL to 1.1.1d

  • bpo-38092: Reduce overhead when using multiprocessing in a Windows virtual environment.

  • bpo-38133: Allow py.exe launcher to locate installations from the Microsoft Store and improve display of active virtual environments.

  • bpo-38114: The pip.ini is no longer included in the Nuget package.

  • bpo-32592: Set Windows 8 as the minimum required version for API support

  • bpo-36634: os.cpu_count() now returns active processors rather than maximum processors.

  • bpo-36634: venv activate.bat now works when the existing variables contain double quote characters.

  • bpo-38081: Prevent error calling os.path.realpath() on 'NUL'.

  • bpo-38087: Fix case sensitivity in test_pathlib and test_ntpath.

  • bpo-38088: Fixes distutils not finding vcruntime140.dll with only the v142 toolset installed.

  • bpo-37283: Ensure command-line and unattend.xml setting override previously detected states in Windows installer.

  • bpo-38030: Fixes os.stat() failing for block devices on Windows

  • bpo-38020: Fixes potential crash when calling os.readlink() (or indirectly through realpath()) on a file that is not a supported link.

  • bpo-37705: Improve the implementation of winerror_to_errno().

  • bpo-37549: os.dup() no longer fails for standard streams on Windows 7.

  • bpo-1311: The nul file on Windows now returns True from exists() and a valid result from os.stat() with S_IFCHR set.

  • bpo-9949: Enable support for following symlinks in os.realpath().

  • bpo-37834: Treat all name surrogate reparse points on Windows in os.lstat() and other reparse points as regular files in os.stat().

  • bpo-36266: Add the module name in the formatted error message when DLL load fail happens during module import in _PyImport_FindSharedFuncptrWindows(). Patch by Srinivas Nyayapati.

  • bpo-25172: Trying to import the crypt module on Windows will result in an ImportError with a message explaining that the module isn’t supported on Windows. On other platforms, if the underlying _crypt module is not available, the ImportError will include a message explaining the problem.

  • bpo-37778: Fixes the icons used for file associations to the Microsoft Store package.

  • bpo-37734: Fix use of registry values to launch Python from Microsoft Store app.

  • bpo-37702: Fix memory leak on Windows in creating an SSLContext object or running urllib.request.urlopen('https://...').

  • bpo-37672: Switch Windows Store package’s pip to use bundled pip.ini instead of PIP_USER variable.

  • bpo-10945: Officially drop support for creating bdist_wininst installers on non-Windows systems.

  • bpo-37445: Include the FORMAT_MESSAGE_IGNORE_INSERTS flag in FormatMessageW() calls.

  • bpo-37369: Fixes path for sys.executable when running from the Microsoft Store.

  • bpo-37380: Don’t collect unfinished processes with subprocess._active on Windows to cleanup later. Patch by Ruslan Kuprieiev.

  • bpo-37351: Removes libpython38.a from standard Windows distribution.

  • bpo-35360: Update Windows builds to use SQLite 3.28.0.

  • bpo-37267: On Windows, os.dup() no longer creates an inheritable fd when handling a character file.

  • bpo-36779: Ensure time.tzname is correct on Windows when the active code page is set to CP_UTF7 or CP_UTF8.

  • bpo-32587: Make winreg.REG_MULTI_SZ support zero-length strings.

  • bpo-28269: Replace use of strcasecmp() for the system function _stricmp(). Patch by Minmin Gong.

  • bpo-36590: Add native Bluetooth RFCOMM support to socket module.

macOS

  • bpo-38117: Updated OpenSSL to 1.1.1d in macOS installer.

  • bpo-38089: Move Azure Pipelines to latest VM versions and make macOS tests optional

  • bpo-18049: Increase the default stack size of threads from 5MB to 16MB on macOS, to match the stack size of the main thread. This avoids crashes on deep recursion in threads.

  • bpo-34602: Avoid test suite failures on macOS by no longer calling resource.setrlimit to increase the process stack size limit at runtime. The runtime change is no longer needed since the interpreter is being built with a larger default stack size.

  • bpo-35360: Update macOS installer to use SQLite 3.28.0.

  • bpo-34631: Updated OpenSSL to 1.1.1c in macOS installer.

IDLE

  • bpo-26353: Stop adding newline when saving an IDLE shell window.

  • bpo-4630: Add an option to toggle IDLE’s cursor blink for shell, editor, and output windows. See Settings, General, Window Preferences, Cursor Blink. Patch by Zackery Spytz.

  • bpo-38598: Do not try to compile IDLE shell or output windows

  • bpo-36698: IDLE no longer fails when write non-encodable characters to stderr. It now escapes them with a backslash, as the regular Python interpreter. Added the errors field to the standard streams.

  • bpo-35379: When exiting IDLE, catch any AttributeError. One happens when EditorWindow.close is called twice. Printing a traceback, when IDLE is run from a terminal, is useless and annoying.

  • bpo-38183: To avoid problems, test_idle ignores the user config directory. It no longer tries to create or access .idlerc or any files within. Users must run IDLE to discover problems with saving settings.

  • bpo-38077: IDLE no longer adds “argv” to the user namespace when initializing it. This bug only affected 3.7.4 and 3.8.0b2 to 3.8.0b4.

  • bpo-38041: Shell restart lines now fill the window width, always start with “=”, and avoid wrapping unnecessarily. The line will still wrap if the included file name is long relative to the width.

  • bpo-35771: To avoid occasional spurious test_idle failures on slower machines, increase the hover_delay in test_tooltip.

  • bpo-37824: Properly handle user input warnings in IDLE shell. Cease turning SyntaxWarnings into SyntaxErrors.

  • bpo-37929: IDLE Settings dialog now closes properly when there is no shell window.

  • bpo-37902: Add mousewheel scrolling for IDLE module, path, and stack browsers. Patch by George Zhang.

  • bpo-37849: Fixed completions list appearing too high or low when shown above the current line.

  • bpo-36419: Refactor IDLE autocomplete and improve testing.

  • bpo-37748: Reorder the Run menu. Put the most common choice, Run Module, at the top.

  • bpo-37692: Improve highlight config sample with example shell interaction and better labels for shell elements.

  • bpo-37628: Settings dialog no longer expands with font size.

  • bpo-37627: Initialize the Customize Run dialog with the command line arguments most recently entered before. The user can optionally edit before submitting them.

  • bpo-33610: Fix code context not showing the correct context when first toggled on.

  • bpo-37530: Optimize code context to reduce unneeded background activity. Font and highlight changes now occur along with text changes instead of after a random delay.

  • bpo-27452: Cleanup config.py by inlining RemoveFile and simplifying the handling of file in CreateConfigHandlers.

  • bpo-37325: Fix tab focus traversal order for help source and custom run dialogs.

  • bpo-37321: Both subprocess connection error messages now refer to the “Startup failure” section of the IDLE doc.

  • bpo-17535: Add optional line numbers for IDLE editor windows. Windows open without line numbers unless set otherwise in the General tab of the configuration dialog.

  • bpo-26806: To compensate for stack frames added by IDLE and avoid possible problems with low recursion limits, add 30 to limits in the user code execution process. Subtract 30 when reporting recursion limits to make this addition mostly transparent.

  • bpo-37177: Properly “attach” search dialogs to their main window so that they behave like other dialogs and do not get hidden behind their main window.

  • bpo-37039: Adjust «Zoom Height» to individual screens by momentarily maximizing the window on first use with a particular screen. Changing screen settings may invalidate the saved height. While a window is maximized, «Zoom Height» has no effect.

  • bpo-35763: Make calltip reminder about “/” meaning positional-only less obtrusive by only adding it when there is room on the first line.

  • bpo-5680: Add “Run… Customized” to the Run menu to run a module with customized settings. Any “command line arguments” entered are added to sys.argv. One can suppress the normal Shell main module restart.

  • bpo-36390: Gather Format menu functions into format.py. Combine paragraph.py, rstrip.py, and format methods from editor.py.

Tools/Demos

  • bpo-38118: Update Valgrind suppression file to ignore a false alarm in PyUnicode_Decode() when using GCC builtin strcmp().

  • bpo-38347: pathfix.py: Assume all files that end on “.py” are Python scripts when working recursively.

  • bpo-37803: pdb’s --help and --version long options now work.

  • bpo-37942: Improve ArgumentClinic converter for floats.

  • bpo-37704: Remove Tools/scripts/h2py.py: use cffi to access a C API in Python.

  • bpo-37675: 2to3 now works when run from a zipped standard library.

  • bpo-37034: Argument Clinic now uses the argument name on errors with keyword-only argument instead of their position. Patch contributed by Rémi Lapeyre.

  • bpo-37064: Add option -k to pathscript.py script: preserve shebang flags. Add option -a to pathscript.py script: add flags.

C API

  • bpo-37633: Re-export some function compatibility wrappers for macros in pythonrun.h.

  • bpo-38644: Provide Py_EnterRecursiveCall() and Py_LeaveRecursiveCall() as regular functions for the limited API. Previously, there were defined as macros, but these macros didn’t work with the limited API which cannot access PyThreadState.recursion_depth field. Remove _Py_CheckRecursionLimit from the stable ABI.

  • bpo-38650: The global variable PyStructSequence_UnnamedField is now a constant and refers to a constant string.

  • bpo-38540: Fixed possible leak in PyArg_Parse() and similar functions for format units "es#" and "et#" when the macro PY_SSIZE_T_CLEAN is not defined.

  • bpo-38395: Fix a crash in weakref.proxy objects due to incorrect lifetime management when calling some associated methods that may delete the last reference to object being referenced by the proxy. Patch by Pablo Galindo.

  • bpo-36389: The _PyObject_CheckConsistency() function is now also available in release mode. For example, it can be used to debug a crash in the visit_decref() function of the GC.

  • bpo-38266: Revert the removal of PyThreadState_DeleteCurrent() with documentation.

  • bpo-38303: Update audioop extension module to use the stable ABI (PEP-384). Patch by Tyler Kieft.

  • bpo-38234: Py_SetPath() now sets sys.executable to the program full path (Py_GetProgramFullPath()) rather than to the program name (Py_GetProgramName()).

  • bpo-38234: Python ignored arguments passed to Py_SetPath(), Py_SetPythonHome() and Py_SetProgramName(): fix Python initialization to use specified arguments.

  • bpo-38205: The Py_UNREACHABLE() macro now calls Py_FatalError().

  • bpo-38140: Make dict and weakref offsets opaque for C heap types by passing the offsets through PyMemberDef

  • bpo-15088: The C function PyGen_NeedsFinalizing has been removed. It was not documented, tested or used anywhere within CPython after the implementation of PEP 442. Patch by Joannah Nanjekye. (Patch by Joannah Nanjekye)

  • bpo-36763: Options added by PySys_AddXOption() are now handled the same way than PyConfig.xoptions and command line -X options.

  • bpo-37926: Fix a crash in PySys_SetArgvEx(0, NULL, 0).

  • bpo-37879: Fix subtype_dealloc to suppress the type decref when the base type is a C heap type

  • bpo-37645: Add _PyObject_FunctionStr() to get a user-friendly string representation of a function-like object. Patch by Jeroen Demeyer.

  • bpo-29548: The functions PyEval_CallObject, PyEval_CallFunction, PyEval_CallMethod and PyEval_CallObjectWithKeywords are deprecated. Use PyObject_Call() and its variants instead.

  • bpo-37151: PyCFunction_Call is now a deprecated alias of PyObject_Call().

  • bpo-37540: The vectorcall protocol now requires that the caller passes only strings as keyword names.

  • bpo-37207: The vectorcall protocol is now enabled for type objects: set tp_vectorcall to a vectorcall function to be used instead of tp_new and tp_init when calling the class itself.

  • bpo-21120: Exclude Python-ast.h, ast.h and asdl.h from the limited API.

  • bpo-37483: Add new function _PyObject_CallOneArg for calling an object with one positional argument.

  • bpo-36763: Add PyConfig_SetWideStringList() function.

  • bpo-37337: Add fast functions for calling methods: _PyObject_VectorcallMethod(), _PyObject_CallMethodNoArgs() and _PyObject_CallMethodOneArg().

  • bpo-28805: The METH_FASTCALL calling convention has been documented.

  • bpo-37221: The new function PyCode_NewWithPosOnlyArgs() allows to create code objects like PyCode_New(), but with an extra posonlyargcount parameter for indicating the number of positonal-only arguments.

  • bpo-37215: Fix dtrace issue introduce by bpo-36842

  • bpo-37194: Add a new public PyObject_CallNoArgs() function to the C API: call a callable Python object without any arguments. It is the most efficient way to call a callback without any argument. On x86-64, for example, PyObject_CallFunctionObjArgs(func, NULL) allocates 960 bytes on the stack per call, whereas PyObject_CallNoArgs(func) only allocates 624 bytes per call.

  • bpo-37170: Fix the cast on error in PyLong_AsUnsignedLongLongMask().

  • bpo-35381: Convert posixmodule.c statically allocated types DirEntryType and ScandirIteratorType to heap-allocated types.

  • bpo-34331: Use singular/plural noun in error message when instantiating an abstract class with non-overridden abstract method(s).

Python 3.8.0 beta 1

Release date: 2019-06-04

Security

  • bpo-35907: CVE 2019-9948: Avoid file reading by disallowing local-file:// and local_file:// URL schemes in URLopener().open() and URLopener().retrieve() of urllib.request.

  • bpo-33529: Prevent fold function used in email header encoding from entering infinite loop when there are too many non-ASCII characters in a header.

  • bpo-33164: Updated blake2 implementation which uses secure memset implementation provided by platform.

Core and Builtins

  • bpo-35814: Allow unpacking in the right hand side of annotated assignments. In particular, t: Tuple[int, ...] = x, y, *z is now allowed.

  • bpo-37126: All structseq objects are now tracked by the garbage collector. Patch by Pablo Galindo.

  • bpo-37122: Make the co_argcount attribute of code objects represent the total number of positional arguments (including positional-only arguments). The value of co_posonlyargcount can be used to distinguish which arguments are positional only, and the difference (co_argcount - co_posonlyargcount) is the number of positional-or-keyword arguments. Patch by Pablo Galindo.

  • bpo-20092: Constructors of int, float and complex will now use the __index__() special method, if available and the corresponding method __int__(), __float__() or __complex__() is not available.

  • bpo-37087: Add native thread ID (TID) support to OpenBSD.

  • bpo-26219: Implemented per opcode cache mechanism and LOAD_GLOBAL instruction use it. LOAD_GLOBAL is now about 40% faster. Contributed by Yury Selivanov, and Inada Naoki.

  • bpo-37072: Fix crash in PyAST_FromNodeObject() when flags is NULL.

  • bpo-37029: Freeing a great many small objects could take time quadratic in the number of arenas, due to using linear search to keep obmalloc.c’s list of usable arenas sorted by order of number of free memory pools. This is accomplished without search now, leaving the worst-case time linear in the number of arenas. For programs where this quite visibly matters (typically with more than 100 thousand small objects alive simultaneously), this can greatly reduce the time needed to release their memory.

  • bpo-26423: Fix possible overflow in wrap_lenfunc() when sizeof(long) < sizeof(Py_ssize_t) (e.g., 64-bit Windows).

  • bpo-37050: Improve the AST for «debug» f-strings, which use “=” to print out the source of the expression being evaluated. Delete expr_text from the FormattedValue node, and instead use a Constant string node (possibly merged with adjacent constant expressions inside the f-string).

  • bpo-22385: The bytes.hex, bytearray.hex, and memoryview.hex methods as well as the binascii.hexlify and b2a_hex functions now have the ability to include an optional separator between hex bytes. This functionality was inspired by MicroPython’s hexlify implementation.

  • bpo-26836: Add os.memfd_create().

  • bpo-37032: Added new replace() method to the code type (types.CodeType).

  • bpo-37007: Implement socket.if_nameindex(), socket.if_nametoindex(), and socket.if_indextoname() on Windows.

  • bpo-36829: PyErr_WriteUnraisable() now creates a traceback object if there is no current traceback. Moreover, call PyErr_NormalizeException() and PyException_SetTraceback() to normalize the exception value. Ignore any error.

  • bpo-36878: Only accept text after # type: ignore if the first character is ASCII. This is to disallow things like # type: ignoreé.

  • bpo-36878: Store text appearing after a # type: ignore comment in the AST. For example a type ignore like # type: ignore[E1000] will have the string "[E1000]" stored in its AST node.

  • bpo-2180: Treat line continuation at EOF as a SyntaxError by Anthony Sottile.

  • bpo-36907: Fix a crash when calling a C function with a keyword dict (f(**kwargs)) and changing the dict kwargs while that function is running.

  • bpo-36946: Fix possible signed integer overflow when handling slices.

  • bpo-36826: Add NamedExpression kind support to ast_unparse.c

  • bpo-1875: A SyntaxError is now raised if a code blocks that will be optimized away (e.g. if conditions that are always false) contains syntax errors. Patch by Pablo Galindo.

  • bpo-36027: Allow computation of modular inverses via three-argument pow: the second argument is now permitted to be negative in the case where the first and third arguments are relatively prime.

  • bpo-36861: Update the Unicode database to version 12.1.0.

  • bpo-28866: Avoid caching attributes of classes which type defines mro() to avoid a hard cache invalidation problem.

  • bpo-36851: The FrameType stack is now correctly cleaned up if the execution ends with a return and the stack is not empty.

  • bpo-34616: The compile() builtin functions now support the ast.PyCF_ALLOW_TOP_LEVEL_AWAIT flag, which allow to compile sources that contains top-level await, async with or async for. This is useful to evaluate async-code from with an already async functions; for example in a custom REPL.

  • bpo-36842: Implement PEP 578, adding sys.audit, io.open_code and related APIs.

  • bpo-27639: Correct return type for UserList slicing operations. Patch by Michael Blahay, Erick Cervantes, and vaultah

  • bpo-36737: Move PyRuntimeState.warnings into per-interpreter state (via «module state»).

  • bpo-36793: Removed __str__ implementations from builtin types bool, int, float, complex and few classes from the standard library. They now inherit __str__() from object.

  • bpo-36817: Add a = feature f-strings for debugging. This can precede !s, !r, or !a. It produces the text of the expression, followed by an equal sign, followed by the repr of the value of the expression. So f'{3*9+15=}' would be equal to the string '3*9+15=42'. If = is specified, the default conversion is set to !r, unless a format spec is given, in which case the formatting behavior is unchanged, and __format__ will be used.

  • bpo-24048: Save the live exception during import.c’s remove_module().

  • bpo-27987: pymalloc returns memory blocks aligned by 16 bytes, instead of 8 bytes, on 64-bit platforms to conform x86-64 ABI. Recent compilers assume this alignment more often. Patch by Inada Naoki.

  • bpo-36601: A long-since-meaningless check for getpid() == main_pid was removed from Python’s internal C signal handler.

  • bpo-36594: Fix incorrect use of %p in format strings. Patch by Zackery Spytz.

  • bpo-36045: builtins.help() now prefixes async for async functions.

  • bpo-36084: Add native thread ID (TID) to threading.Thread objects (supported platforms: Windows, FreeBSD, Linux, macOS)

  • bpo-36035: Added fix for broken symlinks in combination with pathlib

  • bpo-35983: Added new trashcan macros to deal with a double deallocation that could occur when the tp_dealloc of a subclass calls the tp_dealloc of a base class and that base class uses the trashcan mechanism. Patch by Jeroen Demeyer.

  • bpo-20602: Do not clear sys.flags and sys.float_info during shutdown. Patch by Zackery Spytz.

  • bpo-26826: Expose copy_file_range() as a low level API in the os module.

  • bpo-32388: Remove cross-version binary compatibility requirement in tp_flags.

  • bpo-31862: Port binascii to PEP 489 multiphase initialization. Patch by Marcel Plch.

Library

  • bpo-37128: Added math.perm().

  • bpo-37120: Add SSLContext.num_tickets to control the number of TLSv1.3 session tickets.

  • bpo-12202: Fix the error handling in msilib.SummaryInformation.GetProperty(). Patch by Zackery Spytz.

  • bpo-26835: The fcntl module now contains file sealing constants for sealing of memfds.

  • bpo-29262: Add get_origin() and get_args() introspection helpers to typing module.

  • bpo-12639: msilib.Directory.start_component() no longer fails if keyfile is not None.

  • bpo-36999: Add the asyncio.Task.get_coro() method to publicly expose the tasks’s coroutine object.

  • bpo-35246: Make asyncio.create_subprocess_exec() accept path-like arguments.

  • bpo-35279: Change default max_workers of ThreadPoolExecutor from cpu_count() * 5 to min(32, cpu_count() + 4). Previous value was unreasonably large on many cores machines.

  • bpo-37076: _thread.start_new_thread() now logs uncaught exception raised by the function using sys.unraisablehook(), rather than sys.excepthook(), so the hook gets access to the function which raised the exception.

  • bpo-33725: On macOS, the multiprocessing module now uses spawn start method by default.

  • bpo-37054: Fix destructor _pyio.BytesIO and _pyio.TextIOWrapper: initialize their _buffer attribute as soon as possible (in the class body), because it’s used by __del__() which calls close().

  • bpo-37058: PEP 544: Add Protocol and @runtime_checkable to the typing module.

  • bpo-36933: The functions sys.set_coroutine_wrapper and sys.get_coroutine_wrapper that were deprecated and marked for removal in 3.8 have been removed.

  • bpo-37047: Handle late binding and attribute access in unittest.mock.AsyncMock setup for autospeccing. Document newly implemented async methods in unittest.mock.MagicMock.

  • bpo-37049: PEP 589: Add TypedDict to the typing module.

  • bpo-37046: PEP 586: Add Literal to the typing module.

  • bpo-37045: PEP 591: Add Final qualifier and @final decorator to the typing module.

  • bpo-37035: Don’t log OSError based exceptions if a fatal error has occurred in asyncio transport. Peer can generate almost any OSError, user cannot avoid these exceptions by fixing own code. Errors are still propagated to user code, it’s just logging them is pointless and pollute asyncio logs.

  • bpo-37001: symtable.symtable() now accepts the same input types for source code as the built-in compile() function. Patch by Dino Viehland.

  • bpo-37028: Implement asyncio REPL

  • bpo-37027: Return safe to use proxy socket object from transport.get_extra_info(“socket”)

  • bpo-32528: Make asyncio.CancelledError a BaseException.

    This will address the common mistake many asyncio users make: an «except Exception» clause breaking Tasks cancellation.

    In addition to this change, we stop inheriting asyncio.TimeoutError and asyncio.InvalidStateError from their concurrent.futures.* counterparts. There’s no point for these exceptions to share the inheritance chain.

  • bpo-1230540: Add a new threading.excepthook() function which handles uncaught threading.Thread.run() exception. It can be overridden to control how uncaught threading.Thread.run() exceptions are handled.

  • bpo-36996: Handle unittest.mock.patch() used as a decorator on async functions.

  • bpo-37008: Add support for calling next() with the mock resulting from unittest.mock.mock_open()

  • bpo-27737: Allow whitespace only header encoding in email.header - by Batuhan Taskaya

  • bpo-36969: PDB command args now display positional only arguments. Patch contributed by Rémi Lapeyre.

  • bpo-36969: PDB command args now display keyword only arguments. Patch contributed by Rémi Lapeyre.

  • bpo-36983: Add missing names to typing.__all__: ChainMap, ForwardRef, OrderedDict - by Anthony Sottile.

  • bpo-36972: Add SupportsIndex protocol to the typing module to allow type checking to detect classes that can be passed to hex(), oct() and bin().

  • bpo-32972: Implement unittest.IsolatedAsyncioTestCase to help testing asyncio-based code.

  • bpo-36952: fileinput.input() and fileinput.FileInput bufsize argument has been removed (was deprecated and ignored since Python 3.6), and as a result the mode and openhook arguments have been made keyword-only.

  • bpo-36952: Starting with Python 3.3, importing ABCs from collections is deprecated, and import should be done from collections.abc. Still being able to import from collections was marked for removal in 3.8, but has been delayed to 3.9; documentation and DeprecationWarning clarified.

  • bpo-36949: Implement __repr__ for WeakSet objects.

  • bpo-36948: Fix NameError in urllib.request.URLopener.retrieve(). Patch by Karthikeyan Singaravelan.

  • bpo-33524: Fix the folding of email header when the max_line_length is 0 or None and the header contains non-ascii characters. Contributed by Licht Takeuchi (@Licht-T).

  • bpo-24564: shutil.copystat() now ignores errno.EINVAL on os.setxattr() which may occur when copying files on filesystems without extended attributes support.

    Original patch by Giampaolo Rodola, updated by Ying Wang.

  • bpo-36888: Python child processes can now access the status of their parent process using multiprocessing.process.parent_process

  • bpo-36921: Deprecate @coroutine for sake of async def.

  • bpo-25652: Fix bug in __rmod__ of UserString - by Batuhan Taskaya.

  • bpo-36916: Remove a message about an unhandled exception in a task when writer.write() is used without await and writer.drain() fails with an exception.

  • bpo-36889: Introduce asyncio.Stream class that merges asyncio.StreamReader and asyncio.StreamWriter functionality. asyncio.Stream can work in readonly, writeonly and readwrite modes. Provide asyncio.connect(), asyncio.connect_unix(), asyncio.connect_read_pipe() and asyncio.connect_write_pipe() factories to open asyncio.Stream connections. Provide asyncio.StreamServer and UnixStreamServer to serve servers with asyncio.Stream API. Modify asyncio.create_subprocess_shell() and asyncio.create_subprocess_exec() to use asyncio.Stream instead of deprecated StreamReader and StreamWriter. Deprecate asyncio.StreamReader and asyncio.StreamWriter. Deprecate usage of private classes, e.g. asyncio.FlowControlMixing and asyncio.StreamReaderProtocol outside of asyncio package.

  • bpo-36845: Added validation of integer prefixes to the construction of IP networks and interfaces in the ipaddress module.

  • bpo-23378: Add an extend action to argparser.

  • bpo-36867: Fix a bug making a SharedMemoryManager instance and its parent process use two separate resource_tracker processes.

  • bpo-23896: Adds a grammar to lib2to3.pygram that contains exec as a function not as statement.

  • bpo-36895: The function time.clock() was deprecated in 3.3 in favor of time.perf_counter() and marked for removal in 3.8, it has removed.

  • bpo-35545: Fix asyncio discarding IPv6 scopes when ensuring hostname resolutions internally

  • bpo-36887: Add new function math.isqrt() to compute integer square roots.

  • bpo-34632: Introduce the importlib.metadata module with (provisional) support for reading metadata from third-party packages.

  • bpo-36878: When using type_comments=True in ast.parse, treat # type: ignore followed by a non-alphanumeric character and then arbitrary text as a type ignore, instead of requiring nothing but whitespace or another comment. This is to permit formations such as # type: ignore[E1000].

  • bpo-36778: cp65001 encoding (Windows code page 65001) becomes an alias to utf_8 encoding.

  • bpo-36867: The multiprocessing.resource_tracker replaces the multiprocessing.semaphore_tracker module. Other than semaphores, resource_tracker also tracks shared_memory segments.

  • bpo-30262: The Cache and Statement objects of the sqlite3 module are not exposed to the user. Patch by Aviv Palivoda.

  • bpo-24538: In shutil.copystat(), first copy extended file attributes and then file permissions, since extended attributes can only be set on the destination while it is still writeable.

  • bpo-36829: Add new sys.unraisablehook() function which can be overridden to control how «unraisable exceptions» are handled. It is called when an exception has occurred but there is no way for Python to handle it. For example, when a destructor raises an exception or during garbage collection (gc.collect()).

  • bpo-36832: Introducing zipfile.Path, a pathlib-compatible wrapper for traversing zip files.

  • bpo-36814: Fix an issue where os.posix_spawnp() would incorrectly raise a TypeError when file_actions is None.

  • bpo-33110: Handle exceptions raised by functions added by concurrent.futures add_done_callback correctly when the Future has already completed.

  • bpo-26903: Limit max_workers in ProcessPoolExecutor to 61 to work around a WaitForMultipleObjects limitation.

  • bpo-36813: Fix QueueListener to call queue.task_done() upon stopping. Patch by Bar Harel.

  • bpo-36806: Forbid creation of asyncio stream objects like StreamReader, StreamWriter, Process, and their protocols outside of asyncio package.

  • bpo-36802: Provide both sync and async calls for StreamWriter.write() and StreamWriter.close()

  • bpo-36801: Properly handle SSL connection closing in asyncio StreamWriter.drain() call.

  • bpo-36785: Implement PEP 574 (pickle protocol 5 with out-of-band buffers).

  • bpo-36772: functools.lru_cache() can now be used as a straight decorator in addition to its existing usage as a function that returns a decorator.

  • bpo-6584: Add a BadGzipFile exception to the gzip module.

  • bpo-36748: Optimized write buffering in C implementation of TextIOWrapper. Writing ASCII string to TextIOWrapper with ascii, latin1, or utf-8 encoding is about 20% faster. Patch by Inada Naoki.

  • bpo-8138: Don’t mark wsgiref.simple_server.SimpleServer as multi-threaded since wsgiref.simple_server.WSGIServer is single-threaded.

  • bpo-22640: py_compile.compile() now supports silent mode. Patch by Joannah Nanjekye

  • bpo-29183: Fix double exceptions in wsgiref.handlers.BaseHandler by calling its close() method only when no exception is raised.

  • bpo-36548: Improved the repr of regular expression flags.

  • bpo-36542: The signature of Python functions can now be overridden by specifying the __text_signature__ attribute.

  • bpo-36533: Reinitialize logging.Handler locks in forked child processes instead of attempting to acquire them all in the parent before forking only to be released in the child process. The acquire/release pattern was leading to deadlocks in code that has implemented any form of chained logging handlers that depend upon one another as the lock acquisition order cannot be guaranteed.

  • bpo-35252: Throw a TypeError instead of an AssertionError when using an invalid type annotation with singledispatch.

  • bpo-35900: Allow reduction methods to return a 6-item tuple where the 6th item specifies a custom state-setting method that’s called instead of the regular __setstate__ method.

  • bpo-35900: enable custom reduction callback registration for functions and classes in _pickle.c, using the new Pickler’s attribute reducer_override

  • bpo-36368: Fix a bug crashing SharedMemoryManager instances in interactive sessions after a ctrl-c (KeyboardInterrupt) was sent

  • bpo-31904: Fix mmap fail for VxWorks

  • bpo-27497: csv.DictWriter.writeheader() now returns the return value of the underlying csv.Writer.writerow() method. Patch contributed by Ashish Nitin Patil.

  • bpo-36239: Parsing .mo files now ignores comments starting and ending with #-#-#-#-#.

  • bpo-26707: Enable plistlib to read and write binary plist files that were created as a KeyedArchive file. Specifically, this allows the plistlib to process 0x80 tokens as UID objects.

  • bpo-31904: Add posix module support for VxWorks.

  • bpo-35125: Asyncio: Remove inner callback on outer cancellation in shield

  • bpo-35721: Fix asyncio.SelectorEventLoop.subprocess_exec() leaks file descriptors if Popen fails and called with stdin=subprocess.PIPE. Patch by Niklas Fiekas.

  • bpo-31855: unittest.mock.mock_open() results now respects the argument of read([size]). Patch contributed by Rémi Lapeyre.

  • bpo-35431: Implement math.comb() that returns binomial coefficient, that computes the number of ways to choose k items from n items without repetition and without order. Patch by Yash Aggarwal and Keller Fuchs.

  • bpo-26660: Fixed permission errors in TemporaryDirectory clean up. Previously TemporaryDirectory.cleanup() failed when non-writeable or non-searchable files or directories were created inside a temporary directory.

  • bpo-34271: Add debugging helpers to ssl module. It’s now possible to dump key material and to trace TLS protocol. The default and stdlib contexts also support SSLKEYLOGFILE env var.

  • bpo-26467: Added AsyncMock to support using unittest to mock asyncio coroutines. Patch by Lisa Roach.

  • bpo-33569: dataclasses.InitVar: Exposes the type used to create the init var.

  • bpo-34424: Fix serialization of messages containing encoded strings when the policy.linesep is set to a multi-character string. Patch by Jens Troeger.

  • bpo-34303: Performance of functools.reduce() is slightly improved. Patch by Sergey Fedoseev.

  • bpo-33361: Fix a bug in codecs.StreamRecoder where seeking might leave old data in a buffer and break subsequent read calls. Patch by Ammar Askar.

  • bpo-22454: The shlex module now exposes shlex.join(), the inverse of shlex.split(). Patch by Bo Bayles.

  • bpo-31922: asyncio.AbstractEventLoop.create_datagram_endpoint(): Do not connect UDP socket when broadcast is allowed. This allows to receive replies after a UDP broadcast.

  • bpo-24882: Change ThreadPoolExecutor to use existing idle threads before spinning up new ones.

  • bpo-31961: Added support for bytes and path-like objects in subprocess.Popen() on Windows. The args parameter now accepts a path-like object if shell is False and a sequence containing bytes and path-like objects. The executable parameter now accepts a bytes and path-like object. The cwd parameter now accepts a bytes object. Based on patch by Anders Lorentsen.

  • bpo-33123: pathlib.Path.unlink now accepts a missing_ok parameter to avoid a FileNotFoundError from being raised. Patch by Robert Buchholz.

  • bpo-32941: Allow mmap.mmap objects to access the madvise() system call (through mmap.mmap.madvise()).

  • bpo-22102: Added support for ZIP files with disks set to 0. Such files are commonly created by builtin tools on Windows when use ZIP64 extension. Patch by Francisco Facioni.

  • bpo-32515: trace.py can now run modules via python3 -m trace -t –module module_name

  • bpo-32299: Changed unittest.mock.patch.dict() to return the patched dictionary when used as context manager. Patch by Vadim Tsander.

  • bpo-27141: Added a __copy__() to collections.UserList and collections.UserDict in order to correctly implement shallow copying of the objects. Patch by Bar Harel.

  • bpo-31829: \r, \0 and \x1a (end-of-file on Windows) are now escaped in protocol 0 pickles of Unicode strings. This allows to load them without loss from files open in text mode in Python 2.

  • bpo-23395: _thread.interrupt_main() now avoids setting the Python error status if the SIGINT signal is ignored or not handled by Python.

Documentation

  • bpo-36896: Clarify that some types have unstable constructor signature between Python versions.

  • bpo-36686: Improve documentation of the stdin, stdout, and stderr arguments of the asyncio.subprocess_exec function to specify which values are supported. Also mention that decoding as text is not supported.

    Add a few tests to verify that the various values passed to the std* arguments actually work.

  • bpo-36984: Improve version added references in typing module - by Anthony Sottile.

  • bpo-36868: What’s new now mentions SSLContext.hostname_checks_common_name instead of SSLContext.host_flags.

  • bpo-35924: Add a note to the curses.addstr() documentation to warn that multiline strings can cause segfaults because of an ncurses bug.

  • bpo-36783: Added C API Documentation for Time_FromTimeAndFold and PyDateTime_FromDateAndTimeAndFold as per PEP 495. Patch by Edison Abahurire.

  • bpo-36797: More of the legacy distutils documentation has been either pruned, or else more clearly marked as being retained solely until the setuptools documentation covers it independently.

  • bpo-22865: Add detail to the documentation on the pty.spawn function.

  • bpo-35397: Remove deprecation and document urllib.parse.unwrap(). Patch contributed by Rémi Lapeyre.

  • bpo-32995: Added the context variable in glossary.

  • bpo-33519: Clarify that copy() is not part of the MutableSequence ABC.

  • bpo-33482: Make codecs.StreamRecoder.writelines take a list of bytes.

  • bpo-25735: Added documentation for func factorial to indicate that returns integer values

  • bpo-20285: Expand object.__doc__ (docstring) to make it clearer. Modify pydoc.py so that help(object) lists object methods (for other classes, help omits methods of the object base class.)

Tests

  • bpo-37069: Modify test_coroutines, test_cprofile, test_generators, test_raise, test_ssl and test_yield_from to use test.support.catch_unraisable_exception() rather than test.support.captured_stderr().

  • bpo-37098: Fix test_memfd_create on older Linux Kernels.

  • bpo-37081: Test with OpenSSL 1.1.1c

  • bpo-36829: Add test.support.catch_unraisable_exception(): context manager catching unraisable exception using sys.unraisablehook().

  • bpo-36915: The main regrtest process now always removes all temporary directories of worker processes even if they crash or if they are killed on KeyboardInterrupt (CTRL+c).

  • bpo-36719: «python3 -m test -jN …» now continues the execution of next tests when a worker process crash (CHILD_ERROR state). Previously, the test suite stopped immediately. Use –failfast to stop at the first error.

  • bpo-36816: Update Lib/test/selfsigned_pythontestdotnet.pem to match self-signed.pythontest.net’s new TLS certificate.

  • bpo-35925: Skip httplib and nntplib networking tests when they would otherwise fail due to a modern OS or distro with a default OpenSSL policy of rejecting connections to servers with weak certificates.

  • bpo-36782: Add tests for several C API functions in the datetime module. Patch by Edison Abahurire.

  • bpo-36342: Fix test_multiprocessing in test_venv if platform lacks functioning sem_open.

Build

  • bpo-36721: To embed Python into an application, a new --embed option must be passed to python3-config --libs --embed to get -lpython3.8 (link the application to libpython). To support both 3.8 and older, try python3-config --libs --embed first and fallback to python3-config --libs (without --embed) if the previous command fails.

    Add a pkg-config python-3.8-embed module to embed Python into an application: pkg-config python-3.8-embed --libs includes -lpython3.8. To support both 3.8 and older, try pkg-config python-X.Y-embed --libs first and fallback to pkg-config python-X.Y --libs (without --embed) if the previous command fails (replace X.Y with the Python version).

    On the other hand, pkg-config python3.8 --libs no longer contains -lpython3.8. C extensions must not be linked to libpython (except on Android, case handled by the script); this change is backward incompatible on purpose.

  • bpo-36786: «make install» now runs compileall in parallel.

Windows

  • bpo-36965: include of STATUS_CONTROL_C_EXIT without depending on MSC compiler

  • bpo-35926: Update to OpenSSL 1.1.1b for Windows.

  • bpo-29883: Add Windows support for UDP transports for the Proactor Event Loop. Patch by Adam Meily.

  • bpo-33407: The Py_DEPRECATED() macro has been implemented for MSVC.

macOS

  • bpo-36231: Support building Python on macOS without /usr/include installed. As of macOS 10.14, system header files are only available within an SDK provided by either the Command Line Tools or the Xcode app.

IDLE

  • bpo-35610: Replace now redundant .context_use_ps1 with .prompt_last_line. This finishes change started in bpo-31858.

  • bpo-37038: Make idlelib.run runnable; add test clause.

  • bpo-36958: Print any argument other than None or int passed to SystemExit or sys.exit().

  • bpo-36807: When saving a file, call os.fsync() so bits are flushed to e.g. USB drive.

  • bpo-32411: In browser.py, remove extraneous sorting by line number since dictionary was created in line number order.

Tools/Demos

  • bpo-37053: Handle strings like u»bar» correctly in Tools/parser/unparse.py. Patch by Chih-Hsuan Yen.

C API

  • bpo-36763: Implement the PEP 587 «Python Initialization Configuration».

  • bpo-36379: Fix crashes when attempting to use the modulo parameter when __ipow__ is implemented in C.

  • bpo-37107: Update PyObject_CallMethodObjArgs() and _PyObject_CallMethodIdObjArgs to use _PyObject_GetMethod to avoid creating a bound method object in many cases. Patch by Michael J. Sullivan.

  • bpo-36974: Implement PEP 590: Vectorcall: a fast calling protocol for CPython. This is a new protocol to optimize calls of custom callable objects.

  • bpo-36763: Py_Main() now returns the exitcode rather than calling Py_Exit(exitcode) when calling PyErr_Print() if the current exception type is SystemExit.

  • bpo-36922: Add new type flag Py_TPFLAGS_METHOD_DESCRIPTOR for objects behaving like unbound methods. These are objects supporting the optimization given by the LOAD_METHOD/CALL_METHOD opcodes. See PEP 590.

  • bpo-36728: The PyEval_ReInitThreads() function has been removed from the C API. It should not be called explicitly: use PyOS_AfterFork_Child() instead.

Python 3.8.0 alpha 4

Release date: 2019-05-06

Security

  • bpo-36742: Fixes mishandling of pre-normalization characters in urlsplit().

  • bpo-30458: Address CVE 2019-9740 by disallowing URL paths with embedded whitespace or control characters through into the underlying http client request. Such potentially malicious header injection URLs now cause an http.client.InvalidURL exception to be raised.

  • bpo-35755: shutil.which() now uses os.confstr("CS_PATH") if available and if the PATH environment variable is not set. Remove also the current directory from posixpath.defpath. On Unix, shutil.which() and the subprocess module no longer search the executable in the current directory if the PATH environment variable is not set.

Core and Builtins

  • bpo-36722: In debug build, import now also looks for C extensions compiled in release mode and for C extensions compiled in the stable ABI.

  • bpo-32849: Fix Python Initialization code on FreeBSD to detect properly when stdin file descriptor (fd 0) is invalid.

  • bpo-36623: Remove parser headers and related function declarations that lack implementations after the removal of pgen.

  • bpo-20180: dict.pop() is now up to 33% faster thanks to Argument Clinic. Patch by Inada Naoki.

  • bpo-36611: Debug memory allocators: disable serialno field by default from debug hooks on Python memory allocators to reduce the memory footprint by 5%. Enable tracemalloc to get the traceback where a memory block has been allocated when a fatal memory error is logged to decide where to put a breakpoint. Compile Python with PYMEM_DEBUG_SERIALNO defined to get back the field.

  • bpo-36588: On AIX, sys.platform doesn’t contain the major version anymore. Always return 'aix', instead of 'aix3' .. 'aix7'. Since older Python versions include the version number, it is recommended to always use sys.platform.startswith('aix'). Contributed by M. Felt.

  • bpo-36549: Change str.capitalize to use titlecase for the first character instead of uppercase.

  • bpo-36540: Implement PEP 570 (Python positional-only parameters). Patch by Pablo Galindo.

  • bpo-36475: PyEval_AcquireLock() and PyEval_AcquireThread() now terminate the current thread if called while the interpreter is finalizing, making them consistent with PyEval_RestoreThread(), Py_END_ALLOW_THREADS(), and PyGILState_Ensure().

  • bpo-36504: Fix signed integer overflow in _ctypes.c’s PyCArrayType_new().

  • bpo-20844: Fix running script with encoding cookie and LF line ending may fail on Windows.

  • bpo-24214: Fixed support of the surrogatepass error handler in the UTF-8 incremental decoder.

  • bpo-36452: Changing dict keys during iteration of the dict itself, keys(), values(), or items() will now be detected in certain corner cases where keys are deleted/added so that the number of keys isn’t changed. A RuntimeError will be raised after len(dict) iterations. Contributed by Thomas Perl.

  • bpo-36459: Fix a possible double PyMem_FREE() due to tokenizer.c’s tok_nextc().

  • bpo-36433: Fixed TypeError message in classmethoddescr_call.

  • bpo-36430: Fix a possible reference leak in itertools.count().

  • bpo-36440: Include node names in ParserError messages, instead of numeric IDs. Patch by A. Skrobov.

  • bpo-36143: Regenerate keyword from the Grammar and Tokens file using pgen. Patch by Pablo Galindo.

  • bpo-18372: Add missing PyObject_GC_Track() calls in the pickle module. Patch by Zackery Spytz.

Library

  • bpo-35952: Fix pythoninfo when the compiler is missing.

  • bpo-28238: The .find*() methods of xml.etree.ElementTree can now search for wildcards like {*}tag and {ns}* that match a tag in any namespace or all tags in a namespace. Patch by Stefan Behnel.

  • bpo-26978: pathlib.path.link_to() is now implemented. It creates a hard link pointing to a path.

  • bpo-1613500: fileinput.FileInput now uses the input file mode to correctly set the output file mode (previously it was hardcoded to 'w') when inplace=True is passed to its constructor.

  • bpo-36734: Fix compilation of faulthandler.c on HP-UX. Initialize stack_t current_stack to zero using memset().

  • bpo-13611: The xml.etree.ElementTree packages gained support for C14N 2.0 serialisation. Patch by Stefan Behnel.

  • bpo-36669: Add missing matrix multiplication operator support to weakref.proxy.

  • bpo-36676: The XMLParser() in xml.etree.ElementTree provides namespace prefix context to the parser target if it defines the callback methods «start_ns()» and/or «end_ns()». Patch by Stefan Behnel.

  • bpo-36673: The TreeBuilder and XMLPullParser in xml.etree.ElementTree gained support for parsing comments and processing instructions. Patch by Stefan Behnel.

  • bpo-36650: The C version of functools.lru_cache() was treating calls with an empty **kwargs dictionary as being distinct from calls with no keywords at all. This did not result in an incorrect answer, but it did trigger an unexpected cache miss.

  • bpo-28552: Fix distutils.sysconfig if sys.executable is None or an empty string: use os.getcwd() to initialize project_base. Fix also the distutils build command: don’t use sys.executable if it is None or an empty string.

  • bpo-35755: shutil.which() and distutils.spawn.find_executable now use os.confstr("CS_PATH") if available instead of os.defpath, if the PATH environment variable is not set. Moreover, don’t use os.confstr("CS_PATH") nor os.defpath if the PATH environment variable is set to an empty string.

  • bpo-25430: improve performance of IPNetwork.__contains__()

  • bpo-30485: Path expressions in xml.etree.ElementTree can now avoid explicit namespace prefixes for tags (or the «{namespace}tag» notation) by passing a default namespace with an empty string prefix.

  • bpo-36613: Fix asyncio wait() not removing callback if exception

  • bpo-36598: Fix isinstance check for Mock objects with spec when the code is executed under tracing. Patch by Karthikeyan Singaravelan.

  • bpo-18748: In development mode (-X dev) and in debug build, the io.IOBase destructor now logs close() exceptions. These exceptions are silent by default in release mode.

  • bpo-36575: The _lsprof module now uses internal timer same to time.perf_counter() by default. gettimeofday(2) was used on Unix. New timer has better resolution on most Unix platforms and timings are no longer impacted by system clock updates since perf_counter() is monotonic. Patch by Inada Naoki.

  • bpo-33461: json.loads now emits DeprecationWarning when encoding option is specified. Patch by Matthias Bussonnier.

  • bpo-36559: The random module now prefers the lean internal _sha512 module over hashlib for seed(version=2) to optimize import time.

  • bpo-17561: Set backlog=None as the default for socket.create_server.

  • bpo-34373: Fix time.mktime() error handling on AIX for year before 1970.

  • bpo-36232: Improve error message when trying to open existing DBM database that actually doesn’t exist. Patch by Marco Rougeth.

  • bpo-36546: Add statistics.quantiles()

  • bpo-36050: Optimized http.client.HTTPResponse.read() for large response. Patch by Inada Naoki.

  • bpo-36522: If debuglevel is set to >0 in http.client, print all values for headers with multiple values for the same header name. Patch by Matt Houglum.

  • bpo-36492: Deprecated passing required arguments like func as keyword arguments in functions which should accept arbitrary keyword arguments and pass them to other function. Arbitrary keyword arguments (even with names «self» and «func») can now be passed to these functions if the required arguments are passed as positional arguments.

  • bpo-27181: Add statistics.geometric_mean().

  • bpo-30427: os.path.normcase() relies on os.fspath() to check the type of its argument. Redundant checks have been removed from its posixpath.normcase() and ntpath.normcase() implementations. Patch by Wolfgang Maier.

  • bpo-36385: Stop rejecting IPv4 octets for being ambiguously octal. Leading zeros are ignored, and no longer are assumed to specify octal octets. Octets are always decimal numbers. Octets must still be no more than three digits, including leading zeroes.

  • bpo-36434: Errors during writing to a ZIP file no longer prevent to properly close it.

  • bpo-36407: Fixed wrong indentation writing for CDATA section in xml.dom.minidom. Patch by Vladimir Surjaninov.

  • bpo-36326: inspect.getdoc() can now find docstrings for member objects when __slots__ is a dictionary.

  • bpo-36366: Calling stop() on an unstarted or stopped unittest.mock.patch() object will now return None instead of raising RuntimeError, making the method idempotent. Patch by Karthikeyan Singaravelan.

  • bpo-36348: The imap.IMAP4.logout() method no longer ignores silently arbitrary exceptions.

  • bpo-31904: Add time module support and fix test_time failures for VxWorks.

  • bpo-36227: Added support for keyword arguments default_namespace and xml_declaration in functions ElementTree.tostring() and ElementTree.tostringlist().

  • bpo-36004: Added new alternate constructors datetime.date.fromisocalendar() and datetime.datetime.fromisocalendar(), which construct date objects from ISO year, week number and weekday; these are the inverse of each class’s isocalendar method. Patch by Paul Ganssle.

  • bpo-35936: modulefinder no longer depends on the deprecated imp module, and the initializer for modulefinder.ModuleFinder now has immutable default arguments. Patch by Brandt Bucher.

  • bpo-35376: modulefinder correctly handles modules that have the same name as a bad package. Patch by Brandt Bucher.

  • bpo-17396: modulefinder no longer crashes when encountering syntax errors in followed imports. Patch by Brandt Bucher.

  • bpo-35934: Added create_server() and has_dualstack_ipv6() convenience functions to automate the necessary tasks usually involved when creating a server socket, including accepting both IPv4 and IPv6 connections on the same socket. (Contributed by Giampaolo Rodola in bpo-17561.)

  • bpo-23078: Add support for classmethod() and staticmethod() to unittest.mock.create_autospec(). Initial patch by Felipe Ochoa.

  • bpo-35416: Fix potential resource warnings in distutils. Patch by Mickaël Schoentgen.

  • bpo-25451: Add transparency methods to tkinter.PhotoImage. Patch by Zackery Spytz.

  • bpo-35082: Don’t return deleted attributes when calling dir on a unittest.mock.Mock.

  • bpo-34547: wsgiref.handlers.BaseHandler now handles abrupt client connection terminations gracefully. Patch by Petter Strandmark.

  • bpo-31658: xml.sax.parse() now supports path-like. Patch by Mickaël Schoentgen.

  • bpo-34139: Remove stale unix datagram socket before binding

  • bpo-33530: Implemented Happy Eyeballs in asyncio.create_connection(). Added two new arguments, happy_eyeballs_delay and interleave, to specify Happy Eyeballs behavior.

  • bpo-33291: Do not raise AttributeError when calling the inspect functions isgeneratorfunction, iscoroutinefunction, isasyncgenfunction on a method created from an arbitrary callable. Instead, return False.

  • bpo-31310: Fix the multiprocessing.semaphore_tracker so it is reused by child processes

  • bpo-31292: Fix setup.py check --restructuredtext for files containing include directives.

Documentation

  • bpo-36625: Remove obsolete comments from docstrings in fractions.Fraction

  • bpo-30840: Document relative imports

  • bpo-36523: Add docstring for io.IOBase.writelines().

  • bpo-36425: New documentation translation: Simplified Chinese.

  • bpo-36345: Avoid the duplication of code from Tools/scripts/serve.py in using the literalinclude directive for the basic wsgiref-based web server in the documentation of wsgiref. Contributed by Stéphane Wirtel.

  • bpo-36345: Using the code of the Tools/scripts/serve.py script as an example in the wsgiref documentation. Contributed by Stéphane Wirtel.

  • bpo-36157: Added documentation for PyInterpreterState_Main().

  • bpo-33043: Updates the docs.python.org page with the addition of a “Contributing to Docs” link at the end of the page (between “Reporting Bugs” and “About Documentation”). Updates the “Found a Bug” page with additional links and information in the Documentation Bugs section.

  • bpo-35581: @typing.type_check_only now allows type stubs to mark functions and classes not available during runtime.

  • bpo-33832: Add glossary entry for “magic method”.

  • bpo-32913: Added re.Match.groupdict example to regex HOWTO.

Tests

  • bpo-36719: regrtest now always detects uncollectable objects. Previously, the check was only enabled by --findleaks. The check now also works with -jN/--multiprocess N. --findleaks becomes a deprecated alias to --fail-env-changed.

  • bpo-36725: When using multiprocessing mode (-jN), regrtest now better reports errors if a worker process fails, and it exits immediately on a worker thread failure or when interrupted.

  • bpo-36454: Change test_time.test_monotonic() to test only the lower bound of elapsed time after a sleep command rather than the upper bound. This prevents unnecessary test failures on slow buildbots. Patch by Victor Stinner.

  • bpo-32424: Improve test coverage for xml.etree.ElementTree. Patch by Gordon P. Hemsley.

  • bpo-32424: Fix typo in test_cyclic_gc() test for xml.etree.ElementTree. Patch by Gordon P. Hemsley.

  • bpo-36635: Add a new _testinternalcapi module to test the internal C API.

  • bpo-36629: Fix test_imap4_host_default_value() of test_imaplib: catch also errno.ENETUNREACH error.

  • bpo-36611: Fix test_sys.test_getallocatedblocks() when tracemalloc is enabled.

  • bpo-36560: Fix reference leak hunting in regrtest: compute also deltas (of reference count, allocated memory blocks, file descriptor count) during warmup, to ensure that everything is initialized before starting to hunt reference leaks.

  • bpo-36565: Fix reference hunting (python3 -m test -R 3:3) when Python has no built-in abc module.

  • bpo-31904: Port test_resource to VxWorks: skip tests cases setting RLIMIT_FSIZE and RLIMIT_CPU.

  • bpo-31904: Fix test_tabnanny on VxWorks: adjust ENOENT error message.

  • bpo-36436: Fix _testcapi.pymem_buffer_overflow(): handle memory allocation failure.

  • bpo-31904: Fix test_utf8_mode on VxWorks: Python always use UTF-8 on VxWorks.

  • bpo-36341: Fix tests that may fail with PermissionError upon calling bind() on AF_UNIX sockets.

Build

  • bpo-36747: Remove the stale scriptsinstall Makefile target.

  • bpo-21536: On Unix, C extensions are no longer linked to libpython except on Android and Cygwin.

    It is now possible for a statically linked Python to load a C extension built using a shared library Python.

    When Python is embedded, libpython must not be loaded with RTLD_LOCAL, but RTLD_GLOBAL instead. Previously, using RTLD_LOCAL, it was already not possible to load C extensions which were not linked to libpython, such as C extensions of the standard library built by the *shared* section of Modules/Setup.

    distutils, python-config and python-config.py have been modified.

  • bpo-36707: ./configure --with-pymalloc no longer adds the m flag to SOABI (sys.implementation.cache_tag). Enabling or disabling pymalloc has no impact on the ABI.

  • bpo-36635: Change PyAPI_FUNC(type), PyAPI_DATA(type) and PyMODINIT_FUNC macros of pyport.h when Py_BUILD_CORE_MODULE is defined. The Py_BUILD_CORE_MODULE define must be now be used to build a C extension as a dynamic library accessing Python internals: export the PyInit_xxx() function in DLL exports on Windows.

  • bpo-31904: Don’t build the _crypt extension on VxWorks.

  • bpo-36618: Add -fmax-type-align=8 to CFLAGS when clang compiler is detected. The pymalloc memory allocator aligns memory on 8 bytes. On x86-64, clang expects alignment on 16 bytes by default and so uses MOVAPS instruction which can lead to segmentation fault. Instruct clang that Python is limited to alignment on 8 bytes to use MOVUPS instruction instead: slower but don’t trigger a SIGSEGV if the memory is not aligned on 16 bytes. Sadly, the flag must be added to CFLAGS and not just CFLAGS_NODIST, since third party C extensions can have the same issue.

  • bpo-36605: make tags and make TAGS now also parse Modules/_io/*.c and Modules/_io/*.h.

  • bpo-36465: Release builds and debug builds are now ABI compatible: defining the Py_DEBUG macro no longer implies the Py_TRACE_REFS macro, which introduces the only ABI incompatibility. The Py_TRACE_REFS macro, which adds the sys.getobjects() function and the PYTHONDUMPREFS environment variable, can be set using the new ./configure --with-trace-refs build option.

  • bpo-36577: setup.py now correctly reports missing OpenSSL headers and libraries again.

  • bpo-36544: Fix regression introduced in bpo-36146 refactoring setup.py

  • bpo-36508: python-config --ldflags no longer includes flags of the LINKFORSHARED variable. The LINKFORSHARED variable must only be used to build executables.

  • bpo-36503: Remove references to «aix3» and «aix4». Patch by M. Felt.

Windows

  • bpo-35920: Added platform.win32_edition() and platform.win32_is_iot(). Added support for cross-compiling packages for Windows ARM32. Skip tests that are not expected to work on Windows IoT Core ARM32.

  • bpo-36649: Remove trailing spaces for registry keys when installed via the Store.

  • bpo-34144: Fixed activate.bat to correctly update codepage when chcp.com returns dots in output. Patch by Lorenz Mende.

  • bpo-36509: Added preset-iot layout for Windows IoT ARM containers. This layout doesn’t contain UI components like tkinter or IDLE. It also doesn’t contain files to support on-target builds since Windows ARM32 builds must be cross-compiled when using MSVC.

  • bpo-35941: enum_certificates function of the ssl module now returns certificates from all available certificate stores inside windows in a query instead of returning only certificates from the system wide certificate store. This includes certificates from these certificate stores: local machine, local machine enterprise, local machine group policy, current user, current user group policy, services, users. ssl.enum_crls() function is changed in the same way to return all certificate revocation lists inside the windows certificate revocation list stores.

  • bpo-36441: Fixes creating a venv when debug binaries are installed.

  • bpo-36085: Enable better DLL resolution on Windows by using safe DLL search paths and adding os.add_dll_directory().

  • bpo-36010: Add the venv standard library module to the nuget distribution for Windows.

  • bpo-29515: Add the following socket module constants on Windows: IPPROTO_AH IPPROTO_CBT IPPROTO_DSTOPTS IPPROTO_EGP IPPROTO_ESP IPPROTO_FRAGMENT IPPROTO_GGP IPPROTO_HOPOPTS IPPROTO_ICLFXBM IPPROTO_ICMPV6 IPPROTO_IDP IPPROTO_IGMP IPPROTO_IGP IPPROTO_IPV4 IPPROTO_IPV6 IPPROTO_L2TP IPPROTO_MAX IPPROTO_ND IPPROTO_NONE IPPROTO_PGM IPPROTO_PIM IPPROTO_PUP IPPROTO_RDP IPPROTO_ROUTING IPPROTO_SCTP IPPROTO_ST

  • bpo-35947: Added current version of libffi to cpython-source-deps. Change _ctypes to use current version of libffi on Windows.

  • bpo-34060: Report system load when running test suite on Windows. Patch by Ammar Askar. Based on prior work by Jeremy Kloth.

  • bpo-31512: With the Windows 10 Creators Update, non-elevated users can now create symlinks as long as the computer has Developer Mode enabled.

macOS

  • bpo-34602: Avoid failures setting macOS stack resource limit with resource.setrlimit. This reverts an earlier fix for bpo-18075 which forced a non-default stack size when building the interpreter executable on macOS.

IDLE

  • bpo-36429: Fix starting IDLE with pyshell. Add idlelib.pyshell alias at top; remove pyshell alias at bottom. Remove obsolete __name__==”__main__” command.

Tools/Demos

  • bpo-14546: Fix the argument handling in Tools/scripts/lll.py.

C API

  • bpo-36763: Fix memory leak in Py_SetStandardStreamEncoding(): release memory if the function is called twice.

  • bpo-36641: PyDoc_VAR(name) and PyDoc_STRVAR(name, str) now create static const char name[] instead of static char name[]. Patch by Inada Naoki.

  • bpo-36389: Change the value of CLEANBYTE, DEADDYTE and FORBIDDENBYTE internal constants used by debug hooks on Python memory allocators (PyMem_SetupDebugHooks() function). Byte patterns 0xCB, 0xDB and 0xFB have been replaced with 0xCD, 0xDD and 0xFD to use the same values than Windows CRT debug malloc() and free().

  • bpo-36443: Since Python 3.7.0, calling Py_DecodeLocale() before Py_Initialize() produces mojibake if the LC_CTYPE locale is coerced and/or if the UTF-8 Mode is enabled by the user configuration. The LC_CTYPE coercion and UTF-8 Mode are now disabled by default to fix the mojibake issue. They must now be enabled explicitly (opt-in) using the new _Py_PreInitialize() API with _PyPreConfig.

  • bpo-36025: Fixed an accidental change to the datetime C API where the arguments to the PyDate_FromTimestamp() function were incorrectly interpreted as a single timestamp rather than an arguments tuple, which causes existing code to start raising TypeError. The backwards-incompatible change was only present in alpha releases of Python 3.8. Patch by Paul Ganssle.

  • bpo-35810: Modify PyObject_Init to correctly increase the refcount of heap-allocated Type objects. Also fix the refcounts of the heap-allocated types that were either doing this manually or not decreasing the type’s refcount in tp_dealloc

Python 3.8.0 alpha 3

Release date: 2019-03-25

Security

  • bpo-36216: Changes urlsplit() to raise ValueError when the URL contains characters that decompose under IDNA encoding (NFKC-normalization) into characters that affect how the URL is parsed.

  • bpo-35121: Don’t send cookies of domain A without Domain attribute to domain B when domain A is a suffix match of domain B while using a cookiejar with http.cookiejar.DefaultCookiePolicy policy. Patch by Karthikeyan Singaravelan.

Core and Builtins

  • bpo-36421: Fix a possible double decref in _ctypes.c’s PyCArrayType_new().

  • bpo-36412: Fix a possible crash when creating a new dictionary.

  • bpo-36398: Fix a possible crash in structseq_repr().

  • bpo-36256: Fix bug in parsermodule when parsing a state in a DFA that has two or more arcs with labels of the same type. Patch by Pablo Galindo.

  • bpo-36365: repr(structseq) is no longer limited to 512 bytes.

  • bpo-36374: Fix a possible null pointer dereference in merge_consts_recursive(). Patch by Zackery Spytz.

  • bpo-36236: At Python initialization, the current directory is no longer prepended to sys.path if it has been removed.

  • bpo-36352: Python initialization now fails with an error, rather than silently truncating paths, if a path is too long.

  • bpo-36301: Python initialization now fails if decoding pybuilddir.txt configuration file fails at startup.

  • bpo-36333: Fix leak in _PyRuntimeState_Fini. Contributed by Stéphane Wirtel.

  • bpo-36332: The builtin compile() can now handle AST objects that contain assignment expressions. Patch by Pablo Galindo.

  • bpo-36282: Improved error message for too much positional arguments in some builtin functions.

  • bpo-30040: New empty dict uses fewer memory for now. It used more memory than empty dict created by dict.clear(). And empty dict creation and deletion is about 2x faster. Patch by Inada Naoki.

  • bpo-36262: Fix an unlikely memory leak on conversion from string to float in the function _Py_dg_strtod() used by float(str), complex(str), pickle.load(), marshal.load(), etc.

  • bpo-36252: Update Unicode databases to version 12.0.0.

  • bpo-36218: Fix a segfault occurring when sorting a list of heterogeneous values. Patch contributed by Rémi Lapeyre and Elliot Gorokhovsky.

  • bpo-36188: Cleaned up left-over vestiges of Python 2 unbound method handling in method objects and documentation. Patch by Martijn Pieters

  • bpo-36124: Add a new interpreter-specific dict and expose it in the C-API via PyInterpreterState_GetDict(). This parallels PyThreadState_GetDict(). However, extension modules should continue using PyModule_GetState() for their own internal per-interpreter state.

  • bpo-35975: Add a feature_version flag to ast.parse() (documented) and compile() (hidden) that allows tweaking the parser to support older versions of the grammar. In particular, if feature_version is 5 or 6, the hacks for the async and await keyword from PEP 492 are reinstated. (For 7 or higher, these are unconditionally treated as keywords, but they are still special tokens rather than NAME tokens that the parser driver recognizes.)

  • bpo-31904: Use UTF-8 as the system encoding on VxWorks.

  • bpo-36048: The __index__() special method will be used instead of __int__() for implicit conversion of Python numbers to C integers. Using the __int__() method in implicit conversions has been deprecated.

  • bpo-35808: Retire pgen and use a modified version of pgen2 to generate the parser. Patch by Pablo Galindo.

Library

  • bpo-36401: The class documentation created by pydoc now has a separate section for readonly properties.

  • bpo-36320: The typing.NamedTuple() class has deprecated the _field_types attribute in favor of the __annotations__ attribute which carried the same information. Also, both attributes were converted from OrderedDict to a regular dict.

  • bpo-34745: Fix asyncio ssl memory issues caused by circular references

  • bpo-36324: Add method to statistics.NormalDist for computing the inverse cumulative normal distribution.

  • bpo-36321: collections.namedtuple() misspelled the name of an attribute. To be consistent with typing.NamedTuple, the attribute name should have been «_field_defaults» instead of «_fields_defaults». For backwards compatibility, both spellings are now created. The misspelled version may be removed in the future.

  • bpo-36297: «unicode_internal» codec is removed. It was deprecated since Python 3.3. Patch by Inada Naoki.

  • bpo-36298: Raise ModuleNotFoundError in pyclbr when a module can’t be found. Thanks to “mental” for the bug report.

  • bpo-36268: Switch the default format used for writing tars with tarfile to the modern POSIX.1-2001 pax standard, from the vendor-specific GNU. Contributed by C.A.M. Gerlach.

  • bpo-36285: Fix integer overflows in the array module. Patch by Stephan Hohe.

  • bpo-31904: Add _signal module support for VxWorks.

  • bpo-36272: logging does not silently ignore RecursionError anymore. Patch contributed by Rémi Lapeyre.

  • bpo-36280: Add a kind field to ast.Constant. It is “u” if the literal has a “u” prefix (i.e. a Python 2 style unicode literal), else None.

  • bpo-35931: The pdb debug command now gracefully handles all exceptions.

  • bpo-36251: Fix format strings used for stderrprinter and re.Match reprs. Patch by Stephan Hohe.

  • bpo-36235: Fix CFLAGS in customize_compiler() of distutils.sysconfig: when the CFLAGS environment variable is defined, don’t override CFLAGS variable with the OPT variable anymore. Initial patch written by David Malcolm.

  • bpo-35807: Update ensurepip to install pip 19.0.3 and setuptools 40.8.0.

  • bpo-36139: Release GIL when closing mmap objects.

  • bpo-36179: Fix two unlikely reference leaks in _hashopenssl. The leaks only occur in out-of-memory cases.

  • bpo-36169: Add overlap() method to statistics.NormalDist. Computes the overlapping coefficient for two normal distributions.

  • bpo-36103: Default buffer size used by shutil.copyfileobj() is changed from 16 KiB to 64 KiB on non-Windows platform to reduce system call overhead. Contributed by Inada Naoki.

  • bpo-36130: Fix pdb with skip=... when stepping into a frame without a __name__ global. Patch by Anthony Sottile.

  • bpo-35652: shutil.copytree(copy_function=…) erroneously pass DirEntry instead of a path string.

  • bpo-35178: Ensure custom warnings.formatwarning() function can receive line as positional argument. Based on patch by Tashrif Billah.

  • bpo-36106: Resolve potential name clash with libm’s sinpi(). Patch by Dmitrii Pasechnik.

  • bpo-36091: Clean up reference to async generator in Lib/types. Patch by Henry Chen.

  • bpo-36043: FileCookieJar supports path-like object. Contributed by Stéphane Wirtel

  • bpo-35899: Enum has been fixed to correctly handle empty strings and strings with non-Latin characters (ie. “α”, “א”) without crashing. Original patch contributed by Maxwell. Assisted by Stéphane Wirtel.

  • bpo-21269: Add args and kwargs properties to mock call objects. Contributed by Kumar Akshay.

  • bpo-30670: pprint.pp has been added to pretty-print objects with dictionary keys being sorted with their insertion order by default. Parameter sort_dicts has been added to pprint.pprint, pprint.pformat and pprint.PrettyPrinter. Contributed by Rémi Lapeyre.

  • bpo-35843: Implement __getitem__ for _NamespacePath. Patch by Anthony Sottile.

  • bpo-35802: Clean up code which checked presence of os.stat / os.lstat / os.chmod which are always present. Patch by Anthony Sottile.

  • bpo-35715: Librates the return value of a ProcessPoolExecutor _process_worker after it’s no longer needed to free memory

  • bpo-35493: Use multiprocessing.connection.wait() instead of polling each 0.2 seconds for worker updates in multiprocessing.Pool. Patch by Pablo Galindo.

  • bpo-35661: Store the venv prompt in pyvenv.cfg.

  • bpo-35121: Don’t set cookie for a request when the request path is a prefix match of the cookie’s path attribute but doesn’t end with «/». Patch by Karthikeyan Singaravelan.

  • bpo-21478: Calls to a child function created with unittest.mock.create_autospec() should propagate to the parent. Patch by Karthikeyan Singaravelan.

  • bpo-35198: Fix C++ extension compilation on AIX

Documentation

  • bpo-36329: Declare the path of the Python binary for the usage of Tools/scripts/serve.py when executing make -C Doc/ serve. Contributed by Stéphane Wirtel

  • bpo-36138: Improve documentation about converting datetime.timedelta to scalars.

  • bpo-21314: A new entry was added to the Core Language Section of the Programming FAQ, which explaines the usage of slash(/) in the signature of a function. Patch by Lysandros Nikolaou

Tests

  • bpo-36234: test_posix.PosixUidGidTests: add tests for invalid uid/gid type (str). Initial patch written by David Malcolm.

  • bpo-29571: Fix test_re.test_locale_flag(): use locale.getpreferredencoding() rather than locale.getlocale() to get the locale encoding. With some locales, locale.getlocale() returns the wrong encoding.

  • bpo-36123: Fix race condition in test_socket.

Build

  • bpo-36356: Fix leaks that led to build failure when configured with address sanitizer.

  • bpo-36146: Add TEST_EXTENSIONS constant to setup.py to allow to not build test extensions like _testcapi.

  • bpo-36146: Fix setup.py on macOS: only add /usr/include/ffi to include directories of _ctypes, not for all extensions.

  • bpo-31904: Enable build system to cross-build for VxWorks RTOS.

Windows

  • bpo-36312: Fixed decoders for the following code pages: 50220, 50221, 50222, 50225, 50227, 50229, 57002 through 57011, 65000 and 42.

  • bpo-36264: Don’t honor POSIX HOME in os.path.expanduser on windows. Patch by Anthony Sottile.

  • bpo-24643: Fix name collisions due to #define timezone _timezone in PC/pyconfig.h.

IDLE

  • bpo-36405: Use dict unpacking in idlelib.

  • bpo-36396: Remove fgBg param of idlelib.config.GetHighlight(). This param was only used twice and changed the return type.

  • bpo-36176: Fix IDLE autocomplete & calltip popup colors. Prevent conflicts with Linux dark themes (and slightly darken calltip background).

  • bpo-23205: For the grep module, add tests for findfiles, refactor findfiles to be a module-level function, and refactor findfiles to use os.walk.

  • bpo-23216: Add docstrings to IDLE search modules.

  • bpo-36152: Remove colorizer.ColorDelegator.close_when_done and the corresponding argument of .close(). In IDLE, both have always been None or False since 2007.

  • bpo-32129: Avoid blurry IDLE application icon on macOS with Tk 8.6. Patch by Kevin Walzer.

  • bpo-36096: Refactor class variables to instance variables in colorizer.

  • bpo-30348: Increase test coverage of idlelib.autocomplete by 30%. Patch by Louie Lu

Tools/Demos

  • bpo-35132: Fix py-list and py-bt commands of python-gdb.py on gdb7.

  • bpo-32217: Fix freeze script on Windows.

C API

  • bpo-36381: Raise DeprecationWarning when “#” formats are used for building or parsing values without PY_SSIZE_T_CLEAN.

  • bpo-36142: The whole coreconfig.h header is now excluded from Py_LIMITED_API. Move functions definitions into a new internal pycore_coreconfig.h header.

Python 3.8.0 alpha 2

Release date: 2019-02-25

Core and Builtins

  • bpo-36052: Raise a SyntaxError when assigning a value to __debug__ with the Assignment Operator. Contributed by Stéphane Wirtel and Pablo Galindo.

  • bpo-36012: Doubled the speed of class variable writes. When a non-dunder attribute was updated, there was an unnecessary call to update slots.

  • bpo-35942: The error message emitted when returning invalid types from __fspath__ in interfaces that allow passing PathLike objects has been improved and now it does explain the origin of the error.

  • bpo-36016: gc.get_objects can now receive an optional parameter indicating a generation to get objects from. Patch by Pablo Galindo.

  • bpo-1054041: When the main interpreter exits due to an uncaught KeyboardInterrupt, the process now exits in the appropriate manner for its parent process to detect that a SIGINT or ^C terminated the process. This allows shells and batch scripts to understand that the user has asked them to stop.

  • bpo-35992: Fix __class_getitem__() not being called on a class with a custom non-subscriptable metaclass.

  • bpo-35993: Fix a crash on fork when using subinterpreters. Contributed by Stéphane Wirtel

  • bpo-35991: Fix a potential double free in Modules/_randommodule.c.

  • bpo-35961: Fix a crash in slice_richcompare(): use strong references rather than stolen references for the two temporary internal tuples.

  • bpo-35911: Enable the creation of cell objects by adding a cell.__new__ method, and expose the type cell in Lib/types.py under the name CellType. Patch by Pierre Glaser.

  • bpo-12822: Use monotonic clock for pthread_cond_timedwait when pthread_condattr_setclock and CLOCK_MONOTONIC are available.

  • bpo-15248: The compiler emits now syntax warnings in the case when a comma is likely missed before tuple or list.

  • bpo-35886: The implementation of PyInterpreterState has been moved into the internal header files (guarded by Py_BUILD_CORE).

  • bpo-31506: Clarify the errors reported when object.__new__ and object.__init__ receive more than one argument. Contributed by Sanyam Khurana.

  • bpo-35724: Signal-handling is now guaranteed to happen relative to the main interpreter.

  • bpo-33608: We added a new internal _Py_AddPendingCall() that operates relative to the provided interpreter. This allows us to use the existing implementation to ask another interpreter to do work that cannot be done in the current interpreter, like decref an object the other interpreter owns. The existing Py_AddPendingCall() only operates relative to the main interpreter.

  • bpo-33989: Fix a possible crash in list.sort() when sorting objects with ob_type->tp_richcompare == NULL. Patch by Zackery Spytz.

Library

  • bpo-35512: unittest.mock.patch.dict() used as a decorator with string target resolves the target during function call instead of during decorator construction. Patch by Karthikeyan Singaravelan.

  • bpo-36018: Add statistics.NormalDist, a tool for creating and manipulating normal distributions of random variable. Features a composite class that treats the mean and standard deviation of measurement data as single entity.

  • bpo-35904: Added statistics.fmean() as a faster, floating-point variant of the existing mean() function.

  • bpo-35918: Removed broken has_key method from multiprocessing.managers.SyncManager.dict. Contributed by Rémi Lapeyre.

  • bpo-18283: Add support for bytes to shutil.which().

  • bpo-35960: Fix dataclasses.field() throwing away empty mapping objects passed as metadata.

  • bpo-35500: Write expected and actual call parameters on separate lines in unittest.mock.Mock.assert_called_with() assertion errors. Contributed by Susan Su.

  • bpo-35931: The pdb debug command now gracefully handles syntax errors.

  • bpo-24209: In http.server script, rely on getaddrinfo to bind to preferred address based on the bind parameter. Now default bind or binding to a name may bind to IPv6 or dual-stack, depending on the environment.

  • bpo-35321: Set __spec__.origin of _frozen_importlib to frozen so that it matches the behavior of _frozen_importlib_external. Patch by Nina Zakharenko.

  • bpo-35378: Fix a reference issue inside multiprocessing.Pool that caused the pool to remain alive if it was deleted without being closed or terminated explicitly. A new strong reference is added to the pool iterators to link the lifetime of the pool to the lifetime of its iterators so the pool does not get destroyed if a pool iterator is still alive.

  • bpo-34294: re module, fix wrong capturing groups in rare cases. re.search(), re.findall(), re.sub() and other functions that scan through string looking for a match, should reset capturing groups between two match attempts. Patch by Ma Lin.

  • bpo-35615: weakref: Fix a RuntimeError when copying a WeakKeyDictionary or a WeakValueDictionary, due to some keys or values disappearing while iterating.

  • bpo-35606: Implement math.prod() as analogous function to sum() that returns the product of a “start” value (default: 1) times an iterable of numbers. Patch by Pablo Galindo.

  • bpo-32417: Performing arithmetic between datetime.datetime subclasses and datetime.timedelta now returns an object of the same type as the datetime.datetime subclass. As a result, datetime.datetime.astimezone() and alternate constructors like datetime.datetime.now() and datetime.fromtimestamp() called with a tz argument now also retain their subclass.

  • bpo-35153: Add headers optional keyword-only parameter to xmlrpc.client.ServerProxy, xmlrpc.client.Transport and xmlrpc.client.SafeTransport. Patch by Cédric Krier.

  • bpo-34572: Fix C implementation of pickle.loads to use importlib’s locking mechanisms, and thereby avoid using partially loaded modules. Patch by Tim Burgess.

Documentation

  • bpo-36083: Fix formatting of –check-hash-based-pycs options in the manpage Synopsis.

  • bpo-36007: Bump minimum sphinx version to 1.8. Patch by Anthony Sottile.

  • bpo-22062: Update documentation and docstrings for pathlib. Original patch by Mike Short.

Tests

  • bpo-27313: Avoid test_ttk_guionly ComboboxTest failure with macOS Cocoa Tk.

  • bpo-36019: Add test.support.TEST_HTTP_URL and replace references of http://www.example.com by this new constant. Contributed by Stéphane Wirtel.

  • bpo-36037: Fix test_ssl for strict OpenSSL configuration like RHEL8 strict crypto policy. Use older TLS version for minimum TLS version of the server SSL context if needed, to test TLS version older than default minimum TLS version.

  • bpo-35798: Added test.support.check_syntax_warning().

  • bpo-35505: Make test_imap4_host_default_value independent on whether the local IMAP server is running.

  • bpo-35917: multiprocessing: provide unit tests for SyncManager and SharedMemoryManager classes + all the shareable types which are supposed to be supported by them. (patch by Giampaolo Rodola)

  • bpo-35704: Skip test_shutil.test_unpack_archive_xztar to prevent a MemoryError on 32-bit AIX when MAXDATA setting is less than 0x20000000.

    Patch by Michael Felt (aixtools)

  • bpo-34720: Assert m_state != NULL to mimic GC traversal functions that do not correctly handle module creation when the module state has not been created.

Windows

  • bpo-35976: Added ARM build support to Windows build files in PCBuild.

  • bpo-35692: pathlib no longer raises when checking file and directory existence on drives that are not ready

  • bpo-35872: Uses the base Python executable when invoking venv in a virtual environment

  • bpo-35873: Prevents venv paths being inherited by child processes

  • bpo-35299: Fix sysconfig detection of the source directory and distutils handling of pyconfig.h during PGO profiling

IDLE

  • bpo-24310: IDLE – Document settings dialog font tab sample.

  • bpo-35833: Revise IDLE doc for control codes sent to Shell. Add a code example block.

  • bpo-35689: Add docstrings and unittests for colorizer.py.

Python 3.8.0 alpha 1

Release date: 2019-02-03

Security

  • bpo-35746: CVE 2019-5010: Fix a NULL pointer deref in ssl module. The cert parser did not handle CRL distribution points with empty DP or URI correctly. A malicious or buggy certificate can result into segfault. Vulnerability (TALOS-2018-0758) reported by Colin Read and Nicolas Edet of Cisco.

  • bpo-34812: The -I command line option (run Python in isolated mode) is now also copied by the multiprocessing and distutils modules when spawning child processes. Previously, only -E and -s options (enabled by -I) were copied.

  • bpo-34791: The xml.sax and xml.dom.domreg no longer use environment variables to override parser implementations when sys.flags.ignore_environment is set by -E or -I arguments.

  • bpo-17239: The xml.sax and xml.dom.minidom parsers no longer processes external entities by default. External DTD and ENTITY declarations no longer load files or create network connections.

  • bpo-34623: CVE 2018-14647: The C accelerated _elementtree module now initializes hash randomization salt from _Py_HashSecret instead of libexpat’s default CSPRNG.

  • bpo-34405: Updated to OpenSSL 1.1.0i for Windows builds.

  • bpo-33871: Fixed sending the part of the file in os.sendfile() on macOS. Using the trailers argument could cause sending more bytes from the input file than was specified.

  • bpo-32533: Fixed thread-safety of error handling in _ssl.

  • bpo-33136: Harden ssl module against LibreSSL CVE 2018-8970. X509_VERIFY_PARAM_set1_host() is called with an explicit namelen. A new test ensures that NULL bytes are not allowed.

  • bpo-33001: Minimal fix to prevent buffer overrun in os.symlink on Windows

  • bpo-32981: Regexes in difflib and poplib were vulnerable to catastrophic backtracking. These regexes formed potential DOS vectors (REDOS). They have been refactored. This resolves CVE 2018-1060 and CVE 2018-1061. Patch by Jamie Davis.

  • bpo-28414: The ssl module now allows users to perform their own IDN en/decoding when using SNI.

Core and Builtins

  • bpo-35877: Make parenthesis optional for named expressions in while statement. Patch by Karthikeyan Singaravelan.

  • bpo-35814: Allow same right hand side expressions in annotated assignments as in normal ones. In particular, x: Tuple[int, int] = 1, 2 (without parentheses on the right) is now allowed.

  • bpo-35766: Add the option to parse PEP 484 type comments in the ast module. (Off by default.) This is merging the key functionality of the third party fork thereof, [typed_ast](https://github.com/python/typed_ast).

  • bpo-35713: Reorganize Python initialization to get working exceptions and sys.stderr earlier.

  • bpo-33416: Add end line and end column position information to the Python AST nodes. This is a C-level backwards incompatible change.

  • bpo-35720: Fixed a minor memory leak in pymain_parse_cmdline_impl function in Modules/main.c

  • bpo-35634: func(**kwargs) will now raise an error when kwargs is a mapping containing multiple entries with the same key. An error was already raised when other keyword arguments are passed before **kwargs since Python 3.6.

  • bpo-35623: Fix a crash when sorting very long lists. Patch by Stephan Hohe.

  • bpo-35214: clang Memory Sanitizer build instrumentation was added to work around false positives from posix, socket, time, test_io, and test_faulthandler.

  • bpo-35560: Fix an assertion error in format() in debug build for floating-point formatting with «n» format, zero padding and small width. Release build is not impacted. Patch by Karthikeyan Singaravelan.

  • bpo-35552: Format characters %s and %V in PyUnicode_FromFormat() and %s in PyBytes_FromFormat() no longer read memory past the limit if precision is specified.

  • bpo-35504: Fix segfaults and SystemErrors when deleting certain attributes. Patch by Zackery Spytz.

  • bpo-35504: Fixed a SystemError when delete the characters_written attribute of an OSError.

  • bpo-35494: Improved syntax error messages for unbalanced parentheses in f-string.

  • bpo-35444: Fixed error handling in pickling methods when fail to look up builtin «getattr». Sped up pickling iterators.

  • bpo-35436: Fix various issues with memory allocation error handling. Patch by Zackery Spytz.

  • bpo-35423: Separate the signal handling trigger in the eval loop from the «pending calls» machinery. There is no semantic change and the difference in performance is insignificant.

  • bpo-35357: Internal attributes” names of unittest.mock._Call and unittest.mock.MagicProxy (name, parent & from_kall) are now prefixed with _mock_ in order to prevent clashes with widely used object attributes. Fixed minor typo in test function name.

  • bpo-35372: Fixed the code page decoder for input longer than 2 GiB containing undecodable bytes.

  • bpo-35336: Fix PYTHONCOERCECLOCALE=1 environment variable: only coerce the C locale if the LC_CTYPE locale is «C».

  • bpo-31241: The lineno and col_offset attributes of AST nodes for list comprehensions, generator expressions and tuples are now point to the opening parenthesis or square brace. For tuples without parenthesis they point to the position of the first item.

  • bpo-33954: For str.format(), float.__format__() and complex.__format__() methods for non-ASCII decimal point when using the «n» formatter.

  • bpo-35269: Fix a possible segfault involving a newly created coroutine. Patch by Zackery Spytz.

  • bpo-35224: Implement PEP 572 (assignment expressions). Patch by Emily Morehouse.

  • bpo-32492: Speed up namedtuple() attribute access by 1.6x using a C fast-path for the name descriptors. Patch by Pablo Galindo.

  • bpo-35214: Fixed an out of bounds memory access when parsing a truncated unicode escape sequence at the end of a string such as '\N'. It would read one byte beyond the end of the memory allocation.

  • bpo-35214: The interpreter and extension modules have had annotations added so that they work properly under clang’s Memory Sanitizer. A new configure flag –with-memory-sanitizer has been added to make test builds of this nature easier to perform.

  • bpo-35193: Fix an off by one error in the bytecode peephole optimizer where it could read bytes beyond the end of bounds of an array when removing unreachable code. This bug was present in every release of Python 3.6 and 3.7 until now.

  • bpo-35169: Improved error messages for forbidden assignments.

  • bpo-34022: Fix handling of hash-based bytecode files in zipimport. Patch by Elvis Pranskevichus.

  • bpo-28401: Debug builds will no longer to attempt to import extension modules built for the ABI as they were never compatible to begin with. Patch by Stefano Rivera.

  • bpo-29341: Clarify in the docstrings of os methods that path-like objects are also accepted as input parameters.

  • bpo-35050: socket: Fix off-by-one bug in length check for AF_ALG name and type.

  • bpo-29743: Raise ValueError instead of OverflowError in case of a negative _length_ in a ctypes.Array subclass. Also raise TypeError instead of AttributeError for non-integer _length_. Original patch by Oren Milman.

  • bpo-16806: Fix lineno and col_offset for multi-line string tokens.

  • bpo-35029: SyntaxWarning raised as an exception at code generation time will be now replaced with a SyntaxError for better error reporting.

  • bpo-34983: Expose symtable.Symbol.is_nonlocal() in the symtable module. Patch by Pablo Galindo.

  • bpo-34974: bytes and bytearray constructors no longer convert unexpected exceptions (e.g. MemoryError and KeyboardInterrupt) to TypeError.

  • bpo-34939: Allow annotated names in module namespace that are declared global before the annotation happens. Patch by Pablo Galindo.

  • bpo-34973: Fixed crash in bytes() when the list argument is mutated while it is iterated.

  • bpo-34876: The lineno and col_offset attributes of the AST for decorated function and class refer now to the position of the corresponding def, async def and class instead of the position of the first decorator. This leads to more correct line reporting in tracing. This is the only case when the position of child AST nodes can precede the position of the parent AST node.

  • bpo-34879: Fix a possible null pointer dereference in bytesobject.c. Patch by Zackery Spytz.

  • bpo-34784: Fix the implementation of PyStructSequence_NewType in order to create heap allocated StructSequences.

  • bpo-32912: A SyntaxWarning is now emitted instead of a DeprecationWarning for invalid escape sequences in string and bytes literals.

  • bpo-34854: Fixed a crash in compiling string annotations containing a lambda with a keyword-only argument that doesn’t have a default value.

  • bpo-34850: The compiler now produces a SyntaxWarning when identity checks (is and is not) are used with certain types of literals (e.g. strings, ints). These can often work by accident in CPython, but are not guaranteed by the language spec. The warning advises users to use equality tests (== and !=) instead.

  • bpo-34824: Fix a possible null pointer dereference in Modules/_ssl.c. Patch by Zackery Spytz.

  • bpo-30156: The C function property_descr_get() uses a «cached» tuple to optimize function calls. But this tuple can be discovered in debug mode with sys.getobjects(). Remove the optimization, it’s not really worth it and it causes 3 different crashes last years.

  • bpo-34762: Fix contextvars C API to use PyObject* pointer types.

  • bpo-34751: The hash function for tuples is now based on xxHash which gives better collision results on (formerly) pathological cases. Additionally, on 64-bit systems it improves tuple hashes in general. Patch by Jeroen Demeyer with substantial contributions by Tim Peters.

  • bpo-34735: Fix a memory leak in Modules/timemodule.c. Patch by Zackery Spytz.

  • bpo-34683: Fixed a bug where some SyntaxError error pointed to locations that were off-by-one.

  • bpo-34651: Only allow the main interpreter to fork. The avoids the possibility of affecting the main interpreter, which is critical to operation of the runtime.

  • bpo-34653: Remove unused function PyParser_SimpleParseStringFilename.

  • bpo-32236: Warn that line buffering is not supported if open() is called with binary mode and buffering=1.

  • bpo-34641: Further restrict the syntax of the left-hand side of keyword arguments in function calls. In particular, f((keyword)=arg) is now disallowed.

  • bpo-34637: Make the start argument to sum() visible as a keyword argument.

  • bpo-1621: Do not assume signed integer overflow behavior (C undefined behavior) when performing set hash table resizing.

  • bpo-34588: Fix an off-by-one in the recursive call pruning feature of traceback formatting.

  • bpo-34485: On Windows, the LC_CTYPE is now set to the user preferred locale at startup. Previously, the LC_CTYPE locale was «C» at startup, but changed when calling setlocale(LC_CTYPE, «») or setlocale(LC_ALL, «»).

  • bpo-34485: Standard streams like sys.stdout now use the «surrogateescape» error handler, instead of «strict», on the POSIX locale (when the C locale is not coerced and the UTF-8 Mode is disabled).

  • bpo-34485: Fix the error handler of standard streams like sys.stdout: PYTHONIOENCODING=»:» is now ignored instead of setting the error handler to «strict».

  • bpo-34485: Python now gets the locale encoding with C code to initialize the encoding of standard streams like sys.stdout. Moreover, the encoding is now initialized to the Python codec name to get a normalized encoding name and to ensure that the codec is loaded. The change avoids importing _bootlocale and _locale modules at startup by default.

  • bpo-34527: On FreeBSD, Py_DecodeLocale() and Py_EncodeLocale() now also forces the ASCII encoding if the LC_CTYPE locale is «POSIX», not only if the LC_CTYPE locale is «C».

  • bpo-34527: The UTF-8 Mode is now also enabled by the «POSIX» locale, not only by the «C» locale.

  • bpo-34403: On HP-UX with C or POSIX locale, sys.getfilesystemencoding() now returns «ascii» instead of «roman8» (when the UTF-8 Mode is disabled and the C locale is not coerced).

  • bpo-34523: The Python filesystem encoding is now read earlier during the Python initialization.

  • bpo-12458: Tracebacks show now correct line number for subexpressions in multiline expressions. Tracebacks show now the line number of the first line for multiline expressions instead of the line number of the last subexpression.

  • bpo-34408: Prevent a null pointer dereference and resource leakage in PyInterpreterState_New().

  • bpo-34400: Fix undefined behavior in parsetok.c. Patch by Zackery Spytz.

  • bpo-33073: Added as_integer_ratio to ints to make them more interoperable with floats.

  • bpo-34377: Update valgrind suppression list to use _PyObject_Free/_PyObject_Realloc instead of PyObject_Free/PyObject_Realloc.

  • bpo-34353: Added the «socket» option in the stat.filemode() Python implementation to match the C implementation.

  • bpo-34320: Fix dict(od) didn’t copy iteration order of OrderedDict.

  • bpo-34113: Fixed crash on debug builds when opcode stack was adjusted with negative numbers. Patch by Constantin Petrisor.

  • bpo-34100: Compiler now merges constants in tuples and frozensets recursively. Code attributes like co_names are merged too.

  • bpo-34151: Performance of list concatenation, repetition and slicing operations is slightly improved. Patch by Sergey Fedoseev.

  • bpo-34170: -X dev: it is now possible to override the memory allocator using PYTHONMALLOC even if the developer mode is enabled.

  • bpo-33237: Improved AttributeError message for partially initialized module.

  • bpo-34149: Fix min and max functions to get default behavior when key is None.

  • bpo-34125: Profiling of unbound built-in methods now works when **kwargs is given.

  • bpo-34141: Optimized pickling atomic types (None, bool, int, float, bytes, str).

  • bpo-34126: Fix crashes when profiling certain invalid calls of unbound methods. Patch by Jeroen Demeyer.

  • bpo-24618: Fixed reading invalid memory when create the code object with too small varnames tuple or too large argument counts.

  • bpo-34068: In io.IOBase.close(), ensure that the closed attribute is not set with a live exception. Patch by Zackery Spytz and Serhiy Storchaka.

  • bpo-34087: Fix buffer overflow while converting unicode to numeric values.

  • bpo-34080: Fixed a memory leak in the compiler when it raised some uncommon errors during tokenizing.

  • bpo-34066: Disabled interruption by Ctrl-C between calling open() and entering a with block in with open().

  • bpo-34042: Fix dict.copy() to maintain correct total refcount (as reported by sys.gettotalrefcount()).

  • bpo-33418: Fix potential memory leak in function object when it creates reference cycle.

  • bpo-33985: Implement contextvars.ContextVar.name attribute.

  • bpo-33956: Update vendored Expat library copy to version 2.2.5.

  • bpo-24596: Decref the module object in PyRun_SimpleFileExFlags() before calling PyErr_Print(). Patch by Zackery Spytz.

  • bpo-33451: Close directly executed pyc files before calling PyEval_EvalCode().

  • bpo-1617161: The hash of BuiltinMethodType instances (methods of built-in classes) now depends on the hash of the identity of __self__ instead of its value. The hash and equality of ModuleType and MethodWrapperType instances (methods of user-defined classes and some methods of built-in classes like str.__add__) now depend on the hash and equality of the identity of __self__ instead of its value. MethodWrapperType instances no longer support ordering.

  • bpo-33824: Fix «LC_ALL=C python3.7 -V»: reset properly the command line parser when the encoding changes after reading the Python configuration.

  • bpo-33803: Fix a crash in hamt.c caused by enabling GC tracking for an object that hadn’t all of its fields set to NULL.

  • bpo-33738: Seven macro incompatibilities with the Limited API were fixed, and the macros PyIter_Check(), PyIndex_Check() and PyExceptionClass_Name() were added as functions. A script for automatic macro checks was added.

  • bpo-33786: Fix asynchronous generators to handle GeneratorExit in athrow() correctly

  • bpo-30167: PyRun_SimpleFileExFlags removes __cached__ from module in addition to __file__.

  • bpo-33706: Fix a crash in Python initialization when parsing the command line options. Thanks Christoph Gohlke for the bug report and the fix!

  • bpo-33597: Reduce PyGC_Head size from 3 words to 2 words.

  • bpo-30654: Fixed reset of the SIGINT handler to SIG_DFL on interpreter shutdown even when there was a custom handler set previously. Patch by Philipp Kerling.

  • bpo-33622: Fixed a leak when the garbage collector fails to add an object with the __del__ method or referenced by it into the gc.garbage list. PyGC_Collect() can now be called when an exception is set and preserves it.

  • bpo-33462: Make dict and dict views reversible. Patch by Rémi Lapeyre.

  • bpo-23722: A RuntimeError is now raised when the custom metaclass doesn’t provide the __classcell__ entry in the namespace passed to type.__new__. A DeprecationWarning was emitted in Python 3.6–3.7.

  • bpo-33499: Add PYTHONPYCACHEPREFIX environment variable and -X pycache_prefix command-line option to set an alternate root directory for writing module bytecode cache files.

  • bpo-25711: The zipimport module has been rewritten in pure Python.

  • bpo-33509: Fix module_globals parameter of warnings.warn_explicit(): don’t crash if module_globals is not a dict.

  • bpo-31849: Fix signed/unsigned comparison warning in pyhash.c.

  • bpo-33475: Fixed miscellaneous bugs in converting annotations to strings and optimized parentheses in the string representation.

  • bpo-20104: Added support for the setpgroup, resetids, setsigmask, setsigdef and scheduler parameters of posix_spawn. Patch by Pablo Galindo.

  • bpo-33391: Fix a leak in set_symmetric_difference().

  • bpo-33363: Raise a SyntaxError for async with and async for statements outside of async functions.

  • bpo-28055: Fix unaligned accesses in siphash24(). Patch by Rolf Eike Beer.

  • bpo-33128: Fix a bug that causes PathFinder to appear twice on sys.meta_path. Patch by Pablo Galindo Salgado.

  • bpo-33331: Modules imported last are now cleared first at interpreter shutdown.

  • bpo-33312: Fixed clang ubsan (undefined behavior sanitizer) warnings in dictobject.c by adjusting how the internal struct _dictkeysobject shared keys structure is declared.

  • bpo-33305: Improved syntax error messages for invalid numerical literals.

  • bpo-33306: Improved syntax error messages for unbalanced parentheses.

  • bpo-33234: The list constructor will pre-size and not over-allocate when the input length is known.

  • bpo-33270: Intern the names for all anonymous code objects. Patch by Zackery Spytz.

  • bpo-30455: The C and Python code and the documentation related to tokens are now generated from a single source file Grammar/Tokens.

  • bpo-33176: Add a toreadonly() method to memoryviews.

  • bpo-33231: Fix potential memory leak in normalizestring().

  • bpo-33205: Change dict growth function from round_up_to_power_2(used*2+hashtable_size/2) to round_up_to_power_2(used*3). Previously, dict is shrunk only when used == 0. Now dict has more chance to be shrunk.

  • bpo-29922: Improved error messages in “async with” when __aenter__() or __aexit__() return non-awaitable object.

  • bpo-33199: Fix ma_version_tag in dict implementation is uninitialized when copying from key-sharing dict.

  • bpo-33053: When using the -m switch, sys.path[0] is now explicitly expanded as the starting working directory, rather than being left as the empty path (which allows imports from the current working directory at the time of the import)

  • bpo-33138: Changed standard error message for non-pickleable and non-copyable types. It now says «cannot pickle» instead of «can’t pickle» or «cannot serialize».

  • bpo-33018: Improve consistency of errors raised by issubclass() when called with a non-class and an abstract base class as the first and second arguments, respectively. Patch by Josh Bronson.

  • bpo-33083: math.factorial no longer accepts arguments that are not int-like. Patch by Pablo Galindo.

  • bpo-33041: Added new opcode END_ASYNC_FOR and fixes the following issues:

    • Setting global StopAsyncIteration no longer breaks async for loops.

    • Jumping into an async for loop is now disabled.

    • Jumping out of an async for loop no longer corrupts the stack.

  • bpo-25750: Fix rare Python crash due to bad refcounting in type_getattro() if a descriptor deletes itself from the class. Patch by Jeroen Demeyer.

  • bpo-33041: Fixed bytecode generation for «async for» with a complex target. A StopAsyncIteration raised on assigning or unpacking will be now propagated instead of stopping the iteration.

  • bpo-33026: Fixed jumping out of «with» block by setting f_lineno.

  • bpo-33005: Fix a crash on fork when using a custom memory allocator (ex: using PYTHONMALLOC env var). _PyGILState_Reinit() and _PyInterpreterState_Enable() now use the default RAW memory allocator to allocate a new interpreters mutex on fork.

  • bpo-32911: Due to unexpected compatibility issues discovered during downstream beta testing, reverted bpo-29463. docstring field is removed from Module, ClassDef, FunctionDef, and AsyncFunctionDef ast nodes which was added in 3.7a1. Docstring expression is restored as a first statement in their body. Based on patch by Inada Naoki.

  • bpo-17288: Prevent jumps from “return” and “exception” trace events.

  • bpo-32946: Importing names from already imported module with «from … import …» is now 30% faster if the module is not a package.

  • bpo-32932: Make error message more revealing when there are non-str objects in __all__.

  • bpo-32925: Optimized iterating and containing test for literal lists consisting of non-constants: x in [a, b] and for x in [a, b]. The case of all constant elements already was optimized.

  • bpo-32889: Update Valgrind suppression list to account for the rename of Py_ADDRESS_IN_RANG to address_in_range.

  • bpo-32836: Don’t use temporary variables in cases of list/dict/set comprehensions

  • bpo-31356: Remove the new API added in bpo-31356 (gc.ensure_disabled() context manager).

  • bpo-32305: For namespace packages, ensure that both __file__ and __spec__.origin are set to None.

  • bpo-32303: Make sure __spec__.loader matches __loader__ for namespace packages.

  • bpo-32711: Fix the warning messages for Python/ast_unparse.c. Patch by Stéphane Wirtel

  • bpo-32583: Fix possible crashing in builtin Unicode decoders caused by write out-of-bound errors when using customized decode error handlers.

  • bpo-32489: A continue statement is now allowed in the finally clause.

  • bpo-17611: Simplified the interpreter loop by moving the logic of unrolling the stack of blocks into the compiler. The compiler emits now explicit instructions for adjusting the stack of values and calling the cleaning up code for break, continue and return.

    Removed opcodes BREAK_LOOP, CONTINUE_LOOP, SETUP_LOOP and SETUP_EXCEPT. Added new opcodes ROT_FOUR, BEGIN_FINALLY and CALL_FINALLY and POP_FINALLY. Changed the behavior of END_FINALLY and WITH_CLEANUP_START.

  • bpo-32285: New function unicodedata.is_normalized, which can check whether a string is in a specific normal form.

  • bpo-10544: Yield expressions are now disallowed in comprehensions and generator expressions except the expression for the outermost iterable.

  • bpo-32117: Iterable unpacking is now allowed without parentheses in yield and return statements, e.g. yield 1, 2, 3, *rest. Thanks to David Cuthbert for the change and Jordan Chapman for added tests.

  • bpo-31902: Fix the col_offset attribute for ast nodes ast.AsyncFor, ast.AsyncFunctionDef, and ast.AsyncWith. Previously, col_offset pointed to the keyword after async.

  • bpo-25862: Fix assertion failures in the tell() method of io.TextIOWrapper. Patch by Zackery Spytz.

  • bpo-21983: Fix a crash in ctypes.cast() in case the type argument is a ctypes structured data type. Patch by Eryk Sun and Oren Milman.

  • bpo-31577: Fix a crash in os.utime() in case of a bad ns argument. Patch by Oren Milman.

  • bpo-29832: Remove references to “getsockaddrarg” from various socket error messages. Patch by Oren Milman.

Library

  • bpo-35845: Add “order” parameter to memoryview.tobytes().

  • bpo-35864: The _asdict() method for collections.namedtuple now returns a regular dict instead of an OrderedDict.

  • bpo-35537: An ExitStack is now used internally within subprocess.Popen to clean up pipe file handles. No behavior change in normal operation. But if closing one handle were ever to cause an exception, the others will now be closed instead of leaked. (patch by Giampaolo Rodola)

  • bpo-35847: RISC-V needed the CTYPES_PASS_BY_REF_HACK. Fixes ctypes Structure test_pass_by_value.

  • bpo-35813: Shared memory submodule added to multiprocessing to avoid need for serialization between processes

  • bpo-35780: Fix lru_cache() errors arising in recursive, reentrant, or multi-threaded code. These errors could result in orphan links and in the cache being trapped in a state with fewer than the specified maximum number of links. Fix handling of negative maxsize which should have been treated as zero. Fix errors in toggling the «full» status flag. Fix misordering of links when errors are encountered. Sync-up the C code and pure Python code for the space saving path in functions with a single positional argument. In this common case, the space overhead of an lru cache entry is reduced by almost half. Fix counting of cache misses. In error cases, the miss count was out of sync with the actual number of times the underlying user function was called.

  • bpo-35537: os.posix_spawn() and os.posix_spawnp() now have a setsid parameter.

  • bpo-23846: asyncio.ProactorEventLoop now catches and logs send errors when the self-pipe is full.

  • bpo-34323: asyncio: Enhance IocpProactor.close() log: wait 1 second before the first log, then log every second. Log also the number of seconds since close() was called.

  • bpo-35674: Add a new os.posix_spawnp() function. Patch by Joannah Nanjekye.

  • bpo-35733: ast.Constant(boolean) no longer an instance of ast.Num. Patch by Anthony Sottile.

  • bpo-35726: QueueHandler.prepare() now makes a copy of the record before modifying and enqueueing it, to avoid affecting other handlers in the chain.

  • bpo-35719: Sped up multi-argument math functions atan2(), copysign(), remainder() and hypot() by 1.3–2.5 times.

  • bpo-35717: Fix KeyError exception raised when using enums and compile. Patch contributed by Rémi Lapeyre.

  • bpo-35699: Fixed detection of Visual Studio Build Tools 2017 in distutils

  • bpo-32710: Fix memory leaks in asyncio ProactorEventLoop on overlapped operation failure.

  • bpo-35702: The time.CLOCK_UPTIME_RAW constant is now available for macOS 10.12.

  • bpo-32710: Fix a memory leak in asyncio in the ProactorEventLoop when ReadFile() or WSASend() overlapped operation fail immediately: release the internal buffer.

  • bpo-35682: Fix asyncio.ProactorEventLoop.sendfile(): don’t attempt to set the result of an internal future if it’s already done.

  • bpo-35283: Add a deprecated warning for the threading.Thread.isAlive() method. Patch by Donghee Na.

  • bpo-35664: Improve operator.itemgetter() performance by 33% with optimized argument handling and with adding a fast path for the common case of a single non-negative integer index into a tuple (which is the typical use case in the standard library).

  • bpo-35643: Fixed a SyntaxWarning: invalid escape sequence in Modules/_sha3/cleanup.py. Patch by Mickaël Schoentgen.

  • bpo-35619: Improved support of custom data descriptors in help() and pydoc.

  • bpo-28503: The crypt module now internally uses the crypt_r() library function instead of crypt() when available.

  • bpo-35614: Fixed help() on metaclasses. Patch by Sanyam Khurana.

  • bpo-35568: Expose raise(signum) as raise_signal

  • bpo-35588: The floor division and modulo operations and the divmod() function on fractions.Fraction types are 2–4x faster. Patch by Stefan Behnel.

  • bpo-35585: Speed-up building enums by value, e.g. http.HTTPStatus(200).

  • bpo-30561: random.gammavariate(1.0, beta) now computes the same result as random.expovariate(1.0 / beta). This synchronizes the two algorithms and eliminates some idiosyncrasies in the old implementation. It does however produce a difference stream of random variables than it used to.

  • bpo-35537: The subprocess module can now use the os.posix_spawn() function in some cases for better performance.

  • bpo-35526: Delaying the “joke” of barry_as_FLUFL.mandatory to Python version 4.0

  • bpo-35523: Remove ctypes callback workaround: no longer create a callback at startup. Avoid SELinux alert on import ctypes and import uuid.

  • bpo-31784: uuid.uuid1() now calls time.time_ns() rather than int(time.time() * 1e9).

  • bpo-35513: TextTestRunner of unittest.runner now uses time.perf_counter() rather than time.time() to measure the execution time of a test: time.time() can go backwards, whereas time.perf_counter() is monotonic.

  • bpo-35502: Fixed reference leaks in xml.etree.ElementTree.TreeBuilder in case of unfinished building of the tree (in particular when an error was raised during parsing XML).

  • bpo-35348: Make platform.architecture() parsing of file command output more reliable: add the -b option to the file command to omit the filename, force the usage of the C locale, and search also the «shared object» pattern.

  • bpo-35491: multiprocessing: Add Pool.__repr__() and enhance BaseProcess.__repr__() (add pid and parent pid) to ease debugging. Pool state constant values are now strings instead of integers, for example RUN value becomes 'RUN' instead of 0.

  • bpo-35477: multiprocessing.Pool.__enter__() now fails if the pool is not running: with pool: fails if used more than once.

  • bpo-31446: Copy command line that was passed to CreateProcessW since this function can change the content of the input buffer.

  • bpo-35471: Python 2.4 dropped MacOS 9 support. The macpath module was deprecated in Python 3.7. The module is now removed.

  • bpo-23057: Unblock Proactor event loop when keyboard interrupt is received on Windows

  • bpo-35052: Fix xml.dom.minidom cloneNode() on a document with an entity: pass the correct arguments to the user data handler of an entity.

  • bpo-20239: Allow repeated assignment deletion of unittest.mock.Mock attributes. Patch by Pablo Galindo.

  • bpo-17185: Set __signature__ on mock for inspect to get signature. Patch by Karthikeyan Singaravelan.

  • bpo-35445: Memory errors during creating posix.environ no longer ignored.

  • bpo-35415: Validate fileno= argument to socket.socket().

  • bpo-35424: multiprocessing.Pool destructor now emits ResourceWarning if the pool is still running.

  • bpo-35330: When a Mock instance was used to wrap an object, if side_effect is used in one of the mocks of it methods, don’t call the original implementation and return the result of using the side effect the same way that it is done with return_value.

  • bpo-35346: Drop Mac OS 9 and Rhapsody support from the platform module. Rhapsody last release was in 2000. Mac OS 9 last release was in 2001.

  • bpo-10496: check_environ() of distutils.utils now catches KeyError on calling pwd.getpwuid(): don’t create the HOME environment variable in this case.

  • bpo-10496: posixpath.expanduser() now returns the input path unchanged if the HOME environment variable is not set and the current user has no home directory (if the current user identifier doesn’t exist in the password database). This change fix the site module if the current user doesn’t exist in the password database (if the user has no home directory).

  • bpo-35389: platform.libc_ver() now uses os.confstr('CS_GNU_LIBC_VERSION') if available and the executable parameter is not set.

  • bpo-35394: Add empty slots to asyncio abstract protocols.

  • bpo-35310: Fix a bug in select.select() where, in some cases, the file descriptor sequences were returned unmodified after a signal interruption, even though the file descriptors might not be ready yet. select.select() will now always return empty lists if a timeout has occurred. Patch by Oran Avraham.

  • bpo-35380: Enable TCP_NODELAY on Windows for proactor asyncio event loop.

  • bpo-35341: Add generic version of collections.OrderedDict to the typing module. Patch by Ismo Toijala.

  • bpo-35371: Fixed possible crash in os.utime() on Windows when pass incorrect arguments.

  • bpo-35346: platform.uname() now redirects stderr to os.devnull when running external programs like cmd /c ver.

  • bpo-35066: Previously, calling the strftime() method on a datetime object with a trailing “%” in the format string would result in an exception. However, this only occurred when the datetime C module was being used; the python implementation did not match this behavior. Datetime is now PEP-399 compliant, and will not throw an exception on a trailing “%”.

  • bpo-35345: The function platform.popen has been removed, it was deprecated since Python 3.3: use os.popen() instead.

  • bpo-35344: On macOS, platform.platform() now uses platform.mac_ver(), if it returns a non-empty release string, to get the macOS version rather than the darwin version.

  • bpo-35312: Make lib2to3.pgen2.parse.ParseError round-trip pickle-able. Patch by Anthony Sottile.

  • bpo-35308: Fix regression in webbrowser where default browsers may be preferred over browsers in the BROWSER environment variable.

  • bpo-24746: Avoid stripping trailing whitespace in doctest fancy diff. Original patch by R. David Murray & Jairo Trad. Enhanced by Sanyam Khurana.

  • bpo-28604: locale.localeconv() now sets temporarily the LC_CTYPE locale to the LC_MONETARY locale if the two locales are different and monetary strings are non-ASCII. This temporary change affects other threads.

  • bpo-35277: Update ensurepip to install pip 18.1 and setuptools 40.6.2.

  • bpo-24209: Adds IPv6 support when invoking http.server directly.

  • bpo-35226: Recursively check arguments when testing for equality of unittest.mock.call objects and add note that tracking of parameters used to create ancestors of mocks in mock_calls is not possible.

  • bpo-29564: The warnings module now suggests to enable tracemalloc if the source is specified, the tracemalloc module is available, but tracemalloc is not tracing memory allocations.

  • bpo-35189: Modify the following fnctl function to retry if interrupted by a signal (EINTR): flock, lockf, fnctl

  • bpo-30064: Use add_done_callback() in sock_* asyncio API to unsubscribe reader/writer early on calcellation.

  • bpo-35186: Removed the «built with» comment added when setup.py upload is used with either bdist_rpm or bdist_dumb.

  • bpo-35152: Allow sending more than 2 GB at once on a multiprocessing connection on non-Windows systems.

  • bpo-35062: Fix incorrect parsing of io.IncrementalNewlineDecoder’s translate argument.

  • bpo-35065: Remove StreamReaderProtocol._untrack_reader. The call to _untrack_reader is currently performed too soon, causing the protocol to forget about the reader before connection_lost can run and feed the EOF to the reader.

  • bpo-34160: ElementTree and minidom now preserve the attribute order specified by the user.

  • bpo-35079: Improve difflib.SequenceManager.get_matching_blocks doc by adding “non-overlapping” and changing “!=” to “<”.

  • bpo-33710: Deprecated l*gettext() functions and methods in the gettext module. They return encoded bytes instead of Unicode strings and are artifacts from Python 2 times. Also deprecated functions and methods related to setting the charset for l*gettext() functions and methods.

  • bpo-35017: socketserver.BaseServer.serve_forever() now exits immediately if it’s shutdown() method is called while it is polling for new events.

  • bpo-35024: importlib no longer logs wrote <bytecode path> redundantly after (created|could not create) <bytecode path> is already logged. Patch by Quentin Agren.

  • bpo-35047: unittest.mock now includes mock calls in exception messages if assert_not_called, assert_called_once, or assert_called_once_with fails. Patch by Petter Strandmark.

  • bpo-31047: Fix ntpath.abspath regression where it didn’t remove a trailing separator on Windows. Patch by Tim Graham.

  • bpo-35053: tracemalloc now tries to update the traceback when an object is reused from a «free list» (optimization for faster object creation, used by the builtin list type for example).

  • bpo-31553: Add the –json-lines option to json.tool. Patch by hongweipeng.

  • bpo-34794: Fixed a leak in Tkinter when pass the Python wrapper around Tcl_Obj back to Tcl/Tk.

  • bpo-34909: Enum: fix grandchildren subclassing when parent mixed with concrete data types.

  • bpo-35022: unittest.mock.MagicMock now supports the __fspath__ method (from os.PathLike).

  • bpo-35008: Fixed references leaks when call the __setstate__() method of xml.etree.ElementTree.Element in the C implementation for already initialized element.

  • bpo-23420: Verify the value for the parameter “-s” of the cProfile CLI. Patch by Robert Kuska

  • bpo-33947: dataclasses now handle recursive reprs without raising RecursionError.

  • bpo-34890: Make inspect.iscoroutinefunction(), inspect.isgeneratorfunction() and inspect.isasyncgenfunction() work with functools.partial(). Patch by Pablo Galindo.

  • bpo-34521: Use socket.CMSG_SPACE() to calculate ancillary data size instead of socket.CMSG_LEN() in multiprocessing.reduction.recvfds() as RFC 3542 requires the use of the former for portable applications.

  • bpo-31522: The mailbox.mbox.get_string function from_ parameter can now successfully be set to a non-default value.

  • bpo-34970: Protect tasks weak set manipulation in asyncio.all_tasks()

  • bpo-34969: gzip: Add –fast, –best on the gzip CLI, these parameters will be used for the fast compression method (quick) or the best method compress (slower, but smaller file). Also, change the default compression level to 6 (tradeoff).

  • bpo-16965: The 2to3 execfile fixer now opens the file with mode 'rb'. Patch by Zackery Spytz.

  • bpo-34966: pydoc now supports aliases not only to methods defined in the end class, but also to inherited methods. The docstring is not duplicated for aliases.

  • bpo-34926: mimetypes.MimeTypes.guess_type() now accepts path-like object in addition to url strings. Patch by Mayank Asthana.

  • bpo-23831: Add moveto() method to the tkinter.Canvas widget. Patch by Juliette Monsel.

  • bpo-34941: Methods find(), findtext() and findall() of the Element class in the xml.etree.ElementTree module are now able to find children which are instances of Element subclasses.

  • bpo-32680: smtplib.SMTP objects now always have a sock attribute present

  • bpo-34769: Fix for async generators not finalizing when event loop is in debug mode and garbage collector runs in another thread.

  • bpo-34936: Fix TclError in tkinter.Spinbox.selection_element(). Patch by Juliette Monsel.

  • bpo-34829: Add methods selection_from, selection_range, selection_present and selection_to to the tkinter.Spinbox for consistency with the tkinter.Entry widget. Patch by Juliette Monsel.

  • bpo-34911: Added secure_protocols argument to http.cookiejar.DefaultCookiePolicy to allow for tweaking of protocols and also to add support by default for wss, the secure websocket protocol.

  • bpo-34922: Fixed integer overflow in the digest() and hexdigest() methods for the SHAKE algorithm in the hashlib module.

  • bpo-34925: 25% speedup in argument parsing for the functions in the bisect module.

  • bpo-34900: Fixed unittest.TestCase.debug() when used to call test methods with subtests. Patch by Bruno Oliveira.

  • bpo-34844: logging.Formatter enhancement - Ensure styles and fmt matches in logging.Formatter - Added validate method in each format style class: StrFormatStyle, PercentStyle, StringTemplateStyle. - This method is called in the constructor of logging.Formatter class - Also re-raise the KeyError in the format method of each style class, so it would a bit clear that it’s an error with the invalid format fields.

  • bpo-34897: Adjust test.support.missing_compiler_executable check so that a nominal command name of «» is ignored. Patch by Michael Felt.

  • bpo-34871: Fix inspect module polluted sys.modules when parsing __text_signature__ of callable.

  • bpo-34898: Add mtime argument to gzip.compress for reproducible output. Patch by Guo Ci Teo.

  • bpo-28441: On Cygwin and MinGW, ensure that sys.executable always includes the full filename in the path, including the .exe suffix (unless it is a symbolic link).

  • bpo-34866: Adding max_num_fields to cgi.FieldStorage to make DOS attacks harder by limiting the number of MiniFieldStorage objects created by FieldStorage.

  • bpo-34711: http.server ensures it reports HTTPStatus.NOT_FOUND when the local path ends with «/» and is not a directory, even if the underlying OS (e.g. AIX) accepts such paths as a valid file reference. Patch by Michael Felt.

  • bpo-34872: Fix self-cancellation in C implementation of asyncio.Task

  • bpo-34849: Don’t log waiting for selector.select in asyncio loop iteration. The waiting is pretty normal for any asyncio program, logging its time just adds a noise to logs without any useful information provided.

  • bpo-34022: The SOURCE_DATE_EPOCH environment variable no longer overrides the value of the invalidation_mode argument to py_compile.compile(), and determines its default value instead.

  • bpo-34819: Use a monotonic clock to compute timeouts in Executor.map() and as_completed(), in order to prevent timeouts from deviating when the system clock is adjusted.

  • bpo-34758: Add .wasm -> application/wasm to list of recognized file types and content type headers

  • bpo-34789: xml.sax.make_parser() now accepts any iterable as its parser_list argument. Patch by Andrés Delfino.

  • bpo-34334: In QueueHandler, clear exc_text from LogRecord to prevent traceback from being written twice.

  • bpo-34687: On Windows, asyncio now uses ProactorEventLoop, instead of SelectorEventLoop, by default.

  • bpo-5950: Support reading zip files with archive comments in zipimport.

  • bpo-32892: The parser now represents all constants as ast.Constant instead of using specific constant AST types (Num, Str, Bytes, NameConstant and Ellipsis). These classes are considered deprecated and will be removed in future Python versions.

  • bpo-34728: Add deprecation warning when loop is used in methods: asyncio.sleep, asyncio.wait and asyncio.wait_for.

  • bpo-34738: ZIP files created by distutils will now include entries for directories.

  • bpo-34659: Add an optional initial argument to itertools.accumulate().

  • bpo-29577: Support multiple mixin classes when creating Enums.

  • bpo-34670: Add SSLContext.post_handshake_auth and SSLSocket.verify_client_post_handshake for TLS 1.3’s post handshake authentication feature.

  • bpo-32718: The Activate.ps1 script from venv works with PowerShell Core 6.1 and is now available under all operating systems.

  • bpo-31177: Fix bug that prevented using reset_mock on mock instances with deleted attributes

  • bpo-34672: Add a workaround, so the 'Z' time.strftime() specifier on the musl C library can work in some cases.

  • bpo-34666: Implement asyncio.StreamWriter.awrite and asyncio.StreamWriter.aclose() coroutines. Methods are needed for providing a consistent stream API with control flow switched on by default.

  • bpo-6721: Acquire the logging module’s commonly used internal locks while fork()ing to avoid deadlocks in the child process.

  • bpo-34658: Fix a rare interpreter unhandled exception state SystemError only seen when using subprocess with a preexec_fn while an after_parent handler has been registered with os.register_at_fork and the fork system call fails.

  • bpo-34652: Ensure os.lchmod() is never defined on Linux.

  • bpo-34638: Store a weak reference to stream reader to break strong references loop between reader and protocol. It allows to detect and close the socket if the stream is deleted (garbage collected) without close() call.

  • bpo-34536: Enum._missing_: raise ValueError if None returned and TypeError if non-member is returned.

  • bpo-34636: Speed up re scanning of many non-matching characters for s w and d within bytes objects. (microoptimization)

  • bpo-24412: Add addModuleCleanup() and addClassCleanup() to unittest to support cleanups for setUpModule() and setUpClass(). Patch by Lisa Roach.

  • bpo-34630: Don’t log SSL certificate errors in asyncio code (connection error logging is skipped already).

  • bpo-32490: Prevent filename duplication in subprocess exception messages. Patch by Zackery Spytz.

  • bpo-34363: dataclasses.asdict() and .astuple() now handle namedtuples correctly.

  • bpo-34625: Update vendorized expat library version to 2.2.6.

  • bpo-32270: The subprocess module no longer mistakenly closes redirected fds even when they were in pass_fds when outside of the default {0, 1, 2} set.

  • bpo-34622: Create a dedicated asyncio.CancelledError, asyncio.InvalidStateError and asyncio.TimeoutError exception classes. Inherit them from corresponding exceptions from concurrent.futures package. Extract asyncio exceptions into a separate file.

  • bpo-34610: Fixed iterator of multiprocessing.managers.DictProxy.

  • bpo-34421: Fix distutils logging for non-ASCII strings. This caused installation issues on Windows.

  • bpo-34604: Fix possible mojibake in the error message of pwd.getpwnam and grp.getgrnam using string representation because of invisible characters or trailing whitespaces. Patch by William Grzybowski.

  • bpo-30977: Make uuid.UUID use __slots__ to reduce its memory footprint. Based on original patch by Wouter Bolsterlee.

  • bpo-34574: OrderedDict iterators are not exhausted during pickling anymore. Patch by Sergey Fedoseev.

  • bpo-8110: Refactored subprocess to check for Windows-specific modules rather than sys.platform == 'win32'.

  • bpo-34530: distutils.spawn.find_executable() now falls back on os.defpath if the PATH environment variable is not set.

  • bpo-34563: On Windows, fix multiprocessing.Connection for very large read: fix _winapi.PeekNamedPipe() and _winapi.ReadFile() for read larger than INT_MAX (usually 2**31-1).

  • bpo-34558: Correct typo in Lib/ctypes/_aix.py

  • bpo-34282: Move Enum._convert to EnumMeta._convert_ and fix enum members getting shadowed by parent attributes.

  • bpo-22872: When the queue is closed, ValueError is now raised by multiprocessing.Queue.put() and multiprocessing.Queue.get() instead of AssertionError and OSError, respectively. Patch by Zackery Spytz.

  • bpo-34515: Fix parsing non-ASCII identifiers in lib2to3.pgen2.tokenize (PEP 3131).

  • bpo-13312: Avoids a possible integer underflow (undefined behavior) in the time module’s year handling code when passed a very low negative year value.

  • bpo-34472: Improved compatibility for streamed files in zipfile. Previously an optional signature was not being written and certain ZIP applications were not supported. Patch by Silas Sewell.

  • bpo-34454: Fix the .fromisoformat() methods of datetime types crashing when given unicode with non-UTF-8-encodable code points. Specifically, datetime.fromisoformat() now accepts surrogate unicode code points used as the separator. Report and tests by Alexey Izbyshev, patch by Paul Ganssle.

  • bpo-6700: Fix inspect.getsourcelines for module level frames/tracebacks. Patch by Vladimir Matveev.

  • bpo-34171: Running the trace module no longer creates the trace.cover file.

  • bpo-34441: Fix crash when an ABC-derived class with invalid __subclasses__ is passed as the second argument to issubclass(). Patch by Alexey Izbyshev.

  • bpo-34427: Fix infinite loop in a.extend(a) for MutableSequence subclasses.

  • bpo-34412: Make signal.strsignal() work on HP-UX. Patch by Michael Osipov.

  • bpo-20849: shutil.copytree now accepts a new dirs_exist_ok keyword argument. Patch by Josh Bronson.

  • bpo-31715: Associate .mjs file extension with application/javascript MIME Type.

  • bpo-34384: os.readlink() now accepts path-like and bytes objects on Windows.

  • bpo-22602: The UTF-7 decoder now raises UnicodeDecodeError for ill-formed sequences starting with «+» (as specified in RFC 2152). Patch by Zackery Spytz.

  • bpo-2122: The mmap.flush() method now returns None on success, raises an exception on error under all platforms.

  • bpo-34341: Appending to the ZIP archive with the ZIP64 extension no longer grows the size of extra fields of existing entries.

  • bpo-34333: Fix %-formatting in pathlib.PurePath.with_suffix() when formatting an error message.

  • bpo-18540: The imaplib.IMAP4 and imaplib.IMAP4_SSL classes now resolve to the local host IP correctly when the default value of host parameter ('') is used.

  • bpo-26502: Implement traceback.FrameSummary.__len__() method to preserve compatibility with the old tuple API.

  • bpo-34318: assertRaises(), assertRaisesRegex(), assertWarns() and assertWarnsRegex() no longer success if the passed callable is None. They no longer ignore unknown keyword arguments in the context manager mode. A DeprecationWarning was raised in these cases since Python 3.5.

  • bpo-9372: Deprecate __getitem__() methods of xml.dom.pulldom.DOMEventStream, wsgiref.util.FileWrapper and fileinput.FileInput.

  • bpo-33613: Fix a race condition in multiprocessing.semaphore_tracker when the tracker receives SIGINT before it can register signal handlers for ignoring it.

  • bpo-34248: Report filename in the exception raised when the database file cannot be opened by dbm.gnu.open() and dbm.ndbm.open() due to OS-related error. Patch by Zsolt Cserna.

  • bpo-33089: Add math.dist() to compute the Euclidean distance between two points.

  • bpo-34246: smtplib.SMTP.send_message() no longer modifies the content of the mail_options argument. Patch by Pablo S. Blum de Aguiar.

  • bpo-31047: Fix ntpath.abspath for invalid paths on windows. Patch by Franz Woellert.

  • bpo-32321: Add pure Python fallback for functools.reduce. Patch by Robert Wright.

  • bpo-34270: The default asyncio task class now always has a name which can be get or set using two new methods (get_name() and set_name()) and is visible in the repr() output. An initial name can also be set using the new name keyword argument to asyncio.create_task() or the create_task() method of the event loop. If no initial name is set, the default Task implementation generates a name like Task-1 using a monotonic counter.

  • bpo-34263: asyncio’s event loop will not pass timeouts longer than one day to epoll/select etc.

  • bpo-34035: Fix several AttributeError in zipfile seek() methods. Patch by Mickaël Schoentgen.

  • bpo-32215: Fix performance regression in sqlite3 when a DML statement appeared in a different line than the rest of the SQL query.

  • bpo-34075: Deprecate passing non-ThreadPoolExecutor instances to AbstractEventLoop.set_default_executor().

  • bpo-34251: Restore msilib.Win64 to preserve backwards compatibility since it’s already used by distutils” bdist_msi command.

  • bpo-19891: Ignore errors caused by missing / non-writable homedir while writing history during exit of an interactive session. Patch by Anthony Sottile.

  • bpo-33089: Enhanced math.hypot() to support more than two dimensions.

  • bpo-34228: tracemalloc: PYTHONTRACEMALLOC=0 environment variable and -X tracemalloc=0 command line option are now allowed to disable explicitly tracemalloc at startup.

  • bpo-13041: Use shutil.get_terminal_size() to calculate the terminal width correctly in the argparse.HelpFormatter class. Initial patch by Zbyszek Jędrzejewski-Szmek.

  • bpo-34213: Allow frozen dataclasses to have a field named «object». Previously this conflicted with an internal use of «object».

  • bpo-34052: sqlite3.Connection.create_aggregate(), sqlite3.Connection.create_function(), sqlite3.Connection.set_authorizer(), sqlite3.Connection.set_progress_handler() methods raises TypeError when unhashable objects are passed as callable. These methods now don’t pass such objects to SQLite API. Previous behavior could lead to segfaults. Patch by Sergey Fedoseev.

  • bpo-34197: Attributes skipinitialspace, doublequote and strict of the dialect attribute of the csv reader are now bool instances instead of integers 0 or 1.

  • bpo-32788: Errors other than TypeError raised in methods __adapt__() and __conform__() in the sqlite3 module are now propagated to the user.

  • bpo-21446: The reload fixer now uses importlib.reload() instead of deprecated imp.reload().

  • bpo-940286: pydoc’s Helper.showtopic() method now prints the cross references of a topic correctly.

  • bpo-34164: base64.b32decode() could raise UnboundLocalError or OverflowError for incorrect padding. Now it always raises base64.Error in these cases.

  • bpo-33729: Fixed issues with arguments parsing in hashlib.

  • bpo-34097: ZipFile can zip files older than 1980-01-01 and newer than 2107-12-31 using a new strict_timestamps parameter at the cost of setting the timestamp to the limit.

  • bpo-34108: Remove extraneous CR in 2to3 refactor.

  • bpo-34070: Make sure to only check if the handle is a tty, when opening a file with buffering=-1.

  • bpo-27494: Reverted bpo-27494. 2to3 rejects now a trailing comma in generator expressions.

  • bpo-33967: functools.singledispatch now raises TypeError instead of IndexError when no positional arguments are passed.

  • bpo-34041: Add the parameter deterministic to the sqlite3.Connection.create_function() method. Patch by Sergey Fedoseev.

  • bpo-34056: Ensure the loader shim created by imp.load_module always returns bytes from its get_data() function. This fixes using imp.load_module with PEP 552 hash-based pycs.

  • bpo-34054: The multiprocessing module now uses the monotonic clock time.monotonic() instead of the system clock time.time() to implement timeout.

  • bpo-34043: Optimize tarfile uncompress performance about 15% when gzip is used.

  • bpo-34044: subprocess.Popen now copies the startupinfo argument to leave it unchanged: it will modify the copy, so that the same STARTUPINFO object can be used multiple times.

  • bpo-34010: Fixed a performance regression for reading streams with tarfile. The buffered read should use a list, instead of appending to a bytes object.

  • bpo-34019: webbrowser: Correct the arguments passed to Opera Browser when opening a new URL using the webbrowser module. Patch by Bumsik Kim.

  • bpo-34003: csv.DictReader now creates dicts instead of OrderedDicts. Patch by Michael Selik.

  • bpo-33978: Closed existing logging handlers before reconfiguration via fileConfig and dictConfig. Patch by Karthikeyan Singaravelan.

  • bpo-14117: Make minor tweaks to turtledemo. The “wikipedia” example is now “rosette”, describing what it draws. The “penrose” print output is reduced. The’1024” output of “tree” is eliminated.

  • bpo-33974: Fixed passing lists and tuples of strings containing special characters ", \, {, } and \n as options to ttk widgets.

  • bpo-27500: Fix getaddrinfo to resolve IPv6 addresses correctly.

  • bpo-24567: Improve random.choices() to handle subnormal input weights that could occasionally trigger an IndexError.

  • bpo-33871: Fixed integer overflow in os.readv(), os.writev(), os.preadv() and os.pwritev() and in os.sendfile() with headers or trailers arguments (on BSD-based OSes and macOS).

  • bpo-25007: Add copy.copy() and copy.deepcopy() support to zlib compressors and decompressors. Patch by Zackery Spytz.

  • bpo-33929: multiprocessing: Fix a race condition in Popen of multiprocessing.popen_spawn_win32. The child process now duplicates the read end of pipe instead of «stealing» it. Previously, the read end of pipe was «stolen» by the child process, but it leaked a handle if the child process had been terminated before it could steal the handle from the parent process.

  • bpo-33899: Tokenize module now implicitly emits a NEWLINE when provided with input that does not have a trailing new line. This behavior now matches what the C tokenizer does internally. Contributed by Ammar Askar.

  • bpo-33897: Added a “force” keyword argument to logging.basicConfig().

  • bpo-33695: shutil.copytree() uses os.scandir() function and all copy functions depending from it use cached os.stat() values. The speedup for copying a directory with 8000 files is around +9% on Linux, +20% on Windows and + 30% on a Windows SMB share. Also the number of os.stat() syscalls is reduced by 38% making shutil.copytree() especially faster on network filesystems. (Contributed by Giampaolo Rodola” in bpo-33695.)

  • bpo-33916: bz2 and lzma: When Decompressor.__init__() is called twice, free the old lock to not leak memory.

  • bpo-32568: Make select.epoll() and its documentation consistent regarding sizehint and flags.

  • bpo-33833: Fixed bug in asyncio where ProactorSocketTransport logs AssertionError if force closed during write.

  • bpo-33663: Convert content length to string before putting to header.

  • bpo-33721: os.path functions that return a boolean result like exists(), lexists(), isdir(), isfile(), islink(), and ismount(), and pathlib.Path methods that return a boolean result like exists(), is_dir(), is_file(), is_mount(), is_symlink(), is_block_device(), is_char_device(), is_fifo(), is_socket() now return False instead of raising ValueError or its subclasses UnicodeEncodeError and UnicodeDecodeError for paths that contain characters or bytes unrepresentable at the OS level.

  • bpo-26544: Fixed implementation of platform.libc_ver(). It almost always returned version “2.9” for glibc.

  • bpo-33843: Remove deprecated cgi.escape, cgi.parse_qs and cgi.parse_qsl.

  • bpo-33842: Remove tarfile.filemode which is deprecated since Python 3.3.

  • bpo-30167: Prevent site.main() exception if PYTHONSTARTUP is set. Patch by Steve Weber.

  • bpo-33805: Improve error message of dataclasses.replace() when an InitVar is not specified

  • bpo-33687: Fix the call to os.chmod() for uu.decode() if a mode is given or decoded. Patch by Timo Furrer.

  • bpo-33812: Datetime instance d with non-None tzinfo, but with d.tzinfo.utcoffset(d) returning None is now treated as naive by the astimezone() method.

  • bpo-32108: In configparser, don’t clear section when it is assigned to itself.

  • bpo-27397: Make email module properly handle invalid-length base64 strings.

  • bpo-33578: Implement multibyte encoder/decoder state methods

  • bpo-30805: Avoid race condition with debug logging

  • bpo-33476: Fix _header_value_parser.py when address group is missing final “;”. Contributed by Enrique Perez-Terron

  • bpo-33694: asyncio: Fix a race condition causing data loss on pause_reading()/resume_reading() when using the ProactorEventLoop.

  • bpo-32493: Correct test for uuid_enc_be availability in configure.ac. Patch by Michael Felt.

  • bpo-33792: Add asyncio.WindowsSelectorEventLoopPolicy and asyncio.WindowsProactorEventLoopPolicy.

  • bpo-33274: W3C DOM Level 1 specifies return value of Element.removeAttributeNode() as «The Attr node that was removed.» xml.dom.minidom now complies with this requirement.

  • bpo-33778: Update unicodedata’s database to Unicode version 11.0.0.

  • bpo-33165: Added a stacklevel parameter to logging calls to allow use of wrapper/helper functions for logging APIs.

  • bpo-33770: improve base64 exception message for encoded inputs of invalid length

  • bpo-33769: asyncio/start_tls: Fix error message; cancel callbacks in case of an unhandled error; mark SSLTransport as closed if it is aborted.

  • bpo-33767: The concatenation (+) and repetition (*) sequence operations now raise TypeError instead of SystemError when performed on mmap.mmap objects. Patch by Zackery Spytz.

  • bpo-33734: asyncio/ssl: Fix AttributeError, increase default handshake timeout

  • bpo-31014: Fixed creating a controller for webbrowser when a user specifies a path to an entry in the BROWSER environment variable. Based on patch by John Still.

  • bpo-2504: Add gettext.pgettext() and variants.

  • bpo-33197: Add description property for _ParameterKind

  • bpo-32751: When cancelling the task due to a timeout, asyncio.wait_for() will now wait until the cancellation is complete.

  • bpo-32684: Fix gather to propagate cancellation of itself even with return_exceptions.

  • bpo-33654: Support protocol type switching in SSLTransport.set_protocol().

  • bpo-33674: Pause the transport as early as possible to further reduce the risk of data_received() being called before connection_made().

  • bpo-33671: shutil.copyfile(), shutil.copy(), shutil.copy2(), shutil.copytree() and shutil.move() use platform-specific fast-copy syscalls on Linux and macOS in order to copy the file more efficiently. On Windows shutil.copyfile() uses a bigger default buffer size (1 MiB instead of 16 KiB) and a memoryview()-based variant of shutil.copyfileobj() is used. The speedup for copying a 512MiB file is about +26% on Linux, +50% on macOS and +40% on Windows. Also, much less CPU cycles are consumed. (Contributed by Giampaolo Rodola” in bpo-25427.)

  • bpo-33674: Fix a race condition in SSLProtocol.connection_made() of asyncio.sslproto: start immediately the handshake instead of using call_soon(). Previously, data_received() could be called before the handshake started, causing the handshake to hang or fail.

  • bpo-31647: Fixed bug where calling write_eof() on a _SelectorSocketTransport after it’s already closed raises AttributeError.

  • bpo-32610: Make asyncio.all_tasks() return only pending tasks.

  • bpo-32410: Avoid blocking on file IO in sendfile fallback code

  • bpo-33469: Fix RuntimeError after closing loop that used run_in_executor

  • bpo-33672: Fix Task.__repr__ crash with Cython’s bogus coroutines

  • bpo-33654: Fix transport.set_protocol() to support switching between asyncio.Protocol and asyncio.BufferedProtocol. Fix loop.start_tls() to work with asyncio.BufferedProtocols.

  • bpo-33652: Pickles of type variables and subscripted generics are now future-proof and compatible with older Python versions.

  • bpo-32493: Fixed uuid.uuid1() on FreeBSD.

  • bpo-33238: Add InvalidStateError to concurrent.futures. Future.set_result and Future.set_exception now raise InvalidStateError if the futures are not pending or running. Patch by Jason Haydaman.

  • bpo-33618: Finalize and document preliminary and experimental TLS 1.3 support with OpenSSL 1.1.1

  • bpo-33625: Release GIL on grp.getgrnam, grp.getgrgid, pwd.getpwnam and pwd.getpwuid if reentrant variants of these functions are available. Patch by William Grzybowski.

  • bpo-33623: Fix possible SIGSGV when asyncio.Future is created in __del__

  • bpo-11874: Use a better regex when breaking usage into wrappable parts. Avoids bogus assertion errors from custom metavar strings.

  • bpo-30877: Fixed a bug in the Python implementation of the JSON decoder that prevented the cache of parsed strings from clearing after finishing the decoding. Based on patch by c-fos.

  • bpo-33604: Remove HMAC default to md5 marked for removal in 3.8 (removal originally planned in 3.6, bump to 3.8 in PR 7062).

  • bpo-33582: Emit a deprecation warning for inspect.formatargspec

  • bpo-21145: Add functools.cached_property decorator, for computed properties cached for the life of the instance.

  • bpo-33570: Change TLS 1.3 cipher suite settings for compatibility with OpenSSL 1.1.1-pre6 and newer. OpenSSL 1.1.1 will have TLS 1.3 ciphers enabled by default.

  • bpo-28556: Do not simplify arguments to typing.Union. Now Union[Manager, Employee] is not simplified to Employee at runtime. Such simplification previously caused several bugs and limited possibilities for introspection.

  • bpo-12486: tokenize.generate_tokens() is now documented as a public API to tokenize unicode strings. It was previously present but undocumented.

  • bpo-33540: Add a new block_on_close class attribute to ForkingMixIn and ThreadingMixIn classes of socketserver.

  • bpo-33548: tempfile._candidate_tempdir_list should consider common TEMP locations

  • bpo-33109: argparse subparsers are once again not required by default, reverting the change in behavior introduced by bpo-26510 in 3.7.0a2.

  • bpo-33541: Remove unused private method _strptime.LocaleTime.__pad (a.k.a. _LocaleTime__pad).

  • bpo-33536: dataclasses.make_dataclass now checks for invalid field names and duplicate fields. Also, added a check for invalid field specifications.

  • bpo-33542: Prevent uuid.get_node from using a DUID instead of a MAC on Windows. Patch by Zvi Effron

  • bpo-26819: Fix race condition with ReadTransport.resume_reading in Windows proactor event loop.

  • Fix failure in typing.get_type_hints() when ClassVar was provided as a string forward reference.

  • bpo-33516: unittest.mock.MagicMock now supports the __round__ magic method.

  • bpo-28612: Added support for Site Maps to urllib’s RobotFileParser as RobotFileParser.site_maps(). Patch by Lady Red, based on patch by Peter Wirtz.

  • bpo-28167: Remove platform.linux_distribution, which was deprecated since 3.5.

  • bpo-33504: Switch the default dictionary implementation for configparser from collections.OrderedDict to the standard dict type.

  • bpo-33505: Optimize asyncio.ensure_future() by reordering if checks: 1.17x faster.

  • bpo-33497: Add errors param to cgi.parse_multipart and make an encoding in FieldStorage use the given errors (needed for Twisted). Patch by Amber Brown.

  • bpo-29235: The cProfile.Profile class can now be used as a context manager. Patch by Scott Sanderson.

  • bpo-33495: Change dataclasses.Fields repr to use the repr of each of its members, instead of str. This makes it more clear what each field actually represents. This is especially true for the “type” member.

  • bpo-26103: Correct inspect.isdatadescriptor to look for __set__ or __delete__. Patch by Aaron Hall.

  • bpo-29209: Removed the doctype() method and the html parameter of the constructor of XMLParser. The doctype() method defined in a subclass will no longer be called. Deprecated methods getchildren() and getiterator() in the ElementTree module emit now a DeprecationWarning instead of PendingDeprecationWarning.

  • bpo-33453: Fix dataclasses to work if using literal string type annotations or if using PEP 563 «Postponed Evaluation of Annotations». Only specific string prefixes are detected for both ClassVar («ClassVar» and «typing.ClassVar») and InitVar («InitVar» and «dataclasses.InitVar»).

  • bpo-28556: Minor fixes in typing module: add annotations to NamedTuple.__new__, pass *args and **kwds in Generic.__new__. Original PRs by Paulius Šarka and Chad Dombrova.

  • bpo-33365: Print the header values besides the header keys instead just the header keys if debuglevel is set to >0 in http.client. Patch by Marco Strigl.

  • bpo-20087: Updated alias mapping with glibc 2.27 supported locales.

  • bpo-33422: Fix trailing quotation marks getting deleted when looking up byte/string literals on pydoc. Patch by Andrés Delfino.

  • bpo-28167: The function platform.linux_distribution and platform.dist now trigger a DeprecationWarning and have been marked for removal in Python 3.8

  • bpo-33281: Fix ctypes.util.find_library regression on macOS.

  • bpo-33311: Text and html output generated by cgitb does not display parentheses if the current call is done directly in the module. Patch by Stéphane Blondon.

  • bpo-27300: The file classes in tempfile now accept an errors parameter that complements the already existing encoding. Patch by Stephan Hohe.

  • bpo-32933: unittest.mock.mock_open() now supports iteration over the file contents. Patch by Tony Flury.

  • bpo-33217: Raise TypeError when looking up non-Enum objects in Enum classes and Enum members.

  • bpo-33197: Update error message when constructing invalid inspect.Parameters Patch by Donghee Na.

  • bpo-33383: Fixed crash in the get() method of the dbm.ndbm database object when it is called with a single argument.

  • bpo-33375: The warnings module now finds the Python file associated with a warning from the code object, rather than the frame’s global namespace. This is consistent with how tracebacks and pdb find filenames, and should work better for dynamically executed code.

  • bpo-33336: imaplib now allows MOVE command in IMAP4.uid() (RFC 6851: IMAP MOVE Extension) and potentially as a name of supported method of IMAP4 object.

  • bpo-32455: Added jump parameter to dis.stack_effect().

  • bpo-27485: Rename and deprecate undocumented functions in urllib.parse().

  • bpo-33332: Add signal.valid_signals() to expose the POSIX sigfillset() functionality.

  • bpo-33251: ConfigParser.items() was fixed so that key-value pairs passed in via vars() are not included in the resulting output.

  • bpo-33329: Fix multiprocessing regression on newer glibcs

  • bpo-33334: dis.stack_effect() now supports all defined opcodes including NOP and EXTENDED_ARG.

  • bpo-991266: Fix quoting of the Comment attribute of http.cookies.SimpleCookie.

  • bpo-33131: Upgrade bundled version of pip to 10.0.1.

  • bpo-33308: Fixed a crash in the parser module when converting an ST object to a tree of tuples or lists with line_info=False and col_info=True.

  • bpo-23403: lib2to3 now uses pickle protocol 4 for pre-computed grammars.

  • bpo-33266: lib2to3 now recognizes rf'...' strings.

  • bpo-11594: Ensure line-endings are respected when using lib2to3.

  • bpo-33254: Have importlib.resources.contents() and importlib.abc.ResourceReader.contents() return an iterable instead of an iterator.

  • bpo-33265: contextlib.ExitStack and contextlib.AsyncExitStack now use a method instead of a wrapper function for exit callbacks.

  • bpo-33263: Fix FD leak in _SelectorSocketTransport Patch by Vlad Starostin.

  • bpo-33256: Fix display of <module> call in the html produced by cgitb.html(). Patch by Stéphane Blondon.

  • bpo-33144: random.Random() and its subclassing mechanism got optimized to check only once at class/subclass instantiation time whether its getrandbits() method can be relied on by other methods, including randrange(), for the generation of arbitrarily large random integers. Patch by Wolfgang Maier.

  • bpo-33185: Fixed regression when running pydoc with the -m switch. (The regression was introduced in 3.7.0b3 by the resolution of bpo-33053)

    This fix also changed pydoc to add os.getcwd() to sys.path when necessary, rather than adding ".".

  • bpo-29613: Added support for the SameSite cookie flag to the http.cookies module.

  • bpo-33169: Delete entries of None in sys.path_importer_cache when importlib.machinery.invalidate_caches() is called.

  • bpo-33203: random.Random.choice() now raises IndexError for empty sequences consistently even when called from subclasses without a getrandbits() implementation.

  • bpo-33224: Update difflib.mdiff() for PEP 479. Convert an uncaught StopIteration in a generator into a return-statement.

  • bpo-33209: End framing at the end of C implementation of pickle.Pickler.dump().

  • bpo-32861: The urllib.robotparser’s __str__ representation now includes wildcard entries and the «Crawl-delay» and «Request-rate» fields. Also removes extra newlines that were being appended to the end of the string. Patch by Michael Lazar.

  • bpo-23403: DEFAULT_PROTOCOL in pickle was bumped to 4. Protocol 4 is described in PEP 3154 and available since Python 3.4. It offers better performance and smaller size compared to protocol 3 introduced in Python 3.0.

  • bpo-20104: Improved error handling and fixed a reference leak in os.posix_spawn().

  • bpo-33106: Deleting a key from a read-only dbm database raises module specific error instead of KeyError.

  • bpo-33175: In dataclasses, Field.__set_name__ now looks up the __set_name__ special method on the class, not the instance, of the default value.

  • bpo-32380: Create functools.singledispatchmethod to support generic single dispatch on descriptors and methods.

  • bpo-33141: Have Field objects pass through __set_name__ to their default values, if they have their own __set_name__.

  • bpo-33096: Allow ttk.Treeview.insert to insert iid that has a false boolean value. Note iid=0 and iid=False would be same. Patch by Garvit Khatri.

  • bpo-32873: Treat type variables and special typing forms as immutable by copy and pickle. This fixes several minor issues and inconsistencies, and improves backwards compatibility with Python 3.6.

  • bpo-33134: When computing dataclass’s __hash__, use the lookup table to contain the function which returns the __hash__ value. This is an improvement over looking up a string, and then testing that string to see what to do.

  • bpo-33127: The ssl module now compiles with LibreSSL 2.7.1.

  • bpo-32505: Raise TypeError if a member variable of a dataclass is of type Field, but doesn’t have a type annotation.

  • bpo-33078: Fix the failure on OSX caused by the tests relying on sem_getvalue

  • bpo-33116: Add “Field” to dataclasses.__all__.

  • bpo-32896: Fix an error where subclassing a dataclass with a field that uses a default_factory would generate an incorrect class.

  • bpo-33100: Dataclasses: If a field has a default value that’s a MemberDescriptorType, then it’s from that field being in __slots__, not an actual default value.

  • bpo-32953: If a non-dataclass inherits from a frozen dataclass, allow attributes to be added to the derived class. Only attributes from the frozen dataclass cannot be assigned to. Require all dataclasses in a hierarchy to be either all frozen or all non-frozen.

  • bpo-33097: Raise RuntimeError when executor.submit is called during interpreter shutdown.

  • bpo-32968: Modulo and floor division involving Fraction and float should return float.

  • bpo-33061: Add missing NoReturn to __all__ in typing.py

  • bpo-33078: Fix the size handling in multiprocessing.Queue when a pickling error occurs.

  • bpo-33064: lib2to3 now properly supports trailing commas after *args and **kwargs in function signatures.

  • bpo-33056: FIX properly close leaking fds in concurrent.futures.ProcessPoolExecutor.

  • bpo-33021: Release the GIL during fstat() calls, avoiding hang of all threads when calling mmap.mmap(), os.urandom(), and random.seed(). Patch by Nir Soffer.

  • bpo-31804: Avoid failing in multiprocessing.Process if the standard streams are closed or None at exit.

  • bpo-33034: Providing an explicit error message when casting the port property to anything that is not an integer value using urlparse() and urlsplit(). Patch by Matt Eaton.

  • bpo-30249: Improve struct.unpack_from() exception messages for problems with the buffer size and offset.

  • bpo-33037: Skip sending/receiving data after SSL transport closing.

  • bpo-27683: Fix a regression in ipaddress that result of hosts() is empty when the network is constructed by a tuple containing an integer mask and only 1 bit left for addresses.

  • bpo-22674: Add the strsignal() function in the signal module that returns the system description of the given signal, as returned by strsignal(3).

  • bpo-32999: Fix C implementation of ABC.__subclasscheck__(cls, subclass) crashed when subclass is not a type object.

  • bpo-33009: Fix inspect.signature() for single-parameter partialmethods.

  • bpo-32969: Expose several missing constants in zlib and fix corresponding documentation.

  • bpo-32056: Improved exceptions raised for invalid number of channels and sample width when read an audio file in modules aifc, wave and sunau.

  • bpo-32970: Improved disassembly of the MAKE_FUNCTION instruction.

  • bpo-32844: Fix wrong redirection of a low descriptor (0 or 1) to stderr in subprocess if another low descriptor is closed.

  • bpo-32960: For dataclasses, disallow inheriting frozen from non-frozen classes, and also disallow inheriting non-frozen from frozen classes. This restriction will be relaxed at a future date.

  • bpo-32713: Fixed tarfile.itn handling of out-of-bounds float values. Patch by Joffrey Fuhrer.

  • bpo-32257: The ssl module now contains OP_NO_RENEGOTIATION constant, available with OpenSSL 1.1.0h or 1.1.1.

  • bpo-32951: Direct instantiation of SSLSocket and SSLObject objects is now prohibited. The constructors were never documented, tested, or designed as public constructors. Users were suppose to use ssl.wrap_socket() or SSLContext.

  • bpo-32929: Remove the tri-state parameter «hash», and add the boolean «unsafe_hash». If unsafe_hash is True, add a __hash__ function, but if a __hash__ exists, raise TypeError. If unsafe_hash is False, add a __hash__ based on the values of eq= and frozen=. The unsafe_hash=False behavior is the same as the old hash=None behavior. unsafe_hash=False is the default, just as hash=None used to be.

  • bpo-32947: Add OP_ENABLE_MIDDLEBOX_COMPAT and test workaround for TLSv1.3 for future compatibility with OpenSSL 1.1.1.

  • bpo-32146: Document the interaction between frozen executables and the spawn and forkserver start methods in multiprocessing.

  • bpo-30622: The ssl module now detects missing NPN support in LibreSSL.

  • bpo-32922: dbm.open() now encodes filename with the filesystem encoding rather than default encoding.

  • bpo-32759: Free unused arenas in multiprocessing.heap.

  • bpo-32859: In os.dup2, don’t check every call whether the dup3 syscall exists or not.

  • bpo-32556: nt._getfinalpathname, nt._getvolumepathname and nt._getdiskusage now correctly convert from bytes.

  • bpo-21060: Rewrite confusing message from setup.py upload from «No dist file created in earlier command» to the more helpful «Must create and upload files in one command».

  • bpo-32857: In tkinter, after_cancel(None) now raises a ValueError instead of canceling the first scheduled function. Patch by Cheryl Sabella.

  • bpo-32852: Make sure sys.argv remains as a list when running trace.

  • bpo-31333: _abc module is added. It is a speedup module with C implementations for various functions and methods in abc. Creating an ABC subclass and calling isinstance or issubclass with an ABC subclass are up to 1.5x faster. In addition, this makes Python start-up up to 10% faster.

    Note that the new implementation hides internal registry and caches, previously accessible via private attributes _abc_registry, _abc_cache, and _abc_negative_cache. There are three debugging helper methods that can be used instead _dump_registry, _abc_registry_clear, and _abc_caches_clear.

  • bpo-32841: Fixed asyncio.Condition issue which silently ignored cancellation after notifying and cancelling a conditional lock. Patch by Bar Harel.

  • bpo-32819: ssl.match_hostname() has been simplified and no longer depends on re and ipaddress module for wildcard and IP addresses. Error reporting for invalid wildcards has been improved.

  • bpo-19675: multiprocessing.Pool no longer leaks processes if its initialization fails.

  • bpo-32394: socket: Remove TCP_FASTOPEN,TCP_KEEPCNT,TCP_KEEPIDLE,TCP_KEEPINTVL flags on older version Windows during run-time.

  • bpo-31787: Fixed refleaks of __init__() methods in various modules. (Contributed by Oren Milman)

  • bpo-30157: Fixed guessing quote and delimiter in csv.Sniffer.sniff() when only the last field is quoted. Patch by Jake Davis.

  • bpo-30688: Added support of \N{name} escapes in regular expressions. Based on patch by Jonathan Eunice.

  • bpo-32792: collections.ChainMap() preserves the order of the underlying mappings.

  • bpo-32775: fnmatch.translate() no longer produces patterns which contain set operations. Sets starting with “[” or containing “–”, “&&”, “~~” or “||” will be interpreted differently in regular expressions in future versions. Currently they emit warnings. fnmatch.translate() now avoids producing patterns containing such sets by accident.

  • bpo-32622: Implement native fast sendfile for Windows proactor event loop.

  • bpo-32777: Fix a rare but potential pre-exec child process deadlock in subprocess on POSIX systems when marking file descriptors inheritable on exec in the child process. This bug appears to have been introduced in 3.4.

  • bpo-32647: The ctypes module used to depend on indirect linking for dlopen. The shared extension is now explicitly linked against libdl on platforms with dl.

  • bpo-32749: A dbm.dumb database opened with flags “r” is now read-only. dbm.dumb.open() with flags “r” and “w” no longer creates a database if it does not exist.

  • bpo-32741: Implement asyncio.TimerHandle.when() method.

  • bpo-32691: Use mod_spec.parent when running modules with pdb

  • bpo-32734: Fixed asyncio.Lock() safety issue which allowed acquiring and locking the same lock multiple times, without it being free. Patch by Bar Harel.

  • bpo-32727: Do not include name field in SMTP envelope from address. Patch by Stéphane Wirtel

  • bpo-31453: Add TLSVersion constants and SSLContext.maximum_version / minimum_version attributes. The new API wraps OpenSSL 1.1 https://web.archive.org/web/20180309043602/https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_set_min_proto_version.html feature.

  • bpo-24334: Internal implementation details of ssl module were cleaned up. The SSLSocket has one less layer of indirection. Owner and session information are now handled by the SSLSocket and SSLObject constructor. Channel binding implementation has been simplified.

  • bpo-31848: Fix the error handling in Aifc_read.initfp() when the SSND chunk is not found. Patch by Zackery Spytz.

  • bpo-32585: Add Ttk spinbox widget to tkinter.ttk. Patch by Alan D Moore.

  • bpo-32512: profile CLI accepts -m module_name as an alternative to script path.

  • bpo-8525: help() on a type now displays builtin subclasses. This is intended primarily to help with notification of more specific exception subclasses.

    Patch by Sanyam Khurana.

  • bpo-31639: http.server now exposes a ThreadingHTTPServer class and uses it when the module is run with -m to cope with web browsers pre-opening sockets.

  • bpo-29877: compileall: import ProcessPoolExecutor only when needed, preventing hangs on low resource platforms

  • bpo-32221: Various functions returning tuple containing IPv6 addresses now omit %scope part since the same information is already encoded in scopeid tuple item. Especially this speeds up socket.recvfrom() when it receives multicast packet since useless resolving of network interface name is omitted.

  • bpo-32147: binascii.unhexlify() is now up to 2 times faster. Patch by Sergey Fedoseev.

  • bpo-30693: The TarFile class now recurses directories in a reproducible way.

  • bpo-30693: The ZipFile class now recurses directories in a reproducible way.

  • bpo-31680: Added curses.ncurses_version.

  • bpo-31908: Fix output of cover files for trace module command-line tool. Previously emitted cover files only when --missing option was used. Patch by Michael Selik.

  • bpo-31608: Raise a TypeError instead of crashing if a collections.deque subclass returns a non-deque from __new__. Patch by Oren Milman.

  • bpo-31425: Add support for sockets of the AF_QIPCRTR address family, supported by the Linux kernel. This is used to communicate with services, such as GPS or radio, running on Qualcomm devices. Patch by Bjorn Andersson.

  • bpo-22005: Implemented unpickling instances of datetime, date and time pickled by Python 2. encoding='latin1' should be used for successful decoding.

  • bpo-27645: sqlite3.Connection now exposes a backup method, if the underlying SQLite library is at version 3.6.11 or higher. Patch by Lele Gaifax.

  • bpo-16865: Support arrays >=2GiB in ctypes. Patch by Segev Finer.

  • bpo-31508: Removed support of arguments in tkinter.ttk.Treeview.selection. It was deprecated in 3.6. Use specialized methods like selection_set for changing the selection.

  • bpo-29456: Fix bugs in hangul normalization: u1176, u11a7 and u11c3

Documentation

  • bpo-21257: Document http.client.parse_headers().

  • bpo-34764: Improve example of iter() with 2nd sentinel argument.

  • bpo-35564: Explicitly set master_doc variable in conf.py for compliance with Sphinx 2.0

  • bpo-35511: Specified that profile.Profile class doesn’t not support enable or disable methods. Also, elaborated that Profile object as a context manager is only supported in cProfile module.

  • bpo-10536: Enhance the gettext docs. Patch by Éric Araujo

  • bpo-35089: Remove mention of typing.io and typing.re. Their types should be imported from typing directly.

  • bpo-35038: Fix the documentation about an unexisting f_restricted attribute in the frame object. Patch by Stéphane Wirtel

  • bpo-35042: Replace PEP XYZ by the pep role and allow to use the direct links to the PEPs.

  • bpo-35044: Fix the documentation with the role exc for the appropriated exception. Patch by Stéphane Wirtel

  • bpo-35035: Rename documentation for email.utils to email.utils.rst.

  • bpo-34967: Use app.add_object_type() instead of the deprecated Sphinx function app.description_unit()

  • bpo-34913: Add documentation about the new command line interface of the gzip module.

  • bpo-32174: chm document displays non-ASCII characters properly on some MBCS Windows systems.

  • bpo-11233: Create availability directive for documentation. Original patch by Georg Brandl.

  • bpo-34790: Document how passing coroutines to asyncio.wait() can be confusing.

  • bpo-34552: Make clear that == operator sometimes is equivalent to is. The <, <=, > and >= operators are only defined where they make sense.

  • bpo-28617: Fixed info in the stdtypes docs concerning the types that support membership tests.

  • bpo-20177: Migrate datetime.date.fromtimestamp to Argument Clinic. Patch by Tim Hoffmann.

  • bpo-34065: Fix wrongly written basicConfig documentation markup syntax

  • bpo-33460: replaced ellipsis with correct error codes in tutorial chapter 3.

  • bpo-33847: Add “@” operator entry to index.

  • bpo-33409: Clarified the relationship between PEP 538’s PYTHONCOERCECLOCALE and PEP 540’s PYTHONUTF8 mode.

  • bpo-33197: Add versionadded tag to the documentation of ParameterKind.description

  • bpo-17045: Improve the C-API doc for PyTypeObject. This includes adding several quick-reference tables and a lot of missing slot/typedef entries. The existing entries were also cleaned up with a slightly more consistent format.

  • bpo-33736: Improve the documentation of asyncio.open_connection(), asyncio.start_server() and their UNIX socket counterparts.

  • bpo-23859: Document that asyncio.wait() does not cancel its futures on timeout.

  • bpo-32436: Document PEP 567 changes to asyncio.

  • bpo-33604: Update HMAC md5 default to a DeprecationWarning, bump removal to 3.8.

  • bpo-33594: Document getargspec, from_function and from_builtin as deprecated in their respective docstring, and include version since deprecation in DeprecationWarning message.

  • bpo-33503: Fix broken pypi link

  • bpo-33421: Add missing documentation for typing.AsyncContextManager.

  • bpo-33487: BZ2file now emit a DeprecationWarning when buffering=None is passed, the deprecation message and documentation also now explicitly state it is deprecated since 3.0.

  • bpo-33378: Add Korean language switcher for https://docs.python.org/3/

  • bpo-33276: Clarify that the __path__ attribute on modules cannot be just any value.

  • bpo-33201: Modernize documentation for writing C extension types.

  • bpo-33195: Deprecate Py_UNICODE usage in c-api/arg document. Py_UNICODE related APIs are deprecated since Python 3.3, but it is missed in the document.

  • bpo-33126: Document PyBuffer_ToContiguous().

  • bpo-27212: Modify documentation for the islice() recipe to consume initial values up to the start index.

  • bpo-28247: Update zipapp documentation to describe how to make standalone applications.

  • bpo-18802: Documentation changes for ipaddress. Patch by Jon Foster and Berker Peksag.

  • bpo-27428: Update documentation to clarify that WindowsRegistryFinder implements MetaPathFinder. (Patch by Himanshu Lakhara)

  • bpo-28124: The ssl module function ssl.wrap_socket() has been de-emphasized and deprecated in favor of the more secure and efficient SSLContext.wrap_socket() method.

  • bpo-17232: Clarify docs for -O and -OO. Patch by Terry Reedy.

  • bpo-32436: Add documentation for the contextvars module (PEP 567).

  • bpo-32800: Update link to w3c doc for xml default namespaces.

  • bpo-11015: Update test.support documentation.

  • bpo-32613: Update the faq/windows.html to use the py command from PEP 397 instead of python.

  • bpo-8722: Document __getattr__() behavior when property get() method raises AttributeError.

  • bpo-32614: Modify RE examples in documentation to use raw strings to prevent DeprecationWarning and add text to REGEX HOWTO to highlight the deprecation.

  • bpo-20709: Remove the paragraph where we explain that os.utime() does not support a directory as path under Windows. Patch by Jan-Philip Gehrcke

  • bpo-32722: Remove the bad example in the tutorial of the Generator Expression. Patch by Stéphane Wirtel

  • bpo-31972: Improve docstrings for pathlib.PurePath subclasses.

  • bpo-30607: Use the externalized python-docs-theme package when building the documentation.

  • bpo-8243: Add a note about curses.addch and curses.addstr exception behavior when writing outside a window, or pad.

  • bpo-32337: Update documentation related with dict order.

  • bpo-25041: Document AF_PACKET in the socket module.

  • bpo-31432: Clarify meaning of CERT_NONE, CERT_OPTIONAL, and CERT_REQUIRED flags for ssl.SSLContext.verify_mode.

Tests

  • bpo-35772: Fix sparse file tests of test_tarfile on ppc64 with the tmpfs filesystem. Fix the function testing if the filesystem supports sparse files: create a file which contains data and «holes», instead of creating a file which contains no data. tmpfs effective block size is a page size (tmpfs lives in the page cache). RHEL uses 64 KiB pages on aarch64, ppc64, ppc64le, only s390x and x86_64 use 4 KiB pages, whereas the test punch holes of 4 KiB.

  • bpo-35045: Make ssl tests less strict and also accept TLSv1 as system default. The changes unbreaks test_min_max_version on Fedora 29.

  • bpo-32710: test_asyncio/test_sendfile.py now resets the event loop policy using tearDownModule() as done in other tests, to prevent a warning when running tests on Windows.

  • bpo-33717: test.pythoninfo now logs information of all clocks, not only time.time() and time.perf_counter().

  • bpo-35488: Add a test to pathlib’s Path.match() to verify it does not support glob-style ** recursive pattern matching.

  • bpo-31731: Fix a race condition in check_interrupted_write() of test_io: create directly the thread with SIGALRM signal blocked, rather than blocking the signal later from the thread. Previously, it was possible that the thread gets the signal before the signal is blocked.

  • bpo-35424: Fix test_multiprocessing_main_handling: use multiprocessing.Pool with a context manager and then explicitly join the pool.

  • bpo-35519: Rename test.bisect module to test.bisect_cmd to avoid conflict with bisect module when running directly a test like ./python Lib/test/test_xmlrpc.py.

  • bpo-35513: Replace time.time() with time.monotonic() in tests to measure time delta.

  • bpo-34279: test.support.run_unittest() no longer raise TestDidNotRun if the test result contains skipped tests. The exception is now only raised if no test have been run and no test have been skipped.

  • bpo-35412: Add testcase to test_future4: check unicode literal.

  • bpo-26704: Added test demonstrating double-patching of an instance method. Patch by Anthony Sottile.

  • bpo-33725: test_multiprocessing_fork may crash on recent versions of macOS. Until the issue is resolved, skip the test on macOS.

  • bpo-35352: Modify test_asyncio to use the certificate set from the test directory.

  • bpo-35317: Fix mktime() overflow error in test_email: run test_localtime_daylight_true_dst_true() and test_localtime_daylight_false_dst_true() with a specific timezone.

  • bpo-21263: After several reports that test_gdb does not work properly on macOS and since gdb is not shipped by default anymore, test_gdb is now skipped on macOS when LLVM Clang has been used to compile Python. Patch by Lysandros Nikolaou

  • bpo-34279: regrtest issue a warning when no tests have been executed in a particular test file. Also, a new final result state is issued if no test have been executed across all test files. Patch by Pablo Galindo.

  • bpo-34962: make docstest in Doc now passes., and is enforced in CI

  • bpo-23596: Use argparse for the command line of the gzip module. Patch by Antony Lee

  • bpo-34537: Fix test_gdb.test_strings() when LC_ALL=C and GDB was compiled with Python 3.6 or earlier.

  • bpo-34587: test_socket: Remove RDSTest.testCongestion(). The test tries to fill the receiver’s socket buffer and expects an error. But the RDS protocol doesn’t require that. Moreover, the Linux implementation of RDS expects that the producer of the messages reduces its rate, it’s not the role of the receiver to trigger an error. The test fails on Fedora 28 by design, so just remove it.

  • bpo-34661: Fix test_shutil if unzip doesn’t support -t.

  • bpo-34200: Fixed non-deterministic flakiness of test_pkg by not using the scary test.support.module_cleanup() logic to save and restore sys.modules contents between test cases.

  • bpo-34569: The experimental PEP 554 data channels now correctly pass negative PyLong objects between subinterpreters on 32-bit systems. Patch by Michael Felt.

  • bpo-34594: Fix usage of hardcoded errno values in the tests.

  • bpo-34579: Fix test_embed for AIX Patch by Michael Felt

  • bpo-34542: Use 3072 RSA keys and SHA-256 signature for test certs and keys.

  • bpo-11193: Remove special condition for AIX in test_subprocess.test_undecodable_env

  • bpo-34347: Fix test_utf8_mode.test_cmd_line for AIX

  • bpo-34490: On AIX with AF_UNIX family sockets getsockname() does not provide “sockname”, so skip calls to transport.get_extra_info(“sockname”)

  • bpo-34391: Fix ftplib test for TLS 1.3 by reading from data socket.

  • bpo-11192: Fix test_socket on AIX 6.1 and later IPv6 zone id supports only supported by inet_pton6_zone(). Switch to runtime-based platform.system() to establish current platform rather than build-time based sys.platform()

  • bpo-34399: Update all RSA keys and DH params to use at least 2048 bits.

  • bpo-34373: Fix test_mktime and test_pthread_getcpuclickid tests for AIX Add range checking for _PyTime_localtime for AIX Patch by Michael Felt

  • bpo-11191: Skip the distutils test “test_search_cpp” when using XLC as compiler patch by aixtools (Michael Felt)

  • Improved an error message when mock assert_has_calls fails.

  • bpo-33746: Fix test_unittest when run in verbose mode.

  • bpo-33901: Fix test_dbm_gnu on macOS with gdbm 1.15: add a larger value to make sure that the file size changes.

  • bpo-33873: Fix a bug in regrtest that caused an extra test to run if –huntrleaks/-R was used. Exit with error in case that invalid parameters are specified to –huntrleaks/-R (at least one warmup run and one repetition must be used).

  • bpo-33562: Check that a global asyncio event loop policy is not left behind by any tests.

  • bpo-33655: Ignore test_posix_fallocate failures on BSD platforms that might be due to running on ZFS.

  • bpo-32962: Fixed test_gdb when Python is compiled with flags -mcet -fcf-protection -O0.

  • bpo-33358: Fix test_embed.test_pre_initialization_sys_options() when the interpreter is built with --enable-shared.

  • bpo-32872: Avoid regrtest compatibility issue with namespace packages.

  • bpo-32517: Fix failing test_asyncio on macOS 10.12.2+ due to transport of KqueueSelector loop was not being closed.

  • bpo-32663: Making sure the SMTPUTF8SimTests class of tests gets run in test_smtplib.py.

  • bpo-27643: Test_C test case needs «signed short» bitfields, but the IBM XLC compiler (on AIX) does not support this Skip the code and test when AIX and XLC are used

    Applicable to Python2-2.7 and later

  • bpo-19417: Add test_bdb.py.

  • bpo-31809: Add tests to verify connection with secp ECDH curves.

Build

  • bpo-34691: The _contextvars module is now built into the core Python library on Windows.

  • bpo-35683: Improved Azure Pipelines build steps and now verifying layouts correctly

  • bpo-35642: Remove asynciomodule.c from pythoncore.vcxproj

  • bpo-35550: Fix incorrect Solaris #ifdef checks to look for __sun && __SVR4 instead of sun when compiling.

  • bpo-35499: make profile-opt no longer replaces CFLAGS_NODIST with CFLAGS. It now adds profile-guided optimization (PGO) flags to CFLAGS_NODIST: existing CFLAGS_NODIST flags are kept.

  • bpo-35257: Avoid leaking the linker flags from Link Time Optimizations (LTO) into distutils when compiling C extensions.

  • bpo-35351: When building Python with clang and LTO, LTO flags are no longer passed into CFLAGS to build third-party C extensions through distutils.

  • bpo-35139: Fix a compiler error when statically linking pyexpat in Modules/Setup.

  • bpo-35059: PCbuild: Set InlineFunctionExpansion to OnlyExplicitInline («/Ob1» option) in pyproject.props in Debug mode to expand functions marked as inline. This change should make Python compiled in Debug mode a little bit faster on Windows.

  • bpo-35011: Restores the use of pyexpatns.h to isolate our embedded copy of the expat C library so that its symbols do not conflict at link or dynamic loading time with an embedding application or other extension modules with their own version of libexpat.

  • bpo-28015: Have –with-lto works correctly with clang.

  • bpo-34765: Update the outdated install-sh file to the latest revision from automake v1.16.1

  • bpo-34585: Check for floating-point byte order in configure.ac using compilation tests instead of executing code, so that these checks work in cross-compiled builds.

  • bpo-34710: Fixed SSL module build with OpenSSL & pedantic CFLAGS.

  • bpo-34582: Add JUnit XML output for regression tests and update Azure DevOps builds.

  • bpo-34081: Make Sphinx warnings as errors in the Docs Makefile.

  • bpo-34555: Fix for case where it was not possible to have both HAVE_LINUX_VM_SOCKETS_H and HAVE_SOCKADDR_ALG be undefined.

  • bpo-33015: Fix an undefined behaviour in the pthread implementation of PyThread_start_new_thread(): add a function wrapper to always return NULL.

  • bpo-34245: The Python shared library is now installed with write permission (mode 0755), which is the standard way of installing such libraries.

  • bpo-34121: Fix detection of C11 atomic support on clang.

  • bpo-32430: Rename Modules/Setup.dist to Modules/Setup, and remove the necessity to copy the former manually to the latter when updating the local source tree.

  • bpo-30345: Add -g to LDFLAGS when compiling with LTO to get debug symbols.

  • bpo-5755: Move -Wstrict-prototypes option to CFLAGS_NODIST from OPT. This option emitted annoying warnings when building extension modules written in C++.

  • bpo-33614: Ensures module definition files for the stable ABI on Windows are correctly regenerated.

  • bpo-33648: The –with-c-locale-warning configuration flag has been removed. It has had no effect for about a year.

  • bpo-33522: Enable CI builds on Visual Studio Team Services at https://python.visualstudio.com/cpython

  • bpo-33512: configure’s check for «long double» has been simplified

  • bpo-33483: C compiler is now correctly detected from the standard environment variables. –without-gcc and –with-icc options have been removed.

  • bpo-33394: Enable the verbose build for extension modules, when GNU make is passed macros on the command line.

  • bpo-33393: Update config.guess and config.sub files.

  • bpo-33377: Add new triplets for mips r6 and riscv variants (used in extension suffixes).

  • bpo-32232: By default, modules configured in Modules/Setup are no longer built with -DPy_BUILD_CORE. Instead, modules that specifically need that preprocessor definition include it in their individual entries.

  • bpo-33182: The embedding tests can once again be built with clang 6.0

  • bpo-33163: Upgrade pip to 9.0.3 and setuptools to v39.0.1.

  • bpo-33012: gcc 8 has added a new warning heuristic to detect invalid function casts and a stock python build seems to hit that warning quite often. The most common is the cast of a METH_NOARGS function (that uses just one argument) to a PyCFunction. Fix this by adding a dummy argument to all functions that implement METH_NOARGS.

  • bpo-32898: Fix the python debug build when using COUNT_ALLOCS.

  • bpo-29442: Replace optparse with argparse in setup.py

Windows

  • bpo-35890: Fix API calling consistency of GetVersionEx and wcstok.

  • bpo-32560: The py launcher now forwards its STARTUPINFO structure to child processes.

  • bpo-35854: Fix EnvBuilder and –symlinks in venv on Windows

  • bpo-35811: Avoid propagating venv settings when launching via py.exe

  • bpo-35797: Fix default executable used by the multiprocessing module

  • bpo-35758: Allow building on ARM with MSVC.

  • bpo-29734: Fix handle leaks in os.stat on Windows.

  • bpo-35596: Use unchecked PYCs for the embeddable distro to avoid zipimport restrictions.

  • bpo-35596: Fix vcruntime140.dll being added to embeddable distro multiple times.

  • bpo-35402: Update Windows build to use Tcl and Tk 8.6.9

  • bpo-35401: Updates Windows build to OpenSSL 1.1.0j

  • bpo-34977: venv on Windows will now use a python.exe redirector rather than copying the actual binaries from the base environment.

  • bpo-34977: Adds support for building a Windows App Store package

  • bpo-35067: Remove _distutils_findvs module and use vswhere.exe instead.

  • bpo-32557: Allow shutil.disk_usage to take a file path on Windows

  • bpo-34770: Fix a possible null pointer dereference in pyshellext.cpp.

  • bpo-34603: Fix returning structs from functions produced by MSVC

  • bpo-34581: Guard MSVC-specific code in socketmodule.c with #ifdef _MSC_VER.

  • bpo-34532: Fixes exit code of list version arguments for py.exe.

  • bpo-34062: Fixed the “–list” and “–list-paths” arguments for the py.exe launcher

  • bpo-34225: Ensure INCLUDE and LIB directories do not end with a backslash.

  • bpo-34011: A suite of code has been changed which copied across DLLs and init.tcl from the running Python location into a venv being created. These copies are needed only when running from a Python source build, and the copying code is now only run when that is the case, rather than whenever a venv is created.

  • bpo-34006: Revert line length limit for Windows help docs. The line-length limit is not needed because the pages appear in a separate app rather than on a browser tab. It can also interact badly with the DPI setting.

  • bpo-31546: Restore running PyOS_InputHook while waiting for user input at the prompt. The restores integration of interactive GUI windows (such as Matplotlib figures) with the prompt on Windows.

  • bpo-30237: Output error when ReadConsole is canceled by CancelSynchronousIo instead of crashing.

  • bpo-33895: GIL is released while calling functions that acquire Windows loader lock.

  • bpo-33720: Reduces maximum marshal recursion depth on release builds.

  • bpo-29097: Fix bug where datetime.fromtimestamp() erroneously throws an OSError on Windows for values between 0 and 86400. Patch by Ammar Askar.

  • bpo-33316: PyThread_release_lock always fails

  • bpo-33184: Update Windows installer to use OpenSSL 1.1.0h.

  • bpo-32890: Fix usage of GetLastError() instead of errno in os.execve() and os.truncate().

  • bpo-33016: Fix potential use of uninitialized memory in nt._getfinalpathname

  • bpo-32903: Fix a memory leak in os.chdir() on Windows if the current directory is set to a UNC path.

  • bpo-32901: Update Tcl and Tk versions to 8.6.8

  • bpo-31966: Fixed WindowsConsoleIO.write() for writing empty data.

  • bpo-32409: Ensures activate.bat can handle Unicode contents.

  • bpo-32457: Improves handling of denormalized executable path when launching Python.

  • bpo-32370: Use the correct encoding for ipconfig output in the uuid module. Patch by Segev Finer.

  • bpo-29248: Fix os.readlink() on Windows, which was mistakenly treating the PrintNameOffset field of the reparse data buffer as a number of characters instead of bytes. Patch by Craig Holmquist and SSE4.

  • bpo-1104: Correctly handle string length in msilib.SummaryInfo.GetProperty() to prevent it from truncating the last character.

macOS

  • bpo-35401: Update macOS installer to use OpenSSL 1.1.0j.

  • bpo-35025: Properly guard the use of the CLOCK_GETTIME et al. macros in timemodule on macOS.

  • bpo-24658: On macOS, fix reading from and writing into a file with a size larger than 2 GiB.

  • bpo-34405: Update to OpenSSL 1.1.0i for macOS installer builds.

  • bpo-33635: In macOS stat on some file descriptors (/dev/fd/3 f.e) will result in bad file descriptor OSError. Guard against this exception was added in is_dir, is_file and similar methods. DirEntry.is_dir can also throw this exception so _RecursiveWildcardSelector._iterate_directories was also extended with the same error ignoring pattern.

  • bpo-13631: The .editrc file in user’s home directory is now processed correctly during the readline initialization through editline emulation on macOS.

  • bpo-33184: Update macOS installer build to use OpenSSL 1.1.0h.

  • bpo-32726: Build and link with private copy of Tcl/Tk 8.6 for the macOS 10.6+ installer. The 10.9+ installer variant already does this. This means that the Python 3.7 provided by the python.org macOS installers no longer need or use any external versions of Tcl/Tk, either system-provided or user-installed, such as ActiveTcl.

  • bpo-32901: Update macOS 10.9+ installer to Tcl/Tk 8.6.8.

  • bpo-31903: In _scproxy, drop the GIL when calling into SystemConfiguration to avoid deadlocks.

IDLE

  • bpo-35770: IDLE macosx deletes Options => Configure IDLE. It previously deleted Window => Zoom Height by mistake. (Zoom Height is now on the Options menu). On Mac, the settings dialog is accessed via Preferences on the IDLE menu.

  • bpo-35769: Change IDLE’s new file name from “Untitled” to “untitled”

  • bpo-35660: Fix imports in idlelib.window.

  • bpo-35641: Proper format calltip when the function has no docstring.

  • bpo-33987: Use ttk Frame for ttk widgets.

  • bpo-34055: Fix erroneous “smart” indents and newlines in IDLE Shell.

  • bpo-35591: Find Selection now works when selection not found.

  • bpo-35196: Speed up squeezer line counting.

  • bpo-35598: Update config_key: use PEP 8 names and ttk widgets, make some objects global, and add tests.

  • bpo-28097: Add Previous/Next History entries to Shell menu.

  • bpo-35208: Squeezer now properly counts wrapped lines before newlines.

  • bpo-35555: Gray out Code Context menu entry when it’s not applicable.

  • bpo-35521: Document the IDLE editor code context feature. Add some internal references within the IDLE doc.

  • bpo-22703: The Code Context menu label now toggles between Show/Hide Code Context. The Zoom Height menu now toggles between Zoom/Restore Height. Zoom Height has moved from the Window menu to the Options menu.

  • bpo-35213: Where appropriate, use “macOS” in idlelib.

  • bpo-34864: On macOS, warn if the system preference «Prefer tabs when opening documents» is set to «Always».

  • bpo-34864: Document two IDLE on MacOS issues. The System Preferences Dock «prefer tabs always» setting disables some IDLE features. Menus are a bit different than as described for Windows and Linux.

  • bpo-35202: Remove unused imports from lib/idlelib

  • bpo-33000: Document that IDLE’s shell has no line limit. A program that runs indefinitely can overfill memory.

  • bpo-23220: Explain how IDLE’s Shell displays output.

  • bpo-35099: Improve the doc about IDLE running user code. The section is renamed from «IDLE – console differences» is renamed «Running user code». It mostly covers the implications of using custom sys.stdxxx objects.

  • bpo-35097: Add IDLE doc subsection explaining editor windows. Topics include opening, title and status bar, .py* extension, and running.

  • bpo-35093: Document the IDLE document viewer in the IDLE doc. Add a paragraph in «Help and preferences», «Help sources» subsection.

  • bpo-35088: Update idlelib.help.copy_string docstring. We now use git and backporting instead of hg and forward merging.

  • bpo-35087: Update idlelib help files for the current doc build. The main change is the elimination of chapter-section numbers.

  • bpo-34548: Use configured color theme for read-only text views.

  • bpo-1529353: Enable «squeezing» of long outputs in the shell, to avoid performance degradation and to clean up the history without losing it. Squeezed outputs may be copied, viewed in a separate window, and «unsqueezed».

  • bpo-34047: Fixed mousewheel scrolling direction on macOS.

  • bpo-34275: Make IDLE calltips always visible on Mac. Some MacOS-tk combinations need .update_idletasks(). Patch by Kevin Walzer.

  • bpo-34120: Fix unresponsiveness after closing certain windows and dialogs.

  • bpo-33975: Avoid small type when running htests. Since part of the purpose of human-viewed tests is to determine that widgets look right, it is important that they look the same for testing as when running IDLE.

  • bpo-33905: Add test for idlelib.stackview.StackBrowser.

  • bpo-33924: Change mainmenu.menudefs key “windows” to “window”. Every other menudef key is lowercase version of main menu entry.

  • bpo-33906: Rename idlelib.windows as window Match Window on the main menu and remove last plural module name.

  • bpo-33917: Fix and document idlelib/idle_test/template.py. The revised file compiles, runs, and tests OK. idle_test/README.txt explains how to use it to create new IDLE test files.

  • bpo-33904: IDLE: In rstrip, rename class RstripExtension as Rstrip

  • bpo-33907: For consistency and clarity, rename an IDLE module and classes. Module calltips and its class CallTips are now calltip and Calltip. In module calltip_w, class CallTip is now CalltipWindow.

  • bpo-33856: Add «help» in the welcome message of IDLE

  • bpo-33839: IDLE: refactor ToolTip and CallTip and add documentation and tests

  • bpo-33855: Minimally test all IDLE modules. Add missing files, import module, instantiate classes, and check coverage. Check existing files.

  • bpo-33656: On Windows, add API call saying that tk scales for DPI. On Windows 8.1+ or 10, with DPI compatibility properties of the Python binary unchanged, and a monitor resolution greater than 96 DPI, this should make text and lines sharper. It should otherwise have no effect.

  • bpo-33768: Clicking on a context line moves that line to the top of the editor window.

  • bpo-33763: IDLE: Use read-only text widget for code context instead of label widget.

  • bpo-33664: Scroll IDLE editor text by lines. Previously, the mouse wheel and scrollbar slider moved text by a fixed number of pixels, resulting in partial lines at the top of the editor box. The change also applies to the shell and grep output windows, but not to read-only text views.

  • bpo-33679: Enable theme-specific color configuration for Code Context. Use the Highlights tab to see the setting for built-in themes or add settings to custom themes.

  • bpo-33642: Display up to maxlines non-blank lines for Code Context. If there is no current context, show a single blank line.

  • bpo-33628: IDLE: Cleanup codecontext.py and its test.

  • bpo-33564: IDLE’s code context now recognizes async as a block opener.

  • bpo-21474: Update word/identifier definition from ascii to unicode. In text and entry boxes, this affects selection by double-click, movement left/right by control-left/right, and deletion left/right by control-BACKSPACE/DEL.

  • bpo-33204: IDLE: consistently color invalid string prefixes. A “u” string prefix cannot be paired with either “r” or “f”. Consistently color as much of the prefix, starting at the right, as is valid. Revise and extend colorizer test.

  • bpo-32984: Set __file__ while running a startup file. Like Python, IDLE optionally runs one startup file in the Shell window before presenting the first interactive input prompt. For IDLE, -s runs a file named in environmental variable IDLESTARTUP or PYTHONSTARTUP; -r file runs file. Python sets __file__ to the startup file name before running the file and unsets it before the first prompt. IDLE now does the same when run normally, without the -n option.

  • bpo-32940: Simplify and rename StringTranslatePseudoMapping in pyparse.

  • bpo-32916: Change str to code in pyparse.

  • bpo-32905: Remove unused code in pyparse module.

  • bpo-32874: Add tests for pyparse.

  • bpo-32837: Using the system and place-dependent default encoding for open() is a bad idea for IDLE’s system and location-independent files.

  • bpo-32826: Add «encoding=utf-8» to open() in IDLE’s test_help_about. GUI test test_file_buttons() only looks at initial ascii-only lines, but failed on systems where open() defaults to “ascii” because readline() internally reads and decodes far enough ahead to encounter a non-ascii character in CREDITS.txt.

  • bpo-32831: Add docstrings and tests for codecontext.

  • bpo-32765: Update configdialog General tab docstring to add new widgets to the widget list.

Tools/Demos

  • bpo-35884: Add a benchmark script for timing various ways to access variables: Tools/scripts/var_access_benchmark.py.

  • bpo-34989: python-gdb.py now handles errors on computing the line number of a Python frame.

  • bpo-20260: Argument Clinic now has non-bitwise unsigned int converters.

  • bpo-32962: python-gdb now catches UnicodeDecodeError exceptions when calling string().

  • bpo-32962: python-gdb now catches ValueError on read_var(): when Python has no debug symbols for example.

  • bpo-33189: pygettext.py now recognizes only literal strings as docstrings and translatable strings, and rejects bytes literals and f-string expressions.

  • bpo-31920: Fixed handling directories as arguments in the pygettext script. Based on patch by Oleg Krasnikov.

  • bpo-29673: Fix pystackv and pystack gdbinit macros.

  • bpo-25427: Remove the pyvenv script in favor of python3 -m venv in order to lower confusion as to what Python interpreter a virtual environment will be created for.

  • bpo-32885: Add an -n flag for Tools/scripts/pathfix.py to disable automatic backup creation (files with ~ suffix).

  • bpo-32222: Fix pygettext not extracting docstrings for functions with type annotated arguments. Patch by Toby Harradine.

  • bpo-31583: Fix 2to3 for using with –add-suffix option but without –output-dir option for relative path to files in current directory.

C API

Python 3.7.0 final

Release date: 2018-06-27

Library

C API

  • bpo-33932: Calling Py_Initialize() twice does nothing, instead of failing with a fatal error: restore the Python 3.6 behaviour.

Python 3.7.0 release candidate 1

Release date: 2018-06-12

Core and Builtins

  • bpo-33803: Fix a crash in hamt.c caused by enabling GC tracking for an object that hadn’t all of its fields set to NULL.

  • bpo-33706: Fix a crash in Python initialization when parsing the command line options. Thanks Christoph Gohlke for the bug report and the fix!

  • bpo-30654: Fixed reset of the SIGINT handler to SIG_DFL on interpreter shutdown even when there was a custom handler set previously. Patch by Philipp Kerling.

  • bpo-31849: Fix signed/unsigned comparison warning in pyhash.c.

Library

  • bpo-30167: Prevent site.main() exception if PYTHONSTARTUP is set. Patch by Steve Weber.

  • bpo-33812: Datetime instance d with non-None tzinfo, but with d.tzinfo.utcoffset(d) returning None is now treated as naive by the astimezone() method.

  • bpo-30805: Avoid race condition with debug logging

  • bpo-33694: asyncio: Fix a race condition causing data loss on pause_reading()/resume_reading() when using the ProactorEventLoop.

  • bpo-32493: Correct test for uuid_enc_be availability in configure.ac. Patch by Michael Felt.

  • bpo-33792: Add asyncio.WindowsSelectorEventLoopPolicy and asyncio.WindowsProactorEventLoopPolicy.

  • bpo-33778: Update unicodedata’s database to Unicode version 11.0.0.

  • bpo-33770: improve base64 exception message for encoded inputs of invalid length

  • bpo-33769: asyncio/start_tls: Fix error message; cancel callbacks in case of an unhandled error; mark SSLTransport as closed if it is aborted.

  • bpo-33767: The concatenation (+) and repetition (*) sequence operations now raise TypeError instead of SystemError when performed on mmap.mmap objects. Patch by Zackery Spytz.

  • bpo-33734: asyncio/ssl: Fix AttributeError, increase default handshake timeout

  • bpo-11874: Use a better regex when breaking usage into wrappable parts. Avoids bogus assertion errors from custom metavar strings.

  • bpo-33582: Emit a deprecation warning for inspect.formatargspec

Documentation

Build

  • bpo-5755: Move -Wstrict-prototypes option to CFLAGS_NODIST from OPT. This option emitted annoying warnings when building extension modules written in C++.

Windows

  • bpo-33720: Reduces maximum marshal recursion depth on release builds.

IDLE

  • bpo-33656: On Windows, add API call saying that tk scales for DPI. On Windows 8.1+ or 10, with DPI compatibility properties of the Python binary unchanged, and a monitor resolution greater than 96 DPI, this should make text and lines sharper. It should otherwise have no effect.

  • bpo-33768: Clicking on a context line moves that line to the top of the editor window.

  • bpo-33763: IDLE: Use read-only text widget for code context instead of label widget.

  • bpo-33664: Scroll IDLE editor text by lines. Previously, the mouse wheel and scrollbar slider moved text by a fixed number of pixels, resulting in partial lines at the top of the editor box. The change also applies to the shell and grep output windows, but not to read-only text views.

  • bpo-33679: Enable theme-specific color configuration for Code Context. Use the Highlights tab to see the setting for built-in themes or add settings to custom themes.

  • bpo-33642: Display up to maxlines non-blank lines for Code Context. If there is no current context, show a single blank line.

Python 3.7.0 beta 5

Release date: 2018-05-30

Core and Builtins

  • bpo-33622: Fixed a leak when the garbage collector fails to add an object with the __del__ method or referenced by it into the gc.garbage list. PyGC_Collect() can now be called when an exception is set and preserves it.

  • bpo-33509: Fix module_globals parameter of warnings.warn_explicit(): don’t crash if module_globals is not a dict.

  • bpo-20104: The new os.posix_spawn added in 3.7.0b1 was removed as we are still working on what the API should look like. Expect this in 3.8 instead.

  • bpo-33475: Fixed miscellaneous bugs in converting annotations to strings and optimized parentheses in the string representation.

  • bpo-33391: Fix a leak in set_symmetric_difference().

  • bpo-28055: Fix unaligned accesses in siphash24(). Patch by Rolf Eike Beer.

  • bpo-32911: Due to unexpected compatibility issues discovered during downstream beta testing, reverted bpo-29463. docstring field is removed from Module, ClassDef, FunctionDef, and AsyncFunctionDef ast nodes which was added in 3.7a1. Docstring expression is restored as a first statement in their body. Based on patch by Inada Naoki.

  • bpo-21983: Fix a crash in ctypes.cast() in case the type argument is a ctypes structured data type. Patch by Eryk Sun and Oren Milman.

Library

  • bpo-32751: When cancelling the task due to a timeout, asyncio.wait_for() will now wait until the cancellation is complete.

  • bpo-32684: Fix gather to propagate cancellation of itself even with return_exceptions.

  • bpo-33654: Support protocol type switching in SSLTransport.set_protocol().

  • bpo-33674: Pause the transport as early as possible to further reduce the risk of data_received() being called before connection_made().

  • bpo-33674: Fix a race condition in SSLProtocol.connection_made() of asyncio.sslproto: start immediately the handshake instead of using call_soon(). Previously, data_received() could be called before the handshake started, causing the handshake to hang or fail.

  • bpo-31647: Fixed bug where calling write_eof() on a _SelectorSocketTransport after it’s already closed raises AttributeError.

  • bpo-32610: Make asyncio.all_tasks() return only pending tasks.

  • bpo-32410: Avoid blocking on file IO in sendfile fallback code

  • bpo-33469: Fix RuntimeError after closing loop that used run_in_executor

  • bpo-33672: Fix Task.__repr__ crash with Cython’s bogus coroutines

  • bpo-33654: Fix transport.set_protocol() to support switching between asyncio.Protocol and asyncio.BufferedProtocol. Fix loop.start_tls() to work with asyncio.BufferedProtocols.

  • bpo-33652: Pickles of type variables and subscripted generics are now future-proof and compatible with older Python versions.

  • bpo-32493: Fixed uuid.uuid1() on FreeBSD.

  • bpo-33618: Finalize and document preliminary and experimental TLS 1.3 support with OpenSSL 1.1.1

  • bpo-33623: Fix possible SIGSGV when asyncio.Future is created in __del__

  • bpo-30877: Fixed a bug in the Python implementation of the JSON decoder that prevented the cache of parsed strings from clearing after finishing the decoding. Based on patch by c-fos.

  • bpo-33570: Change TLS 1.3 cipher suite settings for compatibility with OpenSSL 1.1.1-pre6 and newer. OpenSSL 1.1.1 will have TLS 1.3 ciphers enabled by default.

  • bpo-28556: Do not simplify arguments to typing.Union. Now Union[Manager, Employee] is not simplified to Employee at runtime. Such simplification previously caused several bugs and limited possibilities for introspection.

  • bpo-33540: Add a new block_on_close class attribute to ForkingMixIn and ThreadingMixIn classes of socketserver.

  • bpo-33548: tempfile._candidate_tempdir_list should consider common TEMP locations

  • bpo-33109: argparse subparsers are once again not required by default, reverting the change in behavior introduced by bpo-26510 in 3.7.0a2.

  • bpo-33536: dataclasses.make_dataclass now checks for invalid field names and duplicate fields. Also, added a check for invalid field specifications.

  • bpo-33542: Prevent uuid.get_node from using a DUID instead of a MAC on Windows. Patch by Zvi Effron

  • bpo-26819: Fix race condition with ReadTransport.resume_reading in Windows proactor event loop.

  • Fix failure in typing.get_type_hints() when ClassVar was provided as a string forward reference.

  • bpo-33505: Optimize asyncio.ensure_future() by reordering if checks: 1.17x faster.

  • bpo-33497: Add errors param to cgi.parse_multipart and make an encoding in FieldStorage use the given errors (needed for Twisted). Patch by Amber Brown.

  • bpo-33495: Change dataclasses.Fields repr to use the repr of each of its members, instead of str. This makes it more clear what each field actually represents. This is especially true for the “type” member.

  • bpo-33453: Fix dataclasses to work if using literal string type annotations or if using PEP 563 «Postponed Evaluation of Annotations». Only specific string prefixes are detected for both ClassVar («ClassVar» and «typing.ClassVar») and InitVar («InitVar» and «dataclasses.InitVar»).

  • bpo-28556: Minor fixes in typing module: add annotations to NamedTuple.__new__, pass *args and **kwds in Generic.__new__. Original PRs by Paulius Šarka and Chad Dombrova.

  • bpo-20087: Updated alias mapping with glibc 2.27 supported locales.

  • bpo-33422: Fix trailing quotation marks getting deleted when looking up byte/string literals on pydoc. Patch by Andrés Delfino.

  • bpo-28167: The function platform.linux_distribution and platform.dist now trigger a DeprecationWarning and have been marked for removal in Python 3.8

  • bpo-33197: Update error message when constructing invalid inspect.Parameters Patch by Donghee Na.

  • bpo-33263: Fix FD leak in _SelectorSocketTransport Patch by Vlad Starostin.

  • bpo-32861: The urllib.robotparser’s __str__ representation now includes wildcard entries and the «Crawl-delay» and «Request-rate» fields. Patch by Michael Lazar.

  • bpo-32257: The ssl module now contains OP_NO_RENEGOTIATION constant, available with OpenSSL 1.1.0h or 1.1.1.

  • bpo-16865: Support arrays >=2GiB in ctypes. Patch by Segev Finer.

Documentation

  • bpo-23859: Document that asyncio.wait() does not cancel its futures on timeout.

  • bpo-32436: Document PEP 567 changes to asyncio.

  • bpo-33604: Update HMAC md5 default to a DeprecationWarning, bump removal to 3.8.

  • bpo-33503: Fix broken pypi link

  • bpo-33421: Add missing documentation for typing.AsyncContextManager.

Tests

  • bpo-33655: Ignore test_posix_fallocate failures on BSD platforms that might be due to running on ZFS.

  • bpo-32604: Remove the _xxsubinterpreters module (meant for testing) and associated helpers. This module was originally added recently in 3.7b1.

Build

  • bpo-33614: Ensures module definition files for the stable ABI on Windows are correctly regenerated.

  • bpo-33522: Enable CI builds on Visual Studio Team Services at https://python.visualstudio.com/cpython

  • bpo-33012: Add -Wno-cast-function-type for gcc 8 for silencing warnings about function casts like casting to PyCFunction in method definition lists.

macOS

  • bpo-13631: The .editrc file in user’s home directory is now processed correctly during the readline initialization through editline emulation on macOS.

IDLE

  • bpo-33628: IDLE: Cleanup codecontext.py and its test.

  • bpo-33564: IDLE’s code context now recognizes async as a block opener.

  • bpo-32831: Add docstrings and tests for codecontext.

Python 3.7.0 beta 4

Release date: 2018-05-02

Core and Builtins

  • bpo-33363: Raise a SyntaxError for async with and async for statements outside of async functions.

  • bpo-33128: Fix a bug that causes PathFinder to appear twice on sys.meta_path. Patch by Pablo Galindo Salgado.

  • bpo-33312: Fixed clang ubsan (undefined behavior sanitizer) warnings in dictobject.c by adjusting how the internal struct _dictkeysobject shared keys structure is declared.

  • bpo-33231: Fix potential memory leak in normalizestring().

  • bpo-33205: Change dict growth function from round_up_to_power_2(used*2+hashtable_size/2) to round_up_to_power_2(used*3). Previously, dict is shrunk only when used == 0. Now dict has more chance to be shrunk.

  • bpo-29922: Improved error messages in “async with” when __aenter__() or __aexit__() return non-awaitable object.

  • bpo-33199: Fix ma_version_tag in dict implementation is uninitialized when copying from key-sharing dict.

Library

  • bpo-33281: Fix ctypes.util.find_library regression on macOS.

  • bpo-33383: Fixed crash in the get() method of the dbm.ndbm database object when it is called with a single argument.

  • bpo-33329: Fix multiprocessing regression on newer glibcs

  • bpo-991266: Fix quoting of the Comment attribute of http.cookies.SimpleCookie.

  • bpo-33131: Upgrade bundled version of pip to 10.0.1.

  • bpo-33308: Fixed a crash in the parser module when converting an ST object to a tree of tuples or lists with line_info=False and col_info=True.

  • bpo-33266: lib2to3 now recognizes rf'...' strings.

  • bpo-11594: Ensure line-endings are respected when using lib2to3.

  • bpo-33254: Have importlib.resources.contents() and importlib.abc.ResourceReader.contents() return an iterable instead of an iterator.

  • bpo-33256: Fix display of <module> call in the html produced by cgitb.html(). Patch by Stéphane Blondon.

  • bpo-33185: Fixed regression when running pydoc with the -m switch. (The regression was introduced in 3.7.0b3 by the resolution of bpo-33053) This fix also changed pydoc to add os.getcwd() to sys.path when necessary, rather than adding ".".

  • bpo-33169: Delete entries of None in sys.path_importer_cache when importlib.machinery.invalidate_caches() is called.

  • bpo-33217: Deprecate looking up non-Enum objects in Enum classes and Enum members (will raise TypeError in 3.8+).

  • bpo-33203: random.Random.choice() now raises IndexError for empty sequences consistently even when called from subclasses without a getrandbits() implementation.

  • bpo-33224: Update difflib.mdiff() for PEP 479. Convert an uncaught StopIteration in a generator into a return-statement.

  • bpo-33209: End framing at the end of C implementation of pickle.Pickler.dump().

  • bpo-20104: Improved error handling and fixed a reference leak in os.posix_spawn().

  • bpo-33175: In dataclasses, Field.__set_name__ now looks up the __set_name__ special method on the class, not the instance, of the default value.

  • bpo-33097: Raise RuntimeError when executor.submit is called during interpreter shutdown.

  • bpo-31908: Fix output of cover files for trace module command-line tool. Previously emitted cover files only when --missing option was used. Patch by Michael Selik.

Documentation

  • bpo-33378: Add Korean language switcher for https://docs.python.org/3/

  • bpo-33276: Clarify that the __path__ attribute on modules cannot be just any value.

  • bpo-33201: Modernize documentation for writing C extension types.

  • bpo-33195: Deprecate Py_UNICODE usage in c-api/arg document. Py_UNICODE related APIs are deprecated since Python 3.3, but it is missed in the document.

  • bpo-8243: Add a note about curses.addch and curses.addstr exception behavior when writing outside a window, or pad.

  • bpo-32337: Update documentation related with dict order.

Tests

  • bpo-33358: Fix test_embed.test_pre_initialization_sys_options() when the interpreter is built with --enable-shared.

Build

  • bpo-33394: Enable the verbose build for extension modules, when GNU make is passed macros on the command line.

  • bpo-33393: Update config.guess and config.sub files.

  • bpo-33377: Add new triplets for mips r6 and riscv variants (used in extension suffixes).

  • bpo-32232: By default, modules configured in Modules/Setup are no longer built with -DPy_BUILD_CORE. Instead, modules that specifically need that preprocessor definition include it in their individual entries.

  • bpo-33182: The embedding tests can once again be built with clang 6.0

Windows

  • bpo-33184: Update Windows installer to use OpenSSL 1.1.0h.

macOS

  • bpo-33184: Update macOS installer build to use OpenSSL 1.1.0h.

IDLE

  • bpo-21474: Update word/identifier definition from ascii to unicode. In text and entry boxes, this affects selection by double-click, movement left/right by control-left/right, and deletion left/right by control-BACKSPACE/DEL.

  • bpo-33204: IDLE: consistently color invalid string prefixes. A “u” string prefix cannot be paired with either “r” or “f”. Consistently color as much of the prefix, starting at the right, as is valid. Revise and extend colorizer test.

Tools/Demos

  • bpo-33189: pygettext.py now recognizes only literal strings as docstrings and translatable strings, and rejects bytes literals and f-string expressions.

  • bpo-31920: Fixed handling directories as arguments in the pygettext script. Based on patch by Oleg Krasnikov.

  • bpo-29673: Fix pystackv and pystack gdbinit macros.

  • bpo-31583: Fix 2to3 for using with –add-suffix option but without –output-dir option for relative path to files in current directory.

Python 3.7.0 beta 3

Release date: 2018-03-29

Security

  • bpo-33136: Harden ssl module against LibreSSL CVE 2018-8970. X509_VERIFY_PARAM_set1_host() is called with an explicit namelen. A new test ensures that NULL bytes are not allowed.

  • bpo-33001: Minimal fix to prevent buffer overrun in os.symlink on Windows

  • bpo-32981: Regexes in difflib and poplib were vulnerable to catastrophic backtracking. These regexes formed potential DOS vectors (REDOS). They have been refactored. This resolves CVE 2018-1060 and CVE 2018-1061. Patch by Jamie Davis.

Core and Builtins

  • bpo-33053: When using the -m switch, sys.path[0] is now explicitly expanded as the starting working directory, rather than being left as the empty path (which allows imports from the current working directory at the time of the import)

  • bpo-33018: Improve consistency of errors raised by issubclass() when called with a non-class and an abstract base class as the first and second arguments, respectively. Patch by Josh Bronson.

  • bpo-33041: Fixed jumping when the function contains an async for loop.

  • bpo-33026: Fixed jumping out of «with» block by setting f_lineno.

  • bpo-33005: Fix a crash on fork when using a custom memory allocator (ex: using PYTHONMALLOC env var). _PyGILState_Reinit() and _PyInterpreterState_Enable() now use the default RAW memory allocator to allocate a new interpreters mutex on fork.

  • bpo-17288: Prevent jumps from “return” and “exception” trace events.

  • bpo-32836: Don’t use temporary variables in cases of list/dict/set comprehensions

Library

  • bpo-33141: Have Field objects pass through __set_name__ to their default values, if they have their own __set_name__.

  • bpo-33096: Allow ttk.Treeview.insert to insert iid that has a false boolean value. Note iid=0 and iid=False would be same. Patch by Garvit Khatri.

  • bpo-32873: Treat type variables and special typing forms as immutable by copy and pickle. This fixes several minor issues and inconsistencies, and improves backwards compatibility with Python 3.6.

  • bpo-33134: When computing dataclass’s __hash__, use the lookup table to contain the function which returns the __hash__ value. This is an improvement over looking up a string, and then testing that string to see what to do.

  • bpo-33127: The ssl module now compiles with LibreSSL 2.7.1.

  • bpo-32505: Raise TypeError if a member variable of a dataclass is of type Field, but doesn’t have a type annotation.

  • bpo-33078: Fix the failure on OSX caused by the tests relying on sem_getvalue

  • bpo-33116: Add “Field” to dataclasses.__all__.

  • bpo-32896: Fix an error where subclassing a dataclass with a field that uses a default_factory would generate an incorrect class.

  • bpo-33100: Dataclasses: If a field has a default value that’s a MemberDescriptorType, then it’s from that field being in __slots__, not an actual default value.

  • bpo-32953: If a non-dataclass inherits from a frozen dataclass, allow attributes to be added to the derived class. Only attributes from the frozen dataclass cannot be assigned to. Require all dataclasses in a hierarchy to be either all frozen or all non-frozen.

  • bpo-33061: Add missing NoReturn to __all__ in typing.py

  • bpo-33078: Fix the size handling in multiprocessing.Queue when a pickling error occurs.

  • bpo-33064: lib2to3 now properly supports trailing commas after *args and **kwargs in function signatures.

  • bpo-33056: FIX properly close leaking fds in concurrent.futures.ProcessPoolExecutor.

  • bpo-33021: Release the GIL during fstat() calls, avoiding hang of all threads when calling mmap.mmap(), os.urandom(), and random.seed(). Patch by Nir Soffer.

  • bpo-31804: Avoid failing in multiprocessing.Process if the standard streams are closed or None at exit.

  • bpo-33037: Skip sending/receiving data after SSL transport closing.

  • bpo-27683: Fix a regression in ipaddress that result of hosts() is empty when the network is constructed by a tuple containing an integer mask and only 1 bit left for addresses.

  • bpo-32999: Fix C implementation of ABC.__subclasscheck__(cls, subclass) crashed when subclass is not a type object.

  • bpo-33009: Fix inspect.signature() for single-parameter partialmethods.

  • bpo-32969: Expose several missing constants in zlib and fix corresponding documentation.

  • bpo-32056: Improved exceptions raised for invalid number of channels and sample width when read an audio file in modules aifc, wave and sunau.

  • bpo-32844: Fix wrong redirection of a low descriptor (0 or 1) to stderr in subprocess if another low descriptor is closed.

  • bpo-32857: In tkinter, after_cancel(None) now raises a ValueError instead of canceling the first scheduled function. Patch by Cheryl Sabella.

  • bpo-31639: http.server now exposes a ThreadedHTTPServer class and uses it when the module is run with -m to cope with web browsers pre-opening sockets.

  • bpo-27645: sqlite3.Connection now exposes a backup method, if the underlying SQLite library is at version 3.6.11 or higher. Patch by Lele Gaifax.

Documentation

  • bpo-33126: Document PyBuffer_ToContiguous().

  • bpo-27212: Modify documentation for the islice() recipe to consume initial values up to the start index.

  • bpo-28247: Update zipapp documentation to describe how to make standalone applications.

  • bpo-18802: Documentation changes for ipaddress. Patch by Jon Foster and Berker Peksag.

  • bpo-27428: Update documentation to clarify that WindowsRegistryFinder implements MetaPathFinder. (Patch by Himanshu Lakhara)

Tests

  • bpo-32872: Avoid regrtest compatibility issue with namespace packages.

  • bpo-32517: Fix failing test_asyncio on macOS 10.12.2+ due to transport of KqueueSelector loop was not being closed.

  • bpo-19417: Add test_bdb.py.

Build

  • bpo-33163: Upgrade pip to 9.0.3 and setuptools to v39.0.1.

Windows

  • bpo-33016: Fix potential use of uninitialized memory in nt._getfinalpathname

  • bpo-32903: Fix a memory leak in os.chdir() on Windows if the current directory is set to a UNC path.

macOS

  • bpo-32726: Build and link with private copy of Tcl/Tk 8.6 for the macOS 10.6+ installer. The 10.9+ installer variant already does this. This means that the Python 3.7 provided by the python.org macOS installers no longer need or use any external versions of Tcl/Tk, either system-provided or user-installed, such as ActiveTcl.

IDLE

  • bpo-32984: Set __file__ while running a startup file. Like Python, IDLE optionally runs one startup file in the Shell window before presenting the first interactive input prompt. For IDLE, -s runs a file named in environmental variable IDLESTARTUP or PYTHONSTARTUP; -r file runs file. Python sets __file__ to the startup file name before running the file and unsets it before the first prompt. IDLE now does the same when run normally, without the -n option.

  • bpo-32940: Simplify and rename StringTranslatePseudoMapping in pyparse.

Tools/Demos

  • bpo-32885: Add an -n flag for Tools/scripts/pathfix.py to disable automatic backup creation (files with ~ suffix).

C API

  • bpo-33042: Embedding applications may once again call PySys_ResetWarnOptions, PySys_AddWarnOption, and PySys_AddXOption prior to calling Py_Initialize.

  • bpo-32374: Document that m_traverse for multi-phase initialized modules can be called with m_state=NULL, and add a sanity check

Python 3.7.0 beta 2

Release date: 2018-02-27

Security

  • bpo-28414: The ssl module now allows users to perform their own IDN en/decoding when using SNI.

Core and Builtins

  • bpo-32889: Update Valgrind suppression list to account for the rename of Py_ADDRESS_IN_RANG to address_in_range.

  • bpo-31356: Remove the new API added in bpo-31356 (gc.ensure_disabled() context manager).

  • bpo-32305: For namespace packages, ensure that both __file__ and __spec__.origin are set to None.

  • bpo-32303: Make sure __spec__.loader matches __loader__ for namespace packages.

  • bpo-32711: Fix the warning messages for Python/ast_unparse.c. Patch by Stéphane Wirtel

  • bpo-32583: Fix possible crashing in builtin Unicode decoders caused by write out-of-bound errors when using customized decode error handlers.

Library

  • bpo-32960: For dataclasses, disallow inheriting frozen from non-frozen classes, and also disallow inheriting non-frozen from frozen classes. This restriction will be relaxed at a future date.

  • bpo-32713: Fixed tarfile.itn handling of out-of-bounds float values. Patch by Joffrey Fuhrer.

  • bpo-32951: Direct instantiation of SSLSocket and SSLObject objects is now prohibited. The constructors were never documented, tested, or designed as public constructors. Users were suppose to use ssl.wrap_socket() or SSLContext.

  • bpo-32929: Remove the tri-state parameter «hash», and add the boolean «unsafe_hash». If unsafe_hash is True, add a __hash__ function, but if a __hash__ exists, raise TypeError. If unsafe_hash is False, add a __hash__ based on the values of eq= and frozen=. The unsafe_hash=False behavior is the same as the old hash=None behavior. unsafe_hash=False is the default, just as hash=None used to be.

  • bpo-32947: Add OP_ENABLE_MIDDLEBOX_COMPAT and test workaround for TLSv1.3 for future compatibility with OpenSSL 1.1.1.

  • bpo-30622: The ssl module now detects missing NPN support in LibreSSL.

  • bpo-32922: dbm.open() now encodes filename with the filesystem encoding rather than default encoding.

  • bpo-32859: In os.dup2, don’t check every call whether the dup3 syscall exists or not.

  • bpo-32556: nt._getfinalpathname, nt._getvolumepathname and nt._getdiskusage now correctly convert from bytes.

  • bpo-25988: Emit a DeprecationWarning when using or importing an ABC directly from collections rather than from collections.abc.

  • bpo-21060: Rewrite confusing message from setup.py upload from «No dist file created in earlier command» to the more helpful «Must create and upload files in one command».

  • bpo-32852: Make sure sys.argv remains as a list when running trace.

  • bpo-31333: _abc module is added. It is a speedup module with C implementations for various functions and methods in abc. Creating an ABC subclass and calling isinstance or issubclass with an ABC subclass are up to 1.5x faster. In addition, this makes Python start-up up to 10% faster. Note that the new implementation hides internal registry and caches, previously accessible via private attributes _abc_registry, _abc_cache, and _abc_negative_cache. There are three debugging helper methods that can be used instead _dump_registry, _abc_registry_clear, and _abc_caches_clear.

  • bpo-32841: Fixed asyncio.Condition issue which silently ignored cancellation after notifying and cancelling a conditional lock. Patch by Bar Harel.

  • bpo-32819: ssl.match_hostname() has been simplified and no longer depends on re and ipaddress module for wildcard and IP addresses. Error reporting for invalid wildcards has been improved.

  • bpo-32394: socket: Remove TCP_FASTOPEN,TCP_KEEPCNT,TCP_KEEPIDLE,TCP_KEEPINTVL flags on older version Windows during run-time.

  • bpo-31787: Fixed refleaks of __init__() methods in various modules. (Contributed by Oren Milman)

  • bpo-30157: Fixed guessing quote and delimiter in csv.Sniffer.sniff() when only the last field is quoted. Patch by Jake Davis.

  • bpo-32792: collections.ChainMap() preserves the order of the underlying mappings.

  • bpo-32775: fnmatch.translate() no longer produces patterns which contain set operations. Sets starting with “[” or containing “–”, “&&”, “~~” or “||” will be interpreted differently in regular expressions in future versions. Currently they emit warnings. fnmatch.translate() now avoids producing patterns containing such sets by accident.

  • bpo-32622: Implement native fast sendfile for Windows proactor event loop.

  • bpo-32777: Fix a rare but potential pre-exec child process deadlock in subprocess on POSIX systems when marking file descriptors inheritable on exec in the child process. This bug appears to have been introduced in 3.4.

  • bpo-32647: The ctypes module used to depend on indirect linking for dlopen. The shared extension is now explicitly linked against libdl on platforms with dl.

  • bpo-32741: Implement asyncio.TimerHandle.when() method.

  • bpo-32691: Use mod_spec.parent when running modules with pdb

  • bpo-32734: Fixed asyncio.Lock() safety issue which allowed acquiring and locking the same lock multiple times, without it being free. Patch by Bar Harel.

  • bpo-32727: Do not include name field in SMTP envelope from address. Patch by Stéphane Wirtel

  • bpo-31453: Add TLSVersion constants and SSLContext.maximum_version / minimum_version attributes. The new API wraps OpenSSL 1.1 https://web.archive.org/web/20180309043602/https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_set_min_proto_version.html feature.

  • bpo-24334: Internal implementation details of ssl module were cleaned up. The SSLSocket has one less layer of indirection. Owner and session information are now handled by the SSLSocket and SSLObject constructor. Channel binding implementation has been simplified.

  • bpo-31848: Fix the error handling in Aifc_read.initfp() when the SSND chunk is not found. Patch by Zackery Spytz.

  • bpo-32585: Add Ttk spinbox widget to tkinter.ttk. Patch by Alan D Moore.

  • bpo-32221: Various functions returning tuple containing IPv6 addresses now omit %scope part since the same information is already encoded in scopeid tuple item. Especially this speeds up socket.recvfrom() when it receives multicast packet since useless resolving of network interface name is omitted.

  • bpo-30693: The TarFile class now recurses directories in a reproducible way.

  • bpo-30693: The ZipFile class now recurses directories in a reproducible way.

Documentation

  • bpo-28124: The ssl module function ssl.wrap_socket() has been de-emphasized and deprecated in favor of the more secure and efficient SSLContext.wrap_socket() method.

  • bpo-17232: Clarify docs for -O and -OO. Patch by Terry Reedy.

  • bpo-32436: Add documentation for the contextvars module (PEP 567).

  • bpo-32800: Update link to w3c doc for xml default namespaces.

  • bpo-11015: Update test.support documentation.

  • bpo-8722: Document __getattr__() behavior when property get() method raises AttributeError.

  • bpo-32614: Modify RE examples in documentation to use raw strings to prevent DeprecationWarning and add text to REGEX HOWTO to highlight the deprecation.

  • bpo-31972: Improve docstrings for pathlib.PurePath subclasses.

Tests

  • bpo-31809: Add tests to verify connection with secp ECDH curves.

Build

  • bpo-32898: Fix the python debug build when using COUNT_ALLOCS.

Windows

  • bpo-32901: Update Tcl and Tk versions to 8.6.8

  • bpo-31966: Fixed WindowsConsoleIO.write() for writing empty data.

  • bpo-32409: Ensures activate.bat can handle Unicode contents.

  • bpo-32457: Improves handling of denormalized executable path when launching Python.

  • bpo-32370: Use the correct encoding for ipconfig output in the uuid module. Patch by Segev Finer.

  • bpo-29248: Fix os.readlink() on Windows, which was mistakenly treating the PrintNameOffset field of the reparse data buffer as a number of characters instead of bytes. Patch by Craig Holmquist and SSE4.

macOS

  • bpo-32901: Update macOS 10.9+ installer to Tcl/Tk 8.6.8.

IDLE

  • bpo-32916: Change str to code in pyparse.

  • bpo-32905: Remove unused code in pyparse module.

  • bpo-32874: Add tests for pyparse.

  • bpo-32837: Using the system and place-dependent default encoding for open() is a bad idea for IDLE’s system and location-independent files.

  • bpo-32826: Add «encoding=utf-8» to open() in IDLE’s test_help_about. GUI test test_file_buttons() only looks at initial ascii-only lines, but failed on systems where open() defaults to “ascii” because readline() internally reads and decodes far enough ahead to encounter a non-ascii character in CREDITS.txt.

  • bpo-32765: Update configdialog General tab docstring to add new widgets to the widget list.

Tools/Demos

  • bpo-32222: Fix pygettext not extracting docstrings for functions with type annotated arguments. Patch by Toby Harradine.

Python 3.7.0 beta 1

Release date: 2018-01-30

Core and Builtins

  • bpo-32703: Fix coroutine’s ResourceWarning when there’s an active error set when it’s being finalized.

  • bpo-32650: Pdb and other debuggers dependent on bdb.py will correctly step over (next command) native coroutines. Patch by Pablo Galindo.

  • bpo-28685: Optimize list.sort() and sorted() by using type specialized comparisons when possible.

  • bpo-32685: Improve suggestion when the Python 2 form of print statement is either present on the same line as the header of a compound statement or else terminated by a semi-colon instead of a newline. Patch by Nitish Chandra.

  • bpo-32697: Python now explicitly preserves the definition order of keyword-only parameters. It’s always preserved their order, but this behavior was never guaranteed before; this behavior is now guaranteed and tested.

  • bpo-32690: The locals() dictionary now displays in the lexical order that variables were defined. Previously, the order was reversed.

  • bpo-32677: Add .isascii() method to str, bytes and bytearray. It can be used to test that string contains only ASCII characters.

  • bpo-32670: Enforce PEP 479 for all code. This means that manually raising a StopIteration exception from a generator is prohibited for all code, regardless of whether “from __future__ import generator_stop” was used or not.

  • bpo-32591: Added built-in support for tracking the origin of coroutine objects; see sys.set_coroutine_origin_tracking_depth and CoroutineType.cr_origin. This replaces the asyncio debug mode’s use of coroutine wrapping for native coroutine objects.

  • bpo-31368: Expose preadv and pwritev system calls in the os module. Patch by Pablo Galindo

  • bpo-32544: hasattr(obj, name) and getattr(obj, name, default) are about 4 times faster than before when name is not found and obj doesn’t override __getattr__ or __getattribute__.

  • bpo-26163: Improved frozenset() hash to create more distinct hash values when faced with datasets containing many similar values.

  • bpo-32550: Remove the STORE_ANNOTATION bytecode.

  • bpo-20104: Expose posix_spawn as a low level API in the os module. (removed before 3.7.0rc1)

  • bpo-24340: Fixed estimation of the code stack size.

  • bpo-32436: Implement PEP 567 Context Variables.

  • bpo-18533: repr() on a dict containing its own values() or items() no longer raises RecursionError; OrderedDict similarly. Instead, use ..., as for other recursive structures. Patch by Ben North.

  • bpo-20891: Py_Initialize() now creates the GIL. The GIL is no longer created «on demand» to fix a race condition when PyGILState_Ensure() is called in a non-Python thread.

  • bpo-32028: Leading whitespace is now correctly ignored when generating suggestions for converting Py2 print statements to Py3 builtin print function calls. Patch by Sanyam Khurana.

  • bpo-31179: Make dict.copy() up to 5.5 times faster.

  • bpo-31113: Get rid of recursion in the compiler for normal control flow.

Library

  • bpo-25988: Deprecate exposing the contents of collections.abc in the regular collections module.

  • bpo-31429: The default cipher suite selection of the ssl module now uses a blacklist approach rather than a hard-coded whitelist. Python no longer re-enables ciphers that have been blocked by OpenSSL security update. Default cipher suite selection can be configured on compile time.

  • bpo-30306: contextlib.contextmanager now releases the arguments passed to the underlying generator as soon as the context manager is entered. Previously it would keep them alive for as long as the context manager was alive, even when not being used as a function decorator. Patch by Martin Teichmann.

  • bpo-21417: Added support for setting the compression level for zipfile.ZipFile.

  • bpo-32251: Implement asyncio.BufferedProtocol (provisional API).

  • bpo-32513: In dataclasses, allow easier overriding of dunder methods without specifying decorator parameters.

  • bpo-32660: termios makes available FIONREAD, FIONCLEX, FIOCLEX, FIOASYNC and FIONBIO also under Solaris/derivatives.

  • bpo-27931: Fix email address header parsing error when the username is an empty quoted string. Patch by Xiang Zhang.

  • bpo-32659: Under Solaris and derivatives, os.stat_result provides a st_fstype attribute.

  • bpo-32662: Implement Server.start_serving(), Server.serve_forever(), and Server.is_serving() methods. Add “start_serving” keyword parameter to loop.create_server() and loop.create_unix_server().

  • bpo-32391: Implement asyncio.StreamWriter.wait_closed() and asyncio.StreamWriter.is_closing() methods

  • bpo-32643: Make Task._step, Task._wakeup and Future._schedule_callbacks methods private.

  • bpo-32630: Refactor decimal module to use contextvars to store decimal context.

  • bpo-32622: Add asyncio.AbstractEventLoop.sendfile() method.

  • bpo-32304: distutils” upload command no longer corrupts tar files ending with a CR byte, and no longer tries to convert CR to CRLF in any of the upload text fields.

  • bpo-32502: uuid.uuid1 no longer raises an exception if a 64-bit hardware address is encountered.

  • bpo-32596: concurrent.futures imports ThreadPoolExecutor and ProcessPoolExecutor lazily (using PEP 562). It makes import asyncio about 15% faster because asyncio uses only ThreadPoolExecutor by default.

  • bpo-31801: Add _ignore_ to Enum so temporary variables can be used during class construction without being turned into members.

  • bpo-32576: Use queue.SimpleQueue() in places where it can be invoked from a weakref callback.

  • bpo-32574: Fix memory leak in asyncio.Queue, when the queue has limited size and it is full, the cancellation of queue.put() can cause a memory leak. Patch by: José Melero.

  • bpo-32521: The nis module is now compatible with new libnsl and headers location.

  • bpo-32467: collections.abc.ValuesView now inherits from collections.abc.Collection.

  • bpo-32473: Improve ABCMeta._dump_registry() output readability

  • bpo-32102: New argument capture_output for subprocess.run

  • bpo-32521: glibc has removed Sun RPC. Use replacement libtirpc headers and library in nis module.

  • bpo-32493: UUID module fixes build for FreeBSD/OpenBSD

  • bpo-32503: Pickling with protocol 4 no longer creates too small frames.

  • bpo-29237: Create enum for pstats sorting options

  • bpo-32454: Add close(fd) function to the socket module.

  • bpo-25942: The subprocess module is now more graceful when handling a Ctrl-C KeyboardInterrupt during subprocess.call, subprocess.run, or a Popen context manager. It now waits a short amount of time for the child (presumed to have also gotten the SIGINT) to exit, before continuing the KeyboardInterrupt exception handling. This still includes a SIGKILL in the call() and run() APIs, but at least the child had a chance first.

  • bpo-32433: The hmac module now has hmac.digest(), which provides an optimized HMAC digest.

  • bpo-28134: Sockets now auto-detect family, type and protocol from file descriptor by default.

  • bpo-32404: Fix bug where datetime.datetime.fromtimestamp() did not call __new__ in datetime.datetime subclasses.

  • bpo-32403: Improved speed of datetime.date and datetime.datetime alternate constructors.

  • bpo-32228: Ensure that truncate() preserves the file position (as reported by tell()) after writes longer than the buffer size.

  • bpo-32410: Implement loop.sock_sendfile for asyncio event loop.

  • bpo-22908: Added seek and tell to the ZipExtFile class. This only works if the file object used to open the zipfile is seekable.

  • bpo-32373: Add socket.getblocking() method.

  • bpo-32248: Add importlib.resources and importlib.abc.ResourceReader as the unified API for reading resources contained within packages. Loaders wishing to support resource reading must implement the get_resource_reader() method. File-based and zipimport-based loaders both implement these APIs. importlib.abc.ResourceLoader is deprecated in favor of these new APIs.

  • bpo-32320: collections.namedtuple() now supports default values.

  • bpo-29302: Add contextlib.AsyncExitStack. Patch by Alexander Mohr and Ilya Kulakov.

  • bpo-31961: Removed in Python 3.7.0b2. The args argument of subprocess.Popen can now be a path-like object. If args is given as a sequence, it’s first element can now be a path-like object as well.

  • bpo-31900: The locale.localeconv() function now sets temporarily the LC_CTYPE locale to the LC_NUMERIC locale to decode decimal_point and thousands_sep byte strings if they are non-ASCII or longer than 1 byte, and the LC_NUMERIC locale is different than the LC_CTYPE locale. This temporary change affects other threads. Same change for the str.format() method when formatting a number (int, float, float and subclasses) with the n type (ex: '{:n}'.format(1234)).

  • bpo-31853: Use super().method instead of socket.method in SSLSocket. They were there most likely for legacy reasons.

  • bpo-31399: The ssl module now uses OpenSSL’s X509_VERIFY_PARAM_set1_host() and X509_VERIFY_PARAM_set1_ip() API to verify hostname and IP addresses. Subject common name fallback can be disabled with SSLContext.hostname_checks_common_name.

  • bpo-14976: Add a queue.SimpleQueue class, an unbounded FIFO queue with a reentrant C implementation of put().

Documentation

  • bpo-32724: Add references to some commands in the documentation of Pdb. Patch by Stéphane Wirtel

  • bpo-32649: Complete the C API documentation, profiling and tracing part with the newly added per-opcode events.

  • bpo-17799: Explain real behaviour of sys.settrace and sys.setprofile and their C-API counterparts regarding which type of events are received in each function. Patch by Pablo Galindo Salgado.

Tests

  • bpo-32721: Fix test_hashlib to not fail if the _md5 module is not built.

  • bpo-28414: Add test cases for IDNA 2003 and 2008 host names. IDNA 2003 internationalized host names are working since bpo-31399 has landed. IDNA 2008 are still broken.

  • bpo-32604: Add a new «_xxsubinterpreters» extension module that exposes the existing subinterpreter C-API and a new cross-interpreter data sharing mechanism. The module is primarily intended for more thorough testing of the existing subinterpreter support. Note that the _xxsubinterpreters module has been removed in 3.7.0rc1.

  • bpo-32602: Add test certs and test for ECDSA cert and EC/RSA dual mode.

  • bpo-32549: On Travis CI, Python now Compiles and uses a local copy of OpenSSL 1.1.0g for testing.

Build

  • bpo-32635: Fix segfault of the crypt module when libxcrypt is provided instead of libcrypt at the system.

  • bpo-32598: Use autoconf to detect OpenSSL libs, headers and supported features. The ax_check_openssl M4 macro uses pkg-config to locate OpenSSL and falls back to manual search.

  • bpo-32593: Drop support of FreeBSD 9 and older.

  • bpo-29708: If the SOURCE_DATE_EPOCH environment variable is set, py_compile will always create hash-based .pyc files.

Windows

  • bpo-32588: Create standalone _distutils_findvs module and add missing _queue module to installer.

  • bpo-29911: Ensure separate Modify and Uninstall buttons are displayed.

  • bpo-32507: Use app-local UCRT install rather than the proper update for old versions of Windows.

macOS

  • bpo-32726: Provide an additional, more modern macOS installer variant that supports macOS 10.9+ systems in 64-bit mode only. Upgrade the supplied third-party libraries to OpenSSL 1.1.0g and to SQLite 3.22.0. The 10.9+ installer now links with and supplies its own copy of Tcl/Tk 8.6.

  • bpo-28440: No longer add /Library/Python/3.x/site-packages to sys.path for macOS framework builds to avoid future conflicts.

C API

  • bpo-32681: Fix uninitialized variable “res” in the C implementation of os.dup2. Patch by Stéphane Wirtel

  • bpo-10381: Add C API access to the datetime.timezone constructor and datetime.timezone.UTC singleton.

Python 3.7.0 alpha 4

Release date: 2018-01-08

Core and Builtins

  • bpo-31975: The default warning filter list now starts with a «default::DeprecationWarning:__main__» entry, so deprecation warnings are once again shown by default in single-file scripts and at the interactive prompt.

  • bpo-32226: __class_getitem__ is now an automatic class method.

  • bpo-32399: Add AIX uuid library support for RFC4122 using uuid_create() in libc.a

  • bpo-32390: Fix the compilation failure on AIX after the f_fsid field has been added to the object returned by os.statvfs() (bpo-32143). Original patch by Michael Felt.

  • bpo-32379: Make MRO computation faster when a class inherits from a single base.

  • bpo-32259: The error message of a TypeError raised when unpack non-iterable is now more specific.

  • bpo-27169: The __debug__ constant is now optimized out at compile time. This fixes also bpo-22091.

  • bpo-32329: The -R option now turns on hash randomization when the PYTHONHASHSEED environment variable is set to 0. Previously, the option was ignored. Moreover, sys.flags.hash_randomization is now properly set to 0 when hash randomization is turned off by PYTHONHASHSEED=0.

  • bpo-30416: The optimizer is now protected from spending much time doing complex calculations and consuming much memory for creating large constants in constant folding. Increased limits for constants that can be produced in constant folding.

  • bpo-32282: Fix an unnecessary ifdef in the include of VersionHelpers.h in socketmodule on Windows.

  • bpo-30579: Implement TracebackType.__new__ to allow Python-level creation of traceback objects, and make TracebackType.tb_next mutable.

  • bpo-32260: Don’t byte swap the input keys to the SipHash algorithm on big-endian platforms. This should ensure siphash gives consistent results across platforms.

  • bpo-31506: Improve the error message logic for object.__new__ and object.__init__. Patch by Sanyam Khurana.

  • bpo-20361: -b and -bb now inject 'default::BytesWarning' and error::BytesWarning entries into sys.warnoptions, ensuring that they take precedence over any other warning filters configured via the -W option or the PYTHONWARNINGS environment variable.

  • bpo-32230: -X dev now injects a 'default' entry into sys.warnoptions, ensuring that it behaves identically to actually passing -Wdefault at the command line.

  • bpo-29240: Add a new UTF-8 mode: implementation of the PEP 540.

  • bpo-32226: PEP 560: Add support for __mro_entries__ and __class_getitem__. Implemented by Ivan Levkivskyi.

  • bpo-32225: PEP 562: Add support for module __getattr__ and __dir__. Implemented by Ivan Levkivskyi.

  • bpo-31901: The atexit module now has its callback stored per interpreter.

  • bpo-31650: Implement PEP 552 (Deterministic pycs). Python now supports invalidating bytecode cache files bashed on a source content hash rather than source last-modified time.

  • bpo-29469: Move constant folding from bytecode layer to AST layer. Original patch by Eugene Toder.

Library

  • bpo-32506: Now that dict is defined as keeping insertion order, drop OrderedDict and just use plain dict.

  • bpo-32279: Add params to dataclasses.make_dataclasses(): init, repr, eq, order, hash, and frozen. Pass them through to dataclass().

  • bpo-32278: Make type information optional on dataclasses.make_dataclass(). If omitted, the string “typing.Any” is used.

  • bpo-32499: Add dataclasses.is_dataclass(obj), which returns True if obj is a dataclass or an instance of one.

  • bpo-32468: Improve frame repr() to mention filename, code name and current line number.

  • bpo-23749: asyncio: Implement loop.start_tls()

  • bpo-32441: Return the new file descriptor (i.e., the second argument) from os.dup2. Previously, None was always returned.

  • bpo-32422: functools.lru_cache uses less memory (3 words for each cached key) and takes about 1/3 time for cyclic GC.

  • bpo-31721: Prevent Python crash from happening when Future._log_traceback is set to True manually. Now it can only be set to False, or a ValueError is raised.

  • bpo-32415: asyncio: Add Task.get_loop() and Future.get_loop()

  • bpo-26133: Don’t unsubscribe signals in asyncio UNIX event loop on interpreter shutdown.

  • bpo-32363: Make asyncio.Task.set_exception() and set_result() raise NotImplementedError. Task._step() and Future.__await__() raise proper exceptions when they are in an invalid state, instead of raising an AssertionError.

  • bpo-32357: Optimize asyncio.iscoroutine() and loop.create_task() for non-native coroutines (e.g. async/await compiled with Cython). “loop.create_task(python_coroutine)” used to be 20% faster than “loop.create_task(cython_coroutine)”. Now, the latter is as fast.

  • bpo-32356: asyncio.transport.resume_reading() and pause_reading() are now idempotent. New transport.is_reading() method is added.

  • bpo-32355: Optimize asyncio.gather(); now up to 15% faster.

  • bpo-32351: Use fastpath in asyncio.sleep if delay<0 (2x boost)

  • bpo-32348: Optimize asyncio.Future schedule/add/remove callback. The optimization shows 3-6% performance improvements of async/await code.

  • bpo-32331: Fix socket.settimeout() and socket.setblocking() to keep socket.type as is. Fix socket.socket() constructor to reset any bit flags applied to socket’s type. This change only affects OSes that have SOCK_NONBLOCK and/or SOCK_CLOEXEC.

  • bpo-32248: Add importlib.abc.ResourceReader as an ABC for loaders to provide a unified API for reading resources contained within packages. Also add importlib.resources as the port of importlib_resources.

  • bpo-32311: Implement asyncio.create_task(coro) shortcut

  • bpo-32327: Convert asyncio functions that were documented as coroutines to coroutines. Affected functions: loop.sock_sendall, loop.sock_recv, loop.sock_accept, loop.getaddrinfo, loop.getnameinfo.

  • bpo-32323: urllib.parse.urlsplit() does not convert zone-id (scope) to lower case for scoped IPv6 addresses in hostnames now.

  • bpo-32302: Fix bdist_wininst of distutils for CRT v142: it binary compatible with CRT v140.

  • bpo-29711: Fix stop_serving in asyncio proactor loop kill all listening servers

  • bpo-32308: re.sub() now replaces empty matches adjacent to a previous non-empty match.

  • bpo-29970: Abort asyncio SSLProtocol connection if handshake not complete within 10 seconds.

  • bpo-32314: Implement asyncio.run().

  • bpo-17852: Revert incorrect fix based on misunderstanding of _Py_PyAtExit() semantics.

  • bpo-32296: Implement asyncio._get_running_loop() and get_event_loop() in C. This makes them 4x faster.

  • bpo-32250: Implement asyncio.current_task() and asyncio.all_tasks(). Add helpers intended to be used by alternative task implementations: asyncio._register_task, asyncio._enter_task, asyncio._leave_task and asyncio._unregister_task. Deprecate asyncio.Task.current_task() and asyncio.Task.all_tasks().

  • bpo-32255: A single empty field is now always quoted when written into a CSV file. This allows to distinguish an empty row from a row consisting of a single empty field. Patch by Licht Takeuchi.

  • bpo-32277: Raise NotImplementedError instead of SystemError on platforms where chmod(..., follow_symlinks=False) is not supported. Patch by Anthony Sottile.

  • bpo-30050: New argument warn_on_full_buffer to signal.set_wakeup_fd lets you control whether Python prints a warning on stderr when the wakeup fd buffer overflows.

  • bpo-29137: The fpectl library has been removed. It was never enabled by default, never worked correctly on x86-64, and it changed the Python ABI in ways that caused unexpected breakage of C extensions.

  • bpo-32273: Move asyncio.test_utils to test.test_asyncio.

  • bpo-32272: Remove asyncio.async() function.

  • bpo-32269: Add asyncio.get_running_loop() function.

  • bpo-32265: All class and static methods of builtin types now are correctly classified by inspect.classify_class_attrs() and grouped in pydoc output. Added types.ClassMethodDescriptorType for unbound class methods of builtin types.

  • bpo-32253: Deprecate yield from lock, await lock, with (yield from lock) and with await lock for asyncio synchronization primitives.

  • bpo-22589: Changed MIME type of .bmp from “image/x-ms-bmp” to “image/bmp”

  • bpo-32193: Convert asyncio to use async/await syntax. Old styled yield from is still supported too.

  • bpo-32206: Add support to run modules with pdb

  • bpo-32227: functools.singledispatch now supports registering implementations using type annotations.

  • bpo-15873: Added new alternate constructors datetime.datetime.fromisoformat(), datetime.time.fromisoformat() and datetime.date.fromisoformat() as the inverse operation of each classes’s respective isoformat methods.

  • bpo-32199: The getnode() ip getter now uses “ip link” instead of “ip link list”.

  • bpo-32143: os.statvfs() includes the f_fsid field from statvfs(2)

  • bpo-26439: Fix ctypes.util.find_library() for AIX by implementing ctypes._aix.find_library() Patch by: Michael Felt

  • bpo-31993: The pickler now uses less memory when serializing large bytes and str objects into a file. Pickles created with protocol 4 will require less memory for unpickling large bytes and str objects.

  • bpo-27456: Ensure TCP_NODELAY is set on Linux. Tests by Victor Stinner.

  • bpo-31778: ast.literal_eval() is now more strict. Addition and subtraction of arbitrary numbers no longer allowed.

  • bpo-31802: Importing native path module (posixpath, ntpath) now works even if the os module still is not imported.

  • bpo-30241: Add contextlib.AbstractAsyncContextManager. Patch by Jelle Zijlstra.

  • bpo-31699: Fix deadlocks in concurrent.futures.ProcessPoolExecutor when task arguments or results cause pickling or unpickling errors. This should make sure that calls to the ProcessPoolExecutor API always eventually return.

  • bpo-15216: TextIOWrapper.reconfigure() supports changing encoding, errors, and newline.

Documentation

  • bpo-32418: Add get_loop() method to Server and AbstractServer classes.

Tests

  • bpo-32252: Fix faulthandler_suppress_crash_report() used to prevent core dump files when testing crashes. getrlimit() returns zero on success.

  • bpo-32002: Adjust C locale coercion testing for the empty locale and POSIX locale cases to more readily adjust to platform dependent behaviour.

Windows

  • bpo-19764: Implement support for subprocess.Popen(close_fds=True) on Windows. Patch by Segev Finer.

Tools/Demos

  • bpo-24960: 2to3 and lib2to3 can now read pickled grammar files using pkgutil.get_data() rather than probing the filesystem. This lets 2to3 and lib2to3 work when run from a zipfile.

C API

  • bpo-32030: Py_Initialize() doesn’t reset the memory allocators to default if the PYTHONMALLOC environment variable is not set.

  • bpo-29084: Undocumented C API for OrderedDict has been excluded from the limited C API. It was added by mistake and actually never worked in the limited C API.

  • bpo-32264: Moved the pygetopt.h header into internal/, since it has no public APIs.

  • bpo-32241: Py_SetProgramName() and Py_SetPythonHome() now take the const wchar * arguments instead of wchar *.

Python 3.7.0 alpha 3

Release date: 2017-12-05

Core and Builtins

  • bpo-32176: co_flags.CO_NOFREE is now always set correctly by the code object constructor based on freevars and cellvars, rather than needing to be set correctly by the caller. This ensures it will be cleared automatically when additional cell references are injected into a modified code object and function.

  • bpo-10544: Yield expressions are now deprecated in comprehensions and generator expressions. They are still permitted in the definition of the outermost iterable, as that is evaluated directly in the enclosing scope.

  • bpo-32137: The repr of deeply nested dict now raises a RecursionError instead of crashing due to a stack overflow.

  • bpo-32096: Revert memory allocator changes in the C API: move structures back from _PyRuntime to Objects/obmalloc.c. The memory allocators are once again initialized statically, and so PyMem_RawMalloc() and Py_DecodeLocale() can be called before _PyRuntime_Initialize().

  • bpo-32043: Add a new «developer mode»: new «-X dev» command line option to enable debug checks at runtime.

  • bpo-32023: SyntaxError is now correctly raised when a generator expression without parenthesis is used instead of an inheritance list in a class definition. The duplication of the parentheses can be omitted only on calls.

  • bpo-32012: SyntaxError is now correctly raised when a generator expression without parenthesis is passed as an argument, but followed by a trailing comma. A generator expression always needs to be directly inside a set of parentheses and cannot have a comma on either side.

  • bpo-28180: A new internal _Py_SetLocaleFromEnv(category) helper function has been added in order to improve the consistency of behaviour across different libc implementations (e.g. Android doesn’t support setting the locale from the environment by default).

  • bpo-31949: Fixed several issues in printing tracebacks (PyTraceBack_Print()). Setting sys.tracebacklimit to 0 or less now suppresses printing tracebacks. Setting sys.tracebacklimit to None now causes using the default limit. Setting sys.tracebacklimit to an integer larger than LONG_MAX now means using the limit LONG_MAX rather than the default limit. Fixed integer overflows in the case of more than 2**31 traceback items on Windows. Fixed output errors handling.

  • bpo-30696: Fix the interactive interpreter looping endlessly when no memory.

  • bpo-20047: Bytearray methods partition() and rpartition() now accept only bytes-like objects as separator, as documented. In particular they now raise TypeError rather of returning a bogus result when an integer is passed as a separator.

  • bpo-21720: BytesWarning no longer emitted when the fromlist argument of __import__() or the __all__ attribute of the module contain bytes instances.

  • bpo-31845: Environment variables are once more read correctly at interpreter startup.

  • bpo-28936: Ensure that lexically first syntax error involving a parameter and global or nonlocal is detected first at a given scope. Patch by Ivan Levkivskyi.

  • bpo-31825: Fixed OverflowError in the “unicode-escape” codec and in codecs.escape_decode() when decode an escaped non-ascii byte.

  • bpo-31618: The per-frame tracing logic added in 3.7a1 has been altered so that frame->f_lineno is updated before either "line" or "opcode" events are emitted. Previously, opcode events were emitted first, and therefore would occasionally see stale line numbers on the frame. The behavior of this feature has changed slightly as a result: when both f_trace_lines and f_trace_opcodes are enabled, line events now occur first.

  • bpo-28603: Print the full context/cause chain of exceptions on interpreter exit, even if an exception in the chain is unhashable or compares equal to later ones. Patch by Zane Bitter.

  • bpo-31786: Fix timeout rounding in the select module to round correctly negative timeouts between -1.0 and 0.0. The functions now block waiting for events as expected. Previously, the call was incorrectly non-blocking. Patch by Pablo Galindo.

  • bpo-31781: Prevent crashes when calling methods of an uninitialized zipimport.zipimporter object. Patch by Oren Milman.

  • bpo-30399: Standard repr() of BaseException with a single argument no longer contains redundant trailing comma.

  • bpo-31626: Fixed a bug in debug memory allocator. There was a write to freed memory after shrinking a memory block.

  • bpo-30817: PyErr_PrintEx() clears now the ignored exception that may be raised by _PySys_SetObjectId(), for example when no memory.

Library

  • bpo-28556: Two minor fixes for typing module: allow shallow copying instances of generic classes, improve interaction of __init_subclass__ with generics. Original PRs by Ivan Levkivskyi.

  • bpo-32214: PEP 557, Data Classes. Provides a decorator which adds boilerplate methods to classes which use type annotations so specify fields.

  • bpo-27240: The header folding algorithm for the new email policies has been rewritten, which also fixes bpo-30788, bpo-31831, and bpo-32182. In particular, RFC2231 folding is now done correctly.

  • bpo-32186: io.FileIO.readall() and io.FileIO.read() now release the GIL when getting the file size. Fixed hang of all threads with inaccessible NFS server. Patch by Nir Soffer.

  • bpo-32101: Add sys.flags.dev_mode flag

  • bpo-32154: The asyncio.windows_utils.socketpair() function has been removed: use directly socket.socketpair() which is available on all platforms since Python 3.5 (before, it wasn’t available on Windows). asyncio.windows_utils.socketpair() was just an alias to socket.socketpair on Python 3.5 and newer.

  • bpo-32089: warnings: In development (-X dev) and debug mode (pydebug build), use the «default» action for ResourceWarning, rather than the «always» action, in the default warnings filters.

  • bpo-32107: uuid.getnode() now preferentially returns universally administered MAC addresses if available, over locally administered MAC addresses. This makes a better guarantee for global uniqueness of UUIDs returned from uuid.uuid1(). If only locally administered MAC addresses are available, the first such one found is returned.

  • bpo-23033: Wildcard is now supported in hostname when it is one and only character in the left most segment of hostname in second argument of ssl.match_hostname(). Patch by Mandeep Singh.

  • bpo-12239: Make msilib.SummaryInformation.GetProperty() return None when the value of property is VT_EMPTY. Initial patch by Mark Mc Mahon.

  • bpo-28334: Use os.path.expanduser() to find the ~/.netrc file in netrc.netrc. If it does not exist, FileNotFoundError is raised. Patch by Dimitri Merejkowsky.

  • bpo-32121: Made tracemalloc.Traceback behave more like the traceback module, sorting the frames from oldest to most recent. Traceback.format() now accepts negative limit, truncating the result to the abs(limit) oldest frames. To get the old behaviour, one can use the new most_recent_first argument to Traceback.format(). (Patch by Jesse Bakker.)

  • bpo-31325: Fix wrong usage of collections.namedtuple() in the RobotFileParser.parse() method. Initial patch by Robin Wellner.

  • bpo-12382: msilib.OpenDatabase() now raises a better exception message when it couldn’t open or create an MSI file. Initial patch by William Tisäter.

  • bpo-19610: setup() now warns about invalid types for some fields. The distutils.dist.Distribution class now warns when classifiers, keywords and platforms fields are not specified as a list or a string.

  • bpo-32071: Added the -k command-line option to python -m unittest to run only tests that match the given pattern(s).

  • bpo-10049: Added nullcontext no-op context manager to contextlib. This provides a simpler and faster alternative to ExitStack() when handling optional context managers.

  • bpo-28684: The new test.support.skip_unless_bind_unix_socket() decorator is used here to skip asyncio tests that fail because the platform lacks a functional bind() function for unix domain sockets (as it is the case for non root users on the recent Android versions that run now SELinux in enforcing mode).

  • bpo-32110: codecs.StreamReader.read(n) now returns not more than n characters/bytes for non-negative n. This makes it compatible with read() methods of other file-like objects.

  • bpo-27535: The warnings module doesn’t leak memory anymore in the hidden warnings registry for the «ignore» action of warnings filters. warn_explicit() function doesn’t add the warning key to the registry anymore for the «ignore» action.

  • bpo-32088: warnings: When Python is build is debug mode (Py_DEBUG), DeprecationWarning, PendingDeprecationWarning and ImportWarning warnings are now displayed by default.

  • bpo-1647489: Fixed searching regular expression patterns that could match an empty string. Non-empty string can now be correctly found after matching an empty string.

  • bpo-25054: Added support of splitting on a pattern that could match an empty string.

  • bpo-32072: Fixed issues with binary plists: Fixed saving bytearrays. Identical objects will be saved only once. Equal references will be load as identical objects. Added support for saving and loading recursive data structures.

  • bpo-32069: Drop legacy SSL transport from asyncio, ssl.MemoryBIO is always used anyway.

  • bpo-32066: asyncio: Support pathlib.Path in create_unix_connection; sock arg should be optional

  • bpo-32046: Updates 2to3 to convert from operator.isCallable(obj) to callable(obj). Patch by Donghee Na.

  • bpo-32018: inspect.signature should follow PEP 8, if the parameter has an annotation and a default value. Patch by Donghee Na.

  • bpo-32025: Add time.thread_time() and time.thread_time_ns()

  • bpo-32037: Integers that fit in a signed 32-bit integer will be now pickled with protocol 0 using the INT opcode. This will decrease the size of a pickle, speed up pickling and unpickling, and make these integers be unpickled as int instances in Python 2.

  • bpo-32034: Make asyncio.IncompleteReadError and LimitOverrunError pickleable.

  • bpo-32015: Fixed the looping of asyncio in the case of reconnection the socket during waiting async read/write from/to the socket.

  • bpo-32011: Restored support of loading marshal files with the TYPE_INT64 code. These files can be produced in Python 2.7.

  • bpo-28369: Enhance add_reader/writer check that socket is not used by some transport. Before, only cases when add_reader/writer were called with an int FD were supported. Now the check is implemented correctly for all file-like objects.

  • bpo-31976: Fix race condition when flushing a file is slow, which can cause a segfault if closing the file from another thread.

  • bpo-31985: Formally deprecated aifc.openfp, sunau.openfp, and wave.openfp. Since change 7bc817d5ba917528e8bd07ec461c635291e7b06a in 1993, openfp in each of the three modules had been pointing to that module’s open function as a matter of backwards compatibility, though it had been both untested and undocumented.

  • bpo-21862: cProfile command line now accepts -m module_name as an alternative to script path. Patch by Sanyam Khurana.

  • bpo-31970: Reduce performance overhead of asyncio debug mode.

  • bpo-31843: database argument of sqlite3.connect() now accepts a path-like object, instead of just a string.

  • bpo-31945: Add Configurable blocksize to HTTPConnection and HTTPSConnection for improved upload throughput. Patch by Nir Soffer.

  • bpo-31943: Add a cancelled() method to asyncio.Handle. Patch by Marat Sharafutdinov.

  • bpo-9678: Fixed determining the MAC address in the uuid module: Using ifconfig on NetBSD and OpenBSD. Using arp on Linux, FreeBSD, NetBSD and OpenBSD. Based on patch by Takayuki Shimizukawa.

  • bpo-30057: Fix potential missed signal in signal.signal().

  • bpo-31933: Fix Blake2 params leaf_size and node_offset on big endian platforms. Patch by Jack O’Connor.

  • bpo-21423: Add an initializer argument to {Process,Thread}PoolExecutor

  • bpo-31927: Fixed compilation of the socket module on NetBSD 8. Fixed assertion failure or reading arbitrary data when parse a AF_BLUETOOTH address on NetBSD and DragonFly BSD.

  • bpo-27666: Fixed stack corruption in curses.box() and curses.ungetmouse() when the size of types chtype or mmask_t is less than the size of C long. curses.box() now accepts characters as arguments. Based on patch by Steve Fink.

  • bpo-31917: Add 3 new clock identifiers: time.CLOCK_BOOTTIME, time.CLOCK_PROF and time.CLOCK_UPTIME.

  • bpo-31897: plistlib now catches more errors when read binary plists and raises InvalidFileException instead of unexpected exceptions.

  • bpo-25720: Fix the method for checking pad state of curses WINDOW. Patch by Masayuki Yamamoto.

  • bpo-31893: Fixed the layout of the kqueue_event structure on OpenBSD and NetBSD. Fixed the comparison of the kqueue_event objects.

  • bpo-31891: Fixed building the curses module on NetBSD.

  • bpo-31884: added required constants to subprocess module for setting priority on windows

  • bpo-28281: Remove year (1-9999) limits on the Calendar.weekday() function. Patch by Mark Gollahon.

  • bpo-31702: crypt.mksalt() now allows to specify the number of rounds for SHA-256 and SHA-512 hashing.

  • bpo-30639: inspect.getfile() no longer computes the repr of unknown objects to display in an error message, to protect against badly behaved custom reprs.

  • bpo-30768: Fix the pthread+semaphore implementation of PyThread_acquire_lock_timed() when called with timeout > 0 and intr_flag=0: recompute the timeout if sem_timedwait() is interrupted by a signal (EINTR). See also the PEP 475.

  • bpo-31854: Add mmap.ACCESS_DEFAULT constant.

  • bpo-31834: Use optimized code for BLAKE2 only with SSSE3+. The pure SSE2 implementation is slower than the pure C reference implementation.

  • bpo-28292: Calendar.itermonthdates() will now consistently raise an exception when a date falls outside of the 0001-01-01 through 9999-12-31 range. To support applications that cannot tolerate such exceptions, the new methods itermonthdays3() and itermonthdays4() are added. The new methods return tuples and are not restricted by the range supported by datetime.date.

  • bpo-28564: The shutil.rmtree() function has been sped up to 20–40%. This was done using the os.scandir() function.

  • bpo-28416: Instances of pickle.Pickler subclass with the persistent_id() method and pickle.Unpickler subclass with the persistent_load() method no longer create reference cycles.

  • bpo-31653: Don’t release the GIL if we can acquire a multiprocessing semaphore immediately.

  • bpo-28326: Fix multiprocessing.Process when stdout and/or stderr is closed or None.

  • bpo-20825: Add subnet_of and superset_of containment tests to ipaddress.IPv6Network and ipaddress.IPv4Network. Patch by Michel Albert and Cheryl Sabella.

  • bpo-31827: Remove the os.stat_float_times() function. It was introduced in Python 2.3 for backward compatibility with Python 2.2, and was deprecated since Python 3.1.

  • bpo-31756: Add a subprocess.Popen(text=False) keyword argument to subprocess functions to be more explicit about when the library should attempt to decode outputs into text. Patch by Andrew Clegg.

  • bpo-31819: Add AbstractEventLoop.sock_recv_into().

  • bpo-31457: If nested log adapters are used, the inner process() methods are no longer omitted.

  • bpo-31457: The manager property on LoggerAdapter objects is now properly settable.

  • bpo-31806: Fix timeout rounding in time.sleep(), threading.Lock.acquire() and socket.socket.settimeout() to round correctly negative timeouts between -1.0 and 0.0. The functions now block waiting for events as expected. Previously, the call was incorrectly non-blocking. Patch by Pablo Galindo.

  • bpo-31803: time.clock() and time.get_clock_info(“clock”) now emit a DeprecationWarning warning.

  • bpo-31800: Extended support for parsing UTC offsets. strptime “%z” can now parse the output generated by datetime.isoformat, including seconds and microseconds.

  • bpo-28603: traceback: Fix a TypeError that occurred during printing of exception tracebacks when either the current exception or an exception in its context/cause chain is unhashable. Patch by Zane Bitter.

  • bpo-30541: Add new function to seal a mock and prevent the automatically creation of child mocks. Patch by Mario Corchero.

  • bpo-31784: Implement the PEP 564, add new 6 new functions with nanosecond resolution to the time module: clock_gettime_ns(), clock_settime_ns(), monotonic_ns(), perf_counter_ns(), process_time_ns(), time_ns().

  • bpo-30143: 2to3 now generates a code that uses abstract collection classes from collections.abc rather than collections.

  • bpo-31770: Prevent a crash when calling the __init__() method of a sqlite3.Cursor object more than once. Patch by Oren Milman.

  • bpo-31764: Prevent a crash in sqlite3.Cursor.close() in case the Cursor object is uninitialized. Patch by Oren Milman.

  • bpo-31752: Fix possible crash in timedelta constructor called with custom integers.

  • bpo-31620: an empty asyncio.Queue now doesn’t leak memory when queue.get pollers timeout

  • bpo-31690: Allow the flags re.ASCII, re.LOCALE, and re.UNICODE to be used as group flags for regular expressions.

  • bpo-30349: FutureWarning is now emitted if a regular expression contains character set constructs that will change semantically in the future (nested sets and set operations).

  • bpo-31664: Added support for the Blowfish hashing in the crypt module.

  • bpo-31632: Fix method set_protocol() of class _SSLProtocolTransport in asyncio module. This method was previously modifying a wrong reference to the protocol.

  • bpo-15037: Added a workaround for getkey() in curses for ncurses 5.7 and earlier.

  • bpo-31307: Allow use of bytes objects for arguments to configparser.ConfigParser.read(). Patch by Vincent Michel.

  • bpo-31334: Fix poll.poll([timeout]) in the select module for arbitrary negative timeouts on all OSes where it can only be a non-negative integer or -1. Patch by Riccardo Coccioli.

  • bpo-31310: multiprocessing’s semaphore tracker should be launched again if crashed.

  • bpo-31308: Make multiprocessing’s forkserver process immune to Ctrl-C and other user interruptions. If it crashes, restart it when necessary.

  • bpo-31245: Added support for AF_UNIX socket in asyncio create_datagram_endpoint.

  • bpo-30553: Add HTTP/2 status code 421 (Misdirected Request) to http.HTTPStatus. Patch by Vitor Pereira.

Documentation

  • bpo-32105: Added asyncio.BaseEventLoop.connect_accepted_socket versionadded marker.

Tests

  • bpo-31380: Skip test_httpservers test_undecodable_file on macOS: fails on APFS.

  • bpo-31705: Skip test_socket.test_sha256() on Linux kernel older than 4.5. The test fails with ENOKEY on kernel 3.10 (on ppc64le). A fix was merged into the kernel 4.5.

  • bpo-32138: Skip on Android test_faulthandler tests that raise SIGSEGV and remove the test.support.requires_android_level decorator.

  • bpo-32136: The runtime embedding tests have been split out from Lib/test/test_capi.py into a new Lib/test/test_embed.py file.

  • bpo-28668: test.support.requires_multiprocessing_queue is removed. Skip tests with test.support.import_module(“multiprocessing.synchronize”) instead when the semaphore implementation is broken or missing.

  • bpo-32126: Skip test_get_event_loop_new_process in test.test_asyncio.test_events when sem_open() is not functional.

  • bpo-31174: Fix test_tools.test_unparse: DirectoryTestCase now stores the names sample to always test the same files. It prevents false alarms when hunting reference leaks.

Build

  • bpo-28538: Revert the previous changes, the if_nameindex structure is defined by Unified Headers.

  • bpo-28762: Revert the last commit, the F_LOCK macro is defined by Android Unified Headers.

  • bpo-29040: Support building Android with Unified Headers. The first NDK release to support Unified Headers is android-ndk-r14.

  • bpo-32059: detect_modules() in setup.py now also searches the sysroot paths when cross-compiling.

  • bpo-31957: Fixes Windows SDK version detection when building for Windows.

  • bpo-31609: Fixes quotes in PCbuild/clean.bat

  • bpo-31934: Abort the build when building out of a not clean source tree.

  • bpo-31926: Fixed Argument Clinic sometimes causing compilation errors when there was more than one function and/or method in a .c file with the same name.

  • bpo-28791: Update Windows builds to use SQLite 3.21.0.

  • bpo-28791: Update OS X installer to use SQLite 3.21.0.

  • bpo-28643: Record profile-opt build progress with stamp files.

  • bpo-31866: Finish removing support for AtheOS.

Windows

  • bpo-1102: Return None when View.Fetch() returns ERROR_NO_MORE_ITEMS instead of raising MSIError. Initial patch by Anthony Tuininga.

  • bpo-31944: Fixes Modify button in Apps and Features dialog.

  • bpo-20486: Implement the Database.Close() method to help closing MSI database objects.

  • bpo-31857: Make the behavior of USE_STACKCHECK deterministic in a multi-threaded environment.

macOS

  • bpo-31392: Update macOS installer to use OpenSSL 1.0.2m

IDLE

  • bpo-32207: Improve tk event exception tracebacks in IDLE. When tk event handling is driven by IDLE’s run loop, a confusing and distracting queue.EMPTY traceback context is no longer added to tk event exception tracebacks. The traceback is now the same as when event handling is driven by user code. Patch based on a suggestion by Serhiy Storchaka.

  • bpo-32164: Delete unused file idlelib/tabbedpages.py. Use of TabbedPageSet in configdialog was replaced by ttk.Notebook.

  • bpo-32100: IDLE: Fix old and new bugs in pathbrowser; improve tests. Patch mostly by Cheryl Sabella.

  • bpo-31858: IDLE – Restrict shell prompt manipulation to the shell. Editor and output windows only see an empty last prompt line. This simplifies the code and fixes a minor bug when newline is inserted. Sys.ps1, if present, is read on Shell start-up, but is not set or changed.

  • bpo-31860: The font sample in the IDLE configuration dialog is now editable. Changes persist while IDLE remains open

  • bpo-31836: Test_code_module now passes if run after test_idle, which sets ps1. The code module uses sys.ps1 if present or sets it to “>>> “ if not. Test_code_module now properly tests both behaviors. Ditto for ps2.

  • bpo-28603: Fix a TypeError that caused a shell restart when printing a traceback that includes an exception that is unhashable. Patch by Zane Bitter.

  • bpo-13802: Use non-Latin characters in the IDLE’s Font settings sample. Even if one selects a font that defines a limited subset of the unicode Basic Multilingual Plane, tcl/tk will use other fonts that define a character. The expanded example give users of non-Latin characters a better idea of what they might see in IDLE’s shell and editors. To make room for the expanded sample, frames on the Font tab are re-arranged. The Font/Tabs help explains a bit about the additions.

Tools/Demos

  • bpo-32159: Remove CVS and Subversion tools: remove svneol.py and treesync.py scripts. CPython migrated from CVS to Subversion, to Mercurial, and then to Git. CVS and Subversion are no longer used to develop CPython.

  • bpo-30722: Make redemo work with Python 3.6 and newer versions. Also, remove the LOCALE option since it doesn’t work with string patterns in Python 3. Patch by Christoph Sarnowski.

C API

  • bpo-20891: Fix PyGILState_Ensure(). When PyGILState_Ensure() is called in a non-Python thread before PyEval_InitThreads(), only call PyEval_InitThreads() after calling PyThreadState_New() to fix a crash.

  • bpo-32125: The Py_UseClassExceptionsFlag flag has been removed. It was deprecated and wasn’t used anymore since Python 2.0.

  • bpo-25612: Move the current exception state from the frame object to the co-routine. This simplifies the interpreter and fixes a couple of obscure bugs caused by having swap exception state when entering or exiting a generator.

  • bpo-23699: Add Py_RETURN_RICHCOMPARE macro to reduce boilerplate code in rich comparison functions.

  • bpo-30697: The PyExc_RecursionErrorInst singleton is removed and PyErr_NormalizeException() does not use it anymore. This singleton is persistent and its members being never cleared may cause a segfault during finalization of the interpreter. See also bpo-22898.

Python 3.7.0 alpha 2

Release date: 2017-10-16

Core and Builtins

  • bpo-31558: gc.freeze() is a new API that allows for moving all objects currently tracked by the garbage collector to a permanent generation, effectively removing them from future collection events. This can be used to protect those objects from having their PyGC_Head mutated. In effect, this enables great copy-on-write stability at fork().

  • bpo-31642: Restored blocking «from package import module» by setting sys.modules[«package.module»] to None.

  • bpo-31708: Allow use of asynchronous generator expressions in synchronous functions.

  • bpo-31709: Drop support of asynchronous __aiter__.

  • bpo-30404: The -u option now makes the stdout and stderr streams unbuffered rather than line-buffered.

  • bpo-31619: Fixed a ValueError when convert a string with large number of underscores to integer with binary base.

  • bpo-31602: Fix an assertion failure in zipimporter.get_source() in case of a bad zlib.decompress(). Patch by Oren Milman.

  • bpo-31592: Fixed an assertion failure in Python parser in case of a bad unicodedata.normalize(). Patch by Oren Milman.

  • bpo-31588: Raise a TypeError with a helpful error message when class creation fails due to a metaclass with a bad __prepare__() method. Patch by Oren Milman.

  • bpo-31574: Importlib was instrumented with two dtrace probes to profile import timing.

  • bpo-31566: Fix an assertion failure in _warnings.warn() in case of a bad __name__ global. Patch by Oren Milman.

  • bpo-31506: Improved the error message logic for object.__new__ and object.__init__.

  • bpo-31505: Fix an assertion failure in json, in case _json.make_encoder() received a bad encoder() argument. Patch by Oren Milman.

  • bpo-31492: Fix assertion failures in case of failing to import from a module with a bad __name__ attribute, and in case of failing to access an attribute of such a module. Patch by Oren Milman.

  • bpo-31478: Fix an assertion failure in _random.Random.seed() in case the argument has a bad __abs__() method. Patch by Oren Milman.

  • bpo-31336: Speed up class creation by 10-20% by reducing the overhead in the necessary special method lookups. Patch by Stefan Behnel.

  • bpo-31415: Add -X importtime option to show how long each import takes. It can be used to optimize application’s startup time. Support the PYTHONPROFILEIMPORTTIME as an equivalent way to enable this.

  • bpo-31410: Optimized calling wrapper and classmethod descriptors.

  • bpo-31353: PEP 553 - Add a new built-in called breakpoint() which calls sys.breakpointhook(). By default this imports pdb and calls pdb.set_trace(), but users may override sys.breakpointhook() to call whatever debugger they want. The original value of the hook is saved in sys.__breakpointhook__.

  • bpo-17852: Maintain a list of open buffered files, flush them before exiting the interpreter. Based on a patch from Armin Rigo.

  • bpo-31315: Fix an assertion failure in imp.create_dynamic(), when spec.name is not a string. Patch by Oren Milman.

  • bpo-31311: Fix a crash in the __setstate__() method of ctypes._CData, in case of a bad __dict__. Patch by Oren Milman.

  • bpo-31293: Fix crashes in true division and multiplication of a timedelta object by a float with a bad as_integer_ratio() method. Patch by Oren Milman.

  • bpo-31285: Fix an assertion failure in warnings.warn_explicit, when the return value of the received loader’s get_source() has a bad splitlines() method. Patch by Oren Milman.

  • bpo-30406: Make async and await proper keywords, as specified in PEP 492.

Library

  • bpo-30058: Fixed buffer overflow in select.kqueue.control().

  • bpo-31672: idpattern in string.Template matched some non-ASCII characters. Now it uses -i regular expression local flag to avoid non-ASCII characters.

  • bpo-31701: On Windows, faulthandler.enable() now ignores MSC and COM exceptions.

  • bpo-31728: Prevent crashes in _elementtree due to unsafe cleanup of Element.text and Element.tail. Patch by Oren Milman.

  • bpo-31671: Now re.compile() converts passed RegexFlag to normal int object before compiling. bm_regex_compile benchmark shows 14% performance improvements.

  • bpo-30397: The types of compiled regular objects and match objects are now exposed as re.Pattern and re.Match. This adds information in pydoc output for the re module.

  • bpo-31675: Fixed memory leaks in Tkinter’s methods splitlist() and split() when pass a string larger than 2 GiB.

  • bpo-31673: Fixed typo in the name of Tkinter’s method adderrorinfo().

  • bpo-31648: Improvements to path predicates in ElementTree: Allow whitespace around predicate parts, i.e. «[a = “text”]» instead of requiring the less readable «[a=”text”]». Add support for text comparison of the current node, like «[.=”text”]». Patch by Stefan Behnel.

  • bpo-30806: Fix the string representation of a netrc object.

  • bpo-31638: Add optional argument compressed to zipapp.create_archive, and add option --compress to the command line interface of zipapp.

  • bpo-25351: Avoid venv activate failures with undefined variables

  • bpo-20519: Avoid ctypes use (if possible) and improve import time for uuid.

  • bpo-28293: The regular expression cache is no longer completely dumped when it is full.

  • bpo-31596: Added pthread_getcpuclockid() to the time module

  • bpo-27494: Make 2to3 accept a trailing comma in generator expressions. For example, set(x for x in [],) is now allowed.

  • bpo-30347: Stop crashes when concurrently iterate over itertools.groupby() iterators.

  • bpo-30346: An iterator produced by itertools.groupby() iterator now becomes exhausted after advancing the groupby iterator.

  • bpo-31556: Cancel asyncio.wait_for future faster if timeout <= 0

  • bpo-31540: Allow passing a context object in concurrent.futures.ProcessPoolExecutor constructor. Also, free job resources in concurrent.futures.ProcessPoolExecutor earlier to improve memory usage when a worker waits for new jobs.

  • bpo-31516: threading.current_thread() should not return a dummy thread at shutdown.

  • bpo-31525: In the sqlite module, require the sqlite3_prepare_v2 API. Thus, the sqlite module now requires sqlite version at least 3.3.9.

  • bpo-26510: argparse subparsers are now required by default. This matches behaviour in Python 2. For optional subparsers, use the new parameter add_subparsers(required=False). Patch by Anthony Sottile. (As of 3.7.0rc1, the default was changed to not required as had been the case since Python 3.3.)

  • bpo-27541: Reprs of subclasses of some collection and iterator classes (bytearray, array.array, collections.deque, collections.defaultdict, itertools.count, itertools.repeat) now contain actual type name instead of hardcoded names of the base class.

  • bpo-31351: python -m ensurepip now exits with non-zero exit code if pip bootstrapping has failed.

  • bpo-31389: pdb.set_trace() now takes an optional keyword-only argument header. If given, this is printed to the console just before debugging begins.

Documentation

  • bpo-31537: Fix incorrect usage of get_history_length in readline documentation example code. Patch by Brad Smith.

  • bpo-30085: The operator functions without double underscores are preferred for clarity. The one with underscores are only kept for back-compatibility.

Build

  • bpo-31696: Improve compiler version information in sys.version when Python is built with Clang.

  • bpo-31625: Stop using ranlib on static libraries. Instead, we assume ar supports the “s” flag.

  • bpo-31624: Remove support for BSD/OS.

  • bpo-22140: Prevent double substitution of prefix in python-config.sh.

  • bpo-31569: Correct PCBuild/ case to PCbuild/ in build scripts and documentation.

  • bpo-31536: Avoid wholesale rebuild after make regen-all if nothing changed.

IDLE

  • bpo-31460: Simplify the API of IDLE’s Module Browser. Passing a widget instead of an flist with a root widget opens the option of creating a browser frame that is only part of a window. Passing a full file name instead of pieces assumed to come from a .py file opens the possibility of browsing python files that do not end in .py.

  • bpo-31649: IDLE - Make _htest, _utest parameters keyword only.

  • bpo-31559: Remove test order dependence in idle_test.test_browser.

  • bpo-31459: Rename IDLE’s module browser from Class Browser to Module Browser. The original module-level class and method browser became a module browser, with the addition of module-level functions, years ago. Nested classes and functions were added yesterday. For back-compatibility, the virtual event <<open-class-browser>>, which appears on the Keys tab of the Settings dialog, is not changed. Patch by Cheryl Sabella.

  • bpo-31500: Default fonts now are scaled on HiDPI displays.

  • bpo-1612262: IDLE module browser now shows nested classes and functions. Original patches for code and tests by Guilherme Polo and Cheryl Sabella, respectively.

C API

  • bpo-28280: Make PyMapping_Keys(), PyMapping_Values() and PyMapping_Items() always return a list (rather than a list or a tuple). Patch by Oren Milman.

  • bpo-31532: Fix memory corruption due to allocator mix in getpath.c between Py_GetPath() and Py_SetPath()

  • bpo-25658: Implement PEP 539 for Thread Specific Storage (TSS) API: it is a new Thread Local Storage (TLS) API to CPython which would supersede use of the existing TLS API within the CPython interpreter, while deprecating the existing API. PEP written by Erik M. Bray, patch by Masayuki Yamamoto.

Python 3.7.0 alpha 1

Release date: 2017-09-19

Security

  • bpo-29781: SSLObject.version() now correctly returns None when handshake over BIO has not been performed yet.

  • bpo-29505: Add fuzz tests for float(str), int(str), unicode(str); for oss-fuzz.

  • bpo-30947: Upgrade libexpat embedded copy from version 2.2.1 to 2.2.3 to get security fixes.

  • bpo-30730: Prevent environment variables injection in subprocess on Windows. Prevent passing other environment variables and command arguments.

  • bpo-30694: Upgrade expat copy from 2.2.0 to 2.2.1 to get fixes of multiple security vulnerabilities including: CVE 2017-9233 (External entity infinite loop DoS), CVE 2016-9063 (Integer overflow, re-fix), CVE 2016-0718 (Fix regression bugs from 2.2.0’s fix to CVE 2016-0718) and CVE 2012-0876 (Counter hash flooding with SipHash). Note: the CVE 2016-5300 (Use os-specific entropy sources like getrandom) doesn’t impact Python, since Python already gets entropy from the OS to set the expat secret using XML_SetHashSalt().

  • bpo-30500: Fix urllib.parse.splithost() to correctly parse fragments. For example, splithost('//127.0.0.1#@evil.com/') now correctly returns the 127.0.0.1 host, instead of treating @evil.com as the host in an authentication (login@host).

  • bpo-29591: Update expat copy from 2.1.1 to 2.2.0 to get fixes of CVE 2016-0718 and CVE 2016-4472. See https://sourceforge.net/p/expat/bugs/537/ for more information.

Core and Builtins

  • bpo-31490: Fix an assertion failure in ctypes class definition, in case the class has an attribute whose name is specified in _anonymous_ but not in _fields_. Patch by Oren Milman.

  • bpo-31471: Fix an assertion failure in subprocess.Popen() on Windows, in case the env argument has a bad keys() method. Patch by Oren Milman.

  • bpo-31418: Fix an assertion failure in PyErr_WriteUnraisable() in case of an exception with a bad __module__ attribute. Patch by Oren Milman.

  • bpo-31416: Fix assertion failures in case of a bad warnings.filters or warnings.defaultaction. Patch by Oren Milman.

  • bpo-28411: Change direct usage of PyInterpreterState.modules to PyImport_GetModuleDict(). Also introduce more uniformity in other code that deals with sys.modules. This helps reduce complications when working on sys.modules.

  • bpo-28411: Switch to the abstract API when dealing with PyInterpreterState.modules. This allows later support for all dict subclasses and other Mapping implementations. Also add a PyImport_GetModule() function to reduce a bunch of duplicated code.

  • bpo-31411: Raise a TypeError instead of SystemError in case warnings.onceregistry is not a dictionary. Patch by Oren Milman.

  • bpo-31344: For finer control of tracing behaviour when testing the interpreter, two new frame attributes have been added to control the emission of particular trace events: f_trace_lines (True by default) to turn off per-line trace events; and f_trace_opcodes (False by default) to turn on per-opcode trace events.

  • bpo-31373: Fix several possible instances of undefined behavior due to floating-point demotions.

  • bpo-30465: Location information (lineno and col_offset) in f-strings is now (mostly) correct. This fixes tools like flake8 from showing warnings on the wrong line (typically the first line of the file).

  • bpo-30860: Consolidate CPython’s global runtime state under a single struct. This improves discoverability of the runtime state.

  • bpo-31347: Fix possible undefined behavior in _PyObject_FastCall_Prepend.

  • bpo-31343: Include sys/sysmacros.h for major(), minor(), and makedev(). GNU C library plans to remove the functions from sys/types.h.

  • bpo-31291: Fix an assertion failure in zipimport.zipimporter.get_data on Windows, when the return value of pathname.replace('/','\\') isn’t a string. Patch by Oren Milman.

  • bpo-31271: Fix an assertion failure in the write() method of io.TextIOWrapper, when the encoder doesn’t return a bytes object. Patch by Oren Milman.

  • bpo-31243: Fix a crash in some methods of io.TextIOWrapper, when the decoder’s state is invalid. Patch by Oren Milman.

  • bpo-30721: print now shows correct usage hint for using Python 2 redirection syntax. Patch by Sanyam Khurana.

  • bpo-31070: Fix a race condition in importlib _get_module_lock().

  • bpo-30747: Add a non-dummy implementation of _Py_atomic_store and _Py_atomic_load on MSVC.

  • bpo-31095: Fix potential crash during GC caused by tp_dealloc which doesn’t call PyObject_GC_UnTrack().

  • bpo-31071: Avoid masking original TypeError in call with * unpacking when other arguments are passed.

  • bpo-30978: str.format_map() now passes key lookup exceptions through. Previously any exception was replaced with a KeyError exception.

  • bpo-30808: Use _Py_atomic API for concurrency-sensitive signal state.

  • bpo-30876: Relative import from unloaded package now reimports the package instead of failing with SystemError. Relative import from non-package now fails with ImportError rather than SystemError.

  • bpo-30703: Improve signal delivery. Avoid using Py_AddPendingCall from signal handler, to avoid calling signal-unsafe functions. The tests I’m adding here fail without the rest of the patch, on Linux and OS X. This means our signal delivery logic had defects (some signals could be lost).

  • bpo-30765: Avoid blocking in pthread_mutex_lock() when PyThread_acquire_lock() is asked not to block.

  • bpo-31161: Make sure the “Missing parentheses” syntax error message is only applied to SyntaxError, not to subclasses. Patch by Martijn Pieters.

  • bpo-30814: Fixed a race condition when import a submodule from a package.

  • bpo-30736: The internal unicodedata database has been upgraded to Unicode 10.0.

  • bpo-30604: Move co_extra_freefuncs from per-thread to per-interpreter to avoid crashes.

  • bpo-30597: print now shows expected input in custom error message when used as a Python 2 statement. Patch by Sanyam Khurana.

  • bpo-30682: Removed a too-strict assertion that failed for certain f-strings, such as eval(«f”\n”») and eval(«f”\r”»).

  • bpo-30501: The compiler now produces more optimal code for complex condition expressions in the «if», «while» and «assert» statement, the «if» expression, and generator expressions and comprehensions.

  • bpo-28180: Implement PEP 538 (legacy C locale coercion). This means that when a suitable coercion target locale is available, both the core interpreter and locale-aware C extensions will assume the use of UTF-8 as the default text encoding, rather than ASCII.

  • bpo-30486: Allows setting cell values for __closure__. Patch by Lisa Roach.

  • bpo-30537: itertools.islice now accepts integer-like objects (having an __index__ method) as start, stop, and slice arguments

  • bpo-25324: Tokens needed for parsing in Python moved to C. COMMENT, NL and ENCODING. This way the tokens and tok_names in the token module don’t get changed when you import the tokenize module.

  • bpo-29104: Fixed parsing backslashes in f-strings.

  • bpo-27945: Fixed various segfaults with dict when input collections are mutated during searching, inserting or comparing. Based on patches by Duane Griffin and Tim Mitchell.

  • bpo-25794: Fixed type.__setattr__() and type.__delattr__() for non-interned attribute names. Based on patch by Eryk Sun.

  • bpo-30039: If a KeyboardInterrupt happens when the interpreter is in the middle of resuming a chain of nested “yield from” or “await” calls, it’s now correctly delivered to the innermost frame.

  • bpo-28974: object.__format__(x, '') is now equivalent to str(x) rather than format(str(self), '').

  • bpo-30024: Circular imports involving absolute imports with binding a submodule to a name are now supported.

  • bpo-12414: sys.getsizeof() on a code object now returns the sizes which includes the code struct and sizes of objects which it references. Patch by Donghee Na.

  • bpo-29839: len() now raises ValueError rather than OverflowError if __len__() returned a large negative integer.

  • bpo-11913: README.rst is now included in the list of distutils standard READMEs and therefore included in source distributions.

  • bpo-29914: Fixed default implementations of __reduce__ and __reduce_ex__(). object.__reduce__() no longer takes arguments, object.__reduce_ex__() now requires one argument.

  • bpo-29949: Fix memory usage regression of set and frozenset object.

  • bpo-29935: Fixed error messages in the index() method of tuple, list and deque when pass indices of wrong type.

  • bpo-29816: Shift operation now has less opportunity to raise OverflowError. ValueError always is raised rather than OverflowError for negative counts. Shifting zero with non-negative count always returns zero.

  • bpo-24821: Fixed the slowing down to 25 times in the searching of some unlucky Unicode characters.

  • bpo-29102: Add a unique ID to PyInterpreterState. This makes it easier to identify each subinterpreter.

  • bpo-29894: The deprecation warning is emitted if __complex__ returns an instance of a strict subclass of complex. In a future versions of Python this can be an error.

  • bpo-29859: Show correct error messages when any of the pthread_* calls in thread_pthread.h fails.

  • bpo-29849: Fix a memory leak when an ImportError is raised during from import.

  • bpo-28856: Fix an oversight that %b format for bytes should support objects follow the buffer protocol.

  • bpo-29723: The sys.path[0] initialization change for bpo-29139 caused a regression by revealing an inconsistency in how sys.path is initialized when executing __main__ from a zipfile, directory, or other import location. The interpreter now consistently avoids ever adding the import location’s parent directory to sys.path, and ensures no other sys.path entries are inadvertently modified when inserting the import location named on the command line.

  • bpo-29568: Escaped percent «%%» in the format string for classic string formatting no longer allows any characters between two percents.

  • bpo-29714: Fix a regression that bytes format may fail when containing zero bytes inside.

  • bpo-29695: bool(), float(), list() and tuple() no longer take keyword arguments. The first argument of int() can now be passes only as positional argument.

  • bpo-28893: Set correct __cause__ for errors about invalid awaitables returned from __aiter__ and __anext__.

  • bpo-28876: bool(range) works even if len(range) raises OverflowError.

  • bpo-29683: Fixes to memory allocation in _PyCode_SetExtra. Patch by Brian Coleman.

  • bpo-29684: Fix minor regression of PyEval_CallObjectWithKeywords. It should raise TypeError when kwargs is not a dict. But it might cause segv when args=NULL and kwargs is not a dict.

  • bpo-28598: Support __rmod__ for subclasses of str being called before str.__mod__. Patch by Martijn Pieters.

  • bpo-29607: Fix stack_effect computation for CALL_FUNCTION_EX. Patch by Matthieu Dartiailh.

  • bpo-29602: Fix incorrect handling of signed zeros in complex constructor for complex subclasses and for inputs having a __complex__ method. Patch by Serhiy Storchaka.

  • bpo-29347: Fixed possibly dereferencing undefined pointers when creating weakref objects.

  • bpo-29463: Add docstring field to Module, ClassDef, FunctionDef, and AsyncFunctionDef ast nodes. docstring is not first stmt in their body anymore. It affects co_firstlineno and co_lnotab of code object for module and class. (Reverted in bpo-32911.)

  • bpo-29438: Fixed use-after-free problem in key sharing dict.

  • bpo-29546: Set the “path” and “name” attribute on ImportError for from ... import ....

  • bpo-29546: Improve from-import error message with location

  • bpo-29478: If max_line_length=None is specified while using the Compat32 policy, it is no longer ignored. Patch by Mircea Cosbuc.

  • bpo-29319: Prevent RunMainFromImporter overwriting sys.path[0].

  • bpo-29337: Fixed possible BytesWarning when compare the code objects. Warnings could be emitted at compile time.

  • bpo-29327: Fixed a crash when pass the iterable keyword argument to sorted().

  • bpo-29034: Fix memory leak and use-after-free in os module (path_converter).

  • bpo-29159: Fix regression in bytes(x) when x.__index__() raises Exception.

  • bpo-29049: Call _PyObject_GC_TRACK() lazily when calling Python function. Calling function is up to 5% faster.

  • bpo-28927: bytes.fromhex() and bytearray.fromhex() now ignore all ASCII whitespace, not only spaces. Patch by Robert Xiao.

  • bpo-28932: Do not include <sys/random.h> if it does not exist.

  • bpo-25677: Correct the positioning of the syntax error caret for indented blocks. Based on patch by Michael Layzell.

  • bpo-29000: Fixed bytes formatting of octals with zero padding in alternate form.

  • bpo-18896: Python function can now have more than 255 parameters. collections.namedtuple() now supports tuples with more than 255 elements.

  • bpo-28596: The preferred encoding is UTF-8 on Android. Patch written by Chi Hsuan Yen.

  • bpo-22257: Clean up interpreter startup (see PEP 432).

  • bpo-26919: On Android, operating system data is now always encoded/decoded to/from UTF-8, instead of the locale encoding to avoid inconsistencies with os.fsencode() and os.fsdecode() which are already using UTF-8.

  • bpo-28991: functools.lru_cache() was susceptible to an obscure reentrancy bug triggerable by a monkey-patched len() function.

  • bpo-28147: Fix a memory leak in split-table dictionaries: setattr() must not convert combined table into split table. Patch written by INADA Naoki.

  • bpo-28739: f-string expressions are no longer accepted as docstrings and by ast.literal_eval() even if they do not include expressions.

  • bpo-28512: Fixed setting the offset attribute of SyntaxError by PyErr_SyntaxLocationEx() and PyErr_SyntaxLocationObject().

  • bpo-28918: Fix the cross compilation of xxlimited when Python has been built with Py_DEBUG defined.

  • bpo-23722: Rather than silently producing a class that doesn’t support zero-argument super() in methods, failing to pass the new __classcell__ namespace entry up to type.__new__ now results in a DeprecationWarning and a class that supports zero-argument super().

  • bpo-28797: Modifying the class __dict__ inside the __set_name__ method of a descriptor that is used inside that class no longer prevents calling the __set_name__ method of other descriptors.

  • bpo-28799: Remove the PyEval_GetCallStats() function and deprecate the untested and undocumented sys.callstats() function. Remove the CALL_PROFILE special build: use the sys.setprofile() function, cProfile or profile to profile function calls.

  • bpo-12844: More than 255 arguments can now be passed to a function.

  • bpo-28782: Fix a bug in the implementation yield from when checking if the next instruction is YIELD_FROM. Regression introduced by WORDCODE (bpo-26647).

  • bpo-28774: Fix error position of the unicode error in ASCII and Latin1 encoders when a string returned by the error handler contains multiple non-encodable characters (non-ASCII for the ASCII codec, characters out of the U+0000-U+00FF range for Latin1).

  • bpo-28731: Optimize _PyDict_NewPresized() to create correct size dict. Improve speed of dict literal with constant keys up to 30%.

  • bpo-28532: Show sys.version when -V option is supplied twice.

  • bpo-27100: The with-statement now checks for __enter__ before it checks for __exit__. This gives less confusing error messages when both methods are missing. Patch by Jonathan Ellington.

  • bpo-28746: Fix the set_inheritable() file descriptor method on platforms that do not have the ioctl FIOCLEX and FIONCLEX commands.

  • bpo-26920: Fix not getting the locale’s charset upon initializing the interpreter, on platforms that do not have langinfo.

  • bpo-28648: Fixed crash in Py_DecodeLocale() in debug build on Mac OS X when decode astral characters. Patch by Xiang Zhang.

  • bpo-28665: Improve speed of the STORE_DEREF opcode by 40%.

  • bpo-19398: Extra slash no longer added to sys.path components in case of empty compile-time PYTHONPATH components.

  • bpo-28621: Sped up converting int to float by reusing faster bits counting implementation. Patch by Adrian Wielgosik.

  • bpo-28580: Optimize iterating split table values. Patch by Xiang Zhang.

  • bpo-28583: PyDict_SetDefault didn’t combine split table when needed. Patch by Xiang Zhang.

  • bpo-28128: Deprecation warning for invalid str and byte escape sequences now prints better information about where the error occurs. Patch by Serhiy Storchaka and Eric Smith.

  • bpo-28509: dict.update() no longer allocate unnecessary large memory.

  • bpo-28426: Fixed potential crash in PyUnicode_AsDecodedObject() in debug build.

  • bpo-28517: Fixed of-by-one error in the peephole optimizer that caused keeping unreachable code.

  • bpo-28214: Improved exception reporting for problematic __set_name__ attributes.

  • bpo-23782: Fixed possible memory leak in _PyTraceback_Add() and exception loss in PyTraceBack_Here().

  • bpo-28183: Optimize and cleanup dict iteration.

  • bpo-26081: Added C implementation of asyncio.Future. Original patch by Yury Selivanov.

  • bpo-28379: Added sanity checks and tests for PyUnicode_CopyCharacters(). Patch by Xiang Zhang.

  • bpo-28376: The type of long range iterator is now registered as Iterator. Patch by Oren Milman.

  • bpo-28376: Creating instances of range_iterator by calling range_iterator type now is disallowed. Calling iter() on range instance is the only way. Patch by Oren Milman.

  • bpo-26906: Resolving special methods of uninitialized type now causes implicit initialization of the type instead of a fail.

  • bpo-18287: PyType_Ready() now checks that tp_name is not NULL. Original patch by Niklas Koep.

  • bpo-24098: Fixed possible crash when AST is changed in process of compiling it.

  • bpo-28201: Dict reduces possibility of 2nd conflict in hash table when hashes have same lower bits.

  • bpo-28350: String constants with null character no longer interned.

  • bpo-26617: Fix crash when GC runs during weakref callbacks.

  • bpo-27942: String constants now interned recursively in tuples and frozensets.

  • bpo-28289: ImportError.__init__ now resets not specified attributes.

  • bpo-21578: Fixed misleading error message when ImportError called with invalid keyword args.

  • bpo-28203: Fix incorrect type in complex(1.0, {2:3}) error message. Patch by Soumya Sharma.

  • bpo-28086: Single var-positional argument of tuple subtype was passed unscathed to the C-defined function. Now it is converted to exact tuple.

  • bpo-28214: Now __set_name__ is looked up on the class instead of the instance.

  • bpo-27955: Fallback on reading /dev/urandom device when the getrandom() syscall fails with EPERM, for example when blocked by SECCOMP.

  • bpo-28192: Don’t import readline in isolated mode.

  • bpo-27441: Remove some redundant assignments to ob_size in longobject.c. Thanks Oren Milman.

  • bpo-27222: Clean up redundant code in long_rshift function. Thanks Oren Milman.

  • Upgrade internal unicode databases to Unicode version 9.0.0.

  • bpo-28131: Fix a regression in zipimport’s compile_source(). zipimport should use the same optimization level as the interpreter.

  • bpo-28126: Replace Py_MEMCPY with memcpy(). Visual Studio can properly optimize memcpy().

  • bpo-28120: Fix dict.pop() for split dictionary when trying to remove a «pending key» (Not yet inserted in split-table). Patch by Xiang Zhang.

  • bpo-26182: Raise DeprecationWarning when async and await keywords are used as variable/attribute/class/function name.

  • bpo-26182: Fix a refleak in code that raises DeprecationWarning.

  • bpo-28721: Fix asynchronous generators aclose() and athrow() to handle StopAsyncIteration propagation properly.

  • bpo-26110: Speed-up method calls: add LOAD_METHOD and CALL_METHOD opcodes.

Library

  • bpo-31499: xml.etree: Fix a crash when a parser is part of a reference cycle.

  • bpo-31482: random.seed() now works with bytes in version=1

  • bpo-28556: typing.get_type_hints now finds the right globalns for classes and modules by default (when no globalns was specified by the caller).

  • bpo-28556: Speed improvements to the typing module. Original PRs by Ivan Levkivskyi and Mitar.

  • bpo-31544: The C accelerator module of ElementTree ignored exceptions raised when looking up TreeBuilder target methods in XMLParser().

  • bpo-31234: socket.create_connection() now fixes manually a reference cycle: clear the variable storing the last exception on success.

  • bpo-31457: LoggerAdapter objects can now be nested.

  • bpo-31431: SSLContext.check_hostname now automatically sets SSLContext.verify_mode to ssl.CERT_REQUIRED instead of failing with a ValueError.

  • bpo-31233: socketserver.ThreadingMixIn now keeps a list of non-daemonic threads to wait until all these threads complete in server_close().

  • bpo-28638: Changed the implementation strategy for collections.namedtuple() to substantially reduce the use of exec() in favor of precomputed methods. As a result, the verbose parameter and _source attribute are no longer supported. The benefits include 1) having a smaller memory footprint for applications using multiple named tuples, 2) faster creation of the named tuple class (approx 4x to 6x depending on how it is measured), and 3) minor speed-ups for instance creation using __new__, _make, and _replace. (The primary patch contributor is Jelle Zijlstra with further improvements by INADA Naoki, Serhiy Storchaka, and Raymond Hettinger.)

  • bpo-31400: Improves SSL error handling to avoid losing error numbers.

  • bpo-27629: Make return types of SSLContext.wrap_bio() and SSLContext.wrap_socket() customizable.

  • bpo-28958: ssl.SSLContext() now uses OpenSSL error information when a context cannot be instantiated.

  • bpo-28182: The SSL module now raises SSLCertVerificationError when OpenSSL fails to verify the peer’s certificate. The exception contains more information about the error.

  • bpo-27340: SSLSocket.sendall() now uses memoryview to create slices of data. This fixes support for all bytes-like object. It is also more efficient and avoids costly copies.

  • bpo-14191: A new function argparse.ArgumentParser.parse_intermixed_args provides the ability to parse command lines where there user intermixes options and positional arguments.

  • bpo-31178: Fix string concatenation bug in rare error path in the subprocess module

  • bpo-31350: Micro-optimize asyncio._get_running_loop() to become up to 10% faster.

  • bpo-31170: expat: Update libexpat from 2.2.3 to 2.2.4. Fix copying of partial characters for UTF-8 input (libexpat bug 115): https://github.com/libexpat/libexpat/issues/115

  • bpo-29136: Add TLS 1.3 cipher suites and OP_NO_TLSv1_3.

  • bpo-1198569: string.Template subclasses can optionally define braceidpattern if they want to specify different placeholder patterns inside and outside the braces. If None (the default) it falls back to idpattern.

  • bpo-31326: concurrent.futures.ProcessPoolExecutor.shutdown() now explicitly closes the call queue. Moreover, shutdown(wait=True) now also join the call queue thread, to prevent leaking a dangling thread.

  • bpo-27144: The map() and as_completed() iterators in concurrent.futures now avoid keeping a reference to yielded objects.

  • bpo-31281: Fix fileinput.FileInput(files, inplace=True) when files contain pathlib.Path objects.

  • bpo-10746: Fix ctypes producing wrong PEP 3118 type codes for integer types.

  • bpo-27584: AF_VSOCK has been added to the socket interface which allows communication between virtual machines and their host.

  • bpo-22536: The subprocess module now sets the filename when FileNotFoundError is raised on POSIX systems due to the executable or cwd not being found.

  • bpo-29741: Update some methods in the _pyio module to also accept integer types. Patch by Oren Milman.

  • bpo-31249: concurrent.futures: WorkItem.run() used by ThreadPoolExecutor now breaks a reference cycle between an exception object and the WorkItem object.

  • bpo-31247: xmlrpc.server now explicitly breaks reference cycles when using sys.exc_info() in code handling exceptions.

  • bpo-23835: configparser: reading defaults in the ConfigParser() constructor is now using read_dict(), making its behavior consistent with the rest of the parser. Non-string keys and values in the defaults dictionary are now being implicitly converted to strings. Patch by James Tocknell.

  • bpo-31238: pydoc: the stop() method of the private ServerThread class now waits until DocServer.serve_until_quit() completes and then explicitly sets its docserver attribute to None to break a reference cycle.

  • bpo-5001: Many asserts in multiprocessing are now more informative, and some error types have been changed to more specific ones.

  • bpo-31109: Convert zipimport to use Argument Clinic.

  • bpo-30102: The ssl and hashlib modules now call OPENSSL_add_all_algorithms_noconf() on OpenSSL < 1.1.0. The function detects CPU features and enables optimizations on some CPU architectures such as POWER8. Patch is based on research from Gustavo Serra Scalet.

  • bpo-18966: Non-daemonic threads created by a multiprocessing.Process are now joined on child exit.

  • bpo-31183: dis now works with asynchronous generator and coroutine objects. Patch by George Collins based on diagnosis by Luciano Ramalho.

  • bpo-5001: There are a number of uninformative asserts in the multiprocessing module, as noted in issue 5001. This change fixes two of the most potentially problematic ones, since they are in error-reporting code, in the multiprocessing.managers.convert_to_error function. (It also makes more informative a ValueError message.) The only potentially problematic change is that the AssertionError is now a TypeError; however, this should also help distinguish it from an AssertionError being reported by the function/its caller (such as in issue 31169). - Patch by Allen W. Smith (drallensmith on github).

  • bpo-31185: Fixed miscellaneous errors in asyncio speedup module.

  • bpo-31151: socketserver.ForkingMixIn.server_close() now waits until all child processes completed to prevent leaking zombie processes.

  • bpo-31072: Add an include_file parameter to zipapp.create_archive()

  • bpo-24700: Optimize array.array comparison. It is now from 10x up to 70x faster when comparing arrays holding values of the same integer type.

  • bpo-31135: ttk: fix the destroy() method of LabeledScale and OptionMenu classes. Call the parent destroy() method even if the used attribute doesn’t exist. The LabeledScale.destroy() method now also explicitly clears label and scale attributes to help the garbage collector to destroy all widgets.

  • bpo-31107: Fix copyreg._slotnames() mangled attribute calculation for classes whose name begins with an underscore. Patch by Shane Harvey.

  • bpo-31080: Allow logging.config.fileConfig to accept kwargs and/or args.

  • bpo-30897: pathlib.Path objects now include an is_mount() method (only implemented on POSIX). This is similar to os.path.ismount(p). Patch by Cooper Ry Lees.

  • bpo-31061: Fixed a crash when using asyncio and threads.

  • bpo-30987: Added support for CAN ISO-TP protocol in the socket module.

  • bpo-30522: Added a setStream method to logging.StreamHandler to allow the stream to be set after creation.

  • bpo-30502: Fix handling of long oids in ssl. Based on patch by Christian Heimes.

  • bpo-5288: Support tzinfo objects with sub-minute offsets.

  • bpo-30919: Fix shared memory performance regression in multiprocessing in 3.x. Shared memory used anonymous memory mappings in 2.x, while 3.x mmaps actual files. Try to be careful to do as little disk I/O as possible.

  • bpo-26732: Fix too many fds in processes started with the «forkserver» method. A child process would inherit as many fds as the number of still-running children.

  • bpo-29403: Fix unittest.mock’s autospec to not fail on method-bound builtin functions. Patch by Aaron Gallagher.

  • bpo-30961: Fix decrementing a borrowed reference in tracemalloc.

  • bpo-19896: Fix multiprocessing.sharedctypes to recognize typecodes 'q' and 'Q'.

  • bpo-30946: Remove obsolete code in readline module for platforms where GNU readline is older than 2.1 or where select() is not available.

  • bpo-25684: Change ttk.OptionMenu radiobuttons to be unique across instances of OptionMenu.

  • bpo-30886: Fix multiprocessing.Queue.join_thread(): it now waits until the thread completes, even if the thread was started by the same process which created the queue.

  • bpo-29854: Fix segfault in readline when using readline’s history-size option. Patch by Nir Soffer.

  • bpo-30794: Added multiprocessing.Process.kill method to terminate using the SIGKILL signal on Unix.

  • bpo-30319: socket.close() now ignores ECONNRESET error.

  • bpo-30828: Fix out of bounds write in asyncio.CFuture.remove_done_callback().

  • bpo-30302: Use keywords in the repr of datetime.timedelta.

  • bpo-30807: signal.setitimer() may disable the timer when passed a tiny value. Tiny values (such as 1e-6) are valid non-zero values for setitimer(), which is specified as taking microsecond-resolution intervals. However, on some platform, our conversion routine could convert 1e-6 into a zero interval, therefore disabling the timer instead of (re-)scheduling it.

  • bpo-30441: Fix bug when modifying os.environ while iterating over it

  • bpo-29585: Avoid importing sysconfig from site to improve startup speed. Python startup is about 5% faster on Linux and 30% faster on macOS.

  • bpo-29293: Add missing parameter «n» on multiprocessing.Condition.notify(). The doc claims multiprocessing.Condition behaves like threading.Condition, but its notify() method lacked the optional «n» argument (to specify the number of sleepers to wake up) that threading.Condition.notify() accepts.

  • bpo-30532: Fix email header value parser dropping folding white space in certain cases.

  • bpo-30596: Add a close() method to multiprocessing.Process.

  • bpo-9146: Fix a segmentation fault in _hashopenssl when standard hash functions such as md5 are not available in the linked OpenSSL library. As in some special FIPS-140 build environments.

  • bpo-29169: Update zlib to 1.2.11.

  • bpo-30119: ftplib.FTP.putline() now throws ValueError on commands that contains CR or LF. Patch by Donghee Na.

  • bpo-30879: os.listdir() and os.scandir() now emit bytes names when called with bytes-like argument.

  • bpo-30746: Prohibited the “=” character in environment variable names in os.putenv() and os.spawn*().

  • bpo-30664: The description of a unittest subtest now preserves the order of keyword arguments of TestCase.subTest().

  • bpo-21071: struct.Struct.format type is now str instead of bytes.

  • bpo-29212: Fix concurrent.futures.thread.ThreadPoolExecutor threads to have a non repr() based thread name by default when no thread_name_prefix is supplied. They will now identify themselves as «ThreadPoolExecutor-y_n».

  • bpo-29755: Fixed the lgettext() family of functions in the gettext module. They now always return bytes.

  • bpo-30616: Functional API of enum allows to create empty enums. Patched by Donghee Na

  • bpo-30038: Fix race condition between signal delivery and wakeup file descriptor. Patch by Nathaniel Smith.

  • bpo-23894: lib2to3 now recognizes rb'...' and f'...' strings.

  • bpo-24744: pkgutil.walk_packages function now raises ValueError if path is a string. Patch by Sanyam Khurana.

  • bpo-24484: Avoid race condition in multiprocessing cleanup.

  • bpo-30589: Fix multiprocessing.Process.exitcode to return the opposite of the signal number when the process is killed by a signal (instead of 255) when using the «forkserver» method.

  • bpo-28994: The traceback no longer displayed for SystemExit raised in a callback registered by atexit.

  • bpo-30508: Don’t log exceptions if Task/Future «cancel()» method was called.

  • bpo-30645: Fix path calculation in imp.load_package(), fixing it for cases when a package is only shipped with bytecodes. Patch by Alexandru Ardelean.

  • bpo-11822: The dis.dis() function now is able to disassemble nested code objects.

  • bpo-30624: selectors does not take KeyboardInterrupt and SystemExit into account, leaving a fd in a bad state in case of error. Patch by Giampaolo Rodola”.

  • bpo-30595: multiprocessing.Queue.get() with a timeout now polls its reader in non-blocking mode if it succeeded to acquire the lock but the acquire took longer than the timeout.

  • bpo-28556: Updates to typing module: Add generic AsyncContextManager, add support for ContextManager on all versions. Original PRs by Jelle Zijlstra and Ivan Levkivskyi

  • bpo-30605: re.compile() no longer raises a BytesWarning when compiling a bytes instance with misplaced inline modifier. Patch by Roy Williams.

  • bpo-29870: Fix ssl sockets leaks when connection is aborted in asyncio/ssl implementation. Patch by Michaël Sghaïer.

  • bpo-29743: Closing transport during handshake process leaks open socket. Patch by Nikolay Kim

  • bpo-27585: Fix waiter cancellation in asyncio.Lock. Patch by Mathieu Sornay.

  • bpo-30014: modify() method of poll(), epoll() and devpoll() based classes of selectors module is around 10% faster. Patch by Giampaolo Rodola”.

  • bpo-30418: On Windows, subprocess.Popen.communicate() now also ignore EINVAL on stdin.write() if the child process is still running but closed the pipe.

  • bpo-30463: Added empty __slots__ to abc.ABC. This allows subclassers to deny __dict__ and __weakref__ creation. Patch by Aaron Hall.

  • bpo-30520: Loggers are now pickleable.

  • bpo-30557: faulthandler now correctly filters and displays exception codes on Windows

  • bpo-30526: Add TextIOWrapper.reconfigure() and a TextIOWrapper.write_through attribute.

  • bpo-30245: Fix possible overflow when organize struct.pack_into error message. Patch by Yuan Liu.

  • bpo-30378: Fix the problem that logging.handlers.SysLogHandler cannot handle IPv6 addresses.

  • bpo-16500: Allow registering at-fork handlers.

  • bpo-30470: Deprecate invalid ctypes call protection on Windows. Patch by Mariatta Wijaya.

  • bpo-30414: multiprocessing.Queue._feed background running thread do not break from main loop on exception.

  • bpo-30003: Fix handling escape characters in HZ codec. Based on patch by Ma Lin.

  • bpo-30149: inspect.signature() now supports callables with variable-argument parameters wrapped with partialmethod. Patch by Donghee Na.

  • bpo-30436: importlib.find_spec() raises ModuleNotFoundError instead of AttributeError if the specified parent module is not a package (i.e. lacks a __path__ attribute).

  • bpo-30301: Fix AttributeError when using SimpleQueue.empty() under spawn and forkserver start methods.

  • bpo-30375: Warnings emitted when compile a regular expression now always point to the line in the user code. Previously they could point into inners of the re module if emitted from inside of groups or conditionals.

  • bpo-30329: imaplib and poplib now catch the Windows socket WSAEINVAL error (code 10022) on shutdown(SHUT_RDWR): An invalid operation was attempted. This error occurs sometimes on SSL connections.

  • bpo-29196: Removed previously deprecated in Python 2.4 classes Plist, Dict and _InternalDict in the plistlib module. Dict values in the result of functions readPlist() and readPlistFromBytes() are now normal dicts. You no longer can use attribute access to access items of these dictionaries.

  • bpo-9850: The macpath is now deprecated and will be removed in Python 3.8.

  • bpo-30299: Compiling regular expression in debug mode on CPython now displays the compiled bytecode in human readable form.

  • bpo-30048: Fixed Task.cancel() can be ignored when the task is running coroutine and the coroutine returned without any more await.

  • bpo-30266: contextlib.AbstractContextManager now supports anti-registration by setting __enter__ = None or __exit__ = None, following the pattern introduced in bpo-25958. Patch by Jelle Zijlstra.

  • bpo-30340: Enhanced regular expressions optimization. This increased the performance of matching some patterns up to 25 times.

  • bpo-30298: Weaken the condition of deprecation warnings for inline modifiers. Now allowed several subsequential inline modifiers at the start of the pattern (e.g. '(?i)(?s)...'). In verbose mode whitespaces and comments now are allowed before and between inline modifiers (e.g. '(?x) (?i) (?s)...').

  • bpo-30285: Optimized case-insensitive matching and searching of regular expressions.

  • bpo-29990: Fix range checking in GB18030 decoder. Original patch by Ma Lin.

  • bpo-29979: rewrite cgi.parse_multipart, reusing the FieldStorage class and making its results consistent with those of FieldStorage for multipart/form-data requests. Patch by Pierre Quentel.

  • bpo-30243: Removed the __init__ methods of _json’s scanner and encoder. Misusing them could cause memory leaks or crashes. Now scanner and encoder objects are completely initialized in the __new__ methods.

  • bpo-30215: Compiled regular expression objects with the re.LOCALE flag no longer depend on the locale at compile time. Only the locale at matching time affects the result of matching.

  • bpo-30185: Avoid KeyboardInterrupt tracebacks in forkserver helper process when Ctrl-C is received.

  • bpo-30103: binascii.b2a_uu() and uu.encode() now support using '`' as zero instead of space.

  • bpo-28556: Various updates to typing module: add typing.NoReturn type, use WrapperDescriptorType, minor bug-fixes. Original PRs by Jim Fasarakis-Hilliard and Ivan Levkivskyi.

  • bpo-30205: Fix getsockname() for unbound AF_UNIX sockets on Linux.

  • bpo-30228: The seek() and tell() methods of io.FileIO now set the internal seekable attribute to avoid one syscall on open() (in buffered or text mode).

  • bpo-30190: unittest’s assertAlmostEqual and assertNotAlmostEqual provide a better message in case of failure which includes the difference between left and right arguments. (patch by Giampaolo Rodola”)

  • bpo-30101: Add support for curses.A_ITALIC.

  • bpo-29822: inspect.isabstract() now works during __init_subclass__. Patch by Nate Soares.

  • bpo-29960: Preserve generator state when _random.Random.setstate() raises an exception. Patch by Bryan Olson.

  • bpo-30070: Fixed leaks and crashes in errors handling in the parser module.

  • bpo-22352: Column widths in the output of dis.dis() are now adjusted for large line numbers and instruction offsets.

  • bpo-30061: Fixed crashes in IOBase methods __next__() and readlines() when readline() or __next__() respectively return non-sizeable object. Fixed possible other errors caused by not checking results of PyObject_Size(), PySequence_Size(), or PyMapping_Size().

  • bpo-30218: Fix PathLike support for shutil.unpack_archive. Patch by Jelle Zijlstra.

  • bpo-10076: Compiled regular expression and match objects in the re module now support copy.copy() and copy.deepcopy() (they are considered atomic).

  • bpo-30068: _io._IOBase.readlines will check if it’s closed first when hint is present.

  • bpo-29694: Fixed race condition in pathlib mkdir with flags parents=True. Patch by Armin Rigo.

  • bpo-29692: Fixed arbitrary unchaining of RuntimeError exceptions in contextlib.contextmanager. Patch by Siddharth Velankar.

  • bpo-26187: Test that sqlite3 trace callback is not called multiple times when schema is changing. Indirectly fixed by switching to use sqlite3_prepare_v2() in bpo-9303. Patch by Aviv Palivoda.

  • bpo-30017: Allowed calling the close() method of the zip entry writer object multiple times. Writing to a closed writer now always produces a ValueError.

  • bpo-29998: Pickling and copying ImportError now preserves name and path attributes.

  • bpo-29995: re.escape() now escapes only regex special characters.

  • bpo-29962: Add math.remainder operation, implementing remainder as specified in IEEE 754.

  • bpo-29649: Improve struct.pack_into() exception messages for problems with the buffer size and offset. Patch by Andrew Nester.

  • bpo-29654: Support If-Modified-Since HTTP header (browser cache). Patch by Pierre Quentel.

  • bpo-29931: Fixed comparison check for ipaddress.ip_interface objects. Patch by Sanjay Sundaresan.

  • bpo-29953: Fixed memory leaks in the replace() method of datetime and time objects when pass out of bound fold argument.

  • bpo-29942: Fix a crash in itertools.chain.from_iterable when encountering long runs of empty iterables.

  • bpo-10030: Sped up reading encrypted ZIP files by 2 times.

  • bpo-29204: Element.getiterator() and the html parameter of XMLParser() were deprecated only in the documentation (since Python 3.2 and 3.4 correspondingly). Now using them emits a deprecation warning.

  • bpo-27863: Fixed multiple crashes in ElementTree caused by race conditions and wrong types.

  • bpo-25996: Added support of file descriptors in os.scandir() on Unix. os.fwalk() is sped up by 2 times by using os.scandir().

  • bpo-28699: Fixed a bug in pools in multiprocessing.pool that raising an exception at the very first of an iterable may swallow the exception or make the program hang. Patch by Davin Potts and Xiang Zhang.

  • bpo-23890: unittest.TestCase.assertRaises() now manually breaks a reference cycle to not keep objects alive longer than expected.

  • bpo-29901: The zipapp module now supports general path-like objects, not just pathlib.Path.

  • bpo-25803: Avoid incorrect errors raised by Path.mkdir(exist_ok=True) when the OS gives priority to errors such as EACCES over EEXIST.

  • bpo-29861: Release references to tasks, their arguments and their results as soon as they are finished in multiprocessing.Pool.

  • bpo-19930: The mode argument of os.makedirs() no longer affects the file permission bits of newly created intermediate-level directories.

  • bpo-29884: faulthandler: Restore the old sigaltstack during teardown. Patch by Christophe Zeitouny.

  • bpo-25455: Fixed crashes in repr of recursive buffered file-like objects.

  • bpo-29800: Fix crashes in partial.__repr__ if the keys of partial.keywords are not strings. Patch by Michael Seifert.

  • bpo-8256: Fixed possible failing or crashing input() if attributes «encoding» or «errors» of sys.stdin or sys.stdout are not set or are not strings.

  • bpo-28692: Using non-integer value for selecting a plural form in gettext is now deprecated.

  • bpo-26121: Use C library implementation for math functions erf() and erfc().

  • bpo-29619: os.stat() and os.DirEntry.inode() now convert inode (st_ino) using unsigned integers.

  • bpo-28298: Fix a bug that prevented array “Q”, “L” and “I” from accepting big intables (objects that have __int__) as elements.

  • bpo-29645: Speed up importing the webbrowser module. webbrowser.register() is now thread-safe.

  • bpo-28231: The zipfile module now accepts path-like objects for external paths.

  • bpo-26915: index() and count() methods of collections.abc.Sequence now check identity before checking equality when do comparisons.

  • bpo-28682: Added support for bytes paths in os.fwalk().

  • bpo-29728: Add new socket.TCP_NOTSENT_LOWAT (Linux 3.12) constant. Patch by Nathaniel J. Smith.

  • bpo-29623: Allow use of path-like object as a single argument in ConfigParser.read(). Patch by David Ellis.

  • bpo-9303: Migrate sqlite3 module to _v2 API. Patch by Aviv Palivoda.

  • bpo-28963: Fix out of bound iteration in asyncio.Future.remove_done_callback implemented in C.

  • bpo-29704: asyncio.subprocess.SubprocessStreamProtocol no longer closes before all pipes are closed.

  • bpo-29271: Fix Task.current_task and Task.all_tasks implemented in C to accept None argument as their pure Python implementation.

  • bpo-29703: Fix asyncio to support instantiation of new event loops in child processes.

  • bpo-29615: SimpleXMLRPCDispatcher no longer chains KeyError (or any other exception) to exception(s) raised in the dispatched methods. Patch by Petr Motejlek.

  • bpo-7769: Method register_function() of xmlrpc.server.SimpleXMLRPCDispatcher and its subclasses can now be used as a decorator.

  • bpo-29376: Fix assertion error in threading._DummyThread.is_alive().

  • bpo-28624: Add a test that checks that cwd parameter of Popen() accepts PathLike objects. Patch by Sayan Chowdhury.

  • bpo-28518: Start a transaction implicitly before a DML statement. Patch by Aviv Palivoda.

  • bpo-29742: get_extra_info() raises exception if get called on closed ssl transport. Patch by Nikolay Kim.

  • bpo-16285: urllib.parse.quote is now based on RFC 3986 and hence includes “~” in the set of characters that is not quoted by default. Patch by Christian Theune and Ratnadeep Debnath.

  • bpo-29532: Altering a kwarg dictionary passed to functools.partial() no longer affects a partial object after creation.

  • bpo-29110: Fix file object leak in aifc.open() when file is given as a filesystem path and is not in valid AIFF format. Patch by Anthony Zhang.

  • bpo-22807: Add uuid.SafeUUID and uuid.UUID.is_safe to relay information from the platform about whether generated UUIDs are generated with a multiprocessing safe method.

  • bpo-29576: Improve some deprecations in importlib. Some deprecated methods now emit DeprecationWarnings and have better descriptive messages.

  • bpo-29534: Fixed different behaviour of Decimal.from_float() for _decimal and _pydecimal. Thanks Andrew Nester.

  • bpo-10379: locale.format_string now supports the “monetary” keyword argument, and locale.format is deprecated.

  • bpo-29851: importlib.reload() now raises ModuleNotFoundError if the module lacks a spec.

  • bpo-28556: Various updates to typing module: typing.Counter, typing.ChainMap, improved ABC caching, etc. Original PRs by Jelle Zijlstra, Ivan Levkivskyi, Manuel Krebber, and Łukasz Langa.

  • bpo-29100: Fix datetime.fromtimestamp() regression introduced in Python 3.6.0: check minimum and maximum years.

  • bpo-29416: Prevent infinite loop in pathlib.Path.mkdir

  • bpo-29444: Fixed out-of-bounds buffer access in the group() method of the match object. Based on patch by WGH.

  • bpo-29377: Add WrapperDescriptorType, MethodWrapperType, and MethodDescriptorType built-in types to types module. Original patch by Manuel Krebber.

  • bpo-29218: Unused install_misc command is now removed. It has been documented as unused since 2000. Patch by Eric N. Vander Weele.

  • bpo-29368: The extend() method is now called instead of the append() method when unpickle collections.deque and other list-like objects. This can speed up unpickling to 2 times.

  • bpo-29338: The help of a builtin or extension class now includes the constructor signature if __text_signature__ is provided for the class.

  • bpo-29335: Fix subprocess.Popen.wait() when the child process has exited to a stopped instead of terminated state (ex: when under ptrace).

  • bpo-29290: Fix a regression in argparse that help messages would wrap at non-breaking spaces.

  • bpo-28735: Fixed the comparison of mock.MagickMock with mock.ANY.

  • bpo-29197: Removed deprecated function ntpath.splitunc().

  • bpo-29210: Removed support of deprecated argument «exclude» in tarfile.TarFile.add().

  • bpo-29219: Fixed infinite recursion in the repr of uninitialized ctypes.CDLL instances.

  • bpo-29192: Removed deprecated features in the http.cookies module.

  • bpo-29193: A format string argument for string.Formatter.format() is now positional-only.

  • bpo-29195: Removed support of deprecated undocumented keyword arguments in methods of regular expression objects.

  • bpo-28969: Fixed race condition in C implementation of functools.lru_cache. KeyError could be raised when cached function with full cache was simultaneously called from different threads with the same uncached arguments.

  • bpo-20804: The unittest.mock.sentinel attributes now preserve their identity when they are copied or pickled.

  • bpo-29142: In urllib.request, suffixes in no_proxy environment variable with leading dots could match related hostnames again (e.g. .b.c matches a.b.c). Patch by Milan Oberkirch.

  • bpo-28961: Fix unittest.mock._Call helper: don’t ignore the name parameter anymore. Patch written by Jiajun Huang.

  • bpo-15812: inspect.getframeinfo() now correctly shows the first line of a context. Patch by Sam Breese.

  • bpo-28985: Update authorizer constants in sqlite3 module. Patch by Dingyuan Wang.

  • bpo-29079: Prevent infinite loop in pathlib.resolve() on Windows

  • bpo-13051: Fixed recursion errors in large or resized curses.textpad.Textbox. Based on patch by Tycho Andersen.

  • bpo-9770: curses.ascii predicates now work correctly with negative integers.

  • bpo-28427: old keys should not remove new values from WeakValueDictionary when collecting from another thread.

  • bpo-28923: Remove editor artifacts from Tix.py.

  • bpo-28871: Fixed a crash when deallocate deep ElementTree.

  • bpo-19542: Fix bugs in WeakValueDictionary.setdefault() and WeakValueDictionary.pop() when a GC collection happens in another thread.

  • bpo-20191: Fixed a crash in resource.prlimit() when passing a sequence that doesn’t own its elements as limits.

  • bpo-16255: subprocess.Popen uses /system/bin/sh on Android as the shell, instead of /bin/sh.

  • bpo-28779: multiprocessing.set_forkserver_preload() would crash the forkserver process if a preloaded module instantiated some multiprocessing objects such as locks.

  • bpo-26937: The chown() method of the tarfile.TarFile class does not fail now when the grp module cannot be imported, as for example on Android platforms.

  • bpo-28847: dbm.dumb now supports reading read-only files and no longer writes the index file when it is not changed. A deprecation warning is now emitted if the index file is missed and recreated in the “r” and “w” modes (will be an error in future Python releases).

  • bpo-27030: Unknown escapes consisting of '\' and an ASCII letter in re.sub() replacement templates regular expressions now are errors.

  • bpo-28835: Fix a regression introduced in warnings.catch_warnings(): call warnings.showwarning() if it was overridden inside the context manager.

  • bpo-27172: To assist with upgrades from 2.7, the previously documented deprecation of inspect.getfullargspec() has been reversed. This decision may be revisited again after the Python 2.7 branch is no longer officially supported.

  • bpo-28740: Add sys.getandroidapilevel(): return the build time API version of Android as an integer. Function only available on Android.

  • bpo-26273: Add new socket.TCP_CONGESTION (Linux 2.6.13) and socket.TCP_USER_TIMEOUT (Linux 2.6.37) constants. Patch written by Omar Sandoval.

  • bpo-28752: Restored the __reduce__() methods of datetime objects.

  • bpo-28727: Regular expression patterns, _sre.SRE_Pattern objects created by re.compile(), become comparable (only x==y and x!=y operators). This change should fix the bpo-18383: don’t duplicate warning filters when the warnings module is reloaded (thing usually only done in unit tests).

  • bpo-20572: Remove the subprocess.Popen.wait endtime parameter. It was deprecated in 3.4 and undocumented prior to that.

  • bpo-25659: In ctypes, prevent a crash calling the from_buffer() and from_buffer_copy() methods on abstract classes like Array.

  • bpo-28548: In the «http.server» module, parse the protocol version if possible, to avoid using HTTP 0.9 in some error responses.

  • bpo-19717: Makes Path.resolve() succeed on paths that do not exist. Patch by Vajrasky Kok

  • bpo-28563: Fixed possible DoS and arbitrary code execution when handle plural form selections in the gettext module. The expression parser now supports exact syntax supported by GNU gettext.

  • bpo-28387: Fixed possible crash in _io.TextIOWrapper deallocator when the garbage collector is invoked in other thread. Based on patch by Sebastian Cufre.

  • bpo-27517: LZMA compressor and decompressor no longer raise exceptions if given empty data twice. Patch by Benjamin Fogle.

  • bpo-28549: Fixed segfault in curses’s addch() with ncurses6.

  • bpo-28449: tarfile.open() with mode «r» or «r:» now tries to open a tar file with compression before trying to open it without compression. Otherwise it had 50% chance failed with ignore_zeros=True.

  • bpo-23262: The webbrowser module now supports Firefox 36+ and derived browsers. Based on patch by Oleg Broytman.

  • bpo-24241: The webbrowser in an X environment now prefers using the default browser directly. Also, the webbrowser register() function now has a documented “preferred” argument, to specify browsers to be returned by get() with no arguments. Patch by David Steele

  • bpo-27939: Fixed bugs in tkinter.ttk.LabeledScale and tkinter.Scale caused by representing the scale as float value internally in Tk. tkinter.IntVar now works if float value is set to underlying Tk variable.

  • bpo-28255: calendar.TextCalendar.prweek() no longer prints a space after a weeks’s calendar. calendar.TextCalendar.pryear() no longer prints redundant newline after a year’s calendar. Based on patch by Xiang Zhang.

  • bpo-28255: calendar.TextCalendar.prmonth() no longer prints a space at the start of new line after printing a month’s calendar. Patch by Xiang Zhang.

  • bpo-20491: The textwrap.TextWrapper class now honors non-breaking spaces. Based on patch by Kaarle Ritvanen.

  • bpo-28353: os.fwalk() no longer fails on broken links.

  • bpo-28430: Fix iterator of C implemented asyncio.Future doesn’t accept non-None value is passed to it.send(val).

  • bpo-27025: Generated names for Tkinter widgets now start by the «!» prefix for readability.

  • bpo-25464: Fixed HList.header_exists() in tkinter.tix module by addin a workaround to Tix library bug.

  • bpo-28488: shutil.make_archive() no longer adds entry «./» to ZIP archive.

  • bpo-25953: re.sub() now raises an error for invalid numerical group reference in replacement template even if the pattern is not found in the string. Error message for invalid group reference now includes the group index and the position of the reference. Based on patch by SilentGhost.

  • bpo-28469: timeit now uses the sequence 1, 2, 5, 10, 20, 50,… instead of 1, 10, 100,… for autoranging.

  • bpo-28115: Command-line interface of the zipfile module now uses argparse. Added support of long options.

  • bpo-18219: Optimize csv.DictWriter for large number of columns. Patch by Mariatta Wijaya.

  • bpo-28448: Fix C implemented asyncio.Future didn’t work on Windows.

  • bpo-23214: In the «io» module, the argument to BufferedReader and BytesIO’s read1() methods is now optional and can be -1, matching the BufferedIOBase specification.

  • bpo-28480: Fix error building socket module when multithreading is disabled.

  • bpo-28240: timeit: remove -c/--clock and -t/--time command line options which were deprecated since Python 3.3.

  • bpo-28240: timeit now repeats the benchmarks 5 times instead of only 3 to make benchmarks more reliable.

  • bpo-28240: timeit autorange now uses a single loop iteration if the benchmark takes less than 10 seconds, instead of 10 iterations. «python3 -m timeit -s “import time” “time.sleep(1)”» now takes 4 seconds instead of 40 seconds.

  • Distutils.sdist now looks for README and setup.py files with case sensitivity. This behavior matches that found in Setuptools 6.0 and later. See setuptools 100 for rationale.

  • bpo-24452: Make webbrowser support Chrome on Mac OS X. Patch by Ned Batchelder.

  • bpo-20766: Fix references leaked by pdb in the handling of SIGINT handlers.

  • bpo-27998: Fixed bytes path support in os.scandir() on Windows. Patch by Eryk Sun.

  • bpo-28317: The disassembler now decodes FORMAT_VALUE argument.

  • bpo-28380: unittest.mock Mock autospec functions now properly support assert_called, assert_not_called, and assert_called_once.

  • bpo-28229: lzma module now supports pathlib.

  • bpo-28321: Fixed writing non-BMP characters with binary format in plistlib.

  • bpo-28225: bz2 module now supports pathlib. Initial patch by Ethan Furman.

  • bpo-28227: gzip now supports pathlib. Patch by Ethan Furman.

  • bpo-28332: Deprecated silent truncations in socket.htons and socket.ntohs. Original patch by Oren Milman.

  • bpo-27358: Optimized merging var-keyword arguments and improved error message when passing a non-mapping as a var-keyword argument.

  • bpo-28257: Improved error message when passing a non-iterable as a var-positional argument. Added opcode BUILD_TUPLE_UNPACK_WITH_CALL.

  • bpo-28322: Fixed possible crashes when unpickle itertools objects from incorrect pickle data. Based on patch by John Leitch.

  • bpo-28228: imghdr now supports pathlib.

  • bpo-28226: compileall now supports pathlib.

  • bpo-28314: Fix function declaration (C flags) for the getiterator() method of xml.etree.ElementTree.Element.

  • bpo-28148: Stop using localtime() and gmtime() in the time module. Introduced platform independent _PyTime_localtime API that is similar to POSIX localtime_r, but available on all platforms. Patch by Ed Schouten.

  • bpo-28253: Fixed calendar functions for extreme months: 0001-01 and 9999-12. Methods itermonthdays() and itermonthdays2() are reimplemented so that they don’t call itermonthdates() which can cause datetime.date under/overflow.

  • bpo-28275: Fixed possible use after free in the decompress() methods of the LZMADecompressor and BZ2Decompressor classes. Original patch by John Leitch.

  • bpo-27897: Fixed possible crash in sqlite3.Connection.create_collation() if pass invalid string-like object as a name. Patch by Xiang Zhang.

  • bpo-18844: random.choices() now has k as a keyword-only argument to improve the readability of common cases and come into line with the signature used in other languages.

  • bpo-18893: Fix invalid exception handling in Lib/ctypes/macholib/dyld.py. Patch by Madison May.

  • bpo-27611: Fixed support of default root window in the tkinter.tix module. Added the master parameter in the DisplayStyle constructor.

  • bpo-27348: In the traceback module, restore the formatting of exception messages like «Exception: None». This fixes a regression introduced in 3.5a2.

  • bpo-25651: Allow false values to be used for msg parameter of subTest().

  • bpo-27778: Fix a memory leak in os.getrandom() when the getrandom() is interrupted by a signal and a signal handler raises a Python exception.

  • bpo-28200: Fix memory leak on Windows in the os module (fix path_converter() function).

  • bpo-25400: RobotFileParser now correctly returns default values for crawl_delay and request_rate. Initial patch by Peter Wirtz.

  • bpo-27932: Prevent memory leak in win32_ver().

  • Fix UnboundLocalError in socket._sendfile_use_sendfile.

  • bpo-28075: Check for ERROR_ACCESS_DENIED in Windows implementation of os.stat(). Patch by Eryk Sun.

  • bpo-22493: Warning message emitted by using inline flags in the middle of regular expression now contains a (truncated) regex pattern. Patch by Tim Graham.

  • bpo-25270: Prevent codecs.escape_encode() from raising SystemError when an empty bytestring is passed.

  • bpo-28181: Get antigravity over HTTPS. Patch by Kaartic Sivaraam.

  • bpo-25895: Enable WebSocket URL schemes in urllib.parse.urljoin. Patch by Gergely Imreh and Markus Holtermann.

  • bpo-28114: Fix a crash in parse_envlist() when env contains byte strings. Patch by Eryk Sun.

  • bpo-27599: Fixed buffer overrun in binascii.b2a_qp() and binascii.a2b_qp().

  • bpo-27906: Fix socket accept exhaustion during high TCP traffic. Patch by Kevin Conway.

  • bpo-28174: Handle when SO_REUSEPORT isn’t properly supported. Patch by Seth Michael Larson.

  • bpo-26654: Inspect functools.partial in asyncio.Handle.__repr__. Patch by iceboy.

  • bpo-26909: Fix slow pipes IO in asyncio. Patch by INADA Naoki.

  • bpo-28176: Fix callbacks race in asyncio.SelectorLoop.sock_connect.

  • bpo-27759: Fix selectors incorrectly retain invalid file descriptors. Patch by Mark Williams.

  • bpo-28325: Remove vestigial MacOS 9 macurl2path module and its tests.

  • bpo-28368: Refuse monitoring processes if the child watcher has no loop attached. Patch by Vincent Michel.

  • bpo-28369: Raise RuntimeError when transport’s FD is used with add_reader, add_writer, etc.

  • bpo-28370: Speedup asyncio.StreamReader.readexactly. Patch by Коренберг Марк.

  • bpo-28371: Deprecate passing asyncio.Handles to run_in_executor.

  • bpo-28372: Fix asyncio to support formatting of non-python coroutines.

  • bpo-28399: Remove UNIX socket from FS before binding. Patch by Коренберг Марк.

  • bpo-27972: Prohibit Tasks to await on themselves.

  • bpo-24142: Reading a corrupt config file left configparser in an invalid state. Original patch by Florian Höch.

  • bpo-29581: ABCMeta.__new__ now accepts **kwargs, allowing abstract base classes to use keyword parameters in __init_subclass__. Patch by Nate Soares.

  • bpo-25532: inspect.unwrap() will now only try to unwrap an object sys.getrecursionlimit() times, to protect against objects which create a new object on every attribute access.

  • bpo-30177: path.resolve(strict=False) no longer cuts the path after the first element not present in the filesystem. Patch by Antoine Pietri.

Documentation

  • bpo-31294: Fix incomplete code snippet in the ZeroMQSocketListener and ZeroMQSocketHandler examples and adapt them to Python 3.

  • bpo-21649: Add RFC 7525 and Mozilla server side TLS links to SSL documentation.

  • bpo-31128: Allow the pydoc server to bind to arbitrary hostnames.

  • bpo-30803: Clarify doc on truth value testing. Original patch by Peter Thomassen.

  • bpo-30176: Add missing attribute related constants in curses documentation.

  • bpo-30052: the link targets for bytes() and bytearray() are now their respective type definitions, rather than the corresponding builtin function entries. Use bytes and bytearray to reference the latter. In order to ensure this and future cross-reference updates are applied automatically, the daily documentation builds now disable the default output caching features in Sphinx.

  • bpo-26985: Add missing info of code object in inspect documentation.

  • bpo-19824: Improve the documentation for, and links to, template strings by emphasizing their utility for internationalization, and by clarifying some usage constraints. (See also: bpo-20314, bpo-12518)

  • bpo-28929: Link the documentation to its source file on GitHub.

  • bpo-25008: Document smtpd.py as effectively deprecated and add a pointer to aiosmtpd, a third-party asyncio-based replacement.

  • bpo-26355: Add canonical header link on each page to corresponding major version of the documentation. Patch by Matthias Bussonnier.

  • bpo-29349: Fix Python 2 syntax in code for building the documentation.

  • bpo-23722: The data model reference and the porting section in the 3.6 What’s New guide now cover the additional __classcell__ handling needed for custom metaclasses to fully support PEP 487 and zero-argument super().

  • bpo-28513: Documented command-line interface of zipfile.

Tests

  • bpo-29639: test.support.HOST is now «localhost», a new HOSTv4 constant has been added for your 127.0.0.1 needs, similar to the existing HOSTv6 constant.

  • bpo-31320: Silence traceback in test_ssl

  • bpo-31346: Prefer PROTOCOL_TLS_CLIENT and PROTOCOL_TLS_SERVER protocols for SSLContext.

  • bpo-25674: Remove sha256.tbs-internet.com ssl test

  • bpo-30715: Address ALPN callback changes for OpenSSL 1.1.0f. The latest version behaves like OpenSSL 1.0.2 and no longer aborts handshake.

  • bpo-30822: regrtest: Exclude tzdata from regrtest –all. When running the test suite using –use=all / -u all, exclude tzdata since it makes test_datetime too slow (15-20 min on some buildbots) which then times out on some buildbots. Fix also regrtest command line parser to allow passing -u extralargefile to run test_zipfile64.

  • bpo-30695: Add the set_nomemory(start, stop) and remove_mem_hooks() functions to the _testcapi module.

  • bpo-30357: test_thread: setUp() now uses support.threading_setup() and support.threading_cleanup() to wait until threads complete to avoid random side effects on following tests. Initial patch written by Grzegorz Grzywacz.

  • bpo-30197: Enhanced functions swap_attr() and swap_item() in the test.support module. They now work when delete replaced attribute or item inside the with statement. The old value of the attribute or item (or None if it doesn’t exist) now will be assigned to the target of the «as» clause, if there is one.

  • bpo-24932: Use proper command line parsing in _testembed

  • bpo-28950: Disallow -j0 to be combined with -T/-l in regrtest command line arguments.

  • bpo-28683: Fix the tests that bind() a unix socket and raise PermissionError on Android for a non-root user.

  • bpo-26936: Fix the test_socket failures on Android - getservbyname(), getservbyport() and getaddrinfo() are broken on some Android API levels.

  • bpo-28666: Now test.support.rmtree is able to remove unwritable or unreadable directories.

  • bpo-23839: Various caches now are cleared before running every test file.

  • bpo-26944: Fix test_posix for Android where “id -G” is entirely wrong or missing the effective gid.

  • bpo-28409: regrtest: fix the parser of command line arguments.

  • bpo-28217: Adds _testconsole module to test console input.

  • bpo-26939: Add the support.setswitchinterval() function to fix test_functools hanging on the Android armv7 qemu emulator.

Build

  • bpo-31354: Allow --with-lto to be used on all builds, not just make profile-opt.

  • bpo-31370: Remove support for building –without-threads. This option is not really useful anymore in the 21st century. Removing lots of conditional paths allows us to simplify the code base, including in difficult to maintain low-level internal code.

  • bpo-31341: Per PEP 11, support for the IRIX operating system was removed.

  • bpo-30854: Fix compile error when compiling –without-threads. Patch by Masayuki Yamamoto.

  • bpo-30687: Locate msbuild.exe on Windows when building rather than vcvarsall.bat

  • bpo-20210: Support the disabled marker in Setup files. Extension modules listed after this marker are not built at all, neither by the Makefile nor by setup.py.

  • bpo-29941: Add --with-assertions configure flag to explicitly enable C assert() checks. Defaults to off. --with-pydebug implies --with-assertions.