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="Deprecations" /> <meta property="og:type" content="website" /> <meta property="og:url" content="https://docs.python.org/3/deprecations/index.html" /> <meta property="og:site_name" content="Python documentation" /> <meta property="og:description" content="Pending Removal in Python 3.14: argparse: The type, choices, and metavar parameters of argparse.BooleanOptionalAction are deprecated and will be removed in 3.14. (Contributed by Nikita Sobolev in g..." /> <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="Pending Removal in Python 3.14: argparse: The type, choices, and metavar parameters of argparse.BooleanOptionalAction are deprecated and will be removed in 3.14. (Contributed by Nikita Sobolev in g..." /> <meta property="og:image:width" content="200" /> <meta property="og:image:height" content="200" /> <meta name="theme-color" content="#3776ab" /> <title>Deprecations — 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="Glossary" href="../glossary.html" /> <link rel="prev" title="“Why is Python Installed on my Computer?” FAQ" href="../faq/installed.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/deprecations/index.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="#">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> <li><a class="reference internal" href="#c-api-deprecations">C API Deprecations</a><ul> <li><a class="reference internal" href="#id1">Pending Removal in Python 3.14</a></li> <li><a class="reference internal" href="#id2">Pending Removal in Python 3.15</a></li> <li><a class="reference internal" href="#id3">Pending Removal in Future Versions</a></li> </ul> </li> </ul> </li> </ul> </div> <div> <h4>Previous topic</h4> <a href="../faq/installed.html" title="previous chapter">“Why is Python Installed on my Computer?” FAQ</a> </div> <div> <h4>Next topic</h4> <a href="../glossary.html" title="next chapter">Glossary</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/deprecations/index.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="../glossary.html" title="Glossary" accesskey="N">next</a> |</li> <li class="right" > <a href="../faq/installed.html" title="“Why is Python Installed on my Computer?” FAQ" 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-this"><a href="">Deprecations</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="deprecations"> <h1>Deprecations<a class="headerlink" href="#deprecations" title="Link to this heading">¶</a></h1> <section id="pending-removal-in-python-3-14"> <h2>Pending Removal in Python 3.14<a class="headerlink" href="#pending-removal-in-python-3-14" title="Link to this heading">¶</a></h2> <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"> <h2>Pending Removal in Python 3.15<a class="headerlink" href="#pending-removal-in-python-3-15" title="Link to this heading">¶</a></h2> <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"> <h2>Pending removal in Python 3.16<a class="headerlink" href="#pending-removal-in-python-3-16" title="Link to this heading">¶</a></h2> <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"> <h2>Pending Removal in Future Versions<a class="headerlink" href="#pending-removal-in-future-versions" title="Link to this heading">¶</a></h2> 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 id="c-api-deprecations"> <h2>C API Deprecations<a class="headerlink" href="#c-api-deprecations" title="Link to this heading">¶</a></h2> <section id="id1"> <h3>Pending Removal in Python 3.14<a class="headerlink" href="#id1" title="Link to this heading">¶</a></h3> <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="id2"> <h3>Pending Removal in Python 3.15<a class="headerlink" href="#id2" title="Link to this heading">¶</a></h3> <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="id3"> <h3>Pending Removal in Future Versions<a class="headerlink" href="#id3" title="Link to this heading">¶</a></h3> 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> <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="#">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> <li><a class="reference internal" href="#c-api-deprecations">C API Deprecations</a><ul> <li><a class="reference internal" href="#id1">Pending Removal in Python 3.14</a></li> <li><a class="reference internal" href="#id2">Pending Removal in Python 3.15</a></li> <li><a class="reference internal" href="#id3">Pending Removal in Future Versions</a></li> </ul> </li> </ul> </li> </ul> </div> <div> <h4>Previous topic</h4> <a href="../faq/installed.html" title="previous chapter">“Why is Python Installed on my Computer?” FAQ</a> </div> <div> <h4>Next topic</h4> <a href="../glossary.html" title="next chapter">Glossary</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/deprecations/index.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="../glossary.html" title="Glossary" >next</a> |</li> <li class="right" > <a href="../faq/installed.html" title="“Why is Python Installed on my Computer?” FAQ" >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-this"><a href="">Deprecations</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 24, 2024 (17:50 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>