Changelog¶
Python 3.11.15 final¶
Release date: 2026-03-03
Security¶
gh-144125:
BytesGeneratorwill now refuse to serialize (write) headers that are unsafely folded or delimited; seeverify_generated_headers. (Contributed by Bas Bloemsaat and Petr Viktorin in gh-121650).gh-143935: Fixed a bug in the folding of comments when flattening an email message using a modern email policy. Comments consisting of a very long sequence of non-foldable characters could trigger a forced line wrap that omitted the required leading space on the continuation line, causing the remainder of the comment to be interpreted as a new header field. This enabled header injection with carefully crafted inputs.
gh-143925: Reject control characters in
data:URL media types.gh-143919: Reject control characters in
http.cookies.Morselfields and values.gh-143916: Reject C0 control characters within wsgiref.headers.Headers fields, values, and parameters.
gh-142145: Remove quadratic behavior in
xml.minidomnode ID cache clearing. In order to do this without breaking existing users, we also add the ownerDocument attribute toxml.dom.minidomelements and attributes created by directly instantiating theElementorAttrclass. Note that this way of creating nodes is not supported; creator functions likexml.dom.Document.documentElement()should be used instead.gh-137836: Add support of the “plaintext” element, RAWTEXT elements “xmp”, “iframe”, “noembed” and “noframes”, and optionally RAWTEXT element “noscript” in
html.parser.HTMLParser.gh-136063:
email.message: ensure linear complexity for legacy HTTP parameters parsing. Patch by Bénédikt Tran.gh-136065: Fix quadratic complexity in
os.path.expandvars().gh-119451: Fix a potential memory denial of service in the
http.clientmodule. When connecting to a malicious server, it could cause an arbitrary amount of memory to be allocated. This could have led to symptoms including aMemoryError, swapping, out of memory (OOM) killed processes or containers, or even system crashes.gh-119452: Fix a potential memory denial of service in the
http.servermodule. When a malicious user is connected to the CGI server on Windows, it could cause an arbitrary amount of memory to be allocated. This could have led to symptoms including aMemoryError, swapping, out of memory (OOM) killed processes or containers, or even system crashes.gh-119342: Fix a potential memory denial of service in the
plistlibmodule. When reading a Plist file received from untrusted source, it could cause an arbitrary amount of memory to be allocated. This could have led to symptoms including aMemoryError, swapping, out of memory (OOM) killed processes or containers, or even system crashes.
Library¶
gh-144833: Fixed a use-after-free in
sslwhenSSL_new()returns NULL innewPySSLSocket(). The error was reported via a dangling pointer after the object had already been freed.gh-90949: Add
SetAllocTrackerActivationThreshold()andSetAllocTrackerMaximumAmplification()to xmlparser objects to prevent use of disproportional amounts of dynamic memory from within an Expat parser. Patch by Bénédikt Tran.
Core and Builtins¶
gh-120384: Fix an array out of bounds crash in
list_ass_subscript, which could be invoked via some specificly tailored input: including concurrent modification of a list object, where one thread assigns a slice and another clears it.gh-120298: Fix use-after free in
list_richcompare_implwhich can be invoked via some specificly tailored evil input.
Python 3.11.14 final¶
Release date: 2025-10-09
Security¶
gh-139700: Check consistency of the zip64 end of central directory record. Support records with “zip64 extensible data” if there are no bytes prepended to the ZIP file.
gh-139400:
xml.parsers.expat: Make sure that parent Expat parsers are only garbage-collected once they are no longer referenced by subparsers created byExternalEntityParserCreate(). Patch by Sebastian Pipping.gh-135661: Fix parsing start and end tags in
html.parser.HTMLParseraccording to the HTML5 standard.Whitespaces no longer accepted between
</and the tag name. E.g.</ script>does not end the script section.Vertical tabulation (
\v) and non-ASCII whitespaces no longer recognized as whitespaces. The only whitespaces are\t\n\r\fand space.Null character (U+0000) no longer ends the tag name.
Attributes and slashes after the tag name in end tags are now ignored, instead of terminating after the first
>in quoted attribute value. E.g.</script/foo=">"/>.Multiple slashes and whitespaces between the last attribute and closing
>are now ignored in both start and end tags. E.g.<a foo=bar/ //>.Multiple
=between attribute name and value are no longer collapsed. E.g.<a foo==bar>produces attribute “foo” with value “=bar”.
gh-135661: Fix CDATA section parsing in
html.parser.HTMLParseraccording to the HTML5 standard:] ]>and]] >no longer end the CDATA section. Add private method_set_support_cdata()which can be used to specify how to parse<[CDATA[— as a CDATA section in foreign content (SVG or MathML) or as a bogus comment in the HTML namespace.gh-102555: Fix comment parsing in
html.parser.HTMLParseraccording to the HTML5 standard.--!>now ends the comment.-- >no longer ends the comment. Support abnormally ended empty comments<-->and<--->.gh-135462: Fix quadratic complexity in processing specially crafted input in
html.parser.HTMLParser. End-of-file errors are now handled according to the HTML5 specs – comments and declarations are automatically closed, tags are ignored.gh-118350: Fix support of escapable raw text mode (elements “textarea” and “title”) in
html.parser.HTMLParser.gh-86155:
html.parser.HTMLParser.close()no longer loses data when the<script>tag is not closed. Patch by Waylan Limberg.
Library¶
Python 3.11.13 final¶
Release date: 2025-06-03
Security¶
gh-135034: Fixes multiple issues that allowed
tarfileextraction filters (filter="data"andfilter="tar") to be bypassed using crafted symlinks and hard links.Addresses CVE 2024-12718, CVE 2025-4138, CVE 2025-4330, and CVE 2025-4517.
gh-133767: Fix use-after-free in the “unicode-escape” decoder with a non-“strict” error handler.
gh-128840: Short-circuit the processing of long IPv6 addresses early in
ipaddressto prevent excessive memory consumption and a minor denial-of-service.
Library¶
gh-128840: Fix parsing long IPv6 addresses with embedded IPv4 address.
gh-134062:
ipaddress: fix collisions in__hash__()forIPv4NetworkandIPv6Networkobjects.gh-123409: Fix
ipaddress.IPv6Address.reverse_pointeroutput according to RFC 3596, §2.5. Patch by Bénédikt Tran.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.
Python 3.11.12 final¶
Release date: 2025-04-08
Security¶
gh-131809: Update bundled libexpat to 2.7.1
gh-131261: Upgrade to libexpat 2.7.0
gh-105704: When using
urllib.parse.urlsplit()andurllib.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-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.
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
imaplibmodule. 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 aMemoryErroror 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¶
Documentation¶
gh-121277: Writers of CPython’s documentation can now use
nextas the version for theversionchanged,versionadded,deprecateddirectives.
C API¶
gh-106883: Disable GC during the _PyThread_CurrentFrames() and _PyThread_CurrentExceptions() calls to avoid the interpreter to deadlock.
Python 3.11.11 final¶
Release date: 2024-12-03
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¶
Security¶
Library¶
Python 3.11.10 final¶
Release date: 2024-09-07
Windows¶
Security¶
gh-123678: Upgrade libexpat to 2.6.3
gh-121957: Fixed missing audit events around interactive use of Python, now also properly firing for
python -i, as well as forpython -m asyncio. The event in question iscpython.run_stdin.gh-122133: Authenticate the socket connection for the
socket.socketpair()fallback on platforms whereAF_UNIXis 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-121285: Remove backtracking from tarfile header parsing for
hdrcharset, PAX, and GNU sparse headers.gh-118486:
os.mkdir()on Windows now accepts mode of0o700to restrict the new directory to the current user. This fixes CVE-2024-4030 affectingtempfile.mkdtemp()in scenarios where the base temporary directory is more permissive than the default.gh-116741: Update bundled libexpat to 2.6.2
Library¶
gh-123270: Applied a more surgical fix for malformed payloads in
zipfile.Pathcausing infinite loops (gh-122905) without breaking contents using legitimate characters.gh-123067: Fix quadratic complexity in parsing
"-quoted cookie values with backslashes byhttp.cookies.gh-122905:
zipfile.Pathobjects now sanitize names from the zipfile.gh-121650:
emailheaders with embedded newlines are now quoted on output. Thegeneratorwill now refuse to serialize (write) headers that are unsafely folded or delimited; seeverify_generated_headers. (Contributed by Bas Bloemsaat and Petr Viktorin in gh-121650.)gh-119506: Fix
io.TextIOWrapper.write()method breaks internal buffer when the method is called again during flushing internal buffer.gh-118643: Fix an AttributeError in the
emailmodule when re-fold a long address list. Also fix more cases of incorrect encoding of the address separator in the address list.gh-113171: Fixed various false positives and false negatives in
ipaddress.IPv4Address.is_private(see these docs for details)
Also in the corresponding
ipaddress.IPv4Networkandipaddress.IPv6Networkattributes.gh-102988:
email.utils.getaddresses()andemail.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: usestrict=Falseto get the old behavior, accept malformed inputs.getattr(email.utils, 'supports_strict_parsing', False)can be use to check if the strict paramater is available. Patch by Thomas Dwyer and Victor Stinner to improve the CVE-2023-27043 fix.gh-67693: Fix
urllib.parse.urlunparse()andurllib.parse.urlunsplit()for URIs with path starting with multiple slashes and no authority. Based on patch by Ashwin Ramaswami.
Core and Builtins¶
Python 3.11.9 final¶
Release date: 2024-04-02
Security¶
gh-115398: Allow controlling Expat >=2.6.0 reparse deferral (CVE-2023-52425) by adding five new methods:
gh-115399: Update bundled libexpat to 2.6.0
gh-115243: Fix possible crashes in
collections.deque.index()when the deque is concurrently modified.gh-114572:
ssl.SSLContext.cert_store_stats()andssl.SSLContext.get_ca_certs()now correctly lock access to the certificate store, when thessl.SSLContextis shared across multiple threads.
Core and Builtins¶
gh-116296: Fix possible refleak in
object.__reduce__()internal error handling.gh-116034: Fix location of the error on a failed assertion.
gh-115823: Properly calculate error ranges in the parser when raising
SyntaxErrorexceptions caused by invalid byte sequences. Patch by Pablo Galindogh-112087: For an empty reverse iterator for list will be reduced to
reversed(). Patch by Donghee Na.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 forint.gh-96497: Fix incorrect resolution of mangled class variables used in assignment expressions in comprehensions.
Library¶
gh-117310: Fixed an unlikely early & extra
Py_DECREFtriggered crash insslwhen creating a new_ssl._SSLContextif 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 CSSL_CTX_set_cipher_list()API.gh-117178: Fix regression in lazy loading of self-referential modules, introduced in gh-114781.
gh-117084: Fix
zipfileextraction for directory entries with the name containing backslashes on Windows.gh-117110: Fix a bug that prevents subclasses of
typing.Anyto be instantiated with arguments. Patch by Chris Fu.gh-90872: On Windows,
subprocess.Popen.wait()no longer callsWaitForSingleObject()with a negative timeout: pass0ms 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-90095: Ignore empty lines and comments in
.pdbrcgh-116764: Restore support of
Noneand other false values inurllib.parsefunctionsparse_qs()andparse_qsl(). Also, they now raise a TypeError for non-zero integers and non-empty sequences.gh-116811: In
PathFinder.invalidate_caches, delegate toMetadataPathFinder.invalidate_caches.gh-116484: Change automatically generated
tkinter.Checkbuttonwidget names to avoid collisions with automatically generatedtkinter.ttk.Checkbuttonwidget names within the same parent widget.gh-116401: Fix blocking
os.fwalk()andshutil.rmtree()on opening named pipe.gh-116143: Fix a race in pydoc
_start_server, eliminating a window in which_start_servercan return a thread that is “serving” but without adocserverset.gh-116325:
typing: raiseSyntaxErrorinstead ofAttributeErroron forward references as empty strings.gh-90535: Fix support of interval values > 1 in
logging.TimedRotatingFileHandlerforwhen='MIDNIGHT'andwhen='Wx'.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.TimedRotatingFileHandlerhandler.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__toNonewhen running a script withpdbgh-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 thereplaceerror handler.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 aswith (x() if y else z()): ...) as invalid syntax iffeature_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-115809: Improve algorithm for computing which rolled-over log files to delete in
logging.TimedRotatingFileHandler. It is now reliable for handlers withoutnamerand with arbitrary deterministicnamerthat leaves the datetime part in the file name unmodified.gh-74668:
urllib.parsefunctionsparse_qs()andparse_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:
csv.writer()now quotes empty fields if delimiter is a space and skipinitialspace is true and raises exception if quoting is not possible.gh-115618: Fix improper decreasing the reference count for
Noneargument inpropertymethodsgetter(),setter()anddeleter().gh-115570: A
DeprecationWarningis no longer omitted on access to the__doc__attributes of the deprecatedtyping.ioandtyping.repseudo-modules.gh-112006: Fix
inspect.unwrap()for types with the__wrapper__data descriptor.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 ininspect.Signature.from_callable().gh-115392: Fix a bug in
doctestwhere incorrect line numbers would be reported for decorated functions.gh-114563: Fix several
format()bugs when using the C implementation ofDecimal: * memory leak in some rare cases when using thezformat option (coerce negative 0) * incorrect output when applying thezformat option to typeF(fixed-point with capitalNAN/INF) * incorrect output when applying the#format option (alternate form)gh-115197:
urllib.requestno longer resolves the hostname before checking it against the system’s proxy bypass list on macOS and Windows.gh-115165: Most exceptions are now ignored when attempting to set the
__orig_class__attribute on objects returned when callingtypinggeneric aliases (including generic aliases created usingtyping.Annotated). Previously onlyAttributeErrorwas ignored. Patch by Dave Shawley.gh-115133: Fix tests for
XMLPullParserwith 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 recursiveglob().gh-114763: Protect modules loaded with
importlib.util.LazyLoaderfrom race conditions when multiple threads try to access attributes before the loading is complete.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-112281: Allow creating union of types for
typing.Annotatedwith unhashable metadata.gh-111775: Fix
importlib.resources.simple.ResourceHandle.open()for text mode, added missedstreamargument.gh-90095: Make .pdbrc and -c work with any valid pdb commands.
gh-107155: Fix incorrect output of
help(x)wherexis alambdafunction, which has an__annotations__dictionary attribute with a"return"key.gh-105866: Fixed
_get_slotsbug which caused error when defining dataclasses with slots and a weakref_slot.gh-60346: Fix ArgumentParser inconsistent with parse_known_args.
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
argparsewhen all options in a mutually exclusive group are suppressed.gh-93205: Fixed a bug in
logging.handlers.TimedRotatingFileHandlerwhere multiple rotating handler instances pointing to files with the same name but different extensions would conflict and not delete the correct files.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.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-33775: Add ‘default’ and ‘version’ help text for localization in argparse.
Documentation¶
gh-115399: Document CVE-2023-52425 of Expat <2.6.0 under “XML vulnerabilities”.
gh-115233: Fix an example for
LoggerAdapterin the Logging Cookbook.
Tests¶
gh-83434: Disable JUnit XML output (
--junit-xml=FILEcommand line option) in regrtest when hunting for reference leaks (-Roption). Patch by Victor Stinner.gh-117187: Fix XML tests for vanilla Expat <2.6.0.
gh-115979: Update test_importlib so that it passes under WASI SDK 21.
gh-116307: Added import helper
isolated_modulesasCleanImportdoes not remove modules imported during the context.gh-115720: Leak tests (
-R,--huntrleaks) now show a summary of the number of leaks found in each iteration.gh-115122: Add
--bisectoption to regrtest test runner: run failed tests withtest.bisect_cmdto identify failing tests. Patch by Victor Stinner.gh-115596: Fix
ProgramPriorityTestsintest_ospermanently changing the process priority.gh-115198: Fix test_check_metadata_deprecate in distutils tests with a newer Docutils.
Build¶
Windows¶
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-115554: The installer now has more strict rules about updating the Python Launcher for Windows. 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 Launcher for Windows can now detect Python 3.13 when installed from the Microsoft Store, and will install Python 3.12 by default when
PYLAUNCHER_ALLOW_INSTALLis set.gh-115009: Update Windows installer to use SQLite 3.45.1.
IDLE¶
gh-88516: On macOS show a proxy icon in the title bar of editor windows to match platform behaviour.
Tools/Demos¶
gh-113516: Don’t set
LDSHAREDwhen building for WASI.
C API¶
gh-117021: Fix integer overflow in
PyLong_AsPid()on non-Windows 64-bit platforms.
Python 3.11.8 final¶
Release date: 2024-02-06
Security¶
gh-113659: Skip
.pthfiles with names starting with a dot or hidden file attribute.
Core and Builtins¶
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-114388: Fix a
RuntimeWarningemitted when assign an integer-like value that is not an instance ofintto an attribute that corresponds to a C struct member of type T_UINT and T_ULONG. Fix a doubleRuntimeWarningemitted when assign a negative integer value to an attribute that corresponds to a C struct member of type T_UINT.gh-89811: Check for a valid
tp_version_tagbefore performing bytecode specializations that rely on this value being usable.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-113566: Fix a 3.11-specific crash when the
reprof aFutureis requested after the module has already been garbage-collected.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-112716: Fix SystemError in the
importstatement and in__reduce__()methods of builtin types when__builtins__is not a dict.gh-105967: Workaround a bug in Apple’s macOS platform zlib library where
zlib.crc32()andbinascii.crc32()could produce incorrect results on multi-gigabyte inputs. Including when usingzipfileon zips containing large data.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.
Library¶
gh-114965: Update bundled pip to 24.0
gh-114959:
tarfileno longer ignores errors when trying to extract a directory on top of a file.gh-109475: Fix support of explicit option value “–” in
argparse(e.g.--option=--).gh-110190: Fix ctypes structs with array on Windows ARM64 platform by setting
MAX_STRUCT_SIZEto 32 in stgdict. Patch by Diego Russogh-113280: Fix a leak of open socket in rare cases when error occurred in
ssl.SSLSocketcreation.gh-77749:
email.policy.EmailPolicy.fold()now always encodes non-ASCII characters in headers ifutf8is false.gh-114492: Make the result of
termios.tcgetattr()reproducible on Alpine Linux. Previously it could leave a random garbage in some fields.gh-75128: Ignore an
OSErrorinasyncio.BaseEventLoop.create_server()when IPv6 is available but the interface cannot actually support it.gh-114257: Dismiss the
FileNotFounderror inctypes.util.find_library()and just returnNoneon Linux.gh-101438: Avoid reference cycle in ElementTree.iterparse. The iterator returned by
ElementTree.iterparsemay 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-104522:
OSErrorraised 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-109534: Fix a reference leak in
asyncio.selector_events.BaseSelectorEventLoopwhen SSL handshakes fail. Patch contributed by Jamie Phan.gh-114077: Fix possible
OverflowErrorinsocket.socket.sendfile()when pass count larger than 2 GiB on 32-bit platform.gh-114014: Fixed a bug in
fractions.Fractionwhere an invalid string usingdin the decimals part creates a different error compared to other invalid letters/characters. Patch by Jeremiah Gabriel Pascual.gh-113951: Fix the behavior of
tag_unbind()methods oftkinter.Textandtkinter.Canvasclasses 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-113877: Fix
tkintermethodwinfo_pathname()on 64-bit Windows.gh-113781: Silence unraisable AttributeError when warnings are emitted during Python finalization.
gh-113594: Fix
UnicodeEncodeErrorinemailwhen 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-85567: Fix resource warnings for unclosed files in
pickleandpickletoolscommand line interfaces.gh-101225: Increase the backlog for
multiprocessing.connection.Listenerobjects created bymultiprocessing.managerandmultiprocessing.resource_sharerto significantly reduce the risk of getting a connection refused error when creating amultiprocessing.connection.Connectionto them.gh-113543: Make sure that
webbrowser.MacOSXOSAScriptsendswebbrowser.openaudit 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-113358: Fix rendering tracebacks for exceptions with a broken
__getattr__.gh-113214: Fix an
AttributeErrorduring asyncio SSL protocol aborts in SSL-over-SSL scenarios.gh-113246: Update bundled pip to 23.3.2.
gh-113199: Make
http.client.HTTPResponse.read1andhttp.client.HTTPResponse.readlineclose IO after reading all data when content length is known. Patch by Illia Volochii.gh-113188: Fix
shutil.copymode()andshutil.copystat()on Windows. Previously they worked differenly 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-61648: Detect line numbers of properties in doctests.
gh-112559:
signal.signal()andsignal.getsignal()no longer callrepron callable handlers.asyncio.run()andasyncio.Runner.run()no longer callrepron the task results. Patch by Yilei Yang.gh-110190: Fix ctypes structs with array on PPC64LE platform by setting
MAX_STRUCT_SIZEto 64 in stgdict. Patch by Diego Russo.gh-79429: Ignore FileNotFoundError when remove a temporary directory in the multiprocessing finalizer.
gh-79325: Fix an infinite recursion error in
tempfile.TemporaryDirectory()cleanup on Windows.gh-110190: Fix ctypes structs with array on Arm platform by setting
MAX_STRUCT_SIZEto 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 insocket.if_indextoname()on 64-bit non-Windows platforms.gh-75666: Fix the behavior of
tkinterwidget’sunbind()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-110345: Show the Tcl/Tk patchlevel (rather than version) in
tkinter._test().gh-109858: Protect
zipfilefrom “quoted-overlap” zipbomb. It now raises BadZipFile when try to read an entry that overlaps with other entry or central directory.gh-38807: Fix race condition in
trace. Instead of checking if a directory exists and creating it, directly callos.makedirs()with the kwargexist_ok=True.gh-75705: Set unixfrom envelope in
mailbox.mboxandmailbox.MMDF.gh-105102: Allow
ctypes.Unionto be nested inctypes.Structurewhen 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-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-91133: Fix a bug in
tempfile.TemporaryDirectorycleanup, which now no longer dereferences symlinks when working around file system permission errors.bpo-43153: On Windows,
tempfile.TemporaryDirectorypreviously masked aPermissionErrorwithNotADirectoryErrorduring directory cleanup. It now correctly raisesPermissionErrorif errors are not ignored. Patch by Andrei Kulakov and Ken Jin.bpo-35332: The
shutil.rmtree()function now ignores errors when callingos.close()when ignore_errors isTrue, andos.close()no longer retried after error.bpo-35928:
io.TextIOWrappernow correctly handles the decoding buffer afterread()andwrite().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-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.
Documentation¶
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
asynciomodule contains code taken from v0.16.0 of the uvloop project, as well as the required MIT licensing information.
Tests¶
gh-109980: Fix
test_tarfile_vs_tarintest_shutilfor macOS, where system tar can include more information in the archive thanshutil.make_archive.gh-112769: The tests now correctly compare zlib version when
zlib.ZLIB_RUNTIME_VERSIONcontains non-integer suffixes. For example zlib-ng defines the version as1.3.0.zlib-ng.gh-105089: Fix
test.test_zipfile.test_core.TestWithDirectory.test_create_directory_with_writetest in AIX by doing a bitwise AND of 0xFFFF on mode , so that it will be in sync withzinfo.external_attrbpo-40648: Test modes that file can get with chmod() on Windows.
Build¶
gh-101778: Fix build error when there’s a dangling symlink in the directory containing
ffi.h.gh-112305: Fixed the
check-clean-srcstep performed on out of tree builds to detect errant$(srcdir)/Python/frozen_modules/*.hfiles and recommend appropriate source tree cleanup steps to get a working build again.bpo-11102: The
os.major(),os.makedev(), andos.minor()functions are now available on HP-UX v3.bpo-36351: Do not set ipv6type when cross-compiling.
Windows¶
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.exelauncher will no longer attempt to run the Microsoft Store redirector when launching a script containing a/usr/bin/envshebanggh-114096: Process privileges that are activated for creating directory junctions are now restored afterwards, avoiding behaviour changes in other parts of the program.
gh-113009:
multiprocessing: On Windows, fix a race condition inProcess.terminate(): no longer set thereturncodeattribute to always callWaitForSingleObject()inProcess.wait(). Previously, sometimes the process was still running afterTerminateProcess()even ifGetExitCodeProcess()is notSTILL_ACTIVE. Patch by Victor Stinner.gh-87868: Correctly sort and remove duplicate environment variables in
_winapi.CreateProcess().bpo-37308: Fix mojibake in
mmap.mmapwhen using a non-ASCII tagname argument on Windows.
macOS¶
gh-115009: Update macOS installer to use SQLite 3.45.1.
gh-109991: Update macOS installer to use OpenSSL 3.0.13.
gh-74573: Document that
dbm.ndbmcan 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-102362: Make sure the result of
sysconfig.get_plaform()includes at least a major and minor versions, even ifMACOSX_DEPLOYMENT_TARGETis 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-109981: Use
/dev/fdon macOS to determine the number of open files intest.support.os_helper.fd_countto avoid a crash with “guarded” file descriptors when probing for open files.
IDLE¶
gh-96905: In idlelib code, stop redefining built-ins ‘dict’ and ‘object’.
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.
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.
bpo-13586: Enter the selected text when opening the “Replace” dialog.
Tools/Demos¶
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.
Python 3.11.7 final¶
Release date: 2023-12-04
Core and Builtins¶
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-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-109181: Speed up
Tracebackobject creation by lazily compute the line number. Patch by Pablo Galindogh-102388: Fix a bug where
iso2022_jp_3andiso2022_jp_2004codecs read out of boundsgh-111366: Fix an issue in the
codeopthat was causingSyntaxErrorexceptions raised in the presence of invalid syntax to not contain precise error messages. Patch by Pablo Galindogh-111380: Fix a bug that was causing
SyntaxWarningto appear twice when parsing if invalid syntax is encountered later. Patch by Pablo galindogh-88116: Traceback location ranges involving wide unicode characters (like emoji and asian characters) now are properly highlighted. Patch by Batuhan Taskaya and Pablo Galindo.
gh-94438: Fix a regression that prevented jumping across
is Noneandis not Nonewhen debugging. Patch by Savannah Ostrowski.gh-110696: Fix incorrect error message for invalid argument unpacking. Patch by Pablo Galindo
gh-110237: Fix missing error checks for calls to
PyList_Appendin_PyEval_MatchClass.
Library¶
gh-112618: Fix a caching bug relating to
typing.Annotated.Annotated[str, True]is no longer identical toAnnotated[str, 1].gh-112509: Fix edge cases that could cause a key to be present in both the
__required_keys__and__optional_keys__attributes of atyping.TypedDict. Patch by Jelle Zijlstra.gh-94722: Fix bug where comparison between instances of
DocTestfails if one of them hasNoneas its lineno.gh-112105: Make
readline.set_completer_delims()work with libeditgh-111942: Fix SystemError in the TextIOWrapper constructor with non-encodable “errors” argument in non-debug mode.
gh-109538: Issue warning message instead of having
RuntimeErrorbe displayed when event loop has already been closed atStreamWriter.__del__().gh-111942: Fix crashes in
io.TextIOWrapper.reconfigure()when pass invalid arguments, e.g. non-string encoding.gh-111804: Remove posix.fallocate() under WASI as the underlying posix_fallocate() is not available in WASI preview2.
gh-111841: Fix truncating arguments on an embedded null character in
os.putenv()andos.unsetenv()on Windows.gh-111541: Fix
doctestforSyntaxErrornot-builtin subclasses.gh-110894: Call loop exception handler for exceptions in
client_connected_cbofasyncio.start_server()so that applications can handle it. Patch by Kumar Aditya.gh-111531: Fix reference leaks in
bind_class()andbind_all()methods oftkinterwidgets.gh-111356: Added
io.text_encoding(),io.DEFAULT_BUFFER_SIZE, andio.IncrementalNewlineDecodertoio.__all__.gh-68166: Remove mention of not supported “vsapi” element type in
tkinter.ttk.Style.element_create(). Add tests forelement_create()and otherttk.Stylemethods. Add examples forelement_create()in the documentation.gh-111251: Fix
_blake2not checking for errors when initializing.gh-111174: Fix crash in
io.BytesIO.getbuffer()called repeatedly for empty BytesIO.gh-111187: Postpone removal version for locale.getdefaultlocale() to Python 3.15.
gh-111159: Fix
doctestoutput comparison for exceptions with notes.gh-110910: Fix invalid state handling in
asyncio.TaskGroupandasyncio.Timeout. They now raise proper RuntimeError if they are improperly used and are left in consistent state after this.gh-111092: Make turtledemo run without default root enabled.
gh-110590: Fix a bug in
_sre.compile()whereTypeErrorwould be overwritten byOverflowErrorwhen the code argument was a list of non-ints.gh-65052: Prevent
pdbfrom crashing when trying to display undisplayable objectsgh-110519: Deprecation warning about non-integer number in
gettextnow alwais refers to the line in the user code where gettext function or method is used. Previously it could refer to a line ingettextcode.gh-110378:
contextmanager()andasynccontextmanager()context managers now close an invalid underlying generator object that yields more then one value.gh-110365: Fix
termios.tcsetattr()bug that was overwritting existing errors during parsing integers fromtermlist.gh-110196: Add
__reduce__method toIPv6Addressin order to keepscope_idgh-109747: Improve errors for unsupported look-behind patterns. Now re.error is raised instead of OverflowError or RuntimeError for too large width of look-behind pattern.
gh-109786: Fix possible reference leaks and crash when re-enter the
__next__()method ofitertools.pairwise.gh-108791: Improved error handling in
pdbcommand line interface, making it produce more concise error messages.gh-73561: Omit the interface scope from an IPv6 address when used as Host header by
http.client.gh-86826:
zipinfonow supports the full range of values in the TZ string determined by RFC 8536 and detects all invalid formats. Both Python and C implementations now raise exceptions of the same type on invalid data.bpo-41422: Fixed memory leaks of
pickle.Picklerandpickle.Unpicklerinvolving cyclic references via the internal memo mapping.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-35191: Fix unexpected integer truncation in
socket.setblocking()which caused it to interpret multiples of2**32asFalse.
Documentation¶
Tests¶
gh-110367: Make regrtest
--verbose3option compatible with--huntrleaks -jNoptions. The./python -m test -j1 -R 3:3 --verbose3command now works as expected. Patch by Victor Stinner.gh-111165: Remove no longer used functions
run_unittest()andrun_doctest()and classBasicTestRunnerfrom thetest.supportmodule.gh-110932: Fix regrtest if the
SOURCE_DATE_EPOCHenvironment 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,--matchfileand--ignorefileare now tested in the order of specification, and the last match determines whether the test case be run or ignored.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-110267: Add tests for pickling and copying PyStructSequence objects. Patched by Xuehai Pan.
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-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-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 PCis found. Patch by Victor Stinner.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.
Build¶
Windows¶
macOS¶
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-109286: Update macOS installer to use SQLite 3.43.1.
gh-71383: Update macOS installer to include an upstream Tcl/Tk fix for the
ttk::ThemeChangederror 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.gh-99834: Update macOS installer to Tcl/Tk 8.6.13.
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.
C API¶
gh-112438: Fix support of format units “es”, “et”, “es#”, and “et#” in nested tuples in
PyArg_ParseTuple()-like functions.gh-109521:
PyImport_GetImporter()now sets RuntimeError if it fails to getsys.path_hooksorsys.path_importer_cacheor they are not list and dict correspondingly. Previously it could return NULL without setting error in obscure cases, crash or raise SystemError if these attributes have wrong type.
Python 3.11.6 final¶
Release date: 2023-10-02
Core and Builtins¶
gh-109351: Fix crash when compiling an invalid AST involving a named (walrus) expression.
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-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-108959: Fix caret placement for error locations for subscript and binary operations that involve non-semantic parentheses and spaces. Patch by Pablo Galindo
gh-108520: Fix
multiprocessing.synchronize.SemLock.__setstate__()to properly initializemultiprocessing.synchronize.SemLock._is_fork_ctx. This fixes a regression when passing a SemLock accross nested processes.Rename
multiprocessing.synchronize.SemLock.is_fork_ctxtomultiprocessing.synchronize.SemLock._is_fork_ctxto avoid exposing it as public API.
Library¶
gh-110036: On Windows, multiprocessing
Popen.terminate()now catchsPermissionErrorand get the process exit code. If the process is still running, raise again thePermissionError. 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-109631:
refunctions such asre.findall(),re.split(),re.search()andre.sub()which perform short repeated matches can now be interrupted by user.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-109613: Fix
os.stat()andos.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-109375: The
pdbaliascommand now prevents registering aliases without arguments.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-50644: Attempts to pickle or create a shallow or deep copy of
codecsstreams 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-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-108843: Fix an issue in
ast.unparse()when unparsing f-strings containing many quote types.gh-108682: Enum: raise
TypeErrorifsuper().__new__()is called from a custom__new__.gh-105829: Fix concurrent.futures.ProcessPoolExecutor deadlock
gh-64662: Fix support for virtual tables in
sqlite3.Connection.iterdump(). Patch by Aviv Palivoda.gh-107913: Fix possible losses of
errnoandwinerrorvalues inOSErrorexceptions if they were cleared or modified by the cleanup code before creating the exception object.gh-104372: On Linux where
subprocesscan use thevfork()syscall for faster spawning, prevent the parent process from blocking other threads by dropping the GIL while it waits for the vfork’ed child processexec()outcome. This prevents spawning a binary from a slow filesystem from blocking the rest of the application.gh-84867:
unittest.TestLoaderno longer loads test cases from exactunittest.TestCaseandunittest.FunctionTestCaseclasses.
Documentation¶
Tests¶
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_REStotest_asyncio.utils. Patch by Victor Stinner.gh-110033: Fix
test_interprocess_signal()oftest_signal. Make sure that thesubprocess.Popenobject is deleted before the test raising an exception in a signal handler. Otherwise,Popen.__del__()can get the exception which is logged asException 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 ot not. Keep the second future which does not complete before wait() timeout. 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-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-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 PCis found. Patch by Victor Stinner.gh-109237: Fix
test_site.test_underpth_basic()when the working directory contains at least one non-ASCII character: encode the._pthfile 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-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 withETIMEDOUTwhich such non standard configuration. Currently, the FreeBSD GCP image enables TCP and UDP blackhole (sysctl net.inet.tcp.blackhole=2andsysctl net.inet.udp.blackhole=1). Patch by Victor Stinner.gh-91960: Skip
test_gdbif 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 retrive the frame parameter of_PyEval_EvalFrameDefault(). In this case, tests likepy_bt()are likely to fail. Without getting access to Python frames,python-gdb.pyis mostly clueless on retrieving the Python traceback. Moreover,test_gdbis no longer skipped on macOS if Python is built with Clang. Patch by Victor Stinner.gh-108962: Skip
test_tempfile.test_flags()ifchflags()fails with “OSError: [Errno 45] Operation not supported” (ex: on FreeBSD 13). Patch by Victor Stinner.gh-89392: Removed support of
test_main()function in tests. They now always use normal unittest test runner.gh-108851: Fix
test_tomllibrecursion 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()andget_recursion_depth()functions to thetest.supportmodule. Patch by Victor Stinner.gh-108822:
regrtestnow computes statistics on all tests: successes, failures and skipped.test_netrc,test_pep646_syntaxandtest_xml_etreenow return results in theirtest_main()function. Patch by Victor Stinner and Alex Waygood.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-101634: When running the Python test suite with
-jNoption, 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-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-98903: The Python test suite now fails wit exit code 4 if no tests ran. It should help detecting typos in test names and test methods.
gh-95027: On Windows, when the Python test suite is run with the
-jNoption, 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-93353: regrtest now checks if a test leaks temporary files or directories if run with -jN option. Patch by Victor Stinner.
Build¶
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. Thedeepfreeze.csource 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.
Windows¶
macOS¶
gh-109991: Update macOS installer to use OpenSSL 3.0.11.
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.
Python 3.11.5 final¶
Release date: 2023-08-24
Security¶
gh-108310: Fixed an issue where instances of
ssl.SSLSocketwere 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.
Core and Builtins¶
gh-104432: Fix potential unaligned memory access on C APIs involving returned sequences of
char *pointers within thegrpandsocketmodules. These were revealed using a-fsaniziter=alignmentbuild on ARM macOS. Patch by Christopher Chavez.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-106092: Fix a segmentation fault caused by a use-after-free bug in
frame_deallocwhen the trashcan delays the deallocation of aPyFrameObject.gh-106719: No longer suppress arbitrary errors in the
__annotations__getter and setter in the type and module types.gh-106723: Propagate
frozen_modulesto multiprocessing spawned process interpreters.gh-105979: Fix crash in
_imp.get_frozen_object()due to improper exception handling.gh-105840: Fix possible crashes when specializing function calls with too many
__defaults__.gh-105588: Fix an issue that could result in crashes when compiling malformed
astnodes.gh-105375: Fix bugs in the
builtinsmodule 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-105235: Prevent out-of-bounds memory access during
mmap.find()calls.
Library¶
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-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-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 withLinkOutsideDestinationError.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-106684: Close
asyncio.StreamWriterwhen it is not closed by application leading to memory leaks. Patch by Kumar Aditya.gh-107077: Seems that in some conditions, OpenSSL will return
SSL_ERROR_SYSCALLinstead ofSSL_ERROR_SSLwhen a certification verification has failed, but the error parameters will still containERR_LIB_SSLandSSL_R_CERTIFICATE_VERIFY_FAILED. We are now detecting this situation and raising the appropiatessl.SSLCertVerificationError. Patch by Pablo Galindogh-107396: tarfiles; Fixed use before assignment of self.exception for gzip decompression
gh-62519: Make
gettext.pgettext()search plural definitions when translation is not found.gh-83006: Document behavior of
shutil.disk_usage()for non-mounted filesystems on Unix.gh-106186: Do not report
MultipartInvariantViolationDefectdefect when theemail.parser.Parserclass is used to parse emails withheadersonly=True.gh-106831: Fix potential missing
NULLcheck ofd2i_SSL_SESSIONresult in_ssl.c.gh-106774: Update the bundled copy of pip to version 23.2.1.
gh-106752: Fixed several bug in zipfile.Path in
name/suffix/suffixes/stemoperations when no filename is present and the Path is not at the root of the zipfile.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-106052:
remodule: 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-105497: Fix flag mask inversion when unnamed flags exist.
gh-90876: Prevent
multiprocessing.spawnfrom failing to import in environments wheresys.executableisNone. This regressed in 3.11 with the addition of support for path-like objects in multiprocessing.gh-106350: Detect possible memory allocation failure in the libtommath function
mp_init()used by the_tkintermodule.gh-102541: Make pydoc.doc catch bad module ImportError when output stream is not None.
gh-106263: Fix crash when calling
reprwith a manually constructed SignalDict object. Patch by Charlie Zhao.gh-105375: Fix a bug in
_Unpickler_SetInputStream()where an exception could end up being overwritten in case of failure.gh-105375: Fix bugs in
syswhere exceptions could end up being overwritten because of deferred error handling.gh-105605: Harden
pyexpaterror handling during module initialisation to prevent exceptions from possibly being overwritten, and objects from being dereferenced twice.gh-105375: Fix bug in
decimalwhere an exception could end up being overwritten.gh-105375: Fix bugs in
_datetimewhere exceptions could be overwritten in case of module initialisation failure.gh-105375: Fix bugs in
_sslinitialisation which could lead to leaked references and overwritten exceptions.gh-105375: Fix a bug in
array.arraywhere an exception could end up being overwritten.gh-105375: Fix bugs in
_ctypeswhere exceptions could end up being overwritten.gh-105375: Fix a bug in the
posixmodule where an exception could be overwritten.gh-105375: Fix bugs in
_elementtreewhere exceptions could be overwritten.gh-105375: Fix bugs in
zoneinfowhere exceptions could be overwritten.gh-105375: Fix bugs in
errnowhere exceptions could be overwritten.gh-105497: Fix flag inversion when alias/mask members exist.
gh-105375: Fix bugs in
picklewhere exceptions could be overwritten.gh-103171: Revert undocumented behaviour change with runtime-checkable protocols decorated with
typing.final()in Python 3.11. The behaviour change had meant that objects would not be considered instances of these protocols at runtime unless they had a__final__attribute. Patch by Alex Waygood.gh-105375: Fix a bug in
sqlite3where an exception could be overwritten in thecollationcallback.gh-105332: Revert pickling method from by-name back to by-value.
gh-104554: Add RTSPS scheme support in urllib.parse
gh-100061: Fix a bug that causes wrong matches for regular expressions with possessive qualifier.
gh-102541: Hide traceback in
help()prompt, when import failed.gh-99203: Restore following CPython <= 3.10.5 behavior of
shutil.make_archive(): do not create an empty archive ifroot_diris not a directory, and, in that case, raiseFileNotFoundErrororNotADirectoryErrorregardless offormatchoice. Beyond the brought-back behavior, the function may now also raise these exceptions indry_runmode.gh-94777: Fix hanging
multiprocessingProcessPoolExecutorwhen a child process crashes while data is being written in the call queue.bpo-18319: Ensure
gettext(msg)retrieve translations even if a plural form exists. In other words:gettext(msg) == ngettext(msg, '', 1).
Documentation¶
Tests¶
gh-105776: Fix test_cppext when the C compiler command
-std=c11option: remove-std=options from the compiler command. Patch by Victor Stinner.gh-107237:
test_logging: Fixtest_udp_reconnection()by increasing the timeout from 100 ms to 5 minutes (LONG_TIMEOUT). Patch by Victor Stinner.gh-101634: When running the Python test suite with
-jNoption, 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.
Build¶
gh-107814: When calling
find_python.batwith-qit did not properly silence the output of nuget. That is now fixed.gh-106881: Check for
linux/limits.hbefore including it inModules/posixmodule.c.gh-104692: Include
commoninstallas a prerequisite forbininstallThis ensures that
commoninstallis completed beforebininstallis started when parallel builds are used (make -j install), and so thepython3symlink is only installed after all standard library modules are installed.gh-100340: Allows -Wno-int-conversion for wasm-sdk 17 and onwards, thus enables building WASI builds once against the latest sdk.
Windows¶
gh-106242: Fixes
realpath()to behave consistently when passed a path containing an embedded null character on Windows. In strict mode, it now raisesOSErrorinstead of the unexpectedValueError, and in non-strict mode will make the path absolute.gh-106844: Fix integer overflow in
_winapi.LCMapStringEx()which affectsntpath.normcase().gh-99079: Update Windows build to use OpenSSL 3.0.9
gh-105436: Ensure that an empty environment block is terminated by two null characters, as is required by Windows.
macOS¶
Tools/Demos¶
gh-107565: Update multissltests and GitHub CI workflows to use OpenSSL 1.1.1v, 3.0.10, and 3.1.2.
gh-95065: Argument Clinic now supports overriding automatically generated signature by using directive
@text_signature. See the Argument Clinic docs.gh-106970: Fix bugs in the Argument Clinic
destination <name> clearcommand; the destination buffers would never be cleared, and thedestinationdirective parser would simply continue to the fault handler after processing the command. Patch by Erlend E. Aasland.
C API¶
gh-107916: C API functions
PyErr_SetFromErrnoWithFilename(),PyErr_SetExcFromWindowsErrWithFilename()andPyErr_SetFromWindowsErrWithFilename()save now the error code before callingPyUnicode_DecodeFSDefault().gh-107915: Such C API functions as
PyErr_SetString(),PyErr_Format(),PyErr_SetFromErrnoWithFilename()and many others no longer crash or ignore errors if it failed to format the error message or decode the filename. Instead, they keep a corresponding error.gh-107226:
PyModule_AddObjectRef()is now only available in the limited API version 3.10 or later.gh-105375: Fix a bug in
PyErr_WarnExplicit()where an exception could end up being overwritten if the API failed internally.gh-99612: Fix
PyUnicode_DecodeUTF8Stateful()for ASCII-only data:*consumedwas not set.
Python 3.11.4 final¶
Release date: 2023-06-06
Security¶
gh-103142: The version of OpenSSL used in our binary builds has been upgraded to 1.1.1u to address several CVEs.
gh-99889: Fixed a security in flaw in
uu.decode()that could allow for directory traversal based on the input if noout_filewas specified.gh-104049: Do not expose the local on-disk location in directory indexes produced by
http.client.SimpleHTTPRequestHandler.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-105164: Ensure annotations are set up correctly if the only annotation in a block is within a
matchblock. Patch by Jelle Zijlstra.gh-104615: Fix wrong ordering of assignments in code like
a, a = x, y. Contributed by Carl Meyer.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.setprofileandsys.settracetrampoline 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-104018: Disallow the “z” format specifier in %-format of bytes objects.
gh-103971: Fix an issue where incorrect locations numbers could be assigned to code following
caseblocks.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 anExceptionGroup.gh-101517: Fix bug in line numbers of instructions emitted for
except*.gh-103242: Migrate
set_ecdh_curve()method not to use deprecated OpenSSL APIs. Patch by Donghee Na.gh-102700: Allow built-in modules to be submodules. This allows submodules to be statically linked into a CPython binary.
gh-101857: Fix xattr support detection on Linux systems by widening the check to linux, not just glibc. This fixes support for musl.
gh-99184: Bypass instance attribute access of
__name__inreprofweakref.ref.gh-96670: The parser now raises
SyntaxErrorwhen parsing source code containing null bytes. Backported fromaab01e3. Patch by Pablo Galindobpo-31821: Fix
pause_reading()to work when called fromconnection_made()inasyncio.
Library¶
gh-105080: Fixed inconsistent signature on derived classes for
inspect.signature()gh-104874: Document the
__name__and__supertype__attributes oftyping.NewType. Patch by Jelle Zijlstra.gh-104340: When an
asynciopipe protocol loses its connection due to an error, and the caller doesn’t awaitwait_closed()on the correspondingStreamWriter, don’t log a warning about an exception that was never retrieved. After all, according to theStreamWriter.close()docs, thewait_closed()call is optional (“not mandatory”).gh-104372: Refactored the
_posixsubprocessinternals to avoid Python C API usage between fork and exec when markingpass_fds=file descriptors inheritable.gh-75367: Fix data descriptor detection in
inspect.getattr_static().gh-104536: Fix a race condition in the internal
multiprocessing.processcleanup logic that could manifest as an unintendedAttributeErrorwhen callingprocess.close().gh-104399: Prepare the
_tkintermodule for building with Tcl 9.0 and future libtommath by replacing usage of deprecated functionsmp_to_unsigned_bin_n()andmp_unsigned_bin_size()when necessary.gh-104307:
socket.getnameinfo()now releases the GIL while contacting the DNS servergh-87695: Fix issue where
pathlib.Path.glob()raisedOSErrorwhen it encountered a symlink to an overly long path.gh-104265: Prevent possible crash by disallowing instantiation of the
_csv.Readerand_csv.Writertypes. The regression was introduced in 3.10.0a4 with PR 23224 (bpo-14935). Patch by Radislav Chugunov.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-103935: Use
io.open_code()for files to be executed instead of rawopen()gh-100370: Fix potential
OverflowErrorinsqlite3.Connection.blobopen()for 32-bit builds. Patch by Erlend E. Aasland.gh-103848: Add checks to ensure that
[bracketed]hosts found byurllib.parse.urlsplit()are of IPv6 or IPvFuture format.gh-103872: Update the bundled copy of pip to version 23.1.2.
gh-103861: Fix
zipfile.Zipfilecreating invalid zip files whenforce_zip64was used to add files to them. Patch by Carey Metcalfe.gh-103685: Prepare
tkinter.Menu.index()for Tk 8.7 so that it does not raiseTclError: expected integer but got ""when it should returnNone.gh-81403:
urllib.request.CacheFTPHandlerno longer raisesURLErrorif a cached FTP instance is reused. ftplib’s endtransfer method calls voidresp to drain the connection to handle FTP instance reuse properly.gh-103578: Fixed a bug where
pdbcrashes when reading source file with different encoding by replacingio.open()withio.open_code(). The new method would also call into the hook set byPyFile_SetOpenCodeHook().gh-103556: Now creating
inspect.Signatureobjects 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-103365: Set default Flag boundary to
STRICTand fix bitwise operations.gh-103472: Avoid a potential
ResourceWarninginhttp.client.HTTPConnectionby closing the proxy / tunnel’s CONNECT response explicitly.gh-103449: Fix a bug in doc string generation in
dataclasses.dataclass().gh-103256: Fixed a bug that caused
hmacto raise an exception when the requested hash algorithm was not available in OpenSSL despite being available separately as part ofhashlibitself. 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 computehmac.digest(b'K', b'M', 'sha3_256').gh-103225: Fix a bug in
pdbwhen displaying line numbers of module-level source code.gh-93910: Remove deprecation of enum
memmber.memberaccess.gh-102978: Fixes
unittest.mock.patch()not enforcing function signatures for methods decorated with@classmethodor@staticmethodwhen patch is called withautospec=True.gh-103204: Fixes
http.serveraccepting HTTP requests with HTTP version numbers preceded by ‘+’, or ‘-’, or with digit-separating ‘_’ characters. The length of the version numbers is also constrained.gh-102953: The extraction methods in
tarfile, andshutil.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-101640:
argparse.ArgumentParsernow catches errors when writing messages, such as whensys.stderrisNone. Patch by Oleg Iarygin.gh-96522: Fix potential deadlock in pty.spawn()
gh-87474: Fix potential file descriptor leaks in
subprocess.Popen.
Documentation¶
gh-89455: Add missing documentation for the
max_group_depthandmax_group_widthparameters and theexceptionsattribute of thetraceback.TracebackExceptionclass.gh-89412: Add missing documentation for the
end_linenoandend_offsetattributes of thetraceback.TracebackExceptionclass.gh-104943: Remove mentions of old Python versions in
typing.NamedTuple.gh-67056: Document that the effect of registering or unregistering an
atexitcleanup function from within a registered cleanup function is undefined.gh-48241: Clarifying documentation about the url parameter to urllib.request.urlopen and urllib.request.Requst needing to be encoded properly.
Tests¶
gh-104494: Update
test_pack_configure_inandtest_place_configure_infor changes to error message formatting in Tk 8.7.gh-104461: Run test_configure_screen on X11 only, since the
DISPLAYenvironment variable and-screenoption for toplevels are not useful on Tk for Win32 or Aqua.gh-103329: Regression tests for the behaviour of
unittest.mock.PropertyMockwere added.gh-85984: Utilize new “winsize” functions from termios in pty tests.
gh-75729: Fix the
os.spawn*tests failing on Windows when the working directory or interpreter path contains spaces.
Build¶
gh-90005: Fix a regression in
configurewhere we could end up unintentionally linking withlibbsd.gh-104106: Add gcc fallback of mkfifoat/mknodat for macOS. Patch by Donghee Na.
gh-99069: Extended workaround defining
static_assertwhen missing from the libc headers to all clang and gcc builds. In particular, this fixes building on macOS <= 10.10.
Windows¶
gh-105146: Updated the links at the end of the installer to point to Discourse rather than the mailing lists.
gh-104623: Update Windows installer to use SQLite 3.42.0.
gh-102997: Update Windows installer to use SQLite 3.41.2.
gh-88013: Fixed a bug where
TypeErrorwas raised when callingntpath.realpath()with a bytes parameter in some cases.
macOS¶
IDLE¶
Python 3.11.3 final¶
Release date: 2023-04-04
Security¶
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-101283:
subprocess.Popennow uses a safer approach to findcmd.exewhen launching withshell=True. Patch by Eryk Sun, based on a patch by Oleg Iarygin.
Core and Builtins¶
gh-101975: Fixed
stacktopvalue on tracing entries to avoid corruption on garbage collection.gh-102701: Fix overflow when creating very large dict.
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-102397: Fix segfault from race condition in signal handling during garbage collection. Patch by Kumar Aditya.
gh-102281: Fix potential nullptr dereference and use of uninitialized memory in fileutils. Patch by Max Bachmann.
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: Fix SSE2 and SSE3 detection in
_blake2internal module. Patch by Max Bachmann.gh-101967: Fix possible segfault in
positional_only_passed_as_keywordfunction, when new list created.gh-101765: Fix SystemError / segmentation fault in iter
__reduce__when internal access ofbuiltins.__dict__keys mutates the iter object.gh-101696: Invalidate type version tag in
_PyStaticType_Deallocfor static types, avoiding bug where a false cache hit could crash the interpreter. Patch by Kumar Aditya.
Library¶
gh-102549: Don’t ignore exceptions in member type creation.
gh-102947: Improve traceback when
dataclasses.fields()is called on a non-dataclass. Patch by Alex Waygoodgh-102780: The
asyncio.Timeoutcontext manager now works reliably even when performing cleanup due to task cancellation. Previously it could raise aCancelledErrorinstead of anTimeoutErrorin such cases.gh-88965: typing: Fix a bug relating to substitution in custom classes generic over a
ParamSpec. Previously, if theParamSpecwas substituted with a parameters list that itself contained aTypeVar, theTypeVarin the parameters list could not be subsequently substituted. This is now fixed.Patch by Nikita Sobolev.
gh-101979: Fix a bug where parentheses in the
metavarargument toargparse.ArgumentParser.add_argument()were dropped. Patch by Yeojin Kim.gh-101961: For the binary mode,
fileinput.hookcompressed()doesn’t set theencodingvalue even if the value isNone. Patch by Gihwan Kim.gh-101936: The default value of
fpbecomesio.BytesIOifHTTPErroris initialized without a designatedfpparameter. Patch by Long Vo.gh-102069: Fix
__weakref__descriptor generation for custom dataclasses.gh-101566: In zipfile, apply fix for extractall on the underlying zipfile after being wrapped in
Path.gh-101892: Callable iterators no longer raise
SystemErrorwhen the callable object exhausts the iterator but forgets to either return a sentinel value or raiseStopIteration.gh-97786: Fix potential undefined behaviour in corner cases of floating-point-to-time conversions.
gh-101517: Fixed bug where
bdblooks up the source line withlinecachewith alineno=None, which causes it to fail with an unhandled exception.gh-101673: Fix a
pdbbug wherellclears the changes to local variables.gh-96931: Fix incorrect results from
ssl.SSLSocket.shared_ciphers()gh-88233: Correctly preserve “extra” fields in
zipfileregardless of their ordering relative to a zip64 “extra.”gh-96127:
inspect.signaturewas raisingTypeErroron call with mock objects. Now it correctly returns(*args, **kwargs)as infered signature.gh-95495: When built against OpenSSL 3.0, the
sslmodule had a bug where it reported unauthenticated EOFs (i.e. without close_notify) as a clean TLS-level EOF. It now raisesSSLEOFError, matching the behavior in previous versions of OpenSSL. Theoptionsattribute onSSLContextalso no longer includesOP_IGNORE_UNEXPECTED_EOFby default. This option may be set to specify the previous OpenSSL 3.0 behavior.gh-94440: Fix a
concurrent.futures.processbug whereProcessPoolExecutorshutdown could hang after a future has been quickly submitted and canceled.
Documentation¶
gh-103112: Add docstring to
http.client.HTTPResponse.read()to fixpydocoutput.gh-85417: Update
cmathdocumentation to clarify behaviour on branch cuts.gh-97725: Fix
asyncio.Task.print_stack()description forfile=None. Patch by Oleg Iarygin.
Tests¶
gh-102537: Adjust the error handling strategy in
test_zoneinfo.TzPathTest.python_tzpath_context. Patch by Paul Ganssle.gh-89792:
test_toolsnow copies up to 10x less source data to a temporary directory during thefreezetest 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.gh-101377: Improved test_locale_calendar_formatweekday of calendar.
Build¶
gh-102711: Fix
-Wstrict-prototypescompiler warnings.
Windows¶
gh-101849: Ensures installer will correctly upgrade existing
py.exelauncher 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.
macOS¶
Python 3.11.2 final¶
Release date: 2023-02-07
Core and Builtins¶
gh-92173: Fix the
defsandkwdefsarguments toPyEval_EvalCodeEx()and a reference leak in that function.gh-101400: Fix wrong lineno in exception message on
continueorbreakwhich 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-101046: Fix a possible memory leak in the parser when raising
MemoryError. Patch by Pablo Galindogh-101037: Fix potential memory underallocation issue for instances of
intsubclasses with value zero.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-100892: Fix race while iterating over thread states in clearing
threading.local. Patch by Kumar Aditya.gh-100776: Fix misleading default value in
input()’s__text_signature__.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-100374: Fix incorrect result and delay in
socket.getfqdn(). Patch by Dominic Socular.gh-99110: Initialize frame->previous in frameobject.c to fix a segmentation fault when accessing frames created by
PyFrame_New().gh-100050: Honor existing errors obtained when searching for mismatching parentheses in the tokenizer. Patch by Pablo Galindo
bpo-32782:
ctypesarrays of length 0 now report a correct itemsize when amemoryviewis constructed from them, rather than always giving a value of 0.
Library¶
gh-101541: [Enum] - fix psuedo-flag creation
gh-101326: Fix regression when passing
Noneas second or third argument toFutureIter.throw.gh-100795: Avoid potential unexpected
freeaddrinfocall (double free) insocketwhen when a libcgetaddrinfo()implementation leaves garbage in an output pointer when returning an error. Original patch by Sergey G. Brester.gh-101143: Remove unused references to
TimerHandleinasyncio.base_events.BaseEventLoop._add_callback.gh-101144: Make
zipfile.Path.open()andzipfile.Path.read_text()also acceptencodingas 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 aTypeError.gh-101015: Fix
typing.get_type_hints()on'*tuple[...]'and*tuple[...]. It must not drop theUnpackpart.gh-100573: Fix a Windows
asynciobug with named pipes where a client doingos.stat()on the pipe would cause an error in the server that disabled serving future requests.gh-100805: Modify
random.choice()implementation to once again work with NumPy arrays.gh-90104: Avoid RecursionError on
reprif a dataclass field definition has a cyclic reference.gh-100750: pass encoding kwarg to subprocess in platform
gh-100689: Fix crash in
pyexpatby statically allocatingPyExpat_CAPIcapsule.gh-100740: Fix
unittest.mock.Mocknot respecting the spec for attribute names prefixed withassert.gh-86508: Fix
asyncio.open_connection()to skip binding to local addresses of different family. Patch by Kumar Aditya.gh-100287: Fix the interaction of
unittest.mock.seal()withunittest.mock.AsyncMock.gh-100474:
http.servernow checks that an index page is actually a regular file before trying to serve it. This avoids issues with directories namedindex.html.gh-100160: Remove any deprecation warnings in
asyncio.get_event_loop(). They are deferred to Python 3.12.gh-96290: Fix handling of partial and invalid UNC drives in
ntpath.splitdrive(), and inntpath.normpath()on non-Windows systems. Paths such as ‘\server’ and ‘\’ are now considered bysplitdrive()to contain only a drive, and consequently are not modified bynormpath()on non-Windows systems. The behaviour ofnormpath()on Windows systems is unaffected, as native OS APIs are used. Patch by Eryk Sun, with contributions by Barney Gale.gh-78878: Fix crash when creating an instance of
_ctypes.CField.gh-99952: Fix a reference undercounting issue in
ctypes.Structurewithfrom_param()results larger than a C pointer.gh-100133: Fix regression in
asynciowhere a subprocess would sometimes lose data received from pipe.gh-100098: Fix
tuplesubclasses being cast totuplewhen used as enum values.gh-98778: Update
HTTPErrorto be initialized properly, even if thefpisNone. Patch by Donghee Na.gh-83035: Fix
inspect.getsource()handling of decorator calls with nested parentheses.gh-99576: Fix
.save()method forLWPCookieJarandMozillaCookieJar: saved file was not truncated on repeated save.gh-99433: Fix
doctestfailure ontypes.MethodWrapperTypein modules.gh-99240: Fix double-free bug in Argument Clinic
str_converterby extracting memory clean up to a newpost_parsingsection.gh-64490: Fix refcount error when arguments are packed to tuple in Argument Clinic.
gh-85267: Several improvements to
inspect.signature()’s handling of__text_signature. - Fixes a case whereinspect.signature()dropped parameters - Fixes a case whereinspect.signature()raisedtokenize.TokenError- Allowsinspect.signature()to understand defaults involving binary operations of constants -inspect.signature()is documented as only raisingTypeErrororValueError, but sometimes raisedRuntimeError. These cases now raiseValueError- Removed a dead code pathgh-95882: Fix a 3.11 regression in
asynccontextmanager(), which caused it to propagate exceptions with incorrect tracebacks and fix a 3.11 regression incontextmanager(), which caused it to propagate exceptions with incorrect tracebacks forStopIteration.bpo-44817: Ignore WinError 53 (ERROR_BAD_NETPATH), 65 (ERROR_NETWORK_ACCESS_DENIED) and 161 (ERROR_BAD_PATHNAME) when using ntpath.realpath().
bpo-40447: Accept
os.PathLike(such aspathlib.Path) in thestripdirarguments ofcompileall.compile_file()andcompileall.compile_dir().bpo-36880: Fix a reference counting issue when a
ctypescallback with return typepy_objectreturnsNone, which could cause crashes.
Documentation¶
gh-100616: Document existing
attrparameter tocurses.window.vline()function incurses.gh-100472: Remove claim in documentation that the
stripdir,prependdirandlimit_sl_destparameters ofcompileall.compile_dir()andcompileall.compile_file()could bebytes.gh-99931: Use sphinxext-opengraph to generate OpenGraph metadata.
Tests¶
Build¶
gh-101522: Allow overriding Windows dependencies versions and paths using MSBuild properties.
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.exelauncher now correctly filters when only a single runtime is installed. It also correctly handles prefix matches on tags so that-3.1does not match3.11, but would still match3.1-32.gh-101135: Restore ability to launch older 32-bit versions from the
py.exelauncher 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
PythonPathregistry 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.exelauncher finding shebang commands in its configuration file using the full command name.gh-100180: Update Windows installer to OpenSSL 1.1.1s
bpo-43984:
winreg.SetValueEx()now leaves the target value untouched in the case of conversion errors. Previously,-1would be written in case of such errors.
macOS¶
gh-100180: Update macOS installer to OpenSSL 1.1.1s
Tools/Demos¶
bpo-45256: Fix a bug that caused an
AttributeErrorto be raised inpython-gdb.pywhenpy-localsis used without a frame.gh-100342: Add missing
NULLcheck for possible allocation failure in*argsparsing in Argument Clinic.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
noptargsin generated code.Do not generate
noptargswhen there is a vararg argument and no optional argument.
C API¶
gh-99240: In argument parsing, after deallocating newly allocated memory, reset its pointer to NULL.
Python 3.11.1 final¶
Release date: 2022-12-06
Security¶
gh-100001:
python -m http.serverno 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.serverBaseHTTPRequestHandler.log_messagemethod to replace control characters with a\xHHhex escape before printing.gh-87604: Avoid publishing list of active per-interpreter audit hooks via the
gcmodulegh-98433: The IDNA codec decoder used on DNS hostnames by
socketorasynciorelated 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 asurllibhttp3xxredirects potentially allow for an attacker to supply such a name.gh-98739: Update bundled libexpat to 2.5.0
gh-97612: Fix a shell code injection vulnerability in the
get-remote-certificate.pyexample script. The script no longer uses a shell to runopensslcommands. Issue reported and initial fix by Caleb Shortt. Patch by Victor Stinner.
Core and Builtins¶
gh-99886: Fix a crash when an object which does not have a dictionary frees its instance values.
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-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-99578: Fix a reference bug in
_imp.create_builtin()after the creation of the first sub-interpreter for modulesbuiltinsandsys. Patch by Victor Stinner.gh-99581: Fixed a bug that was causing a buffer overflow if the tokenizer copies a line missing the newline caracter from a file that is as long as the available tokenizer buffer. Patch by Pablo galindo
gh-99553: Fix bug where an
ExceptionGroupsubclass can wrap aBaseException.gh-99370: Fix zip path for venv created from a non-installed python on POSIX platforms.
gh-99298: Fix an issue that could potentially cause incorrect error handling for some bytecode instructions.
gh-99205: Fix an issue that prevented
PyThreadStateandPyInterpreterStatememory from being freed properly.gh-99181: Fix failure in
except*with unhashable exceptions.gh-99204: Fix calculation of
sys._base_executablewhen 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
faulthandlerto emit an error message with the proper unexpected signal number. Patch by Donghee Na.gh-99153: Fix location of
SyntaxErrorfor atryblock with bothexceptandexcept*.gh-99103: Fix the error reporting positions of specialized traceback anchors when the source line contains Unicode characters.
gh-98852: Fix subscription of type aliases containing bare generic types or types like
TypeVar: for exampletuple[A, T][int]andtuple[TypeVar, T][int], whereAis a generic type, andTis a type variable.gh-98925: Lower the recursion depth for marshal on WASI to support wasmtime 2.0/main.
gh-98783: Fix multiple crashes in debug mode when
strsubclasses are used instead ofstritself.gh-99257: Fix an issue where member descriptors (such as those for
__slots__) could behave incorrectly or crash instead of raising aTypeErrorwhen accessed via an instance of an invalid type.gh-98374: Suppress ImportError for invalid query for help() command. Patch by Donghee Na.
gh-98415: Fix detection of MAC addresses for
uuidon certain OSs. Patch by Chaim Sandersgh-92119: Print exception class name instead of its string representation when raising errors from
ctypescalls.gh-96078:
os.sched_yield()now release the GIL while calling sched_yield(2). Patch by Donghee Na.gh-93354: Fix an issue that could delay the specialization of
PRECALLinstructions.gh-97943: Bugfix:
PyFunction_GetAnnotations()should return a borrowed reference. It was returning a new reference.gh-97779: Ensure that all Python frame objects are backed by “complete” frames.
gh-97591: Fixed a missing incref/decref pair in
Exception.__setstate__(). Patch by Ofey Chan.gh-94526: Fix the Python path configuration used to initialized
sys.pathat 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-95921: Fix overly-broad source position information for chained comparisons used as branching conditions.
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
SystemErrorif a line tracing event raises an exception while opcode tracing is enabled.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-95196: Disable incorrect pickling of the C implemented classmethod descriptors.
gh-96005: On WASI
ENOTCAPABLEis now mapped toPermissionError. Theerrnomodules exposes the new error number.getpath.pynow ignoresPermissionErrorwhen it cannot open landmark filespybuilddir.txtandpyenv.cfg.gh-93696: Allow
pdbto locate source for frozen modules in the standard library.bpo-31718: Raise
ValueErrorinstead ofSystemErrorwhen methods of uninitializedio.IncrementalNewlineDecoderobjects are called. Patch by Oren Milman.bpo-38031: Fix a possible assertion failure in
io.FileIOwhen 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 ambiguious as to if it is a hex replacement we put in or the characters r”x” came through in the original request line.
gh-93453:
asyncio.get_event_loop()now only emits a deprecation warning when a new event loop was created implicitly. It no longer emits a deprecation warning if the current event loop was set.gh-51524: Fix bug when calling trace.CoverageResults with valid infile.
gh-99645: Fix a bug in handling class cleanups in
unittest.TestCase. NowaddClassCleanup()uses separate lists for differentTestCasesubclasses, anddoClassCleanups()only cleans up the particular class.gh-97001: Release the GIL when calling termios APIs to avoid blocking threads.
gh-99341: Fix
ast.increment_lineno()to also coverast.TypeIgnorewhen changing line numbers.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-99382: Check the number of arguments in substitution in user generics containing a
TypeVarTupleand one or moreTypeVar.gh-99379: Fix substitution of
ParamSpecfollowed byTypeVarTuplein generic aliases.gh-99344: Fix substitution of
TypeVarTupleandParamSpectogether in user generics.gh-74044: Fixed bug where
inspect.signature()reported incorrect arguments for decorated methods.gh-99275: Fix
SystemErrorinctypeswhen exception was not set during__initsubclass__.gh-99277: Remove older version of
_SSLProtocolTransport.get_write_buffer_limitsinasyncio.sslprotogh-99248: fix negative numbers failing in verify()
gh-99155: Fix
statistics.NormalDistpickle with0and1protocols.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-83004: Clean up refleak on failed module initialisation in
_zoneinfogh-83004: Clean up refleaks on failed module initialisation in in
_picklegh-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-98706: [3.11] Applied changes from importlib_metadata 4.11.4 through 4.13, including compatibility and robustness fixes for
Distributionobjects without_normalized_name, disallowing invalid inputs toDistribution.from_name, and refined behaviors inPathDistribution._name_from_stemandPathDistribution._normalized_name.gh-98793: Fix argument typechecks in
_overlapped.WSAConnect()and_overlapped.Overlapped.WSASendTo()functions.gh-98744: Prevent crashing in
tracebackwhen retrieving the byte-offset for some source files that contain certain unicode characters.gh-98740: Fix internal error in the
remodule 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 callprotocol.connection_lostcallback only once on Windows.gh-98624: Add a mutex to unittest.mock.NonCallableMock to protect concurrent access to mock attributes.
gh-89237: Fix hang on Windows in
subprocess.wait_closed()inasynciowithProactorEventLoop. Patch by Kumar Aditya.gh-98458: Fix infinite loop in unittest when a self-referencing chained exception is raised
gh-97928:
tkinter.Text.count()raises now an exception for options starting with “-” instead of silently ignoring them.gh-97966: On
uname_result, restored expectation that_fieldsand_asdictwould include all six properties includingprocessor.gh-98307: A
createSocket()method was added toSysLogHandler.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-98251: Allow
venvto pass alongPYTHON*variables toensurepipandpipwhen they do not impact path resolutiongh-98178: On macOS, fix a crash in
syslog.syslog()in multi-threaded applications. On macOS, the libcsyslog()function is not thread-safe, sosyslog.syslog()no longer releases the GIL to call it. Patch by Victor Stinner.gh-96151: Allow
BUILTINSto be a valid field name for frozen dataclasses.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-98086: Make sure
patch.dict()can be applied on async functions.gh-90985: Earlier in 3.11 we deprecated
asyncio.Task.cancel("message"). We realized we were too harsh, and have undeprecated it.gh-97837: Change deprecate warning message in
unittestfromIt is deprecated to return a value!=Noneto
It is deprecated to return a value that is not None from a test casegh-97825: Fixes
AttributeErrorwhensubprocess.check_output()is used with argumentinput=Noneand either of the arguments encoding or errors are used.gh-82836: Fix
is_privateproperties in theipaddressmodule. Previously non-private networks (0.0.0.0/0) would return True from this method; now they correctly return False.gh-96827: Avoid spurious tracebacks from
asynciowhen default executor cleanup is delayed until after the event loop is closed (e.g. as the result of a keyboard interrupt).gh-97592: Avoid a crash in the C version of
asyncio.Future.remove_done_callback()when an evil argument is passed.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-97005: Update bundled libexpat to 2.4.9
gh-85760: Fix race condition in
asynciowhereprocess_exited()called before thepipe_data_received()leading to inconsistent output. Patch by Kumar Aditya.gh-96819: Fixed check in
multiprocessing.resource_trackerthat guarantees that the length of a write to a pipe is not greater thanPIPE_BUF.gh-96741: Corrected type annotation for dataclass attribute
pstats.FunctionProfile.ncallsto bestr.gh-95987: Fix
reprofAnysubclasses.gh-96388: Work around missing socket functions in
socket’s__repr__.gh-96073: In
inspect, fix overeager replacement of “typing.” in formatting annotations.gh-96192: Fix handling of
bytespath-like objects inos.ismount().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 returnsNonefor incomplete input without emitting any warnings.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-91212: Fixed flickering of the turtle window when the tracer is turned off. Patch by Shin-myoung-serp.
gh-88050: Fix
asynciosubprocess transport to kill process cleanly when process is blocked and avoidRuntimeErrorwhen loop is closed. Patch by Kumar Aditya.gh-93858: Prevent error when activating venv in nested fish instances.
gh-91078:
TarFile.next()now returnsNonewhen called on an empty tarfile.bpo-47220: Document the optional callback parameter of
WeakMethod. Patch by Géry Ogam.bpo-46364: Restrict use of sockets instead of pipes for stdin of subprocesses created by
asyncioto AIX platform only.bpo-38523:
shutil.copytree()now applies the ignore_dangling_symlinks argument recursively.bpo-36267: Fix IndexError in
argparse.ArgumentParserwhen astore_trueaction is given an explicit argument.
Documentation¶
gh-92892: Document that calling variadic functions with ctypes requires special care on macOS/arm64 (and possibly other platforms).
gh-85525: Remove extra row
gh-95588: Clarified the conflicting advice given in the
astdocumentation aboutast.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 thatliteral_evalis safe.bpo-41825: Restructured the documentation for the
os.wait*family of functions, and improved the docs foros.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-99659: Optional big memory tests in
test_sqlite3now catch the correctsqlite.DataErrorexception type in case of too large strings and/or blobs passed.gh-98713: Fix a bug in the
typingtests where a test relying on CPython-specific implementation details was not decorated with@cpython_onlyand 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 hencePy_InitializeEx) back to the embedding tests (all other embedding tests migrated toPy_InitializeFromConfigin 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,-Wstrict-prototypes, and-Wimplicit-function-declarationcompiler warnings in configure checks.gh-99337: Fix a compilation issue with GCC 12 on macOS.
gh-99086: Fix
-Wimplicit-intcompiler warning in configure check forPTHREAD_SCOPE_SYSTEM.gh-98872: Fix a possible fd leak in
Programs/_freeze_module.cintroduced in Python 3.11.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-98707: Don’t use vendored
libmpdecheaders if--with-system-libmpdecis passed to configure. Don’t use vendoredlibexpatheaders if--with-system-expatis passed to !configure.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-emscriptenbuilds for browsers now includeconcurrent.futuresforasyncioandunittest.mock.gh-84461:
wasm32-emscriptenplatform no longer buildsresourcemodule,getresuid(),getresgid(), and their setters. The APIs are stubs and not functional.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.
Windows¶
gh-99345: Use faster initialization functions to detect install location for Windows Store package
gh-98629: Fix initialization of
sys.versionandsys._giton Windowsgh-99442: Fix handling in Python Launcher for Windows when
argv[0]does not include a file extension.gh-98689: Update Windows builds to zlib v1.2.13. v1.2.12 has CVE-2022-37434, but the vulnerable
inflateGetHeaderAPI is not used by Python.gh-98790: Assumes that a missing
DLLsdirectory means that standard extension modules are in the executable’s directory.gh-98745: Update
py.exelauncher to install 3.11 by default and 3.12 on request.gh-98692: Fix the Python Launcher for Windows ignoring unrecognized shebang lines instead of treating them as local paths
gh-94328: Update Windows installer to use SQLite 3.39.4.
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 (likewinreg).gh-96965: Update libffi to 3.4.3
gh-94781: Fix
pcbuild.projto clean previous instances of ouput files inPython\deepfreezeandPython\frozen_modulesdirectories on Windows. Patch by Charlie Zhao.bpo-40882: Fix a memory leak in
multiprocessing.shared_memory.SharedMemoryon Windows.
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.
Tools/Demos¶
gh-95853: The
wasm_build.pyscript 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.pyautomates configure, compile, and test steps for building CPython on WebAssembly platforms.gh-95731: Fix handling of module docstrings in
Tools/i18n/pygettext.py.
C API¶
gh-98680:
PyBUF_*constants were marked as part of Limited API of Python 3.11+. These were available in 3.11.0 withPy_LIMITED_APIdefined for 3.11, and are necessary to use the buffer API.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-96853:
Py_InitializeExnow correctly callsPyConfig_Clearafter 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)
Python 3.11.0 final¶
Release date: 2022-10-24
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
multiprocessingmodule 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.
Core and Builtins¶
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-97752: Fix possible data corruption or crashes when accessing the
f_backmember of newly-created generator or coroutine frames.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_digitsoption with no value (invalid) when thePYTHONINTMAXSTRDIGITSenvironment variable is set to a valid limit. Patch by Victor Stinner.gh-96821: Fix undefined behaviour in
_testcapimodule.c.gh-95778: When
ValueErroris raised if an integer is larger than the limit, mention thesys.set_int_max_str_digits()function in the error message. Patch by Victor Stinner.gh-96587: Correctly raise
SyntaxErroron exception groups (PEP 654) on python versions prior to 3.11bpo-42316: Document some places where an assignment expression needs parentheses.
Library¶
gh-98331: Update the bundled copies of pip and setuptools to versions 22.3 and 65.5.0 respectively.
gh-90985: Earlier in 3.11 we deprecated
asyncio.Task.cancel("message"). We realized we were too harsh, and have undeprecated it.gh-97545: Make Semaphore run faster.
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-90155: Fix broken
asyncio.Semaphorewhen acquire is cancelled.
Documentation¶
Tests¶
gh-95027: On Windows, when the Python test suite is run with the
-jNoption, 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.
Build¶
gh-96729: Ensure that Windows releases built with
Tools\msi\buildrelease.batare upgradable to and from official Python releases.
Windows¶
gh-98360: Fixes
multiprocessingspawning child processes on Windows from a virtual environment to ensure that child processes that also usemultiprocessingto spawn more children will recognize that they are in a virtual environment.gh-98414: Fix
py.exelauncher handling of-V:<company>/option when default preferences have been set in environment variables or configuration files.gh-90989: Clarify some text in the Windows installer.
macOS¶
gh-97897: The macOS 13 SDK includes support for the
mkfifoatandmknodatsystem calls. Using thedir_fdoption with eitheros.mkfifo()oros.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.
Python 3.11.0 release candidate 2¶
Release date: 2022-09-11
Security¶
gh-95778: Converting between
intandstrin bases other than 2 (binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) now raises aValueErrorif the number of digits in string form is above a limit to avoid potential denial of service attacks due to the algorithmic complexity. This is a mitigation for CVE-2020-10735.This new limit can be configured or disabled by environment variable, command line flag, or
sysAPIs. See the integer string conversion length limitation documentation. The default limit is 4300 digits in string form.Patch by Gregory P. Smith [Google] and Christian Heimes [Red Hat] with feedback from Victor Stinner, Thomas Wouters, Steve Dower, Ned Deily, and Mark Dickinson.
Core and Builtins¶
gh-96678: Fix case of undefined behavior in ceval.c
gh-96641: Do not expose
KeyWrapperin_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-96569: Remove two cases of undefined behavior, by adding NULL checks.
gh-96582: Fix possible
NULLpointer dereference in_PyThread_CurrentFrames. Patch by Kumar Aditya.gh-96352: Fix
AttributeErrormissingnameandobjattributes inobject.__getattribute__(). Patch by Philip Georgi.gh-96268: Loading a file with invalid UTF-8 will now report the broken character at the correct location.
gh-96187: Fixed a bug that caused
_PyCode_GetExtrato return garbage for negative indexes. Patch by Pablo Galindogh-96071: Fix a deadlock in
PyGILState_Ensure()when allocating new thread state. Patch by Kumar Aditya.gh-96046:
PyType_Ready()now initializesht_cached_keysand 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-95818: Skip over incomplete frames in
PyThreadState_GetFrame().gh-95876: Fix format string in
_PyPegen_raise_error_known_locationthat can lead to memory corruption on some 64bit systems. The function was building a tuple withi(int) instead ofn(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-94996:
ast.parse()will no longer parse function definitions with positional-only params when passedfeature_versionless than(3, 8). Patch by Shantanu Jain.
Library¶
gh-96652: Fix the faulthandler implementation of
faulthandler.register(signal, chain=True)if thesigaction()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 tofloat.gh-96385: Fix
TypeVarTuple.__typing_prepare_subst__.TypeErrorwas not raised when using more than oneTypeVarTuple, like[*T, *V]in type alias substitutions.gh-90467: Fix
asyncio.streams.StreamReaderProtocolto keep a strong reference to the created task, so that it’s not garbage collectedgh-96159: Fix a performance regression in logging TimedRotatingFileHandler. Only check for special files when the rollover time has passed.
gh-96175: Fix unused
localNameparameter in theAttrclass inxml.dom.minidom.gh-96125: Fix incorrect condition that causes
sys.thread_info.nameto be wrong on pthread platforms.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-95899: Fix
asyncio.Runnerto callasyncio.set_event_loop()only once to avoid callingattach_loop()multiple times on child watchers. Patch by Kumar Aditya.gh-95736: Fix
unittest.IsolatedAsyncioTestCaseto set event loop before calling setup functions. Patch by Kumar Aditya.gh-95704: When a task catches
asyncio.CancelledErrorand raises some other error, the other error should generally not silently be suppressed.gh-95231: Fail gracefully if
EPERMorENOSYSis raised when loadingcryptmethods. This may happen when trying to loadMD5on a Linux kernel with FIPS enabled.gh-74116: Allow
asyncio.StreamWriter.drain()to be awaited concurrently by multiple tasks. Patch by Kumar Aditya.gh-92986: Fix
ast.unparse()whenImportFrom.levelis None
Documentation¶
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.
Tests¶
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.
Build¶
gh-94682: Build and test with OpenSSL 1.1.1q
Windows¶
Python 3.11.0 release candidate 1¶
Release date: 2022-08-05
Core and Builtins¶
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-95355:
_PyPegen_Parser_Newnow 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-95185: Prevented crashes in the AST constructor when compiling some absurdly long expressions like
"+0"*1000000.RecursionErroris now raised instead. Patch by Pablo Galindogh-93351:
ast.ASTnode positions are now validated when provided tocompile()and other related functions. If invalid positions are detected, aValueErrorwill be raised.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.
Library¶
gh-95609: Update bundled pip to 22.2.2.
gh-95289: Fix
asyncio.TaskGroupto propagate exception whenasyncio.CancelledErrorwas replaced with another exception by a context manger. Patch by Kumar Aditya and Guido van Rossum.gh-95339: Update bundled pip to 22.2.1.
gh-95045: Fix GC crash when deallocating
_lsprof.Profilerby untracking it before calling any callbacks. Patch by Kumar Aditya.gh-95097: Fix
asyncio.run()forasyncio.Taskimplementations withoutuncancel()method. Patch by Kumar Aditya.gh-93899: Fix check for existence of
os.EFD_CLOEXEC,os.EFD_NONBLOCKandos.EFD_SEMAPHOREflags 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-95109: Ensure that timeouts scheduled with
asyncio.Timeoutthat have already expired are delivered promptly.gh-91810: Suppress writing an XML declaration in open files in
ElementTree.write()withencoding='unicode'andxml_declaration=None.gh-91447: Fix findtext in the xml module to only give an empty string when the text attribute is set to None.
Documentation¶
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-95451: Update library documentation with availability information on WebAssembly platforms
wasm32-emscriptenandwasm32-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-86128: Document a limitation in ThreadPoolExecutor where its exit handler is executed before any handlers in atexit.
Tests¶
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_ssltest_get_cipherson systems that require perfect forward secrecy (PFS) ciphers.gh-94675: Add a regression test for
reexponentional slowdown when using rjsmin.
Build¶
gh-94801: Fix a regression in
configurescript that caused some header checks to ignore customCPPFLAGS. 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
dupfunction in WASI and works around some missingerrno,select, andsocketconstants.gh-95174: Python now skips missing
socketfunctions and methods on WASI. WASI can only create sockets from existing fd / accept and has no netdb.gh-95085: Platforms
wasm32-unknown-emscriptenandwasm32-unknown-wasihave been promoted to PEP 11 tier 3 platform support.
Windows¶
gh-95656: Enable the
enable_load_extension()sqlite3API.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 Launcher for Windows for
/usr/bin/envshebang lines, which will now searchPATHfor 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 Launcher for Windows handling of
py.inicommands (it was incorrectly expecting apy_prefix on keys) and crashes when reading per-user configuration file.gh-95285: Fix Python Launcher for Windows handling of command lines where it is only passed a short executable name.
IDLE¶
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 Alland 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.
C API¶
gh-92678: Restore the 3.10 behavior for multiple inheritance of C extension classes that store their dictionary at the end of the struct.
gh-94936: Added
PyCode_GetVarnames(),PyCode_GetCellvars()andPyCode_GetFreevars()for accessingco_varnames,co_cellvarsandco_freevarsrespectively via the C API.
Python 3.11.0 beta 5¶
Release date: 2022-07-25
Core and Builtins¶
gh-93351:
ast.ASTnode positions are now validated when provided tocompile()and other related functions. If invalid positions are detected, aValueErrorwill 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_linenoattribute of frame objects. In some cases, this could cause inconsistent internal state, resulting in a hard crash of the interpreter.gh-95060: Undocumented
PyCode_Addr2Locationfunction now properly returns whenaddrqargument is less than zero.gh-95113: Replace all
EXTENDED_ARG_QUICKinstructions with basicEXTENDED_ARGinstructions 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-94036: Fix incorrect source location info for some multi-line attribute accesses and method calls.
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 passedfeature_versionless than(3, 9). Patch by Shantanu Jain.gh-94947:
ast.parse()will no longer parse assignment expressions when passedfeature_versionless 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
astnodes. Patch by Pablo Galindo.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
bytearrayitem 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.
Library¶
gh-95087: Fix IndexError in parsing invalid date in the
emailmodule.gh-95199: Upgrade bundled setuptools to 63.2.0.
gh-95194: Upgrade bundled pip to 22.2.
gh-95132: Fix a
sqlite3regression where*argsand**kwdswere incorrectly relayed fromconnect()to theConnectionfactory. The regression was introduced in 3.11a1 with PR 24421 (gh-85128). Patch by Erlend E. Aasland.`gh-93157: Fix
fileinputmodule didn’t supporterrorsoption wheninplaceis true.gh-95105:
wsgiref.types.InputStream.__iter__()should returnIterator[bytes], notIterable[bytes]. 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-89988: Fix memory leak in
pickle.Picklerwhen looking updispatch_table. Patch by Kumar Aditya.
Tests¶
gh-95212: Make multiprocessing test case
test_shared_memory_recreateparallel-safe.
Build¶
gh-94847: Fixed
_decimalmodule 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:
configurenow uses custom flags likeZLIB_CFLAGSandZLIB_LIBSwhen searching for headers and libraries.gh-94773:
deepfreeze.pynow supports code object with frozensets that contain incompatible, unsortable types.
Windows¶
C API¶
gh-92678: Adds unstable C-API functions
_PyObject_VisitManagedDictand_PyObject_ClearManagedDictto allow C extensions to allow the VM to manage their object’s dictionaries.gh-94930: Fix
SystemErrorraised whenPyArg_ParseTupleAndKeywords()is used with#in(...)but withoutPY_SSIZE_T_CLEANdefined.gh-94864: Fix
PyArg_Parse*with deprecated format units “u” and “Z”. It returned 1 (success) when warnings are turned into exceptions.gh-94731: Python again uses C-style casts for most casting operations when compiled with C++. This may trigger compiler warnings, if they are enabled with e.g.
-Wold-style-castor-Wzero-as-null-pointer-constantoptions forg++.
Python 3.11.0 beta 4¶
Release date: 2022-07-11
Security¶
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
memoryviewuse 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-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
RESUMEinstruction 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
opcodewhen raisingunknown opcode errorin 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
stdinwith non utf-8 encoded text. Patch by Pablo Galindogh-88116: Fix an issue when reading line numbers from code objects if the encoded line numbers are close to
INT_MIN. Patch by Pablo Galindogh-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-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-94021: Fix unreachable code warning in
Python/specialize.c.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.GenericAliasno longer relays the__class__attribute. For example,isinstance(list[int], type)no longer returnsTrue.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 fromsys.path_importer_cachewith a relative path as name. This solves a caching issue when a process changes its current working directory.FileFinderno longer inserts a dot in the path, e.g./egg/./spamis now/egg/spam.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 theco_codeattribute.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-93021: Fix the
__text_signature__for__get__()methods implemented in C. Patch by Jelle Zijlstra.gh-92930: Fixed a crash in
_pickle.cfrom mutating collections during__reduce__orpersistent_id.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 ‘:’
bpo-46142: Make
--helpoutput shorter by moving some info to the new--help-envand--help-xoptionscommand-line options. Also add--help-alloption to print complete usage.
Library¶
gh-94736: Fix crash when deallocating an instance of a subclass of
_multiprocessing.SemLock. Patch by Kumar Aditya.gh-94637:
SSLContext.set_default_verify_paths()now releases the GIL aroundSSL_CTX_set_default_verify_pathscall. The function call performs I/O and CPU intensive work.gh-94607: Fix subclassing complex generics with type variables in
typing. Previously an error message sayingSome type variables ... are not listed in Generic[...]was shown.typingno longer populates__parameters__with the__parameters__of a Python class.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()andunittest.IsolatedAsyncioTestCaseto always the set event loop as it was done in Python 3.10 and earlier. Patch by Kumar Aditya.gh-94510: Re-entrant calls to
sys.setprofile()andsys.settrace()now raiseRuntimeError. Patch by Pablo Galindo.gh-92336: Fix bug where
linecache.getline()fails on bad files withUnicodeDecodeErrororSyntaxError. It now returns an empty string as per the documentation.gh-94398: Once a
asyncio.TaskGrouphas 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-94254: Fixed types of
structmodule to be immutable. Patch by Kumar Aditya.gh-94207: Made
_struct.StructGC-tracked in order to fix a reference leak in the_structmodule.gh-91742: Fix
pdbcrash after jump caused by a null pointer dereference. Patch by Kumar Aditya.gh-94101: Manual instantiation of
ssl.SSLSessionobjects 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(), andinspect.isasyncgenfunction()now properly returnTruefor duck-typed function-like objects like instances ofunittest.mock.AsyncMock.This makes
inspect.iscoroutinefunction()consistent with the behavior ofasyncio.iscoroutinefunction(). Patch by Mehdi ABAAKOUK.gh-94028: Fix a regression in the
sqlite3where 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-93847: Fix repr of enum of generic aliases.
gh-91404: Revert the
rememory 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()-ingenum.Flagwith multiple flag members.gh-79512: Fixed names and
__module__value ofweakrefclassesReferenceType,ProxyType,CallableProxyType. It makes them pickleable.gh-91389: Fix an issue where
disutilities could report missing or incorrect position information in the presence ofCACHEentries.gh-93626: Set
__future__.annotationsto have aNonemandatoryRelease 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()andcopy.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 specifiedweakref_slot=Truewhen it was already defined in one of its bases. This resulted in aTypeErrorupon the new class being created.gh-79579:
sqlite3now correctly detects DML queries with leading comments. Patch by Erlend E. Aasland.gh-93421: Update
sqlite3.Cursor.rowcountwhen a DML statement has run to completion. This fixes the row count for SQL queries likeUPDATE ... RETURNING. Patch by Erlend E. Aasland.gh-91162: Support splitting of unpacked arbitrary-length tuple over
TypeVarandTypeVarTupleparameters. 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 theos.remove()function. Patch by Victor Stinner.gh-83658: Make
multiprocessing.Poolraise an exception ifmaxtasksperchildis notNoneor a positive int.gh-93156: Accessing the
pathlib.PurePath.parentssequence of an absolute path using negative index values produced incorrect results.gh-74696:
shutil.make_archive()no longer temporarily changes the current working directory during creation of standard.zipor tar archives.gh-89973: Fix
re.errorraised infnmatchif 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-92932: Now
dis()andget_instructions()handle operand values for instructions prefixed byEXTENDED_ARG_QUICK. Patch by Sam Gross and Donghee Na.gh-91577: Move imports in
SharedMemorymethods to module level so that they can be executed late in python finalization.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-46755: In
QueueHandler, clearstack_infofromLogRecordto prevent stack trace from being written twice.bpo-46197: Fix
ensurepipenvironment isolation for subprocess runningpip.bpo-45924: Fix
asyncioincorrect traceback when future’s exception is raised multiple times. Patch by Kumar Aditya.bpo-34828:
sqlite3.Connection.iterdump()now handles databases that useAUTOINCREMENTin one or more tables.
Documentation¶
gh-94321: Document the PEP 246 style protocol type
sqlite3.PrepareProtocol.gh-61162: Clarify
sqlite3behavior when How to use the connection context manager.gh-87260: Align
sqlite3argument 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 to this.
bpo-47161: Document that
pathlib.PurePathdoes not collapse initial double slashes because they denote UNC paths.
Tests¶
gh-91330: Added more tests for
dataclassesto cover behavior with data descriptor-based fields.gh-94208:
test_sslis 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-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-84461:
run_tests.pynow handles cross compiling env vars correctly and passHOSTRUNNERto regression tests.gh-93616:
test_modulefindernow creates a temporary directory inModuleFinderTest.setUp()instead of module scope.gh-93575: Fix issue with test_unicode test_raiseMemError. The test case now use
test.support.calcobjsizeto 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 workingos.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)withRESOLVE_BENEATHflag, which prevents symlinks with absolute paths.gh-89858: Fix
test_embedfor out-of-tree builds. Patch by Kumar Aditya.gh-92886: Fixing tests that fail when running with optimizations (
-O) intest_imaplib.py.gh-92886: Fixing tests that fail when running with optimizations (
-O) intest_zipimport.pybpo-47016: Create a GitHub Actions workflow for verifying bundled pip and setuptools. Patch by Illia Volochii and Adam Turner.
Build¶
gh-94404:
makesetupnow 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-93584: Address race condition in
Makefilewhen installing a PGO build. Alltestandinstalltargets now depend onalltarget.gh-93491:
configurenow detects and reports PEP 11 support tiers.
Windows¶
gh-93824: Drag and drop of files onto Python files in Windows Explorer has been enabled for Windows ARM64.
bpo-42658: Support native Windows case-insensitive path comparisons by using
LCMapStringExinstead ofstr.lower()inntpath.normcase(). AddLCMapStringExto the_winapimodule.
Tools/Demos¶
C API¶
gh-93937: The following frame functions and type are now directly available with
#include <Python.h>, it’s no longer needed to add#include <frameobject.h>:Patch by Victor Stinner.
gh-91321: Fix the compatibility of the Python C API with C++ older than C++11. Patch by Victor Stinner.
gh-91731: Avoid defining the
static_assertwhen compiling with C++ 11, where this is a keyword and redefining it can lead to undefined behavior. Patch by Pablo Galindogh-93442: Add C++ overloads for _Py_CAST_impl() to handle 0/NULL. This will allow C++ extensions that pass 0 or NULL to macros using _Py_CAST() to continue to compile.
Python 3.11.0 beta 3¶
Release date: 2022-06-01
Core and Builtins¶
Build¶
gh-69093: Fix
Modules/Setup.stdlib.inrule for_sqlite3extension.
Python 3.11.0 beta 2¶
Release date: 2022-05-30
Core and Builtins¶
gh-84694: The
--experimental-isolated-subinterpretersconfigure option andEXPERIMENTAL_ISOLATED_SUBINTERPRETERSmacro have been removed.gh-91924: Fix
__lltrace__debug feature if the stdout encoding is not UTF-8. Patch by Victor Stinner.gh-93061: Backward jumps after
async forloops 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-90473: Decrease default recursion limit on WASI to address limited call stack size.
gh-92804: Fix memory leak in
memoryviewiterator as it was not finalized at exit. Patch by Kumar Aditya.gh-92236: Remove spurious “LINE” event when starting a generator or coroutine, visible tracing functions implemented in C.
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-92261: Fix hang when trying to iterate over a
typing.Union.
Library¶
gh-93297: Make asyncio task groups prevent child tasks from being GCed
gh-90817: The
locale.resetlocale()function is deprecated and will be removed in Python 3.13. Uselocale.setlocale(locale.LC_ALL, "")instead. Patch by Victor Stinner.gh-92728: The
re.template()function and the correspondingre.TEMPLATEandre.Tflags 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-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
InvalidHeaderErrorto the defect list. It should have beenInvalidHeaderDefect.gh-92675: Fix
venv.ensure_directories()to acceptpathlib.Patharguments in addition tostrpaths. Patch by David Foster.gh-87901: Removed the
encodingargument fromos.popen()that was added in 3.11b1.gh-91922: Fix function
sqlite.connect()and thesqlite.Connectionconstructor on non-UTF-8 locales. Also, they now support bytes paths non-decodable with the current FS encoding.gh-92839: Fixed crash resulting from calling bisect.insort() or bisect.insort_left() with the key argument not equal to None.
gh-90473:
subprocessnow fails early on Emscripten and WASI platforms to work around missingos.pipe()on WASI.gh-92671: Fixed
ast.unparse()for empty tuples in the assignment target context.gh-91581:
utcfromtimestamp()no longer attempts to resolvefoldin 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 todatetime.min. Patch by Paul Ganssle.gh-92550: Fix
pathlib.Path.rglob()for empty pattern.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-91810:
ElementTreemethodwrite()and functiontostring()now use the text file’s encoding (“UTF-8” if not available) instead of locale encoding in XML declaration whenencoding="unicode"is specified.gh-90622: Worker processes for
concurrent.futures.ProcessPoolExecutorare 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-91581: Remove an unhandled error case in the C implementation of calls to
datetime.fromtimestampwith 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.bpo-39064:
zipfile.ZipFilenow raiseszipfile.BadZipFileinstead ofValueErrorwhen reading a corrupt zip file in which the central directory offset is negative.bpo-45393: Fix the formatting for
await xandnot xin the operator precedence table when using thehelp()system.bpo-28249: Set
doctest.DocTest.linenotoNonewhen object does not have__doc__.bpo-45046: Add support of context managers in
unittest: methodsenterContext()andenterClassContext()of classTestCase, methodenterAsyncContext()of classIsolatedAsyncioTestCaseand functionunittest.enterModuleContext().bpo-42627: Fix incorrect parsing of Windows registry proxy settings
Documentation¶
gh-86438: Clarify that
-WandPYTHONWARNINGSare matched literally and case-insensitively, rather than as regular expressions, inwarnings.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-40838: Document that
inspect.getdoc(),inspect.getmodule(), andinspect.getsourcefile()might returnNone.bpo-38056: Overhaul the Error Handlers documentation in
codecs.bpo-13553: Document tkinter.Tk args.
Tests¶
gh-92670: Skip
test_shutil.TestCopy.test_copyfile_nonexistent_dirtest 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.
Build¶
Windows¶
gh-92817: Ensures that
py.exewill prefer an active virtual environment over default tags specified with environment variables or through apy.inifile.gh-92984: Explicitly disable incremental linking for non-Debug builds
gh-92841:
asynciono longer throwsRuntimeError: Event loop is closedon interpreter exit after asynchronous socket activity. Patch by Oleg Iarygin.bpo-46907: Update Windows installer to use SQLite 3.38.4.
C API¶
gh-92898: Fix C++ compiler warnings when casting function arguments to
PyObject*. Patch by Serge Guelton.gh-92913: Ensures changes to
PyConfig.module_search_pathsare ignored unlessPyConfig.module_search_paths_setis setgh-92781: Avoid mixing declarations and code in the C API to fix the compiler warning: “ISO C90 forbids mixed declarations and code” [-Werror=declaration-after-statement]. Patch by Victor Stinner.
Python 3.11.0 beta 1¶
Release date: 2022-05-06
Security¶
gh-57684: Add the
-Pcommand line option and thePYTHONSAFEPATHenvironment variable to not prepend a potentially unsafe path tosys.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 importsreadlineandrlcompleterbefore sys.path is extended to include the current working directory of an interactive interpreter. Non-interactive interpreters are not affected.bpo-43857: Improve the
AttributeErrormessage 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 toNone.gh-92112: Fix crash triggered by an evil custom
mro()on a metaclass.gh-92063: The
PRECALL_METHOD_DESCRIPTOR_FAST_WITH_KEYWORDSinstruction 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_Quickencalls 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.UnionTypeinstantiation. 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_iteratortype. Patch by Donghee Na.gh-81548: Octal escapes with value larger than
0o377now produce aDeprecationWarning. In a future Python version they will be aSyntaxWarningand eventually aSyntaxError.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_clearfunction could leave a python function object in an inconsistent state.gh-91603: Speed up
isinstance()andissubclass()checks fortypes.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 aPyFrameObjectis an entry frame. Patch by Pablo Galindo.gh-91266: Refactor the
bytearraystrip methodsstrip,lstripandrstripto use a common implementation.gh-91479: Replaced the
__note__field ofBaseException(added in an earlier version of 3.11) with the final design of PEP 678. Namely,BaseExceptiongets anadd_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] = {...};toopcode.hfor 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_NONEandPOP_JUMP_IF_NOT_NONEvirtual, 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
voidreturn types, so that for instance a function declared likectypes.CFUNCTYPE(None, ctypes.c_int)would be called with signatureint f(int)instead ofvoid 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_POPandJUMP_IF_FALSE_OR_POPrelative rather than absolute.bpo-47177: Replace the
f_lastimember of the internal_PyInterpreterFramestructure with aprev_instrpointer, which reduces overhead in the main interpreter loop. Thef_lastiattribute 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-stringscompilation flag no longer do so.The classes affected are
ctypes.UnionType,pickle.PickleBuffer,testcapi.RecursingInfinitelyError, andtypes.GenericAlias.The functions affected are 24 methods in
ctypes.Patch by Oleg Iarygin.
bpo-46942: Use Argument Clinic for the
types.MethodTypeconstructor. 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 forfloat,int,str,bool, andNoneto 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()usesFLAG_REFfor 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
disutilities 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
memberandnonmemberfunctions 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=Trueis passed todisutilities.gh-92301: Prefer
close_range()to iterating over procfs for file descriptor closing insubprocessfor 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()anddatetime.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_ACLandCOPYFILE_XATTRconstants foros.fcopyfile()available in macOs.gh-91215: For @dataclass, add weakref_slot. Default is 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__()tologging.LoggerAdapterandlogging.StreamHandler, allowing them to be parameterized at runtime. Patch by Alex Waygood.gh-92049: Forbid pickling constants
re._constants.SUCCESSetc. Previously, pickling did not fail, but the result could not be unpickled.gh-92062:
inspect.Parameternow raisesValueErrorifnameis a keyword, in addition to the existing check that it is an identifier.gh-87390: Add an
__unpacked__attribute totypes.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 toTextIOWrapper.reconfigure().gh-91954: Add encoding and errors arguments to
subprocess.getoutput()andsubprocess.getstatusoutput().bpo-47029: Always close the read end of the pipe used by
multiprocessing.Queueafter the last write of buffered data to the write end of the pipe to avoidBrokenPipeErrorat garbage collection and atmultiprocessing.Queue.close()calls. Patch by Géry Ogam.gh-91928: Add
datetime.UTCalias fordatetime.timezone.utc.Patch by Kabir Kwatra.
gh-68966: The
mailcapmodule is now deprecated and will be removed in Python 3.13. See PEP 594 for the rationale and themimetypesmodule for an alternative. Patch by Victor Stinner.gh-91401: Provide a way to disable
subprocessuse ofvfork()just in case it is ever needed and document the existing mechanism forposix_spawn().gh-64783: Fix
signal.NSIGvalue on FreeBSD to accept signal numbers greater than 32, likesignal.SIGRTMINandsignal.SIGRTMAX. Patch by Victor Stinner.gh-91910: Add missing f prefix to f-strings in error messages from the
multiprocessingandasynciomodules.gh-91860: Add
typing.dataclass_transform(), implementing PEP 681. Patch by Jelle Zijlstra.gh-91832: Add
requiredattribute toargparse.Actionrepr output.gh-91827: In the
tkintermodule add methodinfo_patchlevel()which returns the exact version of the Tcl library as a named tuple similar tosys.version_info.gh-84461: Add
--enable-wasm-pthreadsto enable pthreads support for WASM builds.Emscripten/nodeno longer has threading enabled by default. Include additional file systems.gh-91821: Fix unstable
test_from_tupletest intest_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_infonamed tuple with build-time and run-time information about Emscripten platform.gh-90623:
signal.raise_signal()andos.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 appropriatere.errorif 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.BaseManagerconstructor. Kill the process if terminate() takes longer than the timeout. Patch by Victor Stinner.gh-91621: Fix
typing.get_type_hints()forcollections.abc.Callable. Patch by Shantanu Jain.gh-90568: Parsing
\Nescapes of Unicode Named Character Sequences in aregular expressionraises nowre.errorinstead ofTypeError.gh-91670: Remove deprecated
SOconfig variable insysconfig.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:
remodule, fixfullmatch()mismatch when using Atomic Grouping or Possessive Quantifiers.gh-91217: Deprecate the ‘pipes’ module.
gh-91217: Deprecate the ossaudiodev module.
bpo-47256:
remodule, 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 anExceptionGroupwhen 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
remodule to the latest Unicode version.gh-90622: In
concurrent.futures.process.ProcessPoolExecutordisallow the “fork” multiprocessing start method when the newmax_tasks_per_childfeature 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 nomp_contextwas supplied.gh-89022: In
sqlite3,SQLITE_MISUSEresult codes are now mapped toInterfaceErrorinstead ofProgrammingError. Also, more accurate exceptions are raised when binding parameters fail. Patch by Erlend E. Aasland.gh-91526: Stop calling
os.device_encoding(file.fileno())inTextIOWrapper. 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
inspectmodule 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()andinspect.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
rematching 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.
bpo-47000: Make
TextIOWrapperuses locale encoding whenencoding="locale"is specified even in UTF-8 mode.gh-91230:
warnings.catch_warnings()now accepts arguments forwarnings.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_INFOoption (available on macOS) tosocket.bpo-47260: Fix
os.closerange()potentially being a no-op in a Linux seccomp sandbox.bpo-47087: Implement
typing.Requiredandtyping.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 tolocale.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
reparsing errors.bpo-47211: Remove undocumented and never working function
re.template()and flagre.TEMPLATE. This was later reverted in 3.11.0b2 and deprecated instead.bpo-47135:
decimal.localcontext()now accepts context attributes via keyword argumentsbpo-43323: Fix errors in the
emailmodule 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()andtyping.clear_overloads(). Patch by Jelle Zijlstra.bpo-44807:
typing.Protocolno longer silently replaces__init__()methods defined on subclasses. Patch by Adrian Garcia Badaracco.bpo-46787: Fix
concurrent.futures.ProcessPoolExecutorexception memory leakbpo-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-46053: Fix OSS audio support on NetBSD.
bpo-45639:
image/avifandimage/webpwere added tomimetypes.bpo-46285: Add command-line option
-p/--protocolto modulehttp.serverwhich 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 modulehttp.server). Patch by Géry Ogam.bpo-44791: Accept ellipsis as the last argument of
typing.Concatenate.bpo-46547: Remove variables leaking into
pydoc.Helperclass namespace.bpo-46415: Fix ipaddress.ip_{address,interface,network} raising TypeError instead of ValueError if given invalid tuple as address parameter.
bpo-46075:
CookieJarwithDefaultCookiePolicynow 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.BufferedIOBaseorio.TextIOBaseinterface fortempfile.SpooledTemporaryFileobjects. This lets them work correctly with higher-level layers (like compression modules). Patch by Carey Metcalfe.bpo-45138: Fix a regression in the
sqlite3trace 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
TypedDictsubclasses to also includeGenericas a base class in class based syntax. Thereby allowing the user to define a genericTypedDict, just like a user-defined generic but withTypedDictsemantics.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_groupparameter tosubprocess.Popento help move more things off of the unsafepreexec_fnparameter.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 inCookieJarfollows the order of theSet-Cookieheader. Patch by Iman Kermani.bpo-40617: Add
create_window_function()tosqlite3.Connectionfor creating aggregate window functions. Patch by Erlend E. Aasland.bpo-40676: Convert
csvto use Argument Clinic forcsv.field_size_limit(),csv.get_dialect(),csv.unregister_dialect()andcsv.list_dialects().bpo-39716: Raise an
ArgumentErrorwhen the same subparser name is added twice to anargparse.ArgumentParser. This is consistent with the (default) behavior when the same option string is added twice to anArgumentParser.bpo-36073: Raise
ProgrammingErrorinstead of segfaulting on recursive usage of cursors insqlite3converters. Patch by Sergey Fedoseev.bpo-34975: Adds a
start_tls()method toStreamWriter, which upgrades the connection with TLS using the givenSSLContext.bpo-22276:
Pathmethodsglob()andrglob()return only directories if pattern ends with a pathname components separator (/orsep). Patch by Eisuke Kawashima.bpo-24905: Add
blobopen()tosqlite3.Connection.sqlite3.Bloballows incremental I/O operations on blobs. Patch by Aviv Palivoda and Erlend E. Aasland.
Documentation¶
gh-91888: Add a new
ghrole to the documentation to link to GitHub issues.gh-91783: Document security issues concerning the use of the function
shutil.unpack_archive()gh-91547: Remove “Undocumented modules” page.
gh-91298: In
importlib.resources.abc, refined the documentation of the Traversable Protocol, applying changes from importlib_resources 5.7.1.bpo-44347: Clarify the meaning of dirs_exist_ok, a kwarg of
shutil.copytree().bpo-36329: Remove ‘make -C Doc serve’ in favour of ‘make -C Doc htmlview’
bpo-47189: Add a What’s New in Python 3.11 entry for the Faster CPython project. Documentation by Ken Jin and Kumar Aditya.
bpo-38668: Update the introduction to documentation for
os.pathto remove warnings that became irrelevant after the implementations of PEP 383 and PEP 529.bpo-47115: The documentation now lists which members of C structs are part of the Limited API/Stable ABI.
bpo-46962: All docstrings in code snippets are now wrapped into
PyDoc_STRto follow the guideline of PEP 7’s Documentation Strings paragraph. Patch by Oleg Iarygin.bpo-26792: Improve the docstrings of
runpy.run_module()andrunpy.run_path(). Original patch by Andrew Brezovsky.
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.executablevia the--pythonflag.gh-91904: Fix initialization of
PYTHONREGRTEST_UNICODE_GUARDwhich 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_futuresto 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, andctypes.macholib.frameworkare brought from manual pre-unittesttimes toctypes.testlocation and structure. Patch by Oleg Iarygin.bpo-29890: Add tests for
ipaddress.IPv4Interfaceandipaddress.IPv6Interfaceconstruction 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=c11compiler option, rather than-std=c99. Patch by Victor Stinner.bpo-47152: Add script and make target for generating
sre_constants.h.bpo-47103: Windows
PGInstrumentbuilds 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 Launcher for Windows 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 byFindFirstFileW()when appropriate inwin32_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_classparameter.gh-91575: Add script
Tools/scripts/generate_re_casefix.pyand the make targetregen-refor 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 codegetattr(code_object, 'co_code').gh-92173: Fix the
closureargument toPyEval_EvalCodeEx().gh-91320: Fix C++ compiler warnings about “old-style cast” (
g++ -Wold-style-cast) in the Python C API. Use C++reinterpret_cast<>andstatic_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()andPy_IS_TYPE()functions argument type is nowPyObject*, rather thanconst PyObject*. Patch by Victor Stinner.gh-91020: Add
PyBytes_Type.tp_allocto initializePyBytesObject.ob_shashfor bytes subclasses.bpo-40421: Add
PyFrame_GetLastiC-API function to access frame object’sf_lastiattribute safely from C code.bpo-35134: Remove the
Include/code.hheader 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()andPyErr_SetHandledException()as simpler alternatives toPyErr_GetExcInfo()andPyErr_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
IndentationErrorinstead ofSyntaxErrorfor a bareexceptwith no following indent. ImproveSyntaxErrorlocations for an un-parenthesized generator used as arguments. Patch by Matthieu Dartiailh.bpo-47186: Replace
JUMP_IF_NOT_EG_MATCHbyCHECK_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_MATCHbyCHECK_EXC_MATCH+ jump.bpo-47120: Replace the absolute jump opcode
JUMP_NO_INTERRUPTby the relativeJUMP_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_TRAMPOLINEto 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_ABSOLUTEby the relative jumpJUMP_BACKWARD.bpo-42197:
PyFrame_FastToLocalsWithError()andPyFrame_LocalsToFast()are no longer called during profiling nor tracing. C code can access thef_localsattribute ofPyFrameObjectby callingPyFrame_GetLocals().bpo-47070: Improve performance of
array_inplace_repeatby reducing the number of invocations ofmemcpy. Refactor therepeatand inplacerepeatmethods ofarray,bytes,bytearrayandunicodeobjectto use the common_PyBytes_Repeat.bpo-47053: Reduce de-optimization in the specialized
BINARY_OP_INPLACE_ADD_UNICODEopcode.bpo-47045: Remove the
f_statefield from the _PyInterpreterFrame struct. Add theownerfield 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
faulthandlerto avoid compilation problems in systems where this header doesn’t exist. Patch by Pablo Galindobpo-46329: Use low bit of
LOAD_GLOBALto indicate whether to push aNULLbefore 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
bytesandbytearrayby 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_repeatandbytearray_irepeatby reducing the number of invocations ofmemcpy.bpo-46829: Deprecate passing a message into
asyncio.Future.cancel()andasyncio.Task.cancel()bpo-46993: Speed up
bytearraycreation fromlistandtupleby 40%. Patch by Kumar Aditya.bpo-39829: Removed the
__len__()call when initializing a list and moved initializing tolist_extend. Patch by Jeremiah Pascual.bpo-46944: Speed up throwing exception in generator with
METH_FASTCALLcalling convention. Patch by Kumar Aditya.bpo-46841: Modify
STORE_SUBSCRto use an inline cache entry (rather than its oparg) as an adaptive counter.bpo-46841: Use inline caching for
PRECALLandCALL, 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, anddeleterto 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:
remodule: 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
remodule into a package. Deprecate modulessre_compile,sre_constantsandsre_parse.bpo-4833: Add
ZipFile.mkdir()bpo-27929: Fix
asyncio.loop.sock_connect()to only resolve names forsocket.AF_INETorsocket.AF_INET6families. Resolution may not make sense for other families, likesocket.AF_BLUETOOTHandsocket.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_availablenow 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
URLErrorexception messages raised inurllib.request.URLopenernow contain a colon betweenftp errorand 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_blake2module now preferslibb2from https://www.blake2.net/ over Python’s vendored copy of blake2.bpo-47098: The Keccak Code Package for
hashlib’s internal_sha3module 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()andre.sub()for regular expressions starting with\Aor^.bpo-23691: Protect the
re.finditer()iterator from re-entering.bpo-47067: Optimize calling
GenericAliasobjects by using PEP 590vectorcalland by replacingPyObject_SetAttrStringwithPyObject_SetAttr.bpo-28080: Add the metadata_encoding parameter in the
zipfile.ZipFileconstructor and the--metadata-encodingoption in thezipfileCLI 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 aZipFilefrom 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 aszlib.crc32()andhashlibdo.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}+) inregular expressions.bpo-47062: Implement
asyncio.Runnercontext manager.bpo-46382:
dataclass()slots=Truenow 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.Semaphorere-aquiring FIFO order.bpo-47022: The
asynchat,asyncoreandsmtpdmodules 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 passesNULLtoselectfor 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()andasyncio.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 usinggetauxval(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.nanvalue is now always available. Patch by Victor Stinner.bpo-46955: Expose
asyncio.base_events.Serverasasyncio.Server. Patch by Stefan Zabka.bpo-23325: The
signalmodule no longer assumes thatSIG_IGNandSIG_DFLare small int singletons.bpo-46932: Update bundled libexpat to 2.4.7
bpo-46933: The
pwdmodule is now optional.os.path.expanduser()returns the path when thepwdmodule is not available.bpo-40059: PEP 680, the
tomllibmodule. Adds support for parsing TOML.bpo-464471:
asyncio.timeout()andasyncio.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()andsock_recvfrom_into().bpo-46644: No longer require valid typeforms to be callable. This allows
typing.Annotatedto wraptyping.ParamSpecArgsanddataclasses.InitVar. Patch by Gregory Beauregard.bpo-46581: Brings
ParamSpecpropagation forGenericAliasin line withConcatenate(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
venvmodule 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()andsysconfig.get_preferred_scheme()withkey="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
DeprecationWarningtoLegacyInterpolation, deprecated in the docstring since Python 3.2. Will be removed in Python 3.13. UseBasicInterpolationorExtendedInterpolationinstead.bpo-26120:
pydocnow 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 unittestand the filename(s) began with a dot (.), aValueErroris returned.bpo-46245: Add optional parameter dir_fd in
shutil.rmtree().bpo-22859:
usageExit()is marked deprecated, to be removed in 3.13.bpo-46170: Improve the error message when you try to subclass an instance of
typing.NewType.bpo-20392: Fix inconsistency with uppercase file extensions in
MimeTypes.guess_type(). Patch by Kumar Aditya.bpo-46030: Add
LOCAL_CREDS,LOCAL_CREDS_PERSISTENTandSCM_CREDS2FreeBSD constants to the socket module.bpo-44439: Fix
.write()method of a member file inZipFile, when the input data is an object that supports the buffer protocol, the file length may be wrong.bpo-45171: Fix handling of the
stacklevelargument to logging functions in theloggingmodule so that it is consistent across all logging functions and, as advertised, similar to thestacklevelargument used inwarn().bpo-24959: Fix bug where
unittestsometimes drops frames from tracebacks of exceptions raised in tests.bpo-44859: Raise more accurate and PEP 249 compatible exceptions in
sqlite3.Raise
InterfaceErrorinstead ofProgrammingErrorforSQLITE_MISUSEerrors.Don’t overwrite
BufferErrorwithValueErrorwhen conversion to BLOB fails.Raise
ProgrammingErrorinstead ofWarningif user tries toexecute()more than one SQL statement.Raise
ProgrammingErrorinstead ofValueErrorif an SQL query contains null characters.
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()anddeserialize()support tosqlite3. Patch by Erlend E. Aasland.bpo-33178: Added
ctypes.BigEndianUnionandctypes.LittleEndianUnionclasses, 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 consistant with Barrier from threading and multiprocessing libs*
bpo-35859:
remodule, fix a few bugs about capturing group. In rare cases, capturing group gets an incorrect string. Patch by Ma Lin.
Documentation¶
bpo-47040: Clarified the old Python versions compatiblity note of
binascii.crc32()/zlib.adler32()/zlib.crc32()functions.bpo-46033: Clarify
forstatement execution in its doc.bpo-45790: Adjust inaccurate phrasing in Defining Extension Types: Tutorial about the
ob_basefield and the macros used to access its contents.bpo-42340: Document that in some circumstances
KeyboardInterruptmay cause the code to enter an inconsistent state. Provided a sample workaround to avoid it if needed.bpo-41233: Link the errnos referenced in
Doc/library/exceptions.rstto their respective section inDoc/library/errno.rst, and vice versa. Previously this was only done for EINTR and InterruptedError. Patch by Yan “yyyyyyyan” Orestes.
Tests¶
bpo-47205: Skip test for
sched_getaffinity()andsched_setaffinity()error case on FreeBSD.bpo-46126: Restore ‘descriptions’ when running tests internally.
bpo-47104: Rewrite
asyncio.to_thread()tests to useunittest.IsolatedAsyncioTestCase.bpo-40280: The test suite is now passing on the Emscripten platform. All fork, socket, and subprocess-based tests are skipped.
bpo-47037: Skip
strftime("%4Y")feature test on Windows. It can cause an assertion error in debug builds.bpo-46587: Skip tests if platform’s
strftimedoes not support non-portable glibc extensions.bpo-47015: A test case for
os.sendfile()is converted from deprecatedasyncore(see PEP 594) toasyncio. Patch by Oleg Iarygin.
Build¶
bpo-40280: Add configure option
--enable-wasm-dynamic-linkingto enabledlopenand MAIN_MODULE / SIDE_MODULE onwasm32-emscripten.bpo-46023:
makesetupnow detects and skips all duplicated module definitions. The first entry wins.bpo-40280: Add SOABI
wasm32-emscriptenfor Emscripten andwasm32-wasifor WASI on 32bit WASM as well aswasm64counter 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
tkinterpackage now requires Tcl/Tk version 8.5.12 or newer.bpo-46973: Add
regen-configuremake target to regenerate configure script with Christian’s container imagequay.io/tiran/cpython_autoconf:269.bpo-46917: Building Python now requires support of IEEE 754 floating point numbers. Patch by Victor Stinner.
bpo-45774:
configurenow verifies that all SQLite C APIs needed for thesqlite3extension module are found.
Windows¶
bpo-47194: Update
zlibto v1.2.12 to resolve CVE-2018-25032.bpo-47171: Enables installing the
py.exelauncher on Windows ARM64.bpo-46566: Upgraded Python Launcher for Windows to support a new
-V:company/tagargument for full PEP 514 support and to detect ARM64 installs. The-64suffix on arguments is deprecated, but still selects any non-32-bit install. SettingPYLAUNCHER_ALLOW_INSTALLand 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
.chmfile.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¶
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_GetGeneratorandPyFrame_GetGlobalsC-API functions to access frame object attributes safely from C code.bpo-46850: Move the private
_PyFrameEvalFunctiontype, and private_PyInterpreterState_GetEvalFrameFunc()and_PyInterpreterState_SetEvalFrameFunc()functions to the internal C API. The_PyFrameEvalFunctioncallback function type now uses the_PyInterpreterFrametype 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_PyInterpreterFrametype 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 publicsys.call_tracing()function instead. Patch by Victor Stinner.bpo-46850: Remove the private undocumented function
_PyEval_GetCoroutineOriginTrackingDepth()from the C API. Call the publicsys.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()andsys.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()andPyFloat_Unpack8(). Patch by Victor Stinner.
Python 3.11.0 alpha 6¶
Release date: 2022-03-07
Core and Builtins¶
bpo-46940: Avoid overriding
AttributeErrormetadata 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_OPfollowed byEXTENDED_ARG.bpo-46891: Fix bug introduced during 3.11alpha where subclasses of
types.ModuleTypewith__slots__were not initialized correctly, resulting in an interpreter crash.bpo-46841: Use inline caching for
LOAD_ATTR,LOAD_METHOD, andSTORE_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 tofloat.__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 asfloat.__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_OPcaches inline using a newCACHEinstruction.bpo-45107: Specialize
LOAD_METHODfor instances with a dict.bpo-44337: Reduce the memory usage of specialized
LOAD_ATTRandSTORE_ATTRinstructions.bpo-46729: Add number of sub-exceptions to
BaseException.__str__().bpo-45885: Don’t un-adapt
COMPARE_OPwhen collecting specialization stats.bpo-46329: Fix specialization stats gathering for
PRECALLinstructions.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_NAMESbeforePRECALLinstruction in call sequence. ChangeoperandofCALLto matchPRECALLfor easier specialization.bpo-46808: Remove the
NEXT_BLOCKmacro from compile.c, and make the compiler automatically generate implicit blocks when they are needed.bpo-46329: Add
PUSH_NULLinstruction. This is used as a prefix when evaluating a callable, so that the stack has the same shape for methods and other calls.PRECALL_FUNCTIONandPRECALL_METHODare merged into a singlePRECALLinstruction.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_ABSOLUTEinstruction, rather thanJUMP_FORWARDwith 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:
ctypesnow 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
RESUMEthat skips quickening checks.bpo-46702: Specialize
UNPACK_SEQUENCEfortupleandlistunpackings.bpo-46072: Opcode pair stats are now gathered with
--enable-pystats. DefiningDYNAMIC_EXECUTION_PROFILEorDXPAIRSno 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()inModules/_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 toPyLong_FromLongLong().
Library¶
bpo-25707: Fixed a file leak in
xml.etree.ElementTree.iterparse()when the iterator is not exhausted. Patch by Jacob Walls.bpo-46877: Export
unittest.doModuleCleanups()inunittest. Patch by Kumar Aditya.bpo-46848: For performance, use the optimized string-searching implementations from
find()andrfind()forfind()andrfind().bpo-46736:
SimpleHTTPRequestHandlernow uses HTML5 grammar. Patch by Donghee Na.bpo-44886: Inherit asyncio proactor datagram transport from
asyncio.DatagramTransport.bpo-46827: Support UDP sockets in
asyncio.loop.sock_connect()for selector-based event loops. Patch by Thomas Grainger.bpo-46811: Make test suite support Expat >=2.4.5
bpo-46252: Raise
TypeErrorifssl.SSLSocketis passed to transport-based APIs.bpo-46784: Fix libexpat symbols collisions with user dynamically loaded or statically linked libexpat in embedded Python.
bpo-46786: The HTML serialisation in xml.etree.ElementTree now writes
embed,source,trackandwbras empty tags, as defined in HTML 5.bpo-39327:
shutil.rmtree()can now work with VirtualBox shared folders when running from the guest operating-system.bpo-45390: Propagate
asyncio.CancelledErrormessage from inner task to outer awaiter.bpo-46756: Fix a bug in
urllib.request.HTTPPasswordMgr.find_user_password()andurllib.request.HTTPPasswordMgrWithPriorAuth.is_authenticated()which allowed to bypass authorization. For example, access to URIexample.org/foobarwas allowed if the user was authorized for URIexample.org/foo.bpo-46737:
random.gauss()andrandom.normalvariate()now have default arguments.bpo-46752: Add task groups to asyncio (structured concurrency, inspired by Trio’s nurseries). This also introduces a change to task cancellation, where a cancelled task can’t be cancelled again until it calls .uncancel().
bpo-46333: The
__repr__()method oftyping.ForwardRefnow includes themoduleparameter oftyping.ForwardRefwhen it is set.bpo-46643: In
typing.get_type_hints(), support evaluating stringifiedParamSpecArgsandParamSpecKwargsannotations. Patch by Gregory Beauregard.bpo-45863: When the
tarfilemodule creates a pax format archive, it will put an integer representation of timestamps in the ustar header (if possible) for the benefit of older unarchivers, in addition to the existing full-precision timestamps in the pax extended header.bpo-46066: Deprecate kwargs-based syntax for
typing.TypedDictdefinitions. It had confusing semantics when specifying totality, and was largely unused. Patch by Jingchen Ye.bpo-46676: Make
typing.ParamSpecargs and kwargs equal to themselves. Patch by Gregory Beauregard.bpo-46323:
ctypes.CFUNCTYPE()andctypes.WINFUNCTYPE()now fail to create the type if its_argtypes_member contains too many arguments. Previously, the error was only raised when calling a function. Patch by Victor Stinner.bpo-46672: Fix
NameErrorinasyncio.gather()when initial type check fails.bpo-46659: The
calendar.LocaleTextCalendarandcalendar.LocaleHTMLCalendarclasses now uselocale.getlocale(), instead of usinglocale.getdefaultlocale(), if no locale is specified. Patch by Victor Stinner.bpo-46659: The
locale.getdefaultlocale()function is deprecated and will be removed in Python 3.13. Uselocale.setlocale(),locale.getpreferredencoding(False)andlocale.getlocale()functions instead. Patch by Victor Stinner.bpo-46655: In
typing.get_type_hints(), support evaluating bare stringifiedTypeAliasannotations. Patch by Gregory Beauregard.bpo-45948: Fixed a discrepancy in the C implementation of the
xml.etree.ElementTreemodule. Now, instantiating anxml.etree.ElementTree.XMLParserwith atarget=Nonekeyword provides a defaultxml.etree.ElementTree.TreeBuildertarget as the Python implementation does.bpo-46626: Expose Linux’s
IP_BIND_ADDRESS_NO_PORToption insocket.bpo-46521: Fix a bug in the
codeopmodule that was incorrectly identifying invalid code involving string quotes as valid code.bpo-46571: Improve
typing.no_type_check().Now it does not modify external classes and functions. We also now correctly mark classmethods as not to be type checked.
bpo-46400: expat: Update libexpat from 2.4.1 to 2.4.4
bpo-46556: Deprecate undocumented support for using a
pathlib.Pathobject as a context manager.bpo-46534: Implement PEP 673
typing.Self. Patch by James Hilton-Balfe.bpo-46522: Make various module
__getattr__AttributeErrors more closely match a typical AttributeErrorbpo-46475: Add
typing.Neverandtyping.assert_never(). Patch by Jelle Zijlstra.bpo-46333: The
__eq__()and__hash__()methods oftyping.ForwardRefnow honor themoduleparameter oftyping.ForwardRef. Forward references from different modules are now differentiated.bpo-46246: Add missing
__slots__toimportlib.metadata.DeprecatedList. Patch by Arie Bovenberg.bpo-46232: The
sslmodule now handles certificates with bit strings in DN correctly.bpo-46195:
typing.get_type_hints()no longer addsOptionalto parameters withNoneas a default. This aligns to changes to PEP 484 in https://github.com/python/peps/pull/689bpo-31369: Add
RegexFlagtore.__all__and documented it. AddNOFLAGto indicate no flags being set.bpo-45898:
ctypesno longer definesffi_type_*symbols incfield.c. The symbols have been provided by libffi for over a decade.bpo-44953: Calling
operator.itemgetterobjects andoperator.attrgetterobjects is now faster due to use of the vectorcall calling convention.bpo-44289: Fix an issue with
is_tarfile()method when using fileobj argument: position in the fileobj was advanced forward which made it unreadable withtarfile.TarFile.open().bpo-44011: Reimplement SSL/TLS support in asyncio, borrow the implementation from uvloop library.
bpo-41086: Make the
configparser.ConfigParserconstructor raiseTypeErrorif theinterpolationparameter is not of typeconfigparser.Interpolationbpo-29418: Implement
inspect.ismethodwrapper()and fixinspect.isroutine()for cases where methodwrapper is given. Patch by Hakan Çelik.bpo-14156: argparse.FileType now supports an argument of ‘-’ in binary mode, returning the .buffer attribute of sys.stdin/sys.stdout as appropriate. Modes including ‘x’ and ‘a’ are treated equivalently to ‘w’ when argument is ‘-’. Patch contributed by Josh Rosenberg
Documentation¶
bpo-42238:
Doc/tools/rstlint.pyhas moved to its own repository and is now packaged on PyPI assphinx-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_asyncioexecution.bpo-46678: The function
make_legacy_pycinLib/test/support/import_helper.pyno longer fails whenPYTHONPYCACHEPREFIXis 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-suffixwhen 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_NANmacro. Patch by Victor Stinner.bpo-46640: Building Python now requires a C99
<math.h>header file providing aNANconstant, 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_packagefield 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 cound 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 Filesfolder, rather thanProgram 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¶
C API¶
bpo-46748: Python’s public headers no longer import
<stdbool.h>, leaving code that embedd/extends Python free to definebool,trueandfalse.bpo-46836: Move the
PyFrameObjecttype definition (struct _frame) to the internal C APIpycore_frame.hheader file. Patch by Victor Stinner.bpo-45459: Rename
Include/buffer.hheader file toInclude/pybuffer.hto avoid conflits with projects having an existingbuffer.hheader file. Patch by Victor Stinner.bpo-45412: Remove the
HAVE_PY_SET_53BIT_PRECISIONmacro (moved to the internal C API). Patch by Victor Stinner.bpo-46613: Added function
PyType_GetModuleByDef(), which allows accesss 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
superobject. Patch by Kumar Aditya.bpo-45885: Added more fined-grained specialization failure stats regarding the
COMPARE_OPbytecode.bpo-44977: The delegation of
int()to__trunc__()is now deprecated. Callingint(a)whentype(a)implements__trunc__()but not__int__()or__index__()now raises aDeprecationWarning.bpo-46458: Reorder code emitted by the compiler for a
try-exceptblock so that theelseblock’s code immediately follows thetrybody (without a jump). This is more optimal for the happy path.bpo-46527: Allow passing
iterableas a keyword argument toenumerate()again. Patch by Jelle Zijlstra.bpo-46528: Replace several stack manipulation instructions (
DUP_TOP,DUP_TOP_TWO,ROT_TWO,ROT_THREE,ROT_FOUR, andROT_N) with newCOPYandSWAPinstructions.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 differentPRECALLinstructions:PRECALL_FUNTIONandPRECALL_METHOD. The latter pairs withLOAD_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 590vectorcallcalling convention. Patch by Donghee Na.bpo-46417: Fix a race condition on setting a type
__bases__attribute: the internal functionadd_subclass()now gets thePyTypeObject.tp_subclassesmember after callingPyWeakref_NewRef()which can trigger a garbage collection which can indirectly modifyPyTypeObject.tp_subclasses. Patch by Victor Stinner.bpo-46417:
python -X showrefcountnow 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_VALUEinstruction.bpo-46407: Optimize some modulo operations in
Objects/longobject.c. Patch by Jeremiah Vivian.bpo-46409: Add new
RETURN_GENERATORbytecode 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_INTERRUPTbytecode that acts likeJUMP_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 than2**30.bpo-46383: Fix invalid signature of
_zoneinfo’smodule_freefunction to resolve a crash on wasm32-emscripten platform.bpo-46361: Ensure that “small” integers created by
int.from_bytes()anddecimal.Decimalare 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_executablewhen 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
TypeErrormessage for non-string second arguments passed to the built-in functionsgetattr()andhasattr(). Patch by Géry Ogam.
Library¶
bpo-46624: Restore support for non-integer arguments of
random.randrange()andrandom.randint().bpo-46591: Make the IDLE doc URL on the About IDLE dialog clickable.
bpo-46565: Remove loop variables that are leaking into modules’ namespaces.
bpo-46553: In
typing.get_type_hints(), support evaluating bare stringifiedClassVarannotations. Patch by Gregory Beauregard.bpo-46544: Don’t leak
x&uspaceintermediate vars intextwrap.TextWrapper.bpo-46487: Add the
get_write_buffer_limitsmethod toasyncio.transports.WriteTransportand to the SSL transport.bpo-45173: Note the configparser deprecations will be removed in Python 3.12.
bpo-45162: The deprecated
unittestAPIs removed in 3.11a1 have been temporarily restored to be removed in 3.12 while cleanups in external projects go in.bpo-46539: In
typing.get_type_hints(), support evaluating stringifiedClassVarandFinalannotations insideAnnotated. Patch by Gregory Beauregard.bpo-46510: Add missing test for
types.TracebackTypeandtypes.FrameType. Calculate them directly from the caught exception without callingsys.exc_info().bpo-46491: Allow
typing.Annotatedto wraptyping.Finalandtyping.ClassVar. Patch by Gregory Beauregard.bpo-46483: Remove
__class_getitem__()frompathlib.PurePathas this class was not supposed to be generic.bpo-46436: Fix command-line option
-d/--directoryin modulehttp.serverwhich is ignored when combined with command-line option--cgi. Patch by Géry Ogam.bpo-41403: Make
mock.patch()raise aTypeErrorwith a relevant error message on invalid arg. Previously it allowed a crypticAttributeErrorto escape.bpo-46474: In
importlib.metadata.EntryPoint.pattern, avoid potential REDoS by limiting ambiguity in consecutive whitespace.bpo-46474: Removed private method from
importlib.metadata.Path. Sync with importlib_metadata 4.10.0.bpo-46470: Remove unused branch from
typing._remove_dups_flattenbpo-46469:
asynciogeneric classes now returntypes.GenericAliasin__class_getitem__instead of the same class.bpo-41906: Support passing filter instances in the
filtersvalues ofhandlersandloggersin the dictionary passed tologging.config.dictConfig().bpo-46422: Use
dis.Positionsindis.Instructioninstead of a regulartuple.bpo-46434:
pdbnow gracefully handleshelpwhen__doc__is missing, for example when run with pregenerated optimized.pycfiles.bpo-43869: Python uses the same time Epoch on all platforms. Add an explicit unit test to ensure that it’s the case. Patch by Victor Stinner.
bpo-46414: Add
typing.reveal_type(). Patch by Jelle Zijlstra.bpo-40280:
subprocessnow imports Windows-specific imports whenmsvcrtmodule is available, and POSIX-specific imports on all other platforms. This gives a clean exception when_posixsubprocessis not available (e.g. Emscripten browser target).bpo-40066:
IntEnum,IntFlag, andStrEnumuse the mixed-in type for theirstr()andformat()output.bpo-46316: Optimize
pathlib.Path.iterdir()by removing an unnecessary check for special entries.bpo-29688: Document
pathlib.Path.absolute()(which has always existed).bpo-43012: The pathlib module’s obsolete and internal
_Accessorclass has been removed to prepare the terrain for upcoming enhancements to the module.bpo-46258: Speed up
math.isqrt()for small positive integers by replacing two division steps with a lookup table.bpo-46242: Improve error message when creating a new
enum.Enumtype subclassing an existingEnumwith_member_names_usingenum.Enum.__call__().bpo-43118: Fix a bug in
inspect.signature()that was causing it to fail on some subclasses of classes with a__text_signature__referencing module globals. Patch by Weipeng Hong.bpo-26552: Fixed case where failing
asyncio.ensure_future()did not close the coroutine. Patch by Kumar Aditya.bpo-21987: Fix an issue with
tarfile.TarFile.getmember()getting a directory name with a trailing slash.bpo-46124: Update
zoneinfoto rely on importlib.resources traversable API.bpo-46103: Now
inspect.getmembers()only gets__bases__attribute from class type. Patch by Weipeng Hong.bpo-46080: Fix exception in argparse help text generation if a
argparse.BooleanOptionalActionargument’s default isargparse.SUPPRESSand it hashelpspecified. Patch by Felix Fontein.bpo-44791: Fix substitution of
ParamSpecinConcatenatewith different parameter expressions. Substitution with a list of types returns now a tuple of types. Substitution withConcatenatereturns now aConcatenatewith concatenated lists of arguments.
Documentation¶
bpo-46463: Fixes
escape4chm.pyscript 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_windowscleans 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_jsontests checking forRecursionError: modify these tests to usesupport.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 intented to test the readline module. Patch by Victor Stinner.
bpo-40280: Add
test.support.requires_fork()decorators to mark tests that require a workingos.fork().bpo-40280: Add
test.support.requires_subprocess()decorator to mark tests which require workingsubprocessmodule oros.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
-Ogoption in the./configurescript to also use-Ogon 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_UNSIGNEDmacro andpyconfig.hno 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=15option to theconfigurescript, or by definingPYLONG_BITS_IN_DIGITinpyconfig.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
PATHinstead 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 thePyTypeObject.tp_membersmember 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_bufferand variousPy_bufferrelated functions are now part of the limited API and stable ABI.bpo-14916: Fixed bug in the tokenizer that prevented
PyRun_InteractiveOnefrom 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, callingPyObject_GC_UnTrack()on the object crashed if the previous or the next object of thePyGC_Headstructure 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
FormattedValuehas changed to reflectconversionfield 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 typeupdate_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_STARTopcode.bpo-46235: Certain sequence multiplication operations like
[0] * 1_000are now faster due to reference-counting optimizations. Patch by Dennis Sweeney.bpo-46221:
PREP_RERAISE_STARno longer pusheslastito the stack.bpo-46202: Remove
POP_EXCEPT_AND_RERAISEand 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()andExceptionGroup.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_valuefield,exc_typeandexc_tracebackhave been removed as their values can be derived fromexc_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_METHODandCALL_METHOD_KW.Adds
CALL_NO_KWandCALL_KWcall instructions, andPRECALL_METHODprefix for pairing withLOAD_METHOD.bpo-46039: Remove the
YIELD_FROMinstruction and replace it with theSENDinstruction 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
SyntaxErrorexceptions emitted by the symbol table. Patch by Pablo Galindo.bpo-46049: Ensure
._pthfiles work as intended on platforms other than Windows.bpo-46048: Fixes parsing of
._pthfiles 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_NONEandPOP_JUMP_IF_NONEopcodes to speed up conditional jumps.bpo-46025: Fix a crash in the
atexitmodule involving functions that unregister themselves before raising exceptions. Patch by Pablo Galindo.bpo-46000: Improve compatibility of the
cursesmodule 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 specificallytype(obj).bpo-42918: Fix bug where the built-in
compile()function did not always raise aSyntaxErrorwhen 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 ofsetneeds to define a__init__()method if it defines a__new__()method with additional keyword parameters.bpo-43931: Added the
Py_Versionconstant which bears the same value asPY_VERSION_HEX. Patch by Gabriele N. Tornetta.
Library¶
bpo-46342: The
@typing.finaldecorator 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()andstring.Template.get_identifiers()methods.bpo-46306: Assume that
types.CodeTypealways hastypes.CodeType.co_firstlinenoindoctest.bpo-40479: Fix
hashlibusedforsecurity option to work correctly with OpenSSL 3.0.0 in FIPS mode.bpo-46070: Fix possible segfault when importing the
asynciomodule from different sub-interpreters in parallel. Patch by Erlend E. Aasland.bpo-46244: Removed
__slots__fromtyping.ParamSpecandtyping.TypeVar. They served no purpose. Patch by Arie Bovenberg.bpo-46278: Reflect
contextargument inAbstractEventLoop.call_*()methods. Loop implementations already support it.bpo-46269: Remove special-casing of
__new__inenum.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
venvmodule: executable for the executable and command for the command line used to create the environment.bpo-46239: Improve error message when importing
asyncio.windows_eventson non-Windows.bpo-46238: Reuse
_winapiconstants inasyncio.windows_events.bpo-46222: Adding
SF_NOCACHEsendfile constant for FreeBSD for the posixmodule.bpo-37295: Add fast path for
0 <= k <= n <= 67formath.comb().bpo-46176: Adding the
MAP_STACKconstant for the mmap module.bpo-43424: Deprecate
webbrowser.MacOSXOSAScript._nameand usenameinstead.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()andiglob()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. Callingadd_argument_group()oradd_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:
argparseraisesValueErrorwith clear message when trying to render usage for an empty mutually exclusive group. Previously it raised a crypticIndexError.bpo-45615: Functions in the
tracebackmodule raiseTypeErrorrather thanAttributeErrorwhen an exception argument is not of typeBaseException.bpo-16594: Add allow allow_reuse_port flag in socketserver.
bpo-27718: Fix help for the
signalmodule. Some functions (e.g.signal()andgetsignal()) were omitted.bpo-46032: The
registry()method offunctools.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.Unionandtypes.UnionTypeas dispatch argument tofunctools.singledispatch. Patch provided by Yurii Karabas.bpo-46018: Ensure that
math.expm1()does not raise on underflow.bpo-46016: Adding
F_DUP2FDandF_DUP2FD_CLOEXECconstants from FreeBSD into the fcntl module.bpo-45755:
typinggeneric aliases now reveal the class attributes of the original generic class when passed todir(). 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 tomultiprocessing.Eventobjects, patch by Kumar Aditya.bpo-45643: Added
signal.SIGSTKFLTon 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.TimeoutErrorandasyncio.TimeoutErrorwith builtinTimeoutError, keep these names as deprecated aliases.
Documentation¶
Tests¶
bpo-46296: Add a test case for
enumwith_use_args_ == Trueand_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
ValueErrorpath in tests forenum.Flag._missing_().bpo-46150: Now
fakenameintest_pathlib.PosixPathTest.test_expanduseris checked to be non-existent.bpo-46129: Rewrite
asyncio.lockstests withunittest.IsolatedAsyncioTestCaseusage.bpo-23819: Fixed
asynciotests 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, thepythonprogram 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 thePy_FrozenMain()function. Patch by Victor Stinner.bpo-40280: The
configurescript has a new option--with-emscripten-targetto select browser or node as Emscripten build target.bpo-46315: Added and fixed
#ifdef HAVE_FEATUREchecks for functionality that is not available on WASI platform.bpo-45723: Fixed a regression in
configurecheck forselect.epoll().bpo-46263:
configureno longer setsMULTIARCHon 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/wasmcontains WebAssembly-related helpers likeconfig.siteoverride 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_modulefor all but importlib bootstrap files.--with-freeze-moduleconfigure 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¶
bpo-46236: Fix a bug in
PyFunction_GetAnnotations()that caused it to return atupleinstead of adict.bpo-46140:
PyBuffer_GetPointer(),PyBuffer_FromContiguous(),PyBuffer_ToContiguous()andPyMemoryView_FromBuffer()now take buffer info byconst Py_buffer *instead ofPy_buffer *, as they do not need mutability.PyBuffer_FromContiguous()also now takes the source buffer asconst void *, and similarlyPyBuffer_GetPointer()takes the strides asconst Py_ssize_t *.bpo-45855: Document that the no_block argument to
PyCapsule_Import()is a no-op now.bpo-45855: Replaced deprecated usage of
PyImport_ImportModuleNoBlock()withPyImport_ImportModule()in stdlib modules. Patch by Kumar Aditya.bpo-46007: The
PyUnicode_CHECK_INTERNED()macro has been excluded from the limited C API. It was never usable there, because it used internal structures which are not available in the limited C API. Patch by Victor Stinner.
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 togen_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
SyntaxErrorlocation for errors involving for loops with invalid targets. Patch by Pablo Galindobpo-45711:
_PyErr_ChainStackItem()no longer normalizesexc_info(including setting the traceback on the exception instance) becauseexc_infois always normalized.bpo-45607: The
__note__field was added toBaseException. It isNoneby 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_fdnow uses fasterfcntl(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_infoare now always consistent with each other. In particular, thetypeandtracebackfields are now derived from the exception instance. This impacts the return values ofsys.exc_info()andPyErr_GetExcInfo()if the exception instance is modified while the exception is handled, as well asPyErr_SetExcInfo(), which now ignores thetypeandtracebackarguments 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_OPopcode 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
tracebackdisplay 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_VARSopcode, to make copying of free variables from function to frame explicit. Helps optimization of calls to Python function.bpo-45829: Specialize
BINARY_SUBSCRfor classes with a__getitem__method implemented in Pythonbpo-45826: Fixed a crash when calling
.with_traceback(None)onNameError. This occurs internally inunittest.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_OPby 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 adef-statement:>>> def f: File "<stdin>", line 1 def f: ^ SyntaxError: expected '('
bpo-45609: Specialized the
STORE_SUBSCRopcode using the PEP 659 machinery.bpo-45636: Replace all numeric
BINARY_*andINPLACE_*instructions with a singleBINARY_OPimplementation.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 insysandsysconfig.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.Elementsimultaneously with replacing theattribdict.bpo-45711: Make
asyncionormalize exceptions as soon as they are captured withPyErr_Fetch(), and before they are stored as an exc_info triplet. This bringsasyncioin 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.TextTestResultandunittest.TextTestRunnerflush 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:
faulthandlercan 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:
sqliteC 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 beforePyObject_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
sqlite3incorrectly would useSQLITE_LIMIT_LENGTHwhen checking SQL statement lengths. Now,SQLITE_LIMIT_SQL_LENGTHis 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
disproduced an incorrect oparg whenEXTENDED_ARGis followed by an opcode that does not use its argument.bpo-45644: In-place JSON file formatting using
python3 -m json.tool infile infilenow 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.pathlocation while the program is running, calling theimportlib.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()andtypes.new_class()fortypes.GenericAliasinstance as a base.bpo-45663: Fix
dataclasses.is_dataclass()for dataclasses which are subclasses oftypes.GenericAlias.bpo-45662: Fix the repr of
dataclasses.InitVarwith 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()andmath.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_childtoconcurrent.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 suspiciouswill be removed soon in favor ofmake -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.socketdocumentation is corrected to a class from a function.bpo-45392: Update the docstring of the
typebuilt-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()andasdict()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
--findleakscommand line option of regrtest: use the--fail-env-changedoption instead. Since Python 3.7, it was a deprecated alias to the--fail-env-changedoption.bpo-45701: Add tests with
tupletype withfunctools.lru_cache()totest_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-pythonand--with-freeze-moduleoptions to make cross compiling easier.bpo-40280: Emscripten platform now uses
.wasmsuffix by default.bpo-40280: Disable unusable core extension modules on WASM/Emscripten targets.
bpo-40280:
configurenow checks for socketshutdownfunction. The check makes it possible to disableSYS_shutdownwithac_cv_func_shutdown=noin CONFIG_SITE.bpo-40280:
configurenow checks for functionsfork1, getegid, geteuid, getgid, getppid, getuid, opendir, pipe, system, wait, ttyname.bpo-33393: Update
config.guessto 2021-06-03 andconfig.subto 2021-08-14.Makefilenow has anupdate-configtarget to make updating more convenient.bpo-45866:
make regen-allnow 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:
configurenow accepts machinewasm32orwasm64and OSwasioremscriptenfor cross building, e.g.wasm32-unknown-emscripten,wasm32-wasi, orwasm32-unknown-wasi.bpo-41498: Python now compiles on platforms without
sigset_t. Several functions insignalare not available whensigset_tis missing.Based on patch by Roman Yurchak for pyodide.
bpo-45881:
setup.pynow usesCCfrom environment first to discover multiarch and cross compile paths.bpo-45886: The
_freeze_moduleprogram 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_pythonbuild 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_MODmacro andaddext().bpo-45723: Add
autoconfhelpers 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]): RunSCRIPTwrapped withSAVE_ENVandRESTORE_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:
configurenow createsModules/Setup.stdlibwith conditionally enabled/disabled extension module lines. The file is not used, yet.bpo-45573:
configurenow uses a unified format to set state, compiler flags, and linker flags in Makefile. The new macroPY_STDLIB_MODsets three variables that are consumed byModules/Setupandsetup.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
pyexpatC extension are now detected byconfigure. The bundledexpatlibrary is built inMakefile.bpo-45798: Settings for
decimalinternal C extension are now detected byconfigure. The bundledlibmpdeclibrary is built inMakefile.bpo-45723: configure has a new option
--with-pkg-configto disable or require pkg-config.bpo-45774: The build dependencies for
sqlite3are now detected byconfigureandpkg-config. Patch by Erlend E. Aasland.bpo-45763: The build dependencies for
zlib,bz2, andlzmaare now detected byconfigure.bpo-45747: gdbm and dbm build dependencies are now detected by
configure.bpo-45743: On macOS, the build system no longer passes
search_paths_firstto the linker. The flag has been the default since Xcode 4 / macOS 10.6.bpo-45723:
configure.acis now compatible with autoconf 2.71. Deprecated checksSTDC_HEADERSandAC_HEADER_TIMEhave been removed.bpo-45723:
configurenow prints a warning when pkg-config is missing.bpo-45731:
configure --enable-loadable-sqlite-extensionsis now handled by newPY_SQLITE_ENABLE_LOAD_EXTENSIONmacro instead of logic in setup.py.bpo-45723: configure.ac now uses custom helper macros and
AC_CACHE_CHECKto 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.pathin a venv on Windows.bpo-45901: When installed through the Microsoft Store and set as the default app for
*.pyfiles, command line arguments will now be passed to Python when invoking a script without explicitly launching Python (that is,script.py argsrather thanpython 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.dllwas 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
SyntaxErrormessage when usingTrue,NoneorFalseas keywords in a function call. Patch by Pablo Galindo.bpo-45688:
sys.stdlib_module_namesnow contains the macOS-specific module_scproxy.bpo-45379: Clarify
ImportErrormessage when we try to explicitly import a frozen module but frozen modules are disabled.bpo-44525: Specialize simple calls to Python functions (no starargs, keyowrd 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 Value comparisons 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
-Xoption 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_MULTIPLYopcode toBINARY_MULTIPLY_INTandBINARY_MULTIPLY_FLOATusing 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 usingPyImport_ImportFrozenModule(). Also, at the momentco_filenameis 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 thanmodule.__spec__.namethen the module was defined as an alias in Tools/scripts/freeze_modules.py. If it isNonethen 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
ExceptionGroupandBaseExceptionGroup. 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_sizeto -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_FUNCTIONopcode. Implemented initial specializations for C function calls:CALL_FUNCTION_BUILTIN_OforMETH_Oflag.CALL_FUNCTION_BUILTIN_FASTforMETH_FASTCALLflag without keywords.CALL_FUNCTION_LENforlen(o).CALL_FUNCTION_ISINSTANCEforisinstance(o, t).
bpo-44511: Improve the generated bytecode for class and mapping patterns.
bpo-43706: Speed up calls to
enumerate()by using the PEP 590vectorcallcalling convention. Patch by Donghee Na.
Library¶
bpo-45679: Fix caching of multi-value
typing.Literal.Literal[True, 2]is no longer equal toLiteral[1, 2].bpo-42064: Convert
sqlite3to multi-phase initialisation (PEP 489). Patches by Erlend E. Aasland.bpo-45438: Fix typing.Signature string representation for generic builtin types.
bpo-45613:
sqlite3now setssqlite3.threadsafetybased on the default threading mode the underlying SQLite library has been compiled with. Patch by Erlend E. Aasland.bpo-45574: Fix warning about
print_escapebeing unused.bpo-45581:
sqlite3.connect()now correctly raisesMemoryErrorif 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()tooperator.__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.NamespaceLoaderis now public, and implements theimportlib.abc.InspectLoaderinterface._NamespaceLoaderis kept for backward compatibility.bpo-45515: Add references to
zoneinfoin thedatetimedocumentation, mostly replacing outdated references todateutil.tz. Change by Paul Ganssle.bpo-45475: Reverted optimization of iterating
gzip.GzipFile,bz2.BZ2File, andlzma.LZMAFile(see bpo-43787) because it caused regression when user iterate them without having reference of them. Patch by Inada Naoki.bpo-45489: Update
ForwardRefto 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 withUnboundLocalErroron certain invalid input instead of returningNone. 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 theend_offsetin the exception is set to 0. Patch by Pablo Galindobpo-45416: Fix use of
asyncio.Conditionwith explicitasyncio.Lockobjects, 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
doctestmodule that caused it to fail if a docstring included an example with aclassmethodproperty. Patch by Alex Waygood.bpo-45406: Make
inspect.getmodule()catchFileNotFoundErrorraised byinspect.getabsfile(), and returnNoneto 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
ServerHTMLDocwhich now uses the CSS too. cgitb now relies less on pydoc (as it can’t use the CSS file).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.clientmore robust to C runtimes where the underlying Cstrftimefunction results in aValueErrorwhen testing for year formatting options.bpo-20028: Improve error message of
csv.Dialectwhen 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.HTTPConnectionto work properly in OSs that don’t support theTCP_NODELAYsocket option.bpo-45243: Add
setlimit()andgetlimit()tosqlite3.Connectionfor setting and getting SQLite limits by connection basis. Patch by Erlend E. Aasland.bpo-45320: Removed from the
inspectmodule:- the
getargspecfunction, deprecated since Python 3.0; use
inspect.signature()orinspect.getfullargspec()instead.
- the
the
formatargspecfunction, deprecated since Python 3.5; use theinspect.signature()function andSignatureobject directly.the undocumented
Signature.from_callableandSignature.from_functionfunctions, deprecated since Python 3.5; use theSignature.from_callable()method instead.
Patch by Hugo van Kemenade.
bpo-45192: Fix the
tempfile._infer_return_typefunction so that thedirargument of thetempfilefunctions accepts an object implementing theos.PathLikeprotocol.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 aroundchdir().bpo-24139: Add support for SQLite extended result codes in
sqlite3.Error. Patch by Erlend E. Aasland.bpo-24444: Fixed an error raised in
argparsehelp 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 afractions.Fractioninstancefpasses anisinstance(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¶
bpo-45726: Improve documentation for
functools.singledispatch()andfunctools.singledispatchmethod.bpo-45680: Amend the docs on
GenericAliasobjects to clarify that non-container classes can also implement__class_getitem__. Patch contributed by Alex Waygood.bpo-45618: Update Sphinx version used to build the documentation to 4.2.0. Patch by Maciej Olko.
bpo-45655: Add a new “relevant PEPs” section to the top of the documentation for the
typingmodule. Patch by Alex Waygood.bpo-45604: Add
levelargument tomultiprocessing.log_to_stderrfunction docs.bpo-45516: Add protocol description to the
importlib.abc.TraversableResourcesdocumentation.bpo-45464: Mention in the documentation of Built-in Exceptions that inheriting from multiple exception types in a single subclass is not recommended due to possible memory layout incompatibility.
bpo-45449: Add note about PEP 585 in
collections.abc.bpo-45516: Add protocol description to the
importlib.abc.Traversabledocumentation.bpo-20692: Add Programming FAQ entry explaining that int literal attribute access requires either a space after or parentheses around the literal.
Tests¶
bpo-45678: Add tests for scenarios in which
functools.singledispatchmethodis 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.singledispatchmethodcorrectly 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
pickleprotocols intest_zoneinfo.bpo-45566: Fix
test_frozen_pickleintest_dataclassesto check allpickleversions.bpo-43592:
test.libregrtestnow 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.singledispatchmethodwhen combined with@classmethodor@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
sqlite3tests fromtest_sqlitetotest_sqlite3, and relocate them toLib/test/test_sqlite3. Patch by Erlend E. Aasland.
Build¶
bpo-43158:
setup.pynow uses values from configure script to build the_uuidextension module. Configure now detects util-linux’slibuuid, too.bpo-45666: Fix warning of
swprintfand%susage in_testembed.cbpo-45548:
Modules/SetupandModules/makesetuphave been improved. TheSetupfile now contains working rules for all extensions. Outdated comments have been removed. Rules defined bymakesetuptrack dependencies correctly.bpo-45548: The
mathandcmathimplementation now require a C99 compatiblelibmand no longer ship with workarounds for missing acosh, asinh, atanh, expm1, and log1p functions.bpo-45595:
setup.pyandmakesetupnow track build dependencies on all Python header files and module specific header files.bpo-45571:
Modules/Setupnow usePY_CFLAGS_NODISTinstead ofPY_CFLAGSto compile shared modules.bpo-45570:
pyexpatand_elementtreeno longer define obsolete macrosHAVE_EXPAT_CONFIG_HandUSE_PYEXPAT_CAPI.XML_POOR_ENTROPYis now defined inexpat_config.h.bpo-43974:
setup.pyno longer definesPy_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.versionto usemainas fallback information. Patch by Jeong YunWon.bpo-45536: The
configurescript 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
LDFLAGSandCPPFLAGSoptions whereargparse.parse_known_args()could interpret an option as one of the built-in command line argument, for example-hfor 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 errorwhen runningconfigurewith 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_AUTOINITon 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 thePyWeakReferencestructure is opaque in the limited C API.bpo-35081: Move the
interpreteridobject.hheader file fromInclude/toInclude/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.handlongintrepr.hhave been moved to theInclude/cpythondirectory. Moreover, theeval.hheader file was removed. These files must not be included directly, as they are already included inPython.h: Include Files. If they have been included directly, consider includingPython.hinstead. Patch by Victor Stinner.bpo-45474: The following items are no longer available when
Py_LIMITED_APIis defined:the
Py_MARSHAL_VERSIONmacro
These are not part of the limited API.
Patch by Victor Stinner.
bpo-45434: Remove the
pystrhex.hheader 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 thePy_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 thePy_LIMITED_APImacro is set to0x030b0000(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()andPy_UNICODE_FILL()macros, deprecated since Python 3.3. UsePyUnicode_CopyCharacters()ormemcpy()(wchar_t*string), andPyUnicode_Fill()functions instead. Patch by Victor Stinner.bpo-45412: Remove the following math macros using the
errnovariable: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(), andPyThreadState_LeaveTracing()functions to the limited C API to suspend and resume tracing and profiling. Patch by Victor Stinner.bpo-44220:
PyStructSequence_UnnamedFieldis added to the Stable ABI.
Python 3.11.0 alpha 1¶
Release date: 2021-10-05
Security¶
bpo-42278: Replaced usage of
tempfile.mktemp()withTemporaryDirectoryto 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
marshalmodule, and stop raisingcode.__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.pycfiles.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
putcmdfunction insmtplibsanitize input for presence of\rand\ncharacters to avoid (unlikely) command injection.bpo-44022:
http.clientnow avoids infinitely reading potential HTTP headers after a100 Continuestatus 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.GenericAliasobjects.bpo-45155:
int.to_bytes()andint.from_bytes()now take a default value of"big"for thebyteorderargument.int.to_bytes()also takes a default value of1for thelengthargument.bpo-44219: Release the GIL while performing
isattysystem calls on arbitrary file descriptors. In particular, this affectsos.isatty(),os.device_encoding()andio.TextIOWrapper. By extension,io.open()in text mode is also affected. This change solves a deadlock inos.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__raisesRecursionErrorwhen it’s called directly or viasuper(). Patch provided by Yurii Karabas.bpo-44348: The deallocator function of the
BaseExceptiontype now uses the trashcan mechanism to prevent stack overflow. For example, when aRecursionErrorinstance 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()andfileinput.FileInputno 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
tracebackmodule 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 oflist.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 duringstat(),lstat(), andfstatat()syscalls made byos.DirEntry.stat(). Patch by Stanisław Skonieczny.bpo-45018: Fixed pickling of range iterators that iterated for over
2**32times.bpo-45000: A
SyntaxErroris now raised when trying to delete__debug__. Patch by Donghee Na.bpo-44963: Implement
send()andthrow()methods foranext_awaitableobjects. 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 thebytestype, so a bytes objectbpasses anisinstance(b, typing.SupportsBytes)check.bpo-24234: Implement the
__complex__()special method on thecomplextype, so a complex numberzpasses anisinstance(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.Flagstring 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
floatorcomplex.bpo-44895: A debug variable
PYTHONDUMPREFSFILEis 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_CACHEDLOAD_METHOD_MODULELOAD_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 macrosPy_TRASHCAN_BEGINandPy_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_SetObjecthangs 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
SyntaxErrorfor 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.Uniontotypes.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
typingtypes in parameter substitution in the union type.bpo-44676: Add ability to serialise
types.Unionobjects. Patch provided by Yurii Karabas.bpo-44633: Parameter substitution of the union type with wrong types now raises
TypeErrorinstead of returningNotImplemented.bpo-44661: Update
property_descr_setto use vectorcall if possible. Patch by Donghee Na.bpo-44662: Add
__module__totypes.Union. This also fixestypes.Unionissues withtyping.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 | intis nowint. 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
Nonetotype(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
matchstatements with two or more equal literal keys will now raise aSyntaxErrorat compile-time.bpo-44606: Fix
__instancecheck__and__subclasscheck__for the union type.bpo-42073: The
@classmethoddecorator 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 (
PYTHONTHREADDEBUGenvironment 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:
typingnow searches for type parameters intypes.Unionobjects.get_type_hintswill also properly resolve annotations with nestedtypes.Unionobjects. 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 initializingtypes.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_IMMUTABLETYPEflag 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.Unionto break reference cycles and prevent memory leaks.bpo-44490: Add
__parameters__attribute and__getitem__operator totypes.Union. Patch provided by Yurii Karabas.bpo-44523: Remove the pass-through for
hash()ofweakref.proxyobjects 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.Unionobjects 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
TypeErroris now raised instead of anAttributeErrorinwithandasync withstatements 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. Ensures that backtraces inclusing 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**2orpow(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_METHODfor directly accessed objects on their namespace. They now use the regularLOAD_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
sqlite3module that happened when the garbage collector clearssqlite.Statementobjects. Patch by Pablo Galindobpo-44305: Improve error message for
tryblocks withoutexceptorfinallyblocks. 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 ofsetcan 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 functiontype_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:
PyCodeObjectgainedco_fastlocalnamesandco_fastlocalkindsas 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.care 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 messagebpo-26110: Add
CALL_METHOD_KWopcode to speed up method calls with keyword arguments. Idea originated from PyPy. A side effect is executingCALL_METHODis 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
defaultargument in the docstring of the newanextbuiltin.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.ASTobjects with recursive references throughcompile(), the interpreter doesn’t crash anymore instead it raises aRecursionError.bpo-39091: Fix crash when using passing a non-exception to a generator’s
throw()method. Patch by Noah Oxerbpo-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.xmlparserwhen 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), thethreading.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 thethreadingmodule 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 thethreadingmodule. 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 thenanosleep()function, ifclock_nanosleep()is not available butnanosleep()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 aunittest.SkipTestif 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()raisingFileNotFoundErrorwhen source is a directory, which should raiseIsADirectoryErrorbpo-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_loaderis 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 forstr,float,int, andcomplex. 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 toco_consts,co_namesetc 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 theclock_nanosleep()function, if available, which allows to sleep for an interval specified with nanosecond precision.bpo-45173: Remove from the
configparsermodule: theSafeConfigParserclass, thefilenameproperty of theParsingErrorclass, thereadfp()method of theConfigParserclass, 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()withstrict=Falseno longer affects the result of the following call withstrict=True. Also, mutating the returned list no longer affects the global state.bpo-45166:
typing.get_type_hints()now works withFinalwrapped inForwardRef.bpo-45162: Remove many old deprecated
unittestfeatures:“
fail*” and “assert*” aliases ofTestCasemethods.Broken from start
TestCasemethodassertDictContainsSubset().Ignored
<unittest.TestLoader.loadTestsFromModule> TestLoader.loadTestsFromModule()parameter use_load_tests.Old alias
_TextTestResultofTextTestResult.
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 ofxml.dom.pulldom.DOMEventStream,wsgiref.util.FileWrapperandfileinput.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 optionSO_REUSEADDRin UDP.Patch by Hugo van Kemenade.
bpo-45124: The
bdist_msicommand, deprecated in Python 3.9, is now removed.Use
bdist_wheel(wheel packages) instead.Patch by Hugo van Kemenade.
bpo-30856:
unittest.TestResultmethodsaddFailure(),addError(),addSkip()andaddSubTest()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.packwith'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:
unittestnow 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.Protocolsubclasses have wrong__init__. Patch provided by Yurii Karabas.bpo-45085: The
binhexmodule, deprecated in Python 3.9, is now removed. The followingbinasciifunctions, 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
lib2to3package 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()totraceback.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
Nonefrom aformat_frame()override.bpo-41620:
run()now always return aTestResultinstance. Previously it returnedNoneif 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.futuresmodulebpo-43913: Fix bugs in cleaning up classes and modules in
unittest:Functions registered with
addModuleCleanup()were not called unless the user definestearDownModule()in their test module.Functions registered with
addClassCleanup()were not called iftearDownClassis set toNone.Buffering in
TestResultdid not work with functions registered withaddClassCleanup()andaddModuleCleanup().Errors in functions registered with
addClassCleanup()andaddModuleCleanup()were not handled correctly in buffered and debug modes.Errors in
setUpModule()and functions registered withaddModuleCleanup()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__inunittest.mock. It is not used in Python 3.bpo-39218: Improve accuracy of variance calculations by using
x*xinstead ofx**2.bpo-43613: Improve the speed of
gzip.compress()andgzip.decompress()by compressing and decompressing at once in memory instead of in a streamed fashion.bpo-37596: Ensure that
setandfrozensetobjects are alwaysmarshalledreproducibly.bpo-44019: A new function
operator.callhas been added, such thatoperator.call(obj, *args, **kwargs) == obj(*args, **kwargs).bpo-42255:
webbrowser.MacOSXis 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 methodstartTestRun()forTestResultobjects implicitly created inrun(). Previously it was not called for test methods and classes decorated with a skipping decorator.bpo-39039: tarfile.open raises
ReadErrorwhen a zlib error occurs during file extraction.bpo-44935:
subprocesson Solaris now also usesos.posix_spawn()for better performance.bpo-44911:
IsolatedAsyncioTestCasewill no longer throw an exception while cancelling leaked tasks. Patch by Bar Harel.bpo-41322: Added
DeprecationWarningfor 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 withargparse.ArgumentDefaultsHelpFormatter.bpo-44860: Fix the
posix_userscheme insysconfigto not depend onsys.platlibdir.bpo-44859: Improve error handling in
sqlite3and raise more accurate exceptions.MemoryErroris now raised instead ofsqlite3.Warningwhen memory is not enough for encoding a statement to UTF-8 inConnection.__call__()andCursor.execute().UnicodEncodeErroris now raised instead ofsqlite3.Warningwhen the statement contains surrogate characters inConnection.__call__()andCursor.execute().TypeErroris now raised instead ofValueErrorfor non-string script argument inCursor.executescript().ValueErroris now raised for script containing the null character instead of truncating it inCursor.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 theO_PATHflag: ignore theEBADFerror onioctl(), fallback on thefcntl()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 beNone.bpo-44839:
MemoryErrorraised in user-defined functions will now produce aMemoryErrorinsqlite3.OverflowErrorwill now be converted toDataError. PreviouslyOperationalErrorwas produced in these cases.bpo-44822:
sqlite3user-defined functions and aggregators returningstringswith embedded NUL characters are no longer truncated. Patch by Erlend E. Aasland.bpo-44801: Ensure that the
ParamSpecvariable 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.Protocolignore now the__init__method inherited from protocol base classes.bpo-27275:
collections.OrderedDict.popitem()andcollections.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
ParamSpecparameter.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 aNEWLINEtoken if the source doesn’t end with a new line character but the last line is a comment, as the function is already generating aNLtoken. Patch by Pablo Galindobpo-44771: Added
importlib.simplemodule implementing adapters from a low-level resources reader interface to aTraversableResourcesinterface. 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 withimportlib_resources5.2.bpo-44752:
rcompleterdoes not callgetattr()onpropertyobjects to avoid the side-effect of evaluating the corresponding method.bpo-44747: Refactor usage of
sys._getframeintypingmodule. Patch provided by Yurii Karabas.bpo-42378: Fixes the issue with log file being overwritten when
logging.FileHandleris used inatexitwith 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.proxyobjects referencing non-iterators now raiseTypeErrorrather than dereferencing the nulltp_iternextslot and crashing.bpo-44704: The implementation of
collections.abc.Set._hash()now matches that offrozenset.__hash__().bpo-44666: Fixed issue in
compileall.compile_file()whensys.stdoutis 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
_sslmodule that was throwingOverflowErrorwhen using_ssl._SSLSocket.write()and_ssl._SSLSocket.read()for a big value of thelenparameter. Patch by Pablo Galindobpo-44686: Replace
unittest.mock._importerwithpkgutil.resolve_name.bpo-44353: Make
NewType.__call__faster by implementing it in C. Patch provided by Yurii Karabas.bpo-44682: Change the
pdbcommands directive to disallow setting commands for an invalid breakpoint and to display an appropriate error.bpo-44353: Refactor
typing.NewTypefrom 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 totypingmodule 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 ofTypeError, it should beOSErrorwith 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
ExitStackandAsyncExitStackexception chaining. They will now matchwithblock behavior when__context__is explicitly set toNonewhen 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 raiseFileNotFoundErrorinstead of confusingIsADirectoryErrorwhen a path ending with aos.path.sepdoes not exist;shutil.copy()andshutil.copy2()are also affected.bpo-44569: Added the
StackSummary.format_frame()function intraceback. 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
TypedDictto work withtyping.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.PrettyPrinterconstruction 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__modulebpo-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
sqlite3authorizer callback by passingNonetoset_authorizer(). Patch by Erlend E. Aasland.bpo-43977: Set the proper
Py_TPFLAGS_MAPPINGandPy_TPFLAGS_SEQUENCEflags for subclasses created before a parent has been registered as acollections.abc.Mappingorcollections.abc.Sequence.bpo-44482: Fix very unlikely resource leak in
globin alternate Python implementations.bpo-44466: The
faulthandlermodule now detects if a fatal error occurs during a garbage collector collection. Patch by Victor Stinner.bpo-44471: A
TypeErroris now raised instead of anAttributeErrorincontextlib.ExitStack.enter_context()andcontextlib.AsyncExitStack.enter_async_context()for objects which do not support the context manager or asynchronous context manager protocols correspondingly.bpo-44404:
tkinter’safter()method now supports callables without the__name__attribute.bpo-41546: Make
pprint(like the builtinprint) not attempt to write tostdoutwhen it isNone.bpo-44458:
BUFFER_BLOCK_SIZEis 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
linenomight beNoneintraceback.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_GCflag. 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
constkwarg is not provided. Previously, this raised aTypeError.bpo-44389: Fix deprecation of
ssl.OP_NO_TLSv1_3bpo-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
sslmodule’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()indistutils.sysconfigbecause it behaves differently than the similar implementation insysconfig.bpo-35800:
smtpd.MailmanProxyis 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 returninfinstead of raisingValueError. This brings the special-case handling ofmath.powinto compliance with the IEEE 754 standard.bpo-44242: Remove missing flag check from Enum creation and move into a
verifydecorator.bpo-44246: In
importlib.metadata, restore compatibility in the result fromDistribution.entry_points(EntryPoints) to honor expectations in older implementations and issuing deprecation warnings for these cases: A.EntryPointsobjects are once again mutable, allowing forsort()and other list-based mutation operations. Avoid deprecation warnings by casting to a mutable sequence (e.g.list(dist.entry_points).sort()). B.EntryPointsresults 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.Randomconstructor 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
.formatin 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.coroutinedecorator enabling legacy generator-based coroutines to be compatible with async/await code; removeasyncio.coroutines.CoroWrapperused 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
sqlite3context 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.Fractionpickling for large components.bpo-33433: For IPv4 mapped IPv6 addresses (RFC 4291 Section 2.5.5.2), the
ipaddress.IPv6Address.is_privatecheck 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:
hmaccomputations were not releasing the GIL while calling the OpenSSLHMAC_UpdateC API (a new feature in 3.9). This unintentionally prevented parallel computation as otherhashlibalgorithms support.bpo-44095:
zipfile.Pathnow supportszipfile.Path.stem,zipfile.Path.suffixes, andzipfile.Path.suffixattributes.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.Protocolwhich only have data variables declared will now raise aTypeErrorwhen checked withisinstanceunless they are decorated withruntime_checkable(). Previously, these checks passed silently. Patch provided by Yurii Karabas.bpo-44098:
typing.ParamSpecwill no longer be found in the__parameters__of mosttypinggenerics except in valid use locations specified by PEP 612. This prevents incorrect usage liketyping.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.Errorin 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 separatelambdaand the:if there are no parameters.bpo-44061: Fix regression in previous release when calling
pkgutil.iter_modules()with a list ofpathlib.Pathobjectsbpo-44059: Register the SerenityOS Browser in the
webbrowsermodule.bpo-36515: The
hashlibmodule 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, andPatterntotyping.__all__. Patch by Jelle Zijlstra.bpo-44002:
urllib.parsenow usesfunctool.lru_cache()for its internal URL splitting and quoting caches instead of rolling its own like its the ’90s.The undocumented internal
urllib.parseQuotedclass API is now deprecated, for removal in 3.14.bpo-43972: When
http.server.SimpleHTTPRequestHandlersends a301 (Moved Permanently)for a directory path not ending with/, add aContent-Length: 0header. This improves the behavior for certain clients.bpo-28528: Fix a bug in
pdbwherecheckline()raisesAttributeErrorif it is called afterreset().bpo-43853: Improved string handling for
sqlite3user-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
MemoryErrorinshutil.unpack_archive()which fails insideshutil._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 azlib.compressobj. It also provides a faster alternative togzip.compresswhen 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 toimportlib.import_module()andimportlib.__import__().bpo-43318: Fix a bug where
pdbdoes not always echo cleared breakpoints.bpo-43234: Prohibit passing non-
concurrent.futures.ThreadPoolExecutorexecutors toloop.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.EQFULLfor platforms that define this constant (such as macOS).bpo-43086: Added a new optional
strict_modeparameter to binascii.a2b_base64. Whenscrict_modeis set toTrue, 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()andtraceback.format_exception_only().bpo-33809: Add the
traceback.TracebackException.print()method which prints the formatted exception information.bpo-42862:
sqlite3now utilizesfunctools.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 raisesValueErrorwhen the invalid keyword argument check is passed by user code. Previously such use would fail later with aTypeError. Patch by Rémi Lapeyre.bpo-37449:
ensurepipnow usesimportlib.resources.files()traversable APIsbpo-40956: Use Argument Clinic in
sqlite3. Patches by Erlend E. Aasland.bpo-41730:
DeprecationWarningis now raised when importingtkinter.tix, which has been deprecated in documentation since Python 3.6.bpo-20684: Remove unused
_signature_get_bound_paramfunction frominspect- by Anthony Sottile.bpo-41402: Fix
email.message.EmailMessage.set_content()when called with binary data and7bitcontent 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
threadingsynchronization objects:Semaphore,BoundedSemaphore,EventandBarrier.bpo-5846: Deprecated the following
unittestfunctions, scheduled for removal in Python 3.13:findTestCases()makeSuite()getTestCaseNames()
Use
TestLoadermethods 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:
pdbnow displays exceptions fromrepr()with itspandppcommands.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 matchcontextlib.contextmanager()so decorated functions can themselves be decorators.bpo-30256: Pass multiprocessing BaseProxy argument
manager_ownedthrough AutoProxy.bpo-27513:
email.utils.getaddresses()now acceptsemail.header.Headerobjects along with string values. Patch by Zackery Spytz.bpo-16379: Add SQLite error code and name to
sqlite3exceptions. 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
TypeErrorwhen required subparsers withoutdestdo 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.abcdocumentation 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 | Ymore prominently in section aboutUnionand mentionX | Noneat all in section aboutOptional.bpo-16580: Added code equivalents for the
int.to_bytes()andint.from_bytes()methods, as well as tests ensuring that these code equivalents are valid.bpo-44903: Removed the
othergui.rstfile, 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:
base64RFC 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(), andtextwrap.shorten(). Now, there are nav links to attributes ofTextWrap, 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
zipfiledocs: 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__.pyin 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_GenericAliasandPy_GenericAliasType.bpo-38291: Mark
typing.ioandtyping.reas 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
loopparameter for many functions and classes inasyncio.bpo-44195: Corrected references to
TraversableResourcesin docs. There is noTraversableReader.bpo-41963: Document that
ConfigParserstrips 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
dataclassesdocumentation 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.defaultdictparameterdefault_factorydefaults 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
markerstype is supplied toc_make_encoder.bpo-45128: Fix
test_multiprocessing_forkfailure due totest_loggingandsys.modulesmanipulation.bpo-45209: Fix
UserWarning: resource_trackerwarning in_test_multiprocessing._TestSharedMemory.test_shared_memory_cleaned_after_process_terminationbpo-45185: Enables
TestEnumerationstest cases intest_sslsuite.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 bycreate_autospec().bpo-45125: Improves pickling tests and docs of
SharedMemoryandSharableListobjects.bpo-44860: Update
test_sysconfig.test_user_similar()for the posix_user scheme:platlibdoesn’t usesys.platlibdir. Patch by Victor Stinner.bpo-45052:
WithProcessesTestSharedMemory.test_shared_memory_basicstest was ignored, becauseself.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
sizeofSharedMemoryis 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_hashdigestwere skipped all the time.bpo-25130: Add calls of
gc.collect()in tests to support PyPy.bpo-45011: Made tests relying on the
_asyncioC 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 whenobj * 1is used onstrandbytesobjects. 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_TIMEOUTtimeout 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
DeprecationWarningfilters intest.test_importlib.test_metadata_api.APITests.test_entry_points_by_indexto avoidStopIterationerror ifDeprecationWarningsare 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, sinceread()can raisessl.SSLEOFErroron 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_NewTypeaccepts aPyStructSequence_Descwithdocfield set toNULL.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
multiprocessingshared objectsAutoProxy[Queue]insideListProxyandDictProxy
Build¶
bpo-45220: Avoid building with the Windows 11 SDK previews automatically. This may be overridden by setting the
DefaultWindowsSDKVersionenvironment 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
EnableControlFlowGuardset toguardto enable CFG.bpo-41282: Fix broken
make installthat caused standard library extension modules to be unnecessarily and incorrectly rebuilt during the install phase of cpython.
Windows¶
bpo-45375: Fixes an assertion failure due to searching for the standard library in unnormalised paths.
bpo-45022: Update Windows release to include libffi 3.4.2
bpo-45007: Update to OpenSSL 1.1.1l in Windows build
bpo-44848: Upgrade Windows installer to use SQLite 3.36.0.
bpo-44572: Avoid consuming standard input in the
platformmodulebpo-44582: Accelerate speed of
mimetypesinitialization using a native implementation of the registry scan.bpo-41299: Fix 16 milliseconds jitter when using timeouts in
threading, such as withthreading.Lock.acquire()orthreading.Condition.wait().bpo-42686: Build
sqlite3with math functions enabled. Patch by Erlend E. Aasland.bpo-40263: This is a follow-on bug from https://bugs.python.org/issue26903. Once that is applied we run into an off-by-one assertion problem. The assert was not correct.
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_librarywas 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 incasepatterns.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 raisesValueErrorwhen the entire file has already been buffered.bpo-45116: Add the
Py_ALWAYS_INLINEmacro 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_INLINEmacro to disable inlining on a function. Patch by Victor Stinner.bpo-45061: Add a deallocator to the
booltype to detect refcount bugs in C extensions which callPy_DECREF(Py_True);orPy_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.hinclude from the publicPython.hheader.bpo-42747: The
Py_TPFLAGS_HAVE_VERSION_TAGtype flag now does nothing. ThePy_TPFLAGS_HAVE_AM_SENDflag (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_qualnameto thePyCodeObjectstructure to propagate the qualified name from the compiler to code objects.Patch by Gabriele N. Tornetta
bpo-44441:
Py_RunMain()now resetsPyImport_Inittabto its initial value at exit. It must be possible to callPyImport_AppendInittab()orPyImport_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
PyThreadStatemembers like_tstate->trash_delete_nesting, whereas thePyThreadStatestructure is opaque in the limited C API.Exclude also the
PyTrash_UNWIND_LEVELconstant from the C API.Patch by Victor Stinner.
bpo-40939: Removed documentation for the removed
PyParser_*C API.bpo-43795: The list in Contents of Limited API now shows the public name
PyFrameObjectrather than_frame. The non-existing entry_nodeno longer appears in the list.bpo-44378:
Py_IS_TYPE()no longer usesPy_TYPE()to avoid a compiler warning: no longer castconst PyObject*toPyObject*. Patch by Victor Stinner.bpo-39573: Convert the
Py_TYPE()andPy_SIZE()macros to static inline functions. ThePy_SET_TYPE()andPy_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 thePy_TPFLAGS_HAVE_GCflag 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
PyConfigAPI of the Python Initialization Configuration instead (PEP 587).bpo-44094: Remove
PyErr_SetFromErrnoWithUnicodeFilename(),PyErr_SetFromWindowsErrWithUnicodeFilename(), andPyErr_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_UNICODEAPIs: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.Connectionobjects now also producessqlite3.connectandsqlite3.connect/handleauditing events. Previously these events were only produced bysqlite3.connect()calls. Patch by Erlend E. Aasland.bpo-43998: The
sslmodule 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.SSLContextdefaults 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_Newevent when called through the_xxsubinterpretersmodule.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(), andsqlite3.Connection.load_extension(). Patch by Erlend E. Aasland.bpo-43756: Add new audit event
glob.glob/2to incorporate the new root_dir and dir_fd arguments added toglob.glob()andglob.iglob().bpo-36384:
ipaddressmodule 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 functionsocket.inet_aton()treats leading zeros as octal notation. glibc implementation of moderninet_pton()does not accept any leading zeros. For a while theipaddressmodule 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.clientmodule.
Core and Builtins¶
bpo-43977: Prevent classes being both a sequence and a mapping when pattern matching.
bpo-43977: Use
tp_flagson the class object to determine if the subject is a sequence or mapping when pattern matching. Avoids the need to importcollections.abcwhen pattern matching.bpo-43892: Restore proper validation of complex literal value patterns when parsing
matchblocks.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
_signalmodule 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
retypes immutable. Patch by Erlend E. Aasland.bpo-43908: Make the
array.arraytype 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.MatchAsandMatchOrare now defined as pattern nodes rather than as expression nodes. Patch by Nick Coghlan.bpo-42725: Usage of
await/yield/yield fromand 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:
SyntaxErrorexceptions raised by the interpreter will highlight the full error range of the expression that consistutes the syntax error itself, instead of just where the problem is detected. Patch by Pablo Galindo.bpo-38605: Revert making
from __future__ import annotationsthe 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
IndentationErrorexceptions. Patch by Pablo Galindobpo-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
NameErrorraised by the interpreter,PyErr_Display()will offer suggestions of similar variable names in the function that the exception was raised from. Patch by Pablo Galindobpo-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.aliasnodes now include source location metadata attributes e.g. lineno, col_offset.bpo-43797: Improve
SyntaxErrorerror 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.RecursionErroris 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.netrcto 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
TypeErrorwhen non-member is used in a containment check; In 3.12TrueorFalsewill be returned instead, and containment will returnTrueif 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
turtlemodule 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 toDescription, allow for any field to be encoded with multiline values, remove continuation lines from multiline values, and add a.jsonproperty for easy access to the PEP 566 JSON-compatible form. Sync withimportlib_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:
urllibcan 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(), andinspect.from_function()now callinspect.get_annotations()to retrieve annotations. This meansinspect.signature()andinspect.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
sslmodule now usesSSL_read_exandSSL_write_exinternally. 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
_sslextension module to multiphase initialization.bpo-43880:
sslnow 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.GenericAliasobjects no longer includetyping.ParamSpecin__parameters__(with the exception ofcollections.abc.Callable‘sGenericAlias). This means previously invalid uses ofParamSpec(such aslist[P]) which worked in earlier versions of Python 3.10 alpha, will now raiseTypeErrorduring substitution.bpo-43867: The
multiprocessingServerclass now explicitly catchesSystemExitand closes the client connection in this case. It happens when theServer.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 tobz2.BZ2File,gzip.GzipFile, andlzma.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 asio.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
KeyErrorraised intyping.get_type_hints()due to synthetic modules that don’t appear insys.modules.bpo-43776: When
subprocess.Popenargs are provided as a string or aspathlib.Path, the Popen instance repr now shows the right thing.bpo-42248: [Enum] ensure exceptions raised in
_missing__are releasedbpo-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_COMPAT1.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=Trueor be the subject of acreate_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_EOFconstants (OpenSSL 3.0.0)bpo-43785: Improve
bz2.BZ2Fileperformance 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 ingzipandlzmahave 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
sslerror codes are now OpenSSL version-specific. Exceptions will now show correct reason and library codes. Themake_ssl_data.pyscript has been rewritten to use OpenSSL’s text file with error codes.bpo-43766: Implement PEP 647 in the
typingmodule by addingTypeGuard.bpo-25264:
os.path.realpath()now accepts a strict keyword-only argument. When set toTrue,OSErroris 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 fromentry_points()as deprecated.gh-47383: The
P.argsandP.kwargsattributes oftyping.ParamSpecare now instances of the new classestyping.ParamSpecArgsandtyping.ParamSpecKwargs, which enables a more usefulrepr(). Patch by Jelle Zijlstra.bpo-43731: Add an
encodingparameterlogging.fileConfig().bpo-43712: Add
encodinganderrorsparameters tofileinput.input()andfileinput.FileInput.bpo-38659: A
simple_enumdecorator is added to theenummodule to convert a normal class into an Enum.test_simple_enumadded to test simple enums against a corresponding normal Enum. Standard library modules updated to usesimple_enum.bpo-43764: Fix an issue where
__match_args__generation could fail for somedataclasses.bpo-43752: Fix
sqlite3regression for zero-sized blobs with converters, whereb""was returned instead ofNone. The regression was introduced by PR 24723. Patch by Erlend E. Aasland.bpo-43655:
tkinterdialog windows are now recognized as dialogs by window managers on macOS and X Window.bpo-43723: The following
threadingmethods are now deprecated and should be replaced:currentThread=>threading.current_thread()activeCount=>threading.active_count()Condition.notifyAll=>threading.Condition.notify_all()Event.isSet=>threading.Event.is_set()Thread.setName=>threading.Thread.namethread.getName=>threading.Thread.nameThread.isDaemon=>threading.Thread.daemonThread.setDaemon=>threading.Thread.daemon
Patch by Jelle Zijlstra.
bpo-2135: Deprecate find_module() and find_loader() implementations in importlib and zipimport.
bpo-43534:
turtle.textinput()andturtle.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()whenlzma/bz2are unavailable. Patch by Anthony Sottile.bpo-42967: Allow
bytesseparatorargument inurllib.parse.parse_qsandurllib.parse.parse_qslwhen parsingstrquery strings. Previously, this raised aTypeError.bpo-43296: Improve
sqlite3error handling:sqlite3_value_blob()errors that setSQLITE_NOMEMnow raiseMemoryError. Patch by Erlend E. Aasland.bpo-43312: New functions
sysconfig.get_preferred_scheme()andsysconfig.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 nowunknown database <database name>instead ofSQL logic error. Patch by Erlend E. Aasland.bpo-41282: Install schemes in
distutils.command.installare now loaded fromsysconfig.bpo-41282:
distutils.sysconfighas been merged tosysconfig.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:
pprintnow has support fordataclasses.dataclass. Patch by Lewis Gaul.bpo-39950: Add
pathlib.Path.hardlink_to()method that supersedeslink_to(). The new method has the same argument order assymlink_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
slotsparameter todataclasses.dataclassdecorator 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 forasynciofunctions which implicitly create aFutureorTaskobjects if there is no running event loop and no explicit loop argument is passed:ensure_future(),wrap_future(),gather(),shield(),as_completed()and constructors ofFuture,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/zlibmodules, and add.readall()function to_compression.DecompressReaderclass. 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 andreplace(). 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 of1or0.bpo-39906:
pathlib.Path.stat()andchmod()now accept a follow_symlinks keyword-only argument for consistency with corresponding functions in theosmodule.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()andhome()now consistently raiseRuntimeErrorexception when a home directory cannot be resolved. Previously aKeyErrorexception 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_ptype: embedded null characters would cause aValueErrorto 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_MAPPINGandPy_TPFLAGS_SEQUENCEtype 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
ifclause 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 thanos.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.libregrtestnow 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 onthreading.excepthook(). Use--fail-env-changedoption 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¶
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 affectedos.path.exists()andos.path.isdir().bpo-26227: Fixed decoding of host names in
socket.gethostbyaddr()andsocket.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
WindowsConsoleIOerrors 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/usrother than/usr/local. Previously, anything under/Systemwas 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/Librarywere 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_AUTOINITon macOS. Patch by Erlend E. Aasland.bpo-43492: Update macOS installer to use SQLite 3.35.4.
bpo-42235:
Mac/BuildScript/build-installer.pywill now use “–enable-optimizations” and--with-ltowhen 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_INSTANTIATIONtype flag to disallow creating type instances. Patch by Victor Stinner.bpo-43774: Remove the now unused
PYMALLOC_DEBUGmacro. Debug hooks on memory allocators are now installed by default if Python is built in debug mode (ifPy_DEBUGmacro is defined). Moreover, they can now be used on Python build in release mode (ex: usingPYTHONMALLOC=debugenvironment 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 thegcmodule.bpo-43908: Introduce
Py_TPFLAGS_IMMUTABLETYPEflag for immutable type objects, and modifyPyType_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 bypython3.dllon Windows. Like any function that takesFILE*, 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 asx is yin Python. Add also thePy_IsNone(),Py_IsTrue(),Py_IsFalse()functions to test if an object is, respectively, theNonesingleton, theTruesingleton or theFalsesingleton. Patch by Victor Stinner.
Python 3.10.0 alpha 7¶
Release date: 2021-04-05
Security¶
bpo-42988: CVE-2021-3426: Remove the
getfilefeature of thepydocmodule 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:
ftplibno 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_addressattribute on theirftplib.FTPinstances toTrueto re-enable it.bpo-43439: Add audit hooks for
gc.get_objects(),gc.get_referrers()andgc.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.stderrwith 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
_hashopensslextension. 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 590vectorcallcalling convention. Patch by Donghee Na.bpo-42137: The import system now prefers using
__spec__forModuleType.__repr__overmodule_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
SyntaxErrorfor 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_CheckSignalstries 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_ONSTACKflag inPyOS_setsigfor 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 andsigaltstack()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 590vectorcallcalling 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.ServerProxyno longer ignores query and fragment in the URL of the server.bpo-31956: The
index()method ofarray.arraynow has optional start and stop parameters.bpo-40066: Enum: adjust
repr()to show only enum and member name (not value, nor angle brackets) andstr()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.SSLContextdebug callback withssl.SSLContext.sni_callback().bpo-43571: It’s now possible to create MPTCP sockets with IPPROTO_MPTCP
bpo-43542:
image/heicandimage/heifwere added tomimetypes.bpo-40645: The
hmacmodule now uses OpenSSL’s HMAC implementation when digestmod argument is a hash name or builtin hash function.bpo-43510: Implement PEP 597: Add
EncodingWarningwarning,-X warn_default_encodingoption,PYTHONWARNDEFAULTENCODINGenvironment variable andencoding="locale"argument value.bpo-43521:
ast.unparsecan now render NaNs and empty sets.bpo-42914:
pprint.pprint()gains a new booleanunderscore_numbersoptional argument to emit integers with thousands separated by an underscore character for improved readability (for example1_000_000instead of1000000).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 multiplecleanup()attempts. Contributed by C.A.M. Gerlach.bpo-43428: Include changes from importlib_metadata 3.7:
Performance enhancements to distribution discovery.
entry_pointsonly returns unique distributions.Introduces new
EntryPointsobject for containing a set of entry points with convenience methods for selecting entry points by group or name.entry_pointsnow 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.clientwhen using a proxy viaset_tunnel(). Fewer small send calls are made during connection setup.bpo-43420: Improve performance of
fractions.Fractionarithmetics for large components. Contributed by Sergey B. Kirpichev.bpo-43356: Allow passing a signal number to
_thread.interrupt_main().bpo-43399: Fix
ElementTree.extendnot working on iterators when using the Python implementationbpo-43369: Improve
sqlite3error handling: Ifsqlite3_column_text()andsqlite3_column_blob()setSQLITE_NOMEM,MemoryErroris now raised. Patch by Erlend E. Aasland.bpo-43368: Fix a regression introduced in PR 24562, where an empty bytestring was fetched as
Noneinstead ofb''insqlite3. Patch by Mariusz Felisiak.bpo-41282: Fixed stacklevel of
DeprecationWarningemitted fromimport distutils.bpo-42129:
importlib.resourcesnow honors namespace packages, merging resources from each location in the namespace as introduced inimportlib_resources3.2 and including incidental changes through 5.0.3.bpo-43295:
datetime.datetime.strptime()now raisesValueErrorinstead ofIndexErrorwhen matching'z'with the%zformat specifier.bpo-43125: Return empty string if base64mime.body_encode receive empty bytes
bpo-43084:
curses.window.enclose()returns nowTrueorFalse(as was documented) instead of1or0.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()andstr()have changed:repr()is now EnumClass.MemberName andstr()is MemberName. Additionally, stdlib Enum’s whose contents are available as module attributes, such asRegexFlag.IGNORECASE, have theirrepr()as module.name, e.g.re.IGNORECASE.bpo-26053: Fixed bug where the
pdbinteractive 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.tempdirglobal 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 thetempfile.gettempdir()andtempfile.gettempdirb()functions always returnstrandbytesrespectively.bpo-39342: Expose
X509_V_FLAG_ALLOW_PROXY_CERTSasVERIFY_ALLOW_PROXY_CERTSto allow proxy certificate validation as explained in https://www.openssl.org/docs/man1.1.1/man7/proxy-certificates.html.bpo-31861: Add builtins.aiter and builtins.anext. Patch by Joshua Bronson (@jab), Daniel Pope (@lordmauve), and Justin Wang (@justin39).
Documentation¶
bpo-43199: Answer “Why is there no goto?” in the Design and History FAQ.
bpo-43407: Clarified that a result from
time.monotonic(),time.perf_counter(),time.process_time(), ortime.thread_time()can be compared with the result from any following call to the same function - not just the next immediate call.bpo-43354: Fix type documentation for
Fault.faultCode; the type has to beintinstead ofstr.bpo-41933: Clarified wording of s * n in the Common Sequence Operations
Tests¶
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
configurescript now supports--with-openssl-rpathoption.bpo-43372: Use
_freeze_importlibto 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¶
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_DEBUGmacro is defined). In the limited C API, thePy_INCREF()andPy_DECREF()functions are now implemented as opaque function calls, rather than accessing directly thePyObject.ob_refcntmember, if Python is built in debug mode and thePy_LIMITED_APImacro targets Python 3.10 or newer. It became possible to support the limited C API in debug mode because thePyObjectstructure 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-refsspecial build (Py_TRACE_REFSmacro).Patch by Victor Stinner.
bpo-43244: Remove the
pyarena.hheader 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 _modtype, 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, andPython-ast.hheader files. These functions were undocumented and excluded from the limited C API. Most names defined by these header files were not prefixed byPyand so could create names conflicts. For example,Python-ast.hdefined aYieldmacro which was conflict with theYieldname used by the Windows<winbase.h>header. Use the Pythonastmodule 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.hheader 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 thesymtable.hheader file was excluded from the limited C API.The Python
symtablemodule 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_tytype) 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
SystemErrorraised whenPyArg_Parse*()is used with#but withoutPY_SSIZE_T_CLEANdefined.bpo-36346:
PyArg_Parse*()functions now emitsDeprecationWarningwhenuorZformat 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 ofsetbut not an instance of a subtype. Patch by Pablo Galindo.bpo-42990: The
types.FunctionTypeconstructor now inherits the current builtins if the globals dictionary has no"__builtins__"key, rather than using{"None": None}as builtins: same behavior aseval()andexec()functions. Defining a function withdef 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
SyntaxErrormessage 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 callsreadline.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 callingreadline.parse_and_bind("set enable-bracketed-paste on"). Patch by Dustin Rodrigues.bpo-42808: Simple calls to
type(object)are now faster due to thevectorcallcalling 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 str2andstr2.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 thatmultiprocess.synchronize()is available on a given platform and rely on that check in theconcurrent.futurestest suite so we can run tests that are unrelated toProcessPoolExecutoron those platforms.bpo-38302: If
object.__ipow__()returnsNotImplemented, the operator will correctly fall back toobject.__pow__()andobject.__rpow__()as expected.
Library¶
bpo-43316: The
python -m gzipcommand 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
gzipmodule 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()andformat_exception().bpo-43260: Fix TextIOWrapper can not flush internal buffer forever after very large text is written.
bpo-43258: Prevent needless allocation of
sqlite3aggregate function context when no rows match an aggregate query. Patch by Erlend E. Aasland.bpo-43251: Improve
sqlite3error handling:sqlite3_column_name()failures now result inMemoryError. 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()andreadline.get_endidx()behavior based on libreadline vs libedit use.bpo-43163: Fix a bug in
codeopthat was causing it to not ask for more input when multi-line snippets have unclosed parentheses. Patch by Pablo Galindobpo-43162: deprecate unsupported ability to access enum members as attributes of other enum members
bpo-43146: Fix recent regression in None argument handling in
tracebackmodule 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_SYMLINKandO_NOFOLLOW_ANYfor macOS. Patch by Donghee Na.bpo-42960: Adds
resource.RLIMIT_KQUEUESconstant from FreeBSD to theresourcemodule.bpo-42151: Make the pure Python implementation of
xml.etree.ElementTreebehave the same as the C implementation (_elementree) regarding default attribute values (by not settingspecified_attributes=1).bpo-29753: In ctypes, now packed bitfields are calculated properly and the first item of packed bitfields is now shrank correctly.
Documentation¶
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-8compiler option.bpo-43103: Add a new configure
--without-static-libpythonoption to not build thelibpythonMAJOR.MINOR.astatic library and not install thepython.oobject 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¶
bpo-43155:
PyCMethod_New()is now present inpython3.lib.
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 publicPyErr_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 accessedPyTypeObject.tp_namedirectly. 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 accessedPyTypeObject.tp_iternextdirectly. Patch by Erlend E. Aasland.bpo-40170: Convert
PyDescr_IsData()macro to a function to hide implementation details: The macro accessedPyTypeObject.tp_descr_setdirectly. 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¶
bpo-42938: Avoid static buffers when computing the repr of
ctypes.c_doubleandctypes.c_longdoublevalues.
Core and Builtins¶
bpo-42990: Refactor the
PyEval_family of functions.An new function
_PyEval_Vectoris added to simplify calls to Python from C._PyEval_EvalCodeWithNameis removedPyEval_EvalCodeExis retained as part of the API, but is not used internally
bpo-38631: Replace
Py_FatalError()calls in the compiler with regularSystemErrorexceptions. 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_ATTRnow 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
bytearrayrepetition 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 thebytearrayto a shorter byte string).bpo-42882: Fix the
_PyUnicode_FromId()function (_Py_IDENTIFIER(var) API) whenPy_Initialize()/Py_Finalize()is called multiple times: preserve_PyRuntime.unicode_ids.next_indexvalue.bpo-42827: Fix a crash when working out the error line of a
SyntaxErrorin 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 Collections Abstract Base Classes from the
collectionsmodule.bpo-41994: Fixed possible leak in
importwhensys.modulesis not adict.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
cursesmodule. Patch by Pablo Galindobpo-43077: Update the bundled pip to 21.0.1 and setuptools to 52.0.0.
bpo-41282: Deprecate
distutilsin documentation and add warning on import.bpo-43014: Improve performance of
tokenizeby 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.samplewhencountsargument is notNone.bpo-42934: Use
TracebackException’s newcompactparam inTestResultto reduce time and memory consumed by traceback formatting.bpo-42931: Add
randbytes()torandom.__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
compactparameter to the constructor oftraceback.TracebackExceptionto reduce time and memory for use cases that only need to callTracebackException.format()andTracebackException.format_exception_only().bpo-42923: The
Py_FatalError()function and thefaulthandlermodule now dump the list of extension modules on a fatal error.bpo-42848: Removed recursion from
TracebackExceptionto 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
_jsonmodule 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_wininstcommand deprecated in Python 3.8 has been removed. The distutilsbdist_wheelcommand is now recommended to distribute binary packages on Windows.bpo-24464: The undocumented built-in function
sqlite3.enable_shared_cacheis 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
cProfileandprofileto catchBrokenPipeError.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
Falsewhen passed toThreading.threadas 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 thecursesmodule if available.bpo-33289: Correct call to
tkinter.colorchooserto return RGB triplet of ints instead of floats. Patch by Cheryl Sabella.
Documentation¶
Tests¶
Build¶
bpo-43031: Pass
--timeout=$(TESTTIMEOUT)option to the default profile task./python -m test --pgocommand.bpo-36143:
make regen-allnow also runsregen-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=PATHoption to the./configurescript. If specified, theensurepipmodule looks forsetuptoolsandpipwheel 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 theensurepip._bundledpackage.
Windows¶
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 signedwchar_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
astnodes 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_lastiandf_linenoattributes 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-ccommand 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
atexitmodule state per-interpreter. It is now safe have more than oneatexitmodule instance. Patch by Donghee Na and Victor Stinner.bpo-32381: Fix encoding name when running a
.pycfile on Windows:PyRun_SimpleFileExFlags()now uses the correct encoding to decode the filename.bpo-42195: The
__args__of the parameterized generics fortyping.Callableandcollections.abc.Callableare now consistent. The__args__forcollections.abc.Callableare now flattened whiletyping.Callable’s have not changed. To allow this change,types.GenericAliascan now be subclassed andcollections.abc.Callable’s__class_getitem__will now return a subclass oftypes.GenericAlias. Tests for typing were also updated to not subclass things likeCallable[..., T]as that is not a valid base class. Finally, bothCallables no longer validate theirargtypes, inCallable[[argtypes], resulttype]to prepare for PEP 612. Patch by Ken Jin.bpo-40137: Convert functools module to use
PyType_FromModuleAndSpec().bpo-40077: Convert
arrayto use heap types, and establish module state for these.bpo-42008: Fix _random.Random() seeding.
bpo-1635741: Port the
pyexpatextension 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.Variableandtkinter.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()andtyping.get_origin()now support PEP 604 union types and PEP 612 additions toCallable.bpo-42655:
subprocessextra_groups is now correctly passed into setgroups() system call.bpo-42727:
EnumMeta.__prepare__now accepts**kwdsto 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, andNoDefaultRoot()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:
tkintersupports 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
_threadextension 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:
tkinterfunctions and constructors which need a default root window raise nowRuntimeErrorwith descriptive message instead of obscureAttributeErrororNameErrorif it is not created yet or cannot be created automatically.bpo-42639:
atexit._run_exitfuncs()now logs callback exceptions usingsys.unraisablehook, rather than logging them directly intosys.stderrand raise the last exception.bpo-42644:
logging.disablewill now validate the types and value of its parameter. It also now accepts strings representing the levels (as doesloging.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: -EntryPointobjects now expose a.distobject referencing theDistributionwhen constructed from aDistribution. - Add support for package discovery under package normalization rules. - The object returned bymetadata()now has a formally defined protocol calledPackageMetadatawith 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 Noneorfrom ebpo-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
ParamSpecandConcatenatetotyping. 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 addedbpo-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
tracebackand the interpreter in formatting of SyntaxError with lineno not set (tracebackwas changed to match interpreter).bpo-42393: Raise
OverflowErrorinstead of silent truncation insocket.ntohs()andsocket.htons(). Silent truncation was deprecated in Python 3.7. Patch by Erlend E. Aaslandbpo-42222: Harmonized
random.randrange()argument handling to matchrange().The integer test and conversion in
randrange()now usesoperator.index().Non-integer arguments to
randrange()are deprecated.The
ValueErroris deprecated in favor of aTypeError.It now runs a little faster than before.
(Contributed by Raymond Hettinger and Serhiy Storchaka.)
bpo-42163: Restore compatibility for
uname_resultaround deepcopy and _replace.bpo-42090:
zipfile.Path.joinpathnow accepts arbitrary arguments, same aspathlib.Path.joinpath.bpo-1635741: Port the _csv module to the multi-phase initialization API (PEP 489).
bpo-42059:
typing.TypedDicttypes created using the alternative call-style syntax now correctly respect thetotalkeyword argument when setting their__required_keys__and__optional_keys__class attributes.bpo-41960: Add
globalnsandlocalnsparameters to theinspect.signature()andinspect.Signature.from_callable().bpo-41907: fix
format()behavior forIntFlagbpo-41891: Ensure asyncio.wait_for waits for task completion
bpo-24792: Fixed bug where
zipimportersometimes 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.LabeledScaledummy widget to prevent hiding part of the content label.bpo-37193: Fixed memory leak in
socketserver.ThreadingMixInintroduced in Python 3.7.bpo-39068: Fix initialization race condition in
a85encode()andb85encode()inbase64. Patch by Brandon Stansbury.
Documentation¶
bpo-17140: Add documentation for the
multiprocessing.pool.ThreadPoolclass.bpo-34398: Prominently feature listings from the glossary in documentation search results. Patch by Ammar Askar.
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-modulesoption to theconfigurescript: 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¶
Tools/Demos¶
C API¶
bpo-42591: Export the
Py_FrozenMain()function: fix a Python 3.9.0 regression. Python 3.9 uses-fvisibility=hiddenand 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
resourceextension module to module statebpo-42111: Update the
xxlimitedmodule 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
volatileto the accumulator variable inhmac.compare_digest, making constant-time-defeating optimizations less likely.
Core and Builtins¶
bpo-42576:
types.GenericAliaswill now raise aTypeErrorwhen 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
-bis specified. Speed up comparison of bytarray objects with non-buffer object.bpo-1635741: Port the
_warningsextension module to the multi-phase initialization API (PEP 489). Patch by Victor Stinner.bpo-41686: On Windows, the
SIGINTevent,_PyOS_SigintEvent(), is now created even if Python is configured to not install signal handlers (ifPyConfig.install_signal_handlersequals to 0, orPy_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 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.GenericAliasobjects 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-42246: Improved accuracy of line tracing events and f_lineno attribute of Frame objects. See PEP 626 for details.
bpo-42233: Allow
GenericAliasobjects to use union type expressions. This allows expressions likelist[int] | dict[float, str]where previously aTypeErrorwould have been thrown. This also fixes union type expressions not de-duplicatingGenericAliasobjects. (Contributed by Ken Jin in bpo-42233.)bpo-26131: The import system triggers a
ImportWarningwhen it falls back to usingload_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 raisesOSErrorinstead ofIndexErrorwhenco_linenoof 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 aspec_argargument 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:
TracebackExceptionno 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.subprocessandasyncio.tasksfunctions. Patch provided by Yurii Karabas.bpo-42392: Remove loop parameter from
asyncio.open_connectionandasyncio.start_serverfunctions. Patch provided by Yurii Karabas.bpo-28468: Add
platform.freedesktop_os_release()function to parse freedesktop.orgos-releasefiles.bpo-42299: Removed the
formattermodule, 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 allasyncio.locksandasyncio.Queueclasses. Patch provided by Yurii Karabas.bpo-15450: Make
filecmp.dircmprespect subclassing. Now thefilecmp.dircmp.subdirsbehaves as expected when subclassing dircmp.bpo-42413: The exception
socket.timeoutis now an alias ofTimeoutError.bpo-31904: Support signal module on VxWorks.
bpo-42406: We fixed an issue in
pickle.whichmodulein which importingmultiprocessingcould change the how pickle identifies which module an object belongs to, potentially breaking the unpickling of those objects.bpo-42403: Simplify the
importlibexternal bootstrap code:importlib._bootstrap_externalnow 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 likesys. 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
_signalextension module to the multi-phase initialization API (PEP 489). Patch by Victor Stinner and Mohamed Koubaa.bpo-37205:
time.time(),time.perf_counter()andtime.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 byStyle.map()). The structure of the result is now the same on all platform and does not depend on the value ofwantobjects.bpo-42345: Fix various issues with
typing.Literalparameter handling (flatten, deduplicate, use type to cache key). Patch provided by Yurii Karabas.bpo-37205:
time.perf_counter()on Windows andtime.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. Usetime.perf_counter_ns()andtime.monotonic_ns()added in Python 3.7 to avoid this precision loss.bpo-42318: Fixed support of non-BMP characters in
tkinteron macOS.bpo-42350: Fix the
threading.Threadclass 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
onerrorcallback fromshutil.rmtreenow receives correct function whenos.openfails.bpo-42237: Fix
os.sendfile()on illumos.bpo-42308: Add
threading.__excepthook__to allow retrieving the original value ofthreading.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.OptimizedUnicodehas been undocumented and obsolete since Python 3.3, when it was made an alias tostr. It is now deprecated, scheduled for removal in Python 3.12.bpo-42251: Added
threading.gettrace()andthreading.getprofile()to retrieve the functions set bythreading.settrace()andthreading.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__.loaderwhen__loader__isn’t defined on a module.bpo-26131: The
load_module()methods found inimportlibnow trigger aDeprecationWarning.bpo-39825: Windows: Change
sysconfig.get_config_var('EXT_SUFFIX')to the expected fullplatform_tag.extensionformat. Previously it was hard-coded to.pyd, now it is compatible withdistutils.sysconfigand 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(), andtraceback.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
sqlite3to use heap types (PEP 384). Patch by Erlend E. Aasland.bpo-40624: Added support for the XPath
!=operator in xml.etreebpo-28850: Fix
pprint.PrettyPrinter.format()overrides being ignored for contents of small containers. Thepprint._safe_repr()function was removed.bpo-41625: Expose the
splice()asos.splice()in theosmodule. Patch by Pablo Galindobpo-34215: Clarify the error message for
asyncio.IncompleteReadErrorwhenexpectedisNone.bpo-41543: Add async context manager support for contextlib.nullcontext.
bpo-21041:
pathlib.PurePath.parentsnow 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.requestandhttp.clientnow sendhttp/1.1ALPN 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_asyncidentifier topyclbr’sFunctionobjects. Patch by Batuhan Taskayabpo-35498: Add slice support to
pathlib.PurePath.parents.
Documentation¶
bpo-42238: Tentative to deprecate
make suspiciousby 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 thecall_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
_testinternalcapimodule in Windows installer for test suitebpo-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.hinternal 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
_ctypesextension module withoutwchar_ttype: removeCTYPES_UNICODEmacro. Anyway, thewchar_ttype 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¶
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-universalsdkand--with-universal-archsoptions 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¶
C API¶
bpo-42423: The
PyType_FromSpecWithBases()andPyType_FromModuleAndSpec()functions now accept a single class as the bases argument.bpo-1635741: Port
selectextension module to multiphase initialization (PEP 489).bpo-1635741: Port _posixsubprocess extension module to multiphase initialization (PEP 489).
bpo-1635741: Port _posixshmem extension module to multiphase initialization (PEP 489)
bpo-1635741: Port _struct extension module to multiphase initialization (PEP 489)
bpo-1635741: Port
spwdextension module to multiphase initialization (PEP 489)bpo-1635741: Port
gcextension module to multiphase initialization (PEP 489)bpo-1635741: Port _queue extension module to multiphase initialization (PEP 489)
bpo-39573: Convert
Py_TYPE()andPy_SIZE()back to macros to allow using them as an l-value. Many third party C extension modules rely on the ability of using Py_TYPE() and Py_SIZE() to set an object type and size:Py_TYPE(obj) = type;andPy_SIZE(obj) = size;.bpo-1635741: Port
symtableextension module to multiphase initialization (PEP 489)bpo-1635741: Port
grpandpwdextension modules to multiphase initialization (PEP 489)bpo-1635741: Port _random extension module to multiphase initialization (PEP 489)
bpo-1635741: Port _hashlib extension module to multiphase initialization (PEP 489)
bpo-41713: Removed the undocumented
PyOS_InitInterrupts()function. Initializing Python already implicitly installs signal handlers: seePyConfig.install_signal_handlers. Patch by Victor Stinner.bpo-40170: The
Py_TRASHCAN_BEGINmacro no longer accesses PyTypeObject attributes, but now can get the condition by calling the new private_PyTrash_cond()function which hides implementation details.bpo-42260:
Py_GetPath(),Py_GetPrefix(),Py_GetExecPrefix(),Py_GetProgramFullPath(),Py_GetPythonHome()andPy_GetProgramName()functions now returnNULLif called beforePy_Initialize()(before Python is initialized). Use the new Python Initialization Configuration API to get the Python Path Configuration.. Patch by Victor Stinner.bpo-42260: The
PyConfig_Read()function now only parsesPyConfig.argvarguments once:PyConfig.parse_argvis set to2after arguments are parsed. Since Python arguments are strippped fromPyConfig.argv, parsing arguments twice would parse the application options as Python options.bpo-42262: Added
Py_NewRef()andPy_XNewRef()functions to increment the reference count of an object and return the object. Patch by Victor Stinner.bpo-42260: When
Py_Initialize()is called twice, the second call now updates moresysattributes for the configuration, rather than onlysys.argv. Patch by Victor Stinner.bpo-41832: The
PyType_FromModuleAndSpec()function now accepts NULLtp_docslot.bpo-1635741: Added
PyModule_AddObjectRef()function: similar toPyModule_AddObject()but don’t steal a reference to the value on success. Patch by Victor Stinner.bpo-42171: The
METH_FASTCALLcalling convention is added to the limited API. The functionsPyModule_AddType(),PyType_FromModuleAndSpec(),PyType_GetModule()andPyType_GetModuleState()are added to the limited API on Windows.bpo-42085: Add dedicated entry to PyAsyncMethods for sending values
bpo-41073:
PyType_GetSlot()can now accept static types.bpo-30459:
PyList_SET_ITEM(),PyTuple_SET_ITEM()andPyCell_SET()macros can no longer be used as l-value or r-value. For example,x = PyList_SET_ITEM(a, b, c)andPyList_SET_ITEM(a, b, c) = xnow fail with a compiler error. It prevents bugs likeif (PyList_SET_ITEM (a, b, c) < 0) ...test. Patch by Zackery Spytz and Victor Stinner.
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
plistlibmodule 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_fluflrule. Patch by Pablo Galindo.bpo-42206: Propagate and raise the errors caused by
PyAST_Validate()in the parser.bpo-41796: The
astmodule 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
primarydidn’t fail immediately. This led to invalid expressions likea {b}to throw aSyntaxErrorwith a wrong offset, or invalid expressions ending with a curly brace likea {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_ATTRinstruction 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.moduleswhen 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 thecomplexclass. They always raised aTypeError.bpo-41902: Micro optimization when compute
sq_itemandmp_subscriptofrange. 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, e.g.{"x": "int"}instead of{"x": int}.
Library¶
bpo-35455: On Solaris,
thread_time()is now implemented withgethrvtime()becauseclock_gettime(CLOCK_THREAD_CPUTIME_ID)is not always available. Patch by Jakub Kulik.bpo-42233: The
repr()oftypingtypes containing Generic Alias Types previously did not show the parameterized types in theGenericAlias. They have now been changed to do so.bpo-29566:
binhex.binhex()consistently writes macOS 9 line endings.bpo-26789: The
logging.FileHandlerclass now keeps a reference to the builtinopen()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_CAPIattribute which was an internal PyCapsule object. The related private_PyUnicode_Name_CAPIstructure was moved to the internal C API. Patch by Victor Stinner.bpo-42157: Convert the
unicodedataextension module to the multiphase initialization API (PEP 489) and convert theunicodedata.UCDstatic 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 inuser(group,extra_groups) overflowsuid_t(gid_t).bpo-42103:
InvalidFileExceptionandRecursionErrorare 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,.pathmethod 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.timesubclasses. 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 whenbreak_long_words=Trueandbreak_on_hyphens=True.bpo-35823: Use
vfork()instead offork()forsubprocess.Popen()on Linux to improve performance in cases where it is deemed safe.bpo-42043: Add support for
zipfile.Pathinheritance.zipfile.Path.is_file()now returns False for non-existent names.zipfile.Pathobjects now expose a.filenameattribute and rely on that to resolve.nameand.parentwhen thePathobject is at the root of the zipfile.bpo-39101: Fixed tests using IsolatedAsyncioTestCase from hanging on BaseExceptions.
bpo-41976: Fixed a bug that was causing
ctypes.util.find_library()to returnNonewhen triying to locate a library in an environment when gcc>=9 is available andldconfigis not. Patch by Pablo Galindobpo-41943: Fix bug where TestCase.assertLogs doesn’t correctly filter messages by level.
bpo-41923: Implement PEP 613, introducing
typing.TypeAliasannotation.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 thetypeattribute of thetkinter.Eventobject 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.aclosingfor deterministic cleanup of async generators which is analogous tocontextlib.closingfor non-async generators. Patch by Joongi Kim and John Belmonte.bpo-16396: Allow
ctypes.wintypesto be imported on non-Windows systems.bpo-4356: Add a key function to the bisect module.
bpo-40592:
shutil.which()now ignores empty entries inPATHEXTinstead of treating them as a match.bpo-40492: Fix
--outfileforcProfile/profilenot writing the output file in the original directory when the program being profiled changes the working directory. PR by Anthony Sottile.bpo-34204: The
shelvemodule now usespickle.DEFAULT_PROTOCOLby default instead ofpickleprotocol3.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.cookiejarmodule 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_lib2to3if 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.ScaleTesthappening when executing the test with Tk 8.6.10.
Build¶
bpo-38980: Add
-fno-semantic-interpositionto 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_CAPIstructure of the PyCapsule APIunicodedata.ucnhash_CAPIhas 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 theselfargument of aPyCFunction.bpo-40423: The
subprocessmodule andos.closerangewill now use theclose_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_closerangefunction to provide performant closing of a range of file descriptors.bpo-41986:
Py_FileSystemDefaultEncodeErrorsandPy_UTF8Modeare available again in limited API.bpo-41756: Add
PyIter_Sendfunction to allow sending value into generator/coroutine/iterator without raising StopIteration exception to signal return.bpo-41784: Added
PyUnicode_AsUTF8AndSizeto the limited C API.
Python 3.10.0 alpha 1¶
Release date: 2020-10-05
Security¶
bpo-41304: Fixes
python3x._pthbeing 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.dllis 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()andisinstance()when getting the__bases__attribute leads to infinite recursion.bpo-41922: Speed up calls to
reversed()by using the PEP 590vectorcallcalling convention. Patch by Donghee Na.bpo-41873: Calls to
float()are now faster due to thevectorcallcalling convention. Patch by Dennis Sweeney.bpo-41870: Speed up calls to
bool()by using the PEP 590vectorcallcalling convention. Patch by Donghee Na.bpo-1635741: Port the
_bisectmodule 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__()oftypes.GenericAlias. Patch by Batuhan Taskaya.bpo-1635741: Port the
_lsprofextension module to multi-phase initialization (PEP 489).bpo-1635741: Port the
cmathextension module to multi-phase initialization (PEP 489).bpo-1635741: Port the
_scproxyextension module to multi-phase initialization (PEP 489).bpo-1635741: Port the
termiosextension module to multi-phase initialization (PEP 489).bpo-1635741: Convert the
_sha256extension 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
_overlappedextension module to multi-phase initialization (PEP 489).bpo-1635741: Port the
_curses_panelextension module to multi-phase initialization (PEP 489).bpo-1635741: Port the
_opcodeextension 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 andstr.format().bpo-41675: The implementation of
signal.siginterrupt()now usessigaction()(if it is available in the system) instead of the deprecatedsiginterrupt(). 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
zlibextension module to multi-phase initialization (PEP 489).bpo-41631: The
_astmodule 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 thatimport _astalways return a fully initialized_astmodule.bpo-40077: Convert
_operatorto usePyType_FromSpec().bpo-1653741: Port
_sha3to multi-phase init. Convert static types to heap types.bpo-1635741: Port the
_blake2extension module to the multi-phase initialization API (PEP 489).bpo-41533: Free the stack allocated in
va_build_stackifdo_mkstackfails and the stack is not asmall_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 --helpcontains now only ASCII characters.bpo-1635741: Port the
_sha1,_sha512, and_md5extension 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()andbytearray()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
multiprocessingto multi-phase initializationbpo-1635741: Port
winapito multiphase initializationbpo-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
faulthandlerto multiphase initialization.bpo-1635741: Port
sha256to multiphase initializationbpo-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 toPyParser*, so that we can remove the old set ofPyParser*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
symbolmodule.bpo-40077: Convert
_bz2to usePyType_FromSpec().bpo-41006: The
encodings.latin_1module 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’sstrictparameter, which raises aValueErrorif the arguments are exhausted at different lengths. Patch by Brandt Bucher.bpo-1635741: Port
_gdbmto multiphase initialization.bpo-40985: Fix a bug that caused the
SyntaxErrortext 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
_dbmto multiphase initialization.bpo-40957: Fix refleak in _Py_fopen_obj() when PySys_Audit() fails
bpo-40950: Add a state to the
nismodule (PEP 3121) and apply the multiphase initialization. Patch by Donghee Na.bpo-40947: The Python Path Configuration now takes
PyConfig.platlibdirin account.bpo-40939: Remove the old parser, the
parsermodule 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
NEWLINEtoken was emitted. The old parser was working around the issue, but the new parser threw aSyntaxErrorfor valid input due to this. For example, an empty line following a line continuation character was interpreted as aSyntaxError.bpo-40890: Each dictionary view now has a
mappingattribute that provides atypes.MappingProxyTypewrapping 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 Galindobpo-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 Galindobpo-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
ValueErrorwhen validating custom AST’s where the constantsTrue,FalseandNoneare used within aast.Namenode.bpo-40854: Allow overriding
sys.platlibdirvia a newPYTHONPLATLIBDIRenvironment 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
fcntlto 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 byTypeErrorin theinoperator and functionscontains(),indexOf()andcountOf()of theoperatormodule.bpo-40792: Attributes
start,stopandstepof therangeobject now always has exact typeint. Previously, they could have been an instance of a subclass ofint.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
SyntaxErrorin the expression part of an fstring, the filename attribute of theSyntaxErrorgets 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
TypeErrormessages 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 ayield from.bpo-4022: Improve performance of generators by not raising internal StopIteration.
bpo-1635741: Port
mmapto multiphase initialization.bpo-1635741: Port
_lzmato 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 foreval().bpo-41773: Note in documentation that
random.choices()doesn’t support non-finite weights, raiseValueErrorwhen given non-finite weights.bpo-41840: Fix a bug in the
symtablemodule 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.Threadconstructor now uses the target name if the target argument is specified but the name argument is omitted.bpo-41817: fix
tkinter.EventTypeEnum so all members are strings, and none are tuplesbpo-41810:
types.EllipsisType,types.NotImplementedTypeandtypes.NoneTypehave 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
objectoverrides inEnumclass creation (specifically,__str__,__repr__,__format__, and__reduce_ex__).bpo-32218:
enum.Flagandenum.IntFlagmembers are now iterable.bpo-39651: Fix a race condition in the
call_soon_threadsafe()method ofasyncio.ProactorEventLoop: do nothing if the self-pipe socket has been closed.bpo-1635741: Port the
mashalextension module to the multi-phase initialization API (PEP 489).bpo-1635741: Port the
_stringextension 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 settingPYTHONASYNCIODEBUGor-X devto enable asyncio debug mode when usingasyncio.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 insqlite3withProgrammingError.bpo-39010: Restarting a
ProactorEventLoopon Windows no longer logs spuriousConnectionResetErrors.bpo-41638:
ProgrammingErrormessage for absent parameter insqlite3contains 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
codeopregression 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): return0rather 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
tarfilemodule 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-35328: Set the environment variable
VIRTUAL_ENV_PROMPTatvenvactivation.bpo-41341: Recursive evaluation of
typing.ForwardRefinget_type_hints.bpo-41344: Prevent creating
shared_memory.SharedMemoryobjects withsize=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
_ProactorReadPipeTransportby callingrecv_intoinstead ofrecv, thus not creating a new buffer for eachrecvcall 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.arrayas aMutableSequence. Patch by Pablo Galindo.bpo-39168: Remove the
__new__method oftyping.Generic.bpo-41194: Fix a crash in the
_astmodule: 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 anyOSErrorto ignore error if the filesystem is read-only, instead of only ignoringFileNotFoundErrorandPermissionError.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
tracemodule 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
selectmodule - 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.ZoneInfofrom being subclassed.bpo-35018: Add the
xml.sax.handler.LexicalHandlerclass 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:
ensurepipnow disables the use ofpipcache when installing the bundled versions ofpipandsetuptools. Patch by Krzysztof Konopko.bpo-40967: Removed
asyncio.Task.current_task()andasyncio.Task.all_tasks(). Patch contributed by Rémi Lapeyre.bpo-40924: Ensure
importlib.resources.pathreturns 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
subprocessmodule 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
keywordmodule.bpo-23427: Add
sys.orig_argvattribute: 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
defaultsparameter tologging.Formatter, to allow specifying default values for custom fields. Patch by Asaf Alon and Bar Harel.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
selectmodule when the module is imported in a subinterpreter.bpo-39791: Built-in loaders (SourceFileLoader and ZipImporter) now supply
TraversableResourcesimplementations forResourceReader, and the fallback function has been removed.bpo-39314:
rlcompleter.Completerand 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
functoolsmodule has been moved to a newgraphlibmodule to better accommodate the new tools and keep the original scope of thefunctoolsmodule. Patch by Pablo Galindobpo-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 byTypeErrorincsv.reader(),csv.writer.writerow()andcsv.writer.writerows().bpo-39384: Fixed email.contentmanager to allow set_content() to set a null string.
bpo-40744: The
sqlite3module 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 typeint. Previously, the result could have been an instance of a subclass ofint.bpo-40767:
webbrowsernow 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’sCRYPTO_memcmp()function when OpenSSL is available.bpo-40795:
ctypesmodule: 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 byPyErr_Print().bpo-16995: Add
base64.b32hexencode()andbase64.b32hexdecode()to support the Base32 Encoding with Extended Hex Alphabet.bpo-30008: Fix
sslcode to be compatible with OpenSSL 1.1.x builds that useno-deprecatedand--api=1.1.0.bpo-30064: Fix asyncio
loop.sock_*race condition issuebpo-40759: Deprecate the
symbolmodule.bpo-40756: The second argument (extra) of
LoggerAdapter.__init__now defaults to None.bpo-37129: Add a new
os.RWF_APPENDflag foros.pwritev().bpo-40737: Fix possible reference leak for
sqlite3initialization.bpo-40726: Handle cases where the
end_linenoisNoneonast.increment_lineno().bpo-40698:
distutilsupload creates SHA2-256 and Blake2b-256 digests. MD5 digests is skipped if platform blocks MD5.bpo-40695:
hashlibno 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()passedusedforsecurityto 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 passedfeature_versionis 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 callinggetaddrinfo()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 callingsocket.getaddrinfo(). The lock was also used on FreeBSD older than 5.3, OpenBSD older than 201311 and NetBSD older than 4.bpo-40671: Prepare
_hashlibfor PEP 489 and usePyModule_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 ofrun_in_executor()that can directly take keyword arguments.bpo-36543: Restored the deprecated
xml.etree.cElementTreemodule.bpo-40611:
MAP_POPULATEconstant has now been added to the list of exportedmmapmodule flags.bpo-39881: PEP 554 for use in the test suite. (Patch By Joannah Nanjekye)
bpo-13097:
ctypesnow raises anArgumentErrorwhen 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 duplicateValueErroris not set as the__context__of the originalValueError.bpo-39244: Fixed
multiprocessing.context.get_all_start_methodsto 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
--quietoption to command-line interface ofpy_compile. Patch by Gregory Schevchenko.bpo-35714:
struct.erroris now raised if there is a null character in astructformat 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
TypeErroron 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 aRuntimeExceptionwhen 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_markupbasemodule.html.parser.HTMLParseris the only subclass ofParserBaseand itserror()implementation was deprecated in Python 3.4 and removed in Python 3.5.bpo-34226: Fix
cgi.parse_multipartwithout content_length. Patch by Roger Duranbpo-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.readintobpo-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_v3option and disablec_warn_on_allowed_pre_v3option 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 annotationsbecomes the default from4.0to3.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 globalurllib.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: Renameblacklistparameter ofcheck__all__()tonot_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 than2**31.bpo-41069:
test.support.TESTFNand the current directory for tests when run viatest.regrtestcontain 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 theskip_if_broken_multiprocessing_synchronize()function to thetest.supportmodule.bpo-41009: Fix use of
support.require_{linux|mac|freebsd}_version()decorators as class decorator.bpo-41003: Fix
test_copyregwhennumpyis installed:test.pickletesternow saves/restores warnings filters when importingnumpy, to ignore filters installed bynumpy.bpo-40964: Disable remote
imaplibtests, 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
multiprocessingtests 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_UNREACHABLEto use __builtin_unreachable() if only the compiler is able to use it. Patch by Donghee Na.bpo-41617: Fix
pycore_bitutils.hheader 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()andvsnprintf()are now required to build Python.bpo-40684:
make installnow uses thePLATLIBDIRvariable for the destinationlib-dynload/directory when./configure --with-platlibdiris used.bpo-40683: Fixed an issue where the
zoneinfomodule and its tests were not included when Python is installed withmake.
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
-32suffix 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:
msilibnow 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()andmsilib.init_database()and non-ASCII SQL in methodmsilib.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
.pyfiles on Windows totext/x-pythoninstead oftext/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,stdoutandstderrin 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_RECURSIONandPy_END_ALLOW_RECURSIONand therecursion_criticalfield of thePyInterpreterStatestructure.bpo-41692: The
PyUnicode_InternImmortal()function is now deprecated and will be removed in Python 3.12: usePyUnicode_InternInPlace()instead. Patch by Victor Stinner.bpo-41842: Add
PyCodec_Unregister()function to unregister a codec search function.bpo-41834: Remove the
_Py_CheckRecursionLimitvariable: it has been replaced byceval.recursion_limitof thePyInterpreterStatestructure. Patch by Victor Stinner.bpo-41689: Types created with
PyType_FromSpec()now make any signature in theirtp_docslot 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()andPyDateTime_TIME_GET_TZINFO()macros for accessing thetzinfoattributes ofdatetime.datetimeanddatetime.timeobjects.bpo-40170: Revert
PyType_HasFeature()change: it reads again directly thePyTypeObject.tp_flagsmember when the limited C API is not used, rather than always callingPyType_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 manipulatingPy_UNICODE*strings.bpo-41103:
PyObject_AsCharBuffer(),PyObject_AsReadBuffer(),PyObject_CheckReadBuffer(), andPyObject_AsWriteBuffer()are removed. Please migrate to new buffer protocol;PyObject_GetBuffer()andPyBuffer_Release().bpo-36346: Raises DeprecationWarning for
PyUnicode_FromUnicode(NULL, size)andPyUnicode_FromStringAndSize(NULL, size)withsize > 0.bpo-36346: Mark
Py_UNICODE_COPY,Py_UNICODE_FILL,PyUnicode_WSTR_LENGTH,PyUnicode_FromUnicode,PyUnicode_AsUnicode, andPyUnicode_AsUnicodeAndSizeas deprecated in C. RemovePy_UNICODE_MATCHwhich was deprecated and broken since Python 3.3.bpo-40989: The
PyObject_INIT()andPyObject_INIT_VAR()macros become aliases to, respectively,PyObject_Init()andPyObject_InitVar()functions.bpo-36020: On Windows,
#include "pyerrors.h"no longer definessnprintfandvsnprintfmacros.bpo-40943: The
PY_SSIZE_T_CLEANmacro must now be defined to usePyArg_ParseTuple()andPy_BuildValue()formats which use#:es#,et#,s#,u#,y#,z#,U#andZ#. 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 typeint. Previously, the result could have been an instance of a subclass ofint.bpo-39573: Convert
Py_REFCNT()andPy_SIZE()macros to static inline functions. They cannot be used as l-value anymore: usePy_SET_REFCNT()andPy_SET_SIZE()to set an object reference count and size. This change is backward incompatible on purpose, to prepare the C API for an opaquePyObjectstructure.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 Galindobpo-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
errnoto multiphase initialization (PEP 489).bpo-40523: Add pass-throughs for
hash()andreversed()toweakref.proxyobjects. Patch by Pablo Galindo.bpo-1635741: Port
syslogto 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-40536: Added the
available_timezones()function to thezoneinfomodule. Patch by Paul Ganssle.bpo-40645: The
hmac.HMACexposes internal implementation details. The attributesdigest_cons,inner, andouterare deprecated and will be removed in the future.bpo-40645: The internal module
_hashlibwraps 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,blake1or--without-builtin-hashlib-hashes.bpo-37630: The
hashlibmodule can now use SHA3 hashes and SHAKE XOF from OpenSSL when available.bpo-40479: The
hashlibnow 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
zoneinfomodule. Adds support for the IANA time zone database.bpo-40397: Removed attributes
__args__and__parameters__from special generic aliases liketyping.List(not subscripted).bpo-40549: Convert posixmodule.c (“posix” or “nt” module) to the multiphase initialization (PEP 489).
bpo-31033: Add a
msgargument toFuture.cancel()andTask.cancel().bpo-40541: Added an optional counts parameter to random.sample().
bpo-40515: The
sslandhashlibmodules 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.Taskis 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:
compileallis now able to use hardlinks to prevent duplicates in a case when.pycfiles 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 malformedast.Dictnodes 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
nntplibto mergenntplib.NNTPandnntplib._NNTPBase. Patch by Donghee Na.bpo-32494: Update
dbm.gnuto use gdbm_count if possible when callinglen(). Patch by Donghee Na.bpo-40453: Add
isolated=Truekeyword-only parameter to_xxsubinterpreters.create(). An isolated subinterpreter cannot spawn threads, spawn a child process or callos.fork().bpo-40286: Remove
_random.Random.randbytes(): the C implementation ofrandbytes(). Implement the method in Python to ease subclassing:randbytes()now directly reusesgetrandbits().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)ofconcurrent.futuresnow closes explicitly the result queue.bpo-30966: Add a new
close()method to theSimpleQueueclass to explicitly close the queue.bpo-39966: Revert bpo-25597.
unittest.mock.MagicMockwith 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 returnstyping.Optional[T]when called fortyping.Unionof two types, one of which isNoneType.bpo-40291: Add support for CAN_J1939 sockets (available on Linux 5.4+)
bpo-40273:
types.MappingProxyTypeis now reversible.bpo-39075: The repr for
types.SimpleNamespaceis now insertion ordered rather than alphabetical.bpo-40192: On AIX,
thread_time()is now implemented withthread_cputime()which has nanosecond resolution, rather thanclock_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 ofdatetime.dateanddatetime.datetimenow return a named tuple instead of atuple.
Documentation¶
bpo-34790: Add version of removal for explicit passing of coros to
asyncio.wait()’s documentationbpo-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¶
Build¶
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
asynciodatagram 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,
_tkinternow 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-includesand--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
turtledemothat now raises aSyntaxError.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()withPyAPI_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 providedtp_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
AbstractBasicAuthHandlerclass of theurllib.requestmodule 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 oldparserorPYTHONOLDPARSER=1. In Python 3.10 we will remove the old parser completely, including theparsermodule (already deprecated) and anything that depends on it.bpo-40267: Fix the tokenizer to display the correct error message, when there is a
SyntaxErroron the last input character and no newline follows. It used to beunexpected EOF while parsing, while it should beinvalid syntax.bpo-39522: Correctly unparse explicit
uprefix 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 590vectorcallcalling convention.bpo-40141: Add column and line information to
ast.keywordnodes. Patch by Pablo Galindo.bpo-1635741: Port
resourceto multiphase initialization (PEP 489).bpo-1635741: Port
mathto 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.frameis a borrowed reference, not a strong reference:PyThreadState_Clear()must not callPy_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 590vectorcallcalling 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()andtyping.get_type_hints()support now generic aliases likelist[int].bpo-38061: Optimize the
subprocessmodule on FreeBSD usingclosefrom(). A singleclose(fd)syscall is cheap, but whensysconf(_SC_OPEN_MAX)is high, the loop callingclose(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 callsclosefrom(fd_low)if fd_high is greater than or equal tosysconf(_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
lib2to3module is pending deprecation due to PEP 617.bpo-40138: Fix the Windows implementation of
os.waitpid()for exit code larger thanINT_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
loggingpackage is now imported lazily inunittestonly when theassertLogs()assertion is used.bpo-40275: The
asynciopackage is now imported lazily inunittestonly when theIsolatedAsyncioTestCaseclass 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
typingmodule. Docstrings are now shown for all special forms and special generic aliases (likeUnionandList). Usinghelp()with generic alias likeList[int]will show the help for the correspondent concrete type (listin 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. Inpydocthe 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 andrandom.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.selectwhen no fds are registeredbpo-40260: Ensure
modulefinderusesio.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
ProcessPoolExecutorare 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
symtablemodule that was causing incorrectly report global variables as local. Patch by Pablo Galindo.bpo-40190: Add support for
_SC_AIX_REALMEMtoposix.sysconf().bpo-40182: Removed the
_field_typesattribute of thetyping.NamedTupleclass.bpo-36517: Multiple inheritance with
typing.NamedTuplenow 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
runpyand incorrently use 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.RLockandthreading.Conditionclasses: reinitialize the lock at fork in the child process, reset the lock to the unlocked state. Rename also the private_reset_internal_locks()method ofthreading.Eventto_at_fork_reinit().bpo-25780: Expose
CAN_RAW_JOIN_FILTERSin thesocketmodule.bpo-39503:
AbstractBasicAuthHandlerofurllib.requestnow 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.futuresby adding an internalthreading._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 newwinregbuiltin module if it’s already available insys.modules, and remove redundant imports.bpo-40014: Fix
os.getgrouplist(): ifgetgrouplist()function fails because the group list is too small, retry with a larger group list. On failure, the glibc implementation ofgetgrouplist()setsngroupsto the total number of groups. For other implementations, double the group list size.bpo-40017: Add
time.CLOCK_TAIconstant 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
sslmodule.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 inmultiprocessing.shared_memory.ShareableList. This avoids quadratic performance when iterating aShareableList. Patch by Thomas Krennwallner.bpo-39682: Remove undocumented support for closing a
pathlib.Pathobject via its context manager. The context manager magic methods remain, but they are now a no-op, makingPathobjects immutable.bpo-36144: Added PEP 584 operators (
|and|=) tocollections.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 insys.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()’ssparameter. Patch by Zackery Spytz.bpo-31758: Prevent crashes when using an uninitialized
_elementtree.XMLParserobject. Patch by Oren Milman.
Documentation¶
bpo-27635: The pickle documentation incorrectly claimed that
__new__isn’t called by default when unpickling.bpo-39879: Updated Data model docs to include
dict()insertion order preservation. Patch by Furkan Onder and Samy Lahfa.bpo-38387: Document
PyDoc_STRVARmacro 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_cmdnow copies Python command line options like-Oor-W. Moreover, emit a warning iftest.bisect_cmdis used with-w/--verbose2option.bpo-39380: Add the encoding in
ftplib.FTPandftplib.FTP_TLSto the constructor as keyword-only and change the default fromlatin-1toutf-8to 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¶
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¶
Tools/Demos¶
bpo-40385: Removed the checkpyc.py tool. Please see compileall without force mode as a potential alternative.
bpo-40179: Fixed translation of
#elifin Argument Clinic.bpo-40094: Fix
which.pyscript exit code: it now usesos.waitstatus_to_exitcode()to convertos.system()exit status into an exit code.
C API¶
bpo-40241: Move the
PyGC_Headstructure to the internal C API.bpo-40170: Convert
PyObject_IS_GC()macro to a function to hide implementation details.bpo-40241: Add the functions
PyObject_GC_IsTracked()andPyObject_GC_IsFinalized()to the public API to allow to query if Python objects are being currently tracked or have been already finalized by the garbage collector respectively. Patch by Pablo Galindo.bpo-40170: The
PyObject_NEW()macro becomes an alias to thePyObject_New()macro, and thePyObject_NEW_VAR()macro becomes an alias to thePyObject_NewVar()macro, to hide implementation details. They no longer access directly thePyTypeObject.tp_basicsizemember.bpo-40170:
PyType_HasFeature()now always callsPyType_GetFlags()to hide implementation details. Previously, it accessed directly thePyTypeObject.tp_flagsmember when the limited C API was not used.bpo-40170: Convert the
PyObject_GET_WEAKREFS_LISTPTR()macro to a function to hide implementation details: the macro accessed directly to thePyTypeObject.tp_weaklistoffsetmember.bpo-40170: Convert
PyObject_CheckBuffer()macro to a function to hide implementation details: the macro accessed directly thePyTypeObject.tp_as_buffermember.bpo-40170: Always declare
PyIndex_Check()as an opaque function to hide implementation details: removePyIndex_Check()macro. The macro accessed directly thePyTypeObject.tp_as_numbermember.bpo-39947: Add
PyThreadState_GetID()function: get the unique identifier of a Python thread state.
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 590vectorcallcalling convention. Patch by Donghee Na.bpo-39984: subinterpreters: Move
_PyRuntimeState.ceval.tracing_possibletoPyInterpreterState.ceval.tracing_possible: each interpreter now has its own variable.bpo-37207: Speed up calls to
set()by using the PEP 590vectorcallcalling 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
SyntaxErrorif await is used inside non-async functions andPyCF_ALLOW_TOP_LEVEL_AWAITis 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_AWAITflag is given. Patch by Batuhan Taskaya.bpo-37207: Speed up calls to
tuple()by using the PEP 590vectorcallcalling 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.globin 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_PyRuntimevariable directly instead of usingtstate->interp->runtime, sincetstatecan be a dangling pointer afterPy_Finalize()has been called. Moreover, the daemon thread now exits before trying to take the GIL.bpo-39871: Fix a possible
SystemErrorinmath.{atan2,copysign,remainder}()when the first argument cannot be converted to afloat. 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.OrderedDictclasses. 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()andPyUnicode_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
NotImplementedin 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.Pathto__all__in thezipfilemodule.bpo-40000: Improved error messages for validation of
ast.Constantnodes. 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.AugLoadandast.AugStorenode 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.Paramnode class because it’s no longer used. Patch by Batuhan Taskaya.bpo-39360: Ensure all workers exit when finalizing a
multiprocessing.Poolimplicitly 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 tomultiprocessing.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.OrderedDictnow implements|and|=(PEP 584).bpo-39652: The column name found in
sqlite3.Cursor.descriptionis now truncated on the first ‘[’ only if the PARSE_COLNAMES option is set.bpo-39915: Ensure
unittest.mock.AsyncMock.await_args_listhas call objects in the order of awaited arguments instead of usingunittest.mock.Mock.call_argswhich has the last value of the call. Patch by Karthikeyan Singaravelan.bpo-36144: Updated
os.environandos.environbto support PEP 584’s merge (|) and update (|=) operators.bpo-38662: The
ensurepipmodule now invokespipvia therunpymodule. Hence it is no longer tightly coupled with the internal API of the bundledpipversion, allowing easier updates to a newerpipversion both internally and for distributors.bpo-38075: Fix the
random.Random.seed()method when aboolis passed as the seed.bpo-39916: More reliable use of
os.scandir()inPath.glob(). It no longer emits a ResourceWarning when interrupted.bpo-39850:
multiprocessingnow supports abstract socket addresses (if abstract sockets are supported in the running platform). When creating arbitrary addresses (like when default-constructingmultiprocessing.connection.Listenerobjects) 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.kindis set toNone).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.toolto catchBrokenPipeError. Patch by Donghee Na.bpo-13487: Avoid a possible “RuntimeError: dictionary changed size during iteration” from
inspect.getmodule()when it tried to loop throughsys.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 thesubprocessmodule.bpo-39794: Add –without-decimal-contextvar build option. This enables a thread-local rather than a coroutine local context.
bpo-36144:
collections.defaultdictnow implements|(PEP 584).bpo-39517: Fix runpy.run_path() when using pathlike objects
bpo-39775: Change
inspect.Signature.parametersback tocollections.OrderedDict. This was changed todictin Python 3.9.0a4.bpo-39678: Refactor queue_manager in
concurrent.futures.ProcessPoolExecutorto 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-dno 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.MappingProxyTypeobjects now support the merge (|) operator from PEP 584.bpo-38691: The
importlibmodule now ignores thePYTHONCASEOKenvironment variable when the-Eor-Icommand line options are being used.bpo-39719: Remove
tempfile.SpooledTemporaryFile.softspace()as files no longer have thesoftspaceattribute 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
ASTnodes. Patch by Batuhan Taskayabpo-39639: Deprecated
ast.Suitenode 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.AbstractDigestAuthHandlerwhen the optionalqopparameter is not present.bpo-39509: HTTP status codes
103 EARLY_HINTSand425 TOO_EARLYare added tohttp.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
returnandyieldstatements forlib2to3. 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.
astclassesIndexandExtSliceare considered deprecated and will be removed in future Python versions. In the meantime,Index(value)now returns avalueitself,ExtSlice(slices)returnsTuple(slices, Load()).
Documentation¶
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
tokendocumentation to reflect additions in Python 3.8bpo-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 ofsys.pathcontains a.pthfile.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
subprocessmodule if thesubprocessmodule is not available: before required C extension modules are built.bpo-1294959: Add
--with-platlibdiroption to the configure script: name of the platform-specific library directory, stored in the newsys.platlibdirattribute. 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.dllis 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:
distutilswill no longer statically linkvcruntime140.dllwhen 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
getproxiesin thelib2to3.fixes.fix_urllibmodule. Patch by José Roberto Meza Cabrera.
C API¶
bpo-40024: Add
PyModule_AddType()helper function: add a type to a module. Patch by Donghee Na.bpo-39946: Remove
_PyRuntime.getframehook and remove_PyThreadState_GetFramemacro which was an alias to_PyRuntime.getframe. They were only exposed by the internal C API. Remove alsoPyThreadFrameGettertype.bpo-39947: Add
PyThreadState_GetFrame()function: get the current frame of a Python thread state.bpo-37207: Add _PyArg_NoKwnames helper function. Patch by Donghee Na.
bpo-39947: Add
PyThreadState_GetInterpreter(): get the interpreter of a Python thread state.bpo-39947: Add
PyInterpreterState_Get()function to the limited C API.bpo-35370: If
PySys_Audit()fails inPyEval_SetProfile()orPyEval_SetTrace(), log the error as an unraisable exception.bpo-39947: Move the static inline function flavor of Py_EnterRecursiveCall() and Py_LeaveRecursiveCall() to the internal C API: they access PyThreadState attributes. The limited C API provides regular functions which hide implementation details.
bpo-39947: Py_TRASHCAN_BEGIN_CONDITION and Py_TRASHCAN_END macro no longer access PyThreadState attributes, but call new private _PyTrash_begin() and _PyTrash_end() functions which hide implementation details.
bpo-39884:
PyDescr_NewMethod()andPyCFunction_NewEx()now include the method name in the SystemError “bad call flags” error message to ease debug.bpo-39877: Deprecated
PyEval_InitThreads()andPyEval_ThreadsInitialized(). CallingPyEval_InitThreads()now does nothing.bpo-38249:
Py_UNREACHABLEis now implemented with__builtin_unreachable()and analogs in release mode.bpo-38643:
PyNumber_ToBase()now raises aSystemErrorinstead of crashing when called with invalid base.bpo-39882: The
Py_FatalError()function is replaced with a macro which logs automatically the name of the current function, unless thePy_LIMITED_APImacro is defined.bpo-39824: Extension modules:
m_traverse,m_clearandm_freefunctions ofPyModuleDefare no longer called if the module state was requested but is not allocated yet. This is the case immediately after the module is created and before the module is executed (Py_mod_execfunction). More precisely, these functions are not called ifm_sizeis greater than 0 and the module state (as returned byPyModule_GetState()) isNULL.Extension modules without module state (
m_size <= 0) are not affected.bpo-38913: Fixed segfault in
Py_BuildValue()called with a format containing “#” and undefined PY_SSIZE_T_CLEAN whwn an exception is set.bpo-38500: Add a private API to get and set the frame evaluation function: add
_PyInterpreterState_GetEvalFrameFunc()and_PyInterpreterState_SetEvalFrameFunc()C functions. The_PyFrameEvalFunctionfunction type now takes a tstate parameter.
Python 3.9.0 alpha 4¶
Release date: 2020-02-25
Security¶
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
acloseon an async generator that had already been closed or exhausted.bpo-39579: Change the ending column offset of
Attributenodes constructed inast_for_dotted_nameto point at the end of the current node and not at the end of the lastNAMEnode.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
ZeroDivisionErrorfor 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_MERGEandDICT_UPDATEhave been added The old bytecodesBUILD_MAP_UNPACKandBUILD_MAP_UNPACK_WITH_CALLhave 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.joinoperations. 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 590vectorcallcalling convention. Patch by Mark Shannon.bpo-36144:
dict(andcollections.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 assignmenty = expr.
Library¶
bpo-30566: Fix
IndexErrorwhen trying to decode an invalid string with punycode codec.bpo-39649: Remove obsolete check for
__args__inbdb.Bdb.format_stack_entry.bpo-39648: Expanded
math.gcd()andmath.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.UnsupportedOperationinio.BufferedReader.truncate()when it is called on a read-onlyio.BufferedReaderinstance.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
pydocandtracemodules now use thesysconfigmodule 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_msicommand is deprecated in Python 3.9, usebdist_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.Fractionif the numerator and/or the denominator is anintsubclass. Themath.gcd()function is now used to normalize the numerator and denominator.math.gcd()always return ainttype. Previously, the GCD type depended on numerator and denominator.bpo-39567: Added audit for
os.walk(),os.fwalk(),pathlib.Path.glob()andpathlib.Path.rglob().bpo-39559: Remove unused, undocumented argument
gettersfromuuid.getnode()bpo-38149:
sys.audit()is now called only once per call ofglob.glob()andglob.iglob().bpo-39546: Fix a regression in
ArgumentParserwhereallow_abbrev=Falsewas 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_namehas been added to thepkgutilmodule. This resolves a string of the form'a.b.c.d'or'a.b:c.d'to an object. In the example,a.bis a package/module andc.dis 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.closedas a propertybpo-39491: Add
typing.Annotatedandinclude_extrasparameter totyping.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
devmajoranddevminorfields for non-device files intarfilearchives, enabling bit-for-bit compatibility with GNUtar(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):andwith (yield from asyncio.lock):. The same is correct forasyncio.Conditionandasyncio.Semaphore.bpo-25597: Ensure, if
wrapsis supplied tounittest.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.parametersandinspect.BoundArguments.argumentsare 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
lazycachefunction to__all__. * Usedict.clearto clear the cache. * Refactoringgetlinefunction andcheckcachefunction.
Documentation¶
bpo-17422: The language reference now specifies restrictions on class namespaces. Adapted from a patch by Ethan Furman.
bpo-39572: Updated documentation of
totalflag ofTypedDict.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¶
bpo-38325: Skip tests on non-BMP characters of test_winconsoleio.
bpo-39502: Skip test_zipfile.test_add_file_after_2107() if
time.localtime()fails withOverflowError. It is the case on AIX 6.1 for example.
Build¶
bpo-39489: Remove
COUNT_ALLOCSspecial 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()andexpanduser()on Windows now preferUSERPROFILEand no longer useHOME, which is not normally set for regular user accounts. This makes them again behave likeos.path.expanduser(), which was changed to ignoreHOMEin 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
KeyboardInterruptor shell restart occurs. Patch by Zackery Spytz.
C API¶
bpo-35081: Move the
bytes_methods.hheader file to the internal C API aspycore_bytes_methods.h: it only contains private symbols (prefixed by_Py), except of thePyDoc_STRVAR_shared()macro.bpo-35081: Move the
dtoa.hheader file to the internal C API aspycore_dtoa.h: it only contains private functions (prefixed by_Py). Themathandcmathmodules must now be compiled with thePy_BUILD_COREmacro defined.bpo-39573: Add
Py_SET_SIZE()function to set the size of an object.bpo-39500:
PyUnicode_IsIdentifier()does not callPy_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()andPyType_CheckExact()macros to static inline functions.bpo-39542: In the limited C API,
PyObject_INIT()andPyObject_INIT_VAR()are now defined as aliases toPyObject_Init()andPyObject_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 thePyThreadState.on_deletecallback. Previously, that happened inPyThreadState_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 flagPy_TPFLAGS_HAVE_VECTORCALL.
Python 3.9.0 alpha 3¶
Release date: 2020-01-24
Core and Builtins¶
bpo-39427: Document all possibilities for the
-Xoptions in the command line help section. Patch by Pablo Galindo.bpo-39421: Fix possible crashes when operating with the functions in the
heapqmodule and custom comparison operators.bpo-39386: Prevent double awaiting of async iterator.
bpo-17005: Add
functools.TopologicalSorterto thefunctoolsmodule 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 withstatements 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
SystemErrorwhen nested function has annotation on positional-only argument - by Anthony Sottile.bpo-39200: Correct the error message when calling the
min()ormax()with no arguments. Patch by Donghee Na.bpo-39200: Correct the error message when trying to construct
rangeobjects 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.stderris line-buffered now, even ifstderris redirected to a file. You can still makesys.stderrunbuffered by passing the-ucommand-line option or setting thePYTHONUNBUFFEREDenvironment 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-39413: The
os.unsetenv()function is now also available on Windows.bpo-39390: Fixed a regression with the
ignorecallback ofshutil.copytree(). The argument types are nowstrandList[str]again.bpo-39395: The
os.putenv()andos.unsetenv()functions are now always available.bpo-39406: If
setenv()C function is available,os.putenv()is now implemented withsetenv()instead ofputenv(), 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, likezipfile.is_zipfile(). Patch by William Woodruff.bpo-39377: Removed
encodingoption fromjson.loads(). It has been deprecated since Python 3.1.bpo-39389: Write accurate compression level metadata in
gziparchives, rather than always signaling maximum compression.bpo-39366: The previously deprecated
xpath()andxgtitle()methods ofnntplib.NNTPhave been removed.bpo-39357: Remove the buffering parameter of
bz2.BZ2File. Since Python 3.0, it was ignored and using it was emittingDeprecationWarning. 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
binhexmodule and the followingbinasciifunctions:b2a_hqx(),a2b_hqx(),rlecode_hqx(),rledecode_hqx(),crc_hqx().bpo-39351: Remove
base64.encodestring()andbase64.decodestring(), aliases deprecated since Python 3.1: usebase64.encodebytes()andbase64.decodebytes()instead.bpo-39350: Remove
fractions.gcd()function, deprecated since Python 3.5 (bpo-22486): usemath.gcd()instead.bpo-39329:
LMTPconstructor now has an optional timeout parameter. Patch by Donghee Na.bpo-39313: Add a new
exec_functionoption (–exec-function in the CLI) toRefactoringToolfor makingexeca function. Patch by Batuhan Taskaya.bpo-39259:
FTP_TLSandFTP_TLSnow raise aValueErrorif the given timeout for their constructor is zero to prevent the creation of a non-blocking socket. Patch by Donghee Na.bpo-39259:
SMTPandSMTP_SSLnow raise aValueErrorif 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:
NNTPandNNTP_SSLnow raise aValueErrorif 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:
POP3andPOP3_SSLnow raise aValueErrorif 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
NNTPnews reader server and nntplib tests.bpo-35292: Proxy the
SimpleHTTPRequestHandler.guess_typetomimetypes.guess_typeso themimetypes.initis called lazily to avoid unnecessary costs whenhttp.servermodule is imported.bpo-39239: The
select.epoll.unregister()method no longer ignores theEBADFerror.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) , theloggingglobal lock may not be released appropriately, resulting in deadlock. This change wraps that block of code withtry...finallyto 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.TimeoutErrorbpo-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()withvalidate=Trueraises 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 withmock.patch.dict().bpo-39019: Implement dummy
__class_getitem__fortempfile.SpooledTemporaryFile.bpo-39019: Implement dummy
__class_getitem__forsubprocess.Popen,subprocess.CompletedProcessbpo-38914: Adjusted the wording of the warning issued by distutils’
checkcommand when theauthorandmaintainerfields are supplied but no corresponding e-mail field (author_emailormaintainer_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.PathLiketo return a correct result upon inheritance. Patch by Bar Harel.bpo-38615:
IMAP4andIMAP4_SSLnow have an optional timeout parameter for their constructors. Also, theopen()method now has an optional timeout parameter with this change. The overridden methods ofIMAP4_SSLandIMAP4_streamwere 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, thesubprocess.Popen.returncodeattribute is stillNone, and the pid has been reassigned (recycled) to a new different process.bpo-38536: Removes trailing space in formatted currency with
international=Trueand 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
identcould include a leading path separator whensyslog.openlog()was called without arguments.bpo-38293: Add
copy.copy()andcopy.deepcopy()support toproperty()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 theinspectdocs’ Types and members table.bpo-3530: In the
astmodule documentation, fix a misleadingNodeTransformerexample and add advice on when to use thefix_missing_locationsfunction.
Build¶
bpo-39395: On non-Windows platforms, the
setenv()andunsetenv()functions are now required to build Python.bpo-39160: Updated the documentation in
./configure --helpto 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 ofSO_REUSEADDRin UDP. For more details, see the documentation forloop.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 requiresPy_ssize_tto be used for size arguments in the format string, regardless of whetherPY_SSIZE_T_CLEANwas 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
replaceon a code object now raises thecode.__new__audit event.bpo-38920: Add audit hooks for when
sys.excepthook()andsys.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
NSMALLNEGINTSandNSMALLPOSINTSmacros: macros should now be modified manually inpycore_pystate.hheader file.bpo-36854: The garbage collector state becomes per interpreter (
PyInterpreterState.gc), rather than being global (_PyRuntimeState.gc).bpo-38835: The
PyFPE_START_PROTECT()andPyFPE_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
listandsetdisplays. Patch by Brandt Bucher.bpo-38707:
MainThread.native_idis now correctly reset in child processes spawned usingmultiprocessing.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
NameErrorinzipimport. 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
InvalidMessageIDtoken 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__foros.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: Removetostring()andfromstring()methods. They were aliases totobytes()andfrombytes(), 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: handlewaitpid()error. Ifwaitpid()is called elsewhere,waitpid()call fails withChildProcessError: 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_asciioptions to json.dumps in thejson.toolcommand-line interface.bpo-38634: The
readlinemodule 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.toolfailed 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
UnboundLocalErroron parsing an invalid value. Patch by Claudiu Popa.bpo-38927: Use
python -m pipinstead ofpipto 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
KeyErrorfor 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 aBINGETorLONG_BINGETload from the memo, leading to aKeyErroras the determined index was bogus. Patch by Claudiu Popa.bpo-38688: Calling func:
shutil.copytreeto 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 inhttp.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 withfunctools.wraps().bpo-38870: Expose
ast.unparse()as a function of theastmodule that can be used to unparse anast.ASTobject and produce a string with code that would produce an equivalentast.ASTobject 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.TypedDictsubclasses 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
argparsewhen internationalizing error messages for arguments withnargsset 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
pathlibwhenos.link()is missing. Patch by Toke Høiland-Jørgensen.bpo-38686: Added support for multiple
qopvalues inurllib.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
-iand--indent(indentation level), and--no-type-comments(type comments) command line options to ast parsing tool.bpo-37523: Change
zipfile.ZipExtFileto raiseValueErrorwhen 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()inenum. 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.toolCLI. The following mutually exclusive options are now supported:--indentfor setting the indent level in spaces;--tabfor indenting with tabs;--no-indentfor suppressing newlines; and--compactfor suppressing all whitespace. The default behavior remains the same as--indent=4.
Documentation¶
bpo-38928: Correct when venv’s
upgrade_dependencies()and--upgrade-depsare added.bpo-38899: Update documentation to state that to activate virtual environments under fish one should use
source, not.as documented at https://fishshell.com/docs/current/cmds/source.html.bpo-22377: Improves documentation of the values that
datetime.datetime.strptime()accepts for%Z. Patch by Karl Dubost.
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.supportconstants:LOOPBACK_TIMEOUT,INTERNET_TIMEOUT,SHORT_TIMEOUTandLONG_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()andassert_python_failure()functions no longer strip whitespaces from stderr. Removetest.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 aPermissionError. This situation can happen in a Linux sandbox using a syscall whitelist which doesn’t allow thepidfd_open()syscall yet.bpo-38839: Fix some unused functions in tests. Patch by Adam Johnson.
bpo-38669: Raise
TypeErrorwhen passing target as a string withunittest.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:
asyncionow raisesTyperErrorwhen calling incompatible methods with anssl.SSLSocketsocket. 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¶
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()andPyCFunction_ClearFreeList()functions: the free lists of bound method objects have been removed.bpo-38835: Exclude
PyFPE_START_PROTECT()andPyFPE_END_PROTECT()macros ofpyfpe.hfromPy_LIMITED_API(stable API).
Python 3.9.0 alpha 1¶
Release date: 2019-11-19
Security¶
bpo-38722:
runpynow usesio.open_code()to open code files. Patch by Jason Killen.bpo-38622: Add additional audit events for the
ctypesmodule.bpo-38418: Fixes audit event for
os.system()to be namedos.system.bpo-38243: Escape the server title of
xmlrpc.server.DocXMLRPCServerwhen rendering the document page as HTML. (Contributed by Donghee Na in bpo-38243.)bpo-38174: Update vendorized expat library version to 2.2.8, which resolves CVE-2019-15903.
bpo-37764: Fixes email._header_value_parser.get_unstructured going into an infinite loop for a specific case in which the email header does not have trailing whitespace, and the case in which it contains an invalid encoded word. Patch by Ashwin Ramaswami.
bpo-37461: Fix an infinite loop when parsing specially crafted email headers. Patch by Abhilash Raj.
bpo-37363: Adds audit events for the range of supported run commands (see Command line and environment).
bpo-37463: ssl.match_hostname() no longer accepts IPv4 addresses with additional text after the address and only quad-dotted notation without trailing whitespaces. Some inet_aton() implementations ignore whitespace and all data after whitespace, e.g. ‘127.0.0.1 whatever’.
bpo-37363: Adds audit events for
ensurepip,ftplib,glob,imaplib,nntplib,pdb,poplib,shutil,smtplib,sqlite3,subprocess,telnetlib,tempfileandwebbrowser, as well asos.listdir(),os.scandir()andbreakpoint().bpo-37364:
io.open_code()is now used when reading.pthfiles.bpo-34631: Updated OpenSSL to 1.1.1c in Windows installer
bpo-34155: Fix parsing of invalid email addresses with more than one
@(e.g. a@b@c.com.) to not return the part before 2nd@as valid email address. Patch by maxking & jpic.
Core and Builtins¶
bpo-38631: Replace
Py_FatalError()call with a regularRuntimeErrorexception infloat.__getformat__().bpo-38639: Optimized
math.floor(),math.ceil()andmath.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-) ofdict_keys.d.keys() | otherwas slower thanset(d) | otherbut they are almost same performance for now.bpo-28029:
"".replace("", s, n)now returnssinstead of an empty string for all non-zeron. There are similar changes forbytesandbytearrayobjects.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
dictobjects. Patch by Donghee Na and Inada Naoki.bpo-38465:
bytearray,arrayandmmapobjects allow now to export more than2**31buffers 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_DEBUGmacro for debug builds of the interpreter (whenPy_DEBUGis 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()andget_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 callstp_traverse()of the object type to ensure that the object is valid: test that objects visited bytp_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
cryptorcrypt_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.warnoptionshas the highest priority, as stated in the PEP 587.bpo-38310: Predict
BUILD_MAP_UNPACK_WITH_CALL->CALL_FUNCTION_EXopcode 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
dictconstructor and theupdate()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 ofasyncio.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