Changelog¶
Python 3.10.19 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.10.18 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.10.17 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.
Python 3.10.16 final¶
Release date: 2024-12-03
Tests¶
gh-125041: Re-enable skipped tests for
zlibon the s390x architecture: only skip checks of the compressed bytes, which can be different between zlib’s software implementation and the hardware-accelerated implementation.gh-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.
Security¶
Library¶
gh-124651: Properly quote template strings in
venvactivation scripts.gh-103848: Add checks to ensure that
[bracketed]hosts found byurllib.parse.urlsplit()are of IPv6 or IPvFuture format.
Python 3.10.15 final¶
Release date: 2024-09-07
Windows¶
Tests¶
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-117187: Fix XML tests for vanilla Expat <2.6.0.
gh-100454: Fix SSL tests CI for OpenSSL 3.1+
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-123693: Use platform-agnostic behavior when computing
zipfile.Path.name.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-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¶
gh-112275: A deadlock involving
pystate.c’sHEAD_LOCKinposixmodule.cat fork is now fixed. Patch by ChuBoning based on previous Python 3.12 fix by Victor Stinner.
Python 3.10.14 final¶
Release date: 2024-03-19
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-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.gh-113659: Skip
.pthfiles with names starting with a dot or hidden file attribute.
Core and Builtins¶
gh-102388: Fix a bug where
iso2022_jp_3andiso2022_jp_2004codecs read out of bounds
Library¶
gh-115197:
urllib.requestno longer resolves the hostname before checking it against the system’s proxy bypass list on macOS and Windows.gh-115133: Fix tests for
XMLPullParserwith Expat 2.6.0.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-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-91133: Fix a bug in
tempfile.TemporaryDirectorycleanup, which now no longer dereferences symlinks when working around file system permission errors.
Documentation¶
gh-115399: Document CVE-2023-52425 of Expat <2.6.0 under “XML vulnerabilities”.
Windows¶
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.10.13 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.
Library¶
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.
Tools/Demos¶
gh-107565: Update multissltests and GitHub CI workflows to use OpenSSL 1.1.1v, 3.0.10, and 3.1.2.
C API¶
gh-99612: Fix
PyUnicode_DecodeUTF8Stateful()for ASCII-only data:*consumedwas not set.
Python 3.10.12 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.
Library¶
gh-103935: Use
io.open_code()for files to be executed instead of rawopen()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.
Documentation¶
gh-89412: Add missing documentation for the
end_linenoandend_offsetattributes of thetraceback.TracebackExceptionclass.
Build¶
gh-103262: Fixes Windows installer build to work with latest compilers.
Python 3.10.11 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-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-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.
Library¶
gh-102947: Improve traceback when
dataclasses.fields()is called on a non-dataclass. Patch by Alex Waygoodgh-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-101566: In zipfile, apply fix for extractall on the underlying zipfile after being wrapped in
Path.gh-101997: Upgrade pip wheel bundled with ensurepip (pip 23.0.1)
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-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¶
Build¶
gh-102711: Fix
-Wstrict-prototypescompiler warnings.
Windows¶
macOS¶
gh-103207: Add instructions to the macOS installer welcome display on how to workaround the macOS 13 Ventura “The installer encountered an error” failure.
gh-101759: Update macOS installer to SQLite 3.40.1.
gh-87235: On macOS
python3 /dev/fd/9 9</path/to/script.pyfailed for any script longer than a couple of bytes.
Python 3.10.10 final¶
Release date: 2023-02-07
Core and Builtins¶
gh-101400: Fix wrong lineno in exception message on
continueorbreakwhich are not in a loop. Patch by Dong-hee Na.gh-101372: Fix
is_normalized()to properly handle the UCD 3.2.0 cases. Patch by Dong-hee Na.gh-101046: Fix a possible memory leak in the parser when raising
MemoryError. Patch by Pablo Galindogh-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-100374: Fix incorrect result and delay in
socket.getfqdn(). Patch by Dominic Socular.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-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. Earlier 3.10 versions had a regression where supplying it as a positional argument would lead to aTypeError.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-90104: Avoid RecursionError on
reprif a dataclass field definition has a cyclic reference.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-99952: Fix a reference undercounting issue in
ctypes.Structurewithfrom_param()results larger than a C pointer.gh-98778: Update
HTTPErrorto be initialized properly, even if thefpisNone. Patch by Dong-hee Na.gh-83035: Fix
inspect.getsource()handling of decorator calls with nested parentheses.gh-99240: Fix double-free bug in Argument Clinic
str_converterby extracting memory clean up to a newpost_parsingsection.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-96192: Fix handling of
bytespath-like objects inos.ismount().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.
Tests¶
Build¶
gh-101522: Allow overriding Windows dependencies versions and paths using MSBuild properties.
Windows¶
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-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
C API¶
gh-99240: In argument parsing, after deallocating newly allocated memory, reset its pointer to NULL.
Python 3.10.9 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-98517: Port XKCP’s fix for the buffer overflows in SHA-3 (CVE-2022-37454).
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-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-96055: Update
faulthandlerto emit an error message with the proper unexpected signal number. Patch by Dong-hee Na.gh-98852: Fix subscription of
types.GenericAliasinstances containing bare generic types: for exampletuple[A, T][int], whereAis a generic type, andTis a type variable.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-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-74044: Fixed bug where
inspect.signature()reported incorrect arguments for decorated methods.gh-99275: Fix
SystemErrorinctypeswhen exception was not set during__initsubclass__.gh-99155: Fix
statistics.NormalDistpickle with0and1protocols.gh-99134: Update the bundled copy of pip to version 22.3.1.
gh-99130: Apply bugfixes from importlib_metadata 4.11.4, namely: In
PathDistribution._name_from_stem, avoid including parts of the extension in the result. InPathDistribution._normalized_name, ensure names loaded from the stem of the filename are also normalized, ensuring duplicate entry points by packages varying only by non-normalized name are hidden.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-98793: Fix argument typechecks in
_overlapped.WSAConnect()and_overlapped.Overlapped.WSASendTo()functions.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-98331: Update the bundled copies of pip and setuptools to versions 22.3 and 65.5.0 respectively.
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-98086: Make sure
patch.dict()can be applied on async functions.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-93858: Prevent error when activating venv in nested fish instances.
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).
Tests¶
Build¶
gh-99086: Fix
-Wimplicit-int,-Wstrict-prototypes, and-Wimplicit-function-declarationcompiler warnings in configure checks.gh-99086: Fix
-Wimplicit-intcompiler warning in configure check forPTHREAD_SCOPE_SYSTEM.gh-97731: Specify the full path to the source location for
make docclean(needed for cross-builds).gh-98671: Fix
NO_MISALIGNED_ACCESSESbeing not defined for the SHA3 extension whenHAVE_ALIGNED_REQUIREDis set. Allowing builds on hardware that unaligned memory accesses are not allowed.
Windows¶
gh-99345: Use faster initialization functions to detect install location for Windows Store package
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-94328: Update Windows installer to use SQLite 3.39.4.
bpo-40882: Fix a memory leak in
multiprocessing.shared_memory.SharedMemoryon Windows.
macOS¶
gh-94328: Update macOS installer to SQLite 3.39.4.
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-95731: Fix handling of module docstrings in
Tools/i18n/pygettext.py.
Python 3.10.8 final¶
Release date: 2022-10-11
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-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.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-96078:
os.sched_yield()now release the GIL while calling sched_yield(2). Patch by Dong-hee Na.gh-97943: Bugfix:
PyFunction_GetAnnotations()should return a borrowed reference. It was returning a new reference.gh-97591: Fixed a missing incref/decref pair in
Exception.__setstate__(). Patch by Ofey Chan.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-95921: Fix overly-broad source position information for chained comparisons used as branching conditions.
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-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-96641: Do not expose
KeyWrapperin_functools.gh-96611: When loading a file with invalid UTF-8 inside a multi-line string, a correct SyntaxError is emitted.
gh-95196: Disable incorrect pickling of the C implemented classmethod descriptors.
gh-96352: Fix
AttributeErrormissingnameandobjattributes inobject.__getattribute__(). Patch by Philip Georgi.bpo-42316: Document some places where an assignment expression needs parentheses.
Library¶
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-97825: Fixes
AttributeErrorwhensubprocess.check_output()is used with argumentinput=Noneand either of the arguments encoding or errors are used.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-97545: Make Semaphore run faster.
gh-73588: Fix generation of the default name of
tkinter.Checkbutton. Previously, checkbuttons in different parent widgets could have the same short name and share the same state if arguments “name” and “variable” are not specified. Now they are globally unique.gh-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-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-96073: In
inspect, fix overeager replacement of “typing.” in formatting annotations.gh-90467: Fix
asyncio.streams.StreamReaderProtocolto keep a strong reference to the created task, so that it’s not garbage collectedgh-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-91212: Fixed flickering of the turtle window when the tracer is turned off. Patch by Shin-myoung-serp.
gh-74116: Allow
asyncio.StreamWriter.drain()to be awaited concurrently by multiple tasks. Patch by Kumar Aditya.gh-90155: Fix broken
asyncio.Semaphorewhen acquire is cancelled.gh-92986: Fix
ast.unparse()whenImportFrom.levelis Nonegh-91539: Improve performance of
urllib.request.getproxies_environmentwhen there are many environment variables
Documentation¶
gh-97741: Fix
!in c domain ref target syntax via aconf.pypatch, so it works as intended to disable ref target resolution.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.gh-93031: Update tutorial introduction output to use 3.10+ SyntaxError invalid range.
Build¶
gh-96729: Ensure that Windows releases built with
Tools\msi\buildrelease.batare upgradable to and from official Python releases.
Windows¶
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-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.10.7 final¶
Release date: 2022-09-05
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-96187: Fixed a bug that caused
_PyCode_GetExtrato return garbage for negative indexes. Patch by Pablo Galindogh-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-93592:
coroutine.throw()now properly initializes theframe.f_backwhen resuming a stack of coroutines. This allows e.g.traceback.print_stack()to work correctly when an exception (such asCancelledError) is thrown into a coroutine.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-68163: Correct conversion of
numbers.Rational’s tofloat.gh-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-95609: Update bundled pip to 22.2.2.
gh-95231: Fail gracefully if
EPERMorENOSYSis raised when loadingcryptmethods. This may happen when trying to loadMD5on a Linux kernel with FIPS enabled.
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-95789: Update the default RFC base URL from deprecated tools.ietf.org to datatracker.ietf.org
gh-91207: Fix stylesheet not working in Windows CHM htmlhelp docs. Contributed by C.A.M. Gerlach.
bpo-47115: The documentation now lists which members of C structs are part of the Limited API/Stable ABI.
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
IDLE¶
Python 3.10.6 final¶
Release date: 2022-08-01
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-92888: Fix
memoryviewuse after free when accessing the backing buffer in certain cases.
Core and Builtins¶
gh-95355:
_PyPegen_Parser_Newnow properly detects token memory allocation errors. Patch by Honglin Zhu.gh-94938: Fix error detection in some builtin functions when keyword argument name is an instance of a str subclass with overloaded
__eq__and__hash__. Previously it could cause SystemError or other undesired behavior.gh-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-94869: Fix the column offsets for some expressions in multi-line f-strings
astnodes. Patch by Pablo Galindo.gh-91153: Fix an issue where a
bytearrayitem assignment could crash if it’s resized by the new value’s__index__()method.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-94192: Fix error for dictionary literals with invalid expression as value.
gh-93964: Strengthened compiler overflow checks to prevent crashes when compiling very large source files.
gh-93671: Fix some exponential backtrace case happening with deeply nested sequence patterns in match statements. Patch by Pablo Galindo
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 ‘:’
Library¶
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-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-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-93157: Fix
fileinputmodule didn’t supporterrorsoption wheninplaceis true.gh-94821: Fix binding of unix socket to empty address on Linux to use an available address from the abstract namespace, instead of “0”.
gh-94736: Fix crash when deallocating an instance of a subclass of
_multiprocessing.SemLock. Patch by Kumar Aditya.gh-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-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-89988: Fix memory leak in
pickle.Picklerwhen looking updispatch_table. Patch by Kumar Aditya.gh-94254: Fixed types of
structmodule to be immutable. Patch by Kumar Aditya.gh-94245: Fix pickling and copying of
typing.Tuple[()].gh-94207: Made
_struct.StructGC-tracked in order to fix a reference leak in the_structmodule.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-83499: Fix double closing of file description in
tempfile.gh-79512: Fixed names and
__module__value ofweakrefclassesReferenceType,ProxyType,CallableProxyType. It makes them pickleable.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-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-91810: Suppress writing an XML declaration in open files in
ElementTree.write()withencoding='unicode'andxml_declaration=None.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-74696:
shutil.make_archive()no longer temporarily changes the current working directory during creation of standard.zipor tar archives.gh-91577: Move imports in
SharedMemorymethods to module level so that they can be executed late in python finalization.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-46053: Fix OSS audio support on NetBSD.
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-86128: Document a limitation in ThreadPoolExecutor where its exit handler is executed before any handlers in atexit.
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 do this.
bpo-47161: Document that
pathlib.PurePathdoes not collapse initial double slashes because they denote UNC paths.
Tests¶
gh-95280: Fix problem with
test_ssltest_get_cipherson systems that require perfect forward secrecy (PFS) ciphers.gh-95212: Make multiprocessing test case
test_shared_memory_recreateparallel-safe.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-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-57539: Increase calendar test coverage for
calendar.LocaleTextCalendar.formatweekday().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-94841: Fix the possible performance regression of
PyObject_Free()compiled with MSVC version 1932.bpo-45816: Python now supports building with Visual Studio 2022 (MSVC v143, VS Version 17.0). Patch by Jeremiah Vivian.
Windows¶
gh-90844: Allow virtual environments to correctly launch when they have spaces in the path.
gh-92841:
asynciono longer throwsRuntimeError: Event loop is closedon interpreter exit after asynchronous socket activity. Patch by Oleg Iarygin.bpo-42658: Support native Windows case-insensitive path comparisons by using
LCMapStringExinstead ofstr.lower()inntpath.normcase(). AddLCMapStringExto the_winapimodule.
IDLE¶
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.
Tools/Demos¶
C API¶
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.
Python 3.10.5 final¶
Release date: 2022-06-06
Core and Builtins¶
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-91924: Fix
__ltrace__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-92311: Fixed a bug where setting
frame.f_linenoto jump over a list comprehension could misbehave or crash.gh-92112: Fix crash triggered by an evil custom
mro()on a metaclass.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-91421: Fix a potential integer overflow in _Py_DecodeUTF8Ex.
bpo-47212: Raise
IndentationErrorinstead ofSyntaxErrorfor a bareexceptwith no following indent. ImproveSyntaxErrorlocations for an un-parenthesized generator used as arguments. Patch by Matthieu Dartiailh.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-46775: Some Windows system error codes(>= 10000) are now mapped into the correct errno and may now raise a subclass of
OSError. Patch by Dong-hee Na.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-39829: Removed the
__len__()call when initializing a list and moved initializing tolist_extend. Patch by Jeremiah Pascual.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-36819: Fix crashes in built-in encoders with error handlers that return position less or equal than the starting position of non-encodable characters.
Library¶
gh-93156: Accessing the
pathlib.PurePath.parentssequence of an absolute path using negative index values produced incorrect results.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-93010: In a very special case, the email package tried to append the nonexistent
InvalidHeaderErrorto the defect list. It should have beenInvalidHeaderDefect.gh-92839: Fixed crash resulting from calling bisect.insort() or bisect.insort_left() with the key argument not equal to None.
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-92530: Fix an issue that occurred after interrupting
threading.Condition.notify().gh-92049: Forbid pickling constants
re._constants.SUCCESSetc. Previously, pickling did not fail, but the result could not be unpickled.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-91401: Provide a fail-safe way to disable
subprocessuse ofvfork()via a privatesubprocess._USE_VFORKattribute. While there is currently no known need for this, if you find a need please only set it toFalse. File a CPython issue as to why you needed it and link to that from a comment in your code. This attribute is documented as a footnote in 3.11.gh-91910: Add missing f prefix to f-strings in error messages from the
multiprocessingandasynciomodules.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-91832: Add
requiredattribute toargparse.Actionrepr output.gh-91734: Fix OSS audio support on Solaris.
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-91676: Fix
unittest.IsolatedAsyncioTestCaseto shutdown the per test event loop executor before returning from itsrunmethod so that a not yet stopped or garbage collected executor state does not persist beyond the test.gh-90568: Parsing
\Nescapes of Unicode Named Character Sequences in aregular expressionraises nowre.errorinstead ofTypeError.gh-91595: Fix the comparison of character and integer inside
Tools.gdb.libpython.write_repr(). Patch by Yu Liu.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-91575: Update case-insensitive matching in the
remodule to the latest Unicode version.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-47260: Fix
os.closerange()potentially being a no-op in a Linux seccomp sandbox.bpo-39064:
zipfile.ZipFilenow raiseszipfile.BadZipFileinstead ofValueErrorwhen reading a corrupt zip file in which the central directory offset is negative.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-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-43323: Fix errors in the
emailmodule if the charset itself contains undecodable/unencodable characters.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-46787: Fix
concurrent.futures.ProcessPoolExecutorexception memory leakbpo-45393: Fix the formatting for
await xandnot xin the operator precedence table when using thehelp()system.bpo-46415: Fix ipaddress.ip_{address,interface,network} raising TypeError instead of ValueError if given invalid tuple as address parameter.
bpo-28249: Set
doctest.DocTest.linenotoNonewhen object does not have__doc__.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-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-42627: Fix incorrect parsing of Windows registry proxy settings
bpo-36073: Raise
ProgrammingErrorinstead of segfaulting on recursive usage of cursors insqlite3converters. Patch by Sergey Fedoseev.
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
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.
bpo-44347: Clarify the meaning of dirs_exist_ok, a kwarg of
shutil.copytree().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-47138: Pin Jinja to a version compatible with Sphinx version 3.2.1.
bpo-46962: All docstrings in code snippets are now wrapped into
PyDoc_STR()to 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.bpo-40838: Document that
inspect.getdoc(),inspect.getmodule(), andinspect.getsourcefile()might returnNone.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.bpo-38056: Overhaul the Error Handlers documentation in
codecs.bpo-13553: Document tkinter.Tk args.
Tests¶
gh-92886: Fixing tests that fail when running with optimizations (
-O) intest_imaplib.py.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.gh-91904: Fix initialization of
PYTHONREGRTEST_UNICODE_GUARDwhich prevented running regression tests on non-UTF-8 locale.gh-91607: Fix
test_concurrent_futuresto test the correct multiprocessing start method context in several cases where the test logic mixed this up.bpo-47205: Skip test for
sched_getaffinity()andsched_setaffinity()error case on FreeBSD.bpo-47104: Rewrite
asyncio.to_thread()tests to useunittest.IsolatedAsyncioTestCase.bpo-29890: Add tests for
ipaddress.IPv4Interfaceandipaddress.IPv6Interfaceconstruction with tuple arguments. Original patch and tests by louisom.
Build¶
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¶
gh-92984: Explicitly disable incremental linking for non-Debug builds
bpo-47194: Update
zlibto v1.2.12 to resolve CVE-2018-25032.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
Tools/Demos¶
gh-91583: Fix regression in the code generated by Argument Clinic for functions with the
defining_classparameter.
Python 3.10.4 final¶
Release date: 2022-03-23
Core and Builtins¶
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 Galindo
Library¶
bpo-23691: Protect the
re.finditer()iterator from re-entering.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.bpo-39394: A warning about inline flags not at the start of the regular expression now contains the position of the flag.
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-2604: Fix bug where doctests using globals would fail when run multiple times.
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-46421: Fix a unittest issue where if the command was invoked as
python -m unittestand the filename(s) began with a dot (.), aValueErroris returned.
Python 3.10.3 final¶
Release date: 2022-03-16
Core and Builtins¶
bpo-46940: Avoid overriding
AttributeErrormetadata information for nested attribute access calls. Patch by Pablo Galindo.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-46794: Bump up the libexpat version into 2.4.6
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-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-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-46707: Avoid potential exponential backtracking when producing some syntax errors involving lots of brackets. Patch by Pablo Galindo.
bpo-40479: Add a missing call to
va_end()inModules/_hashopenssl.c.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-45773: Remove two invalid “peephole” optimizations from the bytecode compiler.
bpo-43721: Fix docstrings of
getter,setter, anddeleterto clarify that they create a new copy of the property.bpo-46503: Fix an assert when parsing some invalid N escape sequences in f-strings.
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-46383: Fix invalid signature of
_zoneinfo’smodule_freefunction to resolve a crash on wasm32-emscripten platform.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-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-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-46091: Correctly calculate indentation levels for lines with whitespace character that are ended by line continuation characters. Patch by Pablo Galindo
Library¶
bpo-43253: Fix a crash when closing transports where the underlying socket handle is already invalid on the Proactor event loop.
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-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-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-25707: Fixed a file leak in
xml.etree.ElementTree.iterparse()when the iterator is not exhausted. Patch by Jacob Walls.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-39327:
shutil.rmtree()can now work with VirtualBox shared folders when running from the guest operating-system.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-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-46676: Make
typing.ParamSpecargs and kwargs equal to themselves. Patch by Gregory Beauregard.bpo-46672: Fix
NameErrorinasyncio.gather()when initial type check fails.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-46521: Fix a bug in the
codeopmodule that was incorrectly identifying invalid code involving string quotes as valid code.bpo-46581: Brings
ParamSpecpropagation forGenericAliasin line withConcatenate(and others).bpo-46591: Make the IDLE doc URL on the About IDLE dialog clickable.
bpo-46400: expat: Update libexpat from 2.4.1 to 2.4.4
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-46539: In
typing.get_type_hints(), support evaluating stringifiedClassVarandFinalannotations insideAnnotated. Patch by Gregory Beauregard.bpo-46491: Allow
typing.Annotatedto wraptyping.Finalandtyping.ClassVar. Patch by Gregory Beauregard.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-46469:
asynciogeneric classes now returntypes.GenericAliasin__class_getitem__instead of the same class.bpo-46434:
pdbnow gracefully handleshelpwhen__doc__is missing, for example when run with pregenerated optimized.pycfiles.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-46266: Improve day constants in
calendar.Now all constants (
MONDAY…SUNDAY) are documented, tested, and added to__all__.bpo-46232: The
sslmodule now handles certificates with bit strings in DN correctly.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-20392: Fix inconsistency with uppercase file extensions in
MimeTypes.guess_type(). Patch by Kumar Aditya.bpo-46080: Fix exception in argparse help text generation if a
argparse.BooleanOptionalActionargument’s default isargparse.SUPPRESSand it hashelpspecified. Patch by Felix Fontein.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-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-24959: Fix bug where
unittestsometimes drops frames from tracebacks of exceptions raised in tests.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.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-46463: Fixes
escape4chm.pyscript used when building the CHM documentation file
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-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-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-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.
Build¶
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-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-45925: Update Windows installer to use SQLite 3.37.2.
Windows¶
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.
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).
macOS¶
bpo-45925: Update macOS installer to SQLite 3.37.2.
IDLE¶
bpo-46630: Make query dialogs on Windows start with a cursor in the entry box.
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.
bpo-45447: Apply IDLE syntax highlighting to
pyifiles. Patch by Alex Waygood and Terry Jan Reedy.
C API¶
Python 3.10.2 final¶
Release date: 2022-01-13
Core and Builtins¶
bpo-46347: Fix memory leak in PyEval_EvalCodeEx.
bpo-46289: ASDL declaration of
FormattedValuehas changed to reflectconversionfield is not optional.bpo-46237: Fix the line number of tokenizer errors inside f-strings. Patch by Pablo Galindo.
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-46085: Fix iterator cache mechanism of
OrderedDict.bpo-46110: Add a maximum recursion check to the PEG parser to avoid stack overflow. Patch by Pablo Galindo
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-46025: Fix a crash in the
atexitmodule involving functions that unregister themselves before raising exceptions. Patch by Pablo Galindo.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-46000: Improve compatibility of the
cursesmodule with NetBSD curses.bpo-46004: Fix the
SyntaxErrorlocation for errors involving for loops with invalid targets. Patch by Pablo Galindobpo-42918: Fix bug where the built-in
compile()function did not always raise aSyntaxErrorwhen passed multiple statements in ‘single’ mode. Patch by Weipeng Hong.
Library¶
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-46278: Reflect
contextargument inAbstractEventLoop.call_*()methods. Loop implementations already support it.bpo-46239: Improve error message when importing
asyncio.windows_eventson non-Windows.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-26952:
argparseraisesValueErrorwith clear message when trying to render usage for an empty mutually-exclusive group. Previously it raised a crypticIndexError.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-46018: Ensure that
math.expm1()does not raise on underflow.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-13236:
unittest.TextTestResultandunittest.TextTestRunnerflush now the output stream more often.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.
Documentation¶
bpo-46120: State that
|is preferred for readability overUnionin thetypingdocs.bpo-46040: Fix removal Python version for
@asyncio.coroutine, the correct value is 3.11.bpo-19737: Update the documentation for the
globals()function.bpo-45840: Improve cross-references in the documentation for the data model.
Tests¶
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-46150: Now
fakenameintest_pathlib.PosixPathTest.test_expanduseris checked to be non-existent.bpo-46129: Rewrite
asyncio.lockstests withunittest.IsolatedAsyncioTestCaseusage.bpo-46114: Fix test case for OpenSSL 3.0.1 version. OpenSSL 3.0 uses
0xMNN00PP0L.
Build¶
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.
Python 3.10.1 final¶
Release date: 2021-12-06
Core and Builtins¶
bpo-42268: Fail the configure step if the selected compiler doesn’t support memory sanitizer. Patch by Pablo Galindo
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-45614: Fix
tracebackdisplay for exceptions with invalid module name.bpo-45848: Allow the parser to obtain error lines directly from encoded files. Patch by Pablo Galindo
bpo-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-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-45773: Fix a compiler hang when attempting to optimize certain jump patterns.
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-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-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-45385: Fix reference leak from descr_check. Patch by Dong-hee Na.
bpo-45167: Fix deepcopying of
types.GenericAliasobjects.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-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-45121: Fix issue where
Protocol.__init__raisesRecursionErrorwhen it’s called directly or viasuper(). Patch provided by Yurii Karabas.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-45056: Compiler now removes trailing unused constants from co_consts.
Library¶
bpo-27946: Fix possible crash when getting an attribute of class:
xml.etree.ElementTree.Elementsimultaneously with replacing theattribdict.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-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-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-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-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-45679: Fix caching of multi-value
typing.Literal.Literal[True, 2]is no longer equal toLiteral[1, 2].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-45438: Fix typing.Signature string representation for generic builtin types.
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-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-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-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-45419: Correct interfaces on DegenerateFiles.Path.
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 by :’func:inspect.getabsfile, and returnNoneto indicate that the module could not be determined.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-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-20028: Improve error message of
csv.Dialectwhen initializing. Patch by Vajrasky Kok and Dong-hee Na.bpo-45343: Update bundled pip to 21.2.4 and setuptools to 58.1.0
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-45328: Fixed
http.client.HTTPConnectionto work properly in OSs that don’t support theTCP_NODELAYsocket option.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-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-45192: Fix the
tempfile._infer_return_typefunction so that thedirargument of thetempfilefunctions accepts an object implementing theos.PathLikeprotocol.Patch by Kyungmin Lee.
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-45160: When tracing a tkinter variable used by a ttk OptionMenu, callbacks are no longer made twice.
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-20499: Improve the speed and accuracy of statistics.pvariance().
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-45021: Fix a potential deadlock at shutdown of forked children when using
concurrent.futuresmodulebpo-39039: tarfile.open raises
ReadErrorwhen a zlib error occurs during file extraction.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-44295: Ensure deprecation warning from
assertDictContainsSubset()points at calling code - by Anthony Sottile.bpo-43498: Avoid a possible “RuntimeError: dictionary changed size during iteration” when adjusting the process count of
ProcessPoolExecutor.
Documentation¶
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-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-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-45250: Update the documentation to note that CPython does not consistently require iterators to define
__iter__.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.
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-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-19460: Add new Test for
email.mime.nonmultipart.MIMENonMultipart.bpo-45835: Fix race condition in test_queue tests with multiple “feeder” threads.
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-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-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-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-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-25130: Add calls of
gc.collect()in tests to support PyPy.
Build¶
bpo-44035: CI now verifies that autoconf files have been regenerated with a current and unpatched autoconf package.
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-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-43158:
setup.pynow uses values from configure script to build the_uuidextension module. Configure now detects util-linux’slibuuid, too.bpo-45571:
Modules/Setupnow usePY_CFLAGS_NODISTinstead ofPY_CFLAGSto compile shared modules.bpo-45561: Run smelly.py tool from $(srcdir).
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-45405: Prevent
internal configure errorwhen runningconfigurewith recent versions of non-Apple clang. Patch by David Bohman.bpo-45220: Avoid building with the Windows 11 SDK previews automatically. This may be overridden by setting the
DefaultWindowsSDKVersionenvironment variable before building.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.
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-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.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.
macOS¶
bpo-45732: Update python.org macOS installer to use Tcl/Tk 8.6.12.
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.
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.
IDLE¶
Tools/Demos¶
bpo-44786: Fix a warning in regular expression in the c-analyzer script.
C API¶
bpo-39026: Fix Python.h to build C extensions with Xcode: remove a relative include from
Include/cpython/pystate.h.bpo-45307: Restore the private C API function
_PyImport_FindExtensionObject(). It will be removed in Python 3.11.bpo-44687:
BufferedReader.peek()no longer raisesValueErrorwhen the entire file has already been buffered.bpo-44751: Remove
crypt.hinclude from the publicPython.hheader.
Python 3.10.0 final¶
Release date: 2021-10-04
Core and Builtins¶
bpo-45121: Fix issue where
Protocol.__init__raisesRecursionErrorwhen it’s called directly or viasuper(). Patch provided by Yurii Karabas.
Library¶
bpo-45234: Fixed a regression in
copyfile(),copy(),copy2()raisingFileNotFoundErrorwhen source is a directory, which should raiseIsADirectoryError
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.
Tests¶
bpo-45128: Fix
test_multiprocessing_forkfailure due totest_loggingandsys.modulesmanipulation.bpo-44860: Update
test_sysconfig.test_user_similar()for the posix_user scheme:platlibdoesn’t usesys.platlibdir. Patch by Victor Stinner.
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.
IDLE¶
bpo-45193: Make completion boxes appear on Ubuntu again.
C API¶
bpo-45307: Restore the private C API function
_PyImport_FindExtensionObject(). It will be removed in Python 3.11.
Python 3.10.0 release candidate 2¶
Release date: 2021-09-07
Security¶
bpo-42278: Replaced usage of
tempfile.mktemp()withTemporaryDirectoryto avoid a potential race condition.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.
Core and Builtins¶
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-45018: Fixed pickling of range iterators that iterated for over 2**32 times.
bpo-45000: A
SyntaxErroris now raised when trying to delete__debug__. Patch by Dong-hee 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-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-44698: Restore behaviour of complex exponentiation with integer-valued exponent of type
floatorcomplex.bpo-44885: Correct the ast locations of f-strings with format specs and repeated expressions. Patch by Pablo Galindo
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-44838: Fixed a bug that was causing the parser to raise an incorrect custom
SyntaxErrorfor invalid ‘if’ expressions. Patch by Pablo Galindo.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-39091: Fix crash when using passing a non-exception to a generator’s
throw()method. Patch by Noah Oxer
Library¶
bpo-45081: Fix issue when dataclasses that inherit from
typing.Protocolsubclasses have wrong__init__. Patch provided by Yurii Karabas.bpo-41620:
run()now always return aTestResultinstance. Previously it returnedNoneif the test class or method was decorated with a skipping decorator.bpo-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-44449: Fix a crash in the signal handler of the
faulthandlermodule: no longer modify the reference count of frame objects. Patch by Victor Stinner.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-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-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-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-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-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-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-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-38840: Fix
test___all__on platforms lacking a shared memory implementation.bpo-26228: pty.spawn no longer hangs on FreeBSD, macOS, and Solaris.
bpo-33349: lib2to3 now recognizes async generators everywhere.
Documentation¶
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-44903: Removed the othergui.rst file, any references to it, and the list of GUI frameworks in the FAQ. In their place I’ve added links to the Python Wiki
page on GUI frameworks.bpo-33479: Tkinter documentation has been greatly expanded with new “Architecture” and “Threading model” sections.
bpo-36700:
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-44756: Reverted automated virtual environment creation on
make htmlwhen building documentation. It turned out to be disruptive for downstream distributors.bpo-42958: Updated the docstring and docs of
filecmp.cmp()to be more accurate and less confusing especially in respect to shallow arg.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-27752: Documentation of csv.Dialect is more descriptive.
bpo-41576: document BaseException in favor of bare except
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-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-45042: Fixes that test classes decorated with
@hashlib_helper.requires_hashdigestwere skipped all the time.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.
Windows¶
bpo-45007: Update to OpenSSL 1.1.1l in Windows build
macOS¶
bpo-45007: Update macOS installer builds to use OpenSSL 1.1.1l.
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.
Python 3.10.0 release candidate 1¶
Release date: 2021-08-02
Security¶
Core and Builtins¶
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-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-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-44635: Convert
Nonetotype(None)in the union type constructor.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-44490:
typingnow searches for type parameters intypes.Unionobjects.get_type_hintswill also properly resolve annotations with nestedtypes.Unionobjects. Patch provided by Yurii Karabas.bpo-44490: Add
__parameters__attribute and__getitem__operator totypes.Union. Patch provided by Yurii Karabas.bpo-44472: Fix ltrace functionality when exceptions are raised. Patch by Pablo Galindo
Library¶
bpo-44806: Non-protocol subclasses of
typing.Protocolignore now the__init__method inherited from protocol base classes.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-44752:
rcompleterdoes not callgetattr()onpropertyobjects to avoid the side-effect of evaluating the corresponding method.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-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-44353: Refactor
typing.NewTypefrom function into callable class. Patch provided by Yurii Karabas.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-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-44559: [Enum] module reverted to 3.9; 3.10 changes pushed until 3.11
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-44566: handle StopIteration subclass raised from @contextlib.contextmanager generator
bpo-41249: Fixes
TypedDictto work withtyping.get_type_hints()and postponed evaluation of annotations across modules.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-42892: Fixed an exception thrown while parsing a malformed multipart email by
email.message.EmailMessage.bpo-27827:
pathlib.PureWindowsPath.is_reserved()now identifies a greater range of reserved filenames, including those with trailing spaces or colons.bpo-38741:
configparser: using ‘]’ inside a section header will no longer cut the section name short at the ‘]’bpo-27513:
email.utils.getaddresses()now acceptsemail.header.Headerobjects along with string values. Patch by Zackery Spytz.bpo-29298: Fix
TypeErrorwhen required subparsers withoutdestdo not receive arguments. Patch by Anthony Sottile.
Documentation¶
bpo-44740: Replaced occurences 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-44613: importlib.metadata is no longer provisional.
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-44453: Fix documentation for the return type of
sysconfig.get_path().
Tests¶
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-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
Windows¶
bpo-44572: Avoid consuming standard input in the
platformmodulebpo-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¶
Tools/Demos¶
bpo-44756: In the Makefile for documentation (
Doc/Makefile), thebuildrule is dependent on thevenvrule. Therefore,html,latex, and other build-dependent rules are also now dependent onvenv. Thevenvrule only performs an action if$(VENVDIR)does not exist.Doc/README.rstwas updated; most users now only need to typemake html.
C API¶
bpo-41103: Reverts removal of the old buffer protocol because they are part of stable ABI.
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.
Python 3.10.0 beta 4¶
Release date: 2021-07-10
Security¶
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.
Core and Builtins¶
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-44553: Implement GC methods for
types.Unionto break reference cycles and prevent memory leaks.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-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-44368: Improve syntax errors for invalid “as” targets. Patch by Pablo Galindo
bpo-44317: Improve tokenizer error with improved locations. Patch by Pablo Galindo.
bpo-43667: Improve Unicode support in non-UTF locales on Oracle Solaris. This issue does not affect other Solaris systems.
Library¶
bpo-44558: Make the implementation consistency of
indexOf()between C and Python versions. Patch by Dong-hee Na.bpo-34798: Break up paragraph about
pprint.PrettyPrinterconstruction parameters to make it easier to read.bpo-44516: Update vendored pip to 21.1.3
bpo-44468:
typing.get_type_hints()now finds annotations in classes and base classes with unexpected__module__. Previously, it skipped those MRO elements.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-44404:
tkinter’safter()method now supports callables without the__name__attribute.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-44395: Fix
as_string()to pass unixfrom properly. Patch by Dong-hee Na.bpo-34266: Handle exceptions from parsing the arg of
pdb’s run/restart command.bpo-44077: It’s now possible to receive the type of service (ToS), a.k.a. differentiated services (DS), a.k.a. differenciated services code point (DSCP) and excplicit congestion notification (ECN) IP header fields with
socket.IP_RECVTOS.bpo-43024: Improve the help signature of
traceback.print_exception(),traceback.format_exception()andtraceback.format_exception_only().bpo-30256: Pass multiprocessing BaseProxy argument
manager_ownedthrough AutoProxy.
Documentation¶
bpo-44558: Match the docstring and python implementation of
countOf()to the behavior of its c implementation.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-13814: In the Design FAQ, answer “Why don’t generators support the with statement?”
bpo-41621: Document that
collections.defaultdictparameterdefault_factorydefaults to None and is positional-only.
Tests¶
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-30256: Add test for nested queues when using
multiprocessingshared objectsAutoProxy[Queue]insideListProxyandDictProxy
Build¶
Windows¶
bpo-44582: Accelerate speed of
mimetypesinitialization using a native implementation of the registry scan.bpo-41299: Fix 16ms jitter when using timeouts in
threading, such as withthreading.Lock.acquire()orthreading.Condition.wait().
C API¶
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-40939: Removed documentation for the removed
PyParser_*C API.
Python 3.10.0 beta 3¶
Release date: 2021-06-17
Core and Builtins¶
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-44349: Fix an edge case when displaying text from files with encoding in syntax errors. Patch by Pablo Galindo.
bpo-44335: Fix a regression when identifying incorrect characters in syntax errors. 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-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-11105: When compiling
ast.ASTobjects with recursive references throughcompile(), the interpreter doesn’t crash anymore instead it raises aRecursionError.
Library¶
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-44389: Fix deprecation of
ssl.OP_NO_TLSv1_3bpo-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-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-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-43318: Fix a bug where
pdbdoes not always echo cleared breakpoints.bpo-37022:
pdbnow displays exceptions fromrepr()with itspandppcommands.
Documentation¶
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.
Tests¶
bpo-44363: Account for address sanitizer in test_capi. test_capi now passes when run GCC address sanitizer.
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.
Build¶
bpo-44381: The Windows build now accepts
EnableControlFlowGuardset toguardto enable CFG.
IDLE¶
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.
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.
Python 3.10.0 beta 2¶
Release date: 2021-05-31
Security¶
bpo-44022: mod:
http.clientnow avoids infinitely reading potential HTTP headers after a100 Continuestatus response from the server.
Core and Builtins¶
bpo-43667: Improve Unicode support in non-UTF locales on Oracle Solaris. This issue does not affect other Solaris systems.
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-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-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-44143: Fixed a crash in the parser that manifest when raising tokenizer errors when an existing exception was present. Patch by Pablo Galindo.
bpo-44114: Fix incorrect dictkeys_reversed and dictitems_reversed function signatures in C code, which broke webassembly builds.
bpo-43149: Corrent the syntax error message regarding multiple exception types to not refer to “exception groups”. Patch by Pablo Galindo
bpo-44056: Syntax errors when default
exceptis not the lastexceptare reported with the correct location. Patch by Mark Shannon.bpo-43822: The parser will prioritize tokenizer errors over custom syntax errors when raising exceptions. Patch by Pablo Galindo.
bpo-28146: Fix a confusing error message in
str.format().
Library¶
bpo-44254: On Mac, give turtledemo button text a color that works on both light or dark background. Programmers cannot control the latter.
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-44210: Make importlib.metadata._meta.PackageMetadata public.
bpo-43643: Declare readers.MultiplexedPath.name as a property per the spec.
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-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-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-44059: Register the SerenityOS Browser in the
webbrowsermodule.bpo-36515: The
hashlibmodule no longer does unaligned memory accesses when compiled for ARM platforms.bpo-44018: random.seed() no longer mutates bytearray inputs.
bpo-38352: Add
IO,BinaryIO,TextIO,Match, andPatterntotyping.__all__. Patch by Jelle Zijlstra.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-43650: Fix
MemoryErrorinshutil.unpack_archive()which fails insideshutil._unpack_zipfile()on large files. Patch by Igor Bolshakov.bpo-41730:
DeprecationWarningis now raised when importingtkinter.tix, which has been deprecated in documentation since Python 3.6.
Documentation¶
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.
Tests¶
bpo-31904: Ignore error string case in test_py_compile
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.
Build¶
bpo-41282: Fix broken
make installthat caused standard library extension modules to be unnecessarily and incorrectly rebuilt during the install phase of cpython.
Windows¶
macOS¶
bpo-43109: Allow –with-lto configure option to work with Apple-supplied Xcode or Command Line Tools.
IDLE¶
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-44074: Make patchcheck automatically detect the correct base branch name (previously it was hardcoded to ‘master’)
C API¶
bpo-43795: The undocumented function
Py_FrozenMain()is removed from the Limited API.bpo-43795:
PyCodec_Unregister()is now properly exported as a function in the Windows Stable ABI DLL.
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 notatation. 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 Dong-hee 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 Dong-hee 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 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__tostructsequencebased classes. 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 supportedbpo-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 Dong-hee Na.
bpo-31904: Skip some asyncio tests on VxWorks.
bpo-42641: Enhance
test_select.test_select(): it now takes 500 ms 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 Dong-hee 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 in importlib now trigger a DeprecationWarning.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 func:
os.eventfdto 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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/typingbpo-41789: Honor
objectoverrides inEnumclass creation (specifically,__str__,__repr__,__format__, and__reduce_ex__).bpo-32218:
enum.Flagandenum.IntFlagmembers are now iterablebpo-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: func:
hashlib.newpassedusedforsecurityto 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 originalValueErrorbpo-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 Dong-hee 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 Dong-hee 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 intolong.
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 Dong-hee Na.bpo-32494: Update
dbm.gnuto use gdbm_count if possible when callinglen(). Patch by Dong-hee 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 Dong-hee 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 ms. 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 SyntaxError on the last input character and no newline follows. It used to be
unexpected 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: func:
inspect.getdocno 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee Na.bpo-39434: floor division of float operation now has a better performance. Also the message of
ZeroDivisionErrorfor this operation is updated. Patch by Dong-hee 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__in bdb.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 Dong-hee 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 now str and List[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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 Dong-hee 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 mod:
lib2to3. Patch by Dong-hee 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 Dong-hee 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 Popabpo-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, notas documented at https://fishshell.com/docs/current/commands.html#source.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 Dong-hee 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 Dong-hee 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 Dong-hee 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
bpo-38113: ast module updated to PEP-384 and all statics removed
bpo-38076: The struct module is now PEP-384 compatible
bpo-38075: The random module is now PEP-384 compatible
bpo-38074: zlib module made PEP-384 compatible
bpo-38073: Make pwd extension module PEP-384 compatible
bpo-38072: grp module made PEP-384 compatible
bpo-38069: Make _posixsubprocess PEP-384 compatible
bpo-38071: Make termios extension module PEP-384 compatible
bpo-38005: Fixed comparing and creating of InterpreterID and ChannelID.
bpo-36946: Fix possible signed integer overflow when handling slices. Patch by hongweipeng.
bpo-37994: Fixed silencing arbitrary errors if an attribute lookup fails in several sites. Only AttributeError should be silenced.
bpo-8425: Optimize set difference_update for the case when the other set is much larger than the base set. (Suggested by Evgeny Kapun with code contributed by Michele Orrù).
bpo-37966: The implementation of
is_normalized()has been greatly sped up on strings that aren’t normalized, by implementing the full normalization-quick-check algorithm from the Unicode standard.bpo-37947: Adjust correctly the recursion level in the symtable generation for named expressions. Patch by Pablo Galindo.
bpo-37812: The
CHECK_SMALL_INTmacro used insideObject/longobject.chas been replaced with an explicitreturnat each call site.bpo-37751: Fix
codecs.lookup()to normalize the encoding name the same way thanencodings.normalize_encoding(), except thatcodecs.lookup()also converts the name to lower case.bpo-37830: Fixed compilation of
breakandcontinuein thefinallyblock when the correspondingtryblock containsreturnwith a non-constant value.bpo-20490: Improve import error message for partially initialized module on circular
fromimports - by Anthony Sottile.bpo-37840: Fix handling of negative indices in
sq_itemofbytearray. Patch by Sergey Fedoseev.bpo-37802: Slightly improve performance of
PyLong_FromUnsignedLong(),PyLong_FromUnsignedLongLong()andPyLong_FromSize_t(). Patch by Sergey Fedoseev.bpo-37409: Ensure explicit relative imports from interactive sessions and scripts (having no parent package) always raise ImportError, rather than treating the current module as the package. Patch by Ben Lewis.
bpo-32912: Reverted bpo-32912: emitting
SyntaxWarninginstead ofDeprecationWarningfor invalid escape sequences in string and bytes literals.bpo-37757: PEP 572: As described in the PEP, assignment expressions now raise
SyntaxErrorwhen their interaction with comprehension scoping results in an ambiguous target scope.The
TargetScopeErrorsubclass originally proposed by the PEP has been removed in favour of just raising regular syntax errors for the disallowed cases.bpo-36279: Fix potential use of uninitialized memory in
os.wait3().bpo-36311: Decoding bytes objects larger than 2GiB is faster and no longer fails when a multibyte characters spans a chunk boundary.
bpo-34880: The
assertstatement now works properly if theAssertionErrorexception is being shadowed. Patch by Zackery Spytz.bpo-37340: Removed object cache (
free_list) for bound method objects. Temporary bound method objects are less used than before thanks to theLOAD_METHODopcode and the_PyObject_VectorcallMethodC API.bpo-37648: Fixed minor inconsistency in
list.__contains__(),tuple.__contains__()and a few other places. The collection’s item is now always at the left and the needle is on the right of==.bpo-37444: Update differing exception between
builtins.__import__()andimportlib.__import__().bpo-37619: When adding a wrapper descriptor from one class to a different class (for example, setting
__add__ = str.__add__on anintsubclass), an exception is correctly raised when the operator is called.bpo-37593: Swap the positions of the posonlyargs and args parameters in the constructor of
ast.parametersnodes.bpo-37543: Optimized pymalloc for non PGO build.
bpo-37537: Compute allocated pymalloc blocks inside _Py_GetAllocatedBlocks(). This slows down _Py_GetAllocatedBlocks() but gives a small speedup to _PyObject_Malloc() and _PyObject_Free().
bpo-37467: Fix
sys.excepthook()andPyErr_Display()if a filename is a bytes string. For example, for a SyntaxError exception where the filename attribute is a bytes string.bpo-37433: Fix
SyntaxErrorindicator printing too many spaces for multi-line strings - by Anthony Sottile.bpo-37417:
bytearray.extend()now correctly handles errors that arise during iteration. Patch by Brandt Bucher.bpo-37414: The undocumented
sys.callstats()function has been removed. Since Python 3.7, it was deprecated and always returnedNone. It required a special build optionCALL_PROFILEwhich was already removed in Python 3.7.bpo-37392: Remove
sys.getcheckinterval()andsys.setcheckinterval()functions. They were deprecated since Python 3.2. Usesys.getswitchinterval()andsys.setswitchinterval()instead. Remove alsocheck_intervalfield of thePyInterpreterStatestructure.bpo-37388: In development mode and in debug build, encoding and errors arguments are now checked on string encoding and decoding operations. Examples:
open(),str.encode()andbytes.decode().By default, for best performances, the errors argument is only checked at the first encoding/decoding error, and the encoding argument is sometimes ignored for empty strings.
bpo-37348: Optimized decoding short ASCII string with UTF-8 and ascii codecs.
b"foo".decode()is about 15% faster. Patch by Inada Naoki.bpo-24214: Improved support of the surrogatepass error handler in the UTF-8 and UTF-16 incremental decoders.
bpo-37330:
open(),io.open(),codecs.open()andfileinput.FileInputno longer accept'U'(“universal newline”) in the file mode. This flag was deprecated since Python 3.3.bpo-35224: Reverse evaluation order of key: value in dict comprehensions as proposed in PEP 572. I.e. in
{k: v for ...},kwill be evaluated beforev.bpo-37316: Fix the
PySys_Audit()call inmmap.mmap.bpo-37300: Remove an unnecessary Py_XINCREF in classobject.c.
bpo-37269: Fix a bug in the peephole optimizer that was not treating correctly constant conditions with binary operators. Patch by Pablo Galindo.
bpo-20443: Python now gets the absolute path of the script filename specified on the command line (ex: “python3 script.py”): the __file__ attribute of the __main__ module and sys.path[0] become an absolute path, rather than a relative path.
bpo-37257: Python’s small object allocator (
obmalloc.c) now allows (no more than) one empty arena to remain available for immediate reuse, without returning it to the OS. This prevents thrashing in simple loops where an arena could be created and destroyed anew on each iteration.bpo-37231: The dispatching of type slots to special methods (for example calling
__mul__when doingx * y) has been made faster.bpo-36974: Implemented separate vectorcall functions for every calling convention of builtin functions and methods. This improves performance for calls.
bpo-37213: Handle correctly negative line offsets in the peephole optimizer. Patch by Pablo Galindo.
bpo-37219: Remove erroneous optimization for empty set differences.
bpo-15913: Implement
PyBuffer_SizeFromFormat()function (previously documented but not implemented): callstruct.calcsize(). Patch by Joannah Nanjekye.bpo-36922: Slot functions optimize any callable with
Py_TPFLAGS_METHOD_DESCRIPTORinstead of only instances offunction.bpo-36974: The slot
tp_vectorcall_offsetis inherited unconditionally to supportsuper().__call__()when the base class uses vectorcall.bpo-37160:
threading.get_native_id()now also supports NetBSD.bpo-37077: Add
threading.get_native_id()support for AIX. Patch by M. Feltbpo-34556: Add
--upgrade-depsto venv module. Patch by Cooper Ry Leesbpo-20523:
pdb.Pdbsupports ~/.pdbrc in Windows 7. Patch by Tim Hopper and Dan Lidral-Porter.bpo-35551: Updated encodings: - Removed the “tis260” encoding, which was an alias for the nonexistent “tactis” codec. - Added “mac_centeuro” as an alias for the mac_latin2 encoding.
bpo-19072: The
classmethoddecorator can now wrap other descriptors such as property objects. Adapted from a patch written by Graham Dumpleton.bpo-27575: Improve speed of dictview intersection by directly using set intersection logic. Patch by David Su.
bpo-30773: Prohibit parallel running of aclose() / asend() / athrow(). Fix ag_running to reflect the actual running status of the AG.
Library¶
bpo-36589: The
curses.update_lines_cols()function now returnsNoneinstead of1on success.bpo-38807: Update
TypeErrormessages foros.path.join()to includeos.PathLikeobjects as acceptable input types.bpo-38724: Add a repr for
subprocess.Popenobjects. Patch by Andrey Doroschenko.bpo-38786: pydoc now recognizes and parses HTTPS URLs. Patch by python273.
bpo-38785: Prevent asyncio from crashing if parent
__init__is not called from a constructor of object derived fromasyncio.Future.bpo-38723:
pdbnow usesio.open_code()to trigger auditing events.bpo-27805: Allow opening pipes and other non-seekable files in append mode with
open().bpo-38438: Simplify the
argparseusage message fornargs="*".bpo-38761: WeakSet is now registered as a collections.abc.MutableSet.
bpo-38716: logging: change RotatingHandler namer and rotator to class-level attributes. This stops __init__ from setting them to None in the case where a subclass defines them with eponymous methods.
bpo-38713: Add
os.P_PIDFDconstant, which may be passed toos.waitid()to wait on a Linux process file descriptor.bpo-38692: Add
asyncio.PidfdChildWatcher, a Linux-specific child watcher implementation that polls process file descriptors.bpo-38692: Expose the Linux
pidfd_opensyscall asos.pidfd_open().bpo-38602: Added constants
F_OFD_GETLK,F_OFD_SETLKandF_OFD_SETLKWto thefcntlmodule. Patch by Dong-hee Na.bpo-38334: Fixed seeking backward on an encrypted
zipfile.ZipExtFile.bpo-38312: Add
curses.get_escdelay(),curses.set_escdelay(),curses.get_tabsize(), andcurses.set_tabsize()functions - by Anthony Sottile.bpo-38586: Now
fileConfig()correctly sets the .name of handlers loaded.bpo-38565: Add new cache_parameters() method for functools.lru_cache() to better support pickling.
bpo-34679: asynci.ProactorEventLoop.close() now only calls signal.set_wakeup_fd() in the main thread.
bpo-31202: The case the result of
pathlib.WindowsPath.glob()matches now the case of the pattern for literal parts.bpo-36321: Remove misspelled attribute. The 3.8 changelog noted that this would be removed in 3.9.
bpo-38521: Fixed erroneous equality comparison in statistics.NormalDist().
bpo-38493: Added
CLD_KILLEDandCLD_STOPPEDforsi_code. Patch by Dong-hee Na.bpo-38478: Fixed a bug in
inspect.signature.bind()that was causing it to fail when handling a keyword argument with same name as positional-only parameter. Patch by Pablo Galindo.bpo-33604: Fixed
hmac.newandhmac.HMACto raise TypeError instead of ValueError when the digestmod parameter, now required in 3.8, is omitted. Also clarified the hmac module documentation and docstrings.bpo-38378: Parameters out and in of
os.sendfile()was renamed to out_fd and in_fd.bpo-38417: Added support for setting the umask in the child process to the subprocess module on POSIX systems.
bpo-38449: Revert PR 15522, which introduces a regression in
mimetypes.guess_type()due to improper handling of filenames as urls.bpo-38431: Fix
__repr__method fordataclasses.InitVarto support typing objects, patch by Samuel Colvin.bpo-38109: Add missing
stat.S_IFDOOR,stat.S_IFPORT,stat.S_IFWHT,stat.S_ISDOOR(),stat.S_ISPORT(), andstat.S_ISWHT()values to the Python implementation ofstat.bpo-38422: Clarify docstrings of pathlib suffix(es)
bpo-38405: Nested subclasses of
typing.NamedTupleare now pickleable.bpo-38332: Prevent
KeyErrorthrown by_encoded_words.decode()when given an encoded-word with invalid content-type encoding from propagating all the way toemail.message.get().bpo-38371: Deprecated the
split()method in_tkinter.TkappTypein favour of thesplitlist()method which has more consistent and predicable behavior.bpo-38341: Add
smtplib.SMTPNotSupportedErrorto thesmtplibexported names.bpo-38319: sendfile() used in socket and shutil modules was raising OverflowError for files >= 2GiB on 32-bit architectures. (patch by Giampaolo Rodola)
bpo-38242: Revert the new asyncio Streams API
bpo-13153: OS native encoding is now used for converting between Python strings and Tcl objects. This allows to display, copy and paste to clipboard emoji and other non-BMP characters. Converting strings from Tcl to Python and back now never fails (except MemoryError).
bpo-38019: Correctly handle pause/resume reading of closed asyncio unix pipe.
bpo-38163: Child mocks will now detect their type as either synchronous or asynchronous, asynchronous child mocks will be AsyncMocks and synchronous child mocks will be either MagicMock or Mock (depending on their parent type).
bpo-38161: Removes _AwaitEvent from AsyncMock.
bpo-38216: Allow the rare code that wants to send invalid http requests from the
http.clientlibrary a way to do so. The fixes for bpo-30458 led to breakage for some projects that were relying on this ability to test their own behavior in the face of bad requests.bpo-28286: Deprecate opening
GzipFilefor writing implicitly. Always specify the mode argument for writing.bpo-38108: Any synchronous magic methods on an AsyncMock now return a MagicMock. Any asynchronous magic methods on a MagicMock now return an AsyncMock.
bpo-38265: Update the length parameter of
os.pread()to acceptPy_ssize_tinstead ofint.bpo-38112:
compileallhas a higher default recursion limit and new command-line arguments for path manipulation, symlinks handling, and multiple optimization levels.bpo-38248: asyncio: Fix inconsistent immediate Task cancellation
bpo-38237: The arguments for the builtin pow function are more descriptive. They can now also be passed in as keywords.
bpo-34002: Improve efficiency in parts of email package by changing while-pop to a for loop, using isdisjoint instead of set intersections.
bpo-38191: Constructors of
NamedTupleandTypedDicttypes now accept arbitrary keyword argument names, including “cls”, “self”, “typename”, “_typename”, “fields” and “_fields”.bpo-38185: Fixed case-insensitive string comparison in
sqlite3.Rowindexing.bpo-38136: Changes AsyncMock call count and await count to be two different counters. Now await count only counts when a coroutine has been awaited, not when it has been called, and vice-versa. Update the documentation around this.
bpo-37828: Fix default mock name in
unittest.mock.Mock.assert_called()exceptions. Patch by Abraham Toriz Cruz.bpo-38175: Fix a memory leak in comparison of
sqlite3.Rowobjects.bpo-33936: _hashlib no longer calls obsolete OpenSSL initialization function with OpenSSL 1.1.0+.
bpo-34706: Preserve subclassing in inspect.Signature.from_callable.
bpo-38153: Names of hashing algorithms from OpenSSL are now normalized to follow Python’s naming conventions. For example OpenSSL uses sha3-512 instead of sha3_512 or blake2b512 instead of blake2b.
bpo-38115: Fix a bug in dis.findlinestarts() where it would return invalid bytecode offsets. Document that a code object’s co_lnotab can contain invalid bytecode offsets.
bpo-38148: Add slots to
asynciotransport classes, which can reduce memory usage.bpo-38142: The _hashlib OpenSSL wrapper extension module is now PEP-384 compliant.
bpo-9216: hashlib constructors now support usedforsecurity flag to signal that a hashing algorithm is not used in a security context.
bpo-36991: Fixes a potential incorrect AttributeError exception escaping ZipFile.extract() in some unsupported input error situations.
bpo-38134: Remove obsolete copy of PBKDF2_HMAC_fast. All supported OpenSSL versions contain a fast implementation.
bpo-38132: The OpenSSL hashlib wrapper uses a simpler implementation. Several Macros and pointless caches are gone. The hash name now comes from OpenSSL’s EVP. The algorithm name stays the same, except it is now always lower case.
bpo-38008: Fix parent class check in protocols to correctly identify the module that provides a builtin protocol, instead of assuming they all come from the
collections.abcmodulebpo-34037: For
asyncio, add a new coroutineloop.shutdown_default_executor(). The new coroutine provides an API to schedule an executor shutdown that waits on the threadpool to finish closing. Also,asyncio.run()has been updated to utilize the new coroutine. Patch by Kyle Stanley.bpo-37405: Fixed regression bug for socket.getsockname() for non-CAN_ISOTP AF_CAN address family sockets by returning a 1-tuple instead of string.
bpo-38121: Update parameter names on functions in importlib.metadata matching the changes in the 0.22 release of importlib_metadata.
bpo-38110: The os.closewalk() implementation now uses the libc fdwalk() API on platforms where it is available.
bpo-38093: Fixes AsyncMock so it doesn’t crash when used with AsyncContextManagers or AsyncIterators.
bpo-37488: Add warning to
datetime.utctimetuple(),datetime.utcnow()anddatetime.utcfromtimestamp().bpo-35640: Allow passing a path-like object as
directoryargument to thehttp.server.SimpleHTTPRequestHandlerclass. Patch by Géry Ogam.bpo-38086: Update importlib.metadata with changes from importlib_metadata 0.21.
bpo-37251: Remove
__code__check in AsyncMock that incorrectly evaluated function specs as async objects but failed to evaluate classes with__await__but no__code__attribute defined as async objects.bpo-38066: Hide internal asyncio.Stream methods: feed_eof(), feed_data(), set_exception() and set_transport().
bpo-38059: inspect.py now uses sys.exit() instead of exit()
bpo-37953: In
typing, improved the__hash__and__eq__methods forForwardReferences.bpo-38026: Fixed
inspect.getattr_static()usedisinstancewhile it should avoid dynamic lookup.bpo-35923: Update
importlib.machinery.BuiltinImporterto useloader._ORIGINinstead of a hardcoded value. Patch by Dong-hee Na.bpo-38010: In
importlib.metadatasync withimportlib_metadata0.20, clarifying behavior offiles()and fixing issue where only one requirement was returned forrequires()ondist-infopackages.bpo-38006: weakref.WeakValueDictionary defines a local remove() function used as callback for weak references. This function was created with a closure. Modify the implementation to avoid the closure.
bpo-37995: Added the indent option to
ast.dump()which allows it to produce a multiline indented output.bpo-34410: Fixed a crash in the
tee()iterator when re-enter it. RuntimeError is now raised in this case.bpo-37140: Fix a ctypes regression of Python 3.8. When a ctypes.Structure is passed by copy to a function, ctypes internals created a temporary object which had the side effect of calling the structure finalizer (__del__) twice. The Python semantics requires a finalizer to be called exactly once. Fix ctypes internals to no longer call the finalizer twice.
bpo-37587:
_json.scanstringis now up to 3x faster when there are many backslash escaped characters in the JSON string.bpo-37834: Prevent shutil.rmtree exception when built on non-Windows system without fd system call support, like older versions of macOS.
bpo-10978: Semaphores and BoundedSemaphores can now release more than one waiting thread at a time.
bpo-37972: Subscripts to the
unittest.mock.callobjects now receive the same chaining mechanism as any other custom attributes, so that the following usage no longer raises aTypeError:call().foo().__getitem__(‘bar’)
Patch by blhsing
bpo-37965: Fix C compiler warning caused by distutils.ccompiler.CCompiler.has_function.
bpo-37960:
repr()of buffered and text streams now silences only expected exceptions when get the value of “name” and “mode” attributes.bpo-37961: Add a
total_nframefield to the traces collected by the tracemalloc module. This field indicates the original number of frames before it was truncated.bpo-37951: Most features of the subprocess module now work again in subinterpreters. Only preexec_fn is restricted in subinterpreters.
bpo-36205: Fix the rusage implementation of time.process_time() to correctly report the sum of the system and user CPU time.
bpo-37950: Fix
ast.dump()when call with incompletely initialized node.bpo-34679: Restores instantiation of Windows IOCP event loops from the non-main thread.
bpo-36917: Add default implementation of the
ast.NodeVisitor.visit_Constant()method which emits a deprecation warning and calls corresponding methodyvisit_Num(),visit_Str(), etc.bpo-37798: Update test_statistics.py to verify that the statistics module works well for both C and Python implementations. Patch by Dong-hee Na
bpo-26589: Added a new status code to the http module: 451 UNAVAILABLE_FOR_LEGAL_REASONS
bpo-37915: Fix a segmentation fault that appeared when comparing instances of
datetime.timezoneanddatetime.tzinfoobjects. Patch by Pablo Galindo.bpo-32554: Deprecate having random.seed() call hash on arbitrary types.
bpo-9938: Add optional keyword argument
exit_on_errorforArgumentParser.bpo-37851: The
faulthandlermodule no longer allocates its alternative stack at Python startup. Now the stack is only allocated at the first faulthandler usage.bpo-32793: Fix a duplicated debug message when
smtplib.SMTP.connect()is called.bpo-37885: venv: Don’t generate unset variable warning on deactivate.
bpo-37868: Fix dataclasses.is_dataclass when given an instance that never raises AttributeError in __getattr__. That is, an object that returns something for __dataclass_fields__ even if it’s not a dataclass.
bpo-37811: Fix
socketmodule’ssocket.connect(address)function being unable to establish connection in case of interrupted system call. The problem was observed on all OSes whichpoll(2)system call can take only non-negative integers and -1 as a timeout value.bpo-37863: Optimizations for Fraction.__hash__ suggested by Tim Peters.
bpo-21131: Fix
faulthandler.register(chain=True)stack. faulthandler now allocates a dedicated stack ofSIGSTKSZ*2bytes, instead of justSIGSTKSZbytes. Calling the previous signal handler in faulthandler signal handler uses more thanSIGSTKSZbytes of stack memory on some platforms.bpo-37798: Add C fastpath for statistics.NormalDist.inv_cdf() Patch by Dong-hee Na
bpo-37804: Remove the deprecated method
threading.Thread.isAlive(). Patch by Dong-hee Na.bpo-37819: Add Fraction.as_integer_ratio() to match the corresponding methods in bool, int, float, and decimal.
bpo-14465: Add an xml.etree.ElementTree.indent() function for pretty-printing XML trees. Contributed by Stefan Behnel.
bpo-37810: Fix
difflib?hint in diff output when dealing with tabs. Patch by Anthony Sottile.bpo-37772: In
zipfile.Path, when adding implicit dirs, ensure that ancestral directories are added and that duplicates are excluded.bpo-18578: Renamed and documented
test.bytecode_helperastest.support.bytecode_helper. Patch by Joannah Nanjekye.bpo-34488:
writelines()method ofio.BytesIOis now slightly faster when many small lines are passed. Patch by Sergey Fedoseev.bpo-37449:
ensurepipnow usesimportlib.resources.read_binary()to read data instead ofpkgutil.get_data(). Patch by Joannah Nanjekye.bpo-28292: Mark calendar.py helper functions as being private. The follows PEP 8 guidance to maintain the style conventions in the module and it addresses a known case of user confusion.
bpo-18049: Add definition of THREAD_STACK_SIZE for AIX in Python/thread_pthread.h The default thread stacksize caused crashes with the default recursion limit Patch by M Felt
bpo-37742: The logging.getLogger() API now returns the root logger when passed the name ‘root’, whereas previously it returned a non-root logger named ‘root’. This could affect cases where user code explicitly wants a non-root logger named ‘root’, or instantiates a logger using logging.getLogger(__name__) in some top-level module called ‘root.py’.
bpo-37738: Fix the implementation of curses
addch(str, color_pair): pass the color pair tosetcchar(), instead of always passing 0 as the color pair.bpo-37723: Fix performance regression on regular expression parsing with huge character sets. Patch by Yann Vaginay.
bpo-35943: The function
PyImport_GetModule()now ensures any module it returns is fully initialized. Patch by Joannah Nanjekye.bpo-32178: Fix IndexError in
emailpackage when trying to parse invalid address fields starting with:.bpo-37268: The
parsermodule is deprecated and will be removed in future versions of Python.bpo-37685: Fixed comparisons of
datetime.timedeltaanddatetime.timezone.bpo-37697: Synchronize
importlib.metadatawith importlib_metadata 0.19, improving handling of EGG-INFO files and fixing a crash when entry point names contained colons.bpo-37695: Correct
curses.unget_wch()error message. Patch by Anthony Sottile.bpo-37689: Add
is_relative_to()inPurePathto determine whether or not one path is relative to another.bpo-29553: Fixed
argparse.ArgumentParser.format_usage()for mutually exclusive groups. Patch by Andrew Nester.bpo-37691: Let math.dist() accept coordinates as sequences (or iterables) rather than just tuples.
bpo-37685: Fixed
__eq__,__lt__etc implementations in some classes. They now returnNotImplementedfor unsupported type of the other operand. This allows the other operand to play role (for example the equality comparison withANYwill returnTrue).bpo-37354: Make Activate.ps1 Powershell script static to allow for signing it.
bpo-37664: Update wheels bundled with ensurepip (pip 19.2.3 and setuptools 41.2.0)
bpo-37663: Bring consistency to venv shell activation scripts by always using __VENV_PROMPT__.
bpo-37642: Allowed the pure Python implementation of
datetime.timezoneto represent sub-minute offsets close to minimum and maximum boundaries, specifically in the ranges (23:59, 24:00) and (-23:59, 24:00). Patch by Ngalim Siregarbpo-36161: In
posix, usettyname_rinstead ofttynamefor thread safety.bpo-36324: Make internal attributes for statistics.NormalDist() private.
bpo-37555: Fix
NonCallableMock._call_matcherreturning tuple instead of_Callobject whenself._spec_signatureexists. Patch by Elizabeth Useltonbpo-29446: Make
from tkinter import *import only the expected objects.bpo-16970: Adding a value error when an invalid value in passed to nargs Patch by Robert Leenders
bpo-34443: Exceptions from
enumnow use the__qualnameof the enum class in the exception message instead of the__name__.bpo-37491: Fix
IndexErrorwhen parsing email headers with unexpectedly ending bare-quoted string value. Patch by Abhilash Raj.bpo-37587: Make json.loads faster for long strings. (Patch by Marco Paolini)
bpo-18378: Recognize “UTF-8” as a valid value for LC_CTYPE in locale._parse_localename.
bpo-37579: Return
NotImplementedin Python implementation of__eq__fortimedeltaandtimewhen the other object being compared is not of the same type to match C implementation. Patch by Karthikeyan Singaravelan.bpo-21478: Record calls to parent when autospecced object is attached to a mock using
unittest.mock.attach_mock(). Patch by Karthikeyan Singaravelan.bpo-37531: “python3 -m test -jN –timeout=TIMEOUT” now kills a worker process if it runs longer than TIMEOUT seconds.
bpo-37482: Fix serialization of display name in originator or destination address fields with both encoded words and special chars.
bpo-36993: Improve error reporting for corrupt zip files with bad zip64 extra data. Patch by Daniel Hillier.
bpo-37502: pickle.loads() no longer raises TypeError when the buffers argument is set to None
bpo-37520: Correct behavior for zipfile.Path.parent when the path object identifies a subdirectory.
bpo-18374: Fix the
.col_offsetattribute of nestedast.BinOpinstances which had a too large value in some situations.bpo-37424: Fixes a possible hang when using a timeout on
subprocess.run()while capturing output. If the child process spawned its own children or otherwise connected its stdout or stderr handles with another process, we could hang after the timeout was reached and our child was killed when attempting to read final output from the pipes.bpo-37421: Fix
multiprocessing.util.get_temp_dir()finalizer: clear also the ‘tempdir’ configuration of the current process, so next call toget_temp_dir()will create a new temporary directory, rather than reusing the removed temporary directory.bpo-37481: The distutils
bdist_wininstcommand is deprecated in Python 3.8, usebdist_wheel(wheel packages) instead.bpo-37479: When
Enum.__str__is overridden in a derived class, the override will be used byEnum.__format__regardless of whether mixin classes are present.bpo-37440: http.client now enables TLS 1.3 post-handshake authentication for default context or if a cert_file is passed to HTTPSConnection.
bpo-37437: Update vendorized expat version to 2.2.7.
bpo-37428: SSLContext.post_handshake_auth = True no longer sets SSL_VERIFY_POST_HANDSHAKE verify flag for client connections. Although the option is documented as ignored for clients, OpenSSL implicitly enables cert chain validation when the flag is set.
bpo-37420:
os.sched_setaffinity()now correctly handles errors that arise during iteration over itsmaskargument. Patch by Brandt Bucher.bpo-37412: The
os.getcwdb()function now uses the UTF-8 encoding on Windows, rather than the ANSI code page: see PEP 529 for the rationale. The function is no longer deprecated on Windows.bpo-37406: The sqlite3 module now raises TypeError, rather than ValueError, if operation argument type is not str: execute(), executemany() and calling a connection.
bpo-29412: Fix IndexError in parsing a header value ending unexpectedly. Patch by Abhilash Raj.
bpo-36546: The dist argument for statistics.quantiles() is now positional only. The current name doesn’t reflect that the argument can be either a dataset or a distribution. Marking the parameter as positional avoids confusion and makes it possible to change the name later.
bpo-37394: Fix a bug that was causing the
queuemodule to fail if the accelerator module was not available. Patch by Pablo Galindo.bpo-37376:
pprintnow has support fortypes.SimpleNamespace. Patch by Carl Bordum Hansen.bpo-26967: An
ArgumentParserwithallow_abbrev=Falseno longer disables grouping of short flags, such as-vv, but only disables abbreviation of long flags as documented. Patch by Zac Hatfield-Dodds.bpo-37212:
unittest.mock.call()now preserves the order of keyword arguments in repr output. Patch by Karthikeyan Singaravelan.bpo-37372: Fix error unpickling datetime.time objects from Python 2 with seconds>=24. Patch by Justin Blanchard.
bpo-37345: Add formal support for UDPLITE sockets. Support was present before, but it is now easier to detect support with
hasattr(socket, 'IPPROTO_UDPLITE')and there are constants defined for each of the values needed:socket.IPPROTO_UDPLITE,UDPLITE_SEND_CSCOV, andUDPLITE_RECV_CSCOV. Patch by Gabe Appleton.bpo-37358: Optimized
functools.partialby using vectorcall.bpo-37347:
sqlite3.Connection.create_aggregate(),sqlite3.Connection.create_function(),sqlite3.Connection.set_authorizer(),sqlite3.Connection.set_progress_handler()sqlite3.Connection.set_trace_callback()methods lead to segfaults if some of these methods are called twice with an equal object but not the same. Now callbacks are stored more carefully. Patch by Aleksandr Balezin.bpo-37163: The obj argument of
dataclasses.replace()is positional-only now.bpo-37085: Add the optional Linux SocketCAN Broadcast Manager constants, used as flags to configure the BCM behaviour, in the socket module. Patch by Karl Ding.
bpo-37328:
HTMLParser.unescapeis removed. It was undocumented and deprecated since Python 3.4.bpo-37305: Add .webmanifest -> application/manifest+json to list of recognized file types and content type headers
bpo-37320:
aifc.openfp()alias toaifc.open(),sunau.openfp()alias tosunau.open(), andwave.openfp()alias towave.open()have been removed. They were deprecated since Python 3.7.bpo-37315: Deprecated accepting floats with integral value (like
5.0) inmath.factorial().bpo-37312:
_dummy_threadanddummy_threadingmodules have been removed. These modules were deprecated since Python 3.7 which requires threading support.bpo-33972: Email with single part but content-type set to
multipart/*doesn’t raise AttributeError anymore.bpo-37280: Use threadpool for reading from file for sendfile fallback mode.
bpo-37279: Fix asyncio sendfile support when sendfile sends extra data in fallback mode.
bpo-19865:
ctypes.create_unicode_buffer()now also supports non-BMP characters on platforms with 16-bitwchar_t(for example, Windows and AIX).bpo-37266: In a subinterpreter, spawning a daemon thread now raises an exception. Daemon threads were never supported in subinterpreters. Previously, the subinterpreter finalization crashed with a Python fatal error if a daemon thread was still running.
bpo-37210: Allow pure Python implementation of
pickleto work even when the C_picklemodule is unavailable.bpo-21872: Fix
lzma: module decompresses data incompletely. When decompressing a FORMAT_ALONE format file, and it doesn’t have the end marker, sometimes the last one to dozens bytes can’t be output. Patch by Ma Lin.bpo-35922: Fix
RobotFileParser.crawl_delay()andRobotFileParser.request_rate()to returnNonerather than raiseAttributeErrorwhen no relevant rule is defined in the robots.txt file. Patch by Rémi Lapeyre.bpo-35766: Change the format of feature_version to be a (major, minor) tuple.
bpo-36607: Eliminate
RuntimeErrorraised byasyncio.all_tasks()if internal tasks weak set is changed by another thread during iteration.bpo-18748:
_pyio.IOBasedestructor now does nothing if getting theclosedattribute fails to better mimic_io.IOBasefinalizer.bpo-36402: Fix a race condition at Python shutdown when waiting for threads. Wait until the Python thread state of all non-daemon threads get deleted (join all non-daemon threads), rather than just wait until non-daemon Python threads complete.
bpo-37206: Default values which cannot be represented as Python objects no longer improperly represented as
Nonein function signatures.bpo-37111: Added
encodinganderrorskeyword parameters tologging.basicConfig.bpo-12144: Ensure cookies with
expiresattribute are handled inCookieJar.make_cookies().bpo-34886: Fix an unintended ValueError from
subprocess.run()when checking for conflictinginputandstdinorcapture_outputandstdoutorstderrargs when they were explicitly provided but withNonevalues within a passed in**kwargsdict rather than as passed directly by name. Patch contributed by Rémi Lapeyre.bpo-37173: The exception message for
inspect.getfile()now correctly reports the passed class rather than the builtins module.bpo-37178: Give math.perm() a one argument form that means the same as math.factorial().
bpo-37178: For math.perm(n, k), let k default to n, giving the same result as factorial.
bpo-37165: Converted _collections._count_elements to use the Argument Clinic.
bpo-34767: Do not always create a
collections.dequeinasyncio.Lock.bpo-37158: Speed-up statistics.fmean() by switching from a function to a generator.
bpo-34282: Remove
Enum._convertmethod, deprecated in 3.8.bpo-37150:
argparse._ActionsContainer.add_argumentnow throws error, if someone accidentally pass FileType class object instead of instance of FileType astypeargumentbpo-28724: The socket module now has the
socket.send_fds()andsocket.recv.fds()methods. Contributed by Joannah Nanjekye, Shinya Okano and Victor Stinner.bpo-35621: Support running asyncio subprocesses when execution event loop in a thread on UNIX.
bpo-36520: Lengthy email headers with UTF-8 characters are now properly encoded when they are folded. Patch by Jeffrey Kintscher.
bpo-30835: Fixed a bug in email parsing where a message with invalid bytes in content-transfer-encoding of a multipart message can cause an AttributeError. Patch by Andrew Donnellan.
bpo-31163: pathlib.Path instance’s rename and replace methods now return the new Path instance.
bpo-25068:
urllib.request.ProxyHandlernow lowercases the keys of the passed dictionary.bpo-26185: Fix
repr()on emptyZipInfoobject. Patch by Mickaël Schoentgen.bpo-21315: Email headers containing RFC2047 encoded words are parsed despite the missing whitespace, and a defect registered. Also missing trailing whitespace after encoded words is now registered as a defect.
bpo-31904: Port test_datetime to VxWorks: skip zoneinfo tests on VxWorks
bpo-35805: Add parser for Message-ID header and add it to default HeaderRegistry. This should prevent folding of Message-ID using RFC 2048 encoded words.
bpo-36871: Ensure method signature is used instead of constructor signature of a class while asserting mock object against method calls. Patch by Karthikeyan Singaravelan.
bpo-35070: posix.getgrouplist() now works correctly when the user belongs to NGROUPS_MAX supplemental groups. Patch by Jeffrey Kintscher.
bpo-31783: Fix race condition in ThreadPoolExecutor when worker threads are created during interpreter shutdown.
bpo-36582: Fix
UserString.encode()to correctly returnbytesrather than aUserStringinstance.bpo-32424: Deprecate xml.etree.ElementTree.Element.copy() in favor of copy.copy().
Patch by Gordon P. Hemsley
bpo-36564: Fix infinite loop in email header folding logic that would be triggered when an email policy’s max_line_length is not long enough to include the required markup and any values in the message. Patch by Paul Ganssle
bpo-36543: Removed methods Element.getchildren(), Element.getiterator() and ElementTree.getiterator() and the xml.etree.cElementTree module.
bpo-36409: Remove the old plistlib API deprecated in Python 3.4
bpo-36302: distutils sorts source file lists so that Extension .so files build more reproducibly by default
bpo-36250: Ignore
ValueErrorfromsignalwithinteractionin non-main thread.bpo-36046: Added
user,groupandextra_groupsparameters to the subprocess.Popen constructor. Patch by Patrick McLean.bpo-32627: Fix compile error when
_uuidheaders conflicting included.bpo-35800: Deprecate
smtpd.MailmanProxyready for future removal.bpo-35168:
shlex.shlex.punctuation_charsis now a read-only property.bpo-8538: Add support for boolean actions like
--fooand--no-footo argparse. Patch contributed by Rémi Lapeyre.bpo-20504: Fixes a bug in
cgimodule when a multipart/form-data request has noContent-Lengthheader.bpo-25988: The abstract base classes in
collections.abcno longer are exposed in the regularcollectionsmodule.bpo-11122: Distutils won’t check for rpmbuild in specified paths only.
bpo-34775: Division handling of PurePath now returns NotImplemented instead of raising a TypeError when passed something other than an instance of str or PurePath. Patch by Roger Aiudi.
bpo-34749:
binascii.a2b_base64()is now up to 2 times faster. Patch by Sergey Fedoseev.bpo-34519: Add additional aliases for HP Roman 8. Patch by Michael Osipov.
bpo-28009: Fix uuid.getnode() on platforms with ‘.’ as MAC Addr delimiter as well fix for MAC Addr format that omits a leading 0 in MAC Addr values. Currently, AIX is the only know platform with these settings. Patch by Michael Felt.
bpo-30618: Add
readlink(). Patch by Girts Folkmanis.bpo-32498: Made
urllib.parse.unquote()accept bytes in addition to strings. Patch by Stein Karlsen.bpo-33348: lib2to3 now recognizes expressions after
*and**like inf(*[] or []).bpo-32689: Update
shutil.move()function to allow for Path objects to be used as source argument. Patch by Emily Morehouse and Maxwell “5.13b” McKinnon.bpo-32820: Added __format__ to IPv4 and IPv6 classes. Always outputs a fully zero- padded string. Supports b/x/n modifiers (bin/hex/native format). Native format for IPv4 is bin, native format for IPv6 is hex. Also supports ‘#’ and ‘_’ modifiers.
bpo-27657: Fix urllib.parse.urlparse() with numeric paths. A string like “path:80” is no longer parsed as a path but as a scheme (“path”) and a path (“80”).
bpo-4963: Fixed non-deterministic behavior related to mimetypes extension mapping and module reinitialization.
Documentation¶
bpo-21767: Explicitly mention abc support in functools.singledispatch
bpo-38816: Provides more details about the interaction between
fork()and CPython’s runtime, focusing just on the C-API. This includes cautions about wherefork()should and shouldn’t be called.bpo-38351: Modernize
emailexamples from %-formatting to f-strings.bpo-38778: Document the fact that
RuntimeErroris raised ifos.fork()is called in a subinterpreter.bpo-38592: Add Brazilian Portuguese to the language switcher at Python Documentation website.
bpo-38294: Add list of no-longer-escaped chars to re.escape documentation
bpo-38053: Modernized the plistlib documentation
bpo-26868: Fix example usage of
PyModule_AddObject()to properly handle errors.bpo-36797: Fix a dead link in the distutils API Reference.
bpo-37977: Warn more strongly and clearly about pickle insecurity
bpo-37979: Added a link to dateutil.parser.isoparse in the datetime.fromisoformat documentation. Patch by Paul Ganssle
bpo-12707: Deprecate info(), geturl(), getcode() methods in favor of the headers, url, and status properties, respectively, for HTTPResponse and addinfourl. Also deprecate the code attribute of addinfourl in favor of the status attribute. Patch by Ashwin Ramaswami
bpo-37937: Mention
frame.f_traceinsys.settrace()docs.bpo-37878: Make
PyThreadState_DeleteCurrent()Internal.bpo-37759: Beginning edits to Whatsnew 3.8
bpo-37726: Stop recommending getopt in the tutorial for command line argument parsing and promote argparse.
bpo-32910: Remove implementation-specific behaviour of how venv’s Deactivate works.
bpo-37256: Fix wording of arguments for
Requestinurllib.requestbpo-37284: Add a brief note to indicate that any new
sys.implementationrequired attributes must go through the PEP process.bpo-30088: Documented that
mailbox.Maildirconstructor doesn’t attempt to verify the maildir folder layout correctness. Patch by Sviatoslav Sydorenko.bpo-37521: Fix
importlibexamples to insert any newly created modules via importlib.util.module_from_spec() immediately into sys.modules instead of after calling loader.exec_module().Thanks to Benjamin Mintz for finding the bug.
bpo-37456: Slash (‘/’) is now part of syntax.
bpo-37487: Fix PyList_GetItem index description to include 0.
bpo-37149: Replace the dead link to the Tkinter 8.5 reference by John Shipman, New Mexico Tech, with a link to the archive.org copy.
bpo-37478: Added possible exceptions to the description of os.chdir().
bpo-34903: Documented that in
datetime.datetime.strptime(), the leading zero in some two-digit formats is optional. Patch by Mike Gleen.bpo-36260: Add decompression pitfalls to zipfile module documentation.
bpo-37004: In the documentation for difflib, a note was added explicitly warning that the results of SequenceMatcher’s ratio method may depend on the order of the input strings.
bpo-36960: Restructured the
datetimedocs in the interest of making them more user-friendly and improving readability. Patch by Brad Solomon.bpo-36487: Make C-API docs clear about what the “main” interpreter is.
bpo-23460: The documentation for decimal string formatting using the
:gspecifier has been updated to reflect the correct exponential notation cutoff point. Original patch contributed by Tuomas Suutari.bpo-35803: Document and test that
tempfilefunctions may accept a path-like object for thedirargument. Patch by Anthony Sottile.bpo-33944: Added a note about the intended use of code in .pth files.
bpo-34293: Fix the Doc/Makefile regarding PAPER environment variable and PDF builds
bpo-25237: Add documentation for tkinter modules
Tests¶
bpo-38614: Fix test_communicate() of test_asyncio.test_subprocess: use
support.LONG_TIMEOUT(5 minutes), instead of just 1 minute.bpo-38614: Add timeout constants to
test.support:LOOPBACK_TIMEOUT,INTERNET_TIMEOUT,SHORT_TIMEOUTandLONG_TIMEOUT.bpo-38502: test.regrtest now uses process groups in the multiprocessing mode (-jN command line option) if process groups are available: if
os.setsid()andos.killpg()functions are available.bpo-35998: Fix a race condition in test_asyncio.test_start_tls_server_1(). Previously, there was a race condition between the test main() function which replaces the protocol and the test ServerProto protocol which sends ANSWER once it gets HELLO. Now, only the test main() function is responsible to send data, ServerProto no longer sends data.
bpo-38470: Fix
test_compileall.test_compile_dir_maxlevels()on Windows without long path support: only create 3 subdirectories instead of between 20 and 100 subdirectories.bpo-37531: On timeout, regrtest no longer attempts to call
popen.communicate()again: it can hang until all child processes using stdout and stderr pipes completes. Kill the worker process and ignores its output. Change also the faulthandler timeout of the main process from 1 minute to 5 minutes, for Python slowest buildbots.bpo-38239: Fix test_gdb for Link Time Optimization (LTO) builds.
bpo-38275: test_ssl now handles disabled TLS/SSL versions better. OpenSSL’s crypto policy and run-time settings are recognized and tests for disabled versions are skipped. Tests also accept more TLS minimum_versions for platforms that override OpenSSL’s default with strict settings.
bpo-38271: The private keys for test_ssl were encrypted with 3DES in traditional PKCS#5 format. 3DES and the digest algorithm of PKCS#5 are blocked by some strict crypto policies. Use PKCS#8 format with AES256 encryption instead.
bpo-38270: test.support now has a helper function to check for availability of a hash digest function. Several tests are refactored avoid MD5 and use SHA256 instead. Other tests are marked to use MD5 and skipped when MD5 is disabled.
bpo-37123: Multiprocessing test test_mymanager() now also expects -SIGTERM, not only exitcode 0. BaseManager._finalize_manager() sends SIGTERM to the manager process if it takes longer than 1 second to stop, which happens on slow buildbots.
bpo-38212: Multiprocessing tests: increase test_queue_feeder_donot_stop_onexc() timeout from 1 to 60 seconds.
bpo-38117: Test with OpenSSL 1.1.1d
bpo-38018: Increase code coverage for multiprocessing.shared_memory.
bpo-37805: Add tests for json.dump(…, skipkeys=True). Patch by Dong-hee Na.
bpo-37531: Enhance regrtest multiprocess timeout: write a message when killing a worker process, catch popen.kill() and popen.wait() exceptions, put a timeout on the second call to popen.communicate().
bpo-37876: Add tests for ROT-13 codec.
bpo-36833: Added tests for PyDateTime_xxx_GET_xxx() macros of the C API of the
datetimemodule. Patch by Joannah Nanjekye.bpo-37558: Fix test_shared_memory_cleaned_after_process_termination name handling
bpo-37526: Add
test.support.catch_threading_exception(): context manager catchingthreading.Threadexception usingthreading.excepthook().bpo-37421: test_concurrent_futures now explicitly stops the ForkServer instance if it’s running.
bpo-37421: multiprocessing tests now stop the ForkServer instance if it’s running: close the “alive” file descriptor to ask the server to stop and then remove its UNIX address.
bpo-37421: test_distutils.test_build_ext() is now able to remove the temporary directory on Windows: don’t import the newly built C extension (“xx”) in the current process, but test it in a separated process.
bpo-37421: test_concurrent_futures now cleans up multiprocessing to remove immediately temporary directories created by multiprocessing.util.get_temp_dir().
bpo-37421: test_winconsoleio doesn’t leak a temporary file anymore: use tempfile.TemporaryFile() to remove it when the test completes.
bpo-37421: multiprocessing tests now explicitly call
_run_finalizers()to immediately remove temporary directories created by tests.bpo-37421: urllib.request tests now call
urlcleanup()to remove temporary files created byurlretrieve()tests and to clear the_openerglobal variable set byurlopen()and functions calling indirectlyurlopen().bpo-37472: Remove
Lib/test/outstanding_bugs.py.bpo-37199: Fix test failures when IPv6 is unavailable or disabled.
bpo-19696: Replace deprecated method “random.choose” with “random.choice” in “test_pkg_import.py”.
bpo-37335: Remove no longer necessary code from c locale coercion tests
bpo-37421: Fix test_shutil to no longer leak temporary files.
bpo-37411: Fix test_wsgiref.testEnviron() to no longer depend on the environment variables (don’t fail if “X” variable is set).
bpo-37400: Fix test_os.test_chown(): use os.getgroups() rather than grp.getgrall() to get groups. Rename also the test to test_chown_gid().
bpo-37359: Add –cleanup option to python3 -m test to remove
test_python_*directories of previous failed jobs. Add “make cleantest” to runpython3 -m test --cleanup.bpo-37362: test_gdb no longer fails if it gets an “unexpected” message on stderr: it now ignores stderr. The purpose of test_gdb is to test that python-gdb.py commands work as expected, not to test gdb.
bpo-35998: Avoid TimeoutError in test_asyncio: test_start_tls_server_1()
bpo-37278: Fix test_asyncio ProactorLoopCtrlC: join the thread to prevent leaking a running thread and leaking a reference.
bpo-37261: Fix
test.support.catch_unraisable_exception(): its __exit__() method now ignores unraisable exception raised when clearing itsunraisableattribute.bpo-37069: regrtest now uses
sys.unraisablehook()to mark a test as “environment altered” (ENV_CHANGED) if it emits an “unraisable exception”. Moreover, regrtest logs a warning in this case.Use
python3 -m test --fail-env-changedto catch unraisable exceptions in tests.bpo-37252: Fix assertions in
test_closeandtest_events_mask_overflowdevpoll tests.bpo-37169: Rewrite
_PyObject_IsFreed()unit tests.bpo-37153:
test_venv.test_multiprocessing()now explicitly callspool.terminate()to wait until the pool completes.bpo-34001: Make test_ssl pass with LibreSSL. LibreSSL handles minimum and maximum TLS version differently than OpenSSL.
bpo-36919: Make
test_source_encoding.test_issue2301implementation independent. The test will work now for both CPython and IronPython.bpo-30202: Update
test.test_importlib.test_abcto testfind_spec().bpo-28009: Modify the test_uuid logic to test when a program is available AND can be used to obtain a MACADDR as basis for an UUID. Patch by M. Felt
bpo-34596: Fallback to a default reason when
unittest.skip()is uncalled. Patch by Naitree Zhu.
Build¶
bpo-38809: On Windows, build scripts will now recognize and use python.exe from an active virtual env.
bpo-38684: Fix _hashlib build when Blake2 is disabled, but OpenSSL supports it.
bpo-38468: Misc/python-config.in now uses
getvar()for all still existingsysconfig.get_config_var()calls. Patch by Joannah Nanjekye.bpo-37415: Fix stdatomic.h header check for ICC compiler: the ICC implementation lacks atomic_uintptr_t type which is needed by Python.
bpo-38301: In Solaris family, we must be sure to use
-D_REENTRANT. Patch by Jesús Cea Avión.bpo-36002: Locate
llvm-profdataandllvm-arbinaries usingAC_PATH_TOOLrather thanAC_PATH_TARGET_TOOL.bpo-37936: The
.gitignorefile systematically keeps “rooted”, with a non-trailing slash, all the rules that are meant to apply to files in a specific place in the repo. Previously, when the intended file to ignore happened to be at the root of the repo, we’d most often accidentally also ignore files and directories with the same name anywhere in the tree.bpo-37760: The
Tools/unicode/makeunicodedata.pyscript, which is used for converting information from the Unicode Character Database into generated code and data used by the methods ofstrand by theunicodedatamodule, now handles each character’s data as adataclasswith named attributes, rather than a length-18 list of different fields.bpo-37936: The
.gitignorefile no longer applies to any files that are in fact tracked in the Git repository. Patch by Greg Price.bpo-37725: Change “clean” makefile target to also clean the program guided optimization (PGO) data. Previously you would have to use “make clean” and “make profile-removal”, or “make clobber”.
bpo-37707: Mark some individual tests to skip when –pgo is used. The tests marked increase the PGO task time significantly and likely don’t help improve optimization of the final executable.
bpo-36044: Reduce the number of unit tests run for the PGO generation task. This speeds up the task by a factor of about 15x. Running the full unit test suite is slow. This change may result in a slightly less optimized build since not as many code branches will be executed. If you are willing to wait for the much slower build, the old behavior can be restored using ‘./configure [..] PROFILE_TASK=”-m test –pgo-extended”’. We make no guarantees as to which PGO task set produces a faster build. Users who care should run their own relevant benchmarks as results can depend on the environment, workload, and compiler tool chain.
bpo-37468:
make installno longer installswininst-*.exefiles used by distutils bdist_wininst: bdist_wininst only works on Windows.bpo-37189: Many
PyRun_XXX()functions likePyRun_String()were no longer exported inlibpython38.dllby mistake. Export them again to fix the ABI compatibility.bpo-25361: Enables use of SSE2 instructions in Windows 32-bit build.
bpo-36210: Update optional extension module detection for AIX. ossaudiodev and spwd are not applicable for AIX, and are no longer reported as missing. 3rd-party packaging of ncurses (with ASIS support) conflicts with officially supported AIX curses library, so configure AIX to use libcurses.a. However, skip trying to build _curses_panel.
patch by M Felt
Windows¶
bpo-38589: Fixes HTML Help shortcut when Windows is not installed to C drive
bpo-38453: Ensure ntpath.realpath() correctly resolves relative paths.
bpo-38519: Restores the internal C headers that were missing from the nuget.org and Microsoft Store packages.
bpo-38492: Remove
pythonw.exedependency on the Microsoft C++ runtime.bpo-38344: Fix error message in activate.bat
bpo-38359: Ensures
pyw.exelauncher reads correct registry key.bpo-38355: Fixes
ntpath.realpathfailing onsys.executable.bpo-38117: Update bundled OpenSSL to 1.1.1d
bpo-38092: Reduce overhead when using multiprocessing in a Windows virtual environment.
bpo-38133: Allow py.exe launcher to locate installations from the Microsoft Store and improve display of active virtual environments.
bpo-38114: The
pip.iniis no longer included in the Nuget package.bpo-32592: Set Windows 8 as the minimum required version for API support
bpo-36634:
os.cpu_count()now returns active processors rather than maximum processors.bpo-36634: venv activate.bat now works when the existing variables contain double quote characters.
bpo-38081: Prevent error calling
os.path.realpath()on'NUL'.bpo-38087: Fix case sensitivity in test_pathlib and test_ntpath.
bpo-38088: Fixes distutils not finding vcruntime140.dll with only the v142 toolset installed.
bpo-37283: Ensure command-line and unattend.xml setting override previously detected states in Windows installer.
bpo-38030: Fixes
os.stat()failing for block devices on Windowsbpo-38020: Fixes potential crash when calling
os.readlink()(or indirectly throughrealpath()) on a file that is not a supported link.bpo-37705: Improve the implementation of
winerror_to_errno().bpo-37549:
os.dup()no longer fails for standard streams on Windows 7.bpo-1311: The
nulfile on Windows now returns True fromexists()and a valid result fromos.stat()withS_IFCHRset.bpo-9949: Enable support for following symlinks in
os.realpath().bpo-37834: Treat all name surrogate reparse points on Windows in
os.lstat()and other reparse points as regular files inos.stat().bpo-36266: Add the module name in the formatted error message when DLL load fail happens during module import in
_PyImport_FindSharedFuncptrWindows(). Patch by Srinivas Nyayapati.bpo-25172: Trying to import the
cryptmodule on Windows will result in anImportErrorwith a message explaining that the module isn’t supported on Windows. On other platforms, if the underlying_cryptmodule is not available, the ImportError will include a message explaining the problem.bpo-37778: Fixes the icons used for file associations to the Microsoft Store package.
bpo-37734: Fix use of registry values to launch Python from Microsoft Store app.
bpo-37702: Fix memory leak on Windows in creating an SSLContext object or running urllib.request.urlopen(’https://…’).
bpo-37672: Switch Windows Store package’s pip to use bundled
pip.iniinstead ofPIP_USERvariable.bpo-10945: Officially drop support for creating bdist_wininst installers on non-Windows systems.
bpo-37445: Include the
FORMAT_MESSAGE_IGNORE_INSERTSflag inFormatMessageW()calls.bpo-37369: Fixes path for
sys.executablewhen running from the Microsoft Store.bpo-37380: Don’t collect unfinished processes with
subprocess._activeon Windows to cleanup later. Patch by Ruslan Kuprieiev.bpo-37351: Removes libpython38.a from standard Windows distribution.
bpo-35360: Update Windows builds to use SQLite 3.28.0.
bpo-37267: On Windows,
os.dup()no longer creates an inheritable fd when handling a character file.bpo-36779: Ensure
time.tznameis correct on Windows when the active code page is set to CP_UTF7 or CP_UTF8.bpo-32587: Make
winreg.REG_MULTI_SZsupport zero-length strings.bpo-28269: Replace use of
strcasecmp()for the system function_stricmp(). Patch by Minmin Gong.bpo-36590: Add native Bluetooth RFCOMM support to socket module.
macOS¶
bpo-38117: Updated OpenSSL to 1.1.1d in macOS installer.
bpo-38089: Move Azure Pipelines to latest VM versions and make macOS tests optional
bpo-18049: Increase the default stack size of threads from 5MB to 16MB on macOS, to match the stack size of the main thread. This avoids crashes on deep recursion in threads.
bpo-34602: Avoid test suite failures on macOS by no longer calling resource.setrlimit to increase the process stack size limit at runtime. The runtime change is no longer needed since the interpreter is being built with a larger default stack size.
bpo-35360: Update macOS installer to use SQLite 3.28.0.
bpo-34631: Updated OpenSSL to 1.1.1c in macOS installer.
IDLE¶
bpo-26353: Stop adding newline when saving an IDLE shell window.
bpo-4630: Add an option to toggle IDLE’s cursor blink for shell, editor, and output windows. See Settings, General, Window Preferences, Cursor Blink. Patch by Zackery Spytz.
bpo-38598: Do not try to compile IDLE shell or output windows
bpo-36698: IDLE no longer fails when write non-encodable characters to stderr. It now escapes them with a backslash, as the regular Python interpreter. Added the
errorsfield to the standard streams.bpo-35379: When exiting IDLE, catch any AttributeError. One happens when EditorWindow.close is called twice. Printing a traceback, when IDLE is run from a terminal, is useless and annoying.
bpo-38183: To avoid problems, test_idle ignores the user config directory. It no longer tries to create or access .idlerc or any files within. Users must run IDLE to discover problems with saving settings.
bpo-38077: IDLE no longer adds ‘argv’ to the user namespace when initializing it. This bug only affected 3.7.4 and 3.8.0b2 to 3.8.0b4.
bpo-38041: Shell restart lines now fill the window width, always start with ‘=’, and avoid wrapping unnecessarily. The line will still wrap if the included file name is long relative to the width.
bpo-35771: To avoid occasional spurious test_idle failures on slower machines, increase the
hover_delayin test_tooltip.bpo-37824: Properly handle user input warnings in IDLE shell. Cease turning SyntaxWarnings into SyntaxErrors.
bpo-37929: IDLE Settings dialog now closes properly when there is no shell window.
bpo-37902: Add mousewheel scrolling for IDLE module, path, and stack browsers. Patch by George Zhang.
bpo-37849: Fixed completions list appearing too high or low when shown above the current line.
bpo-36419: Refactor IDLE autocomplete and improve testing.
bpo-37748: Reorder the Run menu. Put the most common choice, Run Module, at the top.
bpo-37692: Improve highlight config sample with example shell interaction and better labels for shell elements.
bpo-37628: Settings dialog no longer expands with font size.
bpo-37627: Initialize the Customize Run dialog with the command line arguments most recently entered before. The user can optionally edit before submitting them.
bpo-33610: Fix code context not showing the correct context when first toggled on.
bpo-37530: Optimize code context to reduce unneeded background activity. Font and highlight changes now occur along with text changes instead of after a random delay.
bpo-27452: Cleanup
config.pyby inliningRemoveFileand simplifying the handling offileinCreateConfigHandlers.bpo-37325: Fix tab focus traversal order for help source and custom run dialogs.
bpo-37321: Both subprocess connection error messages now refer to the ‘Startup failure’ section of the IDLE doc.
bpo-17535: Add optional line numbers for IDLE editor windows. Windows open without line numbers unless set otherwise in the General tab of the configuration dialog.
bpo-26806: To compensate for stack frames added by IDLE and avoid possible problems with low recursion limits, add 30 to limits in the user code execution process. Subtract 30 when reporting recursion limits to make this addition mostly transparent.
bpo-37177: Properly ‘attach’ search dialogs to their main window so that they behave like other dialogs and do not get hidden behind their main window.
bpo-37039: Adjust “Zoom Height” to individual screens by momentarily maximizing the window on first use with a particular screen. Changing screen settings may invalidate the saved height. While a window is maximized, “Zoom Height” has no effect.
bpo-35763: Make calltip reminder about ‘/’ meaning positional-only less obtrusive by only adding it when there is room on the first line.
bpo-5680: Add ‘Run… Customized’ to the Run menu to run a module with customized settings. Any ‘command line arguments’ entered are added to sys.argv. One can suppress the normal Shell main module restart.
bpo-36390: Gather Format menu functions into format.py. Combine paragraph.py, rstrip.py, and format methods from editor.py.
Tools/Demos¶
bpo-38118: Update Valgrind suppression file to ignore a false alarm in
PyUnicode_Decode()when using GCC builtin strcmp().bpo-38347: pathfix.py: Assume all files that end on ‘.py’ are Python scripts when working recursively.
bpo-37803: pdb’s
--helpand--versionlong options now work.bpo-37942: Improve ArgumentClinic converter for floats.
bpo-37704: Remove
Tools/scripts/h2py.py: use cffi to access a C API in Python.bpo-37675: 2to3 now works when run from a zipped standard library.
bpo-37034: Argument Clinic now uses the argument name on errors with keyword-only argument instead of their position. Patch contributed by Rémi Lapeyre.
bpo-37064: Add option -k to pathscript.py script: preserve shebang flags. Add option -a to pathscript.py script: add flags.
C API¶
bpo-37633: Re-export some function compatibility wrappers for macros in
pythonrun.h.bpo-38644: Provide
Py_EnterRecursiveCall()andPy_LeaveRecursiveCall()as regular functions for the limited API. Previously, there were defined as macros, but these macros didn’t work with the limited API which cannot accessPyThreadState.recursion_depthfield. Remove_Py_CheckRecursionLimitfrom the stable ABI.bpo-38650: The global variable
PyStructSequence_UnnamedFieldis now a constant and refers to a constant string.bpo-38540: Fixed possible leak in
PyArg_Parse()and similar functions for format units"es#"and"et#"when the macroPY_SSIZE_T_CLEANis not defined.bpo-38395: Fix a crash in
weakref.proxyobjects due to incorrect lifetime management when calling some associated methods that may delete the last reference to object being referenced by the proxy. Patch by Pablo Galindo.bpo-36389: The
_PyObject_CheckConsistency()function is now also available in release mode. For example, it can be used to debug a crash in thevisit_decref()function of the GC.bpo-38266: Revert the removal of PyThreadState_DeleteCurrent() with documentation.
bpo-38303: Update audioop extension module to use the stable ABI (PEP-384). Patch by Tyler Kieft.
bpo-38234:
Py_SetPath()now setssys.executableto the program full path (Py_GetProgramFullPath()) rather than to the program name (Py_GetProgramName()).bpo-38234: Python ignored arguments passed to
Py_SetPath(),Py_SetPythonHome()andPy_SetProgramName(): fix Python initialization to use specified arguments.bpo-38205: The
Py_UNREACHABLE()macro now callsPy_FatalError().bpo-38140: Make dict and weakref offsets opaque for C heap types by passing the offsets through PyMemberDef
bpo-15088: The C function
PyGen_NeedsFinalizinghas been removed. It was not documented, tested or used anywhere within CPython after the implementation of PEP 442. Patch by Joannah Nanjekye. (Patch by Joannah Nanjekye)bpo-36763: Options added by
PySys_AddXOption()are now handled the same way thanPyConfig.xoptionsand command line-Xoptions.bpo-37926: Fix a crash in
PySys_SetArgvEx(0, NULL, 0).bpo-37879: Fix subtype_dealloc to suppress the type decref when the base type is a C heap type
bpo-37645: Add
_PyObject_FunctionStr()to get a user-friendly string representation of a function-like object. Patch by Jeroen Demeyer.bpo-29548: The functions
PyEval_CallObject,PyEval_CallFunction,PyEval_CallMethodandPyEval_CallObjectWithKeywordsare deprecated. UsePyObject_Call()and its variants instead.bpo-37151:
PyCFunction_Callis now a deprecated alias ofPyObject_Call().bpo-37540: The vectorcall protocol now requires that the caller passes only strings as keyword names.
bpo-37207: The vectorcall protocol is now enabled for
typeobjects: settp_vectorcallto a vectorcall function to be used instead oftp_newandtp_initwhen calling the class itself.bpo-21120: Exclude Python-ast.h, ast.h and asdl.h from the limited API.
bpo-37483: Add new function
_PyObject_CallOneArgfor calling an object with one positional argument.bpo-36763: Add
PyConfig_SetWideStringList()function.bpo-37337: Add fast functions for calling methods:
_PyObject_VectorcallMethod(),_PyObject_CallMethodNoArgs()and_PyObject_CallMethodOneArg().bpo-28805: The
METH_FASTCALLcalling convention has been documented.bpo-37221: The new function
PyCode_NewWithPosOnlyArgs()allows to create code objects likePyCode_New(), but with an extra posonlyargcount parameter for indicating the number of positonal-only arguments.bpo-37194: Add a new public
PyObject_CallNoArgs()function to the C API: call a callable Python object without any arguments. It is the most efficient way to call a callback without any argument. On x86-64, for example,PyObject_CallFunctionObjArgs(func, NULL)allocates 960 bytes on the stack per call, whereasPyObject_CallNoArgs(func)only allocates 624 bytes per call.bpo-37170: Fix the cast on error in
PyLong_AsUnsignedLongLongMask().bpo-35381: Convert posixmodule.c statically allocated types
DirEntryTypeandScandirIteratorTypeto heap-allocated types.bpo-34331: Use singular/plural noun in error message when instantiating an abstract class with non-overriden abstract method(s).
Python 3.8.0 beta 1¶
Release date: 2019-06-04
Security¶
bpo-35907: CVE-2019-9948: Avoid file reading by disallowing
local-file://andlocal_file://URL schemes inURLopener().open()andURLopener().retrieve()ofurllib.request.bpo-33529: Prevent fold function used in email header encoding from entering infinite loop when there are too many non-ASCII characters in a header.
bpo-33164: Updated blake2 implementation which uses secure memset implementation provided by platform.
Core and Builtins¶
bpo-35814: Allow unpacking in the right hand side of annotated assignments. In particular,
t: Tuple[int, ...] = x, y, *zis now allowed.bpo-37126: All structseq objects are now tracked by the garbage collector. Patch by Pablo Galindo.
bpo-37122: Make the co_argcount attribute of code objects represent the total number of positional arguments (including positional-only arguments). The value of co_posonlyargcount can be used to distinguish which arguments are positional only, and the difference (co_argcount - co_posonlyargcount) is the number of positional-or-keyword arguments. Patch by Pablo Galindo.
bpo-20092: Constructors of
int,floatandcomplexwill now use the__index__()special method, if available and the corresponding method__int__(),__float__()or__complex__()is not available.bpo-37087: Add native thread ID (TID) support to OpenBSD.
bpo-26219: Implemented per opcode cache mechanism and
LOAD_GLOBALinstruction use it.LOAD_GLOBALis now about 40% faster. Contributed by Yury Selivanov, and Inada Naoki.bpo-37072: Fix crash in PyAST_FromNodeObject() when flags is NULL.
bpo-37029: Freeing a great many small objects could take time quadratic in the number of arenas, due to using linear search to keep
obmalloc.c’s list of usable arenas sorted by order of number of free memory pools. This is accomplished without search now, leaving the worst-case time linear in the number of arenas. For programs where this quite visibly matters (typically with more than 100 thousand small objects alive simultaneously), this can greatly reduce the time needed to release their memory.bpo-26423: Fix possible overflow in
wrap_lenfunc()whensizeof(long) < sizeof(Py_ssize_t)(e.g., 64-bit Windows).bpo-37050: Improve the AST for “debug” f-strings, which use ‘=’ to print out the source of the expression being evaluated. Delete expr_text from the FormattedValue node, and instead use a Constant string node (possibly merged with adjacent constant expressions inside the f-string).
bpo-22385: The
bytes.hex,bytearray.hex, andmemoryview.hexmethods as well as thebinascii.hexlifyandb2a_hexfunctions now have the ability to include an optional separator between hex bytes. This functionality was inspired by MicroPython’s hexlify implementation.bpo-26836: Add
os.memfd_create().bpo-37032: Added new
replace()method to the code type (types.CodeType).bpo-37007: Implement
socket.if_nameindex(),socket.if_nametoindex(), andsocket.if_indextoname()on Windows.bpo-36829:
PyErr_WriteUnraisable()now creates a traceback object if there is no current traceback. Moreover, callPyErr_NormalizeException()andPyException_SetTraceback()to normalize the exception value. Ignore any error.bpo-36878: Only accept text after
# type: ignoreif the first character is ASCII. This is to disallow things like# type: ignoreé.bpo-36878: Store text appearing after a
# type: ignorecomment in the AST. For example a type ignore like# type: ignore[E1000]will have the string"[E1000]"stored in its AST node.bpo-2180: Treat line continuation at EOF as a
SyntaxErrorby Anthony Sottile.bpo-36907: Fix a crash when calling a C function with a keyword dict (
f(**kwargs)) and changing the dictkwargswhile that function is running.bpo-36946: Fix possible signed integer overflow when handling slices.
bpo-36826: Add NamedExpression kind support to ast_unparse.c
bpo-1875: A
SyntaxErroris now raised if a code blocks that will be optimized away (e.g. if conditions that are always false) contains syntax errors. Patch by Pablo Galindo.bpo-36027: Allow computation of modular inverses via three-argument
pow: the second argument is now permitted to be negative in the case where the first and third arguments are relatively prime.bpo-36861: Update the Unicode database to version 12.1.0.
bpo-28866: Avoid caching attributes of classes which type defines mro() to avoid a hard cache invalidation problem.
bpo-36851: The
FrameTypestack is now correctly cleaned up if the execution ends with a return and the stack is not empty.bpo-34616: The
compile()builtin functions now support theast.PyCF_ALLOW_TOP_LEVEL_AWAITflag, which allow to compile sources that contains top-levelawait,async withorasync for. This is useful to evaluate async-code from with an already async functions; for example in a custom REPL.bpo-36842: Implement PEP 578, adding sys.audit, io.open_code and related APIs.
bpo-27639: Correct return type for UserList slicing operations. Patch by Michael Blahay, Erick Cervantes, and vaultah
bpo-36737: Move PyRuntimeState.warnings into per-interpreter state (via “module state”).
bpo-36793: Removed
__str__implementations from builtin typesbool,int,float,complexand few classes from the standard library. They now inherit__str__()fromobject.bpo-36817: Add a
=feature f-strings for debugging. This can precede!s,!r, or!a. It produces the text of the expression, followed by an equal sign, followed by the repr of the value of the expression. Sof'{3*9+15=}'would be equal to the string'3*9+15=42'. If=is specified, the default conversion is set to!r, unless a format spec is given, in which case the formatting behavior is unchanged, and __format__ will be used.bpo-24048: Save the live exception during import.c’s
remove_module().bpo-27987: pymalloc returns memory blocks aligned by 16 bytes, instead of 8 bytes, on 64-bit platforms to conform x86-64 ABI. Recent compilers assume this alignment more often. Patch by Inada Naoki.
bpo-36601: A long-since-meaningless check for
getpid() == main_pidwas removed from Python’s internal C signal handler.bpo-36594: Fix incorrect use of
%pin format strings. Patch by Zackery Spytz.bpo-36045: builtins.help() now prefixes
asyncfor async functionsbpo-36084: Add native thread ID (TID) to threading.Thread objects (supported platforms: Windows, FreeBSD, Linux, macOS)
bpo-36035: Added fix for broken symlinks in combination with pathlib
bpo-35983: Added new trashcan macros to deal with a double deallocation that could occur when the
tp_deallocof a subclass calls thetp_deallocof a base class and that base class uses the trashcan mechanism. Patch by Jeroen Demeyer.bpo-20602: Do not clear
sys.flagsandsys.float_infoduring shutdown. Patch by Zackery Spytz.bpo-26826: Expose
copy_file_range()as a low level API in theosmodule.bpo-32388: Remove cross-version binary compatibility requirement in tp_flags.
bpo-31862: Port binascii to PEP 489 multiphase initialization. Patch by Marcel Plch.
Library¶
bpo-37128: Added
math.perm().bpo-37120: Add SSLContext.num_tickets to control the number of TLSv1.3 session tickets.
bpo-12202: Fix the error handling in
msilib.SummaryInformation.GetProperty(). Patch by Zackery Spytz.bpo-26835: The fcntl module now contains file sealing constants for sealing of memfds.
bpo-29262: Add
get_origin()andget_args()introspection helpers totypingmodule.bpo-12639:
msilib.Directory.start_component()no longer fails if keyfile is notNone.bpo-36999: Add the
asyncio.Task.get_coro()method to publicly expose the tasks’s coroutine object.bpo-35246: Make
asyncio.create_subprocess_exec()accept path-like arguments.bpo-35279: Change default max_workers of
ThreadPoolExecutorfromcpu_count() * 5tomin(32, cpu_count() + 4). Previous value was unreasonably large on many cores machines.bpo-37076:
_thread.start_new_thread()now logs uncaught exception raised by the function usingsys.unraisablehook(), rather thansys.excepthook(), so the hook gets access to the function which raised the exception.bpo-33725: On macOS, the
multiprocessingmodule now uses spawn start method by default.bpo-37054: Fix destructor
_pyio.BytesIOand_pyio.TextIOWrapper: initialize their_bufferattribute as soon as possible (in the class body), because it’s used by__del__()which callsclose().bpo-37058: PEP 544: Add
Protocoland@runtime_checkableto thetypingmodule.bpo-36933: The functions
sys.set_coroutine_wrapperandsys.get_coroutine_wrapperthat were deprecated and marked for removal in 3.8 have been removed.bpo-37047: Handle late binding and attribute access in
unittest.mock.AsyncMocksetup for autospeccing. Document newly implemented async methods inunittest.mock.MagicMock.bpo-37049: PEP 589: Add
TypedDictto thetypingmodule.bpo-37046: PEP 586: Add
Literalto thetypingmodule.bpo-37045: PEP 591: Add
Finalqualifier and@finaldecorator to thetypingmodule.bpo-37035: Don’t log OSError based exceptions if a fatal error has occurred in asyncio transport. Peer can generate almost any OSError, user cannot avoid these exceptions by fixing own code. Errors are still propagated to user code, it’s just logging them is pointless and pollute asyncio logs.
bpo-37001:
symtable.symtable()now accepts the same input types for source code as the built-incompile()function. Patch by Dino Viehland.bpo-37028: Implement asyncio REPL
bpo-37027: Return safe to use proxy socket object from transport.get_extra_info(‘socket’)
bpo-32528: Make asyncio.CancelledError a BaseException.
This will address the common mistake many asyncio users make: an “except Exception” clause breaking Tasks cancellation.
In addition to this change, we stop inheriting asyncio.TimeoutError and asyncio.InvalidStateError from their concurrent.futures.* counterparts. There’s no point for these exceptions to share the inheritance chain.
bpo-1230540: Add a new
threading.excepthook()function which handles uncaughtthreading.Thread.run()exception. It can be overridden to control how uncaughtthreading.Thread.run()exceptions are handled.bpo-36996: Handle
unittest.mock.patch()used as a decorator on async functions.bpo-37008: Add support for calling
next()with the mock resulting fromunittest.mock.mock_open()bpo-27737: Allow whitespace only header encoding in
email.header- by Batuhan Taskayabpo-36969: PDB command
argsnow display positional only arguments. Patch contributed by Rémi Lapeyre.bpo-36969: PDB command
argsnow display keyword only arguments. Patch contributed by Rémi Lapeyre.bpo-36983: Add missing names to
typing.__all__:ChainMap,ForwardRef,OrderedDict- by Anthony Sottile.bpo-36972: Add SupportsIndex protocol to the typing module to allow type checking to detect classes that can be passed to
hex(),oct()andbin().bpo-32972: Implement
unittest.IsolatedAsyncioTestCaseto help testing asyncio-based code.bpo-36952:
fileinput.input()andfileinput.FileInputbufsize argument has been removed (was deprecated and ignored since Python 3.6), and as a result the mode and openhook arguments have been made keyword-only.bpo-36952: Starting with Python 3.3, importing ABCs from
collectionsis deprecated, and import should be done fromcollections.abc. Still being able to import fromcollectionswas marked for removal in 3.8, but has been delayed to 3.9; documentation andDeprecationWarningclarified.bpo-36949: Implement __repr__ for WeakSet objects.
bpo-36948: Fix
NameErrorinurllib.request.URLopener.retrieve(). Patch by Karthikeyan Singaravelan.bpo-33524: Fix the folding of email header when the max_line_length is 0 or None and the header contains non-ascii characters. Contributed by Licht Takeuchi (@Licht-T).
bpo-24564:
shutil.copystat()now ignoreserrno.EINVALonos.setxattr()which may occur when copying files on filesystems without extended attributes support.Original patch by Giampaolo Rodola, updated by Ying Wang.
bpo-36888: Python child processes can now access the status of their parent process using multiprocessing.process.parent_process
bpo-36921: Deprecate
@coroutinefor sake ofasync def.bpo-25652: Fix bug in
__rmod__ofUserString- by Batuhan Taskaya.bpo-36916: Remove a message about an unhandled exception in a task when writer.write() is used without await and writer.drain() fails with an exception.
bpo-36889: Introduce
asyncio.Streamclass that mergesasyncio.StreamReaderandasyncio.StreamWriterfunctionality.asyncio.Streamcan work in readonly, writeonly and readwrite modes. Provideasyncio.connect(),asyncio.connect_unix(),asyncio.connect_read_pipe()andasyncio.connect_write_pipe()factories to openasyncio.Streamconnections. Provideasyncio.StreamServerandUnixStreamServerto serve servers with asyncio.Stream API. Modifyasyncio.create_subprocess_shell()andasyncio.create_subprocess_exec()to useasyncio.Streaminstead of deprecatedStreamReaderandStreamWriter. Deprecateasyncio.StreamReaderandasyncio.StreamWriter. Deprecate usage of private classes, e.g.asyncio.FlowControlMixingandasyncio.StreamReaderProtocoloutside of asyncio package.bpo-36845: Added validation of integer prefixes to the construction of IP networks and interfaces in the ipaddress module.
bpo-23378: Add an extend action to argparser.
bpo-36867: Fix a bug making a SharedMemoryManager instance and its parent process use two separate resource_tracker processes.
bpo-23896: Adds a grammar to lib2to3.pygram that contains exec as a function not as statement.
bpo-36895: The function
time.clock()was deprecated in 3.3 in favor oftime.perf_counter()and marked for removal in 3.8, it has removed.bpo-35545: Fix asyncio discarding IPv6 scopes when ensuring hostname resolutions internally
bpo-36887: Add new function
math.isqrt()to compute integer square roots.bpo-34632: Introduce the
importlib.metadatamodule with (provisional) support for reading metadata from third-party packages.bpo-36878: When using
type_comments=Trueinast.parse, treat# type: ignorefollowed by a non-alphanumeric character and then arbitrary text as a type ignore, instead of requiring nothing but whitespace or another comment. This is to permit formations such as# type: ignore[E1000].bpo-36778:
cp65001encoding (Windows code page 65001) becomes an alias toutf_8encoding.bpo-36867: The multiprocessing.resource_tracker replaces the multiprocessing.semaphore_tracker module. Other than semaphores, resource_tracker also tracks shared_memory segments.
bpo-30262: The
CacheandStatementobjects of thesqlite3module are not exposed to the user. Patch by Aviv Palivoda.bpo-24538: In
shutil.copystat(), first copy extended file attributes and then file permissions, since extended attributes can only be set on the destination while it is still writeable.bpo-36829: Add new
sys.unraisablehook()function which can be overridden to control how “unraisable exceptions” are handled. It is called when an exception has occurred but there is no way for Python to handle it. For example, when a destructor raises an exception or during garbage collection (gc.collect()).bpo-36832: Introducing
zipfile.Path, a pathlib-compatible wrapper for traversing zip files.bpo-36814: Fix an issue where os.posix_spawnp() would incorrectly raise a TypeError when file_actions is None.
bpo-33110: Handle exceptions raised by functions added by concurrent.futures add_done_callback correctly when the Future has already completed.
bpo-26903: Limit
max_workersinProcessPoolExecutorto 61 to work around a WaitForMultipleObjects limitation.bpo-36813: Fix
QueueListenerto callqueue.task_done()upon stopping. Patch by Bar Harel.bpo-36806: Forbid creation of asyncio stream objects like StreamReader, StreamWriter, Process, and their protocols outside of asyncio package.
bpo-36802: Provide both sync and async calls for StreamWriter.write() and StreamWriter.close()
bpo-36801: Properly handle SSL connection closing in asyncio StreamWriter.drain() call.
bpo-36785: Implement PEP 574 (pickle protocol 5 with out-of-band buffers).
bpo-36772: functools.lru_cache() can now be used as a straight decorator in addition to its existing usage as a function that returns a decorator.
bpo-6584: Add a
BadGzipFileexception to thegzipmodule.bpo-36748: Optimized write buffering in C implementation of
TextIOWrapper. Writing ASCII string toTextIOWrapperwith ascii, latin1, or utf-8 encoding is about 20% faster. Patch by Inada Naoki.bpo-8138: Don’t mark
wsgiref.simple_server.SimpleServeras multi-threaded sincewsgiref.simple_server.WSGIServeris single-threaded.bpo-22640:
py_compile.compile()now supports silent mode. Patch by Joannah Nanjekyebpo-29183: Fix double exceptions in
wsgiref.handlers.BaseHandlerby calling itsclose()method only when no exception is raised.bpo-36548: Improved the repr of regular expression flags.
bpo-36542: The signature of Python functions can now be overridden by specifying the
__text_signature__attribute.bpo-36533: Reinitialize logging.Handler locks in forked child processes instead of attempting to acquire them all in the parent before forking only to be released in the child process. The acquire/release pattern was leading to deadlocks in code that has implemented any form of chained logging handlers that depend upon one another as the lock acquisition order cannot be guaranteed.
bpo-35252: Throw a TypeError instead of an AssertionError when using an invalid type annotation with singledispatch.
bpo-35900: Allow reduction methods to return a 6-item tuple where the 6th item specifies a custom state-setting method that’s called instead of the regular
__setstate__method.bpo-35900: enable custom reduction callback registration for functions and classes in _pickle.c, using the new Pickler’s attribute
reducer_overridebpo-36368: Fix a bug crashing SharedMemoryManager instances in interactive sessions after a ctrl-c (KeyboardInterrupt) was sent
bpo-31904: Fix mmap fail for VxWorks
bpo-27497:
csv.DictWriter.writeheader()now returns the return value of the underlyingcsv.Writer.writerow()method. Patch contributed by Ashish Nitin Patil.bpo-36239: Parsing .mo files now ignores comments starting and ending with #-#-#-#-#.
bpo-26707: Enable plistlib to read and write binary plist files that were created as a KeyedArchive file. Specifically, this allows the plistlib to process 0x80 tokens as UID objects.
bpo-31904: Add posix module support for VxWorks.
bpo-35125: Asyncio: Remove inner callback on outer cancellation in shield
bpo-35721: Fix
asyncio.SelectorEventLoop.subprocess_exec()leaks file descriptors ifPopenfails and called withstdin=subprocess.PIPE. Patch by Niklas Fiekas.bpo-31855:
unittest.mock.mock_open()results now respects the argument of read([size]). Patch contributed by Rémi Lapeyre.bpo-35431: Implement
math.comb()that returns binomial coefficient, that computes the number of ways to choose k items from n items without repetition and without order. Patch by Yash Aggarwal and Keller Fuchs.bpo-26660: Fixed permission errors in
TemporaryDirectoryclean up. PreviouslyTemporaryDirectory.cleanup()failed when non-writeable or non-searchable files or directories were created inside a temporary directory.bpo-34271: Add debugging helpers to ssl module. It’s now possible to dump key material and to trace TLS protocol. The default and stdlib contexts also support SSLKEYLOGFILE env var.
bpo-26467: Added AsyncMock to support using unittest to mock asyncio coroutines. Patch by Lisa Roach.
bpo-33569: dataclasses.InitVar: Exposes the type used to create the init var.
bpo-34424: Fix serialization of messages containing encoded strings when the policy.linesep is set to a multi-character string. Patch by Jens Troeger.
bpo-34303: Performance of
functools.reduce()is slightly improved. Patch by Sergey Fedoseev.bpo-33361: Fix a bug in
codecs.StreamRecoderwhere seeking might leave old data in a buffer and break subsequent read calls. Patch by Ammar Askar.bpo-22454: The
shlexmodule now exposesshlex.join(), the inverse ofshlex.split(). Patch by Bo Bayles.bpo-31922:
asyncio.AbstractEventLoop.create_datagram_endpoint(): Do not connect UDP socket when broadcast is allowed. This allows to receive replies after a UDP broadcast.bpo-24882: Change ThreadPoolExecutor to use existing idle threads before spinning up new ones.
bpo-31961: Added support for bytes and path-like objects in
subprocess.Popen()on Windows. The args parameter now accepts a path-like object if shell isFalseand a sequence containing bytes and path-like objects. The executable parameter now accepts a bytes and path-like object. The cwd parameter now accepts a bytes object. Based on patch by Anders Lorentsen.bpo-33123:
pathlib.Path.unlinknow accepts a missing_ok parameter to avoid aFileNotFoundErrorfrom being raised. Patch by Robert Buchholz.bpo-32941: Allow
mmap.mmapobjects to access the madvise() system call (throughmmap.mmap.madvise()).bpo-22102: Added support for ZIP files with disks set to 0. Such files are commonly created by builtin tools on Windows when use ZIP64 extension. Patch by Francisco Facioni.
bpo-32515: trace.py can now run modules via python3 -m trace -t –module module_name
bpo-32299: Changed
unittest.mock.patch.dict()to return the patched dictionary when used as context manager. Patch by Vadim Tsander.bpo-27141: Added a
__copy__()tocollections.UserListandcollections.UserDictin order to correctly implement shallow copying of the objects. Patch by Bar Harel.bpo-31829:
\r,\0and\x1a(end-of-file on Windows) are now escaped in protocol 0 pickles of Unicode strings. This allows to load them without loss from files open in text mode in Python 2.bpo-23395:
_thread.interrupt_main()now avoids setting the Python error status if theSIGINTsignal is ignored or not handled by Python.
Documentation¶
bpo-36896: Clarify that some types have unstable constructor signature between Python versions.
bpo-36686: Improve documentation of the stdin, stdout, and stderr arguments of the
asyncio.subprocess_execfunction to specify which values are supported. Also mention that decoding as text is not supported.Add a few tests to verify that the various values passed to the std* arguments actually work.
bpo-36984: Improve version added references in
typingmodule - by Anthony Sottile.bpo-36868: What’s new now mentions SSLContext.hostname_checks_common_name instead of SSLContext.host_flags.
bpo-35924: Add a note to the
curses.addstr()documentation to warn that multiline strings can cause segfaults because of an ncurses bug.bpo-36783: Added C API Documentation for Time_FromTimeAndFold and PyDateTime_FromDateAndTimeAndFold as per PEP 495. Patch by Edison Abahurire.
bpo-36797: More of the legacy distutils documentation has been either pruned, or else more clearly marked as being retained solely until the setuptools documentation covers it independently.
bpo-22865: Add detail to the documentation on the
pty.spawnfunction.bpo-35397: Remove deprecation and document urllib.parse.unwrap(). Patch contributed by Rémi Lapeyre.
bpo-32995: Added the context variable in glossary.
bpo-33519: Clarify that
copy()is not part of theMutableSequenceABC.bpo-33482: Make
codecs.StreamRecoder.writelinestake a list of bytes.bpo-25735: Added documentation for func factorial to indicate that returns integer values
bpo-20285: Expand object.__doc__ (docstring) to make it clearer. Modify pydoc.py so that help(object) lists object methods (for other classes, help omits methods of the object base class.)
Tests¶
bpo-37069: Modify test_coroutines, test_cprofile, test_generators, test_raise, test_ssl and test_yield_from to use
test.support.catch_unraisable_exception()rather thantest.support.captured_stderr().bpo-37098: Fix test_memfd_create on older Linux Kernels.
bpo-37081: Test with OpenSSL 1.1.1c
bpo-36829: Add
test.support.catch_unraisable_exception(): context manager catching unraisable exception usingsys.unraisablehook().bpo-36915: The main regrtest process now always removes all temporary directories of worker processes even if they crash or if they are killed on KeyboardInterrupt (CTRL+c).
bpo-36719: “python3 -m test -jN …” now continues the execution of next tests when a worker process crash (CHILD_ERROR state). Previously, the test suite stopped immediately. Use –failfast to stop at the first error.
bpo-36816: Update Lib/test/selfsigned_pythontestdotnet.pem to match self-signed.pythontest.net’s new TLS certificate.
bpo-35925: Skip httplib and nntplib networking tests when they would otherwise fail due to a modern OS or distro with a default OpenSSL policy of rejecting connections to servers with weak certificates.
bpo-36782: Add tests for several C API functions in the
datetimemodule. Patch by Edison Abahurire.bpo-36342: Fix test_multiprocessing in test_venv if platform lacks functioning sem_open.
Build¶
bpo-36721: To embed Python into an application, a new
--embedoption must be passed topython3-config --libs --embedto get-lpython3.8(link the application to libpython). To support both 3.8 and older, trypython3-config --libs --embedfirst and fallback topython3-config --libs(without--embed) if the previous command fails.Add a pkg-config
python-3.8-embedmodule to embed Python into an application:pkg-config python-3.8-embed --libsincludes-lpython3.8. To support both 3.8 and older, trypkg-config python-X.Y-embed --libsfirst and fallback topkg-config python-X.Y --libs(without--embed) if the previous command fails (replaceX.Ywith the Python version).On the other hand,
pkg-config python3.8 --libsno longer contains-lpython3.8. C extensions must not be linked to libpython (except on Android, case handled by the script); this change is backward incompatible on purpose.bpo-36786: “make install” now runs compileall in parallel.
Windows¶
bpo-36965: include of STATUS_CONTROL_C_EXIT without depending on MSC compiler
bpo-35926: Update to OpenSSL 1.1.1b for Windows.
bpo-29883: Add Windows support for UDP transports for the Proactor Event Loop. Patch by Adam Meily.
bpo-33407: The
Py_DEPRECATED()macro has been implemented for MSVC.
macOS¶
bpo-36231: Support building Python on macOS without /usr/include installed. As of macOS 10.14, system header files are only available within an SDK provided by either the Command Line Tools or the Xcode app.
IDLE¶
bpo-35610: Replace now redundant .context_use_ps1 with .prompt_last_line. This finishes change started in bpo-31858.
bpo-37038: Make idlelib.run runnable; add test clause.
bpo-36958: Print any argument other than None or int passed to SystemExit or sys.exit().
bpo-36807: When saving a file, call os.fsync() so bits are flushed to e.g. USB drive.
bpo-32411: In browser.py, remove extraneous sorting by line number since dictionary was created in line number order.
Tools/Demos¶
bpo-37053: Handle strings like u”bar” correctly in Tools/parser/unparse.py. Patch by Chih-Hsuan Yen.
C API¶
bpo-36763: Implement the PEP 587 “Python Initialization Configuration”.
bpo-36379: Fix crashes when attempting to use the modulo parameter when
__ipow__is implemented in C.bpo-37107: Update
PyObject_CallMethodObjArgs()and_PyObject_CallMethodIdObjArgsto use_PyObject_GetMethodto avoid creating a bound method object in many cases. Patch by Michael J. Sullivan.bpo-36974: Implement PEP 590: Vectorcall: a fast calling protocol for CPython. This is a new protocol to optimize calls of custom callable objects.
bpo-36763:
Py_Main()now returns the exitcode rather than callingPy_Exit(exitcode)when callingPyErr_Print()if the current exception type isSystemExit.bpo-36922: Add new type flag
Py_TPFLAGS_METHOD_DESCRIPTORfor objects behaving like unbound methods. These are objects supporting the optimization given by theLOAD_METHOD/CALL_METHODopcodes. See PEP 590.bpo-36728: The
PyEval_ReInitThreads()function has been removed from the C API. It should not be called explicitly: usePyOS_AfterFork_Child()instead.
Python 3.8.0 alpha 4¶
Release date: 2019-05-06
Security¶
bpo-36742: Fixes mishandling of pre-normalization characters in urlsplit().
bpo-30458: Address CVE-2019-9740 by disallowing URL paths with embedded whitespace or control characters through into the underlying http client request. Such potentially malicious header injection URLs now cause an http.client.InvalidURL exception to be raised.
bpo-35755:
shutil.which()now usesos.confstr("CS_PATH")if available and if thePATHenvironment variable is not set. Remove also the current directory fromposixpath.defpath. On Unix,shutil.which()and thesubprocessmodule no longer search the executable in the current directory if thePATHenvironment variable is not set.
Core and Builtins¶
bpo-36722: In debug build, import now also looks for C extensions compiled in release mode and for C extensions compiled in the stable ABI.
bpo-32849: Fix Python Initialization code on FreeBSD to detect properly when stdin file descriptor (fd 0) is invalid.
bpo-36623: Remove parser headers and related function declarations that lack implementations after the removal of pgen.
bpo-20180:
dict.pop()is now up to 33% faster thanks to Argument Clinic. Patch by Inada Naoki.bpo-36611: Debug memory allocators: disable serialno field by default from debug hooks on Python memory allocators to reduce the memory footprint by 5%. Enable
tracemallocto get the traceback where a memory block has been allocated when a fatal memory error is logged to decide where to put a breakpoint. Compile Python withPYMEM_DEBUG_SERIALNOdefined to get back the field.bpo-36588: On AIX,
sys.platformdoesn’t contain the major version anymore. Always return'aix', instead of'aix3'..'aix7'. Since older Python versions include the version number, it is recommended to always usesys.platform.startswith('aix'). Contributed by M. Felt.bpo-36549: Change str.capitalize to use titlecase for the first character instead of uppercase.
bpo-36540: Implement PEP 570 (Python positional-only parameters). Patch by Pablo Galindo.
bpo-36475:
PyEval_AcquireLock()andPyEval_AcquireThread()now terminate the current thread if called while the interpreter is finalizing, making them consistent withPyEval_RestoreThread(),Py_END_ALLOW_THREADS(), andPyGILState_Ensure().bpo-36504: Fix signed integer overflow in _ctypes.c’s
PyCArrayType_new().bpo-20844: Fix running script with encoding cookie and LF line ending may fail on Windows.
bpo-24214: Fixed support of the surrogatepass error handler in the UTF-8 incremental decoder.
bpo-36452: Changing
dictkeys during iteration of the dict itself,keys(),values(), oritems()will now be detected in certain corner cases where keys are deleted/added so that the number of keys isn’t changed. ARuntimeErrorwill be raised afterlen(dict)iterations. Contributed by Thomas Perl.bpo-36459: Fix a possible double
PyMem_FREE()due to tokenizer.c’stok_nextc().bpo-36433: Fixed TypeError message in classmethoddescr_call.
bpo-36430: Fix a possible reference leak in
itertools.count().bpo-36440: Include node names in
ParserErrormessages, instead of numeric IDs. Patch by A. Skrobov.bpo-36143: Regenerate
keywordfrom the Grammar and Tokens file using pgen. Patch by Pablo Galindo.bpo-18372: Add missing
PyObject_GC_Track()calls in thepicklemodule. Patch by Zackery Spytz.
Library¶
bpo-35952: Fix pythoninfo when the compiler is missing.
bpo-28238: The
.find*()methods of xml.etree.ElementTree can now search for wildcards like{*}tagand{ns}*that match a tag in any namespace or all tags in a namespace. Patch by Stefan Behnel.bpo-26978:
pathlib.path.link_to()is now implemented. It creates a hard link pointing to a path.bpo-1613500:
fileinput.FileInputnow uses the input file mode to correctly set the output file mode (previously it was hardcoded to'w') wheninplace=Trueis passed to its constructor.bpo-36734: Fix compilation of
faulthandler.con HP-UX. Initializestack_t current_stackto zero usingmemset().bpo-13611: The xml.etree.ElementTree packages gained support for C14N 2.0 serialisation. Patch by Stefan Behnel.
bpo-36669: Add missing matrix multiplication operator support to weakref.proxy.
bpo-36676: The XMLParser() in xml.etree.ElementTree provides namespace prefix context to the parser target if it defines the callback methods “start_ns()” and/or “end_ns()”. Patch by Stefan Behnel.
bpo-36673: The TreeBuilder and XMLPullParser in xml.etree.ElementTree gained support for parsing comments and processing instructions. Patch by Stefan Behnel.
bpo-36650: The C version of functools.lru_cache() was treating calls with an empty
**kwargsdictionary as being distinct from calls with no keywords at all. This did not result in an incorrect answer, but it did trigger an unexpected cache miss.bpo-28552: Fix
distutils.sysconfigifsys.executableisNoneor an empty string: useos.getcwd()to initializeproject_base. Fix also the distutils build command: don’t usesys.executableif it isNoneor an empty string.bpo-35755:
shutil.which()anddistutils.spawn.find_executable()now useos.confstr("CS_PATH")if available instead ofos.defpath, if thePATHenvironment variable is not set. Moreover, don’t useos.confstr("CS_PATH")noros.defpathif thePATHenvironment variable is set to an empty string.bpo-25430: improve performance of
IPNetwork.__contains__()bpo-30485: Path expressions in xml.etree.ElementTree can now avoid explicit namespace prefixes for tags (or the “{namespace}tag” notation) by passing a default namespace with an empty string prefix.
bpo-36613: Fix
asynciowait() not removing callback if exceptionbpo-36598: Fix
isinstancecheck for Mock objects with spec when the code is executed under tracing. Patch by Karthikeyan Singaravelan.bpo-18748: In development mode (
-Xdev) and in debug build, theio.IOBasedestructor now logsclose()exceptions. These exceptions are silent by default in release mode.bpo-36575: The
_lsprofmodule now uses internal timer same totime.perf_counter()by default.gettimeofday(2)was used on Unix. New timer has better resolution on most Unix platforms and timings are no longer impacted by system clock updates sinceperf_counter()is monotonic. Patch by Inada Naoki.bpo-33461:
json.loadsnow emitsDeprecationWarningwhenencodingoption is specified. Patch by Matthias Bussonnier.bpo-36559: The random module now prefers the lean internal _sha512 module over hashlib for seed(version=2) to optimize import time.
bpo-17561: Set backlog=None as the default for socket.create_server.
bpo-34373: Fix
time.mktime()error handling on AIX for year before 1970.bpo-36232: Improve error message when trying to open existing DBM database that actually doesn’t exist. Patch by Marco Rougeth.
bpo-36546: Add statistics.quantiles()
bpo-36050: Optimized
http.client.HTTPResponse.read()for large response. Patch by Inada Naoki.bpo-36522: If debuglevel is set to >0 in
http.client, print all values for headers with multiple values for the same header name. Patch by Matt Houglum.bpo-36492: Deprecated passing required arguments like func as keyword arguments in functions which should accept arbitrary keyword arguments and pass them to other function. Arbitrary keyword arguments (even with names “self” and “func”) can now be passed to these functions if the required arguments are passed as positional arguments.
bpo-27181: Add statistics.geometric_mean().
bpo-30427:
os.path.normcase()relies onos.fspath()to check the type of its argument. Redundant checks have been removed from itsposixpath.normcase()andntpath.normcase()implementations. Patch by Wolfgang Maier.bpo-36385: Stop rejecting IPv4 octets for being ambiguously octal. Leading zeros are ignored, and no longer are assumed to specify octal octets. Octets are always decimal numbers. Octets must still be no more than three digits, including leading zeroes.
bpo-36434: Errors during writing to a ZIP file no longer prevent to properly close it.
bpo-36407: Fixed wrong indentation writing for CDATA section in xml.dom.minidom. Patch by Vladimir Surjaninov.
bpo-36326: inspect.getdoc() can now find docstrings for member objects when __slots__ is a dictionary.
bpo-36366: Calling
stop()on an unstarted or stoppedunittest.mock.patch()object will now returnNoneinstead of raisingRuntimeError, making the method idempotent. Patch by Karthikeyan Singaravelan.bpo-36348: The
imap.IMAP4.logout()method no longer ignores silently arbitrary exceptions.bpo-31904: Add time module support and fix test_time faiures for VxWorks.
bpo-36227: Added support for keyword arguments
default_namespaceandxml_declarationin functions ElementTree.tostring() and ElementTree.tostringlist().bpo-36004: Added new alternate constructors
datetime.date.fromisocalendar()anddatetime.datetime.fromisocalendar(), which construct date objects from ISO year, week number and weekday; these are the inverse of each class’sisocalendarmethod. Patch by Paul Ganssle.bpo-35936:
modulefinderno longer depends on the deprecatedimpmodule, and the initializer formodulefinder.ModuleFindernow has immutable default arguments. Patch by Brandt Bucher.bpo-35376:
modulefindercorrectly handles modules that have the same name as a bad package. Patch by Brandt Bucher.bpo-17396:
modulefinderno longer crashes when encountering syntax errors in followed imports. Patch by Brandt Bucher.bpo-35934: Added
create_server()andhas_dualstack_ipv6()convenience functions to automate the necessary tasks usually involved when creating a server socket, including accepting both IPv4 and IPv6 connections on the same socket. (Contributed by Giampaolo Rodola in bpo-17561.)bpo-23078: Add support for
classmethod()andstaticmethod()tounittest.mock.create_autospec(). Initial patch by Felipe Ochoa.bpo-35416: Fix potential resource warnings in distutils. Patch by Mickaël Schoentgen.
bpo-25451: Add transparency methods to
tkinter.PhotoImage. Patch by Zackery Spytz.bpo-35082: Don’t return deleted attributes when calling dir on a
unittest.mock.Mock.bpo-34547:
wsgiref.handlers.BaseHandlernow handles abrupt client connection terminations gracefully. Patch by Petter Strandmark.bpo-31658:
xml.sax.parse()now supports path-like. Patch by Mickaël Schoentgen.bpo-34139: Remove stale unix datagram socket before binding
bpo-33530: Implemented Happy Eyeballs in
asyncio.create_connection(). Added two new arguments, happy_eyeballs_delay and interleave, to specify Happy Eyeballs behavior.bpo-33291: Do not raise AttributeError when calling the inspect functions isgeneratorfunction, iscoroutinefunction, isasyncgenfunction on a method created from an arbitrary callable. Instead, return False.
bpo-31310: Fix the multiprocessing.semaphore_tracker so it is reused by child processes
bpo-31292: Fix
setup.py check --restructuredtextfor files containingincludedirectives.
Documentation¶
bpo-36625: Remove obsolete comments from docstrings in fractions.Fraction
bpo-30840: Document relative imports
bpo-36523: Add docstring for io.IOBase.writelines().
bpo-36425: New documentation translation: Simplified Chinese.
bpo-36345: Avoid the duplication of code from
Tools/scripts/serve.pyin using theliteralincludedirective for the basic wsgiref-based web server in the documentation ofwsgiref. Contributed by Stéphane Wirtel.bpo-36345: Using the code of the
Tools/scripts/serve.pyscript as an example in thewsgirefdocumentation. Contributed by Stéphane Wirtel.bpo-36157: Added Documention for PyInterpreterState_Main().
bpo-33043: Updates the docs.python.org page with the addition of a ‘Contributing to Docs’ link at the end of the page (between ‘Reporting Bugs’ and ‘About Documentation’). Updates the ‘Found a Bug’ page with additional links and information in the Documentation Bugs section.
bpo-35581: @typing.type_check_only now allows type stubs to mark functions and classes not available during runtime.
bpo-33832: Add glossary entry for ‘magic method’.
bpo-32913: Added re.Match.groupdict example to regex HOWTO.
Tests¶
bpo-36719: regrtest now always detects uncollectable objects. Previously, the check was only enabled by
--findleaks. The check now also works with-jN/--multiprocess N.--findleaksbecomes a deprecated alias to--fail-env-changed.bpo-36725: When using multiprocessing mode (-jN), regrtest now better reports errors if a worker process fails, and it exits immediately on a worker thread failure or when interrupted.
bpo-36454: Change test_time.test_monotonic() to test only the lower bound of elapsed time after a sleep command rather than the upper bound. This prevents unnecessary test failures on slow buildbots. Patch by Victor Stinner.
bpo-32424: Improve test coverage for xml.etree.ElementTree. Patch by Gordon P. Hemsley.
bpo-32424: Fix typo in test_cyclic_gc() test for xml.etree.ElementTree. Patch by Gordon P. Hemsley.
bpo-36635: Add a new
_testinternalcapimodule to test the internal C API.bpo-36629: Fix
test_imap4_host_default_value()oftest_imaplib: catch alsoerrno.ENETUNREACHerror.bpo-36611: Fix
test_sys.test_getallocatedblocks()whentracemallocis enabled.bpo-36560: Fix reference leak hunting in regrtest: compute also deltas (of reference count, allocated memory blocks, file descriptor count) during warmup, to ensure that everything is initialized before starting to hunt reference leaks.
bpo-36565: Fix reference hunting (
python3 -m test -R 3:3) when Python has no built-in abc module.bpo-31904: Port test_resource to VxWorks: skip tests cases setting RLIMIT_FSIZE and RLIMIT_CPU.
bpo-31904: Fix test_tabnanny on VxWorks: adjust ENOENT error message.
bpo-36436: Fix
_testcapi.pymem_buffer_overflow(): handle memory allocation failure.bpo-31904: Fix test_utf8_mode on VxWorks: Python always use UTF-8 on VxWorks.
bpo-36341: Fix tests that may fail with PermissionError upon calling bind() on AF_UNIX sockets.
Build¶
bpo-36747: Remove the stale scriptsinstall Makefile target.
bpo-21536: On Unix, C extensions are no longer linked to libpython except on Android and Cygwin.
It is now possible for a statically linked Python to load a C extension built using a shared library Python.
When Python is embedded,
libpythonmust not be loaded withRTLD_LOCAL, butRTLD_GLOBALinstead. Previously, usingRTLD_LOCAL, it was already not possible to load C extensions which were not linked tolibpython, such as C extensions of the standard library built by the*shared*section ofModules/Setup.distutils, python-config and python-config.py have been modified.
bpo-36707:
./configure --with-pymallocno longer adds themflag to SOABI (sys.implementation.cache_tag). Enabling or disabling pymalloc has no impact on the ABI.bpo-36635: Change
PyAPI_FUNC(type),PyAPI_DATA(type)andPyMODINIT_FUNCmacros ofpyport.hwhenPy_BUILD_CORE_MODULEis defined. ThePy_BUILD_CORE_MODULEdefine must be now be used to build a C extension as a dynamic library accessing Python internals: export the PyInit_xxx() function in DLL exports on Windows.bpo-31904: Don’t build the
_cryptextension on VxWorks.bpo-36618: Add
-fmax-type-align=8to CFLAGS when clang compiler is detected. The pymalloc memory allocator aligns memory on 8 bytes. On x86-64, clang expects alignment on 16 bytes by default and so uses MOVAPS instruction which can lead to segmentation fault. Instruct clang that Python is limited to alignment on 8 bytes to use MOVUPS instruction instead: slower but don’t trigger a SIGSEGV if the memory is not aligned on 16 bytes. Sadly, the flag must be added toCFLAGSand not justCFLAGS_NODIST, since third party C extensions can have the same issue.bpo-36605:
make tagsandmake TAGSnow also parseModules/_io/*.candModules/_io/*.h.bpo-36465: Release builds and debug builds are now ABI compatible: defining the
Py_DEBUGmacro no longer implies thePy_TRACE_REFSmacro, which introduces the only ABI incompatibility. ThePy_TRACE_REFSmacro, which adds thesys.getobjects()function and thePYTHONDUMPREFSenvironment variable, can be set using the new./configure --with-trace-refsbuild option.bpo-36577: setup.py now correctly reports missing OpenSSL headers and libraries again.
bpo-36544: Fix regression introduced in bpo-36146 refactoring setup.py
bpo-36508:
python-config --ldflagsno longer includes flags of theLINKFORSHAREDvariable. TheLINKFORSHAREDvariable must only be used to build executables.bpo-36503: Remove references to “aix3” and “aix4”. Patch by M. Felt.
Windows¶
bpo-35920: Added platform.win32_edition() and platform.win32_is_iot(). Added support for cross-compiling packages for Windows ARM32. Skip tests that are not expected to work on Windows IoT Core ARM32.
bpo-36649: Remove trailing spaces for registry keys when installed via the Store.
bpo-34144: Fixed activate.bat to correctly update codepage when chcp.com returns dots in output. Patch by Lorenz Mende.
bpo-36509: Added preset-iot layout for Windows IoT ARM containers. This layout doesn’t contain UI components like tkinter or IDLE. It also doesn’t contain files to support on-target builds since Windows ARM32 builds must be cross-compiled when using MSVC.
bpo-35941: enum_certificates function of the ssl module now returns certificates from all available certificate stores inside windows in a query instead of returning only certificates from the system wide certificate store. This includes certificates from these certificate stores: local machine, local machine enterprise, local machine group policy, current user, current user group policy, services, users. ssl.enum_crls() function is changed in the same way to return all certificate revocation lists inside the windows certificate revocation list stores.
bpo-36441: Fixes creating a venv when debug binaries are installed.
bpo-36085: Enable better DLL resolution on Windows by using safe DLL search paths and adding
os.add_dll_directory().bpo-36010: Add the venv standard library module to the nuget distribution for Windows.
bpo-29515: Add the following socket module constants on Windows: IPPROTO_AH IPPROTO_CBT IPPROTO_DSTOPTS IPPROTO_EGP IPPROTO_ESP IPPROTO_FRAGMENT IPPROTO_GGP IPPROTO_HOPOPTS IPPROTO_ICLFXBM IPPROTO_ICMPV6 IPPROTO_IDP IPPROTO_IGMP IPPROTO_IGP IPPROTO_IPV4 IPPROTO_IPV6 IPPROTO_L2TP IPPROTO_MAX IPPROTO_ND IPPROTO_NONE IPPROTO_PGM IPPROTO_PIM IPPROTO_PUP IPPROTO_RDP IPPROTO_ROUTING IPPROTO_SCTP IPPROTO_ST
bpo-35947: Added current version of libffi to cpython-source-deps. Change _ctypes to use current version of libffi on Windows.
bpo-34060: Report system load when running test suite on Windows. Patch by Ammar Askar. Based on prior work by Jeremy Kloth.
bpo-31512: With the Windows 10 Creators Update, non-elevated users can now create symlinks as long as the computer has Developer Mode enabled.
macOS¶
IDLE¶
bpo-36429: Fix starting IDLE with pyshell. Add idlelib.pyshell alias at top; remove pyshell alias at bottom. Remove obsolete __name__==’__main__’ command.
Tools/Demos¶
bpo-14546: Fix the argument handling in Tools/scripts/lll.py.
C API¶
bpo-36763: Fix memory leak in
Py_SetStandardStreamEncoding(): release memory if the function is called twice.bpo-36641:
PyDoc_VAR(name)andPyDoc_STRVAR(name, str)now createstatic const char name[]instead ofstatic char name[]. Patch by Inada Naoki.bpo-36389: Change the value of
CLEANBYTE,DEADDYTEandFORBIDDENBYTEinternal constants used by debug hooks on Python memory allocators (PyMem_SetupDebugHooks()function). Byte patterns0xCB,0xDBand0xFBhave been replaced with0xCD,0xDDand0xFDto use the same values than Windows CRT debugmalloc()andfree().bpo-36443: Since Python 3.7.0, calling
Py_DecodeLocale()beforePy_Initialize()produces mojibake if theLC_CTYPElocale is coerced and/or if the UTF-8 Mode is enabled by the user configuration. The LC_CTYPE coercion and UTF-8 Mode are now disabled by default to fix the mojibake issue. They must now be enabled explicitly (opt-in) using the new_Py_PreInitialize()API with_PyPreConfig.bpo-36025: Fixed an accidental change to the datetime C API where the arguments to the
PyDate_FromTimestamp()function were incorrectly interpreted as a single timestamp rather than an arguments tuple, which causes existing code to start raisingTypeError. The backwards-incompatible change was only present in alpha releases of Python 3.8. Patch by Paul Ganssle.bpo-35810: Modify
PyObject_Initto correctly increase the refcount of heap- allocated Type objects. Also fix the refcounts of the heap-allocated types that were either doing this manually or not decreasing the type’s refcount in tp_dealloc
Python 3.8.0 alpha 3¶
Release date: 2019-03-25
Security¶
bpo-36216: Changes urlsplit() to raise ValueError when the URL contains characters that decompose under IDNA encoding (NFKC-normalization) into characters that affect how the URL is parsed.
bpo-35121: Don’t send cookies of domain A without Domain attribute to domain B when domain A is a suffix match of domain B while using a cookiejar with
http.cookiejar.DefaultCookiePolicypolicy. Patch by Karthikeyan Singaravelan.
Core and Builtins¶
bpo-36421: Fix a possible double decref in _ctypes.c’s
PyCArrayType_new().bpo-36412: Fix a possible crash when creating a new dictionary.
bpo-36398: Fix a possible crash in
structseq_repr().bpo-36256: Fix bug in parsermodule when parsing a state in a DFA that has two or more arcs with labels of the same type. Patch by Pablo Galindo.
bpo-36365: repr(structseq) is no longer limited to 512 bytes.
bpo-36374: Fix a possible null pointer dereference in
merge_consts_recursive(). Patch by Zackery Spytz.bpo-36236: At Python initialization, the current directory is no longer prepended to
sys.pathif it has been removed.bpo-36352: Python initialization now fails with an error, rather than silently truncating paths, if a path is too long.
bpo-36301: Python initialization now fails if decoding
pybuilddir.txtconfiguration file fails at startup.bpo-36333: Fix leak in _PyRuntimeState_Fini. Contributed by Stéphane Wirtel.
bpo-36332: The builtin
compile()can now handle AST objects that contain assignment expressions. Patch by Pablo Galindo.bpo-36282: Improved error message for too much positional arguments in some builtin functions.
bpo-30040: New empty dict uses fewer memory for now. It used more memory than empty dict created by
dict.clear(). And empty dict creation and deletion is about 2x faster. Patch by Inada Naoki.bpo-36262: Fix an unlikely memory leak on conversion from string to float in the function
_Py_dg_strtod()used byfloat(str),complex(str),pickle.load(),marshal.load(), etc.bpo-36252: Update Unicode databases to version 12.0.0.
bpo-36218: Fix a segfault occurring when sorting a list of heterogeneous values. Patch contributed by Rémi Lapeyre and Elliot Gorokhovsky.
bpo-36188: Cleaned up left-over vestiges of Python 2 unbound method handling in method objects and documentation. Patch by Martijn Pieters
bpo-36124: Add a new interpreter-specific dict and expose it in the C-API via PyInterpreterState_GetDict(). This parallels PyThreadState_GetDict(). However, extension modules should continue using PyModule_GetState() for their own internal per-interpreter state.
bpo-35975: Add a
feature_versionflag toast.parse()(documented) andcompile()(hidden) that allows tweaking the parser to support older versions of the grammar. In particular, iffeature_versionis 5 or 6, the hacks for theasyncandawaitkeyword from PEP 492 are reinstated. (For 7 or higher, these are unconditionally treated as keywords, but they are still special tokens rather thanNAMEtokens that the parser driver recognizes.)bpo-31904: Use UTF-8 as the system encoding on VxWorks.
bpo-36048: The
__index__()special method will be used instead of__int__()for implicit conversion of Python numbers to C integers. Using the__int__()method in implicit conversions has been deprecated.bpo-35808: Retire pgen and use a modified version of pgen2 to generate the parser. Patch by Pablo Galindo.
Library¶
bpo-36401: The class documentation created by pydoc now has a separate section for readonly properties.
bpo-36320: The typing.NamedTuple() class has deprecated the _field_types attribute in favor of the __annotations__ attribute which carried the same information. Also, both attributes were converted from OrderedDict to a regular dict.
bpo-34745: Fix
asynciossl memory issues caused by circular referencesbpo-36324: Add method to statistics.NormalDist for computing the inverse cumulative normal distribution.
bpo-36321: collections.namedtuple() misspelled the name of an attribute. To be consistent with typing.NamedTuple, the attribute name should have been “_field_defaults” instead of “_fields_defaults”. For backwards compatibility, both spellings are now created. The misspelled version may be removed in the future.
bpo-36297: “unicode_internal” codec is removed. It was deprecated since Python 3.3. Patch by Inada Naoki.
bpo-36298: Raise ModuleNotFoundError in pyclbr when a module can’t be found. Thanks to ‘mental’ for the bug report.
bpo-36268: Switch the default format used for writing tars with mod:
tarfileto the modern POSIX.1-2001 pax standard, from the vendor-specific GNU. Contributed by C.A.M. Gerlach.bpo-36285: Fix integer overflows in the array module. Patch by Stephan Hohe.
bpo-31904: Add _signal module support for VxWorks.
bpo-36272:
loggingdoes not silently ignore RecursionError anymore. Patch contributed by Rémi Lapeyre.bpo-36280: Add a kind field to ast.Constant. It is ‘u’ if the literal has a ‘u’ prefix (i.e. a Python 2 style unicode literal), else None.
bpo-35931: The
pdbdebugcommand now gracefully handles all exceptions.bpo-36251: Fix format strings used for stderrprinter and re.Match reprs. Patch by Stephan Hohe.
bpo-36235: Fix
CFLAGSincustomize_compiler()ofdistutils.sysconfig: when theCFLAGSenvironment variable is defined, don’t overrideCFLAGSvariable with theOPTvariable anymore. Initial patch written by David Malcolm.bpo-35807: Update ensurepip to install pip 19.0.3 and setuptools 40.8.0.
bpo-36179: Fix two unlikely reference leaks in _hashopenssl. The leaks only occur in out-of-memory cases.
bpo-36169: Add overlap() method to statistics.NormalDist. Computes the overlapping coefficient for two normal distributions.
bpo-36103: Default buffer size used by
shutil.copyfileobj()is changed from 16 KiB to 64 KiB on non-Windows platform to reduce system call overhead. Contributed by Inada Naoki.bpo-36130: Fix
pdbwithskip=...when stepping into a frame without a__name__global. Patch by Anthony Sottile.bpo-35652: shutil.copytree(copy_function=…) erroneously pass DirEntry instead of a path string.
bpo-35178: Ensure custom
warnings.formatwarning()function can receivelineas positional argument. Based on patch by Tashrif Billah.bpo-36106: Resolve potential name clash with libm’s sinpi(). Patch by Dmitrii Pasechnik.
bpo-36091: Clean up reference to async generator in Lib/types. Patch by Henry Chen.
bpo-36043:
FileCookieJarsupports path-like object. Contributed by Stéphane Wirtelbpo-35899: Enum has been fixed to correctly handle empty strings and strings with non-Latin characters (ie. ‘α’, ‘א’) without crashing. Original patch contributed by Maxwell. Assisted by Stéphane Wirtel.
bpo-21269: Add
argsandkwargsproperties to mock call objects. Contributed by Kumar Akshay.bpo-30670:
pprint.pphas been added to pretty-print objects with dictionary keys being sorted with their insertion order by default. Parameter sort_dicts has been added topprint.pprint,pprint.pformatandpprint.PrettyPrinter. Contributed by Rémi Lapeyre.bpo-35843: Implement
__getitem__for_NamespacePath. Patch by Anthony Sottile.bpo-35802: Clean up code which checked presence of
os.stat/os.lstat/os.chmodwhich are always present. Patch by Anthony Sottile.bpo-35715: Librates the return value of a ProcessPoolExecutor _process_worker after it’s no longer needed to free memory
bpo-35493: Use
multiprocessing.connection.wait()instead of polling each 0.2 seconds for worker updates inmultiprocessing.Pool. Patch by Pablo Galindo.bpo-35661: Store the venv prompt in pyvenv.cfg.
bpo-35121: Don’t set cookie for a request when the request path is a prefix match of the cookie’s path attribute but doesn’t end with “/”. Patch by Karthikeyan Singaravelan.
bpo-21478: Calls to a child function created with
unittest.mock.create_autospec()should propagate to the parent. Patch by Karthikeyan Singaravelan.bpo-35198: Fix C++ extension compilation on AIX
Documentation¶
bpo-36329: Declare the path of the Python binary for the usage of
Tools/scripts/serve.pywhen executingmake -C Doc/ serve. Contributed by Stéphane Wirtelbpo-36138: Improve documentation about converting datetime.timedelta to scalars.
bpo-21314: A new entry was added to the Core Language Section of the Programming FAQ, which explaines the usage of slash(/) in the signature of a function. Patch by Lysandros Nikolaou
Tests¶
bpo-36234: test_posix.PosixUidGidTests: add tests for invalid uid/gid type (str). Initial patch written by David Malcolm.
bpo-29571: Fix
test_re.test_locale_flag(): uselocale.getpreferredencoding()rather thanlocale.getlocale()to get the locale encoding. With some locales,locale.getlocale()returns the wrong encoding.bpo-36123: Fix race condition in test_socket.
Build¶
bpo-36356: Fix leaks that led to build failure when configured with address sanitizer.
bpo-36146: Add
TEST_EXTENSIONSconstant tosetup.pyto allow to not build test extensions like_testcapi.bpo-36146: Fix setup.py on macOS: only add
/usr/include/ffito include directories of _ctypes, not for all extensions.bpo-31904: Enable build system to cross-build for VxWorks RTOS.
Windows¶
bpo-36312: Fixed decoders for the following code pages: 50220, 50221, 50222, 50225, 50227, 50229, 57002 through 57011, 65000 and 42.
bpo-36264: Don’t honor POSIX
HOMEinos.path.expanduseron windows. Patch by Anthony Sottile.bpo-24643: Fix name collisions due to
#define timezone _timezonein PC/pyconfig.h.
IDLE¶
bpo-36405: Use dict unpacking in idlelib.
bpo-36396: Remove fgBg param of idlelib.config.GetHighlight(). This param was only used twice and changed the return type.
bpo-36176: Fix IDLE autocomplete & calltip popup colors. Prevent conflicts with Linux dark themes (and slightly darken calltip background).
bpo-23205: For the grep module, add tests for findfiles, refactor findfiles to be a module-level function, and refactor findfiles to use os.walk.
bpo-23216: Add docstrings to IDLE search modules.
bpo-36152: Remove colorizer.ColorDelegator.close_when_done and the corresponding argument of .close(). In IDLE, both have always been None or False since 2007.
bpo-32129: Avoid blurry IDLE application icon on macOS with Tk 8.6. Patch by Kevin Walzer.
bpo-36096: Refactor class variables to instance variables in colorizer.
bpo-30348: Increase test coverage of idlelib.autocomplete by 30%. Patch by Louie Lu
Tools/Demos¶
C API¶
Python 3.8.0 alpha 2¶
Release date: 2019-02-25
Core and Builtins¶
bpo-36052: Raise a
SyntaxErrorwhen assigning a value to__debug__with the Assignment Operator. Contributed by Stéphane Wirtel and Pablo Galindo.bpo-36012: Doubled the speed of class variable writes. When a non-dunder attribute was updated, there was an unnecessary call to update slots.
bpo-35942: The error message emitted when returning invalid types from
__fspath__in interfaces that allow passingPathLikeobjects has been improved and now it does explain the origin of the error.bpo-36016:
gc.get_objectscan now receive an optional parameter indicating a generation to get objects from. Patch by Pablo Galindo.bpo-1054041: When the main interpreter exits due to an uncaught KeyboardInterrupt, the process now exits in the appropriate manner for its parent process to detect that a SIGINT or ^C terminated the process. This allows shells and batch scripts to understand that the user has asked them to stop.
bpo-35992: Fix
__class_getitem__()not being called on a class with a custom non-subscriptable metaclass.bpo-35993: Fix a crash on fork when using subinterpreters. Contributed by Stéphane Wirtel
bpo-35991: Fix a potential double free in Modules/_randommodule.c.
bpo-35961: Fix a crash in slice_richcompare(): use strong references rather than stolen references for the two temporary internal tuples.
bpo-35911: Enable the creation of cell objects by adding a
cell.__new__method, and expose the typecellinLib/types.pyunder the name CellType. Patch by Pierre Glaser.bpo-12822: Use monotonic clock for
pthread_cond_timedwaitwhenpthread_condattr_setclockandCLOCK_MONOTONICare available.bpo-15248: The compiler emits now syntax warnings in the case when a comma is likely missed before tuple or list.
bpo-35886: The implementation of PyInterpreterState has been moved into the internal header files (guarded by Py_BUILD_CORE).
bpo-31506: Clarify the errors reported when
object.__new__andobject.__init__receive more than one argument. Contributed by Sanyam Khurana.bpo-35724: Signal-handling is now guaranteed to happen relative to the main interpreter.
bpo-33608: We added a new internal _Py_AddPendingCall() that operates relative to the provided interpreter. This allows us to use the existing implementation to ask another interpreter to do work that cannot be done in the current interpreter, like decref an object the other interpreter owns. The existing Py_AddPendingCall() only operates relative to the main interpreter.
bpo-33989: Fix a possible crash in
list.sort()when sorting objects withob_type->tp_richcompare == NULL. Patch by Zackery Spytz.
Library¶
bpo-35512:
unittest.mock.patch.dict()used as a decorator with string target resolves the target during function call instead of during decorator construction. Patch by Karthikeyan Singaravelan.bpo-36018: Add statistics.NormalDist, a tool for creating and manipulating normal distributions of random variable. Features a composite class that treats the mean and standard deviation of measurement data as single entity.
bpo-35904: Added statistics.fmean() as a faster, floating point variant of the existing mean() function.
bpo-35918: Removed broken
has_keymethod from multiprocessing.managers.SyncManager.dict. Contributed by Rémi Lapeyre.bpo-18283: Add support for bytes to
shutil.which().bpo-35960: Fix
dataclasses.field()throwing away empty mapping objects passed as metadata.bpo-35500: Write expected and actual call parameters on separate lines in
unittest.mock.Mock.assert_called_with()assertion errors. Contributed by Susan Su.bpo-35931: The
pdbdebugcommand now gracefully handles syntax errors.bpo-24209: In http.server script, rely on getaddrinfo to bind to preferred address based on the bind parameter. Now default bind or binding to a name may bind to IPv6 or dual-stack, depending on the environment.
bpo-35321: Set
__spec__.originof_frozen_importlibto frozen so that it matches the behavior of_frozen_importlib_external. Patch by Nina Zakharenko.bpo-35378: Fix a reference issue inside
multiprocessing.Poolthat caused the pool to remain alive if it was deleted without being closed or terminated explicitly. A new strong reference is added to the pool iterators to link the lifetime of the pool to the lifetime of its iterators so the pool does not get destroyed if a pool iterator is still alive.bpo-34294: re module, fix wrong capturing groups in rare cases.
re.search(),re.findall(),re.sub()and other functions that scan through string looking for a match, should reset capturing groups between two match attempts. Patch by Ma Lin.bpo-35615:
weakref: Fix a RuntimeError when copying a WeakKeyDictionary or a WeakValueDictionary, due to some keys or values disappearing while iterating.bpo-35606: Implement
math.prod()as analogous function tosum()that returns the product of a ‘start’ value (default: 1) times an iterable of numbers. Patch by Pablo Galindo.bpo-32417: Performing arithmetic between
datetime.datetimesubclasses anddatetime.timedeltanow returns an object of the same type as thedatetime.datetimesubclass. As a result,datetime.datetime.astimezone()and alternate constructors likedatetime.datetime.now()anddatetime.fromtimestamp()called with atzargument now also retain their subclass.bpo-35153: Add headers optional keyword-only parameter to
xmlrpc.client.ServerProxy,xmlrpc.client.Transportandxmlrpc.client.SafeTransport. Patch by Cédric Krier.bpo-34572: Fix C implementation of pickle.loads to use importlib’s locking mechanisms, and thereby avoid using partially loaded modules. Patch by Tim Burgess.
Documentation¶
Tests¶
bpo-27313: Avoid test_ttk_guionly ComboboxTest failure with macOS Cocoa Tk.
bpo-36019: Add test.support.TEST_HTTP_URL and replace references of http://www.example.com by this new constant. Contributed by Stéphane Wirtel.
bpo-36037: Fix test_ssl for strict OpenSSL configuration like RHEL8 strict crypto policy. Use older TLS version for minimum TLS version of the server SSL context if needed, to test TLS version older than default minimum TLS version.
bpo-35798: Added
test.support.check_syntax_warning().bpo-35505: Make test_imap4_host_default_value independent on whether the local IMAP server is running.
bpo-35917: multiprocessing: provide unit tests for SyncManager and SharedMemoryManager classes + all the shareable types which are supposed to be supported by them. (patch by Giampaolo Rodola)
bpo-35704: Skip
test_shutil.test_unpack_archive_xztarto prevent a MemoryError on 32-bit AIX when MAXDATA setting is less than 0x20000000.Patch by Michael Felt (aixtools)
bpo-34720: Assert m_state != NULL to mimic GC traversal functions that do not correctly handle module creation when the module state has not been created.
Windows¶
bpo-35976: Added ARM build support to Windows build files in PCBuild.
bpo-35692:
pathlibno longer raises when checking file and directory existence on drives that are not readybpo-35872: Uses the base Python executable when invoking venv in a virtual environment
bpo-35873: Prevents venv paths being inherited by child processes
bpo-35299: Fix sysconfig detection of the source directory and distutils handling of pyconfig.h during PGO profiling
IDLE¶
Python 3.8.0 alpha 1¶
Release date: 2019-02-03
Security¶
bpo-35746: [CVE-2019-5010] Fix a NULL pointer deref in ssl module. The cert parser did not handle CRL distribution points with empty DP or URI correctly. A malicious or buggy certificate can result into segfault. Vulnerability (TALOS-2018-0758) reported by Colin Read and Nicolas Edet of Cisco.
bpo-34812: The
-Icommand line option (run Python in isolated mode) is now also copied by themultiprocessinganddistutilsmodules when spawning child processes. Previously, only-Eand-soptions (enabled by-I) were copied.bpo-34791: The xml.sax and xml.dom.domreg no longer use environment variables to override parser implementations when sys.flags.ignore_environment is set by -E or -I arguments.
bpo-17239: The xml.sax and xml.dom.minidom parsers no longer processes external entities by default. External DTD and ENTITY declarations no longer load files or create network connections.
bpo-34623: CVE-2018-14647: The C accelerated _elementtree module now initializes hash randomization salt from _Py_HashSecret instead of libexpat’s default CSPRNG.
bpo-34405: Updated to OpenSSL 1.1.0i for Windows builds.
bpo-33871: Fixed sending the part of the file in
os.sendfile()on macOS. Using the trailers argument could cause sending more bytes from the input file than was specified.bpo-32533: Fixed thread-safety of error handling in _ssl.
bpo-33136: Harden ssl module against LibreSSL CVE-2018-8970. X509_VERIFY_PARAM_set1_host() is called with an explicit namelen. A new test ensures that NULL bytes are not allowed.
bpo-33001: Minimal fix to prevent buffer overrun in os.symlink on Windows
bpo-32981: Regexes in difflib and poplib were vulnerable to catastrophic backtracking. These regexes formed potential DOS vectors (REDOS). They have been refactored. This resolves CVE-2018-1060 and CVE-2018-1061. Patch by Jamie Davis.
bpo-28414: The ssl module now allows users to perform their own IDN en/decoding when using SNI.
Core and Builtins¶
bpo-35877: Make parenthesis optional for named expressions in while statement. Patch by Karthikeyan Singaravelan.
bpo-35814: Allow same right hand side expressions in annotated assignments as in normal ones. In particular,
x: Tuple[int, int] = 1, 2(without parentheses on the right) is now allowed.bpo-35766: Add the option to parse PEP 484 type comments in the ast module. (Off by default.) This is merging the key functionality of the third party fork thereof, [typed_ast](https://github.com/python/typed_ast).
bpo-35713: Reorganize Python initialization to get working exceptions and sys.stderr earlier.
bpo-33416: Add end line and end column position information to the Python AST nodes. This is a C-level backwards incompatible change.
bpo-35720: Fixed a minor memory leak in pymain_parse_cmdline_impl function in Modules/main.c
bpo-35634:
func(**kwargs)will now raise an error whenkwargsis a mapping containing multiple entries with the same key. An error was already raised when other keyword arguments are passed before**kwargssince Python 3.6.bpo-35623: Fix a crash when sorting very long lists. Patch by Stephan Hohe.
bpo-35214: clang Memory Sanitizer build instrumentation was added to work around false positives from posix, socket, time, test_io, and test_faulthandler.
bpo-35560: Fix an assertion error in
format()in debug build for floating point formatting with “n” format, zero padding and small width. Release build is not impacted. Patch by Karthikeyan Singaravelan.bpo-35552: Format characters
%sand%VinPyUnicode_FromFormat()and%sinPyBytes_FromFormat()no longer read memory past the limit if precision is specified.bpo-35504: Fix segfaults and
SystemErrors when deleting certain attributes. Patch by Zackery Spytz.bpo-35504: Fixed a SystemError when delete the characters_written attribute of an OSError.
bpo-35494: Improved syntax error messages for unbalanced parentheses in f-string.
bpo-35444: Fixed error handling in pickling methods when fail to look up builtin “getattr”. Sped up pickling iterators.
bpo-35436: Fix various issues with memory allocation error handling. Patch by Zackery Spytz.
bpo-35423: Separate the signal handling trigger in the eval loop from the “pending calls” machinery. There is no semantic change and the difference in performance is insignificant.
bpo-35357: Internal attributes’ names of unittest.mock._Call and unittest.mock.MagicProxy (name, parent & from_kall) are now prefixed with _mock_ in order to prevent clashes with widely used object attributes. Fixed minor typo in test function name.
bpo-35372: Fixed the code page decoder for input longer than 2 GiB containing undecodable bytes.
bpo-35336: Fix PYTHONCOERCECLOCALE=1 environment variable: only coerce the C locale if the LC_CTYPE locale is “C”.
bpo-31241: The lineno and col_offset attributes of AST nodes for list comprehensions, generator expressions and tuples are now point to the opening parenthesis or square brace. For tuples without parenthesis they point to the position of the first item.
bpo-33954: For
str.format(),float.__format__()andcomplex.__format__()methods for non-ASCII decimal point when using the “n” formatter.bpo-35269: Fix a possible segfault involving a newly created coroutine. Patch by Zackery Spytz.
bpo-35224: Implement PEP 572 (assignment expressions). Patch by Emily Morehouse.
bpo-32492: Speed up
namedtupleattribute access by 1.6x using a C fast-path for the name descriptors. Patch by Pablo Galindo.bpo-35214: Fixed an out of bounds memory access when parsing a truncated unicode escape sequence at the end of a string such as
'\N'. It would read one byte beyond the end of the memory allocation.bpo-35214: The interpreter and extension modules have had annotations added so that they work properly under clang’s Memory Sanitizer. A new configure flag –with-memory-sanitizer has been added to make test builds of this nature easier to perform.
bpo-35193: Fix an off by one error in the bytecode peephole optimizer where it could read bytes beyond the end of bounds of an array when removing unreachable code. This bug was present in every release of Python 3.6 and 3.7 until now.
bpo-35169: Improved error messages for forbidden assignments.
bpo-34022: Fix handling of hash-based bytecode files in
zipimport. Patch by Elvis Pranskevichus.bpo-28401: Debug builds will no longer to attempt to import extension modules built for the ABI as they were never compatible to begin with. Patch by Stefano Rivera.
bpo-29341: Clarify in the docstrings of
osmethods that path-like objects are also accepted as input parameters.bpo-35050:
socket: Fix off-by-one bug in length check forAF_ALGname and type.bpo-29743: Raise
ValueErrorinstead ofOverflowErrorin case of a negative_length_in actypes.Arraysubclass. Also raiseTypeErrorinstead ofAttributeErrorfor non-integer_length_. Original patch by Oren Milman.bpo-16806: Fix
linenoandcol_offsetfor multi-line string tokens.bpo-35029:
SyntaxWarningraised as an exception at code generation time will be now replaced with aSyntaxErrorfor better error reporting.bpo-34983: Expose
symtable.Symbol.is_nonlocal()in the symtable module. Patch by Pablo Galindo.bpo-34974:
bytesandbytearrayconstructors no longer convert unexpected exceptions (e.g.MemoryErrorandKeyboardInterrupt) toTypeError.bpo-34939: Allow annotated names in module namespace that are declared global before the annotation happens. Patch by Pablo Galindo.
bpo-34973: Fixed crash in
bytes()when thelistargument is mutated while it is iterated.bpo-34876: The lineno and col_offset attributes of the AST for decorated function and class refer now to the position of the corresponding
def,async defandclassinstead of the position of the first decorator. This leads to more correct line reporting in tracing. This is the only case when the position of child AST nodes can precede the position of the parent AST node.bpo-34879: Fix a possible null pointer dereference in bytesobject.c. Patch by Zackery Spytz.
bpo-34784: Fix the implementation of PyStructSequence_NewType in order to create heap allocated StructSequences.
bpo-32912: A
SyntaxWarningis now emitted instead of aDeprecationWarningfor invalid escape sequences in string and bytes literals.bpo-34854: Fixed a crash in compiling string annotations containing a lambda with a keyword-only argument that doesn’t have a default value.
bpo-34850: The compiler now produces a
SyntaxWarningwhen identity checks (isandis not) are used with certain types of literals (e.g. strings, ints). These can often work by accident in CPython, but are not guaranteed by the language spec. The warning advises users to use equality tests (==and!=) instead.bpo-34824: Fix a possible null pointer dereference in Modules/_ssl.c. Patch by Zackery Spytz.
bpo-30156: The C function
property_descr_get()uses a “cached” tuple to optimize function calls. But this tuple can be discovered in debug mode withsys.getobjects(). Remove the optimization, it’s not really worth it and it causes 3 different crashes last years.bpo-34762: Fix contextvars C API to use PyObject* pointer types.
bpo-34751: The hash function for tuples is now based on xxHash which gives better collision results on (formerly) pathological cases. Additionally, on 64-bit systems it improves tuple hashes in general. Patch by Jeroen Demeyer with substantial contributions by Tim Peters.
bpo-34735: Fix a memory leak in Modules/timemodule.c. Patch by Zackery Spytz.
bpo-34683: Fixed a bug where some SyntaxError error pointed to locations that were off-by-one.
bpo-34651: Only allow the main interpreter to fork. The avoids the possibility of affecting the main interpreter, which is critical to operation of the runtime.
bpo-34653: Remove unused function PyParser_SimpleParseStringFilename.
bpo-32236: Warn that line buffering is not supported if
open()is called with binary mode andbuffering=1.bpo-34641: Further restrict the syntax of the left-hand side of keyword arguments in function calls. In particular,
f((keyword)=arg)is now disallowed.bpo-34637: Make the start argument to sum() visible as a keyword argument.
bpo-1621: Do not assume signed integer overflow behavior (C undefined behavior) when performing set hash table resizing.
bpo-34588: Fix an off-by-one in the recursive call pruning feature of traceback formatting.
bpo-34485: On Windows, the LC_CTYPE is now set to the user preferred locale at startup. Previously, the LC_CTYPE locale was “C” at startup, but changed when calling setlocale(LC_CTYPE, “”) or setlocale(LC_ALL, “”).
bpo-34485: Standard streams like sys.stdout now use the “surrogateescape” error handler, instead of “strict”, on the POSIX locale (when the C locale is not coerced and the UTF-8 Mode is disabled).
bpo-34485: Fix the error handler of standard streams like sys.stdout: PYTHONIOENCODING=”:” is now ignored instead of setting the error handler to “strict”.
bpo-34485: Python now gets the locale encoding with C code to initialize the encoding of standard streams like sys.stdout. Moreover, the encoding is now initialized to the Python codec name to get a normalized encoding name and to ensure that the codec is loaded. The change avoids importing _bootlocale and _locale modules at startup by default.
bpo-34527: On FreeBSD, Py_DecodeLocale() and Py_EncodeLocale() now also forces the ASCII encoding if the LC_CTYPE locale is “POSIX”, not only if the LC_CTYPE locale is “C”.
bpo-34527: The UTF-8 Mode is now also enabled by the “POSIX” locale, not only by the “C” locale.
bpo-34403: On HP-UX with C or POSIX locale, sys.getfilesystemencoding() now returns “ascii” instead of “roman8” (when the UTF-8 Mode is disabled and the C locale is not coerced).
bpo-34523: The Python filesystem encoding is now read earlier during the Python initialization.
bpo-12458: Tracebacks show now correct line number for subexpressions in multiline expressions. Tracebacks show now the line number of the first line for multiline expressions instead of the line number of the last subexpression.
bpo-34408: Prevent a null pointer dereference and resource leakage in
PyInterpreterState_New().bpo-34400: Fix undefined behavior in parsetok.c. Patch by Zackery Spytz.
bpo-33073: Added as_integer_ratio to ints to make them more interoperable with floats.
bpo-34377: Update valgrind suppression list to use
_PyObject_Free/_PyObject_Reallocinstead ofPyObject_Free/PyObject_Realloc.bpo-34353: Added the “socket” option in the
stat.filemode()Python implementation to match the C implementation.bpo-34320: Fix
dict(od)didn’t copy iteration order of OrderedDict.bpo-34113: Fixed crash on debug builds when opcode stack was adjusted with negative numbers. Patch by Constantin Petrisor.
bpo-34100: Compiler now merges constants in tuples and frozensets recursively. Code attributes like
co_namesare merged too.bpo-34151: Performance of list concatenation, repetition and slicing operations is slightly improved. Patch by Sergey Fedoseev.
bpo-34170: -X dev: it is now possible to override the memory allocator using PYTHONMALLOC even if the developer mode is enabled.
bpo-33237: Improved
AttributeErrormessage for partially initialized module.bpo-34149: Fix min and max functions to get default behavior when key is None.
bpo-34125: Profiling of unbound built-in methods now works when
**kwargsis given.bpo-34141: Optimized pickling atomic types (None, bool, int, float, bytes, str).
bpo-34126: Fix crashes when profiling certain invalid calls of unbound methods. Patch by Jeroen Demeyer.
bpo-24618: Fixed reading invalid memory when create the code object with too small varnames tuple or too large argument counts.
bpo-34068: In
io.IOBase.close(), ensure that theclosedattribute is not set with a live exception. Patch by Zackery Spytz and Serhiy Storchaka.bpo-34087: Fix buffer overflow while converting unicode to numeric values.
bpo-34080: Fixed a memory leak in the compiler when it raised some uncommon errors during tokenizing.
bpo-34066: Disabled interruption by Ctrl-C between calling
open()and entering a with block inwith open().bpo-34042: Fix dict.copy() to maintain correct total refcount (as reported by sys.gettotalrefcount()).
bpo-33418: Fix potential memory leak in function object when it creates reference cycle.
bpo-33985: Implement contextvars.ContextVar.name attribute.
bpo-33956: Update vendored Expat library copy to version 2.2.5.
bpo-24596: Decref the module object in
PyRun_SimpleFileExFlags()before callingPyErr_Print(). Patch by Zackery Spytz.bpo-33451: Close directly executed pyc files before calling
PyEval_EvalCode().bpo-1617161: The hash of
BuiltinMethodTypeinstances (methods of built-in classes) now depends on the hash of the identity of __self__ instead of its value. The hash and equality ofModuleTypeandMethodWrapperTypeinstances (methods of user-defined classes and some methods of built-in classes likestr.__add__) now depend on the hash and equality of the identity of __self__ instead of its value.MethodWrapperTypeinstances no longer support ordering.bpo-33824: Fix “LC_ALL=C python3.7 -V”: reset properly the command line parser when the encoding changes after reading the Python configuration.
bpo-33803: Fix a crash in hamt.c caused by enabling GC tracking for an object that hadn’t all of its fields set to NULL.
bpo-33738: Seven macro incompatibilities with the Limited API were fixed, and the macros
PyIter_Check(),PyIndex_Check()andPyExceptionClass_Name()were added as functions. A script for automatic macro checks was added.bpo-33786: Fix asynchronous generators to handle GeneratorExit in athrow() correctly
bpo-30167:
PyRun_SimpleFileExFlagsremoves__cached__from module in addition to__file__.bpo-33706: Fix a crash in Python initialization when parsing the command line options. Thanks Christoph Gohlke for the bug report and the fix!
bpo-33597: Reduce
PyGC_Headsize from 3 words to 2 words.bpo-30654: Fixed reset of the SIGINT handler to SIG_DFL on interpreter shutdown even when there was a custom handler set previously. Patch by Philipp Kerling.
bpo-33622: Fixed a leak when the garbage collector fails to add an object with the
__del__method or referenced by it into thegc.garbagelist.PyGC_Collect()can now be called when an exception is set and preserves it.bpo-33462: Make dict and dict views reversible. Patch by Rémi Lapeyre.
bpo-23722: A
RuntimeErroris now raised when the custom metaclass doesn’t provide the__classcell__entry in the namespace passed totype.__new__. ADeprecationWarningwas emitted in Python 3.6–3.7.bpo-33499: Add
PYTHONPYCACHEPREFIXenvironment variable and-Xpycache_prefixcommand-line option to set an alternate root directory for writing module bytecode cache files.bpo-25711: The
zipimportmodule has been rewritten in pure Python.bpo-33509: Fix module_globals parameter of warnings.warn_explicit(): don’t crash if module_globals is not a dict.
bpo-31849: Fix signed/unsigned comparison warning in pyhash.c.
bpo-33475: Fixed miscellaneous bugs in converting annotations to strings and optimized parentheses in the string representation.
bpo-20104: Added support for the
setpgroup,resetids,setsigmask,setsigdefandschedulerparameters ofposix_spawn. Patch by Pablo Galindo.bpo-33391: Fix a leak in set_symmetric_difference().
bpo-33363: Raise a SyntaxError for
async withandasync forstatements outside of async functions.bpo-28055: Fix unaligned accesses in siphash24(). Patch by Rolf Eike Beer.
bpo-33128: Fix a bug that causes PathFinder to appear twice on sys.meta_path. Patch by Pablo Galindo Salgado.
bpo-33331: Modules imported last are now cleared first at interpreter shutdown.
bpo-33312: Fixed clang ubsan (undefined behavior sanitizer) warnings in dictobject.c by adjusting how the internal struct _dictkeysobject shared keys structure is declared.
bpo-33305: Improved syntax error messages for invalid numerical literals.
bpo-33306: Improved syntax error messages for unbalanced parentheses.
bpo-33234: The list constructor will pre-size and not over-allocate when the input length is known.
bpo-33270: Intern the names for all anonymous code objects. Patch by Zackery Spytz.
bpo-30455: The C and Python code and the documentation related to tokens are now generated from a single source file
Grammar/Tokens.bpo-33176: Add a
toreadonly()method to memoryviews.bpo-33231: Fix potential memory leak in
normalizestring().bpo-33205: Change dict growth function from
round_up_to_power_2(used*2+hashtable_size/2)toround_up_to_power_2(used*3). Previously, dict is shrinked only whenused == 0. Now dict has more chance to be shrinked.bpo-29922: Improved error messages in ‘async with’ when
__aenter__()or__aexit__()return non-awaitable object.bpo-33199: Fix
ma_version_tagin dict implementation is uninitialized when copying from key-sharing dict.bpo-33053: When using the -m switch, sys.path[0] is now explicitly expanded as the starting working directory, rather than being left as the empty path (which allows imports from the current working directory at the time of the import)
bpo-33138: Changed standard error message for non-pickleable and non-copyable types. It now says “cannot pickle” instead of “can’t pickle” or “cannot serialize”.
bpo-33018: Improve consistency of errors raised by
issubclass()when called with a non-class and an abstract base class as the first and second arguments, respectively. Patch by Josh Bronson.bpo-33083:
math.factorialno longer accepts arguments that are not int-like. Patch by Pablo Galindo.bpo-33041: Added new opcode
END_ASYNC_FORand fixes the following issues:Setting global
StopAsyncIterationno longer breaksasync forloops.Jumping into an
async forloop is now disabled.Jumping out of an
async forloop no longer corrupts the stack.
bpo-25750: Fix rare Python crash due to bad refcounting in
type_getattro()if a descriptor deletes itself from the class. Patch by Jeroen Demeyer.bpo-33041: Fixed bytecode generation for “async for” with a complex target. A StopAsyncIteration raised on assigning or unpacking will be now propagated instead of stopping the iteration.
bpo-33026: Fixed jumping out of “with” block by setting f_lineno.
bpo-33005: Fix a crash on fork when using a custom memory allocator (ex: using PYTHONMALLOC env var). _PyGILState_Reinit() and _PyInterpreterState_Enable() now use the default RAW memory allocator to allocate a new interpreters mutex on fork.
bpo-32911: Due to unexpected compatibility issues discovered during downstream beta testing, reverted bpo-29463.
docstringfield is removed from Module, ClassDef, FunctionDef, and AsyncFunctionDef ast nodes which was added in 3.7a1. Docstring expression is restored as a first statement in their body. Based on patch by Inada Naoki.bpo-17288: Prevent jumps from ‘return’ and ‘exception’ trace events.
bpo-32946: Importing names from already imported module with “from … import …” is now 30% faster if the module is not a package.
bpo-32932: Make error message more revealing when there are non-str objects in
__all__.bpo-32925: Optimized iterating and containing test for literal lists consisting of non-constants:
x in [a, b]andfor x in [a, b]. The case of all constant elements already was optimized.bpo-32889: Update Valgrind suppression list to account for the rename of
Py_ADDRESS_IN_RANGtoaddress_in_range.bpo-32836: Don’t use temporary variables in cases of list/dict/set comprehensions
bpo-31356: Remove the new API added in bpo-31356 (gc.ensure_disabled() context manager).
bpo-32305: For namespace packages, ensure that both
__file__and__spec__.originare set to None.bpo-32303: Make sure
__spec__.loadermatches__loader__for namespace packages.bpo-32711: Fix the warning messages for Python/ast_unparse.c. Patch by Stéphane Wirtel
bpo-32583: Fix possible crashing in builtin Unicode decoders caused by write out-of-bound errors when using customized decode error handlers.
bpo-32489: A
continuestatement is now allowed in thefinallyclause.bpo-17611: Simplified the interpreter loop by moving the logic of unrolling the stack of blocks into the compiler. The compiler emits now explicit instructions for adjusting the stack of values and calling the cleaning up code for
break,continueandreturn.Removed opcodes
BREAK_LOOP,CONTINUE_LOOP,SETUP_LOOPandSETUP_EXCEPT. Added new opcodesROT_FOUR,BEGIN_FINALLYandCALL_FINALLYandPOP_FINALLY. Changed the behavior ofEND_FINALLYandWITH_CLEANUP_START.bpo-32285: New function unicodedata.is_normalized, which can check whether a string is in a specific normal form.
bpo-10544: Yield expressions are now disallowed in comprehensions and generator expressions except the expression for the outermost iterable.
bpo-32117: Iterable unpacking is now allowed without parentheses in yield and return statements, e.g.
yield 1, 2, 3, *rest. Thanks to David Cuthbert for the change and Jordan Chapman for added tests.bpo-31902: Fix the
col_offsetattribute for ast nodesast.AsyncFor,ast.AsyncFunctionDef, andast.AsyncWith. Previously,col_offsetpointed to the keyword afterasync.bpo-25862: Fix assertion failures in the
tell()method ofio.TextIOWrapper. Patch by Zackery Spytz.bpo-21983: Fix a crash in
ctypes.cast()in case the type argument is a ctypes structured data type. Patch by Eryk Sun and Oren Milman.bpo-31577: Fix a crash in
os.utime()in case of a bad ns argument. Patch by Oren Milman.bpo-29832: Remove references to ‘getsockaddrarg’ from various socket error messages. Patch by Oren Milman.
Library¶
bpo-35845: Add ‘order’ parameter to memoryview.tobytes().
bpo-35864: The _asdict() method for collections.namedtuple now returns a regular dict instead of an OrderedDict.
bpo-35537: An ExitStack is now used internally within subprocess.Popen to clean up pipe file handles. No behavior change in normal operation. But if closing one handle were ever to cause an exception, the others will now be closed instead of leaked. (patch by Giampaolo Rodola)
bpo-35847: RISC-V needed the CTYPES_PASS_BY_REF_HACK. Fixes ctypes Structure test_pass_by_value.
bpo-35813: Shared memory submodule added to multiprocessing to avoid need for serialization between processes
bpo-35780: Fix lru_cache() errors arising in recursive, reentrant, or multi-threaded code. These errors could result in orphan links and in the cache being trapped in a state with fewer than the specified maximum number of links. Fix handling of negative maxsize which should have been treated as zero. Fix errors in toggling the “full” status flag. Fix misordering of links when errors are encountered. Sync-up the C code and pure Python code for the space saving path in functions with a single positional argument. In this common case, the space overhead of an lru cache entry is reduced by almost half. Fix counting of cache misses. In error cases, the miss count was out of sync with the actual number of times the underlying user function was called.
bpo-35537:
os.posix_spawn()andos.posix_spawnp()now have a setsid parameter.bpo-23846:
asyncio.ProactorEventLoopnow catches and logs send errors when the self-pipe is full.bpo-34323:
asyncio: EnhanceIocpProactor.close()log: wait 1 second before the first log, then log every second. Log also the number of seconds sinceclose()was called.bpo-35674: Add a new
os.posix_spawnp()function. Patch by Joannah Nanjekye.bpo-35733:
ast.Constant(boolean)no longer an instance ofast.Num. Patch by Anthony Sottile.bpo-35726: QueueHandler.prepare() now makes a copy of the record before modifying and enqueueing it, to avoid affecting other handlers in the chain.
bpo-35719: Sped up multi-argument
mathfunctions atan2(), copysign(), remainder() and hypot() by 1.3–2.5 times.bpo-35717: Fix KeyError exception raised when using enums and compile. Patch contributed by Rémi Lapeyre.
bpo-35699: Fixed detection of Visual Studio Build Tools 2017 in distutils
bpo-32710: Fix memory leaks in asyncio ProactorEventLoop on overlapped operation failure.
bpo-35702: The
time.CLOCK_UPTIME_RAWconstant is now available for macOS 10.12.bpo-32710: Fix a memory leak in asyncio in the ProactorEventLoop when
ReadFile()orWSASend()overlapped operation fail immediately: release the internal buffer.bpo-35682: Fix
asyncio.ProactorEventLoop.sendfile(): don’t attempt to set the result of an internal future if it’s already done.bpo-35283: Add a deprecated warning for the
threading.Thread.isAlive()method. Patch by Dong-hee Na.bpo-35664: Improve operator.itemgetter() performance by 33% with optimized argument handling and with adding a fast path for the common case of a single non-negative integer index into a tuple (which is the typical use case in the standard library).
bpo-35643: Fixed a SyntaxWarning: invalid escape sequence in Modules/_sha3/cleanup.py. Patch by Mickaël Schoentgen.
bpo-35619: Improved support of custom data descriptors in
help()andpydoc.bpo-28503: The
cryptmodule now internally uses thecrypt_r()library function instead ofcrypt()when available.bpo-35614: Fixed help() on metaclasses. Patch by Sanyam Khurana.
bpo-35568: Expose
raise(signum)asraise_signalbpo-35588: The floor division and modulo operations and the
divmod()function onfractions.Fractiontypes are 2–4x faster. Patch by Stefan Behnel.bpo-35585: Speed-up building enums by value, e.g. http.HTTPStatus(200).
bpo-30561: random.gammavariate(1.0, beta) now computes the same result as random.expovariate(1.0 / beta). This synchronizes the two algorithms and eliminates some idiosyncrasies in the old implementation. It does however produce a difference stream of random variables than it used to.
bpo-35537: The
subprocessmodule can now use theos.posix_spawn()function in some cases for better performance.bpo-35526: Delaying the ‘joke’ of barry_as_FLUFL.mandatory to Python version 4.0
bpo-35523: Remove
ctypescallback workaround: no longer create a callback at startup. Avoid SELinux alert onimport ctypesandimport uuid.bpo-31784:
uuid.uuid1()now callstime.time_ns()rather thanint(time.time() * 1e9).bpo-35513:
TextTestRunnerofunittest.runnernow usestime.perf_counter()rather thantime.time()to measure the execution time of a test:time.time()can go backwards, whereastime.perf_counter()is monotonic.bpo-35502: Fixed reference leaks in
xml.etree.ElementTree.TreeBuilderin case of unfinished building of the tree (in particular when an error was raised during parsing XML).bpo-35348: Make
platform.architecture()parsing offilecommand output more reliable: add the-boption to thefilecommand to omit the filename, force the usage of the C locale, and search also the “shared object” pattern.bpo-35491:
multiprocessing: AddPool.__repr__()and enhanceBaseProcess.__repr__()(add pid and parent pid) to ease debugging. Pool state constant values are now strings instead of integers, for exampleRUNvalue becomes'RUN'instead of0.bpo-35477:
multiprocessing.Pool.__enter__()now fails if the pool is not running:with pool:fails if used more than once.bpo-31446: Copy command line that was passed to CreateProcessW since this function can change the content of the input buffer.
bpo-35471: Python 2.4 dropped MacOS 9 support. The macpath module was deprecated in Python 3.7. The module is now removed.
bpo-23057: Unblock Proactor event loop when keyboard interrupt is received on Windows
bpo-35052: Fix xml.dom.minidom cloneNode() on a document with an entity: pass the correct arguments to the user data handler of an entity.
bpo-20239: Allow repeated assignment deletion of
unittest.mock.Mockattributes. Patch by Pablo Galindo.bpo-17185: Set
__signature__on mock forinspectto get signature. Patch by Karthikeyan Singaravelan.bpo-35445: Memory errors during creating posix.environ no longer ignored.
bpo-35415: Validate fileno= argument to socket.socket().
bpo-35424:
multiprocessing.Pooldestructor now emitsResourceWarningif the pool is still running.bpo-35330: When a
Mockinstance was used to wrap an object, ifside_effectis used in one of the mocks of it methods, don’t call the original implementation and return the result of using the side effect the same way that it is done with return_value.bpo-35346: Drop Mac OS 9 and Rhapsody support from the
platformmodule. Rhapsody last release was in 2000. Mac OS 9 last release was in 2001.bpo-10496:
check_environ()ofdistutils.utilsnow catchesKeyErroron callingpwd.getpwuid(): don’t create theHOMEenvironment variable in this case.bpo-10496:
posixpath.expanduser()now returns the input path unchanged if theHOMEenvironment variable is not set and the current user has no home directory (if the current user identifier doesn’t exist in the password database). This change fix thesitemodule if the current user doesn’t exist in the password database (if the user has no home directory).bpo-35389:
platform.libc_ver()now usesos.confstr('CS_GNU_LIBC_VERSION')if available and the executable parameter is not set.bpo-35394: Add empty slots to asyncio abstract protocols.
bpo-35310: Fix a bug in
select.select()where, in some cases, the file descriptor sequences were returned unmodified after a signal interruption, even though the file descriptors might not be ready yet.select.select()will now always return empty lists if a timeout has occurred. Patch by Oran Avraham.bpo-35380: Enable TCP_NODELAY on Windows for proactor asyncio event loop.
bpo-35341: Add generic version of
collections.OrderedDictto thetypingmodule. Patch by Ismo Toijala.bpo-35371: Fixed possible crash in
os.utime()on Windows when pass incorrect arguments.bpo-35346:
platform.uname()now redirectsstderrtoos.devnullwhen running external programs likecmd /c ver.bpo-35066: Previously, calling the strftime() method on a datetime object with a trailing ‘%’ in the format string would result in an exception. However, this only occurred when the datetime C module was being used; the python implementation did not match this behavior. Datetime is now PEP-399 compliant, and will not throw an exception on a trailing ‘%’.
bpo-35345: The function
platform.popenhas been removed, it was deprecated since Python 3.3: useos.popen()instead.bpo-35344: On macOS,
platform.platform()now usesplatform.mac_ver(), if it returns a non-empty release string, to get the macOS version rather than the darwin version.bpo-35312: Make
lib2to3.pgen2.parse.ParseErrorround-trip pickle-able. Patch by Anthony Sottile.bpo-35308: Fix regression in
webbrowserwhere default browsers may be preferred over browsers in theBROWSERenvironment variable.bpo-24746: Avoid stripping trailing whitespace in doctest fancy diff. Original patch by R. David Murray & Jairo Trad. Enhanced by Sanyam Khurana.
bpo-28604:
locale.localeconv()now sets temporarily theLC_CTYPElocale to theLC_MONETARYlocale if the two locales are different and monetary strings are non-ASCII. This temporary change affects other threads.bpo-35277: Update ensurepip to install pip 18.1 and setuptools 40.6.2.
bpo-24209: Adds IPv6 support when invoking http.server directly.
bpo-35226: Recursively check arguments when testing for equality of
unittest.mock.callobjects and add note that tracking of parameters used to create ancestors of mocks inmock_callsis not possible.bpo-29564: The warnings module now suggests to enable tracemalloc if the source is specified, the tracemalloc module is available, but tracemalloc is not tracing memory allocations.
bpo-35189: Modify the following fnctl function to retry if interrupted by a signal (EINTR): flock, lockf, fnctl
bpo-30064: Use add_done_callback() in sock_* asyncio API to unsubscribe reader/writer early on calcellation.
bpo-35186: Removed the “built with” comment added when
setup.py uploadis used with eitherbdist_rpmorbdist_dumb.bpo-35152: Allow sending more than 2 GB at once on a multiprocessing connection on non-Windows systems.
bpo-35062: Fix incorrect parsing of
_io.IncrementalNewlineDecoder’s translate argument.bpo-35065: Remove
StreamReaderProtocol._untrack_reader. The call to_untrack_readeris currently performed too soon, causing the protocol to forget about the reader beforeconnection_lostcan run and feed the EOF to the reader.bpo-34160: ElementTree and minidom now preserve the attribute order specified by the user.
bpo-35079: Improve difflib.SequenceManager.get_matching_blocks doc by adding ‘non-overlapping’ and changing ‘!=’ to ‘<’.
bpo-33710: Deprecated
l*gettext()functions and methods in thegettextmodule. They return encoded bytes instead of Unicode strings and are artifacts from Python 2 times. Also deprecated functions and methods related to setting the charset forl*gettext()functions and methods.bpo-35017:
socketserver.BaseServer.serve_forever()now exits immediately if it’sshutdown()method is called while it is polling for new events.bpo-35024:
importlibno longer logswroteredundantly after(created|could not create)is already logged. Patch by Quentin Agren.bpo-35047:
unittest.mocknow includes mock calls in exception messages ifassert_not_called,assert_called_once, orassert_called_once_withfails. Patch by Petter Strandmark.bpo-31047: Fix
ntpath.abspathregression where it didn’t remove a trailing separator on Windows. Patch by Tim Graham.bpo-35053: tracemalloc now tries to update the traceback when an object is reused from a “free list” (optimization for faster object creation, used by the builtin list type for example).
bpo-31553: Add the –json-lines option to json.tool. Patch by hongweipeng.
bpo-34794: Fixed a leak in Tkinter when pass the Python wrapper around Tcl_Obj back to Tcl/Tk.
bpo-34909: Enum: fix grandchildren subclassing when parent mixed with concrete data types.
bpo-35022:
unittest.mock.MagicMocknow supports the__fspath__method (fromos.PathLike).bpo-35008: Fixed references leaks when call the
__setstate__()method ofxml.etree.ElementTree.Elementin the C implementation for already initialized element.bpo-23420: Verify the value for the parameter ‘-s’ of the cProfile CLI. Patch by Robert Kuska
bpo-33947: dataclasses now handle recursive reprs without raising RecursionError.
bpo-34890: Make
inspect.iscoroutinefunction(),inspect.isgeneratorfunction()andinspect.isasyncgenfunction()work withfunctools.partial(). Patch by Pablo Galindo.bpo-34521: Use
socket.CMSG_SPACE()to calculate ancillary data size instead ofsocket.CMSG_LEN()inmultiprocessing.reduction.recvfds()as RFC 3542 requires the use of the former for portable applications.bpo-31522: The
mailbox.mbox.get_stringfunction from_ parameter can now successfully be set to a non-default value.bpo-34970: Protect tasks weak set manipulation in
asyncio.all_tasks()bpo-34969: gzip: Add –fast, –best on the gzip CLI, these parameters will be used for the fast compression method (quick) or the best method compress (slower, but smaller file). Also, change the default compression level to 6 (tradeoff).
bpo-16965: The 2to3
execfilefixer now opens the file with mode'rb'. Patch by Zackery Spytz.bpo-34966:
pydocnow supports aliases not only to methods defined in the end class, but also to inherited methods. The docstring is not duplicated for aliases.bpo-34926:
mimetypes.MimeTypes.guess_type()now accepts path-like object in addition to url strings. Patch by Mayank Asthana.bpo-23831: Add
moveto()method to thetkinter.Canvaswidget. Patch by Juliette Monsel.bpo-34941: Methods
find(),findtext()andfindall()of theElementclass in thexml.etree.ElementTreemodule are now able to find children which are instances ofElementsubclasses.bpo-32680:
smtplib.SMTPobjects now always have asockattribute presentbpo-34769: Fix for async generators not finalizing when event loop is in debug mode and garbage collector runs in another thread.
bpo-34936: Fix
TclErrorintkinter.Spinbox.selection_element(). Patch by Juliette Monsel.bpo-34829: Add methods
selection_from,selection_range,selection_presentandselection_toto thetkinter.Spinboxfor consistency with thetkinter.Entrywidget. Patch by Juliette Monsel.bpo-34911: Added secure_protocols argument to http.cookiejar.DefaultCookiePolicy to allow for tweaking of protocols and also to add support by default for wss, the secure websocket protocol.
bpo-34922: Fixed integer overflow in the
digest()andhexdigest()methods for the SHAKE algorithm in thehashlibmodule.bpo-34925: 25% speedup in argument parsing for the functions in the bisect module.
bpo-34900: Fixed
unittest.TestCase.debug()when used to call test methods with subtests. Patch by Bruno Oliveira.bpo-34844: logging.Formatter enhancement - Ensure styles and fmt matches in logging.Formatter - Added validate method in each format style class: StrFormatStyle, PercentStyle, StringTemplateStyle. - This method is called in the constructor of logging.Formatter class - Also re-raise the KeyError in the format method of each style class, so it would a bit clear that it’s an error with the invalid format fields.
bpo-34897: Adjust test.support.missing_compiler_executable check so that a nominal command name of “” is ignored. Patch by Michael Felt.
bpo-34871: Fix inspect module polluted
sys.moduleswhen parsing__text_signature__of callable.bpo-34898: Add
mtimeargument togzip.compressfor reproducible output. Patch by Guo Ci Teo.bpo-28441: On Cygwin and MinGW, ensure that
sys.executablealways includes the full filename in the path, including the.exesuffix (unless it is a symbolic link).bpo-34866: Adding
max_num_fieldstocgi.FieldStorageto make DOS attacks harder by limiting the number ofMiniFieldStorageobjects created byFieldStorage.bpo-34711: http.server ensures it reports HTTPStatus.NOT_FOUND when the local path ends with “/” and is not a directory, even if the underlying OS (e.g. AIX) accepts such paths as a valid file reference. Patch by Michael Felt.
bpo-34872: Fix self-cancellation in C implementation of asyncio.Task
bpo-34849: Don’t log waiting for
selector.selectin asyncio loop iteration. The waiting is pretty normal for any asyncio program, logging its time just adds a noise to logs without any useful information provided.bpo-34022: The
SOURCE_DATE_EPOCHenvironment variable no longer overrides the value of the invalidation_mode argument topy_compile.compile(), and determines its default value instead.bpo-34819: Use a monotonic clock to compute timeouts in
Executor.map()andas_completed(), in order to prevent timeouts from deviating when the system clock is adjusted.bpo-34758: Add .wasm -> application/wasm to list of recognized file types and content type headers
bpo-34789:
xml.sax.make_parser()now accepts any iterable as its parser_list argument. Patch by Andrés Delfino.bpo-34334: In
QueueHandler, clearexc_textfromLogRecordto prevent traceback from being written twice.bpo-34687: On Windows, asyncio now uses ProactorEventLoop, instead of SelectorEventLoop, by default.
bpo-5950: Support reading zip files with archive comments in
zipimport.bpo-32892: The parser now represents all constants as
ast.Constantinstead of using specific constant AST types (Num,Str,Bytes,NameConstantandEllipsis). These classes are considered deprecated and will be removed in future Python versions.bpo-34728: Add deprecation warning when
loopis used in methods:asyncio.sleep,asyncio.waitandasyncio.wait_for.bpo-34738: ZIP files created by
distutilswill now include entries for directories.bpo-34659: Add an optional initial argument to itertools.accumulate().
bpo-29577: Support multiple mixin classes when creating Enums.
bpo-34670: Add SSLContext.post_handshake_auth and SSLSocket.verify_client_post_handshake for TLS 1.3’s post handshake authentication feature.
bpo-32718: The Activate.ps1 script from venv works with PowerShell Core 6.1 and is now available under all operating systems.
bpo-31177: Fix bug that prevented using
reset_mockon mock instances with deleted attributesbpo-34672: Add a workaround, so the
'Z'time.strftime()specifier on the musl C library can work in some cases.bpo-34666: Implement
asyncio.StreamWriter.awriteandasyncio.StreamWriter.aclose()coroutines. Methods are needed for providing a consistent stream API with control flow switched on by default.bpo-6721: Acquire the logging module’s commonly used internal locks while fork()ing to avoid deadlocks in the child process.
bpo-34658: Fix a rare interpreter unhandled exception state SystemError only seen when using subprocess with a preexec_fn while an after_parent handler has been registered with os.register_at_fork and the fork system call fails.
bpo-34652: Ensure
os.lchmod()is never defined on Linux.bpo-34638: Store a weak reference to stream reader to break strong references loop between reader and protocol. It allows to detect and close the socket if the stream is deleted (garbage collected) without
close()call.bpo-34536:
Enum._missing_: raiseValueErrorif None returned andTypeErrorif non-member is returned.bpo-34636: Speed up re scanning of many non-matching characters for s w and d within bytes objects. (microoptimization)
bpo-24412: Add
addModuleCleanup()andaddClassCleanup()to unittest to support cleanups forsetUpModule()andsetUpClass(). Patch by Lisa Roach.bpo-34630: Don’t log SSL certificate errors in asyncio code (connection error logging is skipped already).
bpo-32490: Prevent filename duplication in
subprocessexception messages. Patch by Zackery Spytz.bpo-34363: dataclasses.asdict() and .astuple() now handle namedtuples correctly.
bpo-34625: Update vendorized expat library version to 2.2.6.
bpo-32270: The subprocess module no longer mistakenly closes redirected fds even when they were in pass_fds when outside of the default {0, 1, 2} set.
bpo-34622: Create a dedicated
asyncio.CancelledError,asyncio.InvalidStateErrorandasyncio.TimeoutErrorexception classes. Inherit them from corresponding exceptions fromconcurrent.futurespackage. Extractasyncioexceptions into a separate file.bpo-34610: Fixed iterator of
multiprocessing.managers.DictProxy.bpo-34421: Fix distutils logging for non-ASCII strings. This caused installation issues on Windows.
bpo-34604: Fix possible mojibake in the error message of
pwd.getpwnamandgrp.getgrnamusing string representation because of invisible characters or trailing whitespaces. Patch by William Grzybowski.bpo-30977: Make uuid.UUID use
__slots__to reduce its memory footprint. Based on original patch by Wouter Bolsterlee.bpo-34574: OrderedDict iterators are not exhausted during pickling anymore. Patch by Sergey Fedoseev.
bpo-8110: Refactored
subprocessto check for Windows-specific modules rather thansys.platform == 'win32'.bpo-34530:
distutils.spawn.find_executable()now falls back onos.defpathif thePATHenvironment variable is not set.bpo-34563: On Windows, fix multiprocessing.Connection for very large read: fix _winapi.PeekNamedPipe() and _winapi.ReadFile() for read larger than INT_MAX (usually
2**31-1).bpo-34558: Correct typo in Lib/ctypes/_aix.py
bpo-34282: Move
Enum._converttoEnumMeta._convert_and fix enum members getting shadowed by parent attributes.bpo-22872: When the queue is closed,
ValueErroris now raised bymultiprocessing.Queue.put()andmultiprocessing.Queue.get()instead ofAssertionErrorandOSError, respectively. Patch by Zackery Spytz.bpo-34515: Fix parsing non-ASCII identifiers in
lib2to3.pgen2.tokenize(PEP 3131).bpo-13312: Avoids a possible integer underflow (undefined behavior) in the time module’s year handling code when passed a very low negative year value.
bpo-34472: Improved compatibility for streamed files in
zipfile. Previously an optional signature was not being written and certain ZIP applications were not supported. Patch by Silas Sewell.bpo-34454: Fix the .fromisoformat() methods of datetime types crashing when given unicode with non-UTF-8-encodable code points. Specifically, datetime.fromisoformat() now accepts surrogate unicode code points used as the separator. Report and tests by Alexey Izbyshev, patch by Paul Ganssle.
bpo-6700: Fix inspect.getsourcelines for module level frames/tracebacks. Patch by Vladimir Matveev.
bpo-34171: Running the
tracemodule no longer creates thetrace.coverfile.bpo-34441: Fix crash when an
ABC-derived class with invalid__subclasses__is passed as the second argument toissubclass(). Patch by Alexey Izbyshev.bpo-34427: Fix infinite loop in
a.extend(a)forMutableSequencesubclasses.bpo-34412: Make
signal.strsignal()work on HP-UX. Patch by Michael Osipov.bpo-20849: shutil.copytree now accepts a new
dirs_exist_okkeyword argument. Patch by Josh Bronson.bpo-31715: Associate
.mjsfile extension withapplication/javascriptMIME Type.bpo-34384:
os.readlink()now accepts path-like andbytesobjects on Windows.bpo-22602: The UTF-7 decoder now raises
UnicodeDecodeErrorfor ill-formed sequences starting with “+” (as specified in RFC 2152). Patch by Zackery Spytz.bpo-2122: The
mmap.flush()method now returnsNoneon success, raises an exception on error under all platforms.bpo-34341: Appending to the ZIP archive with the ZIP64 extension no longer grows the size of extra fields of existing entries.
bpo-34333: Fix %-formatting in
pathlib.PurePath.with_suffix()when formatting an error message.bpo-18540: The
imaplib.IMAP4andimaplib.IMAP4_SSLclasses now resolve to the local host IP correctly when the default value of host parameter ('') is used.bpo-26502: Implement
traceback.FrameSummary.__len__()method to preserve compatibility with the old tuple API.bpo-34318:
assertRaises(),assertRaisesRegex(),assertWarns()andassertWarnsRegex()no longer success if the passed callable is None. They no longer ignore unknown keyword arguments in the context manager mode. A DeprecationWarning was raised in these cases since Python 3.5.bpo-9372: Deprecate
__getitem__()methods ofxml.dom.pulldom.DOMEventStream,wsgiref.util.FileWrapperandfileinput.FileInput.bpo-33613: Fix a race condition in
multiprocessing.semaphore_trackerwhen the tracker receives SIGINT before it can register signal handlers for ignoring it.bpo-34248: Report filename in the exception raised when the database file cannot be opened by
dbm.gnu.open()anddbm.ndbm.open()due to OS-related error. Patch by Zsolt Cserna.bpo-33089: Add math.dist() to compute the Euclidean distance between two points.
bpo-34246:
smtplib.SMTP.send_message()no longer modifies the content of the mail_options argument. Patch by Pablo S. Blum de Aguiar.bpo-31047: Fix
ntpath.abspathfor invalid paths on windows. Patch by Franz Woellert.bpo-32321: Add pure Python fallback for functools.reduce. Patch by Robert Wright.
bpo-34270: The default asyncio task class now always has a name which can be get or set using two new methods (
get_name()andset_name()) and is visible in therepr()output. An initial name can also be set using the newnamekeyword argument toasyncio.create_task()or thecreate_task()method of the event loop. If no initial name is set, the default Task implementation generates a name likeTask-1using a monotonic counter.bpo-34263: asyncio’s event loop will not pass timeouts longer than one day to epoll/select etc.
bpo-34035: Fix several AttributeError in zipfile seek() methods. Patch by Mickaël Schoentgen.
bpo-32215: Fix performance regression in
sqlite3when a DML statement appeared in a different line than the rest of the SQL query.bpo-34075: Deprecate passing non-ThreadPoolExecutor instances to
AbstractEventLoop.set_default_executor().bpo-34251: Restore
msilib.Win64to preserve backwards compatibility since it’s already used bydistutils’bdist_msicommand.bpo-19891: Ignore errors caused by missing / non-writable homedir while writing history during exit of an interactive session. Patch by Anthony Sottile.
bpo-33089: Enhanced math.hypot() to support more than two dimensions.
bpo-34228: tracemalloc: PYTHONTRACEMALLOC=0 environment variable and -X tracemalloc=0 command line option are now allowed to disable explicitly tracemalloc at startup.
bpo-13041: Use
shutil.get_terminal_size()to calculate the terminal width correctly in theargparse.HelpFormatterclass. Initial patch by Zbyszek Jędrzejewski-Szmek.bpo-34213: Allow frozen dataclasses to have a field named “object”. Previously this conflicted with an internal use of “object”.
bpo-34052:
sqlite3.Connection.create_aggregate(),sqlite3.Connection.create_function(),sqlite3.Connection.set_authorizer(),sqlite3.Connection.set_progress_handler()methods raises TypeError when unhashable objects are passed as callable. These methods now don’t pass such objects to SQLite API. Previous behavior could lead to segfaults. Patch by Sergey Fedoseev.bpo-34197: Attributes skipinitialspace, doublequote and strict of the dialect attribute of the
csvreader are nowboolinstances instead of integers 0 or 1.bpo-32788: Errors other than
TypeErrorraised in methods__adapt__()and__conform__()in thesqlite3module are now propagated to the user.bpo-21446: The
reloadfixer now usesimportlib.reload()instead of deprecatedimp.reload().bpo-940286: pydoc’s
Helper.showtopic()method now prints the cross references of a topic correctly.bpo-34164:
base64.b32decode()could raise UnboundLocalError or OverflowError for incorrect padding. Now it always raisesbase64.Errorin these cases.bpo-34097: ZipFile can zip files older than 1980-01-01 and newer than 2107-12-31 using a new
strict_timestampsparameter at the cost of setting the timestamp to the limit.bpo-34108: Remove extraneous CR in 2to3 refactor.
bpo-34070: Make sure to only check if the handle is a tty, when opening a file with
buffering=-1.bpo-27494: Reverted bpo-27494. 2to3 rejects now a trailing comma in generator expressions.
bpo-33967: functools.singledispatch now raises TypeError instead of IndexError when no positional arguments are passed.
bpo-34041: Add the parameter deterministic to the
sqlite3.Connection.create_function()method. Patch by Sergey Fedoseev.bpo-34056: Ensure the loader shim created by
imp.load_modulealways returns bytes from itsget_data()function. This fixes usingimp.load_modulewith PEP 552 hash-based pycs.bpo-34054: The multiprocessing module now uses the monotonic clock
time.monotonic()instead of the system clocktime.time()to implement timeout.bpo-34043: Optimize tarfile uncompress performance about 15% when gzip is used.
bpo-34044:
subprocess.Popennow copies the startupinfo argument to leave it unchanged: it will modify the copy, so that the sameSTARTUPINFOobject can be used multiple times.bpo-34010: Fixed a performance regression for reading streams with tarfile. The buffered read should use a list, instead of appending to a bytes object.
bpo-34019: webbrowser: Correct the arguments passed to Opera Browser when opening a new URL using the
webbrowsermodule. Patch by Bumsik Kim.bpo-34003: csv.DictReader now creates dicts instead of OrderedDicts. Patch by Michael Selik.
bpo-33978: Closed existing logging handlers before reconfiguration via fileConfig and dictConfig. Patch by Karthikeyan Singaravelan.
bpo-14117: Make minor tweaks to turtledemo. The ‘wikipedia’ example is now ‘rosette’, describing what it draws. The ‘penrose’ print output is reduced. The’1024’ output of ‘tree’ is eliminated.
bpo-33974: Fixed passing lists and tuples of strings containing special characters
",\,{,}and\nas options tottkwidgets.bpo-27500: Fix getaddrinfo to resolve IPv6 addresses correctly.
bpo-24567: Improve random.choices() to handle subnormal input weights that could occasionally trigger an IndexError.
bpo-33871: Fixed integer overflow in
os.readv(),os.writev(),os.preadv()andos.pwritev()and inos.sendfile()with headers or trailers arguments (on BSD-based OSes and macOS).bpo-25007: Add
copy.copy()andcopy.deepcopy()support to zlib compressors and decompressors. Patch by Zackery Spytz.bpo-33929: multiprocessing: Fix a race condition in Popen of multiprocessing.popen_spawn_win32. The child process now duplicates the read end of pipe instead of “stealing” it. Previously, the read end of pipe was “stolen” by the child process, but it leaked a handle if the child process had been terminated before it could steal the handle from the parent process.
bpo-33899: Tokenize module now implicitly emits a NEWLINE when provided with input that does not have a trailing new line. This behavior now matches what the C tokenizer does internally. Contributed by Ammar Askar.
bpo-33897: Added a ‘force’ keyword argument to logging.basicConfig().
bpo-33695:
shutil.copytree()usesos.scandir()function and all copy functions depending from it use cachedos.stat()values. The speedup for copying a directory with 8000 files is around +9% on Linux, +20% on Windows and + 30% on a Windows SMB share. Also the number ofos.stat()syscalls is reduced by 38% makingshutil.copytree()especially faster on network filesystems. (Contributed by Giampaolo Rodola’ in bpo-33695.)bpo-33916: bz2 and lzma: When Decompressor.__init__() is called twice, free the old lock to not leak memory.
bpo-32568: Make select.epoll() and its documentation consistent regarding sizehint and flags.
bpo-33833: Fixed bug in asyncio where ProactorSocketTransport logs AssertionError if force closed during write.
bpo-33663: Convert content length to string before putting to header.
bpo-33721:
os.pathfunctions that return a boolean result likeexists(),lexists(),isdir(),isfile(),islink(), andismount(), andpathlib.Pathmethods that return a boolean result likeexists(),is_dir(),is_file(),is_mount(),is_symlink(),is_block_device(),is_char_device(),is_fifo(),is_socket()now returnFalseinstead of raisingValueErroror its subclassesUnicodeEncodeErrorandUnicodeDecodeErrorfor paths that contain characters or bytes unrepresentable at the OS level.bpo-26544: Fixed implementation of
platform.libc_ver(). It almost always returned version ‘2.9’ for glibc.bpo-33843: Remove deprecated
cgi.escape,cgi.parse_qsandcgi.parse_qsl.bpo-33842: Remove
tarfile.filemodewhich is deprecated since Python 3.3.bpo-30167: Prevent site.main() exception if PYTHONSTARTUP is set. Patch by Steve Weber.
bpo-33805: Improve error message of dataclasses.replace() when an InitVar is not specified
bpo-33687: Fix the call to
os.chmod()foruu.decode()if a mode is given or decoded. Patch by Timo Furrer.bpo-33812: Datetime instance d with non-None tzinfo, but with d.tzinfo.utcoffset(d) returning None is now treated as naive by the astimezone() method.
bpo-32108: In configparser, don’t clear section when it is assigned to itself.
bpo-27397: Make email module properly handle invalid-length base64 strings.
bpo-33578: Implement multibyte encoder/decoder state methods
bpo-30805: Avoid race condition with debug logging
bpo-33476: Fix _header_value_parser.py when address group is missing final ‘;’. Contributed by Enrique Perez-Terron
bpo-33694: asyncio: Fix a race condition causing data loss on pause_reading()/resume_reading() when using the ProactorEventLoop.
bpo-32493: Correct test for
uuid_enc_beavailability inconfigure.ac. Patch by Michael Felt.bpo-33792: Add asyncio.WindowsSelectorEventLoopPolicy and asyncio.WindowsProactorEventLoopPolicy.
bpo-33274: W3C DOM Level 1 specifies return value of Element.removeAttributeNode() as “The Attr node that was removed.” xml.dom.minidom now complies with this requirement.
bpo-33778: Update
unicodedata’s database to Unicode version 11.0.0.bpo-33165: Added a stacklevel parameter to logging calls to allow use of wrapper/helper functions for logging APIs.
bpo-33770: improve base64 exception message for encoded inputs of invalid length
bpo-33769: asyncio/start_tls: Fix error message; cancel callbacks in case of an unhandled error; mark SSLTransport as closed if it is aborted.
bpo-33767: The concatenation (
+) and repetition (*) sequence operations now raiseTypeErrorinstead ofSystemErrorwhen performed onmmap.mmapobjects. Patch by Zackery Spytz.bpo-33734: asyncio/ssl: Fix AttributeError, increase default handshake timeout
bpo-31014: Fixed creating a controller for
webbrowserwhen a user specifies a path to an entry in the BROWSER environment variable. Based on patch by John Still.bpo-2504: Add gettext.pgettext() and variants.
bpo-33197: Add description property for _ParameterKind
bpo-32751: When cancelling the task due to a timeout,
asyncio.wait_for()will now wait until the cancellation is complete.bpo-32684: Fix gather to propagate cancellation of itself even with return_exceptions.
bpo-33654: Support protocol type switching in SSLTransport.set_protocol().
bpo-33674: Pause the transport as early as possible to further reduce the risk of data_received() being called before connection_made().
bpo-33671:
shutil.copyfile(),shutil.copy(),shutil.copy2(),shutil.copytree()andshutil.move()use platform-specific fast-copy syscalls on Linux and macOS in order to copy the file more efficiently. On Windowsshutil.copyfile()uses a bigger default buffer size (1 MiB instead of 16 KiB) and amemoryview()-based variant ofshutil.copyfileobj()is used. The speedup for copying a 512MiB file is about +26% on Linux, +50% on macOS and +40% on Windows. Also, much less CPU cycles are consumed. (Contributed by Giampaolo Rodola’ in bpo-25427.)bpo-33674: Fix a race condition in SSLProtocol.connection_made() of asyncio.sslproto: start immediately the handshake instead of using call_soon(). Previously, data_received() could be called before the handshake started, causing the handshake to hang or fail.
bpo-31647: Fixed bug where calling write_eof() on a _SelectorSocketTransport after it’s already closed raises AttributeError.
bpo-32610: Make asyncio.all_tasks() return only pending tasks.
bpo-32410: Avoid blocking on file IO in sendfile fallback code
bpo-33469: Fix RuntimeError after closing loop that used run_in_executor
bpo-33672: Fix Task.__repr__ crash with Cython’s bogus coroutines
bpo-33654: Fix transport.set_protocol() to support switching between asyncio.Protocol and asyncio.BufferedProtocol. Fix loop.start_tls() to work with asyncio.BufferedProtocols.
bpo-33652: Pickles of type variables and subscripted generics are now future-proof and compatible with older Python versions.
bpo-32493: Fixed
uuid.uuid1()on FreeBSD.bpo-33238: Add
InvalidStateErrortoconcurrent.futures.Future.set_resultandFuture.set_exceptionnow raiseInvalidStateErrorif the futures are not pending or running. Patch by Jason Haydaman.bpo-33618: Finalize and document preliminary and experimental TLS 1.3 support with OpenSSL 1.1.1
bpo-33625: Release GIL on
grp.getgrnam,grp.getgrgid,pwd.getpwnamandpwd.getpwuidif reentrant variants of these functions are available. Patch by William Grzybowski.bpo-33623: Fix possible SIGSGV when asyncio.Future is created in __del__
bpo-11874: Use a better regex when breaking usage into wrappable parts. Avoids bogus assertion errors from custom metavar strings.
bpo-30877: Fixed a bug in the Python implementation of the JSON decoder that prevented the cache of parsed strings from clearing after finishing the decoding. Based on patch by c-fos.
bpo-33604: Remove HMAC default to md5 marked for removal in 3.8 (removal originally planned in 3.6, bump to 3.8 in PR 7062).
bpo-33582: Emit a deprecation warning for inspect.formatargspec
bpo-21145: Add
functools.cached_propertydecorator, for computed properties cached for the life of the instance.bpo-33570: Change TLS 1.3 cipher suite settings for compatibility with OpenSSL 1.1.1-pre6 and newer. OpenSSL 1.1.1 will have TLS 1.3 ciphers enabled by default.
bpo-28556: Do not simplify arguments to
typing.Union. NowUnion[Manager, Employee]is not simplified toEmployeeat runtime. Such simplification previously caused several bugs and limited possibilities for introspection.bpo-12486:
tokenize.generate_tokens()is now documented as a public API to tokenize unicode strings. It was previously present but undocumented.bpo-33540: Add a new
block_on_closeclass attribute toForkingMixInandThreadingMixInclasses ofsocketserver.bpo-33548: tempfile._candidate_tempdir_list should consider common TEMP locations
bpo-33109: argparse subparsers are once again not required by default, reverting the change in behavior introduced by bpo-26510 in 3.7.0a2.
bpo-33541: Remove unused private method
_strptime.LocaleTime.__pad(a.k.a._LocaleTime__pad).bpo-33536: dataclasses.make_dataclass now checks for invalid field names and duplicate fields. Also, added a check for invalid field specifications.
bpo-33542: Prevent
uuid.get_nodefrom using a DUID instead of a MAC on Windows. Patch by Zvi Effronbpo-26819: Fix race condition with
ReadTransport.resume_readingin Windows proactor event loop.Fix failure in
typing.get_type_hints()when ClassVar was provided as a string forward reference.bpo-33516:
unittest.mock.MagicMocknow supports the__round__magic method.bpo-28612: Added support for Site Maps to urllib’s
RobotFileParserasRobotFileParser.site_maps(). Patch by Lady Red, based on patch by Peter Wirtz.bpo-28167: Remove platform.linux_distribution, which was deprecated since 3.5.
bpo-33504: Switch the default dictionary implementation for
configparserfromcollections.OrderedDictto the standarddicttype.bpo-33505: Optimize asyncio.ensure_future() by reordering if checks: 1.17x faster.
bpo-33497: Add errors param to cgi.parse_multipart and make an encoding in FieldStorage use the given errors (needed for Twisted). Patch by Amber Brown.
bpo-29235: The
cProfile.Profileclass can now be used as a context manager. Patch by Scott Sanderson.bpo-33495: Change dataclasses.Fields repr to use the repr of each of its members, instead of str. This makes it more clear what each field actually represents. This is especially true for the ‘type’ member.
bpo-26103: Correct
inspect.isdatadescriptorto look for__set__or__delete__. Patch by Aaron Hall.bpo-29209: Removed the
doctype()method and the html parameter of the constructor ofXMLParser. Thedoctype()method defined in a subclass will no longer be called. Deprecated methodsgetchildren()andgetiterator()in theElementTreemodule emit now aDeprecationWarninginstead ofPendingDeprecationWarning.bpo-33453: Fix dataclasses to work if using literal string type annotations or if using PEP 563 “Postponed Evaluation of Annotations”. Only specific string prefixes are detected for both ClassVar (“ClassVar” and “typing.ClassVar”) and InitVar (“InitVar” and “dataclasses.InitVar”).
bpo-28556: Minor fixes in typing module: add annotations to
NamedTuple.__new__, pass*argsand**kwdsinGeneric.__new__. Original PRs by Paulius Šarka and Chad Dombrova.bpo-33365: Print the header values besides the header keys instead just the header keys if debuglevel is set to >0 in
http.client. Patch by Marco Strigl.bpo-20087: Updated alias mapping with glibc 2.27 supported locales.
bpo-33422: Fix trailing quotation marks getting deleted when looking up byte/string literals on pydoc. Patch by Andrés Delfino.
bpo-28167: The function
platform.linux_distributionandplatform.distnow trigger aDeprecationWarningand have been marked for removal in Python 3.8bpo-33281: Fix ctypes.util.find_library regression on macOS.
bpo-33311: Text and html output generated by cgitb does not display parentheses if the current call is done directly in the module. Patch by Stéphane Blondon.
bpo-27300: The file classes in tempfile now accept an errors parameter that complements the already existing encoding. Patch by Stephan Hohe.
bpo-32933:
unittest.mock.mock_open()now supports iteration over the file contents. Patch by Tony Flury.bpo-33217: Raise
TypeErrorwhen looking up non-Enum objects in Enum classes and Enum members.bpo-33197: Update error message when constructing invalid inspect.Parameters Patch by Dong-hee Na.
bpo-33383: Fixed crash in the get() method of the
dbm.ndbmdatabase object when it is called with a single argument.bpo-33375: The warnings module now finds the Python file associated with a warning from the code object, rather than the frame’s global namespace. This is consistent with how tracebacks and pdb find filenames, and should work better for dynamically executed code.
bpo-33336:
imaplibnow allowsMOVEcommand inIMAP4.uid()(RFC 6851: IMAP MOVE Extension) and potentially as a name of supported method ofIMAP4object.bpo-32455: Added jump parameter to
dis.stack_effect().bpo-27485: Rename and deprecate undocumented functions in
urllib.parse().bpo-33332: Add
signal.valid_signals()to expose the POSIX sigfillset() functionality.bpo-33251:
ConfigParser.items()was fixed so that key-value pairs passed in viavarsare not included in the resulting output.bpo-33329: Fix multiprocessing regression on newer glibcs
bpo-33334:
dis.stack_effect()now supports all defined opcodes including NOP and EXTENDED_ARG.bpo-991266: Fix quoting of the
Commentattribute ofhttp.cookies.SimpleCookie.bpo-33131: Upgrade bundled version of pip to 10.0.1.
bpo-33308: Fixed a crash in the
parsermodule when converting an ST object to a tree of tuples or lists withline_info=Falseandcol_info=True.bpo-23403: lib2to3 now uses pickle protocol 4 for pre-computed grammars.
bpo-33266: lib2to3 now recognizes
rf'...'strings.bpo-11594: Ensure line-endings are respected when using lib2to3.
bpo-33254: Have
importlib.resources.contents()andimportlib.abc.ResourceReader.contents()return an iterable instead of an iterator.bpo-33265:
contextlib.ExitStackandcontextlib.AsyncExitStacknow use a method instead of a wrapper function for exit callbacks.bpo-33263: Fix FD leak in
_SelectorSocketTransportPatch by Vlad Starostin.bpo-33256: Fix display of
<module>call in the html produced bycgitb.html(). Patch by Stéphane Blondon.bpo-33144:
random.Random()and its subclassing mechanism got optimized to check only once at class/subclass instantiation time whether itsgetrandbits()method can be relied on by other methods, includingrandrange(), for the generation of arbitrarily large random integers. Patch by Wolfgang Maier.bpo-33185: Fixed regression when running pydoc with the
-mswitch. (The regression was introduced in 3.7.0b3 by the resolution of bpo-33053)This fix also changed pydoc to add
os.getcwd()tosys.pathwhen necessary, rather than adding".".bpo-29613: Added support for the
SameSitecookie flag to thehttp.cookiesmodule.bpo-33169: Delete entries of
Noneinsys.path_importer_cachewhenimportlib.machinery.invalidate_caches()is called.bpo-33203:
random.Random.choice()now raisesIndexErrorfor empty sequences consistently even when called from subclasses without agetrandbits()implementation.bpo-33224: Update difflib.mdiff() for PEP 479. Convert an uncaught StopIteration in a generator into a return-statement.
bpo-33209: End framing at the end of C implementation of
pickle.Pickler.dump().bpo-32861: The urllib.robotparser’s
__str__representation now includes wildcard entries and the “Crawl-delay” and “Request-rate” fields. Also removes extra newlines that were being appended to the end of the string. Patch by Michael Lazar.bpo-23403:
DEFAULT_PROTOCOLinpicklewas bumped to 4. Protocol 4 is described in PEP 3154 and available since Python 3.4. It offers better performance and smaller size compared to protocol 3 introduced in Python 3.0.bpo-20104: Improved error handling and fixed a reference leak in
os.posix_spawn().bpo-33106: Deleting a key from a read-only dbm database raises module specific error instead of KeyError.
bpo-33175: In dataclasses, Field.__set_name__ now looks up the __set_name__ special method on the class, not the instance, of the default value.
bpo-32380: Create functools.singledispatchmethod to support generic single dispatch on descriptors and methods.
bpo-33141: Have Field objects pass through __set_name__ to their default values, if they have their own __set_name__.
bpo-33096: Allow ttk.Treeview.insert to insert iid that has a false boolean value. Note iid=0 and iid=False would be same. Patch by Garvit Khatri.
bpo-32873: Treat type variables and special typing forms as immutable by copy and pickle. This fixes several minor issues and inconsistencies, and improves backwards compatibility with Python 3.6.
bpo-33134: When computing dataclass’s __hash__, use the lookup table to contain the function which returns the __hash__ value. This is an improvement over looking up a string, and then testing that string to see what to do.
bpo-33127: The ssl module now compiles with LibreSSL 2.7.1.
bpo-32505: Raise TypeError if a member variable of a dataclass is of type Field, but doesn’t have a type annotation.
bpo-33078: Fix the failure on OSX caused by the tests relying on sem_getvalue
bpo-33116: Add ‘Field’ to dataclasses.__all__.
bpo-32896: Fix an error where subclassing a dataclass with a field that uses a default_factory would generate an incorrect class.
bpo-33100: Dataclasses: If a field has a default value that’s a MemberDescriptorType, then it’s from that field being in __slots__, not an actual default value.
bpo-32953: If a non-dataclass inherits from a frozen dataclass, allow attributes to be added to the derived class. Only attributes from the frozen dataclass cannot be assigned to. Require all dataclasses in a hierarchy to be either all frozen or all non-frozen.
bpo-33097: Raise RuntimeError when
executor.submitis called during interpreter shutdown.bpo-32968: Modulo and floor division involving Fraction and float should return float.
bpo-33061: Add missing
NoReturnto__all__in typing.pybpo-33078: Fix the size handling in multiprocessing.Queue when a pickling error occurs.
bpo-33064: lib2to3 now properly supports trailing commas after
*argsand**kwargsin function signatures.bpo-33056: FIX properly close leaking fds in concurrent.futures.ProcessPoolExecutor.
bpo-33021: Release the GIL during fstat() calls, avoiding hang of all threads when calling mmap.mmap(), os.urandom(), and random.seed(). Patch by Nir Soffer.
bpo-31804: Avoid failing in multiprocessing.Process if the standard streams are closed or None at exit.
bpo-33034: Providing an explicit error message when casting the port property to anything that is not an integer value using
urlparse()andurlsplit(). Patch by Matt Eaton.bpo-30249: Improve struct.unpack_from() exception messages for problems with the buffer size and offset.
bpo-33037: Skip sending/receiving data after SSL transport closing.
bpo-27683: Fix a regression in
ipaddressthat result ofhosts()is empty when the network is constructed by a tuple containing an integer mask and only 1 bit left for addresses.bpo-22674: Add the strsignal() function in the signal module that returns the system description of the given signal, as returned by strsignal(3).
bpo-32999: Fix C implementation of
ABC.__subclasscheck__(cls, subclass)crashed whensubclassis not a type object.bpo-33009: Fix inspect.signature() for single-parameter partialmethods.
bpo-32969: Expose several missing constants in zlib and fix corresponding documentation.
bpo-32056: Improved exceptions raised for invalid number of channels and sample width when read an audio file in modules
aifc,waveandsunau.bpo-32970: Improved disassembly of the MAKE_FUNCTION instruction.
bpo-32844: Fix wrong redirection of a low descriptor (0 or 1) to stderr in subprocess if another low descriptor is closed.
bpo-32960: For dataclasses, disallow inheriting frozen from non-frozen classes, and also disallow inheriting non-frozen from frozen classes. This restriction will be relaxed at a future date.
bpo-32713: Fixed tarfile.itn handling of out-of-bounds float values. Patch by Joffrey Fuhrer.
bpo-32257: The ssl module now contains OP_NO_RENEGOTIATION constant, available with OpenSSL 1.1.0h or 1.1.1.
bpo-32951: Direct instantiation of SSLSocket and SSLObject objects is now prohibited. The constructors were never documented, tested, or designed as public constructors. Users were suppose to use ssl.wrap_socket() or SSLContext.
bpo-32929: Remove the tri-state parameter “hash”, and add the boolean “unsafe_hash”. If unsafe_hash is True, add a __hash__ function, but if a __hash__ exists, raise TypeError. If unsafe_hash is False, add a __hash__ based on the values of eq= and frozen=. The unsafe_hash=False behavior is the same as the old hash=None behavior. unsafe_hash=False is the default, just as hash=None used to be.
bpo-32947: Add OP_ENABLE_MIDDLEBOX_COMPAT and test workaround for TLSv1.3 for future compatibility with OpenSSL 1.1.1.
bpo-32146: Document the interaction between frozen executables and the spawn and forkserver start methods in multiprocessing.
bpo-30622: The ssl module now detects missing NPN support in LibreSSL.
bpo-32922: dbm.open() now encodes filename with the filesystem encoding rather than default encoding.
bpo-32759: Free unused arenas in multiprocessing.heap.
bpo-32859: In
os.dup2, don’t check every call whether thedup3syscall exists or not.bpo-32556: nt._getfinalpathname, nt._getvolumepathname and nt._getdiskusage now correctly convert from bytes.
bpo-21060: Rewrite confusing message from setup.py upload from “No dist file created in earlier command” to the more helpful “Must create and upload files in one command”.
bpo-32857: In
tkinter,after_cancel(None)now raises aValueErrorinstead of canceling the first scheduled function. Patch by Cheryl Sabella.bpo-32852: Make sure sys.argv remains as a list when running trace.
bpo-31333:
_abcmodule is added. It is a speedup module with C implementations for various functions and methods inabc. Creating an ABC subclass and callingisinstanceorissubclasswith an ABC subclass are up to 1.5x faster. In addition, this makes Python start-up up to 10% faster.Note that the new implementation hides internal registry and caches, previously accessible via private attributes
_abc_registry,_abc_cache, and_abc_negative_cache. There are three debugging helper methods that can be used instead_dump_registry,_abc_registry_clear, and_abc_caches_clear.bpo-32841: Fixed
asyncio.Conditionissue which silently ignored cancellation after notifying and cancelling a conditional lock. Patch by Bar Harel.bpo-32819: ssl.match_hostname() has been simplified and no longer depends on re and ipaddress module for wildcard and IP addresses. Error reporting for invalid wildcards has been improved.
bpo-19675:
multiprocessing.Poolno longer leaks processes if its initialization fails.bpo-32394: socket: Remove TCP_FASTOPEN,TCP_KEEPCNT,TCP_KEEPIDLE,TCP_KEEPINTVL flags on older version Windows during run-time.
bpo-31787: Fixed refleaks of
__init__()methods in various modules. (Contributed by Oren Milman)bpo-30157: Fixed guessing quote and delimiter in csv.Sniffer.sniff() when only the last field is quoted. Patch by Jake Davis.
bpo-30688: Added support of
\N{name}escapes in regular expressions. Based on patch by Jonathan Eunice.bpo-32792: collections.ChainMap() preserves the order of the underlying mappings.
bpo-32775:
fnmatch.translate()no longer produces patterns which contain set operations. Sets starting with ‘[’ or containing ‘–’, ‘&&’, ‘~~’ or ‘||’ will be interpreted differently in regular expressions in future versions. Currently they emit warnings. fnmatch.translate() now avoids producing patterns containing such sets by accident.bpo-32622: Implement native fast sendfile for Windows proactor event loop.
bpo-32777: Fix a rare but potential pre-exec child process deadlock in subprocess on POSIX systems when marking file descriptors inheritable on exec in the child process. This bug appears to have been introduced in 3.4.
bpo-32647: The ctypes module used to depend on indirect linking for dlopen. The shared extension is now explicitly linked against libdl on platforms with dl.
bpo-32749: A
dbm.dumbdatabase opened with flags ‘r’ is now read-only.dbm.dumb.open()with flags ‘r’ and ‘w’ no longer creates a database if it does not exist.bpo-32741: Implement
asyncio.TimerHandle.when()method.bpo-32691: Use mod_spec.parent when running modules with pdb
bpo-32734: Fixed
asyncio.Lock()safety issue which allowed acquiring and locking the same lock multiple times, without it being free. Patch by Bar Harel.bpo-32727: Do not include name field in SMTP envelope from address. Patch by Stéphane Wirtel
bpo-31453: Add TLSVersion constants and SSLContext.maximum_version / minimum_version attributes. The new API wraps OpenSSL 1.1 https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_set_min_proto_version.html feature.
bpo-24334: Internal implementation details of ssl module were cleaned up. The SSLSocket has one less layer of indirection. Owner and session information are now handled by the SSLSocket and SSLObject constructor. Channel binding implementation has been simplified.
bpo-31848: Fix the error handling in Aifc_read.initfp() when the SSND chunk is not found. Patch by Zackery Spytz.
bpo-32585: Add Ttk spinbox widget to
tkinter.ttk. Patch by Alan D Moore.bpo-32512:
profileCLI accepts-m module_nameas an alternative to script path.bpo-8525: help() on a type now displays builtin subclasses. This is intended primarily to help with notification of more specific exception subclasses.
Patch by Sanyam Khurana.
bpo-31639: http.server now exposes a ThreadingHTTPServer class and uses it when the module is run with
-mto cope with web browsers pre-opening sockets.bpo-29877: compileall: import ProcessPoolExecutor only when needed, preventing hangs on low resource platforms
bpo-32221: Various functions returning tuple containing IPv6 addresses now omit
%scopepart since the same information is already encoded in scopeid tuple item. Especially this speeds upsocket.recvfrom()when it receives multicast packet since useless resolving of network interface name is omitted.bpo-32147:
binascii.unhexlify()is now up to 2 times faster. Patch by Sergey Fedoseev.bpo-30693: The TarFile class now recurses directories in a reproducible way.
bpo-30693: The ZipFile class now recurses directories in a reproducible way.
bpo-31680: Added
curses.ncurses_version.bpo-31908: Fix output of cover files for
tracemodule command-line tool. Previously emitted cover files only when--missingoption was used. Patch by Michael Selik.bpo-31608: Raise a
TypeErrorinstead of crashing if acollections.dequesubclass returns a non-deque from__new__. Patch by Oren Milman.bpo-31425: Add support for sockets of the AF_QIPCRTR address family, supported by the Linux kernel. This is used to communicate with services, such as GPS or radio, running on Qualcomm devices. Patch by Bjorn Andersson.
bpo-22005: Implemented unpickling instances of
datetime,dateandtimepickled by Python 2.encoding='latin1'should be used for successful decoding.bpo-27645:
sqlite3.Connectionnow exposes abackupmethod, if the underlying SQLite library is at version 3.6.11 or higher. Patch by Lele Gaifax.bpo-16865: Support arrays >=2GiB in
ctypes. Patch by Segev Finer.bpo-31508: Removed support of arguments in
tkinter.ttk.Treeview.selection. It was deprecated in 3.6. Use specialized methods likeselection_setfor changing the selection.bpo-29456: Fix bugs in hangul normalization: u1176, u11a7 and u11c3
Documentation¶
bpo-21257: Document
http.client.parse_headers().bpo-34764: Improve example of iter() with 2nd sentinel argument.
bpo-35564: Explicitly set master_doc variable in conf.py for compliance with Sphinx 2.0
bpo-35511: Specified that profile.Profile class doesn’t not support enable or disable methods. Also, elaborated that Profile object as a context manager is only supported in cProfile module.
bpo-10536: Enhance the gettext docs. Patch by Éric Araujo
bpo-35089: Remove mention of
typing.ioandtyping.re. Their types should be imported fromtypingdirectly.bpo-35038: Fix the documentation about an unexisting
f_restrictedattribute in the frame object. Patch by Stéphane Wirtelbpo-35042: Replace PEP XYZ by the pep role and allow to use the direct links to the PEPs.
bpo-35044: Fix the documentation with the role
excfor the appropriated exception. Patch by Stéphane Wirtelbpo-35035: Rename documentation for
email.utilstoemail.utils.rst.bpo-34967: Use app.add_object_type() instead of the deprecated Sphinx function app.description_unit()
bpo-34913: Add documentation about the new command line interface of the gzip module.
bpo-32174: chm document displays non-ASCII charaters properly on some MBCS Windows systems.
bpo-11233: Create availability directive for documentation. Original patch by Georg Brandl.
bpo-34790: Document how passing coroutines to asyncio.wait() can be confusing.
bpo-34552: Make clear that
==operator sometimes is equivalent tois. The<,<=,>and>=operators are only defined where they make sense.bpo-28617: Fixed info in the stdtypes docs concerning the types that support membership tests.
bpo-20177: Migrate datetime.date.fromtimestamp to Argument Clinic. Patch by Tim Hoffmann.
bpo-34065: Fix wrongly written basicConfig documentation markup syntax
bpo-33460: replaced ellipsis with correct error codes in tutorial chapter 3.
bpo-33847: Add ‘@’ operator entry to index.
bpo-33409: Clarified the relationship between PEP 538’s PYTHONCOERCECLOCALE and PEP 540’s PYTHONUTF8 mode.
bpo-33197: Add versionadded tag to the documentation of ParameterKind.description
bpo-17045: Improve the C-API doc for PyTypeObject. This includes adding several quick-reference tables and a lot of missing slot/typedef entries. The existing entries were also cleaned up with a slightly more consistent format.
bpo-33736: Improve the documentation of
asyncio.open_connection(),asyncio.start_server()and their UNIX socket counterparts.bpo-23859: Document that
asyncio.wait()does not cancel its futures on timeout.bpo-33604: Update HMAC md5 default to a DeprecationWarning, bump removal to 3.8.
bpo-33594: Document
getargspec,from_functionandfrom_builtinas deprecated in their respective docstring, and include version since deprecation in DeprecationWarning message.bpo-33503: Fix broken pypi link
bpo-33421: Add missing documentation for
typing.AsyncContextManager.bpo-33487: BZ2file now emit a DeprecationWarning when buffering=None is passed, the deprecation message and documentation also now explicitly state it is deprecated since 3.0.
bpo-33378: Add Korean language switcher for https://docs.python.org/3/
bpo-33276: Clarify that the
__path__attribute on modules cannot be just any value.bpo-33201: Modernize documentation for writing C extension types.
bpo-33195: Deprecate
Py_UNICODEusage inc-api/argdocument.Py_UNICODErelated APIs are deprecated since Python 3.3, but it is missed in the document.bpo-33126: Document PyBuffer_ToContiguous().
bpo-27212: Modify documentation for the
islice()recipe to consume initial values up to the start index.bpo-28247: Update
zipappdocumentation to describe how to make standalone applications.bpo-18802: Documentation changes for ipaddress. Patch by Jon Foster and Berker Peksag.
bpo-27428: Update documentation to clarify that
WindowsRegistryFinderimplementsMetaPathFinder. (Patch by Himanshu Lakhara)bpo-28124: The ssl module function ssl.wrap_socket() has been de-emphasized and deprecated in favor of the more secure and efficient SSLContext.wrap_socket() method.
bpo-17232: Clarify docs for -O and -OO. Patch by Terry Reedy.
bpo-32436: Add documentation for the contextvars module (PEP 567).
bpo-32800: Update link to w3c doc for xml default namespaces.
bpo-11015: Update
test.supportdocumentation.bpo-32613: Update the faq/windows.html to use the py command from PEP 397 instead of python.
bpo-8722: Document
__getattr__()behavior when propertyget()method raisesAttributeError.bpo-32614: Modify RE examples in documentation to use raw strings to prevent
DeprecationWarningand add text to REGEX HOWTO to highlight the deprecation.bpo-20709: Remove the paragraph where we explain that os.utime() does not support a directory as path under Windows. Patch by Jan-Philip Gehrcke
bpo-32722: Remove the bad example in the tutorial of the Generator Expression. Patch by Stéphane Wirtel
bpo-31972: Improve docstrings for
pathlib.PurePathsubclasses.bpo-30607: Use the externalized
python-docs-themepackage when building the documentation.bpo-8243: Add a note about curses.addch and curses.addstr exception behavior when writing outside a window, or pad.
bpo-32337: Update documentation related with
dictorder.bpo-31432: Clarify meaning of CERT_NONE, CERT_OPTIONAL, and CERT_REQUIRED flags for ssl.SSLContext.verify_mode.
Tests¶
bpo-35772: Fix sparse file tests of test_tarfile on ppc64 with the tmpfs filesystem. Fix the function testing if the filesystem supports sparse files: create a file which contains data and “holes”, instead of creating a file which contains no data. tmpfs effective block size is a page size (tmpfs lives in the page cache). RHEL uses 64 KiB pages on aarch64, ppc64, ppc64le, only s390x and x86_64 use 4 KiB pages, whereas the test punch holes of 4 KiB.
bpo-35045: Make ssl tests less strict and also accept TLSv1 as system default. The changes unbreaks test_min_max_version on Fedora 29.
bpo-32710:
test_asyncio/test_sendfile.pynow resets the event loop policy usingtearDownModule()as done in other tests, to prevent a warning when running tests on Windows.bpo-33717: test.pythoninfo now logs information of all clocks, not only time.time() and time.perf_counter().
bpo-35488: Add a test to pathlib’s Path.match() to verify it does not support glob-style ** recursive pattern matching.
bpo-31731: Fix a race condition in
check_interrupted_write()of test_io: create directly the thread with SIGALRM signal blocked, rather than blocking the signal later from the thread. Previously, it was possible that the thread gets the signal before the signal is blocked.bpo-35424: Fix test_multiprocessing_main_handling: use
multiprocessing.Poolwith a context manager and then explicitly join the pool.bpo-35519: Rename
test.bisectmodule totest.bisect_cmdto avoid conflict withbisectmodule when running directly a test like./python Lib/test/test_xmlrpc.py.bpo-35513: Replace
time.time()withtime.monotonic()in tests to measure time delta.bpo-34279:
test.support.run_unittest()no longer raiseTestDidNotRunif the test result contains skipped tests. The exception is now only raised if no test have been run and no test have been skipped.bpo-35412: Add testcase to
test_future4: check unicode literal.bpo-26704: Added test demonstrating double-patching of an instance method. Patch by Anthony Sottile.
bpo-33725: test_multiprocessing_fork may crash on recent versions of macOS. Until the issue is resolved, skip the test on macOS.
bpo-35352: Modify test_asyncio to use the certificate set from the test directory.
bpo-35317: Fix
mktime()overflow error intest_email: runtest_localtime_daylight_true_dst_true()andtest_localtime_daylight_false_dst_true()with a specific timezone.bpo-21263: After several reports that test_gdb does not work properly on macOS and since gdb is not shipped by default anymore, test_gdb is now skipped on macOS when LLVM Clang has been used to compile Python. Patch by Lysandros Nikolaou
bpo-34279: regrtest issue a warning when no tests have been executed in a particular test file. Also, a new final result state is issued if no test have been executed across all test files. Patch by Pablo Galindo.
bpo-34962: make docstest in Doc now passes., and is enforced in CI
bpo-23596: Use argparse for the command line of the gzip module. Patch by Antony Lee
bpo-34537: Fix
test_gdb.test_strings()whenLC_ALL=Cand GDB was compiled with Python 3.6 or earlier.bpo-34587: test_socket: Remove RDSTest.testCongestion(). The test tries to fill the receiver’s socket buffer and expects an error. But the RDS protocol doesn’t require that. Moreover, the Linux implementation of RDS expects that the producer of the messages reduces its rate, it’s not the role of the receiver to trigger an error. The test fails on Fedora 28 by design, so just remove it.
bpo-34661: Fix test_shutil if unzip doesn’t support -t.
bpo-34200: Fixed non-deterministic flakiness of test_pkg by not using the scary test.support.module_cleanup() logic to save and restore sys.modules contents between test cases.
bpo-34569: The experimental PEP 554 data channels now correctly pass negative PyLong objects between subinterpreters on 32-bit systems. Patch by Michael Felt.
bpo-34594: Fix usage of hardcoded
errnovalues in the tests.bpo-34579: Fix test_embed for AIX Patch by Michael Felt
bpo-34542: Use 3072 RSA keys and SHA-256 signature for test certs and keys.
bpo-11193: Remove special condition for AIX in
test_subprocess.test_undecodable_envbpo-34347: Fix
test_utf8_mode.test_cmd_linefor AIXbpo-34490: On AIX with AF_UNIX family sockets getsockname() does not provide ‘sockname’, so skip calls to transport.get_extra_info(‘sockname’)
bpo-34391: Fix ftplib test for TLS 1.3 by reading from data socket.
bpo-11192: Fix
test_socketon AIX 6.1 and later IPv6 zone id supports only supported by inet_pton6_zone() Switch to runtime-based platform.system() to establish current platform rather than build-time based sys.platform()bpo-34399: Update all RSA keys and DH params to use at least 2048 bits.
bpo-34373: Fix
test_mktimeandtest_pthread_getcpuclickidtests for AIX Add range checking for_PyTime_localtimefor AIX Patch by Michael Feltbpo-11191: Skip the distutils test ‘test_search_cpp’ when using XLC as compiler patch by aixtools (Michael Felt)
Improved an error message when mock assert_has_calls fails.
bpo-33746: Fix test_unittest when run in verbose mode.
bpo-33901: Fix test_dbm_gnu on macOS with gdbm 1.15: add a larger value to make sure that the file size changes.
bpo-33873: Fix a bug in
regrtestthat caused an extra test to run if –huntrleaks/-R was used. Exit with error in case that invalid parameters are specified to –huntrleaks/-R (at least one warmup run and one repetition must be used).bpo-33562: Check that a global asyncio event loop policy is not left behind by any tests.
bpo-33655: Ignore test_posix_fallocate failures on BSD platforms that might be due to running on ZFS.
bpo-32962: Fixed test_gdb when Python is compiled with flags -mcet -fcf-protection -O0.
bpo-33358: Fix
test_embed.test_pre_initialization_sys_options()when the interpreter is built with--enable-shared.bpo-32872: Avoid regrtest compatibility issue with namespace packages.
bpo-32517: Fix failing
test_asyncioon macOS 10.12.2+ due to transport ofKqueueSelectorloop was not being closed.bpo-32663: Making sure the
SMTPUTF8SimTestsclass of tests gets run in test_smtplib.py.bpo-27643: Test_C test case needs “signed short” bitfields, but the IBM XLC compiler (on AIX) does not support this Skip the code and test when AIX and XLC are used
Applicable to Python2-2.7 and later
bpo-19417: Add test_bdb.py.
bpo-31809: Add tests to verify connection with secp ECDH curves.
Build¶
bpo-34691: The _contextvars module is now built into the core Python library on Windows.
bpo-35683: Improved Azure Pipelines build steps and now verifying layouts correctly
bpo-35642: Remove asynciomodule.c from pythoncore.vcxproj
bpo-35550: Fix incorrect Solaris #ifdef checks to look for __sun && __SVR4 instead of sun when compiling.
bpo-35499:
make profile-optno longer replacesCFLAGS_NODISTwithCFLAGS. It now adds profile-guided optimization (PGO) flags toCFLAGS_NODIST: existingCFLAGS_NODISTflags are kept.bpo-35257: Avoid leaking the linker flags from Link Time Optimizations (LTO) into distutils when compiling C extensions.
bpo-35351: When building Python with clang and LTO, LTO flags are no longer passed into CFLAGS to build third-party C extensions through distutils.
bpo-35139: Fix a compiler error when statically linking
pyexpatinModules/Setup.bpo-35059: PCbuild: Set InlineFunctionExpansion to OnlyExplicitInline (“/Ob1” option) in pyproject.props in Debug mode to expand functions marked as inline. This change should make Python compiled in Debug mode a little bit faster on Windows.
bpo-35011: Restores the use of pyexpatns.h to isolate our embedded copy of the expat C library so that its symbols do not conflict at link or dynamic loading time with an embedding application or other extension modules with their own version of libexpat.
bpo-28015: Have –with-lto works correctly with clang.
bpo-34765: Update the outdated install-sh file to the latest revision from automake v1.16.1
bpo-34585: Check for floating-point byte order in configure.ac using compilation tests instead of executing code, so that these checks work in cross-compiled builds.
bpo-34710: Fixed SSL module build with OpenSSL & pedantic CFLAGS.
bpo-34582: Add JUnit XML output for regression tests and update Azure DevOps builds.
bpo-34081: Make Sphinx warnings as errors in the Docs Makefile.
bpo-34555: Fix for case where it was not possible to have both
HAVE_LINUX_VM_SOCKETS_HandHAVE_SOCKADDR_ALGbe undefined.bpo-33015: Fix an undefined behaviour in the pthread implementation of
PyThread_start_new_thread(): add a function wrapper to always returnNULL.bpo-34245: The Python shared library is now installed with write permission (mode 0755), which is the standard way of installing such libraries.
bpo-34121: Fix detection of C11 atomic support on clang.
bpo-32430: Rename Modules/Setup.dist to Modules/Setup, and remove the necessity to copy the former manually to the latter when updating the local source tree.
bpo-30345: Add -g to LDFLAGS when compiling with LTO to get debug symbols.
bpo-5755: Move
-Wstrict-prototypesoption toCFLAGS_NODISTfromOPT. This option emitted annoying warnings when building extension modules written in C++.bpo-33614: Ensures module definition files for the stable ABI on Windows are correctly regenerated.
bpo-33648: The –with-c-locale-warning configuration flag has been removed. It has had no effect for about a year.
bpo-33522: Enable CI builds on Visual Studio Team Services at https://python.visualstudio.com/cpython
bpo-33512: configure’s check for “long double” has been simplified
bpo-33483: C compiler is now correctly detected from the standard environment variables. –without-gcc and –with-icc options have been removed.
bpo-33394: Enable the verbose build for extension modules, when GNU make is passed macros on the command line.
bpo-33393: Update config.guess and config.sub files.
bpo-33377: Add new triplets for mips r6 and riscv variants (used in extension suffixes).
bpo-32232: By default, modules configured in
Modules/Setupare no longer built with-DPy_BUILD_CORE. Instead, modules that specifically need that preprocessor definition include it in their individual entries.bpo-33182: The embedding tests can once again be built with clang 6.0
bpo-33163: Upgrade pip to 9.0.3 and setuptools to v39.0.1.
bpo-33012: gcc 8 has added a new warning heuristic to detect invalid function casts and a stock python build seems to hit that warning quite often. The most common is the cast of a METH_NOARGS function (that uses just one argument) to a PyCFunction. Fix this by adding a dummy argument to all functions that implement METH_NOARGS.
bpo-32898: Fix the python debug build when using COUNT_ALLOCS.
bpo-29442: Replace optparse with argparse in setup.py
Windows¶
bpo-35890: Fix API calling consistency of GetVersionEx and wcstok.
bpo-32560: The
pylauncher now forwards itsSTARTUPINFOstructure to child processes.bpo-35854: Fix EnvBuilder and –symlinks in venv on Windows
bpo-35811: Avoid propagating venv settings when launching via py.exe
bpo-35797: Fix default executable used by the multiprocessing module
bpo-35758: Allow building on ARM with MSVC.
bpo-29734: Fix handle leaks in os.stat on Windows.
bpo-35596: Use unchecked PYCs for the embeddable distro to avoid zipimport restrictions.
bpo-35596: Fix vcruntime140.dll being added to embeddable distro multiple times.
bpo-35402: Update Windows build to use Tcl and Tk 8.6.9
bpo-35401: Updates Windows build to OpenSSL 1.1.0j
bpo-34977: venv on Windows will now use a python.exe redirector rather than copying the actual binaries from the base environment.
bpo-34977: Adds support for building a Windows App Store package
bpo-35067: Remove _distutils_findvs module and use vswhere.exe instead.
bpo-32557: Allow shutil.disk_usage to take a file path on Windows
bpo-34770: Fix a possible null pointer dereference in pyshellext.cpp.
bpo-34603: Fix returning structs from functions produced by MSVC
bpo-34581: Guard MSVC-specific code in socketmodule.c with
#ifdef _MSC_VER.bpo-34532: Fixes exit code of list version arguments for py.exe.
bpo-34062: Fixed the ‘–list’ and ‘–list-paths’ arguments for the py.exe launcher
bpo-34225: Ensure INCLUDE and LIB directories do not end with a backslash.
bpo-34011: A suite of code has been changed which copied across DLLs and init.tcl from the running Python location into a venv being created. These copies are needed only when running from a Python source build, and the copying code is now only run when that is the case, rather than whenever a venv is created.
bpo-34006: Revert line length limit for Windows help docs. The line-length limit is not needed because the pages appear in a separate app rather than on a browser tab. It can also interact badly with the DPI setting.
bpo-31546: Restore running PyOS_InputHook while waiting for user input at the prompt. The restores integration of interactive GUI windows (such as Matplotlib figures) with the prompt on Windows.
bpo-30237: Output error when ReadConsole is canceled by CancelSynchronousIo instead of crashing.
bpo-33895: GIL is released while calling functions that acquire Windows loader lock.
bpo-33720: Reduces maximum marshal recursion depth on release builds.
bpo-29097: Fix bug where
datetime.fromtimestamp()erroneously throws anOSErroron Windows for values between 0 and 86400. Patch by Ammar Askar.bpo-33316: PyThread_release_lock always fails
bpo-33184: Update Windows installer to use OpenSSL 1.1.0h.
bpo-32890: Fix usage of GetLastError() instead of errno in os.execve() and os.truncate().
bpo-33016: Fix potential use of uninitialized memory in nt._getfinalpathname
bpo-32903: Fix a memory leak in os.chdir() on Windows if the current directory is set to a UNC path.
bpo-32901: Update Tcl and Tk versions to 8.6.8
bpo-31966: Fixed WindowsConsoleIO.write() for writing empty data.
bpo-32409: Ensures activate.bat can handle Unicode contents.
bpo-32457: Improves handling of denormalized executable path when launching Python.
bpo-32370: Use the correct encoding for ipconfig output in the uuid module. Patch by Segev Finer.
bpo-29248: Fix
os.readlink()on Windows, which was mistakenly treating thePrintNameOffsetfield of the reparse data buffer as a number of characters instead of bytes. Patch by Craig Holmquist and SSE4.bpo-1104: Correctly handle string length in
msilib.SummaryInfo.GetProperty()to prevent it from truncating the last character.
macOS¶
bpo-35401: Update macOS installer to use OpenSSL 1.1.0j.
bpo-35025: Properly guard the use of the
CLOCK_GETTIMEet al. macros intimemoduleon macOS.bpo-24658: On macOS, fix reading from and writing into a file with a size larger than 2 GiB.
bpo-34405: Update to OpenSSL 1.1.0i for macOS installer builds.
bpo-33635: In macOS stat on some file descriptors (/dev/fd/3 f.e) will result in bad file descriptor OSError. Guard against this exception was added in is_dir, is_file and similar methods. DirEntry.is_dir can also throw this exception so _RecursiveWildcardSelector._iterate_directories was also extended with the same error ignoring pattern.
bpo-13631: The .editrc file in user’s home directory is now processed correctly during the readline initialization through editline emulation on macOS.
bpo-33184: Update macOS installer build to use OpenSSL 1.1.0h.
bpo-32726: Build and link with private copy of Tcl/Tk 8.6 for the macOS 10.6+ installer. The 10.9+ installer variant already does this. This means that the Python 3.7 provided by the python.org macOS installers no longer need or use any external versions of Tcl/Tk, either system-provided or user-installed, such as ActiveTcl.
bpo-32901: Update macOS 10.9+ installer to Tcl/Tk 8.6.8.
bpo-31903: In
_scproxy, drop the GIL when calling intoSystemConfigurationto avoid deadlocks.
IDLE¶
bpo-35770: IDLE macosx deletes Options => Configure IDLE. It previously deleted Window => Zoom Height by mistake. (Zoom Height is now on the Options menu). On Mac, the settings dialog is accessed via Preferences on the IDLE menu.
bpo-35769: Change IDLE’s new file name from ‘Untitled’ to ‘untitled’
bpo-35660: Fix imports in idlelib.window.
bpo-35641: Proper format
calltipwhen the function has no docstring.bpo-33987: Use ttk Frame for ttk widgets.
bpo-34055: Fix erroneous ‘smart’ indents and newlines in IDLE Shell.
bpo-35591: Find Selection now works when selection not found.
bpo-35196: Speed up squeezer line counting.
bpo-35598: Update config_key: use PEP 8 names and ttk widgets, make some objects global, and add tests.
bpo-28097: Add Previous/Next History entries to Shell menu.
bpo-35208: Squeezer now properly counts wrapped lines before newlines.
bpo-35555: Gray out Code Context menu entry when it’s not applicable.
bpo-35521: Document the IDLE editor code context feature. Add some internal references within the IDLE doc.
bpo-22703: The Code Context menu label now toggles between Show/Hide Code Context. The Zoom Height menu now toggles between Zoom/Restore Height. Zoom Height has moved from the Window menu to the Options menu.
bpo-35213: Where appropriate, use ‘macOS’ in idlelib.
bpo-34864: On macOS, warn if the system preference “Prefer tabs when opening documents” is set to “Always”.
bpo-34864: Document two IDLE on MacOS issues. The System Preferences Dock “prefer tabs always” setting disables some IDLE features. Menus are a bit different than as described for Windows and Linux.
bpo-35202: Remove unused imports from lib/idlelib
bpo-33000: Document that IDLE’s shell has no line limit. A program that runs indefinitely can overfill memory.
bpo-23220: Explain how IDLE’s Shell displays output.
bpo-35099: Improve the doc about IDLE running user code. The section is renamed from “IDLE – console differences” is renamed “Running user code”. It mostly covers the implications of using custom sys.stdxxx objects.
bpo-35097: Add IDLE doc subsection explaining editor windows. Topics include opening, title and status bar, .py* extension, and running.
bpo-35093: Document the IDLE document viewer in the IDLE doc. Add a paragraph in “Help and preferences”, “Help sources” subsection.
bpo-35088: Update idlelib.help.copy_string docstring. We now use git and backporting instead of hg and forward merging.
bpo-35087: Update idlelib help files for the current doc build. The main change is the elimination of chapter-section numbers.
bpo-34548: Use configured color theme for read-only text views.
bpo-1529353: Enable “squeezing” of long outputs in the shell, to avoid performance degradation and to clean up the history without losing it. Squeezed outputs may be copied, viewed in a separate window, and “unsqueezed”.
bpo-34047: Fixed mousewheel scrolling direction on macOS.
bpo-34275: Make IDLE calltips always visible on Mac. Some MacOS-tk combinations need .update_idletasks(). Patch by Kevin Walzer.
bpo-34120: Fix unresponsiveness after closing certain windows and dialogs.
bpo-33975: Avoid small type when running htests. Since part of the purpose of human-viewed tests is to determine that widgets look right, it is important that they look the same for testing as when running IDLE.
bpo-33905: Add test for idlelib.stackview.StackBrowser.
bpo-33924: Change mainmenu.menudefs key ‘windows’ to ‘window’. Every other menudef key is lowercase version of main menu entry.
bpo-33906: Rename idlelib.windows as window Match Window on the main menu and remove last plural module name.
bpo-33917: Fix and document idlelib/idle_test/template.py. The revised file compiles, runs, and tests OK. idle_test/README.txt explains how to use it to create new IDLE test files.
bpo-33904: IDLE: In rstrip, rename class RstripExtension as Rstrip
bpo-33907: For consistency and clarity, rename an IDLE module and classes. Module calltips and its class CallTips are now calltip and Calltip. In module calltip_w, class CallTip is now CalltipWindow.
bpo-33856: Add “help” in the welcome message of IDLE
bpo-33839: IDLE: refactor ToolTip and CallTip and add documentation and tests
bpo-33855: Minimally test all IDLE modules. Add missing files, import module, instantiate classes, and check coverage. Check existing files.
bpo-33656: On Windows, add API call saying that tk scales for DPI. On Windows 8.1+ or 10, with DPI compatibility properties of the Python binary unchanged, and a monitor resolution greater than 96 DPI, this should make text and lines sharper. It should otherwise have no effect.
bpo-33768: Clicking on a context line moves that line to the top of the editor window.
bpo-33763: IDLE: Use read-only text widget for code context instead of label widget.
bpo-33664: Scroll IDLE editor text by lines. Previously, the mouse wheel and scrollbar slider moved text by a fixed number of pixels, resulting in partial lines at the top of the editor box. The change also applies to the shell and grep output windows, but not to read-only text views.
bpo-33679: Enable theme-specific color configuration for Code Context. Use the Highlights tab to see the setting for built-in themes or add settings to custom themes.
bpo-33642: Display up to maxlines non-blank lines for Code Context. If there is no current context, show a single blank line.
bpo-33628: IDLE: Cleanup codecontext.py and its test.
bpo-33564: IDLE’s code context now recognizes async as a block opener.