CINXE.COM

<!DOCTYPE html> <html lang="en" data-content_root="../"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> <meta property="og:title" content="What’s New In Python 3.13" /> <meta property="og:type" content="website" /> <meta property="og:url" content="https://docs.python.org/3/whatsnew/3.13.html" /> <meta property="og:site_name" content="Python documentation" /> <meta property="og:description" content="Editors, Adam Turner and Thomas Wouters,. This article explains the new features in Python 3.13, compared to 3.12. Python 3.13 was released on October 7, 2024. For full details, see the changelog. ..." /> <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" /> <meta property="og:image:alt" content="Python documentation" /> <meta name="description" content="Editors, Adam Turner and Thomas Wouters,. This article explains the new features in Python 3.13, compared to 3.12. Python 3.13 was released on October 7, 2024. For full details, see the changelog. ..." /> <meta property="og:image:width" content="200" /> <meta property="og:image:height" content="200" /> <meta name="theme-color" content="#3776ab" /> <title>What’s New In Python 3.13 — Python 3.13.0 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0"> <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" /> <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=41b4f12d" /> <link rel="stylesheet" type="text/css" href="../_static/sidebar-wrap.css?v=65806c5a" /> <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=b20cc3f5" /> <script src="../_static/documentation_options.js?v=6aaf4047"></script> <script src="../_static/doctools.js?v=9bcbadda"></script> <script src="../_static/sphinx_highlight.js?v=dc90522c"></script> <script src="../_static/sidebar.js"></script> <link rel="search" type="application/opensearchdescription+xml" title="Search within Python 3.13.0 documentation" href="../_static/opensearch.xml"/> <link rel="author" title="About these documents" href="../about.html" /> <link rel="index" title="Index" href="../genindex.html" /> <link rel="search" title="Search" href="../search.html" /> <link rel="copyright" title="Copyright" href="../copyright.html" /> <link rel="next" title="What’s New In Python 3.12" href="3.12.html" /> <link rel="prev" title="What’s New in Python" href="index.html" /> <script defer data-domain="docs.python.org" src="https://plausible.io/js/script.js"></script> <link rel="canonical" href="https://docs.python.org/3/whatsnew/3.13.html" /> <style> @media only screen { table.full-width-table { width: 100%; } } </style> <link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css"> <link rel="shortcut icon" type="image/png" href="../_static/py.svg" /> <script type="text/javascript" src="../_static/copybutton.js"></script> <script type="text/javascript" src="../_static/menu.js"></script> <script type="text/javascript" src="../_static/search-focus.js"></script> <script type="text/javascript" src="../_static/themetoggle.js"></script> <script type="text/javascript" src="../_static/rtd_switcher.js"></script> <meta name="readthedocs-addons-api-version" content="1"> </head> <body> <div class="mobile-nav"> <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation" aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" /> <nav class="nav-content" role="navigation"> <label for="menuToggler" class="toggler__label"> </label> <a href="https://www.python.org/" class="nav-logo"> <img src="../_static/py.svg" alt="Python logo"/> </a> <form role="search" class="search" action="../search.html" method="get"> <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon"> <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path> </svg> <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" /> <input type="submit" value="Go"/> </form> </nav> <div class="menu-wrapper"> <nav class="menu" role="navigation" aria-label="main navigation"> <div class="language_switcher_placeholder"></div> <label class="theme-selector-label"> Theme <select class="theme-selector" oninput="activateTheme(this.value)"> <option value="auto" selected>Auto</option> <option value="light">Light</option> <option value="dark">Dark</option> </select> </label> <div> <h3><a href="../contents.html">Table of Contents</a></h3> <ul> <li><a class="reference internal" href="#">What’s New In Python 3.13</a><ul> <li><a class="reference internal" href="#summary-release-highlights">Summary – Release Highlights</a></li> <li><a class="reference internal" href="#new-features">New Features</a><ul> <li><a class="reference internal" href="#a-better-interactive-interpreter">A better interactive interpreter</a></li> <li><a class="reference internal" href="#improved-error-messages">Improved error messages</a></li> <li><a class="reference internal" href="#free-threaded-cpython">Free-threaded CPython</a></li> <li><a class="reference internal" href="#an-experimental-just-in-time-jit-compiler">An experimental just-in-time (JIT) compiler</a></li> <li><a class="reference internal" href="#defined-mutation-semantics-for-locals">Defined mutation semantics for <code class="xref py py-func docutils literal notranslate">locals()</code></a></li> <li><a class="reference internal" href="#support-for-mobile-platforms">Support for mobile platforms</a></li> </ul> </li> <li><a class="reference internal" href="#other-language-changes">Other Language Changes</a></li> <li><a class="reference internal" href="#new-modules">New Modules</a></li> <li><a class="reference internal" href="#improved-modules">Improved Modules</a><ul> <li><a class="reference internal" href="#argparse">argparse</a></li> <li><a class="reference internal" href="#array">array</a></li> <li><a class="reference internal" href="#ast">ast</a></li> <li><a class="reference internal" href="#asyncio">asyncio</a></li> <li><a class="reference internal" href="#base64">base64</a></li> <li><a class="reference internal" href="#compileall">compileall</a></li> <li><a class="reference internal" href="#concurrent-futures">concurrent.futures</a></li> <li><a class="reference internal" href="#configparser">configparser</a></li> <li><a class="reference internal" href="#copy">copy</a></li> <li><a class="reference internal" href="#ctypes">ctypes</a></li> <li><a class="reference internal" href="#dbm">dbm</a></li> <li><a class="reference internal" href="#dis">dis</a></li> <li><a class="reference internal" href="#doctest">doctest</a></li> <li><a class="reference internal" href="#email">email</a></li> <li><a class="reference internal" href="#fractions">fractions</a></li> <li><a class="reference internal" href="#glob">glob</a></li> <li><a class="reference internal" href="#importlib">importlib</a></li> <li><a class="reference internal" href="#io">io</a></li> <li><a class="reference internal" href="#ipaddress">ipaddress</a></li> <li><a class="reference internal" href="#itertools">itertools</a></li> <li><a class="reference internal" href="#marshal">marshal</a></li> <li><a class="reference internal" href="#math">math</a></li> <li><a class="reference internal" href="#mimetypes">mimetypes</a></li> <li><a class="reference internal" href="#mmap">mmap</a></li> <li><a class="reference internal" href="#multiprocessing">multiprocessing</a></li> <li><a class="reference internal" href="#os">os</a></li> <li><a class="reference internal" href="#os-path">os.path</a></li> <li><a class="reference internal" href="#pathlib">pathlib</a></li> <li><a class="reference internal" href="#pdb">pdb</a></li> <li><a class="reference internal" href="#queue">queue</a></li> <li><a class="reference internal" href="#random">random</a></li> <li><a class="reference internal" href="#re">re</a></li> <li><a class="reference internal" href="#shutil">shutil</a></li> <li><a class="reference internal" href="#site">site</a></li> <li><a class="reference internal" href="#sqlite3">sqlite3</a></li> <li><a class="reference internal" href="#ssl">ssl</a></li> <li><a class="reference internal" href="#statistics">statistics</a></li> <li><a class="reference internal" href="#subprocess">subprocess</a></li> <li><a class="reference internal" href="#sys">sys</a></li> <li><a class="reference internal" href="#tempfile">tempfile</a></li> <li><a class="reference internal" href="#time">time</a></li> <li><a class="reference internal" href="#tkinter">tkinter</a></li> <li><a class="reference internal" href="#traceback">traceback</a></li> <li><a class="reference internal" href="#types">types</a></li> <li><a class="reference internal" href="#typing">typing</a></li> <li><a class="reference internal" href="#unicodedata">unicodedata</a></li> <li><a class="reference internal" href="#venv">venv</a></li> <li><a class="reference internal" href="#warnings">warnings</a></li> <li><a class="reference internal" href="#xml">xml</a></li> <li><a class="reference internal" href="#zipimport">zipimport</a></li> </ul> </li> <li><a class="reference internal" href="#optimizations">Optimizations</a></li> <li><a class="reference internal" href="#removed-modules-and-apis">Removed Modules And APIs</a><ul> <li><a class="reference internal" href="#pep-594-remove-dead-batteries-from-the-standard-library">PEP 594: Remove “dead batteries” from the standard library</a></li> <li><a class="reference internal" href="#to3">2to3</a></li> <li><a class="reference internal" href="#builtins">builtins</a></li> <li><a class="reference internal" href="#id3">configparser</a></li> <li><a class="reference internal" href="#importlib-metadata">importlib.metadata</a></li> <li><a class="reference internal" href="#locale">locale</a></li> <li><a class="reference internal" href="#opcode">opcode</a></li> <li><a class="reference internal" href="#id4">pathlib</a></li> <li><a class="reference internal" href="#id5">re</a></li> <li><a class="reference internal" href="#tkinter-tix">tkinter.tix</a></li> <li><a class="reference internal" href="#turtle">turtle</a></li> <li><a class="reference internal" href="#id6">typing</a></li> <li><a class="reference internal" href="#unittest">unittest</a></li> <li><a class="reference internal" href="#urllib">urllib</a></li> <li><a class="reference internal" href="#webbrowser">webbrowser</a></li> </ul> </li> <li><a class="reference internal" href="#new-deprecations">New Deprecations</a><ul> <li><a class="reference internal" href="#pending-removal-in-python-3-14">Pending Removal in Python 3.14</a></li> <li><a class="reference internal" href="#pending-removal-in-python-3-15">Pending Removal in Python 3.15</a></li> <li><a class="reference internal" href="#pending-removal-in-python-3-16">Pending removal in Python 3.16</a></li> <li><a class="reference internal" href="#pending-removal-in-future-versions">Pending Removal in Future Versions</a></li> </ul> </li> <li><a class="reference internal" href="#cpython-bytecode-changes">CPython Bytecode Changes</a></li> <li><a class="reference internal" href="#c-api-changes">C API Changes</a><ul> <li><a class="reference internal" href="#id7">New Features</a></li> <li><a class="reference internal" href="#changed-c-apis">Changed C APIs</a></li> <li><a class="reference internal" href="#limited-c-api-changes">Limited C API Changes</a></li> <li><a class="reference internal" href="#removed-c-apis">Removed C APIs</a></li> <li><a class="reference internal" href="#deprecated-c-apis">Deprecated C APIs</a><ul> <li><a class="reference internal" href="#id8">Pending Removal in Python 3.14</a></li> <li><a class="reference internal" href="#id9">Pending Removal in Python 3.15</a></li> <li><a class="reference internal" href="#id10">Pending Removal in Future Versions</a></li> </ul> </li> </ul> </li> <li><a class="reference internal" href="#build-changes">Build Changes</a></li> <li><a class="reference internal" href="#porting-to-python-3-13">Porting to Python 3.13</a><ul> <li><a class="reference internal" href="#changes-in-the-python-api">Changes in the Python API</a></li> <li><a class="reference internal" href="#changes-in-the-c-api">Changes in the C API</a></li> </ul> </li> <li><a class="reference internal" href="#regression-test-changes">Regression Test Changes</a></li> <li><a class="reference internal" href="#notable-changes-in-3-13-1">Notable changes in 3.13.1</a><ul> <li><a class="reference internal" href="#id11">sys</a></li> </ul> </li> </ul> </li> </ul> </div> <div> <h4>Previous topic</h4> <a href="index.html" title="previous chapter">What’s New in Python</a> </div> <div> <h4>Next topic</h4> <a href="3.12.html" title="next chapter">What’s New In Python 3.12</a> </div> <div role="note" aria-label="source link"> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../bugs.html">Report a Bug</a></li> <li> <a href="https://github.com/python/cpython/blob/main/Doc/whatsnew/3.13.rst" rel="nofollow">Show Source </a> </li> </ul> </div> </nav> </div> </div> <div class="related" role="navigation" aria-label="Related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > <a href="../py-modindex.html" title="Python Module Index" >modules</a> |</li> <li class="right" > <a href="3.12.html" title="What’s New In Python 3.12" accesskey="N">next</a> |</li> <li class="right" > <a href="index.html" title="What’s New in Python" accesskey="P">previous</a> |</li> <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li> <li><a href="https://www.python.org/">Python</a> »</li> <li class="switchers"> <div class="language_switcher_placeholder"></div> <div class="version_switcher_placeholder"></div> </li> <li> </li> <li id="cpython-language-and-version"> <a href="../index.html">3.13.0 Documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">What’s New in Python</a> »</li> <li class="nav-item nav-item-this"><a href="">What’s New In Python 3.13</a></li> <li class="right"> <div class="inline-search" role="search"> <form class="inline-search" action="../search.html" method="get"> <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" /> <input type="submit" value="Go" /> </form> </div> | </li> <li class="right"> <label class="theme-selector-label"> Theme <select class="theme-selector" oninput="activateTheme(this.value)"> <option value="auto" selected>Auto</option> <option value="light">Light</option> <option value="dark">Dark</option> </select> </label> |</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body" role="main"> <section id="what-s-new-in-python-3-13"> <h1>What’s New In Python 3.13<a class="headerlink" href="#what-s-new-in-python-3-13" title="Link to this heading">¶</a></h1> <dl class="field-list simple"> <dt class="field-odd">Editors:</dt> <dd class="field-odd">Adam Turner and Thomas Wouters </dd> </dl> This article explains the new features in Python 3.13, compared to 3.12. Python 3.13 was released on October 7, 2024. For full details, see the <a class="reference internal" href="changelog.html#changelog">changelog</a>. <div class="admonition seealso"> See also <a class="pep reference external" href="https://peps.python.org/pep-0719/">PEP 719</a> – Python 3.13 Release Schedule </div> <section id="summary-release-highlights"> <h2>Summary – Release Highlights<a class="headerlink" href="#summary-release-highlights" title="Link to this heading">¶</a></h2> Python 3.13 is the latest stable release of the Python programming language, with a mix of changes to the language, the implementation and the standard library. The biggest changes include a new <a class="reference internal" href="#whatsnew313-better-interactive-interpreter">interactive interpreter</a>, experimental support for running in a <a class="reference internal" href="#whatsnew313-free-threaded-cpython">free-threaded mode</a> (<a class="pep reference external" href="https://peps.python.org/pep-0703/">PEP 703</a>), and a <a class="reference internal" href="#whatsnew313-jit-compiler">Just-In-Time compiler</a> (<a class="pep reference external" href="https://peps.python.org/pep-0744/">PEP 744</a>). Error messages continue to improve, with tracebacks now highlighted in color by default. The <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> builtin now has <a class="reference internal" href="#whatsnew313-locals-semantics">defined semantics</a> for changing the returned mapping, and type parameters now support default values. The library changes contain removal of deprecated APIs and modules, as well as the usual improvements in user-friendliness and correctness. Several legacy standard library modules have now <a class="reference internal" href="#whatsnew313-pep594">been removed</a> following their deprecation in Python 3.11 (<a class="pep reference external" href="https://peps.python.org/pep-0594/">PEP 594</a>). This article doesn’t attempt to provide a complete specification of all new features, but instead gives a convenient overview. For full details refer to the documentation, such as the <a class="reference internal" href="../library/index.html#library-index">Library Reference</a> and <a class="reference internal" href="../reference/index.html#reference-index">Language Reference</a>. To understand the complete implementation and design rationale for a change, refer to the PEP for a particular new feature; but note that PEPs usually are not kept up-to-date once a feature has been fully implemented. See <a class="reference internal" href="#porting-to-python-3-13">Porting to Python 3.13</a> for guidance on upgrading from earlier versions of Python. <hr class="docutils" /> Interpreter improvements: <ul class="simple"> <li>A greatly improved <a class="reference internal" href="#whatsnew313-better-interactive-interpreter">interactive interpreter</a> and <a class="reference internal" href="#whatsnew313-improved-error-messages">improved error messages</a>.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a>: The <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> builtin now has <a class="reference internal" href="#whatsnew313-locals-semantics">defined semantics</a> when mutating the returned mapping. Python debuggers and similar tools may now more reliably update local variables in optimized scopes even during concurrent code execution.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0703/">PEP 703</a>: CPython 3.13 has experimental support for running with the <a class="reference internal" href="../glossary.html#term-global-interpreter-lock">global interpreter lock</a> disabled. See <a class="reference internal" href="#whatsnew313-free-threaded-cpython">Free-threaded CPython</a> for more details.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0744/">PEP 744</a>: A basic <a class="reference internal" href="#whatsnew313-jit-compiler">JIT compiler</a> was added. It is currently disabled by default (though we may turn it on later). Performance improvements are modest – we expect to improve this over the next few releases.</li> <li>Color support in the new <a class="reference internal" href="#whatsnew313-better-interactive-interpreter">interactive interpreter</a>, as well as in <a class="reference internal" href="#whatsnew313-improved-error-messages">tracebacks</a> and <a class="reference internal" href="#whatsnew313-doctest">doctest</a> output. This can be disabled through the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_COLORS"><code class="xref std std-envvar docutils literal notranslate">PYTHON_COLORS</code></a> and <a class="reference external" href="https://no-color.org/"><code class="docutils literal notranslate">NO_COLOR</code></a> environment variables.</li> </ul> Python data model improvements: <ul class="simple"> <li><a class="reference internal" href="../reference/datamodel.html#type.__static_attributes__" title="type.__static_attributes__"><code class="xref py py-attr docutils literal notranslate">__static_attributes__</code></a> stores the names of attributes accessed through <code class="docutils literal notranslate">self.X</code> in any function in a class body.</li> <li><a class="reference internal" href="../reference/datamodel.html#type.__firstlineno__" title="type.__firstlineno__"><code class="xref py py-attr docutils literal notranslate">__firstlineno__</code></a> records the first line number of a class definition.</li> </ul> Significant improvements in the standard library: <ul class="simple"> <li>Add a new <a class="reference internal" href="../library/exceptions.html#PythonFinalizationError" title="PythonFinalizationError"><code class="xref py py-exc docutils literal notranslate">PythonFinalizationError</code></a> exception, raised when an operation is blocked during <a class="reference internal" href="../glossary.html#term-interpreter-shutdown">finalization</a>.</li> <li>The <a class="reference internal" href="../library/argparse.html#module-argparse" title="argparse: Command-line option and argument parsing library."><code class="xref py py-mod docutils literal notranslate">argparse</code></a> module now supports deprecating command-line options, positional arguments, and subcommands.</li> <li>The new functions <a class="reference internal" href="../library/base64.html#base64.z85encode" title="base64.z85encode"><code class="xref py py-func docutils literal notranslate">base64.z85encode()</code></a> and <a class="reference internal" href="../library/base64.html#base64.z85decode" title="base64.z85decode"><code class="xref py py-func docutils literal notranslate">base64.z85decode()</code></a> support encoding and decoding <a class="reference external" href="https://rfc.zeromq.org/spec/32/">Z85 data</a>.</li> <li>The <a class="reference internal" href="../library/copy.html#module-copy" title="copy: Shallow and deep copy operations."><code class="xref py py-mod docutils literal notranslate">copy</code></a> module now has a <a class="reference internal" href="../library/copy.html#copy.replace" title="copy.replace"><code class="xref py py-func docutils literal notranslate">copy.replace()</code></a> function, with support for many builtin types and any class defining the <a class="reference internal" href="../library/copy.html#object.__replace__" title="object.__replace__"><code class="xref py py-func docutils literal notranslate">__replace__()</code></a> method.</li> <li>The new <a class="reference internal" href="../library/dbm.html#module-dbm.sqlite3" title="dbm.sqlite3: SQLite backend for dbm (All)"><code class="xref py py-mod docutils literal notranslate">dbm.sqlite3</code></a> module is now the default <a class="reference internal" href="../library/dbm.html#module-dbm" title="dbm: Interfaces to various Unix "database" formats."><code class="xref py py-mod docutils literal notranslate">dbm</code></a> backend.</li> <li>The <a class="reference internal" href="../library/os.html#module-os" title="os: Miscellaneous operating system interfaces."><code class="xref py py-mod docutils literal notranslate">os</code></a> module has a <a class="reference internal" href="../library/os.html#os-timerfd">suite of new functions</a> for working with Linux’s timer notification file descriptors.</li> <li>The <a class="reference internal" href="../library/random.html#module-random" title="random: Generate pseudo-random numbers with various common distributions."><code class="xref py py-mod docutils literal notranslate">random</code></a> module now has a <a class="reference internal" href="../library/random.html#random-cli">command-line interface</a>.</li> </ul> Security improvements: <ul class="simple"> <li><a class="reference internal" href="../library/ssl.html#ssl.create_default_context" title="ssl.create_default_context"><code class="xref py py-func docutils literal notranslate">ssl.create_default_context()</code></a> sets <a class="reference internal" href="../library/ssl.html#ssl.VERIFY_X509_PARTIAL_CHAIN" title="ssl.VERIFY_X509_PARTIAL_CHAIN"><code class="xref py py-data docutils literal notranslate">ssl.VERIFY_X509_PARTIAL_CHAIN</code></a> and <a class="reference internal" href="../library/ssl.html#ssl.VERIFY_X509_STRICT" title="ssl.VERIFY_X509_STRICT"><code class="xref py py-data docutils literal notranslate">ssl.VERIFY_X509_STRICT</code></a> as default flags.</li> </ul> C API improvements: <ul class="simple"> <li>The <a class="reference internal" href="../c-api/module.html#c.Py_mod_gil" title="Py_mod_gil"><code class="xref c c-data docutils literal notranslate">Py_mod_gil</code></a> slot is now used to indicate that an extension module supports running with the <a class="reference internal" href="../glossary.html#term-GIL">GIL</a> disabled.</li> <li>The <a class="reference internal" href="../c-api/time.html">PyTime C API</a> has been added, providing access to system clocks.</li> <li><a class="reference internal" href="../c-api/init.html#c.PyMutex" title="PyMutex"><code class="xref c c-type docutils literal notranslate">PyMutex</code></a> is a new lightweight mutex that occupies a single byte.</li> <li>There is a new <a class="reference internal" href="../c-api/monitoring.html#c-api-monitoring">suite of functions</a> for generating <a class="pep reference external" href="https://peps.python.org/pep-0669/">PEP 669</a> monitoring events in the C API.</li> </ul> New typing features: <ul class="simple"> <li><a class="pep reference external" href="https://peps.python.org/pep-0696/">PEP 696</a>: Type parameters (<a class="reference internal" href="../library/typing.html#typing.TypeVar" title="typing.TypeVar"><code class="xref py py-data docutils literal notranslate">typing.TypeVar</code></a>, <a class="reference internal" href="../library/typing.html#typing.ParamSpec" title="typing.ParamSpec"><code class="xref py py-data docutils literal notranslate">typing.ParamSpec</code></a>, and <a class="reference internal" href="../library/typing.html#typing.TypeVarTuple" title="typing.TypeVarTuple"><code class="xref py py-data docutils literal notranslate">typing.TypeVarTuple</code></a>) now support defaults.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0702/">PEP 702</a>: The new <a class="reference internal" href="../library/warnings.html#warnings.deprecated" title="warnings.deprecated"><code class="xref py py-func docutils literal notranslate">warnings.deprecated()</code></a> decorator adds support for marking deprecations in the type system and at runtime.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0705/">PEP 705</a>: <a class="reference internal" href="../library/typing.html#typing.ReadOnly" title="typing.ReadOnly"><code class="xref py py-data docutils literal notranslate">typing.ReadOnly</code></a> can be used to mark an item of a <a class="reference internal" href="../library/typing.html#typing.TypedDict" title="typing.TypedDict"><code class="xref py py-class docutils literal notranslate">typing.TypedDict</code></a> as read-only for type checkers.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0742/">PEP 742</a>: <a class="reference internal" href="../library/typing.html#typing.TypeIs" title="typing.TypeIs"><code class="xref py py-data docutils literal notranslate">typing.TypeIs</code></a> provides more intuitive type narrowing behavior, as an alternative to <a class="reference internal" href="../library/typing.html#typing.TypeGuard" title="typing.TypeGuard"><code class="xref py py-data docutils literal notranslate">typing.TypeGuard</code></a>.</li> </ul> Platform support: <ul class="simple"> <li><a class="pep reference external" href="https://peps.python.org/pep-0730/">PEP 730</a>: Apple’s iOS is now an <a class="reference internal" href="#whatsnew313-platform-support">officially supported platform</a>, at <a class="pep reference external" href="https://peps.python.org/pep-0011/#tier-3">tier 3</a>.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0738/">PEP 738</a>: Android is now an <a class="reference internal" href="#whatsnew313-platform-support">officially supported platform</a>, at <a class="pep reference external" href="https://peps.python.org/pep-0011/#tier-3">tier 3</a>.</li> <li><code class="docutils literal notranslate">wasm32-wasi</code> is now supported as a <a class="pep reference external" href="https://peps.python.org/pep-0011/#tier-2">tier 2</a> platform.</li> <li><code class="docutils literal notranslate">wasm32-emscripten</code> is no longer an officially supported platform.</li> </ul> Important removals: <ul class="simple"> <li><a class="reference internal" href="#whatsnew313-pep594">PEP 594</a>: The remaining 19 “dead batteries” (legacy stdlib modules) have been removed from the standard library: <code class="xref py py-mod docutils literal notranslate">aifc</code>, <code class="xref py py-mod docutils literal notranslate">audioop</code>, <code class="xref py py-mod docutils literal notranslate">cgi</code>, <code class="xref py py-mod docutils literal notranslate">cgitb</code>, <code class="xref py py-mod docutils literal notranslate">chunk</code>, <code class="xref py py-mod docutils literal notranslate">crypt</code>, <code class="xref py py-mod docutils literal notranslate">imghdr</code>, <code class="xref py py-mod docutils literal notranslate">mailcap</code>, <code class="xref py py-mod docutils literal notranslate">msilib</code>, <code class="xref py py-mod docutils literal notranslate">nis</code>, <code class="xref py py-mod docutils literal notranslate">nntplib</code>, <code class="xref py py-mod docutils literal notranslate">ossaudiodev</code>, <code class="xref py py-mod docutils literal notranslate">pipes</code>, <code class="xref py py-mod docutils literal notranslate">sndhdr</code>, <code class="xref py py-mod docutils literal notranslate">spwd</code>, <code class="xref py py-mod docutils literal notranslate">sunau</code>, <code class="xref py py-mod docutils literal notranslate">telnetlib</code>, <code class="xref py py-mod docutils literal notranslate">uu</code> and <code class="xref py py-mod docutils literal notranslate">xdrlib</code>.</li> <li>Remove the 2to3 tool and <code class="xref py py-mod docutils literal notranslate">lib2to3</code> module (deprecated in Python 3.11).</li> <li>Remove the <code class="xref py py-mod docutils literal notranslate">tkinter.tix</code> module (deprecated in Python 3.6).</li> <li>Remove the <code class="xref py py-func docutils literal notranslate">locale.resetlocale()</code> function.</li> <li>Remove the <code class="xref py py-mod docutils literal notranslate">typing.io</code> and <code class="xref py py-mod docutils literal notranslate">typing.re</code> namespaces.</li> <li>Remove chained <a class="reference internal" href="../library/functions.html#classmethod" title="classmethod"><code class="xref py py-class docutils literal notranslate">classmethod</code></a> descriptors.</li> </ul> Release schedule changes: <a class="pep reference external" href="https://peps.python.org/pep-0602/">PEP 602</a> (“Annual Release Cycle for Python”) has been updated to extend the full support (‘bugfix’) period for new releases to two years. This updated policy means that: <ul class="simple"> <li>Python 3.9–3.12 have one and a half years of full support, followed by three and a half years of security fixes.</li> <li>Python 3.13 and later have two years of full support, followed by three years of security fixes.</li> </ul> </section> <section id="new-features"> <h2>New Features<a class="headerlink" href="#new-features" title="Link to this heading">¶</a></h2> <section id="a-better-interactive-interpreter"> <h3>A better interactive interpreter<a class="headerlink" href="#a-better-interactive-interpreter" title="Link to this heading">¶</a></h3> Python now uses a new <a class="reference internal" href="../glossary.html#term-interactive">interactive</a> shell by default, based on code from the <a class="reference external" href="https://pypy.org/">PyPy project</a>. When the user starts the <a class="reference internal" href="../glossary.html#term-REPL">REPL</a> from an interactive terminal, the following new features are now supported: <ul class="simple"> <li>Multiline editing with history preservation.</li> <li>Direct support for REPL-specific commands like <kbd class="kbd docutils literal notranslate">help</kbd>, <kbd class="kbd docutils literal notranslate">exit</kbd>, and <kbd class="kbd docutils literal notranslate">quit</kbd>, without the need to call them as functions.</li> <li>Prompts and tracebacks with <a class="reference internal" href="../using/cmdline.html#using-on-controlling-color">color enabled by default</a>.</li> <li>Interactive help browsing using <kbd class="kbd docutils literal notranslate">F1</kbd> with a separate command history.</li> <li>History browsing using <kbd class="kbd docutils literal notranslate">F2</kbd> that skips output as well as the <a class="reference internal" href="../glossary.html#term-0">>>></a> and <a class="reference internal" href="../glossary.html#term-...">…</a> prompts.</li> <li>“Paste mode” with <kbd class="kbd docutils literal notranslate">F3</kbd> that makes pasting larger blocks of code easier (press <kbd class="kbd docutils literal notranslate">F3</kbd> again to return to the regular prompt).</li> </ul> To disable the new interactive shell, set the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_BASIC_REPL"><code class="xref std std-envvar docutils literal notranslate">PYTHON_BASIC_REPL</code></a> environment variable. For more on interactive mode, see <a class="reference internal" href="../tutorial/appendix.html#tut-interac">Interactive Mode</a>. (Contributed by Pablo Galindo Salgado, Łukasz Langa, and Lysandros Nikolaou in <a class="reference external" href="https://github.com/python/cpython/issues/111201">gh-111201</a> based on code from the PyPy project. Windows support contributed by Dino Viehland and Anthony Shaw.) </section> <section id="improved-error-messages"> <h3>Improved error messages<a class="headerlink" href="#improved-error-messages" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The interpreter now uses color by default when displaying tracebacks in the terminal. This feature <a class="reference internal" href="../using/cmdline.html#using-on-controlling-color">can be controlled</a> via the new <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_COLORS"><code class="xref std std-envvar docutils literal notranslate">PYTHON_COLORS</code></a> environment variable as well as the canonical <a class="reference external" href="https://no-color.org/"><code class="docutils literal notranslate">NO_COLOR</code></a> and <a class="reference external" href="https://force-color.org/"><code class="docutils literal notranslate">FORCE_COLOR</code></a> environment variables. (Contributed by Pablo Galindo Salgado in <a class="reference external" href="https://github.com/python/cpython/issues/112730">gh-112730</a>.)</li> </ul> <ul> <li>A common mistake is to write a script with the same name as a standard library module. When this results in errors, we now display a more helpful error message: <div class="highlight-pytb notranslate"><div class="highlight"><pre>$ python random.py Traceback (most recent call last): File "/home/me/random.py", line 1, in <module> import random File "/home/me/random.py", line 3, in <module> print(random.randint(5)) ^^^^^^^^^^^^^^ AttributeError: module 'random' has no attribute 'randint' (consider renaming '/home/me/random.py' since it has the same name as the standard library module named 'random' and prevents importing that standard library module) </pre></div> </div> Similarly, if a script has the same name as a third-party module that it attempts to import and this results in errors, we also display a more helpful error message: <div class="highlight-pytb notranslate"><div class="highlight"><pre>$ python numpy.py Traceback (most recent call last): File "/home/me/numpy.py", line 1, in <module> import numpy as np File "/home/me/numpy.py", line 3, in <module> np.array([1, 2, 3]) ^^^^^^^^ AttributeError: module 'numpy' has no attribute 'array' (consider renaming '/home/me/numpy.py' if it has the same name as a library you intended to import) </pre></div> </div> (Contributed by Shantanu Jain in <a class="reference external" href="https://github.com/python/cpython/issues/95754">gh-95754</a>.) </li> <li>The error message now tries to suggest the correct keyword argument when an incorrect keyword argument is passed to a function. <div class="highlight-pycon notranslate"><div class="highlight"><pre>>>> "Better error messages!".split(max_split=1) Traceback (most recent call last): File "<python-input-0>", line 1, in <module> "Better error messages!".split(max_split=1) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^ TypeError: split() got an unexpected keyword argument 'max_split'. Did you mean 'maxsplit'? </pre></div> </div> (Contributed by Pablo Galindo Salgado and Shantanu Jain in <a class="reference external" href="https://github.com/python/cpython/issues/107944">gh-107944</a>.) </li> </ul> </section> <section id="free-threaded-cpython"> <h3>Free-threaded CPython<a class="headerlink" href="#free-threaded-cpython" title="Link to this heading">¶</a></h3> CPython now has experimental support for running in a free-threaded mode, with the <a class="reference internal" href="../glossary.html#term-global-interpreter-lock">global interpreter lock</a> (GIL) disabled. This is an experimental feature and therefore is not enabled by default. The free-threaded mode requires a different executable, usually called <code class="docutils literal notranslate">python3.13t</code> or <code class="docutils literal notranslate">python3.13t.exe</code>. Pre-built binaries marked as free-threaded can be installed as part of the official <a class="reference internal" href="../using/windows.html#install-freethreaded-windows">Windows</a> and <a class="reference internal" href="../using/mac.html#install-freethreaded-macos">macOS</a> installers, or CPython can be built from source with the <a class="reference internal" href="../using/configure.html#cmdoption-disable-gil"><code class="xref std std-option docutils literal notranslate">--disable-gil</code></a> option. Free-threaded execution allows for full utilization of the available processing power by running threads in parallel on available CPU cores. While not all software will benefit from this automatically, programs designed with threading in mind will run faster on multi-core hardware. The free-threaded mode is experimental and work is ongoing to improve it: expect some bugs and a substantial single-threaded performance hit. Free-threaded builds of CPython support optionally running with the GIL enabled at runtime using the environment variable <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_GIL"><code class="xref std std-envvar docutils literal notranslate">PYTHON_GIL</code></a> or the command-line option <a class="reference internal" href="../using/cmdline.html#cmdoption-X"><code class="xref std std-option docutils literal notranslate">-X gil=1</code></a>. To check if the current interpreter supports free-threading, <a class="reference internal" href="../using/cmdline.html#cmdoption-V"><code class="xref std std-option docutils literal notranslate">python -VV</code></a> and <a class="reference internal" href="../library/sys.html#sys.version" title="sys.version"><code class="xref py py-attr docutils literal notranslate">sys.version</code></a> contain “experimental free-threading build”. The new <code class="xref py py-func docutils literal notranslate">sys._is_gil_enabled()</code> function can be used to check whether the GIL is actually disabled in the running process. C-API extension modules need to be built specifically for the free-threaded build. Extensions that support running with the <a class="reference internal" href="../glossary.html#term-GIL">GIL</a> disabled should use the <a class="reference internal" href="../c-api/module.html#c.Py_mod_gil" title="Py_mod_gil"><code class="xref c c-data docutils literal notranslate">Py_mod_gil</code></a> slot. Extensions using single-phase init should use <a class="reference internal" href="../c-api/module.html#c.PyUnstable_Module_SetGIL" title="PyUnstable_Module_SetGIL"><code class="xref c c-func docutils literal notranslate">PyUnstable_Module_SetGIL()</code></a> to indicate whether they support running with the GIL disabled. Importing C extensions that don’t use these mechanisms will cause the GIL to be enabled, unless the GIL was explicitly disabled with the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_GIL"><code class="xref std std-envvar docutils literal notranslate">PYTHON_GIL</code></a> environment variable or the <a class="reference internal" href="../using/cmdline.html#cmdoption-X"><code class="xref std std-option docutils literal notranslate">-X gil=0</code></a> option. pip 24.1 or newer is required to install packages with C extensions in the free-threaded build. This work was made possible thanks to many individuals and organizations, including the large community of contributors to Python and third-party projects to test and enable free-threading support. Notable contributors include: Sam Gross, Ken Jin, Donghee Na, Itamar Oren, Matt Page, Brett Simmers, Dino Viehland, Carl Meyer, Nathan Goldbaum, Ralf Gommers, Lysandros Nikolaou, and many others. Many of these contributors are employed by Meta, which has provided significant engineering resources to support this project. <div class="admonition seealso"> See also <a class="pep reference external" href="https://peps.python.org/pep-0703/">PEP 703</a> “Making the Global Interpreter Lock Optional in CPython” contains rationale and information surrounding this work. <a class="reference external" href="https://py-free-threading.github.io/porting/">Porting Extension Modules to Support Free-Threading</a>: A community-maintained porting guide for extension authors. </div> </section> <section id="an-experimental-just-in-time-jit-compiler"> <h3>An experimental just-in-time (JIT) compiler<a class="headerlink" href="#an-experimental-just-in-time-jit-compiler" title="Link to this heading">¶</a></h3> When CPython is configured and built using the <code class="xref std std-option docutils literal notranslate">--enable-experimental-jit</code> option, a just-in-time (JIT) compiler is added which may speed up some Python programs. On Windows, use <code class="docutils literal notranslate">PCbuild/build.bat --experimental-jit</code> to enable the JIT or <code class="docutils literal notranslate">--experimental-jit-interpreter</code> to enable the Tier 2 interpreter. Build requirements and further supporting information <a class="reference external" href="https://github.com/python/cpython/blob/main/Tools/jit/README.md">are contained at</a> <code class="file docutils literal notranslate">Tools/jit/README.md</code>. The <code class="xref std std-option docutils literal notranslate">--enable-experimental-jit</code> option takes these (optional) values, defaulting to <code class="docutils literal notranslate">yes</code> if <code class="xref std std-option docutils literal notranslate">--enable-experimental-jit</code> is present without the optional value. <ul class="simple"> <li><code class="docutils literal notranslate">no</code>: Disable the entire Tier 2 and JIT pipeline.</li> <li><code class="docutils literal notranslate">yes</code>: Enable the JIT. To disable the JIT at runtime, pass the environment variable <code class="docutils literal notranslate">PYTHON_JIT=0</code>.</li> <li><code class="docutils literal notranslate">yes-off</code>: Build the JIT but disable it by default. To enable the JIT at runtime, pass the environment variable <code class="docutils literal notranslate">PYTHON_JIT=1</code>.</li> <li><code class="docutils literal notranslate">interpreter</code>: Enable the Tier 2 interpreter but disable the JIT. The interpreter can be disabled by running with <code class="docutils literal notranslate">PYTHON_JIT=0</code>.</li> </ul> The internal architecture is roughly as follows: <ul class="simple"> <li>We start with specialized Tier 1 bytecode. See <a class="reference internal" href="3.11.html#whatsnew311-pep659">What’s new in 3.11</a> for details.</li> <li>When the Tier 1 bytecode gets hot enough, it gets translated to a new purely internal intermediate representation (IR), called the Tier 2 IR, and sometimes referred to as micro-ops (“uops”).</li> <li>The Tier 2 IR uses the same stack-based virtual machine as Tier 1, but the instruction format is better suited to translation to machine code.</li> <li>We have several optimization passes for Tier 2 IR, which are applied before it is interpreted or translated to machine code.</li> <li>There is a Tier 2 interpreter, but it is mostly intended for debugging the earlier stages of the optimization pipeline. The Tier 2 interpreter can be enabled by configuring Python with <code class="docutils literal notranslate">--enable-experimental-jit=interpreter</code>.</li> <li>When the JIT is enabled, the optimized Tier 2 IR is translated to machine code, which is then executed.</li> <li>The machine code translation process uses a technique called copy-and-patch. It has no runtime dependencies, but there is a new build-time dependency on LLVM.</li> </ul> <div class="admonition seealso"> See also <a class="pep reference external" href="https://peps.python.org/pep-0744/">PEP 744</a> </div> (JIT by Brandt Bucher, inspired by a paper by Haoran Xu and Fredrik Kjolstad. Tier 2 IR by Mark Shannon and Guido van Rossum. Tier 2 optimizer by Ken Jin.) </section> <section id="defined-mutation-semantics-for-locals"> <h3>Defined mutation semantics for <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a><a class="headerlink" href="#defined-mutation-semantics-for-locals" title="Link to this heading">¶</a></h3> Historically, the expected result of mutating the return value of <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> has been left to individual Python implementations to define. Starting from Python 3.13, <a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a> standardises the historical behavior of CPython for most code execution scopes, but changes <a class="reference internal" href="../glossary.html#term-optimized-scope">optimized scopes</a> (functions, generators, coroutines, comprehensions, and generator expressions) to explicitly return independent snapshots of the currently assigned local variables, including locally referenced nonlocal variables captured in closures. This change to the semantics of <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> in optimized scopes also affects the default behavior of code execution functions that implicitly target <code class="xref py py-func docutils literal notranslate">locals()</code> if no explicit namespace is provided (such as <a class="reference internal" href="../library/functions.html#exec" title="exec"><code class="xref py py-func docutils literal notranslate">exec()</code></a> and <a class="reference internal" href="../library/functions.html#eval" title="eval"><code class="xref py py-func docutils literal notranslate">eval()</code></a>). In previous versions, whether or not changes could be accessed by calling <code class="xref py py-func docutils literal notranslate">locals()</code> after calling the code execution function was implementation-dependent. In CPython specifically, such code would typically appear to work as desired, but could sometimes fail in optimized scopes based on other code (including debuggers and code execution tracing tools) potentially resetting the shared snapshot in that scope. Now, the code will always run against an independent snapshot of the local variables in optimized scopes, and hence the changes will never be visible in subsequent calls to <code class="xref py py-func docutils literal notranslate">locals()</code>. To access the changes made in these cases, an explicit namespace reference must now be passed to the relevant function. Alternatively, it may make sense to update affected code to use a higher level code execution API that returns the resulting code execution namespace (e.g. <a class="reference internal" href="../library/runpy.html#runpy.run_path" title="runpy.run_path"><code class="xref py py-func docutils literal notranslate">runpy.run_path()</code></a> when executing Python files from disk). To ensure debuggers and similar tools can reliably update local variables in scopes affected by this change, <a class="reference internal" href="../reference/datamodel.html#frame.f_locals" title="frame.f_locals"><code class="xref py py-attr docutils literal notranslate">FrameType.f_locals</code></a> now returns a write-through proxy to the frame’s local and locally referenced nonlocal variables in these scopes, rather than returning an inconsistently updated shared <code class="docutils literal notranslate">dict</code> instance with undefined runtime semantics. See <a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a> for more details, including related C API changes and deprecations. Porting notes are also provided below for the affected <a class="reference internal" href="#pep667-porting-notes-py">Python APIs</a> and <a class="reference internal" href="#pep667-porting-notes-c">C APIs</a>. (PEP and implementation contributed by Mark Shannon and Tian Gao in <a class="reference external" href="https://github.com/python/cpython/issues/74929">gh-74929</a>. Documentation updates provided by Guido van Rossum and Alyssa Coghlan.) </section> <section id="support-for-mobile-platforms"> <h3>Support for mobile platforms<a class="headerlink" href="#support-for-mobile-platforms" title="Link to this heading">¶</a></h3> <a class="pep reference external" href="https://peps.python.org/pep-0730/">PEP 730</a>: iOS is now a <a class="pep reference external" href="https://peps.python.org/pep-0011/">PEP 11</a> supported platform, with the <code class="docutils literal notranslate">arm64-apple-ios</code> and <code class="docutils literal notranslate">arm64-apple-ios-simulator</code> targets at tier 3 (iPhone and iPad devices released after 2013 and the Xcode iOS simulator running on Apple silicon hardware, respectively). <code class="docutils literal notranslate">x86_64-apple-ios-simulator</code> (the Xcode iOS simulator running on older <code class="docutils literal notranslate">x86_64</code> hardware) is not a tier 3 supported platform, but will have best-effort support. (PEP written and implementation contributed by Russell Keith-Magee in <a class="reference external" href="https://github.com/python/cpython/issues/114099">gh-114099</a>.) <a class="pep reference external" href="https://peps.python.org/pep-0738/">PEP 738</a>: Android is now a <a class="pep reference external" href="https://peps.python.org/pep-0011/">PEP 11</a> supported platform, with the <code class="docutils literal notranslate">aarch64-linux-android</code> and <code class="docutils literal notranslate">x86_64-linux-android</code> targets at tier 3. The 32-bit targets <code class="docutils literal notranslate">arm-linux-androideabi</code> and <code class="docutils literal notranslate">i686-linux-android</code> are not tier 3 supported platforms, but will have best-effort support. (PEP written and implementation contributed by Malcolm Smith in <a class="reference external" href="https://github.com/python/cpython/issues/116622">gh-116622</a>.) <div class="admonition seealso"> See also <a class="pep reference external" href="https://peps.python.org/pep-0730/">PEP 730</a>, <a class="pep reference external" href="https://peps.python.org/pep-0738/">PEP 738</a> </div> </section> </section> <section id="other-language-changes"> <h2>Other Language Changes<a class="headerlink" href="#other-language-changes" title="Link to this heading">¶</a></h2> <ul> <li>The compiler now strips common leading whitespace from every line in a docstring. This reduces the size of the <a class="reference internal" href="../glossary.html#term-bytecode">bytecode cache</a> (such as <code class="docutils literal notranslate">.pyc</code> files), with reductions in file size of around 5%, for example in <code class="xref py py-mod docutils literal notranslate">sqlalchemy.orm.session</code> from SQLAlchemy 2.0. This change affects tools that use docstrings, such as <a class="reference internal" href="../library/doctest.html#module-doctest" title="doctest: Test pieces of code within docstrings."><code class="xref py py-mod docutils literal notranslate">doctest</code></a>. <div class="highlight-pycon notranslate"><div class="highlight"><pre>>>> def spam(): ... """ ... This is a docstring with ... leading whitespace. ... ... It even has multiple paragraphs! ... """ ... >>> spam.__doc__ '\nThis is a docstring with\n leading whitespace.\n\nIt even has multiple paragraphs!\n' </pre></div> </div> (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/81283">gh-81283</a>.) </li> <li><a class="reference internal" href="../reference/executionmodel.html#annotation-scopes">Annotation scopes</a> within class scopes can now contain lambdas and comprehensions. Comprehensions that are located within class scopes are not inlined into their parent scope. <div class="highlight-python notranslate"><div class="highlight"><pre>class C[T]: type Alias = lambda: T </pre></div> </div> (Contributed by Jelle Zijlstra in <a class="reference external" href="https://github.com/python/cpython/issues/109118">gh-109118</a> and <a class="reference external" href="https://github.com/python/cpython/issues/118160">gh-118160</a>.) </li> <li><a class="reference internal" href="../reference/simple_stmts.html#future">Future statements</a> are no longer triggered by relative imports of the <a class="reference internal" href="../library/__future__.html#module-__future__" title="__future__: Future statement definitions"><code class="xref py py-mod docutils literal notranslate">__future__</code></a> module, meaning that statements of the form <code class="docutils literal notranslate">from .__future__ import ...</code> are now simply standard relative imports, with no special features activated. (Contributed by Jeremiah Gabriel Pascual in <a class="reference external" href="https://github.com/python/cpython/issues/118216">gh-118216</a>.)</li> <li><a class="reference internal" href="../reference/simple_stmts.html#global"><code class="xref std std-keyword docutils literal notranslate">global</code></a> declarations are now permitted in <a class="reference internal" href="../reference/compound_stmts.html#except"><code class="xref std std-keyword docutils literal notranslate">except</code></a> blocks when that global is used in the <a class="reference internal" href="../reference/compound_stmts.html#else"><code class="xref std std-keyword docutils literal notranslate">else</code></a> block. Previously this raised an erroneous <a class="reference internal" href="../library/exceptions.html#SyntaxError" title="SyntaxError"><code class="xref py py-exc docutils literal notranslate">SyntaxError</code></a>. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/111123">gh-111123</a>.)</li> <li>Add <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_FROZEN_MODULES"><code class="xref std std-envvar docutils literal notranslate">PYTHON_FROZEN_MODULES</code></a>, a new environment variable that determines whether frozen modules are ignored by the import machinery, equivalent to the <a class="reference internal" href="../using/cmdline.html#cmdoption-X"><code class="xref std std-option docutils literal notranslate">-X frozen_modules</code></a> command-line option. (Contributed by Yilei Yang in <a class="reference external" href="https://github.com/python/cpython/issues/111374">gh-111374</a>.)</li> <li>Add <a class="reference internal" href="../howto/perf_profiling.html#perf-profiling">support for the perf profiler</a> working without <a class="reference external" href="https://en.wikipedia.org/wiki/Call_stack">frame pointers</a> through the new environment variable <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_PERF_JIT_SUPPORT"><code class="xref std std-envvar docutils literal notranslate">PYTHON_PERF_JIT_SUPPORT</code></a> and command-line option <a class="reference internal" href="../using/cmdline.html#cmdoption-X"><code class="xref std std-option docutils literal notranslate">-X perf_jit</code></a>. (Contributed by Pablo Galindo in <a class="reference external" href="https://github.com/python/cpython/issues/118518">gh-118518</a>.)</li> <li>The location of a <code class="file docutils literal notranslate">.python_history</code> file can be changed via the new <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_HISTORY"><code class="xref std std-envvar docutils literal notranslate">PYTHON_HISTORY</code></a> environment variable. (Contributed by Levi Sabah, Zackery Spytz and Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/73965">gh-73965</a>.)</li> <li>Classes have a new <a class="reference internal" href="../reference/datamodel.html#type.__static_attributes__" title="type.__static_attributes__"><code class="xref py py-attr docutils literal notranslate">__static_attributes__</code></a> attribute. This is populated by the compiler with a tuple of the class’s attribute names which are assigned through <code class="docutils literal notranslate">self.<name></code> from any function in its body. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/115775">gh-115775</a>.)</li> <li>The compiler now creates a <code class="xref py py-attr docutils literal notranslate">__firstlineno__</code> attribute on classes with the line number of the first line of the class definition. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/118465">gh-118465</a>.)</li> <li>The <a class="reference internal" href="../library/functions.html#exec" title="exec"><code class="xref py py-func docutils literal notranslate">exec()</code></a> and <a class="reference internal" href="../library/functions.html#eval" title="eval"><code class="xref py py-func docutils literal notranslate">eval()</code></a> builtins now accept the globals and locals arguments as keywords. (Contributed by Raphael Gaschignard in <a class="reference external" href="https://github.com/python/cpython/issues/105879">gh-105879</a>)</li> <li>The <a class="reference internal" href="../library/functions.html#compile" title="compile"><code class="xref py py-func docutils literal notranslate">compile()</code></a> builtin now accepts a new flag, <code class="docutils literal notranslate">ast.PyCF_OPTIMIZED_AST</code>, which is similar to <code class="docutils literal notranslate">ast.PyCF_ONLY_AST</code> except that the returned AST is optimized according to the value of the optimize argument. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/108113">gh-108113</a>).</li> <li>Add a <a class="reference internal" href="../library/functions.html#property.__name__" title="property.__name__"><code class="xref py py-attr docutils literal notranslate">__name__</code></a> attribute on <a class="reference internal" href="../library/functions.html#property" title="property"><code class="xref py py-class docutils literal notranslate">property</code></a> objects. (Contributed by Eugene Toder in <a class="reference external" href="https://github.com/python/cpython/issues/101860">gh-101860</a>.)</li> <li>Add <a class="reference internal" href="../library/exceptions.html#PythonFinalizationError" title="PythonFinalizationError"><code class="xref py py-exc docutils literal notranslate">PythonFinalizationError</code></a>, a new exception derived from <a class="reference internal" href="../library/exceptions.html#RuntimeError" title="RuntimeError"><code class="xref py py-exc docutils literal notranslate">RuntimeError</code></a> and used to signal when operations are blocked during <a class="reference internal" href="../glossary.html#term-interpreter-shutdown">finalization</a>. The following callables now raise <code class="xref py py-exc docutils literal notranslate">PythonFinalizationError</code>, instead of <a class="reference internal" href="../library/exceptions.html#RuntimeError" title="RuntimeError"><code class="xref py py-exc docutils literal notranslate">RuntimeError</code></a>: <ul class="simple"> <li><a class="reference internal" href="../library/_thread.html#thread.start_new_thread" title="_thread.start_new_thread"><code class="xref py py-func docutils literal notranslate">_thread.start_new_thread()</code></a></li> <li><a class="reference internal" href="../library/os.html#os.fork" title="os.fork"><code class="xref py py-func docutils literal notranslate">os.fork()</code></a></li> <li><a class="reference internal" href="../library/os.html#os.forkpty" title="os.forkpty"><code class="xref py py-func docutils literal notranslate">os.forkpty()</code></a></li> <li><a class="reference internal" href="../library/subprocess.html#subprocess.Popen" title="subprocess.Popen"><code class="xref py py-class docutils literal notranslate">subprocess.Popen</code></a></li> </ul> (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/114570">gh-114570</a>.) </li> <li>Allow the count argument of <a class="reference internal" href="../library/stdtypes.html#str.replace" title="str.replace"><code class="xref py py-meth docutils literal notranslate">str.replace()</code></a> to be a keyword. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/106487">gh-106487</a>.)</li> <li>Many functions now emit a warning if a boolean value is passed as a file descriptor argument. This can help catch some errors earlier. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/82626">gh-82626</a>.)</li> <li>Added <code class="xref py py-attr docutils literal notranslate">name</code> and <code class="xref py py-attr docutils literal notranslate">mode</code> attributes for compressed and archived file-like objects in the <a class="reference internal" href="../library/bz2.html#module-bz2" title="bz2: Interfaces for bzip2 compression and decompression."><code class="xref py py-mod docutils literal notranslate">bz2</code></a>, <a class="reference internal" href="../library/lzma.html#module-lzma" title="lzma: A Python wrapper for the liblzma compression library."><code class="xref py py-mod docutils literal notranslate">lzma</code></a>, <a class="reference internal" href="../library/tarfile.html#module-tarfile" title="tarfile: Read and write tar-format archive files."><code class="xref py py-mod docutils literal notranslate">tarfile</code></a>, and <a class="reference internal" href="../library/zipfile.html#module-zipfile" title="zipfile: Read and write ZIP-format archive files."><code class="xref py py-mod docutils literal notranslate">zipfile</code></a> modules. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/115961">gh-115961</a>.)</li> </ul> </section> <section id="new-modules"> <h2>New Modules<a class="headerlink" href="#new-modules" title="Link to this heading">¶</a></h2> <ul class="simple"> <li><a class="reference internal" href="../library/dbm.html#module-dbm.sqlite3" title="dbm.sqlite3: SQLite backend for dbm (All)"><code class="xref py py-mod docutils literal notranslate">dbm.sqlite3</code></a>: An SQLite backend for <a class="reference internal" href="../library/dbm.html#module-dbm" title="dbm: Interfaces to various Unix "database" formats."><code class="xref py py-mod docutils literal notranslate">dbm</code></a>. (Contributed by Raymond Hettinger and Erlend E. Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/100414">gh-100414</a>.)</li> </ul> </section> <section id="improved-modules"> <h2>Improved Modules<a class="headerlink" href="#improved-modules" title="Link to this heading">¶</a></h2> <section id="argparse"> <h3>argparse<a class="headerlink" href="#argparse" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the deprecated parameter to the <a class="reference internal" href="../library/argparse.html#argparse.ArgumentParser.add_argument" title="argparse.ArgumentParser.add_argument"><code class="xref py py-meth docutils literal notranslate">add_argument()</code></a> and <code class="xref py py-meth docutils literal notranslate">add_parser()</code> methods, to enable deprecating command-line options, positional arguments, and subcommands. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/83648">gh-83648</a>.)</li> </ul> </section> <section id="array"> <h3>array<a class="headerlink" href="#array" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the <code class="docutils literal notranslate">'w'</code> type code (<code class="docutils literal notranslate">Py_UCS4</code>) for Unicode characters. It should be used instead of the deprecated <code class="docutils literal notranslate">'u'</code> type code. (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/80480">gh-80480</a>.)</li> <li>Register <a class="reference internal" href="../library/array.html#array.array" title="array.array"><code class="xref py py-class docutils literal notranslate">array.array</code></a> as a <a class="reference internal" href="../library/collections.abc.html#collections.abc.MutableSequence" title="collections.abc.MutableSequence"><code class="xref py py-class docutils literal notranslate">MutableSequence</code></a> by implementing the <a class="reference internal" href="../library/array.html#array.array.clear" title="array.array.clear"><code class="xref py py-meth docutils literal notranslate">clear()</code></a> method. (Contributed by Mike Zimin in <a class="reference external" href="https://github.com/python/cpython/issues/114894">gh-114894</a>.)</li> </ul> </section> <section id="ast"> <h3>ast<a class="headerlink" href="#ast" title="Link to this heading">¶</a></h3> <ul> <li>The constructors of node types in the <a class="reference internal" href="../library/ast.html#module-ast" title="ast: Abstract Syntax Tree classes and manipulation."><code class="xref py py-mod docutils literal notranslate">ast</code></a> module are now stricter in the arguments they accept, with more intuitive behavior when arguments are omitted. If an optional field on an AST node is not included as an argument when constructing an instance, the field will now be set to <code class="docutils literal notranslate">None</code>. Similarly, if a list field is omitted, that field will now be set to an empty list, and if an <code class="xref py py-class docutils literal notranslate">expr_context</code> field is omitted, it defaults to <a class="reference internal" href="../library/ast.html#ast.Load" title="ast.Load"><code class="xref py py-class docutils literal notranslate">Load()</code></a>. (Previously, in all cases, the attribute would be missing on the newly constructed AST node instance.) In all other cases, where a required argument is omitted, the node constructor will emit a <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a>. This will raise an exception in Python 3.15. Similarly, passing a keyword argument to the constructor that does not map to a field on the AST node is now deprecated, and will raise an exception in Python 3.15. These changes do not apply to user-defined subclasses of <a class="reference internal" href="../library/ast.html#ast.AST" title="ast.AST"><code class="xref py py-class docutils literal notranslate">ast.AST</code></a> unless the class opts in to the new behavior by defining the <a class="reference internal" href="../library/ast.html#ast.AST._field_types" title="ast.AST._field_types"><code class="xref py py-attr docutils literal notranslate">AST._field_types</code></a> mapping. (Contributed by Jelle Zijlstra in <a class="reference external" href="https://github.com/python/cpython/issues/105858">gh-105858</a>, <a class="reference external" href="https://github.com/python/cpython/issues/117486">gh-117486</a>, and <a class="reference external" href="https://github.com/python/cpython/issues/118851">gh-118851</a>.) </li> <li><a class="reference internal" href="../library/ast.html#ast.parse" title="ast.parse"><code class="xref py py-func docutils literal notranslate">ast.parse()</code></a> now accepts an optional argument optimize which is passed on to <a class="reference internal" href="../library/functions.html#compile" title="compile"><code class="xref py py-func docutils literal notranslate">compile()</code></a>. This makes it possible to obtain an optimized AST. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/108113">gh-108113</a>.)</li> </ul> </section> <section id="asyncio"> <h3>asyncio<a class="headerlink" href="#asyncio" title="Link to this heading">¶</a></h3> <ul> <li><a class="reference internal" href="../library/asyncio-task.html#asyncio.as_completed" title="asyncio.as_completed"><code class="xref py py-func docutils literal notranslate">asyncio.as_completed()</code></a> now returns an object that is both an <a class="reference internal" href="../glossary.html#term-asynchronous-iterator">asynchronous iterator</a> and a plain <a class="reference internal" href="../glossary.html#term-iterator">iterator</a> of <a class="reference internal" href="../glossary.html#term-awaitable">awaitables</a>. The awaitables yielded by asynchronous iteration include original task or future objects that were passed in, making it easier to associate results with the tasks being completed. (Contributed by Justin Arthur in <a class="reference external" href="https://github.com/python/cpython/issues/77714">gh-77714</a>.)</li> <li><a class="reference internal" href="../library/asyncio-eventloop.html#asyncio.loop.create_unix_server" title="asyncio.loop.create_unix_server"><code class="xref py py-meth docutils literal notranslate">asyncio.loop.create_unix_server()</code></a> will now automatically remove the Unix socket when the server is closed. (Contributed by Pierre Ossman in <a class="reference external" href="https://github.com/python/cpython/issues/111246">gh-111246</a>.)</li> <li><a class="reference internal" href="../library/asyncio-protocol.html#asyncio.DatagramTransport.sendto" title="asyncio.DatagramTransport.sendto"><code class="xref py py-meth docutils literal notranslate">DatagramTransport.sendto()</code></a> will now send zero-length datagrams if called with an empty bytes object. The transport flow control also now accounts for the datagram header when calculating the buffer size. (Contributed by Jamie Phan in <a class="reference external" href="https://github.com/python/cpython/issues/115199">gh-115199</a>.)</li> <li>Add <a class="reference internal" href="../library/asyncio-queue.html#asyncio.Queue.shutdown" title="asyncio.Queue.shutdown"><code class="xref py py-meth docutils literal notranslate">Queue.shutdown</code></a> and <a class="reference internal" href="../library/asyncio-queue.html#asyncio.QueueShutDown" title="asyncio.QueueShutDown"><code class="xref py py-exc docutils literal notranslate">QueueShutDown</code></a> to manage queue termination. (Contributed by Laurie Opperman and Yves Duprat in <a class="reference external" href="https://github.com/python/cpython/issues/104228">gh-104228</a>.)</li> <li>Add the <a class="reference internal" href="../library/asyncio-eventloop.html#asyncio.Server.close_clients" title="asyncio.Server.close_clients"><code class="xref py py-meth docutils literal notranslate">Server.close_clients()</code></a> and <a class="reference internal" href="../library/asyncio-eventloop.html#asyncio.Server.abort_clients" title="asyncio.Server.abort_clients"><code class="xref py py-meth docutils literal notranslate">Server.abort_clients()</code></a> methods, which more forcefully close an asyncio server. (Contributed by Pierre Ossman in <a class="reference external" href="https://github.com/python/cpython/issues/113538">gh-113538</a>.)</li> <li>Accept a tuple of separators in <a class="reference internal" href="../library/asyncio-stream.html#asyncio.StreamReader.readuntil" title="asyncio.StreamReader.readuntil"><code class="xref py py-meth docutils literal notranslate">StreamReader.readuntil()</code></a>, stopping when any one of them is encountered. (Contributed by Bruce Merry in <a class="reference external" href="https://github.com/python/cpython/issues/81322">gh-81322</a>.)</li> <li>Improve the behavior of <a class="reference internal" href="../library/asyncio-task.html#asyncio.TaskGroup" title="asyncio.TaskGroup"><code class="xref py py-class docutils literal notranslate">TaskGroup</code></a> when an external cancellation collides with an internal cancellation. For example, when two task groups are nested and both experience an exception in a child task simultaneously, it was possible that the outer task group would hang, because its internal cancellation was swallowed by the inner task group. In the case where a task group is cancelled externally and also must raise an <a class="reference internal" href="../library/exceptions.html#ExceptionGroup" title="ExceptionGroup"><code class="xref py py-exc docutils literal notranslate">ExceptionGroup</code></a>, it will now call the parent task’s <a class="reference internal" href="../library/asyncio-task.html#asyncio.Task.cancel" title="asyncio.Task.cancel"><code class="xref py py-meth docutils literal notranslate">cancel()</code></a> method. This ensures that a <a class="reference internal" href="../library/asyncio-exceptions.html#asyncio.CancelledError" title="asyncio.CancelledError"><code class="xref py py-exc docutils literal notranslate">CancelledError</code></a> will be raised at the next <a class="reference internal" href="../reference/expressions.html#await"><code class="xref std std-keyword docutils literal notranslate">await</code></a>, so the cancellation is not lost. An added benefit of these changes is that task groups now preserve the cancellation count (<a class="reference internal" href="../library/asyncio-task.html#asyncio.Task.cancelling" title="asyncio.Task.cancelling"><code class="xref py py-meth docutils literal notranslate">cancelling()</code></a>). In order to handle some corner cases, <a class="reference internal" href="../library/asyncio-task.html#asyncio.Task.uncancel" title="asyncio.Task.uncancel"><code class="xref py py-meth docutils literal notranslate">uncancel()</code></a> may now reset the undocumented <code class="docutils literal notranslate">_must_cancel</code> flag when the cancellation count reaches zero. (Inspired by an issue reported by Arthur Tacca in <a class="reference external" href="https://github.com/python/cpython/issues/116720">gh-116720</a>.) </li> <li>When <a class="reference internal" href="../library/asyncio-task.html#asyncio.TaskGroup.create_task" title="asyncio.TaskGroup.create_task"><code class="xref py py-meth docutils literal notranslate">TaskGroup.create_task()</code></a> is called on an inactive <a class="reference internal" href="../library/asyncio-task.html#asyncio.TaskGroup" title="asyncio.TaskGroup"><code class="xref py py-class docutils literal notranslate">TaskGroup</code></a>, the given coroutine will be closed (which prevents a <a class="reference internal" href="../library/exceptions.html#RuntimeWarning" title="RuntimeWarning"><code class="xref py py-exc docutils literal notranslate">RuntimeWarning</code></a> about the given coroutine being never awaited). (Contributed by Arthur Tacca and Jason Zhang in <a class="reference external" href="https://github.com/python/cpython/issues/115957">gh-115957</a>.)</li> </ul> </section> <section id="base64"> <h3>base64<a class="headerlink" href="#base64" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/base64.html#base64.z85encode" title="base64.z85encode"><code class="xref py py-func docutils literal notranslate">z85encode()</code></a> and <a class="reference internal" href="../library/base64.html#base64.z85decode" title="base64.z85decode"><code class="xref py py-func docutils literal notranslate">z85decode()</code></a> functions for encoding <a class="reference internal" href="../library/stdtypes.html#bytes" title="bytes"><code class="xref py py-class docutils literal notranslate">bytes</code></a> as <a class="reference external" href="https://rfc.zeromq.org/spec/32/">Z85 data</a> and decoding Z85-encoded data to <code class="xref py py-class docutils literal notranslate">bytes</code>. (Contributed by Matan Perelman in <a class="reference external" href="https://github.com/python/cpython/issues/75299">gh-75299</a>.) </li> </ul> </section> <section id="compileall"> <h3>compileall<a class="headerlink" href="#compileall" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The default number of worker threads and processes is now selected using <a class="reference internal" href="../library/os.html#os.process_cpu_count" title="os.process_cpu_count"><code class="xref py py-func docutils literal notranslate">os.process_cpu_count()</code></a> instead of <a class="reference internal" href="../library/os.html#os.cpu_count" title="os.cpu_count"><code class="xref py py-func docutils literal notranslate">os.cpu_count()</code></a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/109649">gh-109649</a>.)</li> </ul> </section> <section id="concurrent-futures"> <h3>concurrent.futures<a class="headerlink" href="#concurrent-futures" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The default number of worker threads and processes is now selected using <a class="reference internal" href="../library/os.html#os.process_cpu_count" title="os.process_cpu_count"><code class="xref py py-func docutils literal notranslate">os.process_cpu_count()</code></a> instead of <a class="reference internal" href="../library/os.html#os.cpu_count" title="os.cpu_count"><code class="xref py py-func docutils literal notranslate">os.cpu_count()</code></a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/109649">gh-109649</a>.)</li> </ul> </section> <section id="configparser"> <h3>configparser<a class="headerlink" href="#configparser" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/configparser.html#configparser.ConfigParser" title="configparser.ConfigParser"><code class="xref py py-class docutils literal notranslate">ConfigParser</code></a> now has support for unnamed sections, which allows for top-level key-value pairs. This can be enabled with the new allow_unnamed_section parameter. (Contributed by Pedro Sousa Lacerda in <a class="reference external" href="https://github.com/python/cpython/issues/66449">gh-66449</a>.)</li> </ul> </section> <section id="copy"> <h3>copy<a class="headerlink" href="#copy" title="Link to this heading">¶</a></h3> <ul> <li>The new <a class="reference internal" href="../library/copy.html#copy.replace" title="copy.replace"><code class="xref py py-func docutils literal notranslate">replace()</code></a> function and the <a class="reference internal" href="../library/copy.html#object.__replace__" title="object.__replace__"><code class="xref py py-meth docutils literal notranslate">replace protocol</code></a> make creating modified copies of objects much simpler. This is especially useful when working with immutable objects. The following types support the <a class="reference internal" href="../library/copy.html#copy.replace" title="copy.replace"><code class="xref py py-func docutils literal notranslate">replace()</code></a> function and implement the replace protocol: <ul class="simple"> <li><a class="reference internal" href="../library/collections.html#collections.namedtuple" title="collections.namedtuple"><code class="xref py py-func docutils literal notranslate">collections.namedtuple()</code></a></li> <li><a class="reference internal" href="../library/dataclasses.html#dataclasses.dataclass" title="dataclasses.dataclass"><code class="xref py py-class docutils literal notranslate">dataclasses.dataclass</code></a></li> <li><a class="reference internal" href="../library/datetime.html#datetime.datetime" title="datetime.datetime"><code class="xref py py-class docutils literal notranslate">datetime.datetime</code></a>, <a class="reference internal" href="../library/datetime.html#datetime.date" title="datetime.date"><code class="xref py py-class docutils literal notranslate">datetime.date</code></a>, <a class="reference internal" href="../library/datetime.html#datetime.time" title="datetime.time"><code class="xref py py-class docutils literal notranslate">datetime.time</code></a></li> <li><a class="reference internal" href="../library/inspect.html#inspect.Signature" title="inspect.Signature"><code class="xref py py-class docutils literal notranslate">inspect.Signature</code></a>, <a class="reference internal" href="../library/inspect.html#inspect.Parameter" title="inspect.Parameter"><code class="xref py py-class docutils literal notranslate">inspect.Parameter</code></a></li> <li><a class="reference internal" href="../library/types.html#types.SimpleNamespace" title="types.SimpleNamespace"><code class="xref py py-class docutils literal notranslate">types.SimpleNamespace</code></a></li> <li><a class="reference internal" href="../reference/datamodel.html#code-objects">code objects</a></li> </ul> Any user-defined class can also support <a class="reference internal" href="../library/copy.html#copy.replace" title="copy.replace"><code class="xref py py-func docutils literal notranslate">copy.replace()</code></a> by defining the <a class="reference internal" href="../library/copy.html#object.__replace__" title="object.__replace__"><code class="xref py py-meth docutils literal notranslate">__replace__()</code></a> method. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/108751">gh-108751</a>.) </li> </ul> </section> <section id="ctypes"> <h3>ctypes<a class="headerlink" href="#ctypes" title="Link to this heading">¶</a></h3> <ul> <li>As a consequence of necessary internal refactoring, initialization of internal metaclasses now happens in <code class="docutils literal notranslate">__init__</code> rather than in <code class="docutils literal notranslate">__new__</code>. This affects projects that subclass these internal metaclasses to provide custom initialization. Generally: <ul class="simple"> <li>Custom logic that was done in <code class="docutils literal notranslate">__new__</code> after calling <code class="docutils literal notranslate">super().__new__</code> should be moved to <code class="docutils literal notranslate">__init__</code>.</li> <li>To create a class, call the metaclass, not only the metaclass’s <code class="docutils literal notranslate">__new__</code> method.</li> </ul> See <a class="reference external" href="https://github.com/python/cpython/issues/124520">gh-124520</a> for discussion and links to changes in some affected projects. </li> <li><a class="reference internal" href="../library/ctypes.html#ctypes.Structure" title="ctypes.Structure"><code class="xref py py-class docutils literal notranslate">ctypes.Structure</code></a> objects have a new <a class="reference internal" href="../library/ctypes.html#ctypes.Structure._align_" title="ctypes.Structure._align_"><code class="xref py py-attr docutils literal notranslate">_align_</code></a> attribute which allows the alignment of the structure being packed to/from memory to be specified explicitly. (Contributed by Matt Sanderson in <a class="reference external" href="https://github.com/python/cpython/issues/112433">gh-112433</a>)</li> </ul> </section> <section id="dbm"> <h3>dbm<a class="headerlink" href="#dbm" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/dbm.html#module-dbm.sqlite3" title="dbm.sqlite3: SQLite backend for dbm (All)"><code class="xref py py-mod docutils literal notranslate">dbm.sqlite3</code></a>, a new module which implements an SQLite backend, and make it the default <code class="xref py py-mod docutils literal notranslate">dbm</code> backend. (Contributed by Raymond Hettinger and Erlend E. Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/100414">gh-100414</a>.)</li> <li>Allow removing all items from the database through the new <a class="reference internal" href="../library/dbm.html#dbm.gnu.gdbm.clear" title="dbm.gnu.gdbm.clear"><code class="xref py py-meth docutils literal notranslate">gdbm.clear()</code></a> and <a class="reference internal" href="../library/dbm.html#dbm.ndbm.ndbm.clear" title="dbm.ndbm.ndbm.clear"><code class="xref py py-meth docutils literal notranslate">ndbm.clear()</code></a> methods. (Contributed by Donghee Na in <a class="reference external" href="https://github.com/python/cpython/issues/107122">gh-107122</a>.)</li> </ul> </section> <section id="dis"> <h3>dis<a class="headerlink" href="#dis" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Change the output of <a class="reference internal" href="../library/dis.html#module-dis" title="dis: Disassembler for Python bytecode."><code class="xref py py-mod docutils literal notranslate">dis</code></a> module functions to show logical labels for jump targets and exception handlers, rather than offsets. The offsets can be added with the new <a class="reference internal" href="../library/dis.html#cmdoption-dis-O"><code class="xref std std-option docutils literal notranslate">-O</code></a> command-line option or the show_offsets argument. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/112137">gh-112137</a>.)</li> <li><a class="reference internal" href="../library/dis.html#dis.get_instructions" title="dis.get_instructions"><code class="xref py py-meth docutils literal notranslate">get_instructions()</code></a> no longer represents cache entries as separate instructions. Instead, it returns them as part of the <a class="reference internal" href="../library/dis.html#dis.Instruction" title="dis.Instruction"><code class="xref py py-class docutils literal notranslate">Instruction</code></a>, in the new cache_info field. The show_caches argument to <a class="reference internal" href="../library/dis.html#dis.get_instructions" title="dis.get_instructions"><code class="xref py py-meth docutils literal notranslate">get_instructions()</code></a> is deprecated and no longer has any effect. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/112962">gh-112962</a>.)</li> </ul> </section> <section id="doctest"> <h3>doctest<a class="headerlink" href="#doctest" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/doctest.html#module-doctest" title="doctest: Test pieces of code within docstrings."><code class="xref py py-mod docutils literal notranslate">doctest</code></a> output is now colored by default. This can be controlled via the new <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_COLORS"><code class="xref std std-envvar docutils literal notranslate">PYTHON_COLORS</code></a> environment variable as well as the canonical <a class="reference external" href="https://no-color.org/"><code class="docutils literal notranslate">NO_COLOR</code></a> and <a class="reference external" href="https://force-color.org/"><code class="docutils literal notranslate">FORCE_COLOR</code></a> environment variables. See also <a class="reference internal" href="../using/cmdline.html#using-on-controlling-color">Controlling color</a>. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/117225">gh-117225</a>.)</li> <li>The <a class="reference internal" href="../library/doctest.html#doctest.DocTestRunner.run" title="doctest.DocTestRunner.run"><code class="xref py py-meth docutils literal notranslate">DocTestRunner.run()</code></a> method now counts the number of skipped tests. Add the <a class="reference internal" href="../library/doctest.html#doctest.DocTestRunner.skips" title="doctest.DocTestRunner.skips"><code class="xref py py-attr docutils literal notranslate">DocTestRunner.skips</code></a> and <a class="reference internal" href="../library/doctest.html#doctest.TestResults.skipped" title="doctest.TestResults.skipped"><code class="xref py py-attr docutils literal notranslate">TestResults.skipped</code></a> attributes. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108794">gh-108794</a>.)</li> </ul> </section> <section id="email"> <h3>email<a class="headerlink" href="#email" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Headers with embedded newlines are now quoted on output. The <a class="reference internal" href="../library/email.generator.html#module-email.generator" title="email.generator: Generate flat text email messages from a message structure."><code class="xref py py-mod docutils literal notranslate">generator</code></a> will now refuse to serialize (write) headers that are improperly folded or delimited, such that they would be parsed as multiple headers or joined with adjacent data. If you need to turn this safety feature off, set <a class="reference internal" href="../library/email.policy.html#email.policy.Policy.verify_generated_headers" title="email.policy.Policy.verify_generated_headers"><code class="xref py py-attr docutils literal notranslate">verify_generated_headers</code></a>. (Contributed by Bas Bloemsaat and Petr Viktorin in <a class="reference external" href="https://github.com/python/cpython/issues/121650">gh-121650</a>.)</li> <li><a class="reference internal" href="../library/email.utils.html#email.utils.getaddresses" title="email.utils.getaddresses"><code class="xref py py-func docutils literal notranslate">getaddresses()</code></a> and <a class="reference internal" href="../library/email.utils.html#email.utils.parseaddr" title="email.utils.parseaddr"><code class="xref py py-func docutils literal notranslate">parseaddr()</code></a> now return <code class="docutils literal notranslate">('', '')</code> pairs in more situations where invalid email addresses are encountered instead of potentially inaccurate values. The two functions have a new optional strict parameter (default <code class="docutils literal notranslate">True</code>). To get the old behavior (accepting malformed input), use <code class="docutils literal notranslate">strict=False</code>. <code class="docutils literal notranslate">getattr(email.utils, 'supports_strict_parsing', False)</code> can be used to check if the strict parameter is available. (Contributed by Thomas Dwyer and Victor Stinner for <a class="reference external" href="https://github.com/python/cpython/issues/102988">gh-102988</a> to improve the <a class="cve reference external" href="https://www.cve.org/CVERecord?id=CVE-2023-27043">CVE 2023-27043</a> fix.)</li> </ul> </section> <section id="fractions"> <h3>fractions<a class="headerlink" href="#fractions" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/fractions.html#fractions.Fraction" title="fractions.Fraction"><code class="xref py py-class docutils literal notranslate">Fraction</code></a> objects now support the standard <a class="reference internal" href="../library/string.html#formatspec">format specification mini-language</a> rules for fill, alignment, sign handling, minimum width, and grouping. (Contributed by Mark Dickinson in <a class="reference external" href="https://github.com/python/cpython/issues/111320">gh-111320</a>.)</li> </ul> </section> <section id="glob"> <h3>glob<a class="headerlink" href="#glob" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/glob.html#glob.translate" title="glob.translate"><code class="xref py py-func docutils literal notranslate">translate()</code></a>, a function to convert a path specification with shell-style wildcards to a regular expression. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/72904">gh-72904</a>.)</li> </ul> </section> <section id="importlib"> <h3>importlib<a class="headerlink" href="#importlib" title="Link to this heading">¶</a></h3> <ul> <li>The following functions in <a class="reference internal" href="../library/importlib.resources.html#module-importlib.resources" title="importlib.resources: Package resource reading, opening, and access"><code class="xref py py-mod docutils literal notranslate">importlib.resources</code></a> now allow accessing a directory (or tree) of resources, using multiple positional arguments (the encoding and errors arguments in the text-reading functions are now keyword-only): <ul class="simple"> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.is_resource" title="importlib.resources.is_resource"><code class="xref py py-func docutils literal notranslate">is_resource()</code></a></li> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.open_binary" title="importlib.resources.open_binary"><code class="xref py py-func docutils literal notranslate">open_binary()</code></a></li> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.open_text" title="importlib.resources.open_text"><code class="xref py py-func docutils literal notranslate">open_text()</code></a></li> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.path" title="importlib.resources.path"><code class="xref py py-func docutils literal notranslate">path()</code></a></li> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.read_binary" title="importlib.resources.read_binary"><code class="xref py py-func docutils literal notranslate">read_binary()</code></a></li> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.read_text" title="importlib.resources.read_text"><code class="xref py py-func docutils literal notranslate">read_text()</code></a></li> </ul> These functions are no longer deprecated and are not scheduled for removal. (Contributed by Petr Viktorin in <a class="reference external" href="https://github.com/python/cpython/issues/116608">gh-116608</a>.) </li> <li><a class="reference internal" href="../library/importlib.resources.html#importlib.resources.contents" title="importlib.resources.contents"><code class="xref py py-func docutils literal notranslate">contents()</code></a> remains deprecated in favor of the fully-featured <a class="reference internal" href="../library/importlib.resources.abc.html#importlib.resources.abc.Traversable" title="importlib.resources.abc.Traversable"><code class="xref py py-class docutils literal notranslate">Traversable</code></a> API. However, there is now no plan to remove it. (Contributed by Petr Viktorin in <a class="reference external" href="https://github.com/python/cpython/issues/116608">gh-116608</a>.)</li> </ul> </section> <section id="io"> <h3>io<a class="headerlink" href="#io" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The <a class="reference internal" href="../library/io.html#io.IOBase" title="io.IOBase"><code class="xref py py-class docutils literal notranslate">IOBase</code></a> finalizer now logs any errors raised by the <a class="reference internal" href="../library/io.html#io.IOBase.close" title="io.IOBase.close"><code class="xref py py-meth docutils literal notranslate">close()</code></a> method with <a class="reference internal" href="../library/sys.html#sys.unraisablehook" title="sys.unraisablehook"><code class="xref py py-data docutils literal notranslate">sys.unraisablehook</code></a>. Previously, errors were ignored silently by default, and only logged in <a class="reference internal" href="../library/devmode.html#devmode">Python Development Mode</a> or when using a <a class="reference internal" href="../using/configure.html#debug-build">Python debug build</a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/62948">gh-62948</a>.)</li> </ul> </section> <section id="ipaddress"> <h3>ipaddress<a class="headerlink" href="#ipaddress" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the <a class="reference internal" href="../library/ipaddress.html#ipaddress.IPv4Address.ipv6_mapped" title="ipaddress.IPv4Address.ipv6_mapped"><code class="xref py py-attr docutils literal notranslate">IPv4Address.ipv6_mapped</code></a> property, which returns the IPv4-mapped IPv6 address. (Contributed by Charles Machalow in <a class="reference external" href="https://github.com/python/cpython/issues/109466">gh-109466</a>.)</li> <li>Fix <code class="docutils literal notranslate">is_global</code> and <code class="docutils literal notranslate">is_private</code> behavior in <a class="reference internal" href="../library/ipaddress.html#ipaddress.IPv4Address" title="ipaddress.IPv4Address"><code class="xref py py-class docutils literal notranslate">IPv4Address</code></a>, <a class="reference internal" href="../library/ipaddress.html#ipaddress.IPv6Address" title="ipaddress.IPv6Address"><code class="xref py py-class docutils literal notranslate">IPv6Address</code></a>, <a class="reference internal" href="../library/ipaddress.html#ipaddress.IPv4Network" title="ipaddress.IPv4Network"><code class="xref py py-class docutils literal notranslate">IPv4Network</code></a>, and <a class="reference internal" href="../library/ipaddress.html#ipaddress.IPv6Network" title="ipaddress.IPv6Network"><code class="xref py py-class docutils literal notranslate">IPv6Network</code></a>. (Contributed by Jakub Stasiak in <a class="reference external" href="https://github.com/python/cpython/issues/113171">gh-113171</a>.)</li> </ul> </section> <section id="itertools"> <h3>itertools<a class="headerlink" href="#itertools" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/itertools.html#itertools.batched" title="itertools.batched"><code class="xref py py-func docutils literal notranslate">batched()</code></a> has a new strict parameter, which raises a <a class="reference internal" href="../library/exceptions.html#ValueError" title="ValueError"><code class="xref py py-exc docutils literal notranslate">ValueError</code></a> if the final batch is shorter than the specified batch size. (Contributed by Raymond Hettinger in <a class="reference external" href="https://github.com/python/cpython/issues/113202">gh-113202</a>.)</li> </ul> </section> <section id="marshal"> <h3>marshal<a class="headerlink" href="#marshal" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the allow_code parameter in module functions. Passing <code class="docutils literal notranslate">allow_code=False</code> prevents serialization and de-serialization of code objects which are incompatible between Python versions. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/113626">gh-113626</a>.)</li> </ul> </section> <section id="math"> <h3>math<a class="headerlink" href="#math" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The new function <a class="reference internal" href="../library/math.html#math.fma" title="math.fma"><code class="xref py py-func docutils literal notranslate">fma()</code></a> performs fused multiply-add operations. This computes <code class="docutils literal notranslate">x * y + z</code> with only a single round, and so avoids any intermediate loss of precision. It wraps the <code class="docutils literal notranslate">fma()</code> function provided by C99, and follows the specification of the IEEE 754 “fusedMultiplyAdd” operation for special cases. (Contributed by Mark Dickinson and Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/73468">gh-73468</a>.)</li> </ul> </section> <section id="mimetypes"> <h3>mimetypes<a class="headerlink" href="#mimetypes" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the <a class="reference internal" href="../library/mimetypes.html#mimetypes.guess_file_type" title="mimetypes.guess_file_type"><code class="xref py py-func docutils literal notranslate">guess_file_type()</code></a> function to guess a MIME type from a filesystem path. Using paths with <a class="reference internal" href="../library/mimetypes.html#mimetypes.guess_type" title="mimetypes.guess_type"><code class="xref py py-func docutils literal notranslate">guess_type()</code></a> is now <a class="reference internal" href="../glossary.html#term-soft-deprecated">soft deprecated</a>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/66543">gh-66543</a>.)</li> </ul> </section> <section id="mmap"> <h3>mmap<a class="headerlink" href="#mmap" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/mmap.html#mmap.mmap" title="mmap.mmap"><code class="xref py py-class docutils literal notranslate">mmap</code></a> is now protected from crashing on Windows when the mapped memory is inaccessible due to file system errors or access violations. (Contributed by Jannis Weigend in <a class="reference external" href="https://github.com/python/cpython/issues/118209">gh-118209</a>.)</li> <li><a class="reference internal" href="../library/mmap.html#mmap.mmap" title="mmap.mmap"><code class="xref py py-class docutils literal notranslate">mmap</code></a> has a new <a class="reference internal" href="../library/mmap.html#mmap.mmap.seekable" title="mmap.mmap.seekable"><code class="xref py py-meth docutils literal notranslate">seekable()</code></a> method that can be used when a seekable file-like object is required. The <a class="reference internal" href="../library/mmap.html#mmap.mmap.seek" title="mmap.mmap.seek"><code class="xref py py-meth docutils literal notranslate">seek()</code></a> method now returns the new absolute position. (Contributed by Donghee Na and Sylvie Liberman in <a class="reference external" href="https://github.com/python/cpython/issues/111835">gh-111835</a>.)</li> <li>The new UNIX-only trackfd parameter for <a class="reference internal" href="../library/mmap.html#mmap.mmap" title="mmap.mmap"><code class="xref py py-class docutils literal notranslate">mmap</code></a> controls file descriptor duplication; if false, the file descriptor specified by fileno will not be duplicated. (Contributed by Zackery Spytz and Petr Viktorin in <a class="reference external" href="https://github.com/python/cpython/issues/78502">gh-78502</a>.)</li> </ul> </section> <section id="multiprocessing"> <h3>multiprocessing<a class="headerlink" href="#multiprocessing" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The default number of worker threads and processes is now selected using <a class="reference internal" href="../library/os.html#os.process_cpu_count" title="os.process_cpu_count"><code class="xref py py-func docutils literal notranslate">os.process_cpu_count()</code></a> instead of <a class="reference internal" href="../library/os.html#os.cpu_count" title="os.cpu_count"><code class="xref py py-func docutils literal notranslate">os.cpu_count()</code></a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/109649">gh-109649</a>.)</li> </ul> </section> <section id="os"> <h3>os<a class="headerlink" href="#os" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/os.html#os.process_cpu_count" title="os.process_cpu_count"><code class="xref py py-func docutils literal notranslate">process_cpu_count()</code></a> function to get the number of logical CPU cores usable by the calling thread of the current process. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/109649">gh-109649</a>.)</li> <li><a class="reference internal" href="../library/os.html#os.cpu_count" title="os.cpu_count"><code class="xref py py-func docutils literal notranslate">cpu_count()</code></a> and <a class="reference internal" href="../library/os.html#os.process_cpu_count" title="os.process_cpu_count"><code class="xref py py-func docutils literal notranslate">process_cpu_count()</code></a> can be overridden through the new environment variable <a class="reference internal" href="../using/cmdline.html#envvar-PYTHON_CPU_COUNT"><code class="xref std std-envvar docutils literal notranslate">PYTHON_CPU_COUNT</code></a> or the new command-line option <a class="reference internal" href="../using/cmdline.html#cmdoption-X"><code class="xref std std-option docutils literal notranslate">-X cpu_count</code></a>. This option is useful for users who need to limit CPU resources of a container system without having to modify application code or the container itself. (Contributed by Donghee Na in <a class="reference external" href="https://github.com/python/cpython/issues/109595">gh-109595</a>.)</li> <li>Add a <a class="reference internal" href="../library/os.html#os-timerfd">low level interface</a> to Linux’s <a class="manpage reference external" href="https://manpages.debian.org/timerfd_create(2)">timer file descriptors</a> via <a class="reference internal" href="../library/os.html#os.timerfd_create" title="os.timerfd_create"><code class="xref py py-func docutils literal notranslate">timerfd_create()</code></a>, <a class="reference internal" href="../library/os.html#os.timerfd_settime" title="os.timerfd_settime"><code class="xref py py-func docutils literal notranslate">timerfd_settime()</code></a>, <a class="reference internal" href="../library/os.html#os.timerfd_settime_ns" title="os.timerfd_settime_ns"><code class="xref py py-func docutils literal notranslate">timerfd_settime_ns()</code></a>, <a class="reference internal" href="../library/os.html#os.timerfd_gettime" title="os.timerfd_gettime"><code class="xref py py-func docutils literal notranslate">timerfd_gettime()</code></a>, <a class="reference internal" href="../library/os.html#os.timerfd_gettime_ns" title="os.timerfd_gettime_ns"><code class="xref py py-func docutils literal notranslate">timerfd_gettime_ns()</code></a>, <a class="reference internal" href="../library/os.html#os.TFD_NONBLOCK" title="os.TFD_NONBLOCK"><code class="xref py py-const docutils literal notranslate">TFD_NONBLOCK</code></a>, <a class="reference internal" href="../library/os.html#os.TFD_CLOEXEC" title="os.TFD_CLOEXEC"><code class="xref py py-const docutils literal notranslate">TFD_CLOEXEC</code></a>, <a class="reference internal" href="../library/os.html#os.TFD_TIMER_ABSTIME" title="os.TFD_TIMER_ABSTIME"><code class="xref py py-const docutils literal notranslate">TFD_TIMER_ABSTIME</code></a>, and <a class="reference internal" href="../library/os.html#os.TFD_TIMER_CANCEL_ON_SET" title="os.TFD_TIMER_CANCEL_ON_SET"><code class="xref py py-const docutils literal notranslate">TFD_TIMER_CANCEL_ON_SET</code></a> (Contributed by Masaru Tsuchiyama in <a class="reference external" href="https://github.com/python/cpython/issues/108277">gh-108277</a>.)</li> <li><a class="reference internal" href="../library/os.html#os.lchmod" title="os.lchmod"><code class="xref py py-func docutils literal notranslate">lchmod()</code></a> and the follow_symlinks argument of <a class="reference internal" href="../library/os.html#os.chmod" title="os.chmod"><code class="xref py py-func docutils literal notranslate">chmod()</code></a> are both now available on Windows. Note that the default value of follow_symlinks in <code class="xref py py-func docutils literal notranslate">lchmod()</code> is <code class="docutils literal notranslate">False</code> on Windows. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/59616">gh-59616</a>.)</li> <li><a class="reference internal" href="../library/os.html#os.fchmod" title="os.fchmod"><code class="xref py py-func docutils literal notranslate">fchmod()</code></a> and support for file descriptors in <a class="reference internal" href="../library/os.html#os.chmod" title="os.chmod"><code class="xref py py-func docutils literal notranslate">chmod()</code></a> are both now available on Windows. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/113191">gh-113191</a>.)</li> <li>On Windows, <a class="reference internal" href="../library/os.html#os.mkdir" title="os.mkdir"><code class="xref py py-func docutils literal notranslate">mkdir()</code></a> and <a class="reference internal" href="../library/os.html#os.makedirs" title="os.makedirs"><code class="xref py py-func docutils literal notranslate">makedirs()</code></a> now support passing a mode value of <code class="docutils literal notranslate">0o700</code> to apply access control to the new directory. This implicitly affects <a class="reference internal" href="../library/tempfile.html#tempfile.mkdtemp" title="tempfile.mkdtemp"><code class="xref py py-func docutils literal notranslate">tempfile.mkdtemp()</code></a> and is a mitigation for <a class="cve reference external" href="https://www.cve.org/CVERecord?id=CVE-2024-4030">CVE 2024-4030</a>. Other values for mode continue to be ignored. (Contributed by Steve Dower in <a class="reference external" href="https://github.com/python/cpython/issues/118486">gh-118486</a>.)</li> <li><a class="reference internal" href="../library/os.html#os.posix_spawn" title="os.posix_spawn"><code class="xref py py-func docutils literal notranslate">posix_spawn()</code></a> now accepts <code class="docutils literal notranslate">None</code> for the env argument, which makes the newly spawned process use the current process environment. (Contributed by Jakub Kulik in <a class="reference external" href="https://github.com/python/cpython/issues/113119">gh-113119</a>.)</li> <li><a class="reference internal" href="../library/os.html#os.posix_spawn" title="os.posix_spawn"><code class="xref py py-func docutils literal notranslate">posix_spawn()</code></a> can now use the <a class="reference internal" href="../library/os.html#os.POSIX_SPAWN_CLOSEFROM" title="os.POSIX_SPAWN_CLOSEFROM"><code class="xref py py-attr docutils literal notranslate">POSIX_SPAWN_CLOSEFROM</code></a> attribute in the file_actions parameter on platforms that support <code class="xref c c-func docutils literal notranslate">posix_spawn_file_actions_addclosefrom_np()</code>. (Contributed by Jakub Kulik in <a class="reference external" href="https://github.com/python/cpython/issues/113117">gh-113117</a>.)</li> </ul> </section> <section id="os-path"> <h3>os.path<a class="headerlink" href="#os-path" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/os.path.html#os.path.isreserved" title="os.path.isreserved"><code class="xref py py-func docutils literal notranslate">isreserved()</code></a> to check if a path is reserved on the current system. This function is only available on Windows. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/88569">gh-88569</a>.)</li> <li>On Windows, <a class="reference internal" href="../library/os.path.html#os.path.isabs" title="os.path.isabs"><code class="xref py py-func docutils literal notranslate">isabs()</code></a> no longer considers paths starting with exactly one slash (<code class="docutils literal notranslate">\</code> or <code class="docutils literal notranslate">/</code>) to be absolute. (Contributed by Barney Gale and Jon Foster in <a class="reference external" href="https://github.com/python/cpython/issues/44626">gh-44626</a>.)</li> <li><a class="reference internal" href="../library/os.path.html#os.path.realpath" title="os.path.realpath"><code class="xref py py-func docutils literal notranslate">realpath()</code></a> now resolves MS-DOS style file names even if the file is not accessible. (Contributed by Moonsik Park in <a class="reference external" href="https://github.com/python/cpython/issues/82367">gh-82367</a>.)</li> </ul> </section> <section id="pathlib"> <h3>pathlib<a class="headerlink" href="#pathlib" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/pathlib.html#pathlib.UnsupportedOperation" title="pathlib.UnsupportedOperation"><code class="xref py py-exc docutils literal notranslate">UnsupportedOperation</code></a>, which is raised instead of <a class="reference internal" href="../library/exceptions.html#NotImplementedError" title="NotImplementedError"><code class="xref py py-exc docutils literal notranslate">NotImplementedError</code></a> when a path operation isn’t supported. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/89812">gh-89812</a>.)</li> <li>Add a new constructor for creating <a class="reference internal" href="../library/pathlib.html#pathlib.Path" title="pathlib.Path"><code class="xref py py-class docutils literal notranslate">Path</code></a> objects from ‘file’ URIs (<code class="docutils literal notranslate">file:///</code>), <a class="reference internal" href="../library/pathlib.html#pathlib.Path.from_uri" title="pathlib.Path.from_uri"><code class="xref py py-meth docutils literal notranslate">Path.from_uri()</code></a>. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/107465">gh-107465</a>.)</li> <li>Add <a class="reference internal" href="../library/pathlib.html#pathlib.PurePath.full_match" title="pathlib.PurePath.full_match"><code class="xref py py-meth docutils literal notranslate">PurePath.full_match()</code></a> for matching paths with shell-style wildcards, including the recursive wildcard “<code class="docutils literal notranslate">**</code>”. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/73435">gh-73435</a>.)</li> <li>Add the <a class="reference internal" href="../library/pathlib.html#pathlib.PurePath.parser" title="pathlib.PurePath.parser"><code class="xref py py-attr docutils literal notranslate">PurePath.parser</code></a> class attribute to store the implementation of <a class="reference internal" href="../library/os.path.html#module-os.path" title="os.path: Operations on pathnames."><code class="xref py py-mod docutils literal notranslate">os.path</code></a> used for low-level path parsing and joining. This will be either <code class="xref py py-mod docutils literal notranslate">posixpath</code> or <code class="xref py py-mod docutils literal notranslate">ntpath</code>.</li> <li>Add recurse_symlinks keyword-only argument to <a class="reference internal" href="../library/pathlib.html#pathlib.Path.glob" title="pathlib.Path.glob"><code class="xref py py-meth docutils literal notranslate">Path.glob()</code></a> and <a class="reference internal" href="../library/pathlib.html#pathlib.Path.rglob" title="pathlib.Path.rglob"><code class="xref py py-meth docutils literal notranslate">rglob()</code></a>. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/77609">gh-77609</a>.)</li> <li><a class="reference internal" href="../library/pathlib.html#pathlib.Path.glob" title="pathlib.Path.glob"><code class="xref py py-meth docutils literal notranslate">Path.glob()</code></a> and <a class="reference internal" href="../library/pathlib.html#pathlib.Path.rglob" title="pathlib.Path.rglob"><code class="xref py py-meth docutils literal notranslate">rglob()</code></a> now return files and directories when given a pattern that ends with “<code class="docutils literal notranslate">**</code>”. Previously, only directories were returned. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/70303">gh-70303</a>.)</li> <li>Add the follow_symlinks keyword-only argument to <a class="reference internal" href="../library/pathlib.html#pathlib.Path.is_file" title="pathlib.Path.is_file"><code class="xref py py-meth docutils literal notranslate">Path.is_file</code></a>, <a class="reference internal" href="../library/pathlib.html#pathlib.Path.is_dir" title="pathlib.Path.is_dir"><code class="xref py py-meth docutils literal notranslate">Path.is_dir</code></a>, <a class="reference internal" href="../library/pathlib.html#pathlib.Path.owner" title="pathlib.Path.owner"><code class="xref py py-meth docutils literal notranslate">Path.owner()</code></a>, and <a class="reference internal" href="../library/pathlib.html#pathlib.Path.group" title="pathlib.Path.group"><code class="xref py py-meth docutils literal notranslate">Path.group()</code></a>. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/105793">gh-105793</a> and Kamil Turek in <a class="reference external" href="https://github.com/python/cpython/issues/107962">gh-107962</a>.)</li> </ul> </section> <section id="pdb"> <h3>pdb<a class="headerlink" href="#pdb" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/functions.html#breakpoint" title="breakpoint"><code class="xref py py-func docutils literal notranslate">breakpoint()</code></a> and <a class="reference internal" href="../library/pdb.html#pdb.set_trace" title="pdb.set_trace"><code class="xref py py-func docutils literal notranslate">set_trace()</code></a> now enter the debugger immediately rather than on the next line of code to be executed. This change prevents the debugger from breaking outside of the context when <code class="xref py py-func docutils literal notranslate">breakpoint()</code> is positioned at the end of the context. (Contributed by Tian Gao in <a class="reference external" href="https://github.com/python/cpython/issues/118579">gh-118579</a>.)</li> <li><code class="docutils literal notranslate">sys.path[0]</code> is no longer replaced by the directory of the script being debugged when <a class="reference internal" href="../library/sys.html#sys.flags.safe_path" title="sys.flags.safe_path"><code class="xref py py-attr docutils literal notranslate">sys.flags.safe_path</code></a> is set. (Contributed by Tian Gao and Christian Walther in <a class="reference external" href="https://github.com/python/cpython/issues/111762">gh-111762</a>.)</li> <li><a class="reference internal" href="../library/zipapp.html#module-zipapp" title="zipapp: Manage executable Python zip archives"><code class="xref py py-mod docutils literal notranslate">zipapp</code></a> is now supported as a debugging target. (Contributed by Tian Gao in <a class="reference external" href="https://github.com/python/cpython/issues/118501">gh-118501</a>.)</li> <li>Add ability to move between chained exceptions during post-mortem debugging in <a class="reference internal" href="../library/pdb.html#pdb.pm" title="pdb.pm"><code class="xref py py-func docutils literal notranslate">pm()</code></a> using the new <a class="reference internal" href="../library/pdb.html#pdbcommand-exceptions"><code class="xref std std-pdbcmd docutils literal notranslate">exceptions [exc_number]</code></a> command for Pdb. (Contributed by Matthias Bussonnier in <a class="reference external" href="https://github.com/python/cpython/issues/106676">gh-106676</a>.)</li> <li>Expressions and statements whose prefix is a pdb command are now correctly identified and executed. (Contributed by Tian Gao in <a class="reference external" href="https://github.com/python/cpython/issues/108464">gh-108464</a>.)</li> </ul> </section> <section id="queue"> <h3>queue<a class="headerlink" href="#queue" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/queue.html#queue.Queue.shutdown" title="queue.Queue.shutdown"><code class="xref py py-meth docutils literal notranslate">Queue.shutdown</code></a> and <a class="reference internal" href="../library/queue.html#queue.ShutDown" title="queue.ShutDown"><code class="xref py py-exc docutils literal notranslate">ShutDown</code></a> to manage queue termination. (Contributed by Laurie Opperman and Yves Duprat in <a class="reference external" href="https://github.com/python/cpython/issues/104750">gh-104750</a>.)</li> </ul> </section> <section id="random"> <h3>random<a class="headerlink" href="#random" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add a <a class="reference internal" href="../library/random.html#random-cli">command-line interface</a>. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/118131">gh-118131</a>.)</li> </ul> </section> <section id="re"> <h3>re<a class="headerlink" href="#re" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Rename <code class="xref py py-exc docutils literal notranslate">re.error</code> to <a class="reference internal" href="../library/re.html#re.PatternError" title="re.PatternError"><code class="xref py py-exc docutils literal notranslate">PatternError</code></a> for improved clarity. <code class="xref py py-exc docutils literal notranslate">re.error</code> is kept for backward compatibility.</li> </ul> </section> <section id="shutil"> <h3>shutil<a class="headerlink" href="#shutil" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Support the dir_fd and follow_symlinks keyword arguments in <a class="reference internal" href="../library/shutil.html#shutil.chown" title="shutil.chown"><code class="xref py py-func docutils literal notranslate">chown()</code></a>. (Contributed by Berker Peksag and Tahia K in <a class="reference external" href="https://github.com/python/cpython/issues/62308">gh-62308</a>)</li> </ul> </section> <section id="site"> <h3>site<a class="headerlink" href="#site" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><code class="file docutils literal notranslate">.pth</code> files are now decoded using UTF-8 first, and then with the <a class="reference internal" href="../glossary.html#term-locale-encoding">locale encoding</a> if UTF-8 decoding fails. (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/117802">gh-117802</a>.)</li> </ul> </section> <section id="sqlite3"> <h3>sqlite3<a class="headerlink" href="#sqlite3" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>A <a class="reference internal" href="../library/exceptions.html#ResourceWarning" title="ResourceWarning"><code class="xref py py-exc docutils literal notranslate">ResourceWarning</code></a> is now emitted if a <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection" title="sqlite3.Connection"><code class="xref py py-class docutils literal notranslate">Connection</code></a> object is not <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.close" title="sqlite3.Connection.close"><code class="xref py py-meth docutils literal notranslate">closed</code></a> explicitly. (Contributed by Erlend E. Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/105539">gh-105539</a>.)</li> <li>Add the filter keyword-only parameter to <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.iterdump" title="sqlite3.Connection.iterdump"><code class="xref py py-meth docutils literal notranslate">Connection.iterdump()</code></a> for filtering database objects to dump. (Contributed by Mariusz Felisiak in <a class="reference external" href="https://github.com/python/cpython/issues/91602">gh-91602</a>.)</li> </ul> </section> <section id="ssl"> <h3>ssl<a class="headerlink" href="#ssl" title="Link to this heading">¶</a></h3> <ul> <li>The <a class="reference internal" href="../library/ssl.html#ssl.create_default_context" title="ssl.create_default_context"><code class="xref py py-func docutils literal notranslate">create_default_context()</code></a> API now includes <a class="reference internal" href="../library/ssl.html#ssl.VERIFY_X509_PARTIAL_CHAIN" title="ssl.VERIFY_X509_PARTIAL_CHAIN"><code class="xref py py-data docutils literal notranslate">VERIFY_X509_PARTIAL_CHAIN</code></a> and <a class="reference internal" href="../library/ssl.html#ssl.VERIFY_X509_STRICT" title="ssl.VERIFY_X509_STRICT"><code class="xref py py-data docutils literal notranslate">VERIFY_X509_STRICT</code></a> in its default flags. <div class="admonition note"> Note <a class="reference internal" href="../library/ssl.html#ssl.VERIFY_X509_STRICT" title="ssl.VERIFY_X509_STRICT"><code class="xref py py-data docutils literal notranslate">VERIFY_X509_STRICT</code></a> may reject pre-<a class="rfc reference external" href="https://datatracker.ietf.org/doc/html/rfc5280.html">RFC 5280</a> or malformed certificates that the underlying OpenSSL implementation might otherwise accept. Whilst disabling this is not recommended, you can do so using: <div class="highlight-python notranslate"><div class="highlight"><pre>import ssl ctx = ssl.create_default_context() ctx.verify_flags &= ~ssl.VERIFY_X509_STRICT </pre></div> </div> </div> (Contributed by William Woodruff in <a class="reference external" href="https://github.com/python/cpython/issues/112389">gh-112389</a>.) </li> </ul> </section> <section id="statistics"> <h3>statistics<a class="headerlink" href="#statistics" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/statistics.html#statistics.kde" title="statistics.kde"><code class="xref py py-func docutils literal notranslate">kde()</code></a> for kernel density estimation. This makes it possible to estimate a continuous probability density function from a fixed number of discrete samples. (Contributed by Raymond Hettinger in <a class="reference external" href="https://github.com/python/cpython/issues/115863">gh-115863</a>.)</li> <li>Add <a class="reference internal" href="../library/statistics.html#statistics.kde_random" title="statistics.kde_random"><code class="xref py py-func docutils literal notranslate">kde_random()</code></a> for sampling from an estimated probability density function created by <a class="reference internal" href="../library/statistics.html#statistics.kde" title="statistics.kde"><code class="xref py py-func docutils literal notranslate">kde()</code></a>. (Contributed by Raymond Hettinger in <a class="reference external" href="https://github.com/python/cpython/issues/115863">gh-115863</a>.)</li> </ul> </section> <section id="subprocess"> <h3>subprocess<a class="headerlink" href="#subprocess" title="Link to this heading">¶</a></h3> <ul> <li>The <a class="reference internal" href="../library/subprocess.html#module-subprocess" title="subprocess: Subprocess management."><code class="xref py py-mod docutils literal notranslate">subprocess</code></a> module now uses the <a class="reference internal" href="../library/os.html#os.posix_spawn" title="os.posix_spawn"><code class="xref py py-func docutils literal notranslate">posix_spawn()</code></a> function in more situations. Notably, when close_fds is <code class="docutils literal notranslate">True</code> (the default), <a class="reference internal" href="../library/os.html#os.posix_spawn" title="os.posix_spawn"><code class="xref py py-func docutils literal notranslate">posix_spawn()</code></a> will be used when the C library provides <code class="xref c c-func docutils literal notranslate">posix_spawn_file_actions_addclosefrom_np()</code>, which includes recent versions of Linux, FreeBSD, and Solaris. On Linux, this should perform similarly to the existing Linux <code class="xref c c-func docutils literal notranslate">vfork()</code> based code. A private control knob <code class="xref py py-attr docutils literal notranslate">subprocess._USE_POSIX_SPAWN</code> can be set to <code class="docutils literal notranslate">False</code> if you need to force <a class="reference internal" href="../library/subprocess.html#module-subprocess" title="subprocess: Subprocess management."><code class="xref py py-mod docutils literal notranslate">subprocess</code></a> to never use <a class="reference internal" href="../library/os.html#os.posix_spawn" title="os.posix_spawn"><code class="xref py py-func docutils literal notranslate">posix_spawn()</code></a>. Please report your reason and platform details in the <a class="reference internal" href="../bugs.html#using-the-tracker">issue tracker</a> if you set this so that we can improve our API selection logic for everyone. (Contributed by Jakub Kulik in <a class="reference external" href="https://github.com/python/cpython/issues/113117">gh-113117</a>.) </li> </ul> </section> <section id="sys"> <h3>sys<a class="headerlink" href="#sys" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the <a class="reference internal" href="../library/sys.html#sys._is_interned" title="sys._is_interned"><code class="xref py py-func docutils literal notranslate">_is_interned()</code></a> function to test if a string was interned. This function is not guaranteed to exist in all implementations of Python. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/78573">gh-78573</a>.)</li> </ul> </section> <section id="tempfile"> <h3>tempfile<a class="headerlink" href="#tempfile" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>On Windows, the default mode <code class="docutils literal notranslate">0o700</code> used by <a class="reference internal" href="../library/tempfile.html#tempfile.mkdtemp" title="tempfile.mkdtemp"><code class="xref py py-func docutils literal notranslate">tempfile.mkdtemp()</code></a> now limits access to the new directory due to changes to <a class="reference internal" href="../library/os.html#os.mkdir" title="os.mkdir"><code class="xref py py-func docutils literal notranslate">os.mkdir()</code></a>. This is a mitigation for <a class="cve reference external" href="https://www.cve.org/CVERecord?id=CVE-2024-4030">CVE 2024-4030</a>. (Contributed by Steve Dower in <a class="reference external" href="https://github.com/python/cpython/issues/118486">gh-118486</a>.)</li> </ul> </section> <section id="time"> <h3>time<a class="headerlink" href="#time" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>On Windows, <a class="reference internal" href="../library/time.html#time.monotonic" title="time.monotonic"><code class="xref py py-func docutils literal notranslate">monotonic()</code></a> now uses the <code class="docutils literal notranslate">QueryPerformanceCounter()</code> clock for a resolution of 1 microsecond, instead of the <code class="docutils literal notranslate">GetTickCount64()</code> clock which has a resolution of 15.6 milliseconds. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/88494">gh-88494</a>.)</li> <li>On Windows, <a class="reference internal" href="../library/time.html#time.time" title="time.time"><code class="xref py py-func docutils literal notranslate">time()</code></a> now uses the <code class="docutils literal notranslate">GetSystemTimePreciseAsFileTime()</code> clock for a resolution of 1 microsecond, instead of the <code class="docutils literal notranslate">GetSystemTimeAsFileTime()</code> clock which has a resolution of 15.6 milliseconds. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/63207">gh-63207</a>.)</li> </ul> </section> <section id="tkinter"> <h3>tkinter<a class="headerlink" href="#tkinter" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add <a class="reference internal" href="../library/tkinter.html#module-tkinter" title="tkinter: Interface to Tcl/Tk for graphical user interfaces"><code class="xref py py-mod docutils literal notranslate">tkinter</code></a> widget methods: <code class="xref py py-meth docutils literal notranslate">tk_busy_hold()</code>, <code class="xref py py-meth docutils literal notranslate">tk_busy_configure()</code>, <code class="xref py py-meth docutils literal notranslate">tk_busy_cget()</code>, <code class="xref py py-meth docutils literal notranslate">tk_busy_forget()</code>, <code class="xref py py-meth docutils literal notranslate">tk_busy_current()</code>, and <code class="xref py py-meth docutils literal notranslate">tk_busy_status()</code>. (Contributed by Miguel, klappnase and Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/72684">gh-72684</a>.)</li> <li>The <a class="reference internal" href="../library/tkinter.html#module-tkinter" title="tkinter: Interface to Tcl/Tk for graphical user interfaces"><code class="xref py py-mod docutils literal notranslate">tkinter</code></a> widget method <code class="xref py py-meth docutils literal notranslate">wm_attributes()</code> now accepts the attribute name without the minus prefix to get window attributes, for example <code class="docutils literal notranslate">w.wm_attributes('alpha')</code> and allows specifying attributes and values to set as keyword arguments, for example <code class="docutils literal notranslate">w.wm_attributes(alpha=0.5)</code>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/43457">gh-43457</a>.)</li> <li><code class="xref py py-meth docutils literal notranslate">wm_attributes()</code> can now return attributes as a <a class="reference internal" href="../library/stdtypes.html#dict" title="dict"><code class="xref py py-class docutils literal notranslate">dict</code></a>, by using the new optional keyword-only parameter return_python_dict. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/43457">gh-43457</a>.)</li> <li><code class="xref py py-meth docutils literal notranslate">Text.count()</code> can now return a simple <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a> when the new optional keyword-only parameter return_ints is used. Otherwise, the single count is returned as a 1-tuple or <code class="docutils literal notranslate">None</code>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/97928">gh-97928</a>.)</li> <li>Support the “vsapi” element type in the <a class="reference internal" href="../library/tkinter.ttk.html#tkinter.ttk.Style.element_create" title="tkinter.ttk.Style.element_create"><code class="xref py py-meth docutils literal notranslate">element_create()</code></a> method of <a class="reference internal" href="../library/tkinter.ttk.html#tkinter.ttk.Style" title="tkinter.ttk.Style"><code class="xref py py-class docutils literal notranslate">tkinter.ttk.Style</code></a>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/68166">gh-68166</a>.)</li> <li>Add the <code class="xref py py-meth docutils literal notranslate">after_info()</code> method for Tkinter widgets. (Contributed by Cheryl Sabella in <a class="reference external" href="https://github.com/python/cpython/issues/77020">gh-77020</a>.)</li> <li>Add a new <code class="xref py py-meth docutils literal notranslate">copy_replace()</code> method to <code class="xref py py-class docutils literal notranslate">PhotoImage</code> to copy a region from one image to another, possibly with pixel zooming, subsampling, or both. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/118225">gh-118225</a>.)</li> <li>Add from_coords parameter to the <code class="xref py py-class docutils literal notranslate">PhotoImage</code> methods <code class="xref py py-meth docutils literal notranslate">copy()</code>, <code class="xref py py-meth docutils literal notranslate">zoom()</code> and <code class="xref py py-meth docutils literal notranslate">subsample()</code>. Add zoom and subsample parameters to the <code class="xref py py-class docutils literal notranslate">PhotoImage</code> method <code class="xref py py-meth docutils literal notranslate">copy()</code>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/118225">gh-118225</a>.)</li> <li>Add the <code class="xref py py-class docutils literal notranslate">PhotoImage</code> methods <code class="xref py py-meth docutils literal notranslate">read()</code> to read an image from a file and <code class="xref py py-meth docutils literal notranslate">data()</code> to get the image data. Add background and grayscale parameters to the <code class="xref py py-meth docutils literal notranslate">write()</code> method. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/118271">gh-118271</a>.)</li> </ul> </section> <section id="traceback"> <h3>traceback<a class="headerlink" href="#traceback" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add the <a class="reference internal" href="../library/traceback.html#traceback.TracebackException.exc_type_str" title="traceback.TracebackException.exc_type_str"><code class="xref py py-attr docutils literal notranslate">exc_type_str</code></a> attribute to <a class="reference internal" href="../library/traceback.html#traceback.TracebackException" title="traceback.TracebackException"><code class="xref py py-class docutils literal notranslate">TracebackException</code></a>, which holds a string display of the exc_type. Deprecate the <a class="reference internal" href="../library/traceback.html#traceback.TracebackException.exc_type" title="traceback.TracebackException.exc_type"><code class="xref py py-attr docutils literal notranslate">exc_type</code></a> attribute, which holds the type object itself. Add parameter save_exc_type (default <code class="docutils literal notranslate">True</code>) to indicate whether <code class="docutils literal notranslate">exc_type</code> should be saved. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/112332">gh-112332</a>.)</li> <li>Add a new show_group keyword-only parameter to <a class="reference internal" href="../library/traceback.html#traceback.TracebackException.format_exception_only" title="traceback.TracebackException.format_exception_only"><code class="xref py py-meth docutils literal notranslate">TracebackException.format_exception_only()</code></a> to (recursively) format the nested exceptions of a <a class="reference internal" href="../library/exceptions.html#BaseExceptionGroup" title="BaseExceptionGroup"><code class="xref py py-exc docutils literal notranslate">BaseExceptionGroup</code></a> instance. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/105292">gh-105292</a>.)</li> </ul> </section> <section id="types"> <h3>types<a class="headerlink" href="#types" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="reference internal" href="../library/types.html#types.SimpleNamespace" title="types.SimpleNamespace"><code class="xref py py-class docutils literal notranslate">SimpleNamespace</code></a> can now take a single positional argument to initialise the namespace’s arguments. This argument must either be a mapping or an iterable of key-value pairs. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/108191">gh-108191</a>.)</li> </ul> </section> <section id="typing"> <h3>typing<a class="headerlink" href="#typing" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="pep reference external" href="https://peps.python.org/pep-0705/">PEP 705</a>: Add <a class="reference internal" href="../library/typing.html#typing.ReadOnly" title="typing.ReadOnly"><code class="xref py py-data docutils literal notranslate">ReadOnly</code></a>, a special typing construct to mark a <a class="reference internal" href="../library/typing.html#typing.TypedDict" title="typing.TypedDict"><code class="xref py py-class docutils literal notranslate">TypedDict</code></a> item as read-only for type checkers.</li> <li><a class="pep reference external" href="https://peps.python.org/pep-0742/">PEP 742</a>: Add <a class="reference internal" href="../library/typing.html#typing.TypeIs" title="typing.TypeIs"><code class="xref py py-data docutils literal notranslate">TypeIs</code></a>, a typing construct that can be used to instruct a type checker how to narrow a type.</li> <li>Add <a class="reference internal" href="../library/typing.html#typing.NoDefault" title="typing.NoDefault"><code class="xref py py-data docutils literal notranslate">NoDefault</code></a>, a sentinel object used to represent the defaults of some parameters in the <a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a> module. (Contributed by Jelle Zijlstra in <a class="reference external" href="https://github.com/python/cpython/issues/116126">gh-116126</a>.)</li> <li>Add <a class="reference internal" href="../library/typing.html#typing.get_protocol_members" title="typing.get_protocol_members"><code class="xref py py-func docutils literal notranslate">get_protocol_members()</code></a> to return the set of members defining a <a class="reference internal" href="../library/typing.html#typing.Protocol" title="typing.Protocol"><code class="xref py py-class docutils literal notranslate">typing.Protocol</code></a>. (Contributed by Jelle Zijlstra in <a class="reference external" href="https://github.com/python/cpython/issues/104873">gh-104873</a>.)</li> <li>Add <a class="reference internal" href="../library/typing.html#typing.is_protocol" title="typing.is_protocol"><code class="xref py py-func docutils literal notranslate">is_protocol()</code></a> to check whether a class is a <a class="reference internal" href="../library/typing.html#typing.Protocol" title="typing.Protocol"><code class="xref py py-class docutils literal notranslate">Protocol</code></a>. (Contributed by Jelle Zijlstra in <a class="reference external" href="https://github.com/python/cpython/issues/104873">gh-104873</a>.)</li> <li><a class="reference internal" href="../library/typing.html#typing.ClassVar" title="typing.ClassVar"><code class="xref py py-data docutils literal notranslate">ClassVar</code></a> can now be nested in <a class="reference internal" href="../library/typing.html#typing.Final" title="typing.Final"><code class="xref py py-data docutils literal notranslate">Final</code></a>, and vice versa. (Contributed by Mehdi Drissi in <a class="reference external" href="https://github.com/python/cpython/issues/89547">gh-89547</a>.)</li> </ul> </section> <section id="unicodedata"> <h3>unicodedata<a class="headerlink" href="#unicodedata" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Update the Unicode database to <a class="reference external" href="https://www.unicode.org/versions/Unicode15.1.0/">version 15.1.0</a>. (Contributed by James Gerity in <a class="reference external" href="https://github.com/python/cpython/issues/109559">gh-109559</a>.) </li> </ul> </section> <section id="venv"> <h3>venv<a class="headerlink" href="#venv" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add support for creating source control management (SCM) ignore files in a virtual environment’s directory. By default, Git is supported. This is implemented as opt-in via the API, which can be extended to support other SCMs (<a class="reference internal" href="../library/venv.html#venv.EnvBuilder" title="venv.EnvBuilder"><code class="xref py py-class docutils literal notranslate">EnvBuilder</code></a> and <a class="reference internal" href="../library/venv.html#venv.create" title="venv.create"><code class="xref py py-func docutils literal notranslate">create()</code></a>), and opt-out via the CLI, using <code class="xref std std-option docutils literal notranslate">--without-scm-ignore-files</code>. (Contributed by Brett Cannon in <a class="reference external" href="https://github.com/python/cpython/issues/108125">gh-108125</a>.)</li> </ul> </section> <section id="warnings"> <h3>warnings<a class="headerlink" href="#warnings" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><a class="pep reference external" href="https://peps.python.org/pep-0702/">PEP 702</a>: The new <a class="reference internal" href="../library/warnings.html#warnings.deprecated" title="warnings.deprecated"><code class="xref py py-func docutils literal notranslate">warnings.deprecated()</code></a> decorator provides a way to communicate deprecations to a <a class="reference internal" href="../glossary.html#term-static-type-checker">static type checker</a> and to warn on usage of deprecated classes and functions. A <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a> may also be emitted when a decorated function or class is used at runtime. (Contributed by Jelle Zijlstra in <a class="reference external" href="https://github.com/python/cpython/issues/104003">gh-104003</a>.)</li> </ul> </section> <section id="xml"> <h3>xml<a class="headerlink" href="#xml" title="Link to this heading">¶</a></h3> <ul> <li>Allow controlling Expat >=2.6.0 reparse deferral (<a class="cve reference external" href="https://www.cve.org/CVERecord?id=CVE-2023-52425">CVE 2023-52425</a>) by adding five new methods: <ul class="simple"> <li><a class="reference internal" href="../library/xml.etree.elementtree.html#xml.etree.ElementTree.XMLParser.flush" title="xml.etree.ElementTree.XMLParser.flush"><code class="xref py py-meth docutils literal notranslate">xml.etree.ElementTree.XMLParser.flush()</code></a></li> <li><a class="reference internal" href="../library/xml.etree.elementtree.html#xml.etree.ElementTree.XMLPullParser.flush" title="xml.etree.ElementTree.XMLPullParser.flush"><code class="xref py py-meth docutils literal notranslate">xml.etree.ElementTree.XMLPullParser.flush()</code></a></li> <li><a class="reference internal" href="../library/pyexpat.html#xml.parsers.expat.xmlparser.GetReparseDeferralEnabled" title="xml.parsers.expat.xmlparser.GetReparseDeferralEnabled"><code class="xref py py-meth docutils literal notranslate">xml.parsers.expat.xmlparser.GetReparseDeferralEnabled()</code></a></li> <li><a class="reference internal" href="../library/pyexpat.html#xml.parsers.expat.xmlparser.SetReparseDeferralEnabled" title="xml.parsers.expat.xmlparser.SetReparseDeferralEnabled"><code class="xref py py-meth docutils literal notranslate">xml.parsers.expat.xmlparser.SetReparseDeferralEnabled()</code></a></li> <li><code class="xref py py-meth docutils literal notranslate">xml.sax.expatreader.ExpatParser.flush()</code></li> </ul> (Contributed by Sebastian Pipping in <a class="reference external" href="https://github.com/python/cpython/issues/115623">gh-115623</a>.) </li> <li>Add the <code class="xref py py-meth docutils literal notranslate">close()</code> method for the iterator returned by <a class="reference internal" href="../library/xml.etree.elementtree.html#xml.etree.ElementTree.iterparse" title="xml.etree.ElementTree.iterparse"><code class="xref py py-func docutils literal notranslate">iterparse()</code></a> for explicit cleanup. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/69893">gh-69893</a>.)</li> </ul> </section> <section id="zipimport"> <h3>zipimport<a class="headerlink" href="#zipimport" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Add support for <a class="reference external" href="https://en.wikipedia.org/wiki/Zip_(file_format)#ZIP64">ZIP64</a> format files. Everybody loves huge data, right? (Contributed by Tim Hatch in <a class="reference external" href="https://github.com/python/cpython/issues/94146">gh-94146</a>.) </li> </ul> </section> </section> <section id="optimizations"> <h2>Optimizations<a class="headerlink" href="#optimizations" title="Link to this heading">¶</a></h2> <ul class="simple"> <li>Several standard library modules have had their import times significantly improved. For example, the import time of the <a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a> module has been reduced by around a third by removing dependencies on <a class="reference internal" href="../library/re.html#module-re" title="re: Regular expression operations."><code class="xref py py-mod docutils literal notranslate">re</code></a> and <a class="reference internal" href="../library/contextlib.html#module-contextlib" title="contextlib: Utilities for with-statement contexts."><code class="xref py py-mod docutils literal notranslate">contextlib</code></a>. Other modules to enjoy import-time speedups include <a class="reference internal" href="../library/email.utils.html#module-email.utils" title="email.utils: Miscellaneous email package utilities."><code class="xref py py-mod docutils literal notranslate">email.utils</code></a>, <a class="reference internal" href="../library/enum.html#module-enum" title="enum: Implementation of an enumeration class."><code class="xref py py-mod docutils literal notranslate">enum</code></a>, <a class="reference internal" href="../library/functools.html#module-functools" title="functools: Higher-order functions and operations on callable objects."><code class="xref py py-mod docutils literal notranslate">functools</code></a>, <a class="reference internal" href="../library/importlib.metadata.html#module-importlib.metadata" title="importlib.metadata: Accessing package metadata"><code class="xref py py-mod docutils literal notranslate">importlib.metadata</code></a>, and <a class="reference internal" href="../library/threading.html#module-threading" title="threading: Thread-based parallelism."><code class="xref py py-mod docutils literal notranslate">threading</code></a>. (Contributed by Alex Waygood, Shantanu Jain, Adam Turner, Daniel Hollas, and others in <a class="reference external" href="https://github.com/python/cpython/issues/109653">gh-109653</a>.)</li> <li><a class="reference internal" href="../library/textwrap.html#textwrap.indent" title="textwrap.indent"><code class="xref py py-func docutils literal notranslate">textwrap.indent()</code></a> is now around 30% faster than before for large input. (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/107369">gh-107369</a>.)</li> <li>The <a class="reference internal" href="../library/subprocess.html#module-subprocess" title="subprocess: Subprocess management."><code class="xref py py-mod docutils literal notranslate">subprocess</code></a> module now uses the <a class="reference internal" href="../library/os.html#os.posix_spawn" title="os.posix_spawn"><code class="xref py py-func docutils literal notranslate">posix_spawn()</code></a> function in more situations, including when close_fds is <code class="docutils literal notranslate">True</code> (the default) on many modern platforms. This should provide a notable performance increase when launching processes on FreeBSD and Solaris. See the <a class="reference internal" href="#whatsnew313-subprocess">subprocess</a> section above for details. (Contributed by Jakub Kulik in <a class="reference external" href="https://github.com/python/cpython/issues/113117">gh-113117</a>.)</li> </ul> </section> <section id="removed-modules-and-apis"> <h2>Removed Modules And APIs<a class="headerlink" href="#removed-modules-and-apis" title="Link to this heading">¶</a></h2> <section id="pep-594-remove-dead-batteries-from-the-standard-library"> <h3>PEP 594: Remove “dead batteries” from the standard library<a class="headerlink" href="#pep-594-remove-dead-batteries-from-the-standard-library" title="Link to this heading">¶</a></h3> <a class="pep reference external" href="https://peps.python.org/pep-0594/">PEP 594</a> proposed removing 19 modules from the standard library, colloquially referred to as ‘dead batteries’ due to their historic, obsolete, or insecure status. All of the following modules were deprecated in Python 3.11, and are now removed: <ul> <li><code class="xref py py-mod docutils literal notranslate">aifc</code></li> <li><code class="xref py py-mod docutils literal notranslate">audioop</code></li> <li><code class="xref py py-mod docutils literal notranslate">chunk</code></li> <li><code class="xref py py-mod docutils literal notranslate">cgi</code> and <code class="xref py py-mod docutils literal notranslate">cgitb</code> <ul> <li><code class="xref py py-class docutils literal notranslate">cgi.FieldStorage</code> can typically be replaced with <a class="reference internal" href="../library/urllib.parse.html#urllib.parse.parse_qsl" title="urllib.parse.parse_qsl"><code class="xref py py-func docutils literal notranslate">urllib.parse.parse_qsl()</code></a> for <code class="docutils literal notranslate">GET</code> and <code class="docutils literal notranslate">HEAD</code> requests, and the <a class="reference internal" href="../library/email.message.html#module-email.message" title="email.message: The base class representing email messages."><code class="xref py py-mod docutils literal notranslate">email.message</code></a> module or the <a class="extlink-pypi reference external" href="https://pypi.org/project/multipart/">multipart</a> library for <code class="docutils literal notranslate">POST</code> and <code class="docutils literal notranslate">PUT</code> requests.</li> <li><code class="xref py py-func docutils literal notranslate">cgi.parse()</code> can be replaced by calling <a class="reference internal" href="../library/urllib.parse.html#urllib.parse.parse_qs" title="urllib.parse.parse_qs"><code class="xref py py-func docutils literal notranslate">urllib.parse.parse_qs()</code></a> directly on the desired query string, unless the input is <code class="docutils literal notranslate">multipart/form-data</code>, which should be replaced as described below for <code class="xref py py-func docutils literal notranslate">cgi.parse_multipart()</code>.</li> <li><code class="xref py py-func docutils literal notranslate">cgi.parse_header()</code> can be replaced with the functionality in the <a class="reference internal" href="../library/email.html#module-email" title="email: Package supporting the parsing, manipulating, and generating email messages."><code class="xref py py-mod docutils literal notranslate">email</code></a> package, which implements the same MIME RFCs. For example, with <a class="reference internal" href="../library/email.message.html#email.message.EmailMessage" title="email.message.EmailMessage"><code class="xref py py-class docutils literal notranslate">email.message.EmailMessage</code></a>: <div class="highlight-python notranslate"><div class="highlight"><pre>from email.message import EmailMessage msg = EmailMessage() msg['content-type'] = 'application/json; charset="utf8"' main, params = msg.get_content_type(), msg['content-type'].params </pre></div> </div> </li> <li><code class="xref py py-func docutils literal notranslate">cgi.parse_multipart()</code> can be replaced with the functionality in the <a class="reference internal" href="../library/email.html#module-email" title="email: Package supporting the parsing, manipulating, and generating email messages."><code class="xref py py-mod docutils literal notranslate">email</code></a> package, which implements the same MIME RFCs, or with the <a class="extlink-pypi reference external" href="https://pypi.org/project/multipart/">multipart</a> library. For example, the <a class="reference internal" href="../library/email.message.html#email.message.EmailMessage" title="email.message.EmailMessage"><code class="xref py py-class docutils literal notranslate">email.message.EmailMessage</code></a> and <a class="reference internal" href="../library/email.compat32-message.html#email.message.Message" title="email.message.Message"><code class="xref py py-class docutils literal notranslate">email.message.Message</code></a> classes.</li> </ul> </li> <li><code class="xref py py-mod docutils literal notranslate">crypt</code> and the private <code class="xref py py-mod docutils literal notranslate">_crypt</code> extension. The <a class="reference internal" href="../library/hashlib.html#module-hashlib" title="hashlib: Secure hash and message digest algorithms."><code class="xref py py-mod docutils literal notranslate">hashlib</code></a> module may be an appropriate replacement when simply hashing a value is required. Otherwise, various third-party libraries on PyPI are available: <ul class="simple"> <li><a class="extlink-pypi reference external" href="https://pypi.org/project/bcrypt/">bcrypt</a>: Modern password hashing for your software and your servers.</li> <li><a class="extlink-pypi reference external" href="https://pypi.org/project/passlib/">passlib</a>: Comprehensive password hashing framework supporting over 30 schemes.</li> <li><a class="extlink-pypi reference external" href="https://pypi.org/project/argon2-cffi/">argon2-cffi</a>: The secure Argon2 password hashing algorithm.</li> <li><a class="extlink-pypi reference external" href="https://pypi.org/project/legacycrypt/">legacycrypt</a>: <a class="reference internal" href="../library/ctypes.html#module-ctypes" title="ctypes: A foreign function library for Python."><code class="xref py py-mod docutils literal notranslate">ctypes</code></a> wrapper to the POSIX crypt library call and associated functionality.</li> <li><a class="extlink-pypi reference external" href="https://pypi.org/project/crypt_r/">crypt_r</a>: Fork of the <code class="xref py py-mod docutils literal notranslate">crypt</code> module, wrapper to the <a class="manpage reference external" href="https://manpages.debian.org/crypt_r(3)">crypt_r(3)</a> library call and associated functionality.</li> </ul> </li> <li><code class="xref py py-mod docutils literal notranslate">imghdr</code>: The <a class="extlink-pypi reference external" href="https://pypi.org/project/filetype/">filetype</a>, <a class="extlink-pypi reference external" href="https://pypi.org/project/puremagic/">puremagic</a>, or <a class="extlink-pypi reference external" href="https://pypi.org/project/python-magic/">python-magic</a> libraries should be used as replacements. For example, the <code class="xref py py-func docutils literal notranslate">puremagic.what()</code> function can be used to replace the <code class="xref py py-func docutils literal notranslate">imghdr.what()</code> function for all file formats that were supported by <code class="xref py py-mod docutils literal notranslate">imghdr</code>.</li> <li><code class="xref py py-mod docutils literal notranslate">mailcap</code>: Use the <a class="reference internal" href="../library/mimetypes.html#module-mimetypes" title="mimetypes: Mapping of filename extensions to MIME types."><code class="xref py py-mod docutils literal notranslate">mimetypes</code></a> module instead.</li> <li><code class="xref py py-mod docutils literal notranslate">msilib</code></li> <li><code class="xref py py-mod docutils literal notranslate">nis</code></li> <li><code class="xref py py-mod docutils literal notranslate">nntplib</code>: Use the <a class="extlink-pypi reference external" href="https://pypi.org/project/pynntp/">pynntp</a> library from PyPI instead.</li> <li><code class="xref py py-mod docutils literal notranslate">ossaudiodev</code>: For audio playback, use the <a class="extlink-pypi reference external" href="https://pypi.org/project/pygame/">pygame</a> library from PyPI instead.</li> <li><code class="xref py py-mod docutils literal notranslate">pipes</code>: Use the <a class="reference internal" href="../library/subprocess.html#module-subprocess" title="subprocess: Subprocess management."><code class="xref py py-mod docutils literal notranslate">subprocess</code></a> module instead. Use <a class="reference internal" href="../library/shlex.html#shlex.quote" title="shlex.quote"><code class="xref py py-func docutils literal notranslate">shlex.quote()</code></a> to replace the undocumented <code class="docutils literal notranslate">pipes.quote</code> function.</li> <li><code class="xref py py-mod docutils literal notranslate">sndhdr</code>: The <a class="extlink-pypi reference external" href="https://pypi.org/project/filetype/">filetype</a>, <a class="extlink-pypi reference external" href="https://pypi.org/project/puremagic/">puremagic</a>, or <a class="extlink-pypi reference external" href="https://pypi.org/project/python-magic/">python-magic</a> libraries should be used as replacements.</li> <li><code class="xref py py-mod docutils literal notranslate">spwd</code>: Use the <a class="extlink-pypi reference external" href="https://pypi.org/project/python-pam/">python-pam</a> library from PyPI instead.</li> <li><code class="xref py py-mod docutils literal notranslate">sunau</code></li> <li><code class="xref py py-mod docutils literal notranslate">telnetlib</code>, Use the <a class="extlink-pypi reference external" href="https://pypi.org/project/telnetlib3/">telnetlib3</a> or <a class="extlink-pypi reference external" href="https://pypi.org/project/Exscript/">Exscript</a> libraries from PyPI instead.</li> <li><code class="xref py py-mod docutils literal notranslate">uu</code>: Use the <a class="reference internal" href="../library/base64.html#module-base64" title="base64: RFC 4648: Base16, Base32, Base64 Data Encodings; Base85 and Ascii85"><code class="xref py py-mod docutils literal notranslate">base64</code></a> module instead, as a modern alternative.</li> <li><code class="xref py py-mod docutils literal notranslate">xdrlib</code></li> </ul> (Contributed by Victor Stinner and Zachary Ware in <a class="reference external" href="https://github.com/python/cpython/issues/104773">gh-104773</a> and <a class="reference external" href="https://github.com/python/cpython/issues/104780">gh-104780</a>.) </section> <section id="to3"> <h3>2to3<a class="headerlink" href="#to3" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the 2to3 program and the <code class="xref py py-mod docutils literal notranslate">lib2to3</code> module, previously deprecated in Python 3.11. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/104780">gh-104780</a>.)</li> </ul> </section> <section id="builtins"> <h3>builtins<a class="headerlink" href="#builtins" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove support for chained <a class="reference internal" href="../library/functions.html#classmethod" title="classmethod"><code class="xref py py-class docutils literal notranslate">classmethod</code></a> descriptors (introduced in <a class="reference external" href="https://github.com/python/cpython/issues/63272">gh-63272</a>). These can no longer be used to wrap other descriptors, such as <a class="reference internal" href="../library/functions.html#property" title="property"><code class="xref py py-class docutils literal notranslate">property</code></a>. The core design of this feature was flawed and led to several problems. To “pass-through” a <a class="reference internal" href="../library/functions.html#classmethod" title="classmethod"><code class="xref py py-class docutils literal notranslate">classmethod</code></a>, consider using the <code class="xref py py-attr docutils literal notranslate">__wrapped__</code> attribute that was added in Python 3.10. (Contributed by Raymond Hettinger in <a class="reference external" href="https://github.com/python/cpython/issues/89519">gh-89519</a>.)</li> <li>Raise a <a class="reference internal" href="../library/exceptions.html#RuntimeError" title="RuntimeError"><code class="xref py py-exc docutils literal notranslate">RuntimeError</code></a> when calling <a class="reference internal" href="../reference/datamodel.html#frame.clear" title="frame.clear"><code class="xref py py-meth docutils literal notranslate">frame.clear()</code></a> on a suspended frame (as has always been the case for an executing frame). (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/79932">gh-79932</a>.)</li> </ul> </section> <section id="id3"> <h3>configparser<a class="headerlink" href="#id3" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the undocumented <code class="xref py py-class docutils literal notranslate">LegacyInterpolation</code> class, deprecated in the docstring since Python 3.2, and at runtime since Python 3.11. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/104886">gh-104886</a>.)</li> </ul> </section> <section id="importlib-metadata"> <h3>importlib.metadata<a class="headerlink" href="#importlib-metadata" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove deprecated subscript (<a class="reference internal" href="../reference/datamodel.html#object.__getitem__" title="object.__getitem__"><code class="xref py py-meth docutils literal notranslate">__getitem__()</code></a>) access for <a class="reference internal" href="../library/importlib.metadata.html#entry-points">EntryPoint</a> objects. (Contributed by Jason R. Coombs in <a class="reference external" href="https://github.com/python/cpython/issues/113175">gh-113175</a>.)</li> </ul> </section> <section id="locale"> <h3>locale<a class="headerlink" href="#locale" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the <code class="xref py py-func docutils literal notranslate">locale.resetlocale()</code> function, deprecated in Python 3.11. Use <code class="docutils literal notranslate">locale.setlocale(locale.LC_ALL, "")</code> instead. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/104783">gh-104783</a>.)</li> </ul> </section> <section id="opcode"> <h3>opcode<a class="headerlink" href="#opcode" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Move <code class="xref py py-attr docutils literal notranslate">opcode.ENABLE_SPECIALIZATION</code> to <code class="xref py py-attr docutils literal notranslate">_opcode.ENABLE_SPECIALIZATION</code>. This field was added in 3.12, it was never documented, and is not intended for external use. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/105481">gh-105481</a>.)</li> <li>Remove <code class="xref py py-func docutils literal notranslate">opcode.is_pseudo()</code>, <code class="xref py py-attr docutils literal notranslate">opcode.MIN_PSEUDO_OPCODE</code>, and <code class="xref py py-attr docutils literal notranslate">opcode.MAX_PSEUDO_OPCODE</code>, which were added in Python 3.12, but were neither documented nor exposed through <a class="reference internal" href="../library/dis.html#module-dis" title="dis: Disassembler for Python bytecode."><code class="xref py py-mod docutils literal notranslate">dis</code></a>, and were not intended to be used externally. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/105481">gh-105481</a>.)</li> </ul> </section> <section id="id4"> <h3>pathlib<a class="headerlink" href="#id4" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the ability to use <a class="reference internal" href="../library/pathlib.html#pathlib.Path" title="pathlib.Path"><code class="xref py py-class docutils literal notranslate">Path</code></a> objects as context managers. This functionality was deprecated and has had no effect since Python 3.9. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/83863">gh-83863</a>.)</li> </ul> </section> <section id="id5"> <h3>re<a class="headerlink" href="#id5" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the undocumented, deprecated, and broken <code class="xref py py-func docutils literal notranslate">re.template()</code> function and <code class="xref py py-attr docutils literal notranslate">re.TEMPLATE</code> / <code class="xref py py-attr docutils literal notranslate">re.T</code> flag. (Contributed by Serhiy Storchaka and Nikita Sobolev in <a class="reference external" href="https://github.com/python/cpython/issues/105687">gh-105687</a>.)</li> </ul> </section> <section id="tkinter-tix"> <h3>tkinter.tix<a class="headerlink" href="#tkinter-tix" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the <code class="xref py py-mod docutils literal notranslate">tkinter.tix</code> module, deprecated in Python 3.6. The third-party Tix library which the module wrapped is unmaintained. (Contributed by Zachary Ware in <a class="reference external" href="https://github.com/python/cpython/issues/75552">gh-75552</a>.)</li> </ul> </section> <section id="turtle"> <h3>turtle<a class="headerlink" href="#turtle" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the <code class="xref py py-meth docutils literal notranslate">RawTurtle.settiltangle()</code> method, deprecated in the documentation since Python 3.1 and at runtime since Python 3.11. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/104876">gh-104876</a>.)</li> </ul> </section> <section id="id6"> <h3>typing<a class="headerlink" href="#id6" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the <code class="xref py py-mod docutils literal notranslate">typing.io</code> and <code class="xref py py-mod docutils literal notranslate">typing.re</code> namespaces, deprecated since Python 3.8. The items in those namespaces can be imported directly from the <a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a> module. (Contributed by Sebastian Rittau in <a class="reference external" href="https://github.com/python/cpython/issues/92871">gh-92871</a>.)</li> <li>Remove the keyword-argument method of creating <a class="reference internal" href="../library/typing.html#typing.TypedDict" title="typing.TypedDict"><code class="xref py py-class docutils literal notranslate">TypedDict</code></a> types, deprecated in Python 3.11. (Contributed by Tomas Roun in <a class="reference external" href="https://github.com/python/cpython/issues/104786">gh-104786</a>.)</li> </ul> </section> <section id="unittest"> <h3>unittest<a class="headerlink" href="#unittest" title="Link to this heading">¶</a></h3> <ul> <li>Remove the following <a class="reference internal" href="../library/unittest.html#module-unittest" title="unittest: Unit testing framework for Python."><code class="xref py py-mod docutils literal notranslate">unittest</code></a> functions, deprecated in Python 3.11: <ul class="simple"> <li><code class="xref py py-func docutils literal notranslate">unittest.findTestCases()</code></li> <li><code class="xref py py-func docutils literal notranslate">unittest.makeSuite()</code></li> <li><code class="xref py py-func docutils literal notranslate">unittest.getTestCaseNames()</code></li> </ul> Use <a class="reference internal" href="../library/unittest.html#unittest.TestLoader" title="unittest.TestLoader"><code class="xref py py-class docutils literal notranslate">TestLoader</code></a> methods instead: <ul class="simple"> <li><a class="reference internal" href="../library/unittest.html#unittest.TestLoader.loadTestsFromModule" title="unittest.TestLoader.loadTestsFromModule"><code class="xref py py-meth docutils literal notranslate">loadTestsFromModule()</code></a></li> <li><a class="reference internal" href="../library/unittest.html#unittest.TestLoader.loadTestsFromTestCase" title="unittest.TestLoader.loadTestsFromTestCase"><code class="xref py py-meth docutils literal notranslate">loadTestsFromTestCase()</code></a></li> <li><a class="reference internal" href="../library/unittest.html#unittest.TestLoader.getTestCaseNames" title="unittest.TestLoader.getTestCaseNames"><code class="xref py py-meth docutils literal notranslate">getTestCaseNames()</code></a></li> </ul> (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/104835">gh-104835</a>.) </li> <li>Remove the untested and undocumented <code class="xref py py-meth docutils literal notranslate">TestProgram.usageExit()</code> method, deprecated in Python 3.11. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/104992">gh-104992</a>.)</li> </ul> </section> <section id="urllib"> <h3>urllib<a class="headerlink" href="#urllib" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the cafile, capath, and cadefault parameters of the <a class="reference internal" href="../library/urllib.request.html#urllib.request.urlopen" title="urllib.request.urlopen"><code class="xref py py-func docutils literal notranslate">urllib.request.urlopen()</code></a> function, deprecated in Python 3.6. Use the context parameter instead with an <a class="reference internal" href="../library/ssl.html#ssl.SSLContext" title="ssl.SSLContext"><code class="xref py py-class docutils literal notranslate">SSLContext</code></a> instance. The <a class="reference internal" href="../library/ssl.html#ssl.SSLContext.load_cert_chain" title="ssl.SSLContext.load_cert_chain"><code class="xref py py-meth docutils literal notranslate">ssl.SSLContext.load_cert_chain()</code></a> function can be used to load specific certificates, or let <a class="reference internal" href="../library/ssl.html#ssl.create_default_context" title="ssl.create_default_context"><code class="xref py py-func docutils literal notranslate">ssl.create_default_context()</code></a> select the operating system’s trusted certificate authority (CA) certificates. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105382">gh-105382</a>.)</li> </ul> </section> <section id="webbrowser"> <h3>webbrowser<a class="headerlink" href="#webbrowser" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>Remove the untested and undocumented <code class="xref py py-class docutils literal notranslate">MacOSX</code> class, deprecated in Python 3.11. Use the <code class="xref py py-class docutils literal notranslate">MacOSXOSAScript</code> class (introduced in Python 3.2) instead. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/104804">gh-104804</a>.)</li> <li>Remove the deprecated <code class="xref py py-attr docutils literal notranslate">MacOSXOSAScript._name</code> attribute. Use the <a class="reference internal" href="../library/webbrowser.html#webbrowser.controller.name" title="webbrowser.controller.name"><code class="xref py py-attr docutils literal notranslate">MacOSXOSAScript.name</code></a> attribute instead. (Contributed by Nikita Sobolev in <a class="reference external" href="https://github.com/python/cpython/issues/105546">gh-105546</a>.)</li> </ul> </section> </section> <section id="new-deprecations"> <h2>New Deprecations<a class="headerlink" href="#new-deprecations" title="Link to this heading">¶</a></h2> <ul class="simple"> <li><a class="reference internal" href="../reference/datamodel.html#user-defined-funcs">User-defined functions</a>: <ul> <li>Deprecate assignment to a function’s <a class="reference internal" href="../reference/datamodel.html#function.__code__" title="function.__code__"><code class="xref py py-attr docutils literal notranslate">__code__</code></a> attribute, where the new code object’s type does not match the function’s type. The different types are: plain function, generator, async generator, and coroutine. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/81137">gh-81137</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/array.html#module-array" title="array: Space efficient arrays of uniformly typed numeric values."><code class="xref py py-mod docutils literal notranslate">array</code></a>: <ul> <li>Deprecate the <code class="docutils literal notranslate">'u'</code> format code (<code class="xref c c-type docutils literal notranslate">wchar_t</code>) at runtime. This format code has been deprecated in documentation since Python 3.3, and will be removed in Python 3.16. Use the <code class="docutils literal notranslate">'w'</code> format code (<a class="reference internal" href="../c-api/unicode.html#c.Py_UCS4" title="Py_UCS4"><code class="xref c c-type docutils literal notranslate">Py_UCS4</code></a>) for Unicode characters instead. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/80480">gh-80480</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/ctypes.html#module-ctypes" title="ctypes: A foreign function library for Python."><code class="xref py py-mod docutils literal notranslate">ctypes</code></a>: <ul> <li>Deprecate the undocumented <code class="xref py py-func docutils literal notranslate">SetPointerType()</code> function, to be removed in Python 3.15. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105733">gh-105733</a>.)</li> <li><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft-deprecate</a> the <a class="reference internal" href="../library/ctypes.html#ctypes.ARRAY" title="ctypes.ARRAY"><code class="xref py py-func docutils literal notranslate">ARRAY()</code></a> function in favour of <code class="docutils literal notranslate">type * length</code> multiplication. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105733">gh-105733</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/decimal.html#module-decimal" title="decimal: Implementation of the General Decimal Arithmetic Specification."><code class="xref py py-mod docutils literal notranslate">decimal</code></a>: <ul> <li>Deprecate the non-standard and undocumented <a class="reference internal" href="../library/decimal.html#decimal.Decimal" title="decimal.Decimal"><code class="xref py py-class docutils literal notranslate">Decimal</code></a> format specifier <code class="docutils literal notranslate">'N'</code>, which is only supported in the <code class="xref py py-mod docutils literal notranslate">decimal</code> module’s C implementation. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/89902">gh-89902</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/dis.html#module-dis" title="dis: Disassembler for Python bytecode."><code class="xref py py-mod docutils literal notranslate">dis</code></a>: <ul> <li>Deprecate the <code class="xref py py-attr docutils literal notranslate">HAVE_ARGUMENT</code> separator. Check membership in <a class="reference internal" href="../library/dis.html#dis.hasarg" title="dis.hasarg"><code class="xref py py-data docutils literal notranslate">hasarg</code></a> instead. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/109319">gh-109319</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/getopt.html#module-getopt" title="getopt: Portable parser for command line options; support both short and long option names."><code class="xref py py-mod docutils literal notranslate">getopt</code></a> and <a class="reference internal" href="../library/optparse.html#module-optparse" title="optparse: Command-line option parsing library. (deprecated)"><code class="xref py py-mod docutils literal notranslate">optparse</code></a>: <ul> <li>Both modules are now <a class="reference internal" href="../glossary.html#term-soft-deprecated">soft deprecated</a>, with <a class="reference internal" href="../library/argparse.html#module-argparse" title="argparse: Command-line option and argument parsing library."><code class="xref py py-mod docutils literal notranslate">argparse</code></a> preferred for new projects. This is a new soft-deprecation for the <code class="xref py py-mod docutils literal notranslate">getopt</code> module, whereas the <code class="xref py py-mod docutils literal notranslate">optparse</code> module was already de facto soft deprecated. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106535">gh-106535</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/gettext.html#module-gettext" title="gettext: Multilingual internationalization services."><code class="xref py py-mod docutils literal notranslate">gettext</code></a>: <ul> <li>Deprecate non-integer numbers as arguments to functions and methods that consider plural forms in the <code class="xref py py-mod docutils literal notranslate">gettext</code> module, even if no translation was found. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/88434">gh-88434</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/glob.html#module-glob" title="glob: Unix shell style pathname pattern expansion."><code class="xref py py-mod docutils literal notranslate">glob</code></a>: <ul> <li>Deprecate the undocumented <code class="xref py py-func docutils literal notranslate">glob0()</code> and <code class="xref py py-func docutils literal notranslate">glob1()</code> functions. Use <a class="reference internal" href="../library/glob.html#glob.glob" title="glob.glob"><code class="xref py py-func docutils literal notranslate">glob()</code></a> and pass a <a class="reference internal" href="../glossary.html#term-path-like-object">path-like object</a> specifying the root directory to the root_dir parameter instead. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/117337">gh-117337</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/http.server.html#module-http.server" title="http.server: HTTP server and request handlers."><code class="xref py py-mod docutils literal notranslate">http.server</code></a>: <ul> <li>Deprecate <a class="reference internal" href="../library/http.server.html#http.server.CGIHTTPRequestHandler" title="http.server.CGIHTTPRequestHandler"><code class="xref py py-class docutils literal notranslate">CGIHTTPRequestHandler</code></a>, to be removed in Python 3.15. Process-based CGI HTTP servers have been out of favor for a very long time. This code was outdated, unmaintained, and rarely used. It has a high potential for both security and functionality bugs. (Contributed by Gregory P. Smith in <a class="reference external" href="https://github.com/python/cpython/issues/109096">gh-109096</a>.)</li> <li>Deprecate the <code class="xref std std-option docutils literal notranslate">--cgi</code> flag to the python -m http.server command-line interface, to be removed in Python 3.15. (Contributed by Gregory P. Smith in <a class="reference external" href="https://github.com/python/cpython/issues/109096">gh-109096</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/mimetypes.html#module-mimetypes" title="mimetypes: Mapping of filename extensions to MIME types."><code class="xref py py-mod docutils literal notranslate">mimetypes</code></a>: <ul> <li><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft-deprecate</a> file path arguments to <a class="reference internal" href="../library/mimetypes.html#mimetypes.guess_type" title="mimetypes.guess_type"><code class="xref py py-func docutils literal notranslate">guess_type()</code></a>, use <a class="reference internal" href="../library/mimetypes.html#mimetypes.guess_file_type" title="mimetypes.guess_file_type"><code class="xref py py-func docutils literal notranslate">guess_file_type()</code></a> instead. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/66543">gh-66543</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/re.html#module-re" title="re: Regular expression operations."><code class="xref py py-mod docutils literal notranslate">re</code></a>: <ul> <li>Deprecate passing the optional maxsplit, count, or flags arguments as positional arguments to the module-level <a class="reference internal" href="../library/re.html#re.split" title="re.split"><code class="xref py py-func docutils literal notranslate">split()</code></a>, <a class="reference internal" href="../library/re.html#re.sub" title="re.sub"><code class="xref py py-func docutils literal notranslate">sub()</code></a>, and <a class="reference internal" href="../library/re.html#re.subn" title="re.subn"><code class="xref py py-func docutils literal notranslate">subn()</code></a> functions. These parameters will become <a class="reference internal" href="../glossary.html#keyword-only-parameter">keyword-only</a> in a future version of Python. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/56166">gh-56166</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/pathlib.html#module-pathlib" title="pathlib: Object-oriented filesystem paths"><code class="xref py py-mod docutils literal notranslate">pathlib</code></a>: <ul> <li>Deprecate <a class="reference internal" href="../library/pathlib.html#pathlib.PurePath.is_reserved" title="pathlib.PurePath.is_reserved"><code class="xref py py-meth docutils literal notranslate">PurePath.is_reserved()</code></a>, to be removed in Python 3.15. Use <a class="reference internal" href="../library/os.path.html#os.path.isreserved" title="os.path.isreserved"><code class="xref py py-func docutils literal notranslate">os.path.isreserved()</code></a> to detect reserved paths on Windows. (Contributed by Barney Gale in <a class="reference external" href="https://github.com/python/cpython/issues/88569">gh-88569</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/platform.html#module-platform" title="platform: Retrieves as much platform identifying data as possible."><code class="xref py py-mod docutils literal notranslate">platform</code></a>: <ul> <li>Deprecate <a class="reference internal" href="../library/platform.html#platform.java_ver" title="platform.java_ver"><code class="xref py py-func docutils literal notranslate">java_ver()</code></a>, to be removed in Python 3.15. This function is only useful for Jython support, has a confusing API, and is largely untested. (Contributed by Nikita Sobolev in <a class="reference external" href="https://github.com/python/cpython/issues/116349">gh-116349</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/pydoc.html#module-pydoc" title="pydoc: Documentation generator and online help system."><code class="xref py py-mod docutils literal notranslate">pydoc</code></a>: <ul> <li>Deprecate the undocumented <code class="xref py py-func docutils literal notranslate">ispackage()</code> function. (Contributed by Zackery Spytz in <a class="reference external" href="https://github.com/python/cpython/issues/64020">gh-64020</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/sqlite3.html#module-sqlite3" title="sqlite3: A DB-API 2.0 implementation using SQLite 3.x."><code class="xref py py-mod docutils literal notranslate">sqlite3</code></a>: <ul> <li>Deprecate passing more than one positional argument to the <a class="reference internal" href="../library/sqlite3.html#sqlite3.connect" title="sqlite3.connect"><code class="xref py py-func docutils literal notranslate">connect()</code></a> function and the <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection" title="sqlite3.Connection"><code class="xref py py-class docutils literal notranslate">Connection</code></a> constructor. The remaining parameters will become keyword-only in Python 3.15. (Contributed by Erlend E. Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/107948">gh-107948</a>.)</li> <li>Deprecate passing name, number of arguments, and the callable as keyword arguments for <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.create_function" title="sqlite3.Connection.create_function"><code class="xref py py-meth docutils literal notranslate">Connection.create_function()</code></a> and <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.create_aggregate" title="sqlite3.Connection.create_aggregate"><code class="xref py py-meth docutils literal notranslate">Connection.create_aggregate()</code></a> These parameters will become positional-only in Python 3.15. (Contributed by Erlend E. Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/108278">gh-108278</a>.)</li> <li>Deprecate passing the callback callable by keyword for the <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.set_authorizer" title="sqlite3.Connection.set_authorizer"><code class="xref py py-meth docutils literal notranslate">set_authorizer()</code></a>, <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.set_progress_handler" title="sqlite3.Connection.set_progress_handler"><code class="xref py py-meth docutils literal notranslate">set_progress_handler()</code></a>, and <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection.set_trace_callback" title="sqlite3.Connection.set_trace_callback"><code class="xref py py-meth docutils literal notranslate">set_trace_callback()</code></a> <a class="reference internal" href="../library/sqlite3.html#sqlite3.Connection" title="sqlite3.Connection"><code class="xref py py-class docutils literal notranslate">Connection</code></a> methods. The callback callables will become positional-only in Python 3.15. (Contributed by Erlend E. Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/108278">gh-108278</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/sys.html#module-sys" title="sys: Access system-specific parameters and functions."><code class="xref py py-mod docutils literal notranslate">sys</code></a>: <ul> <li>Deprecate the <a class="reference internal" href="../library/sys.html#sys._enablelegacywindowsfsencoding" title="sys._enablelegacywindowsfsencoding"><code class="xref py py-func docutils literal notranslate">_enablelegacywindowsfsencoding()</code></a> function, to be removed in Python 3.16. Use the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHONLEGACYWINDOWSFSENCODING"><code class="xref std std-envvar docutils literal notranslate">PYTHONLEGACYWINDOWSFSENCODING</code></a> environment variable instead. (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/73427">gh-73427</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/tarfile.html#module-tarfile" title="tarfile: Read and write tar-format archive files."><code class="xref py py-mod docutils literal notranslate">tarfile</code></a>: <ul> <li>Deprecate the undocumented and unused <code class="xref py py-attr docutils literal notranslate">TarFile.tarfile</code> attribute, to be removed in Python 3.16. (Contributed in <a class="reference external" href="https://github.com/python/cpython/issues/115256">gh-115256</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/traceback.html#module-traceback" title="traceback: Print or retrieve a stack traceback."><code class="xref py py-mod docutils literal notranslate">traceback</code></a>: <ul> <li>Deprecate the <a class="reference internal" href="../library/traceback.html#traceback.TracebackException.exc_type" title="traceback.TracebackException.exc_type"><code class="xref py py-attr docutils literal notranslate">TracebackException.exc_type</code></a> attribute. Use <a class="reference internal" href="../library/traceback.html#traceback.TracebackException.exc_type_str" title="traceback.TracebackException.exc_type_str"><code class="xref py py-attr docutils literal notranslate">TracebackException.exc_type_str</code></a> instead. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/112332">gh-112332</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a>: <ul> <li>Deprecate the undocumented keyword argument syntax for creating <a class="reference internal" href="../library/typing.html#typing.NamedTuple" title="typing.NamedTuple"><code class="xref py py-class docutils literal notranslate">NamedTuple</code></a> classes (e.g. <code class="docutils literal notranslate">Point = NamedTuple("Point", x=int, y=int)</code>), to be removed in Python 3.15. Use the class-based syntax or the functional syntax instead. (Contributed by Alex Waygood in <a class="reference external" href="https://github.com/python/cpython/issues/105566">gh-105566</a>.)</li> <li>Deprecate omitting the fields parameter when creating a <a class="reference internal" href="../library/typing.html#typing.NamedTuple" title="typing.NamedTuple"><code class="xref py py-class docutils literal notranslate">NamedTuple</code></a> or <a class="reference internal" href="../library/typing.html#typing.TypedDict" title="typing.TypedDict"><code class="xref py py-class docutils literal notranslate">typing.TypedDict</code></a> class, and deprecate passing <code class="docutils literal notranslate">None</code> to the fields parameter of both types. Python 3.15 will require a valid sequence for the fields parameter. To create a NamedTuple class with zero fields, use <code class="docutils literal notranslate">class NT(NamedTuple): pass</code> or <code class="docutils literal notranslate">NT = NamedTuple("NT", ())</code>. To create a TypedDict class with zero fields, use <code class="docutils literal notranslate">class TD(TypedDict): pass</code> or <code class="docutils literal notranslate">TD = TypedDict("TD", {})</code>. (Contributed by Alex Waygood in <a class="reference external" href="https://github.com/python/cpython/issues/105566">gh-105566</a> and <a class="reference external" href="https://github.com/python/cpython/issues/105570">gh-105570</a>.)</li> <li>Deprecate the <a class="reference internal" href="../library/typing.html#typing.no_type_check_decorator" title="typing.no_type_check_decorator"><code class="xref py py-func docutils literal notranslate">typing.no_type_check_decorator()</code></a> decorator function, to be removed in in Python 3.15. After eight years in the <a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a> module, it has yet to be supported by any major type checker. (Contributed by Alex Waygood in <a class="reference external" href="https://github.com/python/cpython/issues/106309">gh-106309</a>.)</li> <li>Deprecate <a class="reference internal" href="../library/typing.html#typing.AnyStr" title="typing.AnyStr"><code class="xref py py-data docutils literal notranslate">typing.AnyStr</code></a>. In Python 3.16, it will be removed from <code class="docutils literal notranslate">typing.__all__</code>, and a <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a> will be emitted at runtime when it is imported or accessed. It will be removed entirely in Python 3.18. Use the new <a class="reference internal" href="../reference/compound_stmts.html#type-params">type parameter syntax</a> instead. (Contributed by Michael The in <a class="reference external" href="https://github.com/python/cpython/issues/107116">gh-107116</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/wave.html#module-wave" title="wave: Provide an interface to the WAV sound format."><code class="xref py py-mod docutils literal notranslate">wave</code></a>: <ul> <li>Deprecate the <a class="reference internal" href="../library/wave.html#wave.Wave_read.getmark" title="wave.Wave_read.getmark"><code class="xref py py-meth docutils literal notranslate">getmark()</code></a>, <code class="xref py py-meth docutils literal notranslate">setmark()</code>, and <a class="reference internal" href="../library/wave.html#wave.Wave_read.getmarkers" title="wave.Wave_read.getmarkers"><code class="xref py py-meth docutils literal notranslate">getmarkers()</code></a> methods of the <a class="reference internal" href="../library/wave.html#wave.Wave_read" title="wave.Wave_read"><code class="xref py py-class docutils literal notranslate">Wave_read</code></a> and <a class="reference internal" href="../library/wave.html#wave.Wave_write" title="wave.Wave_write"><code class="xref py py-class docutils literal notranslate">Wave_write</code></a> classes, to be removed in Python 3.15. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105096">gh-105096</a>.)</li> </ul> </li> </ul> <section id="pending-removal-in-python-3-14"> <h3>Pending Removal in Python 3.14<a class="headerlink" href="#pending-removal-in-python-3-14" title="Link to this heading">¶</a></h3> <ul> <li><a class="reference internal" href="../library/argparse.html#module-argparse" title="argparse: Command-line option and argument parsing library."><code class="xref py py-mod docutils literal notranslate">argparse</code></a>: The type, choices, and metavar parameters of <code class="xref py py-class docutils literal notranslate">argparse.BooleanOptionalAction</code> are deprecated and will be removed in 3.14. (Contributed by Nikita Sobolev in <a class="reference external" href="https://github.com/python/cpython/issues/92248">gh-92248</a>.)</li> <li><a class="reference internal" href="../library/ast.html#module-ast" title="ast: Abstract Syntax Tree classes and manipulation."><code class="xref py py-mod docutils literal notranslate">ast</code></a>: The following features have been deprecated in documentation since Python 3.8, now cause a <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a> to be emitted at runtime when they are accessed or used, and will be removed in Python 3.14: <ul class="simple"> <li><code class="xref py py-class docutils literal notranslate">ast.Num</code></li> <li><code class="xref py py-class docutils literal notranslate">ast.Str</code></li> <li><code class="xref py py-class docutils literal notranslate">ast.Bytes</code></li> <li><code class="xref py py-class docutils literal notranslate">ast.NameConstant</code></li> <li><code class="xref py py-class docutils literal notranslate">ast.Ellipsis</code></li> </ul> Use <a class="reference internal" href="../library/ast.html#ast.Constant" title="ast.Constant"><code class="xref py py-class docutils literal notranslate">ast.Constant</code></a> instead. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/90953">gh-90953</a>.) </li> <li><a class="reference internal" href="../library/asyncio.html#module-asyncio" title="asyncio: Asynchronous I/O."><code class="xref py py-mod docutils literal notranslate">asyncio</code></a>: <ul class="simple"> <li>The child watcher classes <a class="reference internal" href="../library/asyncio-policy.html#asyncio.MultiLoopChildWatcher" title="asyncio.MultiLoopChildWatcher"><code class="xref py py-class docutils literal notranslate">MultiLoopChildWatcher</code></a>, <a class="reference internal" href="../library/asyncio-policy.html#asyncio.FastChildWatcher" title="asyncio.FastChildWatcher"><code class="xref py py-class docutils literal notranslate">FastChildWatcher</code></a>, <a class="reference internal" href="../library/asyncio-policy.html#asyncio.AbstractChildWatcher" title="asyncio.AbstractChildWatcher"><code class="xref py py-class docutils literal notranslate">AbstractChildWatcher</code></a> and <a class="reference internal" href="../library/asyncio-policy.html#asyncio.SafeChildWatcher" title="asyncio.SafeChildWatcher"><code class="xref py py-class docutils literal notranslate">SafeChildWatcher</code></a> are deprecated and will be removed in Python 3.14. (Contributed by Kumar Aditya in <a class="reference external" href="https://github.com/python/cpython/issues/94597">gh-94597</a>.)</li> <li><a class="reference internal" href="../library/asyncio-policy.html#asyncio.set_child_watcher" title="asyncio.set_child_watcher"><code class="xref py py-func docutils literal notranslate">asyncio.set_child_watcher()</code></a>, <a class="reference internal" href="../library/asyncio-policy.html#asyncio.get_child_watcher" title="asyncio.get_child_watcher"><code class="xref py py-func docutils literal notranslate">asyncio.get_child_watcher()</code></a>, <a class="reference internal" href="../library/asyncio-policy.html#asyncio.AbstractEventLoopPolicy.set_child_watcher" title="asyncio.AbstractEventLoopPolicy.set_child_watcher"><code class="xref py py-meth docutils literal notranslate">asyncio.AbstractEventLoopPolicy.set_child_watcher()</code></a> and <a class="reference internal" href="../library/asyncio-policy.html#asyncio.AbstractEventLoopPolicy.get_child_watcher" title="asyncio.AbstractEventLoopPolicy.get_child_watcher"><code class="xref py py-meth docutils literal notranslate">asyncio.AbstractEventLoopPolicy.get_child_watcher()</code></a> are deprecated and will be removed in Python 3.14. (Contributed by Kumar Aditya in <a class="reference external" href="https://github.com/python/cpython/issues/94597">gh-94597</a>.)</li> <li>The <a class="reference internal" href="../library/asyncio-eventloop.html#asyncio.get_event_loop" title="asyncio.get_event_loop"><code class="xref py py-meth docutils literal notranslate">get_event_loop()</code></a> method of the default event loop policy now emits a <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a> if there is no current event loop set and it decides to create one. (Contributed by Serhiy Storchaka and Guido van Rossum in <a class="reference external" href="https://github.com/python/cpython/issues/100160">gh-100160</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/collections.abc.html#module-collections.abc" title="collections.abc: Abstract base classes for containers"><code class="xref py py-mod docutils literal notranslate">collections.abc</code></a>: Deprecated <a class="reference internal" href="../library/collections.abc.html#collections.abc.ByteString" title="collections.abc.ByteString"><code class="xref py py-class docutils literal notranslate">ByteString</code></a>. Prefer <code class="xref py py-class docutils literal notranslate">Sequence</code> or <a class="reference internal" href="../library/collections.abc.html#collections.abc.Buffer" title="collections.abc.Buffer"><code class="xref py py-class docutils literal notranslate">Buffer</code></a>. For use in typing, prefer a union, like <code class="docutils literal notranslate">bytes | bytearray</code>, or <a class="reference internal" href="../library/collections.abc.html#collections.abc.Buffer" title="collections.abc.Buffer"><code class="xref py py-class docutils literal notranslate">collections.abc.Buffer</code></a>. (Contributed by Shantanu Jain in <a class="reference external" href="https://github.com/python/cpython/issues/91896">gh-91896</a>.)</li> <li><a class="reference internal" href="../library/email.html#module-email" title="email: Package supporting the parsing, manipulating, and generating email messages."><code class="xref py py-mod docutils literal notranslate">email</code></a>: Deprecated the isdst parameter in <a class="reference internal" href="../library/email.utils.html#email.utils.localtime" title="email.utils.localtime"><code class="xref py py-func docutils literal notranslate">email.utils.localtime()</code></a>. (Contributed by Alan Williams in <a class="reference external" href="https://github.com/python/cpython/issues/72346">gh-72346</a>.)</li> <li><a class="reference internal" href="../library/importlib.html#module-importlib.abc" title="importlib.abc: Abstract base classes related to import"><code class="xref py py-mod docutils literal notranslate">importlib.abc</code></a> deprecated classes: <ul class="simple"> <li><code class="xref py py-class docutils literal notranslate">importlib.abc.ResourceReader</code></li> <li><code class="xref py py-class docutils literal notranslate">importlib.abc.Traversable</code></li> <li><code class="xref py py-class docutils literal notranslate">importlib.abc.TraversableResources</code></li> </ul> Use <a class="reference internal" href="../library/importlib.resources.abc.html#module-importlib.resources.abc" title="importlib.resources.abc: Abstract base classes for resources"><code class="xref py py-mod docutils literal notranslate">importlib.resources.abc</code></a> classes instead: <ul class="simple"> <li><a class="reference internal" href="../library/importlib.resources.abc.html#importlib.resources.abc.Traversable" title="importlib.resources.abc.Traversable"><code class="xref py py-class docutils literal notranslate">importlib.resources.abc.Traversable</code></a></li> <li><a class="reference internal" href="../library/importlib.resources.abc.html#importlib.resources.abc.TraversableResources" title="importlib.resources.abc.TraversableResources"><code class="xref py py-class docutils literal notranslate">importlib.resources.abc.TraversableResources</code></a></li> </ul> (Contributed by Jason R. Coombs and Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/93963">gh-93963</a>.) </li> <li><a class="reference internal" href="../library/itertools.html#module-itertools" title="itertools: Functions creating iterators for efficient looping."><code class="xref py py-mod docutils literal notranslate">itertools</code></a> had undocumented, inefficient, historically buggy, and inconsistent support for copy, deepcopy, and pickle operations. This will be removed in 3.14 for a significant reduction in code volume and maintenance burden. (Contributed by Raymond Hettinger in <a class="reference external" href="https://github.com/python/cpython/issues/101588">gh-101588</a>.)</li> <li><a class="reference internal" href="../library/multiprocessing.html#module-multiprocessing" title="multiprocessing: Process-based parallelism."><code class="xref py py-mod docutils literal notranslate">multiprocessing</code></a>: The default start method will change to a safer one on Linux, BSDs, and other non-macOS POSIX platforms where <code class="docutils literal notranslate">'fork'</code> is currently the default (<a class="reference external" href="https://github.com/python/cpython/issues/84559">gh-84559</a>). Adding a runtime warning about this was deemed too disruptive as the majority of code is not expected to care. Use the <a class="reference internal" href="../library/multiprocessing.html#multiprocessing.get_context" title="multiprocessing.get_context"><code class="xref py py-func docutils literal notranslate">get_context()</code></a> or <a class="reference internal" href="../library/multiprocessing.html#multiprocessing.set_start_method" title="multiprocessing.set_start_method"><code class="xref py py-func docutils literal notranslate">set_start_method()</code></a> APIs to explicitly specify when your code requires <code class="docutils literal notranslate">'fork'</code>. See <a class="reference internal" href="../library/multiprocessing.html#multiprocessing-start-methods">Contexts and start methods</a>.</li> <li><a class="reference internal" href="../library/pathlib.html#module-pathlib" title="pathlib: Object-oriented filesystem paths"><code class="xref py py-mod docutils literal notranslate">pathlib</code></a>: <a class="reference internal" href="../library/pathlib.html#pathlib.PurePath.is_relative_to" title="pathlib.PurePath.is_relative_to"><code class="xref py py-meth docutils literal notranslate">is_relative_to()</code></a> and <a class="reference internal" href="../library/pathlib.html#pathlib.PurePath.relative_to" title="pathlib.PurePath.relative_to"><code class="xref py py-meth docutils literal notranslate">relative_to()</code></a>: passing additional arguments is deprecated.</li> <li><a class="reference internal" href="../library/pkgutil.html#module-pkgutil" title="pkgutil: Utilities for the import system."><code class="xref py py-mod docutils literal notranslate">pkgutil</code></a>: <a class="reference internal" href="../library/pkgutil.html#pkgutil.find_loader" title="pkgutil.find_loader"><code class="xref py py-func docutils literal notranslate">find_loader()</code></a> and <a class="reference internal" href="../library/pkgutil.html#pkgutil.get_loader" title="pkgutil.get_loader"><code class="xref py py-func docutils literal notranslate">get_loader()</code></a> now raise <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a>; use <a class="reference internal" href="../library/importlib.html#importlib.util.find_spec" title="importlib.util.find_spec"><code class="xref py py-func docutils literal notranslate">importlib.util.find_spec()</code></a> instead. (Contributed by Nikita Sobolev in <a class="reference external" href="https://github.com/python/cpython/issues/97850">gh-97850</a>.)</li> <li><a class="reference internal" href="../library/pty.html#module-pty" title="pty: Pseudo-Terminal Handling for Unix. (Unix)"><code class="xref py py-mod docutils literal notranslate">pty</code></a>: <ul class="simple"> <li><code class="docutils literal notranslate">master_open()</code>: use <a class="reference internal" href="../library/pty.html#pty.openpty" title="pty.openpty"><code class="xref py py-func docutils literal notranslate">pty.openpty()</code></a>.</li> <li><code class="docutils literal notranslate">slave_open()</code>: use <a class="reference internal" href="../library/pty.html#pty.openpty" title="pty.openpty"><code class="xref py py-func docutils literal notranslate">pty.openpty()</code></a>.</li> </ul> </li> <li><a class="reference internal" href="../library/sqlite3.html#module-sqlite3" title="sqlite3: A DB-API 2.0 implementation using SQLite 3.x."><code class="xref py py-mod docutils literal notranslate">sqlite3</code></a>: <ul class="simple"> <li><a class="reference internal" href="../library/sqlite3.html#sqlite3.version" title="sqlite3.version"><code class="xref py py-data docutils literal notranslate">version</code></a> and <a class="reference internal" href="../library/sqlite3.html#sqlite3.version_info" title="sqlite3.version_info"><code class="xref py py-data docutils literal notranslate">version_info</code></a>.</li> <li><a class="reference internal" href="../library/sqlite3.html#sqlite3.Cursor.execute" title="sqlite3.Cursor.execute"><code class="xref py py-meth docutils literal notranslate">execute()</code></a> and <a class="reference internal" href="../library/sqlite3.html#sqlite3.Cursor.executemany" title="sqlite3.Cursor.executemany"><code class="xref py py-meth docutils literal notranslate">executemany()</code></a> if <a class="reference internal" href="../library/sqlite3.html#sqlite3-placeholders">named placeholders</a> are used and parameters is a sequence instead of a <a class="reference internal" href="../library/stdtypes.html#dict" title="dict"><code class="xref py py-class docutils literal notranslate">dict</code></a>.</li> </ul> </li> <li><a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a>: <a class="reference internal" href="../library/typing.html#typing.ByteString" title="typing.ByteString"><code class="xref py py-class docutils literal notranslate">ByteString</code></a>, deprecated since Python 3.9, now causes a <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a> to be emitted when it is used.</li> <li><a class="reference internal" href="../library/urllib.html#module-urllib" title="urllib"><code class="xref py py-mod docutils literal notranslate">urllib</code></a>: <code class="xref py py-class docutils literal notranslate">urllib.parse.Quoter</code> is deprecated: it was not intended to be a public API. (Contributed by Gregory P. Smith in <a class="reference external" href="https://github.com/python/cpython/issues/88168">gh-88168</a>.)</li> </ul> </section> <section id="pending-removal-in-python-3-15"> <h3>Pending Removal in Python 3.15<a class="headerlink" href="#pending-removal-in-python-3-15" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The import system: <ul> <li>Setting <a class="reference internal" href="../reference/datamodel.html#module.__cached__" title="module.__cached__"><code class="xref py py-attr docutils literal notranslate">__cached__</code></a> on a module while failing to set <a class="reference internal" href="../library/importlib.html#importlib.machinery.ModuleSpec.cached" title="importlib.machinery.ModuleSpec.cached"><code class="xref py py-attr docutils literal notranslate">__spec__.cached</code></a> is deprecated. In Python 3.15, <code class="xref py py-attr docutils literal notranslate">__cached__</code> will cease to be set or take into consideration by the import system or standard library. (<a class="reference external" href="https://github.com/python/cpython/issues/97879">gh-97879</a>)</li> <li>Setting <a class="reference internal" href="../reference/datamodel.html#module.__package__" title="module.__package__"><code class="xref py py-attr docutils literal notranslate">__package__</code></a> on a module while failing to set <a class="reference internal" href="../library/importlib.html#importlib.machinery.ModuleSpec.parent" title="importlib.machinery.ModuleSpec.parent"><code class="xref py py-attr docutils literal notranslate">__spec__.parent</code></a> is deprecated. In Python 3.15, <code class="xref py py-attr docutils literal notranslate">__package__</code> will cease to be set or take into consideration by the import system or standard library. (<a class="reference external" href="https://github.com/python/cpython/issues/97879">gh-97879</a>)</li> </ul> </li> <li><a class="reference internal" href="../library/ctypes.html#module-ctypes" title="ctypes: A foreign function library for Python."><code class="xref py py-mod docutils literal notranslate">ctypes</code></a>: <ul> <li>The undocumented <code class="xref py py-func docutils literal notranslate">ctypes.SetPointerType()</code> function has been deprecated since Python 3.13.</li> </ul> </li> <li><a class="reference internal" href="../library/http.server.html#module-http.server" title="http.server: HTTP server and request handlers."><code class="xref py py-mod docutils literal notranslate">http.server</code></a>: <ul> <li>The obsolete and rarely used <a class="reference internal" href="../library/http.server.html#http.server.CGIHTTPRequestHandler" title="http.server.CGIHTTPRequestHandler"><code class="xref py py-class docutils literal notranslate">CGIHTTPRequestHandler</code></a> has been deprecated since Python 3.13. No direct replacement exists. Anything is better than CGI to interface a web server with a request handler.</li> <li>The <code class="xref std std-option docutils literal notranslate">--cgi</code> flag to the python -m http.server command-line interface has been deprecated since Python 3.13.</li> </ul> </li> <li><a class="reference internal" href="../library/locale.html#module-locale" title="locale: Internationalization services."><code class="xref py py-class docutils literal notranslate">locale</code></a>: <ul> <li>The <a class="reference internal" href="../library/locale.html#locale.getdefaultlocale" title="locale.getdefaultlocale"><code class="xref py py-func docutils literal notranslate">getdefaultlocale()</code></a> function has been deprecated since Python 3.11. Its removal was originally planned for Python 3.13 (<a class="reference external" href="https://github.com/python/cpython/issues/90817">gh-90817</a>), but has been postponed to Python 3.15. Use <a class="reference internal" href="../library/locale.html#locale.getlocale" title="locale.getlocale"><code class="xref py py-func docutils literal notranslate">getlocale()</code></a>, <a class="reference internal" href="../library/locale.html#locale.setlocale" title="locale.setlocale"><code class="xref py py-func docutils literal notranslate">setlocale()</code></a>, and <a class="reference internal" href="../library/locale.html#locale.getencoding" title="locale.getencoding"><code class="xref py py-func docutils literal notranslate">getencoding()</code></a> instead. (Contributed by Hugo van Kemenade in <a class="reference external" href="https://github.com/python/cpython/issues/111187">gh-111187</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/pathlib.html#module-pathlib" title="pathlib: Object-oriented filesystem paths"><code class="xref py py-mod docutils literal notranslate">pathlib</code></a>: <ul> <li><a class="reference internal" href="../library/pathlib.html#pathlib.PurePath.is_reserved" title="pathlib.PurePath.is_reserved"><code class="xref py py-meth docutils literal notranslate">PurePath.is_reserved()</code></a> has been deprecated since Python 3.13. Use <a class="reference internal" href="../library/os.path.html#os.path.isreserved" title="os.path.isreserved"><code class="xref py py-func docutils literal notranslate">os.path.isreserved()</code></a> to detect reserved paths on Windows.</li> </ul> </li> <li><a class="reference internal" href="../library/platform.html#module-platform" title="platform: Retrieves as much platform identifying data as possible."><code class="xref py py-mod docutils literal notranslate">platform</code></a>: <ul> <li><a class="reference internal" href="../library/platform.html#platform.java_ver" title="platform.java_ver"><code class="xref py py-func docutils literal notranslate">java_ver()</code></a> has been deprecated since Python 3.13. This function is only useful for Jython support, has a confusing API, and is largely untested.</li> </ul> </li> <li><a class="reference internal" href="../library/threading.html#module-threading" title="threading: Thread-based parallelism."><code class="xref py py-mod docutils literal notranslate">threading</code></a>: <ul> <li><a class="reference internal" href="../library/threading.html#threading.RLock" title="threading.RLock"><code class="xref py py-func docutils literal notranslate">RLock()</code></a> will take no arguments in Python 3.15. Passing any arguments has been deprecated since Python 3.14, as the Python version does not permit any arguments, but the C version allows any number of positional or keyword arguments, ignoring every argument.</li> </ul> </li> <li><a class="reference internal" href="../library/types.html#module-types" title="types: Names for built-in types."><code class="xref py py-mod docutils literal notranslate">types</code></a>: <ul> <li><a class="reference internal" href="../library/types.html#types.CodeType" title="types.CodeType"><code class="xref py py-class docutils literal notranslate">types.CodeType</code></a>: Accessing <a class="reference internal" href="../reference/datamodel.html#codeobject.co_lnotab" title="codeobject.co_lnotab"><code class="xref py py-attr docutils literal notranslate">co_lnotab</code></a> was deprecated in <a class="pep reference external" href="https://peps.python.org/pep-0626/">PEP 626</a> since 3.10 and was planned to be removed in 3.12, but it only got a proper <a class="reference internal" href="../library/exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate">DeprecationWarning</code></a> in 3.12. May be removed in 3.15. (Contributed by Nikita Sobolev in <a class="reference external" href="https://github.com/python/cpython/issues/101866">gh-101866</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a>: <ul> <li>The undocumented keyword argument syntax for creating <a class="reference internal" href="../library/typing.html#typing.NamedTuple" title="typing.NamedTuple"><code class="xref py py-class docutils literal notranslate">NamedTuple</code></a> classes (e.g. <code class="docutils literal notranslate">Point = NamedTuple("Point", x=int, y=int)</code>) has been deprecated since Python 3.13. Use the class-based syntax or the functional syntax instead.</li> <li>The <a class="reference internal" href="../library/typing.html#typing.no_type_check_decorator" title="typing.no_type_check_decorator"><code class="xref py py-func docutils literal notranslate">typing.no_type_check_decorator()</code></a> decorator function has been deprecated since Python 3.13. After eight years in the <a class="reference internal" href="../library/typing.html#module-typing" title="typing: Support for type hints (see :pep:`484`)."><code class="xref py py-mod docutils literal notranslate">typing</code></a> module, it has yet to be supported by any major type checker.</li> </ul> </li> <li><a class="reference internal" href="../library/wave.html#module-wave" title="wave: Provide an interface to the WAV sound format."><code class="xref py py-mod docutils literal notranslate">wave</code></a>: <ul> <li>The <a class="reference internal" href="../library/wave.html#wave.Wave_read.getmark" title="wave.Wave_read.getmark"><code class="xref py py-meth docutils literal notranslate">getmark()</code></a>, <code class="xref py py-meth docutils literal notranslate">setmark()</code>, and <a class="reference internal" href="../library/wave.html#wave.Wave_read.getmarkers" title="wave.Wave_read.getmarkers"><code class="xref py py-meth docutils literal notranslate">getmarkers()</code></a> methods of the <a class="reference internal" href="../library/wave.html#wave.Wave_read" title="wave.Wave_read"><code class="xref py py-class docutils literal notranslate">Wave_read</code></a> and <a class="reference internal" href="../library/wave.html#wave.Wave_write" title="wave.Wave_write"><code class="xref py py-class docutils literal notranslate">Wave_write</code></a> classes have been deprecated since Python 3.13.</li> </ul> </li> </ul> </section> <section id="pending-removal-in-python-3-16"> <h3>Pending removal in Python 3.16<a class="headerlink" href="#pending-removal-in-python-3-16" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The import system: <ul> <li>Setting <a class="reference internal" href="../reference/datamodel.html#module.__loader__" title="module.__loader__"><code class="xref py py-attr docutils literal notranslate">__loader__</code></a> on a module while failing to set <a class="reference internal" href="../library/importlib.html#importlib.machinery.ModuleSpec.loader" title="importlib.machinery.ModuleSpec.loader"><code class="xref py py-attr docutils literal notranslate">__spec__.loader</code></a> is deprecated. In Python 3.16, <code class="xref py py-attr docutils literal notranslate">__loader__</code> will cease to be set or taken into consideration by the import system or the standard library.</li> </ul> </li> <li><a class="reference internal" href="../library/array.html#module-array" title="array: Space efficient arrays of uniformly typed numeric values."><code class="xref py py-mod docutils literal notranslate">array</code></a>: <ul> <li>The <code class="docutils literal notranslate">'u'</code> format code (<code class="xref c c-type docutils literal notranslate">wchar_t</code>) has been deprecated in documentation since Python 3.3 and at runtime since Python 3.13. Use the <code class="docutils literal notranslate">'w'</code> format code (<a class="reference internal" href="../c-api/unicode.html#c.Py_UCS4" title="Py_UCS4"><code class="xref c c-type docutils literal notranslate">Py_UCS4</code></a>) for Unicode characters instead.</li> </ul> </li> <li><a class="reference internal" href="../library/asyncio.html#module-asyncio" title="asyncio: Asynchronous I/O."><code class="xref py py-mod docutils literal notranslate">asyncio</code></a>: <ul> <li><code class="xref py py-func docutils literal notranslate">asyncio.iscoroutinefunction()</code> is deprecated and will be removed in Python 3.16, use <a class="reference internal" href="../library/inspect.html#inspect.iscoroutinefunction" title="inspect.iscoroutinefunction"><code class="xref py py-func docutils literal notranslate">inspect.iscoroutinefunction()</code></a> instead. (Contributed by Jiahao Li and Kumar Aditya in <a class="reference external" href="https://github.com/python/cpython/issues/122875">gh-122875</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/builtins.html#module-builtins" title="builtins: The module that provides the built-in namespace."><code class="xref py py-mod docutils literal notranslate">builtins</code></a>: <ul> <li>Bitwise inversion on boolean types, <code class="docutils literal notranslate">~True</code> or <code class="docutils literal notranslate">~False</code> has been deprecated since Python 3.12, as it produces surprising and unintuitive results (<code class="docutils literal notranslate">-2</code> and <code class="docutils literal notranslate">-1</code>). Use <code class="docutils literal notranslate">not x</code> instead for the logical negation of a Boolean. In the rare case that you need the bitwise inversion of the underlying integer, convert to <code class="docutils literal notranslate">int</code> explicitly (<code class="docutils literal notranslate">~int(x)</code>).</li> </ul> </li> <li><a class="reference internal" href="../library/shutil.html#module-shutil" title="shutil: High-level file operations, including copying."><code class="xref py py-mod docutils literal notranslate">shutil</code></a>: <ul> <li>The <code class="xref py py-class docutils literal notranslate">ExecError</code> exception has been deprecated since Python 3.14. It has not been used by any function in <code class="xref py py-mod docutils literal notranslate">shutil</code> since Python 3.4, and is now an alias of <a class="reference internal" href="../library/exceptions.html#RuntimeError" title="RuntimeError"><code class="xref py py-exc docutils literal notranslate">RuntimeError</code></a>.</li> </ul> </li> <li><a class="reference internal" href="../library/symtable.html#module-symtable" title="symtable: Interface to the compiler's internal symbol tables."><code class="xref py py-mod docutils literal notranslate">symtable</code></a>: <ul> <li>The <a class="reference internal" href="../library/symtable.html#symtable.Class.get_methods" title="symtable.Class.get_methods"><code class="xref py py-meth docutils literal notranslate">Class.get_methods</code></a> method has been deprecated since Python 3.14.</li> </ul> </li> <li><a class="reference internal" href="../library/sys.html#module-sys" title="sys: Access system-specific parameters and functions."><code class="xref py py-mod docutils literal notranslate">sys</code></a>: <ul> <li>The <a class="reference internal" href="../library/sys.html#sys._enablelegacywindowsfsencoding" title="sys._enablelegacywindowsfsencoding"><code class="xref py py-func docutils literal notranslate">_enablelegacywindowsfsencoding()</code></a> function has been deprecated since Python 3.13. Use the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHONLEGACYWINDOWSFSENCODING"><code class="xref std std-envvar docutils literal notranslate">PYTHONLEGACYWINDOWSFSENCODING</code></a> environment variable instead.</li> </ul> </li> <li><a class="reference internal" href="../library/tarfile.html#module-tarfile" title="tarfile: Read and write tar-format archive files."><code class="xref py py-mod docutils literal notranslate">tarfile</code></a>: <ul> <li>The undocumented and unused <code class="xref py py-attr docutils literal notranslate">TarFile.tarfile</code> attribute has been deprecated since Python 3.13.</li> </ul> </li> </ul> </section> <section id="pending-removal-in-future-versions"> <h3>Pending Removal in Future Versions<a class="headerlink" href="#pending-removal-in-future-versions" title="Link to this heading">¶</a></h3> The following APIs will be removed in the future, although there is currently no date scheduled for their removal. <ul class="simple"> <li><a class="reference internal" href="../library/argparse.html#module-argparse" title="argparse: Command-line option and argument parsing library."><code class="xref py py-mod docutils literal notranslate">argparse</code></a>: Nesting argument groups and nesting mutually exclusive groups are deprecated.</li> <li><a class="reference internal" href="../library/array.html#module-array" title="array: Space efficient arrays of uniformly typed numeric values."><code class="xref py py-mod docutils literal notranslate">array</code></a>’s <code class="docutils literal notranslate">'u'</code> format code (<a class="reference external" href="https://github.com/python/cpython/issues/57281">gh-57281</a>)</li> <li><a class="reference internal" href="../library/builtins.html#module-builtins" title="builtins: The module that provides the built-in namespace."><code class="xref py py-mod docutils literal notranslate">builtins</code></a>: <ul> <li><code class="docutils literal notranslate">bool(NotImplemented)</code>.</li> <li>Generators: <code class="docutils literal notranslate">throw(type, exc, tb)</code> and <code class="docutils literal notranslate">athrow(type, exc, tb)</code> signature is deprecated: use <code class="docutils literal notranslate">throw(exc)</code> and <code class="docutils literal notranslate">athrow(exc)</code> instead, the single argument signature.</li> <li>Currently Python accepts numeric literals immediately followed by keywords, for example <code class="docutils literal notranslate">0in x</code>, <code class="docutils literal notranslate">1or x</code>, <code class="docutils literal notranslate">0if 1else 2</code>. It allows confusing and ambiguous expressions like <code class="docutils literal notranslate">[0x1for x in y]</code> (which can be interpreted as <code class="docutils literal notranslate">[0x1 for x in y]</code> or <code class="docutils literal notranslate">[0x1f or x in y]</code>). A syntax warning is raised if the numeric literal is immediately followed by one of keywords <a class="reference internal" href="../reference/expressions.html#and"><code class="xref std std-keyword docutils literal notranslate">and</code></a>, <a class="reference internal" href="../reference/compound_stmts.html#else"><code class="xref std std-keyword docutils literal notranslate">else</code></a>, <a class="reference internal" href="../reference/compound_stmts.html#for"><code class="xref std std-keyword docutils literal notranslate">for</code></a>, <a class="reference internal" href="../reference/compound_stmts.html#if"><code class="xref std std-keyword docutils literal notranslate">if</code></a>, <a class="reference internal" href="../reference/expressions.html#in"><code class="xref std std-keyword docutils literal notranslate">in</code></a>, <a class="reference internal" href="../reference/expressions.html#is"><code class="xref std std-keyword docutils literal notranslate">is</code></a> and <a class="reference internal" href="../reference/expressions.html#or"><code class="xref std std-keyword docutils literal notranslate">or</code></a>. In a future release it will be changed to a syntax error. (<a class="reference external" href="https://github.com/python/cpython/issues/87999">gh-87999</a>)</li> <li>Support for <code class="docutils literal notranslate">__index__()</code> and <code class="docutils literal notranslate">__int__()</code> method returning non-int type: these methods will be required to return an instance of a strict subclass of <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a>.</li> <li>Support for <code class="docutils literal notranslate">__float__()</code> method returning a strict subclass of <a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate">float</code></a>: these methods will be required to return an instance of <a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate">float</code></a>.</li> <li>Support for <code class="docutils literal notranslate">__complex__()</code> method returning a strict subclass of <a class="reference internal" href="../library/functions.html#complex" title="complex"><code class="xref py py-class docutils literal notranslate">complex</code></a>: these methods will be required to return an instance of <a class="reference internal" href="../library/functions.html#complex" title="complex"><code class="xref py py-class docutils literal notranslate">complex</code></a>.</li> <li>Delegation of <code class="docutils literal notranslate">int()</code> to <code class="docutils literal notranslate">__trunc__()</code> method.</li> <li>Passing a complex number as the real or imag argument in the <a class="reference internal" href="../library/functions.html#complex" title="complex"><code class="xref py py-func docutils literal notranslate">complex()</code></a> constructor is now deprecated; it should only be passed as a single positional argument. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/109218">gh-109218</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/calendar.html#module-calendar" title="calendar: Functions for working with calendars, including some emulation of the Unix cal program."><code class="xref py py-mod docutils literal notranslate">calendar</code></a>: <code class="docutils literal notranslate">calendar.January</code> and <code class="docutils literal notranslate">calendar.February</code> constants are deprecated and replaced by <a class="reference internal" href="../library/calendar.html#calendar.JANUARY" title="calendar.JANUARY"><code class="xref py py-data docutils literal notranslate">calendar.JANUARY</code></a> and <a class="reference internal" href="../library/calendar.html#calendar.FEBRUARY" title="calendar.FEBRUARY"><code class="xref py py-data docutils literal notranslate">calendar.FEBRUARY</code></a>. (Contributed by Prince Roshan in <a class="reference external" href="https://github.com/python/cpython/issues/103636">gh-103636</a>.)</li> <li><a class="reference internal" href="../reference/datamodel.html#codeobject.co_lnotab" title="codeobject.co_lnotab"><code class="xref py py-attr docutils literal notranslate">codeobject.co_lnotab</code></a>: use the <a class="reference internal" href="../reference/datamodel.html#codeobject.co_lines" title="codeobject.co_lines"><code class="xref py py-meth docutils literal notranslate">codeobject.co_lines()</code></a> method instead.</li> <li><a class="reference internal" href="../library/datetime.html#module-datetime" title="datetime: Basic date and time types."><code class="xref py py-mod docutils literal notranslate">datetime</code></a>: <ul> <li><a class="reference internal" href="../library/datetime.html#datetime.datetime.utcnow" title="datetime.datetime.utcnow"><code class="xref py py-meth docutils literal notranslate">utcnow()</code></a>: use <code class="docutils literal notranslate">datetime.datetime.now(tz=datetime.UTC)</code>.</li> <li><a class="reference internal" href="../library/datetime.html#datetime.datetime.utcfromtimestamp" title="datetime.datetime.utcfromtimestamp"><code class="xref py py-meth docutils literal notranslate">utcfromtimestamp()</code></a>: use <code class="docutils literal notranslate">datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)</code>.</li> </ul> </li> <li><a class="reference internal" href="../library/gettext.html#module-gettext" title="gettext: Multilingual internationalization services."><code class="xref py py-mod docutils literal notranslate">gettext</code></a>: Plural value must be an integer.</li> <li><a class="reference internal" href="../library/importlib.html#module-importlib" title="importlib: The implementation of the import machinery."><code class="xref py py-mod docutils literal notranslate">importlib</code></a>: <ul> <li><code class="docutils literal notranslate">load_module()</code> method: use <code class="docutils literal notranslate">exec_module()</code> instead.</li> <li><a class="reference internal" href="../library/importlib.html#importlib.util.cache_from_source" title="importlib.util.cache_from_source"><code class="xref py py-func docutils literal notranslate">cache_from_source()</code></a> debug_override parameter is deprecated: use the optimization parameter instead.</li> </ul> </li> <li><a class="reference internal" href="../library/importlib.metadata.html#module-importlib.metadata" title="importlib.metadata: Accessing package metadata"><code class="xref py py-mod docutils literal notranslate">importlib.metadata</code></a>: <ul> <li><code class="docutils literal notranslate">EntryPoints</code> tuple interface.</li> <li>Implicit <code class="docutils literal notranslate">None</code> on return values.</li> </ul> </li> <li><a class="reference internal" href="../library/logging.html#module-logging" title="logging: Flexible event logging system for applications."><code class="xref py py-mod docutils literal notranslate">logging</code></a>: the <code class="docutils literal notranslate">warn()</code> method has been deprecated since Python 3.3, use <a class="reference internal" href="../library/logging.html#logging.warning" title="logging.warning"><code class="xref py py-meth docutils literal notranslate">warning()</code></a> instead.</li> <li><a class="reference internal" href="../library/mailbox.html#module-mailbox" title="mailbox: Manipulate mailboxes in various formats"><code class="xref py py-mod docutils literal notranslate">mailbox</code></a>: Use of StringIO input and text mode is deprecated, use BytesIO and binary mode instead.</li> <li><a class="reference internal" href="../library/os.html#module-os" title="os: Miscellaneous operating system interfaces."><code class="xref py py-mod docutils literal notranslate">os</code></a>: Calling <a class="reference internal" href="../library/os.html#os.register_at_fork" title="os.register_at_fork"><code class="xref py py-func docutils literal notranslate">os.register_at_fork()</code></a> in multi-threaded process.</li> <li><code class="xref py py-class docutils literal notranslate">pydoc.ErrorDuringImport</code>: A tuple value for exc_info parameter is deprecated, use an exception instance.</li> <li><a class="reference internal" href="../library/re.html#module-re" title="re: Regular expression operations."><code class="xref py py-mod docutils literal notranslate">re</code></a>: More strict rules are now applied for numerical group references and group names in regular expressions. Only sequence of ASCII digits is now accepted as a numerical reference. The group name in bytes patterns and replacement strings can now only contain ASCII letters and digits and underscore. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/91760">gh-91760</a>.)</li> <li><code class="xref py py-mod docutils literal notranslate">sre_compile</code>, <code class="xref py py-mod docutils literal notranslate">sre_constants</code> and <code class="xref py py-mod docutils literal notranslate">sre_parse</code> modules.</li> <li><a class="reference internal" href="../library/shutil.html#module-shutil" title="shutil: High-level file operations, including copying."><code class="xref py py-mod docutils literal notranslate">shutil</code></a>: <a class="reference internal" href="../library/shutil.html#shutil.rmtree" title="shutil.rmtree"><code class="xref py py-func docutils literal notranslate">rmtree()</code></a>’s onerror parameter is deprecated in Python 3.12; use the onexc parameter instead.</li> <li><a class="reference internal" href="../library/ssl.html#module-ssl" title="ssl: TLS/SSL wrapper for socket objects"><code class="xref py py-mod docutils literal notranslate">ssl</code></a> options and protocols: <ul> <li><a class="reference internal" href="../library/ssl.html#ssl.SSLContext" title="ssl.SSLContext"><code class="xref py py-class docutils literal notranslate">ssl.SSLContext</code></a> without protocol argument is deprecated.</li> <li><a class="reference internal" href="../library/ssl.html#ssl.SSLContext" title="ssl.SSLContext"><code class="xref py py-class docutils literal notranslate">ssl.SSLContext</code></a>: <a class="reference internal" href="../library/ssl.html#ssl.SSLContext.set_npn_protocols" title="ssl.SSLContext.set_npn_protocols"><code class="xref py py-meth docutils literal notranslate">set_npn_protocols()</code></a> and <code class="xref py py-meth docutils literal notranslate">selected_npn_protocol()</code> are deprecated: use ALPN instead.</li> <li><code class="docutils literal notranslate">ssl.OP_NO_SSL*</code> options</li> <li><code class="docutils literal notranslate">ssl.OP_NO_TLS*</code> options</li> <li><code class="docutils literal notranslate">ssl.PROTOCOL_SSLv3</code></li> <li><code class="docutils literal notranslate">ssl.PROTOCOL_TLS</code></li> <li><code class="docutils literal notranslate">ssl.PROTOCOL_TLSv1</code></li> <li><code class="docutils literal notranslate">ssl.PROTOCOL_TLSv1_1</code></li> <li><code class="docutils literal notranslate">ssl.PROTOCOL_TLSv1_2</code></li> <li><code class="docutils literal notranslate">ssl.TLSVersion.SSLv3</code></li> <li><code class="docutils literal notranslate">ssl.TLSVersion.TLSv1</code></li> <li><code class="docutils literal notranslate">ssl.TLSVersion.TLSv1_1</code></li> </ul> </li> <li><a class="reference internal" href="../library/sysconfig.html#sysconfig.is_python_build" title="sysconfig.is_python_build"><code class="xref py py-func docutils literal notranslate">sysconfig.is_python_build()</code></a> check_home parameter is deprecated and ignored.</li> <li><a class="reference internal" href="../library/threading.html#module-threading" title="threading: Thread-based parallelism."><code class="xref py py-mod docutils literal notranslate">threading</code></a> methods: <ul> <li><code class="xref py py-meth docutils literal notranslate">threading.Condition.notifyAll()</code>: use <a class="reference internal" href="../library/threading.html#threading.Condition.notify_all" title="threading.Condition.notify_all"><code class="xref py py-meth docutils literal notranslate">notify_all()</code></a>.</li> <li><code class="xref py py-meth docutils literal notranslate">threading.Event.isSet()</code>: use <a class="reference internal" href="../library/threading.html#threading.Event.is_set" title="threading.Event.is_set"><code class="xref py py-meth docutils literal notranslate">is_set()</code></a>.</li> <li><code class="xref py py-meth docutils literal notranslate">threading.Thread.isDaemon()</code>, <a class="reference internal" href="../library/threading.html#threading.Thread.setDaemon" title="threading.Thread.setDaemon"><code class="xref py py-meth docutils literal notranslate">threading.Thread.setDaemon()</code></a>: use <a class="reference internal" href="../library/threading.html#threading.Thread.daemon" title="threading.Thread.daemon"><code class="xref py py-attr docutils literal notranslate">threading.Thread.daemon</code></a> attribute.</li> <li><code class="xref py py-meth docutils literal notranslate">threading.Thread.getName()</code>, <a class="reference internal" href="../library/threading.html#threading.Thread.setName" title="threading.Thread.setName"><code class="xref py py-meth docutils literal notranslate">threading.Thread.setName()</code></a>: use <a class="reference internal" href="../library/threading.html#threading.Thread.name" title="threading.Thread.name"><code class="xref py py-attr docutils literal notranslate">threading.Thread.name</code></a> attribute.</li> <li><code class="xref py py-meth docutils literal notranslate">threading.currentThread()</code>: use <a class="reference internal" href="../library/threading.html#threading.current_thread" title="threading.current_thread"><code class="xref py py-meth docutils literal notranslate">threading.current_thread()</code></a>.</li> <li><code class="xref py py-meth docutils literal notranslate">threading.activeCount()</code>: use <a class="reference internal" href="../library/threading.html#threading.active_count" title="threading.active_count"><code class="xref py py-meth docutils literal notranslate">threading.active_count()</code></a>.</li> </ul> </li> <li><a class="reference internal" href="../library/typing.html#typing.Text" title="typing.Text"><code class="xref py py-class docutils literal notranslate">typing.Text</code></a> (<a class="reference external" href="https://github.com/python/cpython/issues/92332">gh-92332</a>).</li> <li><a class="reference internal" href="../library/unittest.html#unittest.IsolatedAsyncioTestCase" title="unittest.IsolatedAsyncioTestCase"><code class="xref py py-class docutils literal notranslate">unittest.IsolatedAsyncioTestCase</code></a>: it is deprecated to return a value that is not <code class="docutils literal notranslate">None</code> from a test case.</li> <li><a class="reference internal" href="../library/urllib.parse.html#module-urllib.parse" title="urllib.parse: Parse URLs into or assemble them from components."><code class="xref py py-mod docutils literal notranslate">urllib.parse</code></a> deprecated functions: <a class="reference internal" href="../library/urllib.parse.html#urllib.parse.urlparse" title="urllib.parse.urlparse"><code class="xref py py-func docutils literal notranslate">urlparse()</code></a> instead <ul> <li><code class="docutils literal notranslate">splitattr()</code></li> <li><code class="docutils literal notranslate">splithost()</code></li> <li><code class="docutils literal notranslate">splitnport()</code></li> <li><code class="docutils literal notranslate">splitpasswd()</code></li> <li><code class="docutils literal notranslate">splitport()</code></li> <li><code class="docutils literal notranslate">splitquery()</code></li> <li><code class="docutils literal notranslate">splittag()</code></li> <li><code class="docutils literal notranslate">splittype()</code></li> <li><code class="docutils literal notranslate">splituser()</code></li> <li><code class="docutils literal notranslate">splitvalue()</code></li> <li><code class="docutils literal notranslate">to_bytes()</code></li> </ul> </li> <li><a class="reference internal" href="../library/urllib.request.html#module-urllib.request" title="urllib.request: Extensible library for opening URLs."><code class="xref py py-mod docutils literal notranslate">urllib.request</code></a>: <a class="reference internal" href="../library/urllib.request.html#urllib.request.URLopener" title="urllib.request.URLopener"><code class="xref py py-class docutils literal notranslate">URLopener</code></a> and <a class="reference internal" href="../library/urllib.request.html#urllib.request.FancyURLopener" title="urllib.request.FancyURLopener"><code class="xref py py-class docutils literal notranslate">FancyURLopener</code></a> style of invoking requests is deprecated. Use newer <a class="reference internal" href="../library/urllib.request.html#urllib.request.urlopen" title="urllib.request.urlopen"><code class="xref py py-func docutils literal notranslate">urlopen()</code></a> functions and methods.</li> <li><a class="reference internal" href="../library/wsgiref.html#module-wsgiref" title="wsgiref: WSGI Utilities and Reference Implementation."><code class="xref py py-mod docutils literal notranslate">wsgiref</code></a>: <code class="docutils literal notranslate">SimpleHandler.stdout.write()</code> should not do partial writes.</li> <li><a class="reference internal" href="../library/xml.etree.elementtree.html#module-xml.etree.ElementTree" title="xml.etree.ElementTree: Implementation of the ElementTree API."><code class="xref py py-mod docutils literal notranslate">xml.etree.ElementTree</code></a>: Testing the truth value of an <a class="reference internal" href="../library/xml.etree.elementtree.html#xml.etree.ElementTree.Element" title="xml.etree.ElementTree.Element"><code class="xref py py-class docutils literal notranslate">Element</code></a> is deprecated. In a future release it will always return <code class="docutils literal notranslate">True</code>. Prefer explicit <code class="docutils literal notranslate">len(elem)</code> or <code class="docutils literal notranslate">elem is not None</code> tests instead.</li> <li><a class="reference internal" href="../library/zipimport.html#zipimport.zipimporter.load_module" title="zipimport.zipimporter.load_module"><code class="xref py py-meth docutils literal notranslate">zipimport.zipimporter.load_module()</code></a> is deprecated: use <a class="reference internal" href="../library/zipimport.html#zipimport.zipimporter.exec_module" title="zipimport.zipimporter.exec_module"><code class="xref py py-meth docutils literal notranslate">exec_module()</code></a> instead.</li> </ul> </section> </section> <section id="cpython-bytecode-changes"> <h2>CPython Bytecode Changes<a class="headerlink" href="#cpython-bytecode-changes" title="Link to this heading">¶</a></h2> <ul class="simple"> <li>The oparg of <a class="reference internal" href="../library/dis.html#opcode-YIELD_VALUE"><code class="xref std std-opcode docutils literal notranslate">YIELD_VALUE</code></a> is now <code class="docutils literal notranslate">1</code> if the yield is part of a yield-from or await, and <code class="docutils literal notranslate">0</code> otherwise. The oparg of <a class="reference internal" href="../library/dis.html#opcode-RESUME"><code class="xref std std-opcode docutils literal notranslate">RESUME</code></a> was changed to add a bit indicating if the except-depth is 1, which is needed to optimize closing of generators. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/111354">gh-111354</a>.)</li> </ul> </section> <section id="c-api-changes"> <h2>C API Changes<a class="headerlink" href="#c-api-changes" title="Link to this heading">¶</a></h2> <section id="id7"> <h3>New Features<a class="headerlink" href="#id7" title="Link to this heading">¶</a></h3> <ul> <li>Add the <a class="reference internal" href="../c-api/monitoring.html#c-api-monitoring">PyMonitoring C API</a> for generating <a class="pep reference external" href="https://peps.python.org/pep-0669/">PEP 669</a> monitoring events: <ul class="simple"> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoringState" title="PyMonitoringState"><code class="xref c c-type docutils literal notranslate">PyMonitoringState</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FirePyStartEvent" title="PyMonitoring_FirePyStartEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FirePyStartEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FirePyResumeEvent" title="PyMonitoring_FirePyResumeEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FirePyResumeEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FirePyReturnEvent" title="PyMonitoring_FirePyReturnEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FirePyReturnEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FirePyYieldEvent" title="PyMonitoring_FirePyYieldEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FirePyYieldEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireCallEvent" title="PyMonitoring_FireCallEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireCallEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireLineEvent" title="PyMonitoring_FireLineEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireLineEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireJumpEvent" title="PyMonitoring_FireJumpEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireJumpEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireBranchEvent" title="PyMonitoring_FireBranchEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireBranchEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireCReturnEvent" title="PyMonitoring_FireCReturnEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireCReturnEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FirePyThrowEvent" title="PyMonitoring_FirePyThrowEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FirePyThrowEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireRaiseEvent" title="PyMonitoring_FireRaiseEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireRaiseEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireCRaiseEvent" title="PyMonitoring_FireCRaiseEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireCRaiseEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireReraiseEvent" title="PyMonitoring_FireReraiseEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireReraiseEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireExceptionHandledEvent" title="PyMonitoring_FireExceptionHandledEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireExceptionHandledEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FirePyUnwindEvent" title="PyMonitoring_FirePyUnwindEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FirePyUnwindEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_FireStopIterationEvent" title="PyMonitoring_FireStopIterationEvent"><code class="xref c c-func docutils literal notranslate">PyMonitoring_FireStopIterationEvent()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_EnterScope" title="PyMonitoring_EnterScope"><code class="xref c c-func docutils literal notranslate">PyMonitoring_EnterScope()</code></a></li> <li><a class="reference internal" href="../c-api/monitoring.html#c.PyMonitoring_ExitScope" title="PyMonitoring_ExitScope"><code class="xref c c-func docutils literal notranslate">PyMonitoring_ExitScope()</code></a></li> </ul> (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/111997">gh-111997</a>). </li> <li>Add <a class="reference internal" href="../c-api/init.html#c.PyMutex" title="PyMutex"><code class="xref c c-type docutils literal notranslate">PyMutex</code></a>, a lightweight mutex that occupies a single byte, and the new <a class="reference internal" href="../c-api/init.html#c.PyMutex_Lock" title="PyMutex_Lock"><code class="xref c c-func docutils literal notranslate">PyMutex_Lock()</code></a> and <a class="reference internal" href="../c-api/init.html#c.PyMutex_Unlock" title="PyMutex_Unlock"><code class="xref c c-func docutils literal notranslate">PyMutex_Unlock()</code></a> functions. <code class="xref c c-func docutils literal notranslate">PyMutex_Lock()</code> will release the <a class="reference internal" href="../glossary.html#term-GIL">GIL</a> (if currently held) if the operation needs to block. (Contributed by Sam Gross in <a class="reference external" href="https://github.com/python/cpython/issues/108724">gh-108724</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/time.html#c-api-time">PyTime C API</a> to provide access to system clocks: <ul class="simple"> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_t" title="PyTime_t"><code class="xref c c-type docutils literal notranslate">PyTime_t</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_MIN" title="PyTime_MIN"><code class="xref c c-var docutils literal notranslate">PyTime_MIN</code></a> and <a class="reference internal" href="../c-api/time.html#c.PyTime_MAX" title="PyTime_MAX"><code class="xref c c-var docutils literal notranslate">PyTime_MAX</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_AsSecondsDouble" title="PyTime_AsSecondsDouble"><code class="xref c c-func docutils literal notranslate">PyTime_AsSecondsDouble()</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_Monotonic" title="PyTime_Monotonic"><code class="xref c c-func docutils literal notranslate">PyTime_Monotonic()</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_MonotonicRaw" title="PyTime_MonotonicRaw"><code class="xref c c-func docutils literal notranslate">PyTime_MonotonicRaw()</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_PerfCounter" title="PyTime_PerfCounter"><code class="xref c c-func docutils literal notranslate">PyTime_PerfCounter()</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_PerfCounterRaw" title="PyTime_PerfCounterRaw"><code class="xref c c-func docutils literal notranslate">PyTime_PerfCounterRaw()</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_Time" title="PyTime_Time"><code class="xref c c-func docutils literal notranslate">PyTime_Time()</code></a>.</li> <li><a class="reference internal" href="../c-api/time.html#c.PyTime_TimeRaw" title="PyTime_TimeRaw"><code class="xref c c-func docutils literal notranslate">PyTime_TimeRaw()</code></a>.</li> </ul> (Contributed by Victor Stinner and Petr Viktorin in <a class="reference external" href="https://github.com/python/cpython/issues/110850">gh-110850</a>.) </li> <li>Add the <a class="reference internal" href="../c-api/dict.html#c.PyDict_ContainsString" title="PyDict_ContainsString"><code class="xref c c-func docutils literal notranslate">PyDict_ContainsString()</code></a> function with the same behavior as <a class="reference internal" href="../c-api/dict.html#c.PyDict_Contains" title="PyDict_Contains"><code class="xref c c-func docutils literal notranslate">PyDict_Contains()</code></a>, but key is specified as a const char* UTF-8 encoded bytes string, rather than a <a class="reference internal" href="../c-api/structures.html#c.PyObject" title="PyObject">PyObject</a>*. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108314">gh-108314</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/dict.html#c.PyDict_GetItemRef" title="PyDict_GetItemRef"><code class="xref c c-func docutils literal notranslate">PyDict_GetItemRef()</code></a> and <a class="reference internal" href="../c-api/dict.html#c.PyDict_GetItemStringRef" title="PyDict_GetItemStringRef"><code class="xref c c-func docutils literal notranslate">PyDict_GetItemStringRef()</code></a> functions, which behave similarly to <a class="reference internal" href="../c-api/dict.html#c.PyDict_GetItemWithError" title="PyDict_GetItemWithError"><code class="xref c c-func docutils literal notranslate">PyDict_GetItemWithError()</code></a>, but return a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a> instead of a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a>. Moreover, these functions return <code class="docutils literal notranslate">-1</code> on error, removing the need to check <code class="xref c c-func docutils literal notranslate">PyErr_Occurred()</code>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106004">gh-106004</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/dict.html#c.PyDict_SetDefaultRef" title="PyDict_SetDefaultRef"><code class="xref c c-func docutils literal notranslate">PyDict_SetDefaultRef()</code></a> function, which behaves similarly to <a class="reference internal" href="../c-api/dict.html#c.PyDict_SetDefault" title="PyDict_SetDefault"><code class="xref c c-func docutils literal notranslate">PyDict_SetDefault()</code></a>, but returns a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a> instead of a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a>. This function returns <code class="docutils literal notranslate">-1</code> on error, <code class="docutils literal notranslate">0</code> on insertion, and <code class="docutils literal notranslate">1</code> if the key was already present in the dictionary. (Contributed by Sam Gross in <a class="reference external" href="https://github.com/python/cpython/issues/112066">gh-112066</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/dict.html#c.PyDict_Pop" title="PyDict_Pop"><code class="xref c c-func docutils literal notranslate">PyDict_Pop()</code></a> and <a class="reference internal" href="../c-api/dict.html#c.PyDict_PopString" title="PyDict_PopString"><code class="xref c c-func docutils literal notranslate">PyDict_PopString()</code></a> functions to remove a key from a dictionary and optionally return the removed value. This is similar to <a class="reference internal" href="../library/stdtypes.html#dict.pop" title="dict.pop"><code class="xref py py-meth docutils literal notranslate">dict.pop()</code></a>, though there is no default value, and <a class="reference internal" href="../library/exceptions.html#KeyError" title="KeyError"><code class="xref py py-exc docutils literal notranslate">KeyError</code></a> is not raised for missing keys. (Contributed by Stefan Behnel and Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/111262">gh-111262</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_GetOptionalItem" title="PyMapping_GetOptionalItem"><code class="xref c c-func docutils literal notranslate">PyMapping_GetOptionalItem()</code></a> and <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_GetOptionalItemString" title="PyMapping_GetOptionalItemString"><code class="xref c c-func docutils literal notranslate">PyMapping_GetOptionalItemString()</code></a> functions as alternatives to <a class="reference internal" href="../c-api/object.html#c.PyObject_GetItem" title="PyObject_GetItem"><code class="xref c c-func docutils literal notranslate">PyObject_GetItem()</code></a> and <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_GetItemString" title="PyMapping_GetItemString"><code class="xref c c-func docutils literal notranslate">PyMapping_GetItemString()</code></a> respectively. The new functions do not raise <a class="reference internal" href="../library/exceptions.html#KeyError" title="KeyError"><code class="xref py py-exc docutils literal notranslate">KeyError</code></a> if the requested key is missing from the mapping. These variants are more convenient and faster if a missing key should not be treated as a failure. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/106307">gh-106307</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/object.html#c.PyObject_GetOptionalAttr" title="PyObject_GetOptionalAttr"><code class="xref c c-func docutils literal notranslate">PyObject_GetOptionalAttr()</code></a> and <a class="reference internal" href="../c-api/object.html#c.PyObject_GetOptionalAttrString" title="PyObject_GetOptionalAttrString"><code class="xref c c-func docutils literal notranslate">PyObject_GetOptionalAttrString()</code></a> functions as alternatives to <a class="reference internal" href="../c-api/object.html#c.PyObject_GetAttr" title="PyObject_GetAttr"><code class="xref c c-func docutils literal notranslate">PyObject_GetAttr()</code></a> and <a class="reference internal" href="../c-api/object.html#c.PyObject_GetAttrString" title="PyObject_GetAttrString"><code class="xref c c-func docutils literal notranslate">PyObject_GetAttrString()</code></a> respectively. The new functions do not raise <a class="reference internal" href="../library/exceptions.html#AttributeError" title="AttributeError"><code class="xref py py-exc docutils literal notranslate">AttributeError</code></a> if the requested attribute is not found on the object. These variants are more convenient and faster if the missing attribute should not be treated as a failure. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/106521">gh-106521</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/exceptions.html#c.PyErr_FormatUnraisable" title="PyErr_FormatUnraisable"><code class="xref c c-func docutils literal notranslate">PyErr_FormatUnraisable()</code></a> function as an extension to <a class="reference internal" href="../c-api/exceptions.html#c.PyErr_WriteUnraisable" title="PyErr_WriteUnraisable"><code class="xref c c-func docutils literal notranslate">PyErr_WriteUnraisable()</code></a> that allows customizing the warning message. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/108082">gh-108082</a>.)</li> <li>Add new functions that return a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a> instead of a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a> for frame locals, globals, and builtins, as part of <a class="reference internal" href="#whatsnew313-locals-semantics">PEP 667</a>: <ul class="simple"> <li><a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetFrameBuiltins" title="PyEval_GetFrameBuiltins"><code class="xref c c-func docutils literal notranslate">PyEval_GetFrameBuiltins()</code></a> replaces <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetBuiltins" title="PyEval_GetBuiltins"><code class="xref c c-func docutils literal notranslate">PyEval_GetBuiltins()</code></a></li> <li><a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetFrameGlobals" title="PyEval_GetFrameGlobals"><code class="xref c c-func docutils literal notranslate">PyEval_GetFrameGlobals()</code></a> replaces <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetGlobals" title="PyEval_GetGlobals"><code class="xref c c-func docutils literal notranslate">PyEval_GetGlobals()</code></a></li> <li><a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetFrameLocals" title="PyEval_GetFrameLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetFrameLocals()</code></a> replaces <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetLocals" title="PyEval_GetLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetLocals()</code></a></li> </ul> (Contributed by Mark Shannon and Tian Gao in <a class="reference external" href="https://github.com/python/cpython/issues/74929">gh-74929</a>.) </li> <li>Add the <a class="reference internal" href="../c-api/object.html#c.Py_GetConstant" title="Py_GetConstant"><code class="xref c c-func docutils literal notranslate">Py_GetConstant()</code></a> and <a class="reference internal" href="../c-api/object.html#c.Py_GetConstantBorrowed" title="Py_GetConstantBorrowed"><code class="xref c c-func docutils literal notranslate">Py_GetConstantBorrowed()</code></a> functions to get <a class="reference internal" href="../glossary.html#term-strong-reference">strong</a> or <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed</a> references to constants. For example, <code class="docutils literal notranslate">Py_GetConstant(Py_CONSTANT_ZERO)</code> returns a strong reference to the constant zero. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/115754">gh-115754</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/import.html#c.PyImport_AddModuleRef" title="PyImport_AddModuleRef"><code class="xref c c-func docutils literal notranslate">PyImport_AddModuleRef()</code></a> function as a replacement for <a class="reference internal" href="../c-api/import.html#c.PyImport_AddModule" title="PyImport_AddModule"><code class="xref c c-func docutils literal notranslate">PyImport_AddModule()</code></a> that returns a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a> instead of a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105922">gh-105922</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/init.html#c.Py_IsFinalizing" title="Py_IsFinalizing"><code class="xref c c-func docutils literal notranslate">Py_IsFinalizing()</code></a> function to check whether the main Python interpreter is <a class="reference internal" href="../glossary.html#term-interpreter-shutdown">shutting down</a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108014">gh-108014</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/list.html#c.PyList_GetItemRef" title="PyList_GetItemRef"><code class="xref c c-func docutils literal notranslate">PyList_GetItemRef()</code></a> function as a replacement for <a class="reference internal" href="../c-api/list.html#c.PyList_GetItem" title="PyList_GetItem"><code class="xref c c-func docutils literal notranslate">PyList_GetItem()</code></a> that returns a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a> instead of a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a>. (Contributed by Sam Gross in <a class="reference external" href="https://github.com/python/cpython/issues/114329">gh-114329</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/list.html#c.PyList_Extend" title="PyList_Extend"><code class="xref c c-func docutils literal notranslate">PyList_Extend()</code></a> and <a class="reference internal" href="../c-api/list.html#c.PyList_Clear" title="PyList_Clear"><code class="xref c c-func docutils literal notranslate">PyList_Clear()</code></a> functions, mirroring the Python <code class="xref py py-meth docutils literal notranslate">list.extend()</code> and <code class="xref py py-meth docutils literal notranslate">list.clear()</code> methods. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/111138">gh-111138</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/long.html#c.PyLong_AsInt" title="PyLong_AsInt"><code class="xref c c-func docutils literal notranslate">PyLong_AsInt()</code></a> function. It behaves similarly to <a class="reference internal" href="../c-api/long.html#c.PyLong_AsLong" title="PyLong_AsLong"><code class="xref c c-func docutils literal notranslate">PyLong_AsLong()</code></a>, but stores the result in a C int instead of a C long. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108014">gh-108014</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/long.html#c.PyLong_AsNativeBytes" title="PyLong_AsNativeBytes"><code class="xref c c-func docutils literal notranslate">PyLong_AsNativeBytes()</code></a>, <a class="reference internal" href="../c-api/long.html#c.PyLong_FromNativeBytes" title="PyLong_FromNativeBytes"><code class="xref c c-func docutils literal notranslate">PyLong_FromNativeBytes()</code></a>, and <a class="reference internal" href="../c-api/long.html#c.PyLong_FromUnsignedNativeBytes" title="PyLong_FromUnsignedNativeBytes"><code class="xref c c-func docutils literal notranslate">PyLong_FromUnsignedNativeBytes()</code></a> functions to simplify converting between native integer types and Python <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a> objects. (Contributed by Steve Dower in <a class="reference external" href="https://github.com/python/cpython/issues/111140">gh-111140</a>.)</li> <li>Add <a class="reference internal" href="../c-api/module.html#c.PyModule_Add" title="PyModule_Add"><code class="xref c c-func docutils literal notranslate">PyModule_Add()</code></a> function, which is similar to <a class="reference internal" href="../c-api/module.html#c.PyModule_AddObjectRef" title="PyModule_AddObjectRef"><code class="xref c c-func docutils literal notranslate">PyModule_AddObjectRef()</code></a> and <a class="reference internal" href="../c-api/module.html#c.PyModule_AddObject" title="PyModule_AddObject"><code class="xref c c-func docutils literal notranslate">PyModule_AddObject()</code></a>, but always steals a reference to the value. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/86493">gh-86493</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/hash.html#c.PyObject_GenericHash" title="PyObject_GenericHash"><code class="xref c c-func docutils literal notranslate">PyObject_GenericHash()</code></a> function that implements the default hashing function of a Python object. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/113024">gh-113024</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/hash.html#c.Py_HashPointer" title="Py_HashPointer"><code class="xref c c-func docutils literal notranslate">Py_HashPointer()</code></a> function to hash a raw pointer. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/111545">gh-111545</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/object.html#c.PyObject_VisitManagedDict" title="PyObject_VisitManagedDict"><code class="xref c c-func docutils literal notranslate">PyObject_VisitManagedDict()</code></a> and <a class="reference internal" href="../c-api/object.html#c.PyObject_ClearManagedDict" title="PyObject_ClearManagedDict"><code class="xref c c-func docutils literal notranslate">PyObject_ClearManagedDict()</code></a> functions. which must be called by the traverse and clear functions of a type using the <a class="reference internal" href="../c-api/typeobj.html#c.Py_TPFLAGS_MANAGED_DICT" title="Py_TPFLAGS_MANAGED_DICT"><code class="xref c c-macro docutils literal notranslate">Py_TPFLAGS_MANAGED_DICT</code></a> flag. The <a class="reference external" href="https://github.com/python/pythoncapi-compat/">pythoncapi-compat project</a> can be used to use these functions with Python 3.11 and 3.12. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/107073">gh-107073</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/init.html#c.PyRefTracer_SetTracer" title="PyRefTracer_SetTracer"><code class="xref c c-func docutils literal notranslate">PyRefTracer_SetTracer()</code></a> and <a class="reference internal" href="../c-api/init.html#c.PyRefTracer_GetTracer" title="PyRefTracer_GetTracer"><code class="xref c c-func docutils literal notranslate">PyRefTracer_GetTracer()</code></a> functions, which enable tracking object creation and destruction in the same way that the <a class="reference internal" href="../library/tracemalloc.html#module-tracemalloc" title="tracemalloc: Trace memory allocations."><code class="xref py py-mod docutils literal notranslate">tracemalloc</code></a> module does. (Contributed by Pablo Galindo in <a class="reference external" href="https://github.com/python/cpython/issues/93502">gh-93502</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/sys.html#c.PySys_AuditTuple" title="PySys_AuditTuple"><code class="xref c c-func docutils literal notranslate">PySys_AuditTuple()</code></a> function as an alternative to <a class="reference internal" href="../c-api/sys.html#c.PySys_Audit" title="PySys_Audit"><code class="xref c c-func docutils literal notranslate">PySys_Audit()</code></a> that takes event arguments as a Python <a class="reference internal" href="../library/stdtypes.html#tuple" title="tuple"><code class="xref py py-class docutils literal notranslate">tuple</code></a> object. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/85283">gh-85283</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/init.html#c.PyThreadState_GetUnchecked" title="PyThreadState_GetUnchecked"><code class="xref c c-func docutils literal notranslate">PyThreadState_GetUnchecked()</code></a> function as an alternative to <a class="reference internal" href="../c-api/init.html#c.PyThreadState_Get" title="PyThreadState_Get"><code class="xref c c-func docutils literal notranslate">PyThreadState_Get()</code></a> that doesn’t kill the process with a fatal error if it is <code class="docutils literal notranslate">NULL</code>. The caller is responsible for checking if the result is <code class="docutils literal notranslate">NULL</code>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108867">gh-108867</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/type.html#c.PyType_GetFullyQualifiedName" title="PyType_GetFullyQualifiedName"><code class="xref c c-func docutils literal notranslate">PyType_GetFullyQualifiedName()</code></a> function to get the type’s fully qualified name. The module name is prepended if <a class="reference internal" href="../reference/datamodel.html#type.__module__" title="type.__module__"><code class="xref py py-attr docutils literal notranslate">type.__module__</code></a> is a string and is not equal to either <code class="docutils literal notranslate">'builtins'</code> or <code class="docutils literal notranslate">'__main__'</code>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/111696">gh-111696</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/type.html#c.PyType_GetModuleName" title="PyType_GetModuleName"><code class="xref c c-func docutils literal notranslate">PyType_GetModuleName()</code></a> function to get the type’s module name. This is equivalent to getting the <a class="reference internal" href="../reference/datamodel.html#type.__module__" title="type.__module__"><code class="xref py py-attr docutils literal notranslate">type.__module__</code></a> attribute. (Contributed by Eric Snow and Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/111696">gh-111696</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/unicode.html#c.PyUnicode_EqualToUTF8AndSize" title="PyUnicode_EqualToUTF8AndSize"><code class="xref c c-func docutils literal notranslate">PyUnicode_EqualToUTF8AndSize()</code></a> and <a class="reference internal" href="../c-api/unicode.html#c.PyUnicode_EqualToUTF8" title="PyUnicode_EqualToUTF8"><code class="xref c c-func docutils literal notranslate">PyUnicode_EqualToUTF8()</code></a> functions to compare a Unicode object with a const char* UTF-8 encoded string and <code class="docutils literal notranslate">1</code> if they are equal or <code class="docutils literal notranslate">0</code> otherwise. These functions do not raise exceptions. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/110289">gh-110289</a>.)</li> <li>Add the <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetRef" title="PyWeakref_GetRef"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetRef()</code></a> function as an alternative to <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetObject" title="PyWeakref_GetObject"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetObject()</code></a> that returns a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a> or <code class="docutils literal notranslate">NULL</code> if the referent is no longer live. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105927">gh-105927</a>.)</li> <li>Add fixed variants of functions which silently ignore errors: <ul class="simple"> <li><a class="reference internal" href="../c-api/object.html#c.PyObject_HasAttrWithError" title="PyObject_HasAttrWithError"><code class="xref c c-func docutils literal notranslate">PyObject_HasAttrWithError()</code></a> replaces <a class="reference internal" href="../c-api/object.html#c.PyObject_HasAttr" title="PyObject_HasAttr"><code class="xref c c-func docutils literal notranslate">PyObject_HasAttr()</code></a>.</li> <li><a class="reference internal" href="../c-api/object.html#c.PyObject_HasAttrStringWithError" title="PyObject_HasAttrStringWithError"><code class="xref c c-func docutils literal notranslate">PyObject_HasAttrStringWithError()</code></a> replaces <a class="reference internal" href="../c-api/object.html#c.PyObject_HasAttrString" title="PyObject_HasAttrString"><code class="xref c c-func docutils literal notranslate">PyObject_HasAttrString()</code></a>.</li> <li><a class="reference internal" href="../c-api/mapping.html#c.PyMapping_HasKeyWithError" title="PyMapping_HasKeyWithError"><code class="xref c c-func docutils literal notranslate">PyMapping_HasKeyWithError()</code></a> replaces <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_HasKey" title="PyMapping_HasKey"><code class="xref c c-func docutils literal notranslate">PyMapping_HasKey()</code></a>.</li> <li><a class="reference internal" href="../c-api/mapping.html#c.PyMapping_HasKeyStringWithError" title="PyMapping_HasKeyStringWithError"><code class="xref c c-func docutils literal notranslate">PyMapping_HasKeyStringWithError()</code></a> replaces <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_HasKeyString" title="PyMapping_HasKeyString"><code class="xref c c-func docutils literal notranslate">PyMapping_HasKeyString()</code></a>.</li> </ul> The new functions return <code class="docutils literal notranslate">-1</code> for errors and the standard <code class="docutils literal notranslate">1</code> for true and <code class="docutils literal notranslate">0</code> for false. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/108511">gh-108511</a>.) </li> </ul> </section> <section id="changed-c-apis"> <h3>Changed C APIs<a class="headerlink" href="#changed-c-apis" title="Link to this heading">¶</a></h3> <ul> <li>The keywords parameter of <a class="reference internal" href="../c-api/arg.html#c.PyArg_ParseTupleAndKeywords" title="PyArg_ParseTupleAndKeywords"><code class="xref c c-func docutils literal notranslate">PyArg_ParseTupleAndKeywords()</code></a> and <a class="reference internal" href="../c-api/arg.html#c.PyArg_VaParseTupleAndKeywords" title="PyArg_VaParseTupleAndKeywords"><code class="xref c c-func docutils literal notranslate">PyArg_VaParseTupleAndKeywords()</code></a> now has type char *const* in C and const char *const* in C++, instead of char**. In C++, this makes these functions compatible with arguments of type const char *const*, const char**, or char *const* without an explicit type cast. In C, the functions only support arguments of type char *const*. This can be overridden with the <a class="reference internal" href="../c-api/arg.html#c.PY_CXX_CONST" title="PY_CXX_CONST"><code class="xref c c-macro docutils literal notranslate">PY_CXX_CONST</code></a> macro. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/65210">gh-65210</a>.)</li> <li><a class="reference internal" href="../c-api/arg.html#c.PyArg_ParseTupleAndKeywords" title="PyArg_ParseTupleAndKeywords"><code class="xref c c-func docutils literal notranslate">PyArg_ParseTupleAndKeywords()</code></a> now supports non-ASCII keyword parameter names. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/110815">gh-110815</a>.)</li> <li>The <code class="xref c c-func docutils literal notranslate">PyCode_GetFirstFree()</code> function is now unstable API and is now named <a class="reference internal" href="../c-api/code.html#c.PyUnstable_Code_GetFirstFree" title="PyUnstable_Code_GetFirstFree"><code class="xref c c-func docutils literal notranslate">PyUnstable_Code_GetFirstFree()</code></a>. (Contributed by Bogdan Romanyuk in <a class="reference external" href="https://github.com/python/cpython/issues/115781">gh-115781</a>.)</li> <li>The <a class="reference internal" href="../c-api/dict.html#c.PyDict_GetItem" title="PyDict_GetItem"><code class="xref c c-func docutils literal notranslate">PyDict_GetItem()</code></a>, <a class="reference internal" href="../c-api/dict.html#c.PyDict_GetItemString" title="PyDict_GetItemString"><code class="xref c c-func docutils literal notranslate">PyDict_GetItemString()</code></a>, <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_HasKey" title="PyMapping_HasKey"><code class="xref c c-func docutils literal notranslate">PyMapping_HasKey()</code></a>, <a class="reference internal" href="../c-api/mapping.html#c.PyMapping_HasKeyString" title="PyMapping_HasKeyString"><code class="xref c c-func docutils literal notranslate">PyMapping_HasKeyString()</code></a>, <a class="reference internal" href="../c-api/object.html#c.PyObject_HasAttr" title="PyObject_HasAttr"><code class="xref c c-func docutils literal notranslate">PyObject_HasAttr()</code></a>, <a class="reference internal" href="../c-api/object.html#c.PyObject_HasAttrString" title="PyObject_HasAttrString"><code class="xref c c-func docutils literal notranslate">PyObject_HasAttrString()</code></a>, and <a class="reference internal" href="../c-api/sys.html#c.PySys_GetObject" title="PySys_GetObject"><code class="xref c c-func docutils literal notranslate">PySys_GetObject()</code></a> functions, each of which clears all errors which occurred when calling them now reports these errors using <a class="reference internal" href="../library/sys.html#sys.unraisablehook" title="sys.unraisablehook"><code class="xref py py-func docutils literal notranslate">sys.unraisablehook()</code></a>. You may replace them with other functions as recommended in the documentation. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/106672">gh-106672</a>.)</li> <li>Add support for the <code class="docutils literal notranslate">%T</code>, <code class="docutils literal notranslate">%#T</code>, <code class="docutils literal notranslate">%N</code> and <code class="docutils literal notranslate">%#N</code> formats to <a class="reference internal" href="../c-api/unicode.html#c.PyUnicode_FromFormat" title="PyUnicode_FromFormat"><code class="xref c c-func docutils literal notranslate">PyUnicode_FromFormat()</code></a>: <ul class="simple"> <li><code class="docutils literal notranslate">%T</code>: Get the fully qualified name of an object type</li> <li><code class="docutils literal notranslate">%#T</code>: As above, but use a colon as the separator</li> <li><code class="docutils literal notranslate">%N</code>: Get the fully qualified name of a type</li> <li><code class="docutils literal notranslate">%#N</code>: As above, but use a colon as the separator</li> </ul> See <a class="pep reference external" href="https://peps.python.org/pep-0737/">PEP 737</a> for more information. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/111696">gh-111696</a>.) </li> <li>You no longer have to define the <code class="docutils literal notranslate">PY_SSIZE_T_CLEAN</code> macro before including <code class="file docutils literal notranslate">Python.h</code> when using <code class="docutils literal notranslate">#</code> formats in <a class="reference internal" href="../c-api/arg.html#arg-parsing-string-and-buffers">format codes</a>. APIs accepting the format codes always use <code class="docutils literal notranslate">Py_ssize_t</code> for <code class="docutils literal notranslate">#</code> formats. (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/104922">gh-104922</a>.)</li> <li>If Python is built in <a class="reference internal" href="../using/configure.html#debug-build">debug mode</a> or <a class="reference internal" href="../using/configure.html#cmdoption-with-assertions"><code class="xref std std-option docutils literal notranslate">with assertions</code></a>, <a class="reference internal" href="../c-api/tuple.html#c.PyTuple_SET_ITEM" title="PyTuple_SET_ITEM"><code class="xref c c-func docutils literal notranslate">PyTuple_SET_ITEM()</code></a> and <a class="reference internal" href="../c-api/list.html#c.PyList_SET_ITEM" title="PyList_SET_ITEM"><code class="xref c c-func docutils literal notranslate">PyList_SET_ITEM()</code></a> now check the index argument with an assertion. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106168">gh-106168</a>.)</li> </ul> </section> <section id="limited-c-api-changes"> <h3>Limited C API Changes<a class="headerlink" href="#limited-c-api-changes" title="Link to this heading">¶</a></h3> <ul> <li>The following functions are now included in the Limited C API: <ul class="simple"> <li><a class="reference internal" href="../c-api/memory.html#c.PyMem_RawMalloc" title="PyMem_RawMalloc"><code class="xref c c-func docutils literal notranslate">PyMem_RawMalloc()</code></a></li> <li><a class="reference internal" href="../c-api/memory.html#c.PyMem_RawCalloc" title="PyMem_RawCalloc"><code class="xref c c-func docutils literal notranslate">PyMem_RawCalloc()</code></a></li> <li><a class="reference internal" href="../c-api/memory.html#c.PyMem_RawRealloc" title="PyMem_RawRealloc"><code class="xref c c-func docutils literal notranslate">PyMem_RawRealloc()</code></a></li> <li><a class="reference internal" href="../c-api/memory.html#c.PyMem_RawFree" title="PyMem_RawFree"><code class="xref c c-func docutils literal notranslate">PyMem_RawFree()</code></a></li> <li><a class="reference internal" href="../c-api/sys.html#c.PySys_Audit" title="PySys_Audit"><code class="xref c c-func docutils literal notranslate">PySys_Audit()</code></a></li> <li><a class="reference internal" href="../c-api/sys.html#c.PySys_AuditTuple" title="PySys_AuditTuple"><code class="xref c c-func docutils literal notranslate">PySys_AuditTuple()</code></a></li> <li><a class="reference internal" href="../c-api/type.html#c.PyType_GetModuleByDef" title="PyType_GetModuleByDef"><code class="xref c c-func docutils literal notranslate">PyType_GetModuleByDef()</code></a></li> </ul> (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/85283">gh-85283</a>, <a class="reference external" href="https://github.com/python/cpython/issues/85283">gh-85283</a>, and <a class="reference external" href="https://github.com/python/cpython/issues/116936">gh-116936</a>.) </li> <li>Python built with <a class="reference internal" href="../using/configure.html#cmdoption-with-trace-refs"><code class="xref std std-option docutils literal notranslate">--with-trace-refs</code></a> (tracing references) now supports the <a class="reference internal" href="../c-api/stable.html#limited-c-api">Limited API</a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108634">gh-108634</a>.)</li> </ul> </section> <section id="removed-c-apis"> <h3>Removed C APIs<a class="headerlink" href="#removed-c-apis" title="Link to this heading">¶</a></h3> <ul> <li>Remove several functions, macros, variables, etc with names prefixed by <code class="docutils literal notranslate">_Py</code> or <code class="docutils literal notranslate">_PY</code> (which are considered private). If your project is affected by one of these removals and you believe that the removed API should remain available, please <a class="reference internal" href="../bugs.html#using-the-tracker">open a new issue</a> to request a public C API and add <code class="docutils literal notranslate">cc: @vstinner</code> to the issue to notify Victor Stinner. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106320">gh-106320</a>.)</li> <li>Remove old buffer protocols deprecated in Python 3.0. Use <a class="reference internal" href="../c-api/buffer.html#bufferobjects">Buffer Protocol</a> instead. <ul> <li><code class="xref c c-func docutils literal notranslate">PyObject_CheckReadBuffer()</code>: Use <a class="reference internal" href="../c-api/buffer.html#c.PyObject_CheckBuffer" title="PyObject_CheckBuffer"><code class="xref c c-func docutils literal notranslate">PyObject_CheckBuffer()</code></a> to test whether the object supports the buffer protocol. Note that <a class="reference internal" href="../c-api/buffer.html#c.PyObject_CheckBuffer" title="PyObject_CheckBuffer"><code class="xref c c-func docutils literal notranslate">PyObject_CheckBuffer()</code></a> doesn’t guarantee that <a class="reference internal" href="../c-api/buffer.html#c.PyObject_GetBuffer" title="PyObject_GetBuffer"><code class="xref c c-func docutils literal notranslate">PyObject_GetBuffer()</code></a> will succeed. To test if the object is actually readable, see the next example of <a class="reference internal" href="../c-api/buffer.html#c.PyObject_GetBuffer" title="PyObject_GetBuffer"><code class="xref c c-func docutils literal notranslate">PyObject_GetBuffer()</code></a>.</li> <li><code class="xref c c-func docutils literal notranslate">PyObject_AsCharBuffer()</code>, <code class="xref c c-func docutils literal notranslate">PyObject_AsReadBuffer()</code>: Use <a class="reference internal" href="../c-api/buffer.html#c.PyObject_GetBuffer" title="PyObject_GetBuffer"><code class="xref c c-func docutils literal notranslate">PyObject_GetBuffer()</code></a> and <a class="reference internal" href="../c-api/buffer.html#c.PyBuffer_Release" title="PyBuffer_Release"><code class="xref c c-func docutils literal notranslate">PyBuffer_Release()</code></a> instead: <div class="highlight-c notranslate"><div class="highlight"><pre>Py_buffer view; if (PyObject_GetBuffer(obj, &view, PyBUF_SIMPLE) < 0) { return NULL; } // Use `view.buf` and `view.len` to read from the buffer. // You may need to cast buf as `(const char*)view.buf`. PyBuffer_Release(&view); </pre></div> </div> </li> <li><code class="xref c c-func docutils literal notranslate">PyObject_AsWriteBuffer()</code>: Use <a class="reference internal" href="../c-api/buffer.html#c.PyObject_GetBuffer" title="PyObject_GetBuffer"><code class="xref c c-func docutils literal notranslate">PyObject_GetBuffer()</code></a> and <a class="reference internal" href="../c-api/buffer.html#c.PyBuffer_Release" title="PyBuffer_Release"><code class="xref c c-func docutils literal notranslate">PyBuffer_Release()</code></a> instead: <div class="highlight-c notranslate"><div class="highlight"><pre>Py_buffer view; if (PyObject_GetBuffer(obj, &view, PyBUF_WRITABLE) < 0) { return NULL; } // Use `view.buf` and `view.len` to write to the buffer. PyBuffer_Release(&view); </pre></div> </div> </li> </ul> (Contributed by Inada Naoki in <a class="reference external" href="https://github.com/python/cpython/issues/85275">gh-85275</a>.) </li> <li>Remove various functions deprecated in Python 3.9: <ul> <li><code class="xref c c-func docutils literal notranslate">PyEval_CallObject()</code>, <code class="xref c c-func docutils literal notranslate">PyEval_CallObjectWithKeywords()</code>: Use <a class="reference internal" href="../c-api/call.html#c.PyObject_CallNoArgs" title="PyObject_CallNoArgs"><code class="xref c c-func docutils literal notranslate">PyObject_CallNoArgs()</code></a> or <a class="reference internal" href="../c-api/call.html#c.PyObject_Call" title="PyObject_Call"><code class="xref c c-func docutils literal notranslate">PyObject_Call()</code></a> instead. <div class="admonition warning"> Warning In <a class="reference internal" href="../c-api/call.html#c.PyObject_Call" title="PyObject_Call"><code class="xref c c-func docutils literal notranslate">PyObject_Call()</code></a>, positional arguments must be a <a class="reference internal" href="../library/stdtypes.html#tuple" title="tuple"><code class="xref py py-class docutils literal notranslate">tuple</code></a> and must not be <code class="docutils literal notranslate">NULL</code>, and keyword arguments must be a <a class="reference internal" href="../library/stdtypes.html#dict" title="dict"><code class="xref py py-class docutils literal notranslate">dict</code></a> or <code class="docutils literal notranslate">NULL</code>, whereas the removed functions checked argument types and accepted <code class="docutils literal notranslate">NULL</code> positional and keyword arguments. To replace <code class="docutils literal notranslate">PyEval_CallObjectWithKeywords(func, NULL, kwargs)</code> with <a class="reference internal" href="../c-api/call.html#c.PyObject_Call" title="PyObject_Call"><code class="xref c c-func docutils literal notranslate">PyObject_Call()</code></a>, pass an empty tuple as positional arguments using <a class="reference internal" href="../c-api/tuple.html#c.PyTuple_New" title="PyTuple_New"><code class="xref c c-func docutils literal notranslate">PyTuple_New(0)</code></a>. </div> </li> <li><code class="xref c c-func docutils literal notranslate">PyEval_CallFunction()</code>: Use <a class="reference internal" href="../c-api/call.html#c.PyObject_CallFunction" title="PyObject_CallFunction"><code class="xref c c-func docutils literal notranslate">PyObject_CallFunction()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PyEval_CallMethod()</code>: Use <a class="reference internal" href="../c-api/call.html#c.PyObject_CallMethod" title="PyObject_CallMethod"><code class="xref c c-func docutils literal notranslate">PyObject_CallMethod()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PyCFunction_Call()</code>: Use <a class="reference internal" href="../c-api/call.html#c.PyObject_Call" title="PyObject_Call"><code class="xref c c-func docutils literal notranslate">PyObject_Call()</code></a> instead.</li> </ul> (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105107">gh-105107</a>.) </li> <li>Remove the following old functions to configure the Python initialization, deprecated in Python 3.11: <ul class="simple"> <li><code class="xref c c-func docutils literal notranslate">PySys_AddWarnOptionUnicode()</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.warnoptions" title="PyConfig.warnoptions"><code class="xref c c-member docutils literal notranslate">PyConfig.warnoptions</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PySys_AddWarnOption()</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.warnoptions" title="PyConfig.warnoptions"><code class="xref c c-member docutils literal notranslate">PyConfig.warnoptions</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PySys_AddXOption()</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.xoptions" title="PyConfig.xoptions"><code class="xref c c-member docutils literal notranslate">PyConfig.xoptions</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PySys_HasWarnOptions()</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.xoptions" title="PyConfig.xoptions"><code class="xref c c-member docutils literal notranslate">PyConfig.xoptions</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PySys_SetPath()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.module_search_paths" title="PyConfig.module_search_paths"><code class="xref c c-member docutils literal notranslate">PyConfig.module_search_paths</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">Py_SetPath()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.module_search_paths" title="PyConfig.module_search_paths"><code class="xref c c-member docutils literal notranslate">PyConfig.module_search_paths</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">Py_SetStandardStreamEncoding()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.stdio_encoding" title="PyConfig.stdio_encoding"><code class="xref c c-member docutils literal notranslate">PyConfig.stdio_encoding</code></a> instead, and set also maybe <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.legacy_windows_stdio" title="PyConfig.legacy_windows_stdio"><code class="xref c c-member docutils literal notranslate">PyConfig.legacy_windows_stdio</code></a> (on Windows).</li> <li><code class="xref c c-func docutils literal notranslate">_Py_SetProgramFullPath()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.executable" title="PyConfig.executable"><code class="xref c c-member docutils literal notranslate">PyConfig.executable</code></a> instead.</li> </ul> Use the new <a class="reference internal" href="../c-api/init_config.html#c.PyConfig" title="PyConfig"><code class="xref c c-type docutils literal notranslate">PyConfig</code></a> API of the <a class="reference internal" href="../c-api/init_config.html#init-config">Python Initialization Configuration</a> instead (<a class="pep reference external" href="https://peps.python.org/pep-0587/">PEP 587</a>), added to Python 3.8. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105145">gh-105145</a>.) </li> <li>Remove <code class="xref c c-func docutils literal notranslate">PyEval_AcquireLock()</code> and <code class="xref c c-func docutils literal notranslate">PyEval_ReleaseLock()</code> functions, deprecated in Python 3.2. They didn’t update the current thread state. They can be replaced with: <ul class="simple"> <li><a class="reference internal" href="../c-api/init.html#c.PyEval_SaveThread" title="PyEval_SaveThread"><code class="xref c c-func docutils literal notranslate">PyEval_SaveThread()</code></a> and <a class="reference internal" href="../c-api/init.html#c.PyEval_RestoreThread" title="PyEval_RestoreThread"><code class="xref c c-func docutils literal notranslate">PyEval_RestoreThread()</code></a>;</li> <li>low-level <a class="reference internal" href="../c-api/init.html#c.PyEval_AcquireThread" title="PyEval_AcquireThread"><code class="xref c c-func docutils literal notranslate">PyEval_AcquireThread()</code></a> and <a class="reference internal" href="../c-api/init.html#c.PyEval_RestoreThread" title="PyEval_RestoreThread"><code class="xref c c-func docutils literal notranslate">PyEval_RestoreThread()</code></a>;</li> <li>or <a class="reference internal" href="../c-api/init.html#c.PyGILState_Ensure" title="PyGILState_Ensure"><code class="xref c c-func docutils literal notranslate">PyGILState_Ensure()</code></a> and <a class="reference internal" href="../c-api/init.html#c.PyGILState_Release" title="PyGILState_Release"><code class="xref c c-func docutils literal notranslate">PyGILState_Release()</code></a>.</li> </ul> (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105182">gh-105182</a>.) </li> <li>Remove the <code class="xref c c-func docutils literal notranslate">PyEval_ThreadsInitialized()</code> function, deprecated in Python 3.9. Since Python 3.7, <code class="xref c c-func docutils literal notranslate">Py_Initialize()</code> always creates the GIL: calling <code class="xref c c-func docutils literal notranslate">PyEval_InitThreads()</code> does nothing and <code class="xref c c-func docutils literal notranslate">PyEval_ThreadsInitialized()</code> always returns non-zero. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105182">gh-105182</a>.)</li> <li>Remove the <code class="xref c c-func docutils literal notranslate">_PyInterpreterState_Get()</code> alias to <a class="reference internal" href="../c-api/init.html#c.PyInterpreterState_Get" title="PyInterpreterState_Get"><code class="xref c c-func docutils literal notranslate">PyInterpreterState_Get()</code></a> which was kept for backward compatibility with Python 3.8. The <a class="reference external" href="https://github.com/python/pythoncapi-compat/">pythoncapi-compat project</a> can be used to get <a class="reference internal" href="../c-api/init.html#c.PyInterpreterState_Get" title="PyInterpreterState_Get"><code class="xref c c-func docutils literal notranslate">PyInterpreterState_Get()</code></a> on Python 3.8 and older. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106320">gh-106320</a>.)</li> <li>Remove the private <code class="xref c c-func docutils literal notranslate">_PyObject_FastCall()</code> function: use <code class="xref c c-func docutils literal notranslate">PyObject_Vectorcall()</code> which is available since Python 3.8 (<a class="pep reference external" href="https://peps.python.org/pep-0590/">PEP 590</a>). (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106023">gh-106023</a>.)</li> <li>Remove the <code class="docutils literal notranslate">cpython/pytime.h</code> header file, which only contained private functions. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/106316">gh-106316</a>.)</li> <li>Remove the undocumented <code class="docutils literal notranslate">PY_TIMEOUT_MAX</code> constant from the limited C API. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/110014">gh-110014</a>.)</li> <li>Remove the old trashcan macros <code class="docutils literal notranslate">Py_TRASHCAN_SAFE_BEGIN</code> and <code class="docutils literal notranslate">Py_TRASHCAN_SAFE_END</code>. Replace both with the new macros <code class="docutils literal notranslate">Py_TRASHCAN_BEGIN</code> and <code class="docutils literal notranslate">Py_TRASHCAN_END</code>. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/105111">gh-105111</a>.)</li> </ul> </section> <section id="deprecated-c-apis"> <h3>Deprecated C APIs<a class="headerlink" href="#deprecated-c-apis" title="Link to this heading">¶</a></h3> <ul> <li>Deprecate old Python initialization functions: <ul class="simple"> <li><a class="reference internal" href="../c-api/sys.html#c.PySys_ResetWarnOptions" title="PySys_ResetWarnOptions"><code class="xref c c-func docutils literal notranslate">PySys_ResetWarnOptions()</code></a>: Clear <a class="reference internal" href="../library/sys.html#sys.warnoptions" title="sys.warnoptions"><code class="xref py py-data docutils literal notranslate">sys.warnoptions</code></a> and <code class="xref py py-data docutils literal notranslate">warnings.filters</code> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetExecPrefix" title="Py_GetExecPrefix"><code class="xref c c-func docutils literal notranslate">Py_GetExecPrefix()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.exec_prefix" title="sys.exec_prefix"><code class="xref py py-data docutils literal notranslate">sys.exec_prefix</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetPath" title="Py_GetPath"><code class="xref c c-func docutils literal notranslate">Py_GetPath()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.path" title="sys.path"><code class="xref py py-data docutils literal notranslate">sys.path</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetPrefix" title="Py_GetPrefix"><code class="xref c c-func docutils literal notranslate">Py_GetPrefix()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.prefix" title="sys.prefix"><code class="xref py py-data docutils literal notranslate">sys.prefix</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetProgramFullPath" title="Py_GetProgramFullPath"><code class="xref c c-func docutils literal notranslate">Py_GetProgramFullPath()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.executable" title="sys.executable"><code class="xref py py-data docutils literal notranslate">sys.executable</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetProgramName" title="Py_GetProgramName"><code class="xref c c-func docutils literal notranslate">Py_GetProgramName()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.executable" title="sys.executable"><code class="xref py py-data docutils literal notranslate">sys.executable</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetPythonHome" title="Py_GetPythonHome"><code class="xref c c-func docutils literal notranslate">Py_GetPythonHome()</code></a>: Get <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.home" title="PyConfig.home"><code class="xref c c-member docutils literal notranslate">PyConfig.home</code></a> or the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHONHOME"><code class="xref std std-envvar docutils literal notranslate">PYTHONHOME</code></a> environment variable instead.</li> </ul> (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105145">gh-105145</a>.) </li> <li><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecate</a> the <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetBuiltins" title="PyEval_GetBuiltins"><code class="xref c c-func docutils literal notranslate">PyEval_GetBuiltins()</code></a>, <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetGlobals" title="PyEval_GetGlobals"><code class="xref c c-func docutils literal notranslate">PyEval_GetGlobals()</code></a>, and <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetLocals" title="PyEval_GetLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetLocals()</code></a> functions, which return a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a>. (Soft deprecated as part of <a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a>.)</li> <li>Deprecate the <a class="reference internal" href="../c-api/import.html#c.PyImport_ImportModuleNoBlock" title="PyImport_ImportModuleNoBlock"><code class="xref c c-func docutils literal notranslate">PyImport_ImportModuleNoBlock()</code></a> function, which is just an alias to <a class="reference internal" href="../c-api/import.html#c.PyImport_ImportModule" title="PyImport_ImportModule"><code class="xref c c-func docutils literal notranslate">PyImport_ImportModule()</code></a> since Python 3.3. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105396">gh-105396</a>.)</li> <li><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecate</a> the <a class="reference internal" href="../c-api/module.html#c.PyModule_AddObject" title="PyModule_AddObject"><code class="xref c c-func docutils literal notranslate">PyModule_AddObject()</code></a> function. It should be replaced with <a class="reference internal" href="../c-api/module.html#c.PyModule_Add" title="PyModule_Add"><code class="xref c c-func docutils literal notranslate">PyModule_Add()</code></a> or <a class="reference internal" href="../c-api/module.html#c.PyModule_AddObjectRef" title="PyModule_AddObjectRef"><code class="xref c c-func docutils literal notranslate">PyModule_AddObjectRef()</code></a>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/86493">gh-86493</a>.)</li> <li>Deprecate the old <code class="docutils literal notranslate">Py_UNICODE</code> and <code class="docutils literal notranslate">PY_UNICODE_TYPE</code> types and the <code class="xref c c-macro docutils literal notranslate">Py_UNICODE_WIDE</code> define. Use the <code class="xref c c-type docutils literal notranslate">wchar_t</code> type directly instead. Since Python 3.3, <code class="docutils literal notranslate">Py_UNICODE</code> and <code class="docutils literal notranslate">PY_UNICODE_TYPE</code> are just aliases to <code class="xref c c-type docutils literal notranslate">wchar_t</code>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105156">gh-105156</a>.)</li> <li>Deprecate the <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetObject" title="PyWeakref_GetObject"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetObject()</code></a> and <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GET_OBJECT" title="PyWeakref_GET_OBJECT"><code class="xref c c-func docutils literal notranslate">PyWeakref_GET_OBJECT()</code></a> functions, which return a <a class="reference internal" href="../glossary.html#term-borrowed-reference">borrowed reference</a>. Replace them with the new <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetRef" title="PyWeakref_GetRef"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetRef()</code></a> function, which returns a <a class="reference internal" href="../glossary.html#term-strong-reference">strong reference</a>. The <a class="reference external" href="https://github.com/python/pythoncapi-compat/">pythoncapi-compat project</a> can be used to get <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetRef" title="PyWeakref_GetRef"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetRef()</code></a> on Python 3.12 and older. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/105927">gh-105927</a>.)</li> </ul> <section id="id8"> <h4>Pending Removal in Python 3.14<a class="headerlink" href="#id8" title="Link to this heading">¶</a></h4> <ul> <li>The <code class="docutils literal notranslate">ma_version_tag</code> field in <a class="reference internal" href="../c-api/dict.html#c.PyDictObject" title="PyDictObject"><code class="xref c c-type docutils literal notranslate">PyDictObject</code></a> for extension modules (<a class="pep reference external" href="https://peps.python.org/pep-0699/">PEP 699</a>; <a class="reference external" href="https://github.com/python/cpython/issues/101193">gh-101193</a>).</li> <li>Creating <a class="reference internal" href="../c-api/typeobj.html#c.Py_TPFLAGS_IMMUTABLETYPE" title="Py_TPFLAGS_IMMUTABLETYPE"><code class="xref c c-data docutils literal notranslate">immutable types</code></a> with mutable bases (<a class="reference external" href="https://github.com/python/cpython/issues/95388">gh-95388</a>).</li> <li>Functions to configure Python’s initialization, deprecated in Python 3.11: <ul class="simple"> <li><code class="xref c c-func docutils literal notranslate">PySys_SetArgvEx()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.argv" title="PyConfig.argv"><code class="xref c c-member docutils literal notranslate">PyConfig.argv</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PySys_SetArgv()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.argv" title="PyConfig.argv"><code class="xref c c-member docutils literal notranslate">PyConfig.argv</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">Py_SetProgramName()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.program_name" title="PyConfig.program_name"><code class="xref c c-member docutils literal notranslate">PyConfig.program_name</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">Py_SetPythonHome()</code>: Set <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.home" title="PyConfig.home"><code class="xref c c-member docutils literal notranslate">PyConfig.home</code></a> instead.</li> </ul> The <a class="reference internal" href="../c-api/init.html#c.Py_InitializeFromConfig" title="Py_InitializeFromConfig"><code class="xref c c-func docutils literal notranslate">Py_InitializeFromConfig()</code></a> API should be used with <a class="reference internal" href="../c-api/init_config.html#c.PyConfig" title="PyConfig"><code class="xref c c-type docutils literal notranslate">PyConfig</code></a> instead. </li> <li>Global configuration variables: <ul class="simple"> <li><a class="reference internal" href="../c-api/init.html#c.Py_DebugFlag" title="Py_DebugFlag"><code class="xref c c-var docutils literal notranslate">Py_DebugFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.parser_debug" title="PyConfig.parser_debug"><code class="xref c c-member docutils literal notranslate">PyConfig.parser_debug</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_VerboseFlag" title="Py_VerboseFlag"><code class="xref c c-var docutils literal notranslate">Py_VerboseFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.verbose" title="PyConfig.verbose"><code class="xref c c-member docutils literal notranslate">PyConfig.verbose</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_QuietFlag" title="Py_QuietFlag"><code class="xref c c-var docutils literal notranslate">Py_QuietFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.quiet" title="PyConfig.quiet"><code class="xref c c-member docutils literal notranslate">PyConfig.quiet</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_InteractiveFlag" title="Py_InteractiveFlag"><code class="xref c c-var docutils literal notranslate">Py_InteractiveFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.interactive" title="PyConfig.interactive"><code class="xref c c-member docutils literal notranslate">PyConfig.interactive</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_InspectFlag" title="Py_InspectFlag"><code class="xref c c-var docutils literal notranslate">Py_InspectFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.inspect" title="PyConfig.inspect"><code class="xref c c-member docutils literal notranslate">PyConfig.inspect</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_OptimizeFlag" title="Py_OptimizeFlag"><code class="xref c c-var docutils literal notranslate">Py_OptimizeFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.optimization_level" title="PyConfig.optimization_level"><code class="xref c c-member docutils literal notranslate">PyConfig.optimization_level</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_NoSiteFlag" title="Py_NoSiteFlag"><code class="xref c c-var docutils literal notranslate">Py_NoSiteFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.site_import" title="PyConfig.site_import"><code class="xref c c-member docutils literal notranslate">PyConfig.site_import</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_BytesWarningFlag" title="Py_BytesWarningFlag"><code class="xref c c-var docutils literal notranslate">Py_BytesWarningFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.bytes_warning" title="PyConfig.bytes_warning"><code class="xref c c-member docutils literal notranslate">PyConfig.bytes_warning</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_FrozenFlag" title="Py_FrozenFlag"><code class="xref c c-var docutils literal notranslate">Py_FrozenFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.pathconfig_warnings" title="PyConfig.pathconfig_warnings"><code class="xref c c-member docutils literal notranslate">PyConfig.pathconfig_warnings</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_IgnoreEnvironmentFlag" title="Py_IgnoreEnvironmentFlag"><code class="xref c c-var docutils literal notranslate">Py_IgnoreEnvironmentFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.use_environment" title="PyConfig.use_environment"><code class="xref c c-member docutils literal notranslate">PyConfig.use_environment</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_DontWriteBytecodeFlag" title="Py_DontWriteBytecodeFlag"><code class="xref c c-var docutils literal notranslate">Py_DontWriteBytecodeFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.write_bytecode" title="PyConfig.write_bytecode"><code class="xref c c-member docutils literal notranslate">PyConfig.write_bytecode</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_NoUserSiteDirectory" title="Py_NoUserSiteDirectory"><code class="xref c c-var docutils literal notranslate">Py_NoUserSiteDirectory</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.user_site_directory" title="PyConfig.user_site_directory"><code class="xref c c-member docutils literal notranslate">PyConfig.user_site_directory</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_UnbufferedStdioFlag" title="Py_UnbufferedStdioFlag"><code class="xref c c-var docutils literal notranslate">Py_UnbufferedStdioFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.buffered_stdio" title="PyConfig.buffered_stdio"><code class="xref c c-member docutils literal notranslate">PyConfig.buffered_stdio</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_HashRandomizationFlag" title="Py_HashRandomizationFlag"><code class="xref c c-var docutils literal notranslate">Py_HashRandomizationFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.use_hash_seed" title="PyConfig.use_hash_seed"><code class="xref c c-member docutils literal notranslate">PyConfig.use_hash_seed</code></a> and <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.hash_seed" title="PyConfig.hash_seed"><code class="xref c c-member docutils literal notranslate">PyConfig.hash_seed</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_IsolatedFlag" title="Py_IsolatedFlag"><code class="xref c c-var docutils literal notranslate">Py_IsolatedFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.isolated" title="PyConfig.isolated"><code class="xref c c-member docutils literal notranslate">PyConfig.isolated</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_LegacyWindowsFSEncodingFlag" title="Py_LegacyWindowsFSEncodingFlag"><code class="xref c c-var docutils literal notranslate">Py_LegacyWindowsFSEncodingFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyPreConfig.legacy_windows_fs_encoding" title="PyPreConfig.legacy_windows_fs_encoding"><code class="xref c c-member docutils literal notranslate">PyPreConfig.legacy_windows_fs_encoding</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_LegacyWindowsStdioFlag" title="Py_LegacyWindowsStdioFlag"><code class="xref c c-var docutils literal notranslate">Py_LegacyWindowsStdioFlag</code></a>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.legacy_windows_stdio" title="PyConfig.legacy_windows_stdio"><code class="xref c c-member docutils literal notranslate">PyConfig.legacy_windows_stdio</code></a> instead.</li> <li><code class="xref c c-var docutils literal notranslate">Py_FileSystemDefaultEncoding</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.filesystem_encoding" title="PyConfig.filesystem_encoding"><code class="xref c c-member docutils literal notranslate">PyConfig.filesystem_encoding</code></a> instead.</li> <li><code class="xref c c-var docutils literal notranslate">Py_HasFileSystemDefaultEncoding</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.filesystem_encoding" title="PyConfig.filesystem_encoding"><code class="xref c c-member docutils literal notranslate">PyConfig.filesystem_encoding</code></a> instead.</li> <li><code class="xref c c-var docutils literal notranslate">Py_FileSystemDefaultEncodeErrors</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.filesystem_errors" title="PyConfig.filesystem_errors"><code class="xref c c-member docutils literal notranslate">PyConfig.filesystem_errors</code></a> instead.</li> <li><code class="xref c c-var docutils literal notranslate">Py_UTF8Mode</code>: Use <a class="reference internal" href="../c-api/init_config.html#c.PyPreConfig.utf8_mode" title="PyPreConfig.utf8_mode"><code class="xref c c-member docutils literal notranslate">PyPreConfig.utf8_mode</code></a> instead. (see <a class="reference internal" href="../c-api/init_config.html#c.Py_PreInitialize" title="Py_PreInitialize"><code class="xref c c-func docutils literal notranslate">Py_PreInitialize()</code></a>)</li> </ul> The <a class="reference internal" href="../c-api/init.html#c.Py_InitializeFromConfig" title="Py_InitializeFromConfig"><code class="xref c c-func docutils literal notranslate">Py_InitializeFromConfig()</code></a> API should be used with <a class="reference internal" href="../c-api/init_config.html#c.PyConfig" title="PyConfig"><code class="xref c c-type docutils literal notranslate">PyConfig</code></a> instead. </li> </ul> </section> <section id="id9"> <h4>Pending Removal in Python 3.15<a class="headerlink" href="#id9" title="Link to this heading">¶</a></h4> <ul class="simple"> <li>The bundled copy of <code class="docutils literal notranslate">libmpdecimal</code>.</li> <li>The <a class="reference internal" href="../c-api/import.html#c.PyImport_ImportModuleNoBlock" title="PyImport_ImportModuleNoBlock"><code class="xref c c-func docutils literal notranslate">PyImport_ImportModuleNoBlock()</code></a>: Use <a class="reference internal" href="../c-api/import.html#c.PyImport_ImportModule" title="PyImport_ImportModule"><code class="xref c c-func docutils literal notranslate">PyImport_ImportModule()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetObject" title="PyWeakref_GetObject"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetObject()</code></a> and <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GET_OBJECT" title="PyWeakref_GET_OBJECT"><code class="xref c c-func docutils literal notranslate">PyWeakref_GET_OBJECT()</code></a>: Use <a class="reference internal" href="../c-api/weakref.html#c.PyWeakref_GetRef" title="PyWeakref_GetRef"><code class="xref c c-func docutils literal notranslate">PyWeakref_GetRef()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/unicode.html#c.Py_UNICODE" title="Py_UNICODE"><code class="xref c c-type docutils literal notranslate">Py_UNICODE</code></a> type and the <code class="xref c c-macro docutils literal notranslate">Py_UNICODE_WIDE</code> macro: Use <code class="xref c c-type docutils literal notranslate">wchar_t</code> instead.</li> <li>Python initialization functions: <ul> <li><a class="reference internal" href="../c-api/sys.html#c.PySys_ResetWarnOptions" title="PySys_ResetWarnOptions"><code class="xref c c-func docutils literal notranslate">PySys_ResetWarnOptions()</code></a>: Clear <a class="reference internal" href="../library/sys.html#sys.warnoptions" title="sys.warnoptions"><code class="xref py py-data docutils literal notranslate">sys.warnoptions</code></a> and <code class="xref py py-data docutils literal notranslate">warnings.filters</code> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetExecPrefix" title="Py_GetExecPrefix"><code class="xref c c-func docutils literal notranslate">Py_GetExecPrefix()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.base_exec_prefix" title="sys.base_exec_prefix"><code class="xref py py-data docutils literal notranslate">sys.base_exec_prefix</code></a> and <a class="reference internal" href="../library/sys.html#sys.exec_prefix" title="sys.exec_prefix"><code class="xref py py-data docutils literal notranslate">sys.exec_prefix</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetPath" title="Py_GetPath"><code class="xref c c-func docutils literal notranslate">Py_GetPath()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.path" title="sys.path"><code class="xref py py-data docutils literal notranslate">sys.path</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetPrefix" title="Py_GetPrefix"><code class="xref c c-func docutils literal notranslate">Py_GetPrefix()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.base_prefix" title="sys.base_prefix"><code class="xref py py-data docutils literal notranslate">sys.base_prefix</code></a> and <a class="reference internal" href="../library/sys.html#sys.prefix" title="sys.prefix"><code class="xref py py-data docutils literal notranslate">sys.prefix</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetProgramFullPath" title="Py_GetProgramFullPath"><code class="xref c c-func docutils literal notranslate">Py_GetProgramFullPath()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.executable" title="sys.executable"><code class="xref py py-data docutils literal notranslate">sys.executable</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetProgramName" title="Py_GetProgramName"><code class="xref c c-func docutils literal notranslate">Py_GetProgramName()</code></a>: Get <a class="reference internal" href="../library/sys.html#sys.executable" title="sys.executable"><code class="xref py py-data docutils literal notranslate">sys.executable</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.Py_GetPythonHome" title="Py_GetPythonHome"><code class="xref c c-func docutils literal notranslate">Py_GetPythonHome()</code></a>: Get <a class="reference internal" href="../c-api/init_config.html#c.PyConfig.home" title="PyConfig.home"><code class="xref c c-member docutils literal notranslate">PyConfig.home</code></a> or the <a class="reference internal" href="../using/cmdline.html#envvar-PYTHONHOME"><code class="xref std std-envvar docutils literal notranslate">PYTHONHOME</code></a> environment variable instead.</li> </ul> </li> </ul> </section> <section id="id10"> <h4>Pending Removal in Future Versions<a class="headerlink" href="#id10" title="Link to this heading">¶</a></h4> The following APIs are deprecated and will be removed, although there is currently no date scheduled for their removal. <ul class="simple"> <li><a class="reference internal" href="../c-api/typeobj.html#c.Py_TPFLAGS_HAVE_FINALIZE" title="Py_TPFLAGS_HAVE_FINALIZE"><code class="xref c c-macro docutils literal notranslate">Py_TPFLAGS_HAVE_FINALIZE</code></a>: Unneeded since Python 3.8.</li> <li><a class="reference internal" href="../c-api/exceptions.html#c.PyErr_Fetch" title="PyErr_Fetch"><code class="xref c c-func docutils literal notranslate">PyErr_Fetch()</code></a>: Use <a class="reference internal" href="../c-api/exceptions.html#c.PyErr_GetRaisedException" title="PyErr_GetRaisedException"><code class="xref c c-func docutils literal notranslate">PyErr_GetRaisedException()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/exceptions.html#c.PyErr_NormalizeException" title="PyErr_NormalizeException"><code class="xref c c-func docutils literal notranslate">PyErr_NormalizeException()</code></a>: Use <a class="reference internal" href="../c-api/exceptions.html#c.PyErr_GetRaisedException" title="PyErr_GetRaisedException"><code class="xref c c-func docutils literal notranslate">PyErr_GetRaisedException()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/exceptions.html#c.PyErr_Restore" title="PyErr_Restore"><code class="xref c c-func docutils literal notranslate">PyErr_Restore()</code></a>: Use <a class="reference internal" href="../c-api/exceptions.html#c.PyErr_SetRaisedException" title="PyErr_SetRaisedException"><code class="xref c c-func docutils literal notranslate">PyErr_SetRaisedException()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/module.html#c.PyModule_GetFilename" title="PyModule_GetFilename"><code class="xref c c-func docutils literal notranslate">PyModule_GetFilename()</code></a>: Use <a class="reference internal" href="../c-api/module.html#c.PyModule_GetFilenameObject" title="PyModule_GetFilenameObject"><code class="xref c c-func docutils literal notranslate">PyModule_GetFilenameObject()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/sys.html#c.PyOS_AfterFork" title="PyOS_AfterFork"><code class="xref c c-func docutils literal notranslate">PyOS_AfterFork()</code></a>: Use <a class="reference internal" href="../c-api/sys.html#c.PyOS_AfterFork_Child" title="PyOS_AfterFork_Child"><code class="xref c c-func docutils literal notranslate">PyOS_AfterFork_Child()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/slice.html#c.PySlice_GetIndicesEx" title="PySlice_GetIndicesEx"><code class="xref c c-func docutils literal notranslate">PySlice_GetIndicesEx()</code></a>: Use <a class="reference internal" href="../c-api/slice.html#c.PySlice_Unpack" title="PySlice_Unpack"><code class="xref c c-func docutils literal notranslate">PySlice_Unpack()</code></a> and <a class="reference internal" href="../c-api/slice.html#c.PySlice_AdjustIndices" title="PySlice_AdjustIndices"><code class="xref c c-func docutils literal notranslate">PySlice_AdjustIndices()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PyUnicode_AsDecodedObject()</code>: Use <a class="reference internal" href="../c-api/codec.html#c.PyCodec_Decode" title="PyCodec_Decode"><code class="xref c c-func docutils literal notranslate">PyCodec_Decode()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PyUnicode_AsDecodedUnicode()</code>: Use <a class="reference internal" href="../c-api/codec.html#c.PyCodec_Decode" title="PyCodec_Decode"><code class="xref c c-func docutils literal notranslate">PyCodec_Decode()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PyUnicode_AsEncodedObject()</code>: Use <a class="reference internal" href="../c-api/codec.html#c.PyCodec_Encode" title="PyCodec_Encode"><code class="xref c c-func docutils literal notranslate">PyCodec_Encode()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">PyUnicode_AsEncodedUnicode()</code>: Use <a class="reference internal" href="../c-api/codec.html#c.PyCodec_Encode" title="PyCodec_Encode"><code class="xref c c-func docutils literal notranslate">PyCodec_Encode()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/unicode.html#c.PyUnicode_READY" title="PyUnicode_READY"><code class="xref c c-func docutils literal notranslate">PyUnicode_READY()</code></a>: Unneeded since Python 3.12</li> <li><code class="xref c c-func docutils literal notranslate">PyErr_Display()</code>: Use <a class="reference internal" href="../c-api/exceptions.html#c.PyErr_DisplayException" title="PyErr_DisplayException"><code class="xref c c-func docutils literal notranslate">PyErr_DisplayException()</code></a> instead.</li> <li><code class="xref c c-func docutils literal notranslate">_PyErr_ChainExceptions()</code>: Use <code class="xref c c-func docutils literal notranslate">_PyErr_ChainExceptions1()</code> instead.</li> <li><code class="xref c c-member docutils literal notranslate">PyBytesObject.ob_shash</code> member: call <a class="reference internal" href="../c-api/object.html#c.PyObject_Hash" title="PyObject_Hash"><code class="xref c c-func docutils literal notranslate">PyObject_Hash()</code></a> instead.</li> <li><code class="xref c c-member docutils literal notranslate">PyDictObject.ma_version_tag</code> member.</li> <li>Thread Local Storage (TLS) API: <ul> <li><a class="reference internal" href="../c-api/init.html#c.PyThread_create_key" title="PyThread_create_key"><code class="xref c c-func docutils literal notranslate">PyThread_create_key()</code></a>: Use <a class="reference internal" href="../c-api/init.html#c.PyThread_tss_alloc" title="PyThread_tss_alloc"><code class="xref c c-func docutils literal notranslate">PyThread_tss_alloc()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.PyThread_delete_key" title="PyThread_delete_key"><code class="xref c c-func docutils literal notranslate">PyThread_delete_key()</code></a>: Use <a class="reference internal" href="../c-api/init.html#c.PyThread_tss_free" title="PyThread_tss_free"><code class="xref c c-func docutils literal notranslate">PyThread_tss_free()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.PyThread_set_key_value" title="PyThread_set_key_value"><code class="xref c c-func docutils literal notranslate">PyThread_set_key_value()</code></a>: Use <a class="reference internal" href="../c-api/init.html#c.PyThread_tss_set" title="PyThread_tss_set"><code class="xref c c-func docutils literal notranslate">PyThread_tss_set()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.PyThread_get_key_value" title="PyThread_get_key_value"><code class="xref c c-func docutils literal notranslate">PyThread_get_key_value()</code></a>: Use <a class="reference internal" href="../c-api/init.html#c.PyThread_tss_get" title="PyThread_tss_get"><code class="xref c c-func docutils literal notranslate">PyThread_tss_get()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.PyThread_delete_key_value" title="PyThread_delete_key_value"><code class="xref c c-func docutils literal notranslate">PyThread_delete_key_value()</code></a>: Use <a class="reference internal" href="../c-api/init.html#c.PyThread_tss_delete" title="PyThread_tss_delete"><code class="xref c c-func docutils literal notranslate">PyThread_tss_delete()</code></a> instead.</li> <li><a class="reference internal" href="../c-api/init.html#c.PyThread_ReInitTLS" title="PyThread_ReInitTLS"><code class="xref c c-func docutils literal notranslate">PyThread_ReInitTLS()</code></a>: Unneeded since Python 3.7.</li> </ul> </li> </ul> </section> </section> </section> <section id="build-changes"> <h2>Build Changes<a class="headerlink" href="#build-changes" title="Link to this heading">¶</a></h2> <ul class="simple"> <li><code class="docutils literal notranslate">arm64-apple-ios</code> and <code class="docutils literal notranslate">arm64-apple-ios-simulator</code> are both now <a class="pep reference external" href="https://peps.python.org/pep-0011/">PEP 11</a> tier 3 platforms. (<a class="reference internal" href="#whatsnew313-platform-support">PEP 730</a> written and implementation contributed by Russell Keith-Magee in <a class="reference external" href="https://github.com/python/cpython/issues/114099">gh-114099</a>.)</li> <li><code class="docutils literal notranslate">aarch64-linux-android</code> and <code class="docutils literal notranslate">x86_64-linux-android</code> are both now <a class="pep reference external" href="https://peps.python.org/pep-0011/">PEP 11</a> tier 3 platforms. (<a class="reference internal" href="#whatsnew313-platform-support">PEP 738</a> written and implementation contributed by Malcolm Smith in <a class="reference external" href="https://github.com/python/cpython/issues/116622">gh-116622</a>.)</li> <li><code class="docutils literal notranslate">wasm32-wasi</code> is now a <a class="pep reference external" href="https://peps.python.org/pep-0011/">PEP 11</a> tier 2 platform. (Contributed by Brett Cannon in <a class="reference external" href="https://github.com/python/cpython/issues/115192">gh-115192</a>.)</li> <li><code class="docutils literal notranslate">wasm32-emscripten</code> is no longer a <a class="pep reference external" href="https://peps.python.org/pep-0011/">PEP 11</a> supported platform. (Contributed by Brett Cannon in <a class="reference external" href="https://github.com/python/cpython/issues/115192">gh-115192</a>.)</li> <li>Building CPython now requires a compiler with support for the C11 atomic library, GCC built-in atomic functions, or MSVC interlocked intrinsics.</li> <li>Autoconf 2.71 and aclocal 1.16.5 are now required to regenerate the <code class="file docutils literal notranslate">configure</code> script. (Contributed by Christian Heimes in <a class="reference external" href="https://github.com/python/cpython/issues/89886">gh-89886</a> and by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/112090">gh-112090</a>.)</li> <li>SQLite 3.15.2 or newer is required to build the <a class="reference internal" href="../library/sqlite3.html#module-sqlite3" title="sqlite3: A DB-API 2.0 implementation using SQLite 3.x."><code class="xref py py-mod docutils literal notranslate">sqlite3</code></a> extension module. (Contributed by Erlend Aasland in <a class="reference external" href="https://github.com/python/cpython/issues/105875">gh-105875</a>.)</li> <li>CPython now bundles the <a class="reference external" href="https://github.com/microsoft/mimalloc/">mimalloc library</a> by default. It is licensed under the MIT license; see <a class="reference internal" href="../license.html#mimalloc-license">mimalloc license</a>. The bundled mimalloc has custom changes, see <a class="reference external" href="https://github.com/python/cpython/issues/113141">gh-113141</a> for details. (Contributed by Dino Viehland in <a class="reference external" href="https://github.com/python/cpython/issues/109914">gh-109914</a>.) </li> <li>The <code class="file docutils literal notranslate">configure</code> option <a class="reference internal" href="../using/configure.html#cmdoption-with-system-libmpdec"><code class="xref std std-option docutils literal notranslate">--with-system-libmpdec</code></a> now defaults to <code class="docutils literal notranslate">yes</code>. The bundled copy of <code class="docutils literal notranslate">libmpdecimal</code> will be removed in Python 3.15.</li> <li>Python built with <code class="file docutils literal notranslate">configure</code> <a class="reference internal" href="../using/configure.html#cmdoption-with-trace-refs"><code class="xref std std-option docutils literal notranslate">--with-trace-refs</code></a> (tracing references) is now ABI compatible with the Python release build and <a class="reference internal" href="../using/configure.html#debug-build">debug build</a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108634">gh-108634</a>.)</li> <li>On POSIX systems, the pkg-config (<code class="docutils literal notranslate">.pc</code>) filenames now include the ABI flags. For example, the free-threaded build generates <code class="docutils literal notranslate">python-3.13t.pc</code> and the debug build generates <code class="docutils literal notranslate">python-3.13d.pc</code>.</li> <li>The <code class="docutils literal notranslate">errno</code>, <code class="docutils literal notranslate">fcntl</code>, <code class="docutils literal notranslate">grp</code>, <code class="docutils literal notranslate">md5</code>, <code class="docutils literal notranslate">pwd</code>, <code class="docutils literal notranslate">resource</code>, <code class="docutils literal notranslate">termios</code>, <code class="docutils literal notranslate">winsound</code>, <code class="docutils literal notranslate">_ctypes_test</code>, <code class="docutils literal notranslate">_multiprocessing.posixshmem</code>, <code class="docutils literal notranslate">_scproxy</code>, <code class="docutils literal notranslate">_stat</code>, <code class="docutils literal notranslate">_statistics</code>, <code class="docutils literal notranslate">_testconsole</code>, <code class="docutils literal notranslate">_testimportmultiple</code> and <code class="docutils literal notranslate">_uuid</code> C extensions are now built with the <a class="reference internal" href="../c-api/stable.html#limited-c-api">limited C API</a>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/85283">gh-85283</a>.)</li> </ul> </section> <section id="porting-to-python-3-13"> <h2>Porting to Python 3.13<a class="headerlink" href="#porting-to-python-3-13" title="Link to this heading">¶</a></h2> This section lists previously described changes and other bugfixes that may require changes to your code. <section id="changes-in-the-python-api"> <h3>Changes in the Python API<a class="headerlink" href="#changes-in-the-python-api" title="Link to this heading">¶</a></h3> <ul id="pep667-porting-notes-py"> <li><a class="reference internal" href="#whatsnew313-locals-semantics">PEP 667</a> introduces several changes to the semantics of <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> and <a class="reference internal" href="../reference/datamodel.html#frame.f_locals" title="frame.f_locals"><code class="xref py py-attr docutils literal notranslate">f_locals</code></a>: <ul class="simple"> <li>Calling <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> in an <a class="reference internal" href="../glossary.html#term-optimized-scope">optimized scope</a> now produces an independent snapshot on each call, and hence no longer implicitly updates previously returned references. Obtaining the legacy CPython behavior now requires explicit calls to update the initially returned dictionary with the results of subsequent calls to <code class="xref py py-func docutils literal notranslate">locals()</code>. Code execution functions that implicitly target <code class="xref py py-func docutils literal notranslate">locals()</code> (such as <code class="docutils literal notranslate">exec</code> and <code class="docutils literal notranslate">eval</code>) must be passed an explicit namespace to access their results in an optimized scope. (Changed as part of <a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a>.)</li> <li>Calling <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a> from a comprehension at module or class scope (including via <code class="docutils literal notranslate">exec</code> or <code class="docutils literal notranslate">eval</code>) once more behaves as if the comprehension were running as an independent nested function (i.e. the local variables from the containing scope are not included). In Python 3.12, this had changed to include the local variables from the containing scope when implementing <a class="pep reference external" href="https://peps.python.org/pep-0709/">PEP 709</a>. (Changed as part of <a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a>.)</li> <li>Accessing <a class="reference internal" href="../reference/datamodel.html#frame.f_locals" title="frame.f_locals"><code class="xref py py-attr docutils literal notranslate">FrameType.f_locals</code></a> in an <a class="reference internal" href="../glossary.html#term-optimized-scope">optimized scope</a> now returns a write-through proxy rather than a snapshot that gets updated at ill-specified times. If a snapshot is desired, it must be created explicitly with <code class="docutils literal notranslate">dict</code> or the proxy’s <code class="docutils literal notranslate">.copy()</code> method. (Changed as part of <a class="pep reference external" href="https://peps.python.org/pep-0667/">PEP 667</a>.)</li> </ul> </li> <li><a class="reference internal" href="../library/functools.html#functools.partial" title="functools.partial"><code class="xref py py-class docutils literal notranslate">functools.partial</code></a> now emits a <a class="reference internal" href="../library/exceptions.html#FutureWarning" title="FutureWarning"><code class="xref py py-exc docutils literal notranslate">FutureWarning</code></a> when used as a method. The behavior will change in future Python versions. Wrap it in <a class="reference internal" href="../library/functions.html#staticmethod" title="staticmethod"><code class="xref py py-func docutils literal notranslate">staticmethod()</code></a> if you want to preserve the old behavior. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/121027">gh-121027</a>.)</li> <li>An <a class="reference internal" href="../library/exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate">OSError</code></a> is now raised by <a class="reference internal" href="../library/getpass.html#getpass.getuser" title="getpass.getuser"><code class="xref py py-func docutils literal notranslate">getpass.getuser()</code></a> for any failure to retrieve a username, instead of <a class="reference internal" href="../library/exceptions.html#ImportError" title="ImportError"><code class="xref py py-exc docutils literal notranslate">ImportError</code></a> on non-Unix platforms or <a class="reference internal" href="../library/exceptions.html#KeyError" title="KeyError"><code class="xref py py-exc docutils literal notranslate">KeyError</code></a> on Unix platforms where the password database is empty.</li> <li>The value of the <code class="xref py py-attr docutils literal notranslate">mode</code> attribute of <a class="reference internal" href="../library/gzip.html#gzip.GzipFile" title="gzip.GzipFile"><code class="xref py py-class docutils literal notranslate">gzip.GzipFile</code></a> is now a string (<code class="docutils literal notranslate">'rb'</code> or <code class="docutils literal notranslate">'wb'</code>) instead of an integer (<code class="docutils literal notranslate">1</code> or <code class="docutils literal notranslate">2</code>). The value of the <code class="xref py py-attr docutils literal notranslate">mode</code> attribute of the readable file-like object returned by <a class="reference internal" href="../library/zipfile.html#zipfile.ZipFile.open" title="zipfile.ZipFile.open"><code class="xref py py-meth docutils literal notranslate">zipfile.ZipFile.open()</code></a> is now <code class="docutils literal notranslate">'rb'</code> instead of <code class="docutils literal notranslate">'r'</code>. (Contributed by Serhiy Storchaka in <a class="reference external" href="https://github.com/python/cpython/issues/115961">gh-115961</a>.)</li> <li><a class="reference internal" href="../library/mailbox.html#mailbox.Maildir" title="mailbox.Maildir"><code class="xref py py-class docutils literal notranslate">mailbox.Maildir</code></a> now ignores files with a leading dot (<code class="docutils literal notranslate">.</code>). (Contributed by Zackery Spytz in <a class="reference external" href="https://github.com/python/cpython/issues/65559">gh-65559</a>.)</li> <li><a class="reference internal" href="../library/pathlib.html#pathlib.Path.glob" title="pathlib.Path.glob"><code class="xref py py-meth docutils literal notranslate">pathlib.Path.glob()</code></a> and <a class="reference internal" href="../library/pathlib.html#pathlib.Path.rglob" title="pathlib.Path.rglob"><code class="xref py py-meth docutils literal notranslate">rglob()</code></a> now return both files and directories if a pattern that ends with “<code class="docutils literal notranslate">**</code>” is given, rather than directories only. Add a trailing slash to keep the previous behavior and only match directories.</li> <li>The <a class="reference internal" href="../library/threading.html#module-threading" title="threading: Thread-based parallelism."><code class="xref py py-mod docutils literal notranslate">threading</code></a> module now expects the <code class="xref py py-mod docutils literal notranslate">_thread</code> module to have an <code class="xref py py-func docutils literal notranslate">_is_main_interpreter()</code> function. This function takes no arguments and returns <code class="docutils literal notranslate">True</code> if the current interpreter is the main interpreter. Any library or application that provides a custom <code class="xref py py-mod docutils literal notranslate">_thread</code> module must provide <code class="xref py py-func docutils literal notranslate">_is_main_interpreter()</code>, just like the module’s other “private” attributes. (<a class="reference external" href="https://github.com/python/cpython/issues/112826">gh-112826</a>.) </li> </ul> </section> <section id="changes-in-the-c-api"> <h3>Changes in the C API<a class="headerlink" href="#changes-in-the-c-api" title="Link to this heading">¶</a></h3> <ul> <li><code class="docutils literal notranslate">Python.h</code> no longer includes the <code class="docutils literal notranslate"><ieeefp.h></code> standard header. It was included for the <code class="xref c c-func docutils literal notranslate">finite()</code> function which is now provided by the <code class="docutils literal notranslate"><math.h></code> header. It should now be included explicitly if needed. Remove also the <code class="docutils literal notranslate">HAVE_IEEEFP_H</code> macro. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108765">gh-108765</a>.)</li> <li><code class="docutils literal notranslate">Python.h</code> no longer includes these standard header files: <code class="docutils literal notranslate"><time.h></code>, <code class="docutils literal notranslate"><sys/select.h></code> and <code class="docutils literal notranslate"><sys/time.h></code>. If needed, they should now be included explicitly. For example, <code class="docutils literal notranslate"><time.h></code> provides the <code class="xref c c-func docutils literal notranslate">clock()</code> and <code class="xref c c-func docutils literal notranslate">gmtime()</code> functions, <code class="docutils literal notranslate"><sys/select.h></code> provides the <code class="xref c c-func docutils literal notranslate">select()</code> function, and <code class="docutils literal notranslate"><sys/time.h></code> provides the <code class="xref c c-func docutils literal notranslate">futimes()</code>, <code class="xref c c-func docutils literal notranslate">gettimeofday()</code> and <code class="xref c c-func docutils literal notranslate">setitimer()</code> functions. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108765">gh-108765</a>.)</li> <li>On Windows, <code class="docutils literal notranslate">Python.h</code> no longer includes the <code class="docutils literal notranslate"><stddef.h></code> standard header file. If needed, it should now be included explicitly. For example, it provides <code class="xref c c-func docutils literal notranslate">offsetof()</code> function, and <code class="docutils literal notranslate">size_t</code> and <code class="docutils literal notranslate">ptrdiff_t</code> types. Including <code class="docutils literal notranslate"><stddef.h></code> explicitly was already needed by all other platforms, the <code class="docutils literal notranslate">HAVE_STDDEF_H</code> macro is only defined on Windows. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/108765">gh-108765</a>.)</li> <li>If the <a class="reference internal" href="../c-api/stable.html#c.Py_LIMITED_API" title="Py_LIMITED_API"><code class="xref c c-macro docutils literal notranslate">Py_LIMITED_API</code></a> macro is defined, <code class="xref c c-macro docutils literal notranslate">Py_BUILD_CORE</code>, <code class="xref c c-macro docutils literal notranslate">Py_BUILD_CORE_BUILTIN</code> and <code class="xref c c-macro docutils literal notranslate">Py_BUILD_CORE_MODULE</code> macros are now undefined by <code class="docutils literal notranslate"><Python.h></code>. (Contributed by Victor Stinner in <a class="reference external" href="https://github.com/python/cpython/issues/85283">gh-85283</a>.)</li> <li>The old trashcan macros <code class="docutils literal notranslate">Py_TRASHCAN_SAFE_BEGIN</code> and <code class="docutils literal notranslate">Py_TRASHCAN_SAFE_END</code> were removed. They should be replaced by the new macros <code class="docutils literal notranslate">Py_TRASHCAN_BEGIN</code> and <code class="docutils literal notranslate">Py_TRASHCAN_END</code>. A <code class="docutils literal notranslate">tp_dealloc</code> function that has the old macros, such as: <div class="highlight-python3 notranslate"><div class="highlight"><pre>static void mytype_dealloc(mytype *p) { PyObject_GC_UnTrack(p); Py_TRASHCAN_SAFE_BEGIN(p); ... Py_TRASHCAN_SAFE_END } </pre></div> </div> should migrate to the new macros as follows: <div class="highlight-python3 notranslate"><div class="highlight"><pre>static void mytype_dealloc(mytype *p) { PyObject_GC_UnTrack(p); Py_TRASHCAN_BEGIN(p, mytype_dealloc) ... Py_TRASHCAN_END } </pre></div> </div> Note that <code class="docutils literal notranslate">Py_TRASHCAN_BEGIN</code> has a second argument which should be the deallocation function it is in. The new macros were added in Python 3.8 and the old macros were deprecated in Python 3.11. (Contributed by Irit Katriel in <a class="reference external" href="https://github.com/python/cpython/issues/105111">gh-105111</a>.) </li> </ul> <ul class="simple" id="pep667-porting-notes-c"> <li><a class="reference internal" href="#whatsnew313-locals-semantics">PEP 667</a> introduces several changes to frame-related functions: <ul> <li>The effects of mutating the dictionary returned from <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetLocals" title="PyEval_GetLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetLocals()</code></a> in an <a class="reference internal" href="../glossary.html#term-optimized-scope">optimized scope</a> have changed. New dict entries added this way will now only be visible to subsequent <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetLocals" title="PyEval_GetLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetLocals()</code></a> calls in that frame, as <a class="reference internal" href="../c-api/frame.html#c.PyFrame_GetLocals" title="PyFrame_GetLocals"><code class="xref c c-func docutils literal notranslate">PyFrame_GetLocals()</code></a>, <a class="reference internal" href="../library/functions.html#locals" title="locals"><code class="xref py py-func docutils literal notranslate">locals()</code></a>, and <a class="reference internal" href="../reference/datamodel.html#frame.f_locals" title="frame.f_locals"><code class="xref py py-attr docutils literal notranslate">FrameType.f_locals</code></a> no longer access the same underlying cached dictionary. Changes made to entries for actual variable names and names added via the write-through proxy interfaces will be overwritten on subsequent calls to <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetLocals" title="PyEval_GetLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetLocals()</code></a> in that frame. The recommended code update depends on how the function was being used, so refer to the deprecation notice on the function for details.</li> <li>Calling <a class="reference internal" href="../c-api/frame.html#c.PyFrame_GetLocals" title="PyFrame_GetLocals"><code class="xref c c-func docutils literal notranslate">PyFrame_GetLocals()</code></a> in an <a class="reference internal" href="../glossary.html#term-optimized-scope">optimized scope</a> now returns a write-through proxy rather than a snapshot that gets updated at ill-specified times. If a snapshot is desired, it must be created explicitly (e.g. with <a class="reference internal" href="../c-api/dict.html#c.PyDict_Copy" title="PyDict_Copy"><code class="xref c c-func docutils literal notranslate">PyDict_Copy()</code></a>), or by calling the new <a class="reference internal" href="../c-api/reflection.html#c.PyEval_GetFrameLocals" title="PyEval_GetFrameLocals"><code class="xref c c-func docutils literal notranslate">PyEval_GetFrameLocals()</code></a> API.</li> <li><code class="xref c c-func docutils literal notranslate">PyFrame_FastToLocals()</code> and <code class="xref c c-func docutils literal notranslate">PyFrame_FastToLocalsWithError()</code> no longer have any effect. Calling these functions has been redundant since Python 3.11, when <a class="reference internal" href="../c-api/frame.html#c.PyFrame_GetLocals" title="PyFrame_GetLocals"><code class="xref c c-func docutils literal notranslate">PyFrame_GetLocals()</code></a> was first introduced.</li> <li><code class="xref c c-func docutils literal notranslate">PyFrame_LocalsToFast()</code> no longer has any effect. Calling this function is redundant now that <a class="reference internal" href="../c-api/frame.html#c.PyFrame_GetLocals" title="PyFrame_GetLocals"><code class="xref c c-func docutils literal notranslate">PyFrame_GetLocals()</code></a> returns a write-through proxy for <a class="reference internal" href="../glossary.html#term-optimized-scope">optimized scopes</a>.</li> </ul> </li> </ul> </section> </section> <section id="regression-test-changes"> <h2>Regression Test Changes<a class="headerlink" href="#regression-test-changes" title="Link to this heading">¶</a></h2> <ul class="simple"> <li>Python built with <code class="file docutils literal notranslate">configure</code> <a class="reference internal" href="../using/configure.html#cmdoption-with-pydebug"><code class="xref std std-option docutils literal notranslate">--with-pydebug</code></a> now supports a <a class="reference internal" href="../using/cmdline.html#cmdoption-X"><code class="xref std std-option docutils literal notranslate">-X presite=package.module</code></a> command-line option. If used, it specifies a module that should be imported early in the lifecycle of the interpreter, before <code class="docutils literal notranslate">site.py</code> is executed. (Contributed by Łukasz Langa in <a class="reference external" href="https://github.com/python/cpython/issues/110769">gh-110769</a>.)</li> </ul> </section> <section id="notable-changes-in-3-13-1"> <h2>Notable changes in 3.13.1<a class="headerlink" href="#notable-changes-in-3-13-1" title="Link to this heading">¶</a></h2> <section id="id11"> <h3>sys<a class="headerlink" href="#id11" title="Link to this heading">¶</a></h3> <ul class="simple"> <li>The previously undocumented special function <a class="reference internal" href="../library/sys.html#sys.getobjects" title="sys.getobjects"><code class="xref py py-func docutils literal notranslate">sys.getobjects()</code></a>, which only exists in specialized builds of Python, may now return objects from other interpreters than the one it’s called in.</li> </ul> </section> </section> </section> <div class="clearer"></div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="Main"> <div class="sphinxsidebarwrapper"> <div> <h3><a href="../contents.html">Table of Contents</a></h3> <ul> <li><a class="reference internal" href="#">What’s New In Python 3.13</a><ul> <li><a class="reference internal" href="#summary-release-highlights">Summary – Release Highlights</a></li> <li><a class="reference internal" href="#new-features">New Features</a><ul> <li><a class="reference internal" href="#a-better-interactive-interpreter">A better interactive interpreter</a></li> <li><a class="reference internal" href="#improved-error-messages">Improved error messages</a></li> <li><a class="reference internal" href="#free-threaded-cpython">Free-threaded CPython</a></li> <li><a class="reference internal" href="#an-experimental-just-in-time-jit-compiler">An experimental just-in-time (JIT) compiler</a></li> <li><a class="reference internal" href="#defined-mutation-semantics-for-locals">Defined mutation semantics for <code class="xref py py-func docutils literal notranslate">locals()</code></a></li> <li><a class="reference internal" href="#support-for-mobile-platforms">Support for mobile platforms</a></li> </ul> </li> <li><a class="reference internal" href="#other-language-changes">Other Language Changes</a></li> <li><a class="reference internal" href="#new-modules">New Modules</a></li> <li><a class="reference internal" href="#improved-modules">Improved Modules</a><ul> <li><a class="reference internal" href="#argparse">argparse</a></li> <li><a class="reference internal" href="#array">array</a></li> <li><a class="reference internal" href="#ast">ast</a></li> <li><a class="reference internal" href="#asyncio">asyncio</a></li> <li><a class="reference internal" href="#base64">base64</a></li> <li><a class="reference internal" href="#compileall">compileall</a></li> <li><a class="reference internal" href="#concurrent-futures">concurrent.futures</a></li> <li><a class="reference internal" href="#configparser">configparser</a></li> <li><a class="reference internal" href="#copy">copy</a></li> <li><a class="reference internal" href="#ctypes">ctypes</a></li> <li><a class="reference internal" href="#dbm">dbm</a></li> <li><a class="reference internal" href="#dis">dis</a></li> <li><a class="reference internal" href="#doctest">doctest</a></li> <li><a class="reference internal" href="#email">email</a></li> <li><a class="reference internal" href="#fractions">fractions</a></li> <li><a class="reference internal" href="#glob">glob</a></li> <li><a class="reference internal" href="#importlib">importlib</a></li> <li><a class="reference internal" href="#io">io</a></li> <li><a class="reference internal" href="#ipaddress">ipaddress</a></li> <li><a class="reference internal" href="#itertools">itertools</a></li> <li><a class="reference internal" href="#marshal">marshal</a></li> <li><a class="reference internal" href="#math">math</a></li> <li><a class="reference internal" href="#mimetypes">mimetypes</a></li> <li><a class="reference internal" href="#mmap">mmap</a></li> <li><a class="reference internal" href="#multiprocessing">multiprocessing</a></li> <li><a class="reference internal" href="#os">os</a></li> <li><a class="reference internal" href="#os-path">os.path</a></li> <li><a class="reference internal" href="#pathlib">pathlib</a></li> <li><a class="reference internal" href="#pdb">pdb</a></li> <li><a class="reference internal" href="#queue">queue</a></li> <li><a class="reference internal" href="#random">random</a></li> <li><a class="reference internal" href="#re">re</a></li> <li><a class="reference internal" href="#shutil">shutil</a></li> <li><a class="reference internal" href="#site">site</a></li> <li><a class="reference internal" href="#sqlite3">sqlite3</a></li> <li><a class="reference internal" href="#ssl">ssl</a></li> <li><a class="reference internal" href="#statistics">statistics</a></li> <li><a class="reference internal" href="#subprocess">subprocess</a></li> <li><a class="reference internal" href="#sys">sys</a></li> <li><a class="reference internal" href="#tempfile">tempfile</a></li> <li><a class="reference internal" href="#time">time</a></li> <li><a class="reference internal" href="#tkinter">tkinter</a></li> <li><a class="reference internal" href="#traceback">traceback</a></li> <li><a class="reference internal" href="#types">types</a></li> <li><a class="reference internal" href="#typing">typing</a></li> <li><a class="reference internal" href="#unicodedata">unicodedata</a></li> <li><a class="reference internal" href="#venv">venv</a></li> <li><a class="reference internal" href="#warnings">warnings</a></li> <li><a class="reference internal" href="#xml">xml</a></li> <li><a class="reference internal" href="#zipimport">zipimport</a></li> </ul> </li> <li><a class="reference internal" href="#optimizations">Optimizations</a></li> <li><a class="reference internal" href="#removed-modules-and-apis">Removed Modules And APIs</a><ul> <li><a class="reference internal" href="#pep-594-remove-dead-batteries-from-the-standard-library">PEP 594: Remove “dead batteries” from the standard library</a></li> <li><a class="reference internal" href="#to3">2to3</a></li> <li><a class="reference internal" href="#builtins">builtins</a></li> <li><a class="reference internal" href="#id3">configparser</a></li> <li><a class="reference internal" href="#importlib-metadata">importlib.metadata</a></li> <li><a class="reference internal" href="#locale">locale</a></li> <li><a class="reference internal" href="#opcode">opcode</a></li> <li><a class="reference internal" href="#id4">pathlib</a></li> <li><a class="reference internal" href="#id5">re</a></li> <li><a class="reference internal" href="#tkinter-tix">tkinter.tix</a></li> <li><a class="reference internal" href="#turtle">turtle</a></li> <li><a class="reference internal" href="#id6">typing</a></li> <li><a class="reference internal" href="#unittest">unittest</a></li> <li><a class="reference internal" href="#urllib">urllib</a></li> <li><a class="reference internal" href="#webbrowser">webbrowser</a></li> </ul> </li> <li><a class="reference internal" href="#new-deprecations">New Deprecations</a><ul> <li><a class="reference internal" href="#pending-removal-in-python-3-14">Pending Removal in Python 3.14</a></li> <li><a class="reference internal" href="#pending-removal-in-python-3-15">Pending Removal in Python 3.15</a></li> <li><a class="reference internal" href="#pending-removal-in-python-3-16">Pending removal in Python 3.16</a></li> <li><a class="reference internal" href="#pending-removal-in-future-versions">Pending Removal in Future Versions</a></li> </ul> </li> <li><a class="reference internal" href="#cpython-bytecode-changes">CPython Bytecode Changes</a></li> <li><a class="reference internal" href="#c-api-changes">C API Changes</a><ul> <li><a class="reference internal" href="#id7">New Features</a></li> <li><a class="reference internal" href="#changed-c-apis">Changed C APIs</a></li> <li><a class="reference internal" href="#limited-c-api-changes">Limited C API Changes</a></li> <li><a class="reference internal" href="#removed-c-apis">Removed C APIs</a></li> <li><a class="reference internal" href="#deprecated-c-apis">Deprecated C APIs</a><ul> <li><a class="reference internal" href="#id8">Pending Removal in Python 3.14</a></li> <li><a class="reference internal" href="#id9">Pending Removal in Python 3.15</a></li> <li><a class="reference internal" href="#id10">Pending Removal in Future Versions</a></li> </ul> </li> </ul> </li> <li><a class="reference internal" href="#build-changes">Build Changes</a></li> <li><a class="reference internal" href="#porting-to-python-3-13">Porting to Python 3.13</a><ul> <li><a class="reference internal" href="#changes-in-the-python-api">Changes in the Python API</a></li> <li><a class="reference internal" href="#changes-in-the-c-api">Changes in the C API</a></li> </ul> </li> <li><a class="reference internal" href="#regression-test-changes">Regression Test Changes</a></li> <li><a class="reference internal" href="#notable-changes-in-3-13-1">Notable changes in 3.13.1</a><ul> <li><a class="reference internal" href="#id11">sys</a></li> </ul> </li> </ul> </li> </ul> </div> <div> <h4>Previous topic</h4> <a href="index.html" title="previous chapter">What’s New in Python</a> </div> <div> <h4>Next topic</h4> <a href="3.12.html" title="next chapter">What’s New In Python 3.12</a> </div> <div role="note" aria-label="source link"> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../bugs.html">Report a Bug</a></li> <li> <a href="https://github.com/python/cpython/blob/main/Doc/whatsnew/3.13.rst" rel="nofollow">Show Source </a> </li> </ul> </div> </div> <div id="sidebarbutton" title="Collapse sidebar"> « </div> </div> <div class="clearer"></div> </div> <div class="related" role="navigation" aria-label="Related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" >index</a></li> <li class="right" > <a href="../py-modindex.html" title="Python Module Index" >modules</a> |</li> <li class="right" > <a href="3.12.html" title="What’s New In Python 3.12" >next</a> |</li> <li class="right" > <a href="index.html" title="What’s New in Python" >previous</a> |</li> <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li> <li><a href="https://www.python.org/">Python</a> »</li> <li class="switchers"> <div class="language_switcher_placeholder"></div> <div class="version_switcher_placeholder"></div> </li> <li> </li> <li id="cpython-language-and-version"> <a href="../index.html">3.13.0 Documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >What’s New in Python</a> »</li> <li class="nav-item nav-item-this"><a href="">What’s New In Python 3.13</a></li> <li class="right"> <div class="inline-search" role="search"> <form class="inline-search" action="../search.html" method="get"> <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" /> <input type="submit" value="Go" /> </form> </div> | </li> <li class="right"> <label class="theme-selector-label"> Theme <select class="theme-selector" oninput="activateTheme(this.value)"> <option value="auto" selected>Auto</option> <option value="light">Light</option> <option value="dark">Dark</option> </select> </label> |</li> </ul> </div> <div class="footer"> © <a href="../copyright.html"> Copyright </a> 2001-2024, Python Software Foundation. This page is licensed under the Python Software Foundation License Version 2. Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License. See <a href="/license.html">History and License</a> for more information. The Python Software Foundation is a non-profit corporation. <a href="https://www.python.org/psf/donations/">Please donate.</a> Last updated on Nov 30, 2024 (09:47 UTC). <a href="/bugs.html">Found a bug</a>? Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.1.3. </div> <script type="text/javascript" src="../_static/switchers.js"></script> </body> </html>