python-docs-fr/whatsnew/3.9.po

1779 lines
59 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"PO-Revision-Date: 2020-08-06 00:39+0200\n"
"Last-Translator: \n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 2.4\n"
#: whatsnew/3.9.rst:3
msgid "What's New In Python 3.9"
msgstr "Les nouveautés de Python 3.9"
#: whatsnew/3.9.rst:0
msgid "Release"
msgstr "Version"
#: whatsnew/3.9.rst:5
msgid "|release|"
msgstr ""
#: whatsnew/3.9.rst:0
msgid "Date"
msgstr ""
#: whatsnew/3.9.rst:6
msgid "|today|"
msgstr "|today|"
#: whatsnew/3.9.rst:48
msgid "This article explains the new features in Python 3.9, compared to 3.8."
msgstr ""
"Cet article explique les nouvelles fonctionnalités de Python 3.9 par rapport "
"à la version 3.8."
#: whatsnew/3.9.rst:50
msgid "For full details, see the :ref:`changelog <changelog>`."
msgstr "Pour plus de détails, voir le :ref:`changelog <changelog>`."
#: whatsnew/3.9.rst:54
msgid ""
"Prerelease users should be aware that this document is currently in draft "
"form. It will be updated substantially as Python 3.9 moves towards release, "
"so it's worth checking back even after reading earlier versions."
msgstr ""
"Les utilisateurs de la prépublication doivent savoir que ce document est "
"actuellement à l'état de brouillon. Il sera mis à jour de manière "
"substantielle au fur et à mesure que Python 3.9 se rapprochera de sa version "
"finale, il est donc utile de le consulter même après avoir lu les versions "
"précédentes."
#: whatsnew/3.9.rst:60
msgid "Summary -- Release highlights"
msgstr "Résumé Points forts de la publication"
#: whatsnew/3.9.rst:70
msgid "You should check for DeprecationWarning in your code"
msgstr "Vous devez vérifier la présence de DeprecationWarning dans votre code"
#: whatsnew/3.9.rst:72
msgid ""
"When Python 2.7 was still supported, many functions were kept for backward "
"compatibility with Python 2.7. With the end of Python 2.7 support, these "
"backward compatibility layers have been removed, or will be removed soon. "
"Most of them emitted a :exc:`DeprecationWarning` warning for several years. "
"For example, using ``collections.Mapping`` instead of ``collections.abc."
"Mapping`` emits a :exc:`DeprecationWarning` since Python 3.3, released in "
"2012."
msgstr ""
"Lorsque Python 2.7 était encore supporté, de nombreuses fonctions ont été "
"conservées pour assurer la rétrocompatibilité avec Python 2.7. Avec la fin "
"du support de Python 2.7, ces couches de rétrocompatibilité ont été "
"supprimées, ou le seront bientôt. La plupart d'entre elles ont émis un "
"avertissement :exc:`DeprecationWarning` pendant plusieurs années. Par "
"exemple, l'utilisation de ``collections.Mapping`` au lieu de ``collections."
"abc.Mapping`` émet un :exc:`DeprecationWarning` depuis Python 3.3, sorti en "
"2012."
#: whatsnew/3.9.rst:79
msgid ""
"Test your application with the :option:`-W` ``default`` command-line option "
"to see :exc:`DeprecationWarning` and :exc:`PendingDeprecationWarning`, or "
"even with :option:`-W` ``error`` to treat them as errors. :ref:`Warnings "
"Filter <warning-filter>` can be used to ignore warnings from third-party "
"code."
msgstr ""
"Testez votre application avec l'option de ligne de commande :option:`-W` "
"``default`` pour voir les :exc:`DeprecationWarning` et les :exc:"
"`PendingDeprecationWarning`, ou même avec :option:`-W` ``error`` pour les "
"traiter comme des erreurs. :ref:`Le filtre des avertissements <warning-"
"filter>` peut être utilisé pour ignorer les avertissements provenant de code "
"de tierces parties."
#: whatsnew/3.9.rst:84
msgid ""
"It has been decided to keep a few backward compatibility layers for one last "
"release, to give more time to Python projects maintainers to organize the "
"removal of the Python 2 support and add support for Python 3.9."
msgstr ""
"Il a été décidé de conserver quelques couches de compatibilité ascendante "
"pour une dernière version, afin de donner plus de temps aux responsables des "
"projets Python pour organiser la suppression du support de Python 2 et "
"ajouter le support de Python 3.9."
#: whatsnew/3.9.rst:88
msgid ""
"Aliases to :ref:`Abstract Base Classes <collections-abstract-base-classes>` "
"in the :mod:`collections` module, like ``collections.Mapping`` alias to :"
"class:`collections.abc.Mapping`, are kept for one last release for backward "
"compatibility. They will be removed from Python 3.10."
msgstr ""
"Les alias vers :ref:`Abstract Base Classes <collections-abstract-base-"
"classes>` dans le module :mod:`collections`, comme l'alias ``collections."
"Mapping`` vers :class:`collections.abc.Mapping`, sont conservés pour une "
"dernière version au titre de la rétrocompatibilité. Ils seront supprimés de "
"Python 3.10."
#: whatsnew/3.9.rst:93
msgid ""
"More generally, try to run your tests in the :ref:`Python Development Mode "
"<devmode>` which helps to prepare your code to make it compatible with the "
"next Python version."
msgstr ""
"Plus généralement, essayez d'exécuter vos tests dans le :ref:`Python "
"Development Mode <devmode>` qui aide à préparer votre code pour le rendre "
"compatible avec la prochaine version de Python."
#: whatsnew/3.9.rst:99 whatsnew/3.9.rst:1031
msgid "New Features"
msgstr "Nouvelles fonctionnalités"
#: whatsnew/3.9.rst:102
msgid "Dictionary Merge & Update Operators"
msgstr "Opérateurs de fusion et de mise à jour de dictionnaires"
#: whatsnew/3.9.rst:104
msgid ""
"Merge (``|``) and update (``|=``) operators have been added to the built-in :"
"class:`dict` class. See :pep:`584` for a full description. (Contributed by "
"Brandt Bucher in :issue:`36144`.)"
msgstr ""
"Les opérateurs de fusion (``|``) et de mise à jour (``|=``) ont été ajoutés "
"à la classe native :class:`dict`. Voir :pep:`584` pour une description "
"complète (contribution de Brandt Bucher dans :issue:`36144`)."
#: whatsnew/3.9.rst:109
msgid "PEP 616: New removeprefix() and removesuffix() string methods"
msgstr ""
"PEP 616 : nouvelles méthodes de chaînes de caractères removeprefix() et "
"removesuffix()"
#: whatsnew/3.9.rst:111
msgid ""
":meth:`str.removeprefix(prefix)<str.removeprefix>` and :meth:`str."
"removesuffix(suffix)<str.removesuffix>` have been added to easily remove an "
"unneeded prefix or a suffix from a string. Corresponding ``bytes``, "
"``bytearray``, and ``collections.UserString`` methods have also been added. "
"See :pep:`616` for a full description. (Contributed by Dennis Sweeney in :"
"issue:`39939`.)"
msgstr ""
":meth:`str.removeprefix(préfixe)<str.removeprefix>` et :meth:`str."
"removesuffix(suffixe)<str.removesuffix>` ont été ajoutées pour supprimer "
"facilement un préfixe ou un suffixe inutile d'une chaîne. Les méthodes "
"correspondantes de ``bytes``, ``bytearray`` et ``collections.UserString`` "
"ont également été ajoutées. Voir :pep:`616` pour une description complète "
"(contribution de Dennis Sweeney dans :issue:`39939`)."
#: whatsnew/3.9.rst:119
msgid "PEP 585: Builtin Generic Types"
msgstr "PEP 585 : Types génériques natifs"
#: whatsnew/3.9.rst:121
msgid ""
"In type annotations you can now use built-in collection types such as "
"``list`` and ``dict`` as generic types instead of importing the "
"corresponding capitalized types (e.g. ``List`` or ``Dict``) from "
"``typing``. Some other types in the standard library are also now generic, "
"for example ``queue.Queue``."
msgstr ""
"Dans les annotations de type, vous pouvez maintenant utiliser les types de "
"collection natifs tels que ``list`` et ``dict`` comme types génériques au "
"lieu d'importer les types en majuscules correspondants (par exemple ``List`` "
"ou ``Dict``) à partir de ``typing``. D'autres types de la bibliothèque "
"standard sont maintenant génériques, par exemple ``queue.Queue``."
#: whatsnew/3.9.rst:127 whatsnew/3.9.rst:963
msgid "Example:"
msgstr "Exemple :"
#: whatsnew/3.9.rst:135
msgid ""
"See :pep:`585` for more details. (Contributed by Guido van Rossum, Ethan "
"Smith, and Batuhan Taşkaya in :issue:`39481`.)"
msgstr ""
"Voir :pep:`585` pour plus de détails (contribution de Guido van Rossum, "
"Ethan Smith et Batuhan Taşkaya dans :issue:`39481`)."
#: whatsnew/3.9.rst:139
msgid "PEP 617: New Parser"
msgstr "PEP 617 : Nouvel analyseur syntaxique"
#: whatsnew/3.9.rst:141
msgid ""
"Python 3.9 uses a new parser, based on `PEG <https://en.wikipedia.org/wiki/"
"Parsing_expression_grammar>`_ instead of `LL(1) <https://en.wikipedia.org/"
"wiki/LL_parser>`_. The new parser's performance is roughly comparable to "
"that of the old parser, but the PEG formalism is more flexible than LL(1) "
"when it comes to designing new language features. We'll start using this "
"flexibility in Python 3.10 and later."
msgstr ""
"Python 3.9 utilise un nouvel analyseur syntaxique, basé sur `PEG <https://en."
"wikipedia.org/wiki/Parsing_expression_grammar>`_ au lieu de `LL(1) <https://"
"fr.wikipedia.org/wiki/Analyse_LL>`_. Les performances du nouvel analyseur "
"sont à peu près comparables à celles de l'ancien, mais le formalisme PEG est "
"plus souple que LL(1) lorsqu'il s'agit de concevoir de nouvelles "
"fonctionnalités du langage. Nous commencerons à utiliser cette flexibilité "
"en Python 3.10 et supérieur."
#: whatsnew/3.9.rst:149
msgid ""
"The :mod:`ast` module uses the new parser and produces the same AST as the "
"old parser."
msgstr ""
"Le module :mod:`ast` utilise le nouvel analyseur syntaxique et produit le "
"même AST que l'ancien analyseur."
#: whatsnew/3.9.rst:152
msgid ""
"In Python 3.10, the old parser will be deleted and so will all functionality "
"that depends on it (primarily the :mod:`parser` module, which has long been "
"deprecated). In Python 3.9 *only*, you can switch back to the LL(1) parser "
"using a command line switch (``-X oldparser``) or an environment variable "
"(``PYTHONOLDPARSER=1``)."
msgstr ""
"En Python 3.10, l'ancien analyseur sera supprimé ainsi que toutes les "
"fonctionnalités qui en dépendent (principalement le module :mod:`parser`, "
"qui est obsolète depuis longtemps). En Python 3.9 *seulement*, vous pouvez "
"revenir à l'analyseur LL(1) en utilisant une option en ligne de commande (``-"
"X oldparser``) ou une variable d'environnement (``PYTHONOLDPARSER=1``)."
#: whatsnew/3.9.rst:158
msgid ""
"See :pep:`617` for more details. (Contributed by Guido van Rossum, Pablo "
"Galindo and Lysandros Nikolaou in :issue:`40334`.)"
msgstr ""
"Voir :pep:`617` pour plus de détails (contribution de Guido van Rossum, "
"Pablo Galindo et Lysandros Nikolaou dans :issue:`40334`)."
#: whatsnew/3.9.rst:163
msgid "Other Language Changes"
msgstr ""
#: whatsnew/3.9.rst:165
msgid ""
":func:`__import__` now raises :exc:`ImportError` instead of :exc:"
"`ValueError`, which used to occur when a relative import went past its top-"
"level package. (Contributed by Ngalim Siregar in :issue:`37444`.)"
msgstr ""
#: whatsnew/3.9.rst:171
msgid ""
"Python now gets the absolute path of the script filename specified on the "
"command line (ex: ``python3 script.py``): the ``__file__`` attribute of the :"
"mod:`__main__` module became an absolute path, rather than a relative path. "
"These paths now remain valid after the current directory is changed by :func:"
"`os.chdir`. As a side effect, the traceback also displays the absolute path "
"for :mod:`__main__` module frames in this case. (Contributed by Victor "
"Stinner in :issue:`20443`.)"
msgstr ""
#: whatsnew/3.9.rst:179
msgid ""
"In the :ref:`Python Development Mode <devmode>` and in debug build, the "
"*encoding* and *errors* arguments are now checked for string encoding and "
"decoding operations. Examples: :func:`open`, :meth:`str.encode` and :meth:"
"`bytes.decode`."
msgstr ""
#: whatsnew/3.9.rst:184
msgid ""
"By default, for best performance, the *errors* argument is only checked at "
"the first encoding/decoding error and the *encoding* argument is sometimes "
"ignored for empty strings. (Contributed by Victor Stinner in :issue:`37388`.)"
msgstr ""
#: whatsnew/3.9.rst:189
msgid ""
"``\"\".replace(\"\", s, n)`` now returns ``s`` instead of an empty string "
"for all non-zero ``n``. It is now consistent with ``\"\".replace(\"\", "
"s)``. There are similar changes for :class:`bytes` and :class:`bytearray` "
"objects. (Contributed by Serhiy Storchaka in :issue:`28029`.)"
msgstr ""
#: whatsnew/3.9.rst:194
msgid ""
"Any valid expression can now be used as a :term:`decorator`. Previously, "
"the grammar was much more restrictive. See :pep:`614` for details. "
"(Contributed by Brandt Bucher in :issue:`39702`.)"
msgstr ""
#: whatsnew/3.9.rst:198
msgid ""
"Improved help for the :mod:`typing` module. Docstrings are now shown for all "
"special forms and special generic aliases (like ``Union`` and ``List``). "
"Using :func:`help` with generic alias like ``List[int]`` will show the help "
"for the correspondent concrete type (``list`` in this case). (Contributed by "
"Serhiy Storchaka in :issue:`40257`.)"
msgstr ""
#: whatsnew/3.9.rst:206
msgid "New Modules"
msgstr ""
#: whatsnew/3.9.rst:209
msgid "zoneinfo"
msgstr ""
#: whatsnew/3.9.rst:211
msgid ""
"The :mod:`zoneinfo` module brings support for the IANA time zone database to "
"the standard library. It adds :class:`zoneinfo.ZoneInfo`, a concrete :class:"
"`datetime.tzinfo` implementation backed by the system's time zone data."
msgstr ""
#: whatsnew/3.9.rst:215
msgid "Example::"
msgstr "Exemple ::"
#: whatsnew/3.9.rst:235
msgid ""
"As a fall-back source of data for platforms that don't ship the IANA "
"database, the |tzdata|_ module was released as a first-party package -- "
"distributed via PyPI and maintained by the CPython core team."
msgstr ""
#: whatsnew/3.9.rst:244
msgid ""
":pep:`615` -- Support for the IANA Time Zone Database in the Standard Library"
msgstr ""
#: whatsnew/3.9.rst:245
msgid "PEP written and implemented by Paul Ganssle"
msgstr ""
#: whatsnew/3.9.rst:249
msgid "graphlib"
msgstr ""
#: whatsnew/3.9.rst:251
msgid ""
"Add the :mod:`graphlib` that contains the :class:`graphlib."
"TopologicalSorter` class to offer functionality to perform topological "
"sorting of graphs. (Contributed by Pablo Galindo, Tim Peters and Larry "
"Hastings in :issue:`17005`.)"
msgstr ""
#: whatsnew/3.9.rst:257
msgid "Improved Modules"
msgstr ""
#: whatsnew/3.9.rst:260
msgid "ast"
msgstr "ast"
#: whatsnew/3.9.rst:262
msgid ""
"Added the *indent* option to :func:`~ast.dump` which allows it to produce a "
"multiline indented output. (Contributed by Serhiy Storchaka in :issue:"
"`37995`.)"
msgstr ""
#: whatsnew/3.9.rst:266
msgid ""
"Added :func:`ast.unparse` as a function in the :mod:`ast` module that can be "
"used to unparse an :class:`ast.AST` object and produce a string with code "
"that would produce an equivalent :class:`ast.AST` object when parsed. "
"(Contributed by Pablo Galindo and Batuhan Taskaya in :issue:`38870`.)"
msgstr ""
#: whatsnew/3.9.rst:271
msgid ""
"Added docstrings to AST nodes that contains the ASDL signature used to "
"construct that node. (Contributed by Batuhan Taskaya in :issue:`39638`.)"
msgstr ""
#: whatsnew/3.9.rst:275
msgid "asyncio"
msgstr "asyncio"
#: whatsnew/3.9.rst:277
msgid ""
"Due to significant security concerns, the *reuse_address* parameter of :meth:"
"`asyncio.loop.create_datagram_endpoint` is no longer supported. This is "
"because of the behavior of the socket option ``SO_REUSEADDR`` in UDP. For "
"more details, see the documentation for ``loop.create_datagram_endpoint()``. "
"(Contributed by Kyle Stanley, Antoine Pitrou, and Yury Selivanov in :issue:"
"`37228`.)"
msgstr ""
#: whatsnew/3.9.rst:284
msgid ""
"Added a new :term:`coroutine` :meth:`~asyncio.loop."
"shutdown_default_executor` that schedules a shutdown for the default "
"executor that waits on the :class:`~concurrent.futures.ThreadPoolExecutor` "
"to finish closing. Also, :func:`asyncio.run` has been updated to use the "
"new :term:`coroutine`. (Contributed by Kyle Stanley in :issue:`34037`.)"
msgstr ""
#: whatsnew/3.9.rst:290
msgid ""
"Added :class:`asyncio.PidfdChildWatcher`, a Linux-specific child watcher "
"implementation that polls process file descriptors. (:issue:`38692`)"
msgstr ""
#: whatsnew/3.9.rst:293
msgid ""
"Added a new :term:`coroutine` :func:`asyncio.to_thread`. It is mainly used "
"for running IO-bound functions in a separate thread to avoid blocking the "
"event loop, and essentially works as a high-level version of :meth:`~asyncio."
"loop.run_in_executor` that can directly take keyword arguments. (Contributed "
"by Kyle Stanley and Yury Selivanov in :issue:`32309`.)"
msgstr ""
#: whatsnew/3.9.rst:300
msgid "compileall"
msgstr "compileall"
#: whatsnew/3.9.rst:302
msgid ""
"Added new possibility to use hardlinks for duplicated ``.pyc`` files: "
"*hardlink_dupes* parameter and --hardlink-dupes command line option. "
"(Contributed by Lumír 'Frenzy' Balhar in :issue:`40495`.)"
msgstr ""
#: whatsnew/3.9.rst:305
msgid ""
"Added new options for path manipulation in resulting ``.pyc`` files: "
"*stripdir*, *prependdir*, *limit_sl_dest* parameters and -s, -p, -e command "
"line options. Added the possibility to specify the option for an "
"optimization level multiple times. (Contributed by Lumír 'Frenzy' Balhar in :"
"issue:`38112`.)"
msgstr ""
#: whatsnew/3.9.rst:310
msgid "concurrent.futures"
msgstr "concurrent.futures"
#: whatsnew/3.9.rst:312
msgid ""
"Added a new *cancel_futures* parameter to :meth:`concurrent.futures.Executor."
"shutdown` that cancels all pending futures which have not started running, "
"instead of waiting for them to complete before shutting down the executor. "
"(Contributed by Kyle Stanley in :issue:`39349`.)"
msgstr ""
#: whatsnew/3.9.rst:318
msgid ""
"Removed daemon threads from :class:`~concurrent.futures.ThreadPoolExecutor` "
"and :class:`~concurrent.futures.ProcessPoolExecutor`. This improves "
"compatibility with subinterpreters and predictability in their shutdown "
"processes. (Contributed by Kyle Stanley in :issue:`39812`.)"
msgstr ""
#: whatsnew/3.9.rst:323
msgid ""
"Workers in :class:`~concurrent.futures.ProcessPoolExecutor` are now spawned "
"on demand, only when there are no available idle workers to reuse. This "
"optimizes startup overhead and reduces the amount of lost CPU time to idle "
"workers. (Contributed by Kyle Stanley in :issue:`39207`.)"
msgstr ""
#: whatsnew/3.9.rst:329
msgid "curses"
msgstr "curses"
#: whatsnew/3.9.rst:331
msgid ""
"Add :func:`curses.get_escdelay`, :func:`curses.set_escdelay`, :func:`curses."
"get_tabsize`, and :func:`curses.set_tabsize` functions. (Contributed by "
"Anthony Sottile in :issue:`38312`.)"
msgstr ""
#: whatsnew/3.9.rst:336
msgid "datetime"
msgstr "datetime"
#: whatsnew/3.9.rst:337
msgid ""
"The :meth:`~datetime.date.isocalendar()` of :class:`datetime.date` and :meth:"
"`~datetime.datetime.isocalendar()` of :class:`datetime.datetime` methods now "
"returns a :func:`~collections.namedtuple` instead of a :class:`tuple`. "
"(Contributed by Dong-hee Na in :issue:`24416`.)"
msgstr ""
#: whatsnew/3.9.rst:343
msgid "distutils"
msgstr "distutils"
#: whatsnew/3.9.rst:345
msgid ""
"The :command:`upload` command now creates SHA2-256 and Blake2b-256 hash "
"digests. It skips MD5 on platforms that block MD5 digest. (Contributed by "
"Christian Heimes in :issue:`40698`.)"
msgstr ""
#: whatsnew/3.9.rst:350
msgid "fcntl"
msgstr ""
#: whatsnew/3.9.rst:352
msgid ""
"Added constants :data:`~fcntl.F_OFD_GETLK`, :data:`~fcntl.F_OFD_SETLK` and :"
"data:`~fcntl.F_OFD_SETLKW`. (Contributed by Dong-hee Na in :issue:`38602`.)"
msgstr ""
#: whatsnew/3.9.rst:357
msgid "ftplib"
msgstr ""
#: whatsnew/3.9.rst:359
msgid ""
":class:`~ftplib.FTP` and :class:`~ftplib.FTP_TLS` now raise a :class:"
"`ValueError` if the given timeout for their constructor is zero to prevent "
"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:"
"`39259`.)"
msgstr ""
#: whatsnew/3.9.rst:364
msgid "gc"
msgstr ""
#: whatsnew/3.9.rst:366
msgid ""
"When the garbage collector makes a collection in which some objects "
"resurrect (they are reachable from outside the isolated cycles after the "
"finalizers have been executed), do not block the collection of all objects "
"that are still unreachable. (Contributed by Pablo Galindo and Tim Peters in :"
"issue:`38379`.)"
msgstr ""
#: whatsnew/3.9.rst:371
msgid ""
"Added a new function :func:`gc.is_finalized` to check if an object has been "
"finalized by the garbage collector. (Contributed by Pablo Galindo in :issue:"
"`39322`.)"
msgstr ""
#: whatsnew/3.9.rst:376
msgid "hashlib"
msgstr ""
#: whatsnew/3.9.rst:378
msgid ""
"Builtin hash modules can now be disabled with ``./configure --without-"
"builtin-hashlib-hashes`` or selectively enabled with e.g. ``./configure --"
"with-builtin-hashlib-hashes=sha3,blake2`` to force use of OpenSSL based "
"implementation. (Contributed by Christian Heimes in :issue:`40479`)"
msgstr ""
#: whatsnew/3.9.rst:385
msgid "http"
msgstr ""
#: whatsnew/3.9.rst:387
msgid ""
"HTTP status codes ``103 EARLY_HINTS``, ``418 IM_A_TEAPOT`` and ``425 "
"TOO_EARLY`` are added to :class:`http.HTTPStatus`. (Contributed by Dong-hee "
"Na in :issue:`39509` and Ross Rhodes in :issue:`39507`.)"
msgstr ""
#: whatsnew/3.9.rst:391
msgid "imaplib"
msgstr ""
#: whatsnew/3.9.rst:393
msgid ""
":class:`~imaplib.IMAP4` and :class:`~imaplib.IMAP4_SSL` now have an optional "
"*timeout* parameter for their constructors. Also, the :meth:`~imaplib.IMAP4."
"open` method now has an optional *timeout* parameter with this change. The "
"overridden methods of :class:`~imaplib.IMAP4_SSL` and :class:`~imaplib."
"IMAP4_stream` were applied to this change. (Contributed by Dong-hee Na in :"
"issue:`38615`.)"
msgstr ""
#: whatsnew/3.9.rst:400
msgid ""
":meth:`imaplib.IMAP4.unselect` is added. :meth:`imaplib.IMAP4.unselect` "
"frees server's resources associated with the selected mailbox and returns "
"the server to the authenticated state. This command performs the same "
"actions as :meth:`imaplib.IMAP4.close`, except that no messages are "
"permanently removed from the currently selected mailbox. (Contributed by "
"Dong-hee Na in :issue:`40375`.)"
msgstr ""
#: whatsnew/3.9.rst:408
msgid "importlib"
msgstr "importlib"
#: whatsnew/3.9.rst:410
msgid ""
"To improve consistency with import statements, :func:`importlib.util."
"resolve_name` now raises :exc:`ImportError` instead of :exc:`ValueError` for "
"invalid relative import attempts. (Contributed by Ngalim Siregar in :issue:"
"`37444`.)"
msgstr ""
#: whatsnew/3.9.rst:416
msgid "inspect"
msgstr ""
#: whatsnew/3.9.rst:418
msgid ""
":attr:`inspect.BoundArguments.arguments` is changed from ``OrderedDict`` to "
"regular dict. (Contributed by Inada Naoki in :issue:`36350` and :issue:"
"`39775`.)"
msgstr ""
#: whatsnew/3.9.rst:422
msgid "ipaddress"
msgstr ""
#: whatsnew/3.9.rst:424
msgid ""
":mod:`ipaddress` now supports IPv6 Scoped Addresses (IPv6 address with "
"suffix ``%<scope_id>``)."
msgstr ""
#: whatsnew/3.9.rst:426
msgid ""
"Scoped IPv6 addresses can be parsed using :class:`ipaddress.IPv6Address`. If "
"present, scope zone ID is available through the :attr:`~ipaddress."
"IPv6Address.scope_id` attribute. (Contributed by Oleksandr Pavliuk in :issue:"
"`34788`.)"
msgstr ""
#: whatsnew/3.9.rst:431
msgid "math"
msgstr ""
#: whatsnew/3.9.rst:433
msgid ""
"Expanded the :func:`math.gcd` function to handle multiple arguments. "
"Formerly, it only supported two arguments. (Contributed by Serhiy Storchaka "
"in :issue:`39648`.)"
msgstr ""
#: whatsnew/3.9.rst:437
msgid ""
"Add :func:`math.lcm`: return the least common multiple of specified "
"arguments. (Contributed by Mark Dickinson, Ananthakrishnan and Serhiy "
"Storchaka in :issue:`39479` and :issue:`39648`.)"
msgstr ""
#: whatsnew/3.9.rst:441
msgid ""
"Add :func:`math.nextafter`: return the next floating-point value after *x* "
"towards *y*. (Contributed by Victor Stinner in :issue:`39288`.)"
msgstr ""
#: whatsnew/3.9.rst:445
msgid ""
"Add :func:`math.ulp`: return the value of the least significant bit of a "
"float. (Contributed by Victor Stinner in :issue:`39310`.)"
msgstr ""
#: whatsnew/3.9.rst:450
msgid "multiprocessing"
msgstr "multiprocessing"
#: whatsnew/3.9.rst:452
msgid ""
"The :class:`multiprocessing.SimpleQueue` class has a new :meth:"
"`~multiprocessing.SimpleQueue.close` method to explicitly close the queue. "
"(Contributed by Victor Stinner in :issue:`30966`.)"
msgstr ""
#: whatsnew/3.9.rst:458
msgid "nntplib"
msgstr ""
#: whatsnew/3.9.rst:460
msgid ""
":class:`~nntplib.NNTP` and :class:`~nntplib.NNTP_SSL` now raise a :class:"
"`ValueError` if the given timeout for their constructor is zero to prevent "
"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:"
"`39259`.)"
msgstr ""
#: whatsnew/3.9.rst:465
msgid "os"
msgstr ""
#: whatsnew/3.9.rst:467
msgid ""
"Added :data:`~os.CLD_KILLED` and :data:`~os.CLD_STOPPED` for :attr:"
"`si_code`. (Contributed by Dong-hee Na in :issue:`38493`.)"
msgstr ""
#: whatsnew/3.9.rst:470
msgid ""
"Exposed the Linux-specific :func:`os.pidfd_open` (:issue:`38692`) and :data:"
"`os.P_PIDFD` (:issue:`38713`) for process management with file descriptors."
msgstr ""
#: whatsnew/3.9.rst:474
msgid ""
"The :func:`os.unsetenv` function is now also available on Windows. "
"(Contributed by Victor Stinner in :issue:`39413`.)"
msgstr ""
#: whatsnew/3.9.rst:477
msgid ""
"The :func:`os.putenv` and :func:`os.unsetenv` functions are now always "
"available. (Contributed by Victor Stinner in :issue:`39395`.)"
msgstr ""
#: whatsnew/3.9.rst:481
msgid ""
"Add :func:`os.waitstatus_to_exitcode` function: convert a wait status to an "
"exit code. (Contributed by Victor Stinner in :issue:`40094`.)"
msgstr ""
#: whatsnew/3.9.rst:486
msgid "pathlib"
msgstr "pathlib"
#: whatsnew/3.9.rst:488
msgid ""
"Added :meth:`pathlib.Path.readlink()` which acts similarly to :func:`os."
"readlink`. (Contributed by Girts Folkmanis in :issue:`30618`)"
msgstr ""
#: whatsnew/3.9.rst:493
msgid "poplib"
msgstr ""
#: whatsnew/3.9.rst:495
msgid ""
":class:`~poplib.POP3` and :class:`~poplib.POP3_SSL` now raise a :class:"
"`ValueError` if the given timeout for their constructor is zero to prevent "
"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:"
"`39259`.)"
msgstr ""
#: whatsnew/3.9.rst:500
msgid "pprint"
msgstr ""
#: whatsnew/3.9.rst:502
msgid ""
":mod:`pprint` can now pretty-print :class:`types.SimpleNamespace`. "
"(Contributed by Carl Bordum Hansen in :issue:`37376`.)"
msgstr ""
#: whatsnew/3.9.rst:506
msgid "pydoc"
msgstr ""
#: whatsnew/3.9.rst:508
msgid ""
"The documentation string is now shown not only for class, function, method "
"etc, but for any object that has its own ``__doc__`` attribute. (Contributed "
"by Serhiy Storchaka in :issue:`40257`.)"
msgstr ""
#: whatsnew/3.9.rst:513
msgid "random"
msgstr ""
#: whatsnew/3.9.rst:515
msgid ""
"Add a new :attr:`random.Random.randbytes` method: generate random bytes. "
"(Contributed by Victor Stinner in :issue:`40286`.)"
msgstr ""
#: whatsnew/3.9.rst:519
msgid "signal"
msgstr ""
#: whatsnew/3.9.rst:521
msgid ""
"Exposed the Linux-specific :func:`signal.pidfd_send_signal` for sending to "
"signals to a process using a file descriptor instead of a pid. (:issue:"
"`38712`)"
msgstr ""
#: whatsnew/3.9.rst:525
msgid "smtplib"
msgstr ""
#: whatsnew/3.9.rst:527
msgid ""
":class:`~smtplib.SMTP` and :class:`~smtplib.SMTP_SSL` now raise a :class:"
"`ValueError` if the given timeout for their constructor is zero to prevent "
"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:"
"`39259`.)"
msgstr ""
#: whatsnew/3.9.rst:531
msgid ""
":class:`~smtplib.LMTP` constructor now has an optional *timeout* parameter. "
"(Contributed by Dong-hee Na in :issue:`39329`.)"
msgstr ""
#: whatsnew/3.9.rst:535
msgid "socket"
msgstr ""
#: whatsnew/3.9.rst:537
msgid ""
"The :mod:`socket` module now exports the :data:`~socket."
"CAN_RAW_JOIN_FILTERS` constant on Linux 4.1 and greater. (Contributed by "
"Stefan Tatschner and Zackery Spytz in :issue:`25780`.)"
msgstr ""
#: whatsnew/3.9.rst:541
msgid ""
"The socket module now supports the :data:`~socket.CAN_J1939` protocol on "
"platforms that support it. (Contributed by Karl Ding in :issue:`40291`.)"
msgstr ""
#: whatsnew/3.9.rst:545
msgid "time"
msgstr "time"
#: whatsnew/3.9.rst:547
msgid ""
"On AIX, :func:`~time.thread_time` is now implemented with "
"``thread_cputime()`` which has nanosecond resolution, rather than "
"``clock_gettime(CLOCK_THREAD_CPUTIME_ID)`` which has a resolution of 10 ms. "
"(Contributed by Batuhan Taskaya in :issue:`40192`)"
msgstr ""
#: whatsnew/3.9.rst:553
msgid "sys"
msgstr "sys"
#: whatsnew/3.9.rst:555
msgid ""
"Add a new :attr:`sys.platlibdir` attribute: name of the platform-specific "
"library directory. It is used to build the path of standard library and the "
"paths of installed extension modules. It is equal to ``\"lib\"`` on most "
"platforms. On Fedora and SuSE, it is equal to ``\"lib64\"`` on 64-bit "
"platforms. (Contributed by Jan Matějek, Matěj Cepl, Charalampos Stratakis "
"and Victor Stinner in :issue:`1294959`.)"
msgstr ""
#: whatsnew/3.9.rst:561
msgid ""
"Previously, :attr:`sys.stderr` was block-buffered when non-interactive. Now "
"``stderr`` defaults to always being line-buffered. (Contributed by Jendrik "
"Seipp in :issue:`13601`.)"
msgstr ""
#: whatsnew/3.9.rst:566
msgid "tracemalloc"
msgstr ""
#: whatsnew/3.9.rst:568
msgid ""
"Added :func:`tracemalloc.reset_peak` to set the peak size of traced memory "
"blocks to the current size, to measure the peak of specific pieces of code. "
"(Contributed by Huon Wilson in :issue:`40630`.)"
msgstr ""
#: whatsnew/3.9.rst:573
msgid "typing"
msgstr ""
#: whatsnew/3.9.rst:575
msgid ""
":pep:`593` introduced an :data:`typing.Annotated` type to decorate existing "
"types with context-specific metadata and new ``include_extras`` parameter "
"to :func:`typing.get_type_hints` to access the metadata at runtime. "
"(Contributed by Till Varoquaux and Konstantin Kashin.)"
msgstr ""
#: whatsnew/3.9.rst:581
msgid "unicodedata"
msgstr "unicodedata"
#: whatsnew/3.9.rst:583
msgid ""
"The Unicode database has been updated to version 13.0.0. (:issue:`39926`)."
msgstr ""
#: whatsnew/3.9.rst:586
msgid "venv"
msgstr "venv"
#: whatsnew/3.9.rst:588
msgid ""
"The activation scripts provided by :mod:`venv` now all specify their prompt "
"customization consistently by always using the value specified by "
"``__VENV_PROMPT__``. Previously some scripts unconditionally used "
"``__VENV_PROMPT__``, others only if it happened to be set (which was the "
"default case), and one used ``__VENV_NAME__`` instead. (Contributed by Brett "
"Cannon in :issue:`37663`.)"
msgstr ""
#: whatsnew/3.9.rst:596
msgid "xml"
msgstr ""
#: whatsnew/3.9.rst:598
msgid ""
"White space characters within attributes are now preserved when serializing :"
"mod:`xml.etree.ElementTree` to XML file. EOLNs are no longer normalized to "
"\"\\n\". This is the result of discussion about how to interpret section "
"2.11 of XML spec. (Contributed by Mefistotelis in :issue:`39011`.)"
msgstr ""
#: whatsnew/3.9.rst:606
msgid "Optimizations"
msgstr ""
#: whatsnew/3.9.rst:608
msgid ""
"Optimized the idiom for assignment a temporary variable in comprehensions. "
"Now ``for y in [expr]`` in comprehensions is as fast as a simple assignment "
"``y = expr``. For example:"
msgstr ""
#: whatsnew/3.9.rst:612
msgid "sums = [s for s in [0] for x in data for s in [s + x]]"
msgstr ""
#: whatsnew/3.9.rst:614
msgid ""
"Unlike the ``:=`` operator this idiom does not leak a variable to the outer "
"scope."
msgstr ""
#: whatsnew/3.9.rst:617
msgid "(Contributed by Serhiy Storchaka in :issue:`32856`.)"
msgstr ""
#: whatsnew/3.9.rst:619
msgid ""
"Optimize signal handling in multithreaded applications. If a thread "
"different than the main thread gets a signal, the bytecode evaluation loop "
"is no longer interrupted at each bytecode instruction to check for pending "
"signals which cannot be handled. Only the main thread of the main "
"interpreter can handle signals."
msgstr ""
#: whatsnew/3.9.rst:625
msgid ""
"Previously, the bytecode evaluation loop was interrupted at each instruction "
"until the main thread handles signals. (Contributed by Victor Stinner in :"
"issue:`40010`.)"
msgstr ""
#: whatsnew/3.9.rst:629
msgid ""
"Optimize the :mod:`subprocess` module on FreeBSD using ``closefrom()``. "
"(Contributed by Ed Maste, Conrad Meyer, Kyle Evans, Kubilay Kocak and Victor "
"Stinner in :issue:`38061`.)"
msgstr ""
#: whatsnew/3.9.rst:633
msgid ""
"Here's a summary of performance improvements from Python 3.4 through Python "
"3.9:"
msgstr ""
#: whatsnew/3.9.rst:680
msgid ""
"These results were generated from the variable access benchmark script at: "
"``Tools/scripts/var_access_benchmark.py``. The benchmark script displays "
"timings in nanoseconds. The benchmarks were measured on an `Intel® Core™ "
"i7-4960HQ processor <https://ark.intel.com/content/www/us/en/ark/"
"products/76088/intel-core-i7-4960hq-processor-6m-cache-up-to-3-80-ghz."
"html>`_ running the macOS 64-bit builds found at `python.org <https://www."
"python.org/downloads/mac-osx/>`_."
msgstr ""
#: whatsnew/3.9.rst:688
msgid ""
"A number of Python builtins (:class:`range`, :class:`tuple`, :class:`set`, :"
"class:`frozenset`, :class:`list`, :class:`dict`) are now sped up by using :"
"pep:`590` vectorcall protocol. (Contributed by Dong-hee Na, Mark Shannon, "
"Jeroen Demeyer and Petr Viktorin in :issue:`37207`.)"
msgstr ""
#: whatsnew/3.9.rst:694
msgid "Deprecated"
msgstr ""
#: whatsnew/3.9.rst:696
msgid ""
"The distutils ``bdist_msi`` command is now deprecated, use ``bdist_wheel`` "
"(wheel packages) instead. (Contributed by Hugo van Kemenade in :issue:"
"`39586`.)"
msgstr ""
#: whatsnew/3.9.rst:700
msgid ""
"Currently :func:`math.factorial` accepts :class:`float` instances with non-"
"negative integer values (like ``5.0``). It raises a :exc:`ValueError` for "
"non-integral and negative floats. It is now deprecated. In future Python "
"versions it will raise a :exc:`TypeError` for all floats. (Contributed by "
"Serhiy Storchaka in :issue:`37315`.)"
msgstr ""
#: whatsnew/3.9.rst:706
msgid ""
"The :mod:`parser` and :mod:`symbol` modules are deprecated and will be "
"removed in future versions of Python. For the majority of use cases, users "
"can leverage the Abstract Syntax Tree (AST) generation and compilation "
"stage, using the :mod:`ast` module."
msgstr ""
#: whatsnew/3.9.rst:711
msgid ""
"The Public C API functions :c:func:`PyParser_SimpleParseStringFlags`, :c:"
"func:`PyParser_SimpleParseStringFlagsFilename`, :c:func:"
"`PyParser_SimpleParseFileFlags` and :c:func:`PyNode_Compile` are deprecated "
"and will be removed in Python 3.10 together with the old parser."
msgstr ""
#: whatsnew/3.9.rst:716
msgid ""
"Using :data:`NotImplemented` in a boolean context has been deprecated, as it "
"is almost exclusively the result of incorrect rich comparator "
"implementations. It will be made a :exc:`TypeError` in a future version of "
"Python. (Contributed by Josh Rosenberg in :issue:`35712`.)"
msgstr ""
#: whatsnew/3.9.rst:722
msgid ""
"The :mod:`random` module currently accepts any hashable type as a possible "
"seed value. Unfortunately, some of those types are not guaranteed to have a "
"deterministic hash value. After Python 3.9, the module will restrict its "
"seeds to :const:`None`, :class:`int`, :class:`float`, :class:`str`, :class:"
"`bytes`, and :class:`bytearray`."
msgstr ""
#: whatsnew/3.9.rst:728
msgid ""
"Opening the :class:`~gzip.GzipFile` file for writing without specifying the "
"*mode* argument is deprecated. In future Python versions it will always be "
"opened for reading by default. Specify the *mode* argument for opening it "
"for writing and silencing a warning. (Contributed by Serhiy Storchaka in :"
"issue:`28286`.)"
msgstr ""
#: whatsnew/3.9.rst:734
msgid ""
"Deprecated the ``split()`` method of :class:`_tkinter.TkappType` in favour "
"of the ``splitlist()`` method which has more consistent and predicable "
"behavior. (Contributed by Serhiy Storchaka in :issue:`38371`.)"
msgstr ""
#: whatsnew/3.9.rst:739
msgid ""
"The explicit passing of coroutine objects to :func:`asyncio.wait` has been "
"deprecated and will be removed in version 3.11. (Contributed by Yury "
"Selivanov and Kyle Stanley in :issue:`34790`.)"
msgstr ""
#: whatsnew/3.9.rst:743
msgid ""
"binhex4 and hexbin4 standards are now deprecated. The :mod:`binhex` module "
"and the following :mod:`binascii` functions are now deprecated:"
msgstr ""
#: whatsnew/3.9.rst:746
msgid ":func:`~binascii.b2a_hqx`, :func:`~binascii.a2b_hqx`"
msgstr ""
#: whatsnew/3.9.rst:747
msgid ":func:`~binascii.rlecode_hqx`, :func:`~binascii.rledecode_hqx`"
msgstr ""
#: whatsnew/3.9.rst:749
msgid "(Contributed by Victor Stinner in :issue:`39353`.)"
msgstr ""
#: whatsnew/3.9.rst:751
msgid ""
":mod:`ast` classes ``slice``, ``Index`` and ``ExtSlice`` are considered "
"deprecated and will be removed in future Python versions. ``value`` itself "
"should be used instead of ``Index(value)``. ``Tuple(slices, Load())`` "
"should be used instead of ``ExtSlice(slices)``. (Contributed by Serhiy "
"Storchaka in :issue:`32892`.)"
msgstr ""
#: whatsnew/3.9.rst:757
msgid ""
":mod:`ast` classes ``Suite``, ``Param``, ``AugLoad`` and ``AugStore`` are "
"considered deprecated and will be removed in future Python versions. They "
"were not generated by the parser and not accepted by the code generator in "
"Python 3. (Contributed by Batuhan Taskaya in :issue:`39639` and :issue:"
"`39969` and Serhiy Storchaka in :issue:`39988`.)"
msgstr ""
#: whatsnew/3.9.rst:764
msgid ""
"The :c:func:`PyEval_InitThreads` and :c:func:`PyEval_ThreadsInitialized` "
"functions are now deprecated and will be removed in Python 3.11. Calling :c:"
"func:`PyEval_InitThreads` now does nothing. The :term:`GIL` is initialized "
"by :c:func:`Py_Initialize()` since Python 3.7. (Contributed by Victor "
"Stinner in :issue:`39877`.)"
msgstr ""
#: whatsnew/3.9.rst:770
msgid ""
"Passing ``None`` as the first argument to the :func:`shlex.split` function "
"has been deprecated. (Contributed by Zackery Spytz in :issue:`33262`.)"
msgstr ""
#: whatsnew/3.9.rst:773
msgid ""
"The :mod:`lib2to3` module now emits a :exc:`PendingDeprecationWarning`. "
"Python 3.9 switched to a PEG parser (see :pep:`617`), and Python 3.10 may "
"include new language syntax that is not parsable by lib2to3's LL(1) parser. "
"The ``lib2to3`` module may be removed from the standard library in a future "
"Python version. Consider third-party alternatives such as `LibCST`_ or "
"`parso`_. (Contributed by Carl Meyer in :issue:`40360`.)"
msgstr ""
#: whatsnew/3.9.rst:781
msgid ""
"The *random* parameter of :func:`random.shuffle` has been deprecated. "
"(Contributed by Raymond Hettinger in :issue:`40465`)"
msgstr ""
#: whatsnew/3.9.rst:788 whatsnew/3.9.rst:1129
msgid "Removed"
msgstr ""
#: whatsnew/3.9.rst:790
msgid ""
"The erroneous version at :data:`unittest.mock.__version__` has been removed."
msgstr ""
#: whatsnew/3.9.rst:792
msgid ""
":class:`nntplib.NNTP`: ``xpath()`` and ``xgtitle()`` methods have been "
"removed. These methods are deprecated since Python 3.3. Generally, these "
"extensions are not supported or not enabled by NNTP server administrators. "
"For ``xgtitle()``, please use :meth:`nntplib.NNTP.descriptions` or :meth:"
"`nntplib.NNTP.description` instead. (Contributed by Dong-hee Na in :issue:"
"`39366`.)"
msgstr ""
#: whatsnew/3.9.rst:799
msgid ""
":class:`array.array`: ``tostring()`` and ``fromstring()`` methods have been "
"removed. They were aliases to ``tobytes()`` and ``frombytes()``, deprecated "
"since Python 3.2. (Contributed by Victor Stinner in :issue:`38916`.)"
msgstr ""
#: whatsnew/3.9.rst:804
msgid ""
"The undocumented ``sys.callstats()`` function has been removed. Since Python "
"3.7, it was deprecated and always returned :const:`None`. It required a "
"special build option ``CALL_PROFILE`` which was already removed in Python "
"3.7. (Contributed by Victor Stinner in :issue:`37414`.)"
msgstr ""
#: whatsnew/3.9.rst:809
msgid ""
"The ``sys.getcheckinterval()`` and ``sys.setcheckinterval()`` functions have "
"been removed. They were deprecated since Python 3.2. Use :func:`sys."
"getswitchinterval` and :func:`sys.setswitchinterval` instead. (Contributed "
"by Victor Stinner in :issue:`37392`.)"
msgstr ""
#: whatsnew/3.9.rst:814
msgid ""
"The C function ``PyImport_Cleanup()`` has been removed. It was documented "
"as: \"Empty the module table. For internal use only.\" (Contributed by "
"Victor Stinner in :issue:`36710`.)"
msgstr ""
#: whatsnew/3.9.rst:818
msgid ""
"``_dummy_thread`` and ``dummy_threading`` modules have been removed. These "
"modules were deprecated since Python 3.7 which requires threading support. "
"(Contributed by Victor Stinner in :issue:`37312`.)"
msgstr ""
#: whatsnew/3.9.rst:822
msgid ""
"``aifc.openfp()`` alias to ``aifc.open()``, ``sunau.openfp()`` alias to "
"``sunau.open()``, and ``wave.openfp()`` alias to :func:`wave.open()` have "
"been removed. They were deprecated since Python 3.7. (Contributed by Victor "
"Stinner in :issue:`37320`.)"
msgstr ""
#: whatsnew/3.9.rst:827
msgid ""
"The :meth:`~threading.Thread.isAlive()` method of :class:`threading.Thread` "
"has been removed. It was deprecated since Python 3.8. Use :meth:`~threading."
"Thread.is_alive()` instead. (Contributed by Dong-hee Na in :issue:`37804`.)"
msgstr ""
#: whatsnew/3.9.rst:832
msgid ""
"Methods ``getchildren()`` and ``getiterator()`` of classes :class:`~xml."
"etree.ElementTree.ElementTree` and :class:`~xml.etree.ElementTree.Element` "
"in the :mod:`~xml.etree.ElementTree` module have been removed. They were "
"deprecated in Python 3.2. Use ``iter(x)`` or ``list(x)`` instead of ``x."
"getchildren()`` and ``x.iter()`` or ``list(x.iter())`` instead of ``x."
"getiterator()``. (Contributed by Serhiy Storchaka in :issue:`36543`.)"
msgstr ""
#: whatsnew/3.9.rst:840
msgid ""
"The old :mod:`plistlib` API has been removed, it was deprecated since Python "
"3.4. Use the :func:`~plistlib.load`, :func:`~plistlib.loads`, :func:"
"`~plistlib.dump`, and :func:`~plistlib.dumps` functions. Additionally, the "
"*use_builtin_types* parameter was removed, standard :class:`bytes` objects "
"are always used instead. (Contributed by Jon Janzen in :issue:`36409`.)"
msgstr ""
#: whatsnew/3.9.rst:846
msgid ""
"The C function ``PyGen_NeedsFinalizing`` has been removed. It was not "
"documented, tested, or used anywhere within CPython after the implementation "
"of :pep:`442`. Patch by Joannah Nanjekye. (Contributed by Joannah Nanjekye "
"in :issue:`15088`)"
msgstr ""
#: whatsnew/3.9.rst:851
msgid ""
"``base64.encodestring()`` and ``base64.decodestring()``, aliases deprecated "
"since Python 3.1, have been removed: use :func:`base64.encodebytes` and :"
"func:`base64.decodebytes` instead. (Contributed by Victor Stinner in :issue:"
"`39351`.)"
msgstr ""
#: whatsnew/3.9.rst:856
msgid ""
"``fractions.gcd()`` function has been removed, it was deprecated since "
"Python 3.5 (:issue:`22486`): use :func:`math.gcd` instead. (Contributed by "
"Victor Stinner in :issue:`39350`.)"
msgstr ""
#: whatsnew/3.9.rst:860
msgid ""
"The *buffering* parameter of :class:`bz2.BZ2File` has been removed. Since "
"Python 3.0, it was ignored and using it emitted a :exc:`DeprecationWarning`. "
"Pass an open file object to control how the file is opened. (Contributed by "
"Victor Stinner in :issue:`39357`.)"
msgstr ""
#: whatsnew/3.9.rst:865
msgid ""
"The *encoding* parameter of :func:`json.loads` has been removed. As of "
"Python 3.1, it was deprecated and ignored; using it has emitted a :exc:"
"`DeprecationWarning` since Python 3.8. (Contributed by Inada Naoki in :issue:"
"`39377`)"
msgstr ""
#: whatsnew/3.9.rst:870
msgid ""
"``with (await asyncio.lock):`` and ``with (yield from asyncio.lock):`` "
"statements are not longer supported, use ``async with lock`` instead. The "
"same is correct for ``asyncio.Condition`` and ``asyncio.Semaphore``. "
"(Contributed by Andrew Svetlov in :issue:`34793`.)"
msgstr ""
#: whatsnew/3.9.rst:875
msgid ""
"The :func:`sys.getcounts` function, the ``-X showalloccount`` command line "
"option and the ``show_alloc_count`` field of the C structure :c:type:"
"`PyConfig` have been removed. They required a special Python build by "
"defining ``COUNT_ALLOCS`` macro. (Contributed by Victor Stinner in :issue:"
"`39489`.)"
msgstr ""
#: whatsnew/3.9.rst:881
msgid ""
"The ``_field_types`` attribute of the :class:`typing.NamedTuple` class has "
"been removed. It was deprecated deprecated since Python 3.8. Use the "
"``__annotations__`` attribute instead. (Contributed by Serhiy Storchaka in :"
"issue:`40182`.)"
msgstr ""
#: whatsnew/3.9.rst:886
msgid ""
"The :meth:`symtable.SymbolTable.has_exec` method has been removed. It was "
"deprecated since 2006, and only returning ``False`` when it's called. "
"(Contributed by Batuhan Taskaya in :issue:`40208`)"
msgstr ""
#: whatsnew/3.9.rst:890
msgid ""
"The :meth:`asyncio.Task.current_task` and :meth:`asyncio.Task.all_tasks` "
"have have been removed. They were deprecated since Python 3.7 and you can "
"use :func:`asyncio.current_task` and :func:`asyncio.all_tasks` instead. "
"(Contributed by Rémi Lapeyre in :issue:`40967`)"
msgstr ""
#: whatsnew/3.9.rst:897 whatsnew/3.9.rst:1085
msgid "Porting to Python 3.9"
msgstr ""
#: whatsnew/3.9.rst:899
msgid ""
"This section lists previously described changes and other bugfixes that may "
"require changes to your code."
msgstr ""
#: whatsnew/3.9.rst:904
msgid "Changes in the Python API"
msgstr ""
#: whatsnew/3.9.rst:906
msgid ""
":func:`__import__` and :func:`importlib.util.resolve_name` now raise :exc:"
"`ImportError` where it previously raised :exc:`ValueError`. Callers catching "
"the specific exception type and supporting both Python 3.9 and earlier "
"versions will need to catch both using ``except (ImportError, ValueError):``."
msgstr ""
#: whatsnew/3.9.rst:911
msgid ""
"The :mod:`venv` activation scripts no longer special-case when "
"``__VENV_PROMPT__`` is set to ``\"\"``."
msgstr ""
#: whatsnew/3.9.rst:914
msgid ""
"The :meth:`select.epoll.unregister` method no longer ignores the :data:"
"`~errno.EBADF` error. (Contributed by Victor Stinner in :issue:`39239`.)"
msgstr ""
#: whatsnew/3.9.rst:918
msgid ""
"The *compresslevel* parameter of :class:`bz2.BZ2File` became keyword-only, "
"since the *buffering* parameter has been removed. (Contributed by Victor "
"Stinner in :issue:`39357`.)"
msgstr ""
#: whatsnew/3.9.rst:922
msgid ""
"Simplified AST for subscription. Simple indices will be represented by their "
"value, extended slices will be represented as tuples. ``Index(value)`` will "
"return a ``value`` itself, ``ExtSlice(slices)`` will return ``Tuple(slices, "
"Load())``. (Contributed by Serhiy Storchaka in :issue:`34822`.)"
msgstr ""
#: whatsnew/3.9.rst:928
msgid ""
"The :mod:`importlib` module now ignores the :envvar:`PYTHONCASEOK` "
"environment variable when the :option:`-E` or :option:`-I` command line "
"options are being used."
msgstr ""
#: whatsnew/3.9.rst:932
msgid ""
"The *encoding* parameter has been added to the classes :class:`ftplib.FTP` "
"and :class:`ftplib.FTP_TLS` as a keyword-only parameter, and the default "
"encoding is changed from Latin-1 to UTF-8 to follow :rfc:`2640`."
msgstr ""
#: whatsnew/3.9.rst:936
msgid ""
":meth:`asyncio.loop.shutdown_default_executor` has been added to :class:"
"`~asyncio.AbstractEventLoop`, meaning alternative event loops that inherit "
"from it should have this method defined. (Contributed by Kyle Stanley in :"
"issue:`34037`.)"
msgstr ""
#: whatsnew/3.9.rst:941
msgid ""
"The constant values of future flags in the :mod:`__future__` module is "
"updated in order to prevent collision with compiler flags. Previously "
"``PyCF_ALLOW_TOP_LEVEL_AWAIT`` was clashing with ``CO_FUTURE_DIVISION``. "
"(Contributed by Batuhan Taskaya in :issue:`39562`)"
msgstr ""
#: whatsnew/3.9.rst:946
msgid ""
"``array('u')`` now uses ``wchar_t`` as C type instead of ``Py_UNICODE``. "
"This change doesn't affect to its behavior because ``Py_UNICODE`` is alias "
"of ``wchar_t`` since Python 3.3. (Contributed by Inada Naoki in :issue:"
"`34538`.)"
msgstr ""
#: whatsnew/3.9.rst:953
msgid "Changes in the C API"
msgstr ""
#: whatsnew/3.9.rst:955
msgid ""
"Instances of heap-allocated types (such as those created with :c:func:"
"`PyType_FromSpec` and similar APIs) hold a reference to their type object "
"since Python 3.8. As indicated in the \"Changes in the C API\" of Python "
"3.8, for the vast majority of cases, there should be no side effect but for "
"types that have a custom :c:member:`~PyTypeObject.tp_traverse` function, "
"ensure that all custom ``tp_traverse`` functions of heap-allocated types "
"visit the object's type."
msgstr ""
#: whatsnew/3.9.rst:976
msgid ""
"If your traverse function delegates to ``tp_traverse`` of its base class (or "
"another type), ensure that ``Py_TYPE(self)`` is visited only once. Note that "
"only heap types are expected to visit the type in ``tp_traverse``."
msgstr ""
#: whatsnew/3.9.rst:980
msgid "For example, if your ``tp_traverse`` function includes:"
msgstr ""
#: whatsnew/3.9.rst:986
msgid "then add:"
msgstr ""
#: whatsnew/3.9.rst:999
msgid "(See :issue:`35810` and :issue:`40217` for more information.)"
msgstr ""
#: whatsnew/3.9.rst:1002
msgid "CPython bytecode changes"
msgstr ""
#: whatsnew/3.9.rst:1004
msgid ""
"The :opcode:`LOAD_ASSERTION_ERROR` opcode was added for handling the :"
"keyword:`assert` statement. Previously, the assert statement would not work "
"correctly if the :exc:`AssertionError` exception was being shadowed. "
"(Contributed by Zackery Spytz in :issue:`34880`.)"
msgstr ""
#: whatsnew/3.9.rst:1011
msgid "Build Changes"
msgstr ""
#: whatsnew/3.9.rst:1013
msgid ""
"Add ``--with-platlibdir`` option to the ``configure`` script: name of the "
"platform-specific library directory, stored in the new :attr:`sys."
"platlibdir` attribute. See :attr:`sys.platlibdir` attribute for more "
"information. (Contributed by Jan Matějek, Matěj Cepl, Charalampos Stratakis "
"and Victor Stinner in :issue:`1294959`.)"
msgstr ""
#: whatsnew/3.9.rst:1019
msgid ""
"The ``COUNT_ALLOCS`` special build macro has been removed. (Contributed by "
"Victor Stinner in :issue:`39489`.)"
msgstr ""
#: whatsnew/3.9.rst:1022
msgid ""
"On non-Windows platforms, the :c:func:`setenv` and :c:func:`unsetenv` "
"functions are now required to build Python. (Contributed by Victor Stinner "
"in :issue:`39395`.)"
msgstr ""
#: whatsnew/3.9.rst:1028
msgid "C API Changes"
msgstr ""
#: whatsnew/3.9.rst:1033
msgid ""
":pep:`573`: Add :c:func:`PyType_FromModuleAndSpec` to associate a module "
"with a class; :c:func:`PyType_GetModule` and :c:func:`PyType_GetModuleState` "
"to retrieve the module and its state; and :c:data:`PyCMethod` and :c:data:"
"`METH_METHOD` to allow a method to access the class it was defined in. "
"(Contributed by Marcel Plch and Petr Viktorin in :issue:`38787`.)"
msgstr ""
#: whatsnew/3.9.rst:1040
msgid ""
"Add :c:func:`PyFrame_GetCode` function: get a frame code. Add :c:func:"
"`PyFrame_GetBack` function: get the frame next outer frame. (Contributed by "
"Victor Stinner in :issue:`40421`.)"
msgstr ""
#: whatsnew/3.9.rst:1044
msgid ""
"Add :c:func:`PyFrame_GetLineNumber` to the limited C API. (Contributed by "
"Victor Stinner in :issue:`40421`.)"
msgstr ""
#: whatsnew/3.9.rst:1047
msgid ""
"Add :c:func:`PyThreadState_GetInterpreter` and :c:func:"
"`PyInterpreterState_Get` functions to get the interpreter. Add :c:func:"
"`PyThreadState_GetFrame` function to get the current frame of a Python "
"thread state. Add :c:func:`PyThreadState_GetID` function: get the unique "
"identifier of a Python thread state. (Contributed by Victor Stinner in :"
"issue:`39947`.)"
msgstr ""
#: whatsnew/3.9.rst:1055
msgid ""
"Add a new public :c:func:`PyObject_CallNoArgs` function to the C API, which "
"calls a callable Python object without any arguments. It is the most "
"efficient way to call a callable Python object without any argument. "
"(Contributed by Victor Stinner in :issue:`37194`.)"
msgstr ""
#: whatsnew/3.9.rst:1060 whatsnew/3.9.rst:1140
msgid "Changes in the limited C API (if ``Py_LIMITED_API`` macro is defined):"
msgstr ""
#: whatsnew/3.9.rst:1062
msgid ""
"Provide :c:func:`Py_EnterRecursiveCall` and :c:func:`Py_LeaveRecursiveCall` "
"as regular functions for the limited API. Previously, there were defined as "
"macros, but these macros didn't compile with the limited C API which cannot "
"access ``PyThreadState.recursion_depth`` field (the structure is opaque in "
"the limited C API)."
msgstr ""
#: whatsnew/3.9.rst:1068
msgid ""
"``PyObject_INIT()`` and ``PyObject_INIT_VAR()`` become regular \"opaque\" "
"function to hide implementation details."
msgstr ""
#: whatsnew/3.9.rst:1071 whatsnew/3.9.rst:1167
msgid "(Contributed by Victor Stinner in :issue:`38644` and :issue:`39542`.)"
msgstr ""
#: whatsnew/3.9.rst:1073
msgid ""
"The :c:func:`PyModule_AddType` function is added to help adding a type to a "
"module. (Contributed by Dong-hee Na in :issue:`40024`.)"
msgstr ""
#: whatsnew/3.9.rst:1077
msgid ""
"Add the functions :c:func:`PyObject_GC_IsTracked` and :c:func:"
"`PyObject_GC_IsFinalized` to the public API to allow to query if Python "
"objects are being currently tracked or have been already finalized by the "
"garbage collector respectively. (Contributed by Pablo Galindo in :issue:"
"`40241`.)"
msgstr ""
#: whatsnew/3.9.rst:1087
msgid ""
"``PyInterpreterState.eval_frame`` (:pep:`523`) now requires a new mandatory "
"*tstate* parameter (``PyThreadState*``). (Contributed by Victor Stinner in :"
"issue:`38500`.)"
msgstr ""
#: whatsnew/3.9.rst:1091
msgid ""
"Extension modules: :c:member:`~PyModuleDef.m_traverse`, :c:member:"
"`~PyModuleDef.m_clear` and :c:member:`~PyModuleDef.m_free` functions of :c:"
"type:`PyModuleDef` are no longer called if the module state was requested "
"but is not allocated yet. This is the case immediately after the module is "
"created and before the module is executed (:c:data:`Py_mod_exec` function). "
"More precisely, these functions are not called if :c:member:`~PyModuleDef."
"m_size` is greater than 0 and the module state (as returned by :c:func:"
"`PyModule_GetState`) is ``NULL``."
msgstr ""
#: whatsnew/3.9.rst:1100
msgid ""
"Extension modules without module state (``m_size <= 0``) are not affected."
msgstr ""
#: whatsnew/3.9.rst:1102
msgid ""
"If :c:func:`Py_AddPendingCall` is called in a subinterpreter, the function "
"is now scheduled to be called from the subinterpreter, rather than being "
"called from the main interpreter. Each subinterpreter now has its own list "
"of scheduled calls. (Contributed by Victor Stinner in :issue:`39984`.)"
msgstr ""
#: whatsnew/3.9.rst:1108
msgid ""
"The Windows registry is no longer used to initialize :data:`sys.path` when "
"the ``-E`` option is used (if :c:member:`PyConfig.use_environment` is set to "
"``0``). This is significant when embedding Python on Windows. (Contributed "
"by Zackery Spytz in :issue:`8901`.)"
msgstr ""
#: whatsnew/3.9.rst:1113
msgid ""
"The global variable :c:data:`PyStructSequence_UnnamedField` is now a "
"constant and refers to a constant string. (Contributed by Serhiy Storchaka "
"in :issue:`38650`.)"
msgstr ""
#: whatsnew/3.9.rst:1117
msgid ""
"The :c:type:`PyGC_Head` structure is now opaque. It is only defined in the "
"internal C API (``pycore_gc.h``). (Contributed by Victor Stinner in :issue:"
"`40241`.)"
msgstr ""
#: whatsnew/3.9.rst:1121
msgid ""
"The ``Py_UNICODE_COPY``, ``Py_UNICODE_FILL``, ``PyUnicode_WSTR_LENGTH``, :c:"
"func:`PyUnicode_FromUnicode`, :c:func:`PyUnicode_AsUnicode`, "
"``_PyUnicode_AsUnicode``, and :c:func:`PyUnicode_AsUnicodeAndSize` are "
"marked as deprecated in C. They have been deprecated by :pep:`393` since "
"Python 3.3. (Contributed by Inada Naoki in :issue:`36346`.)"
msgstr ""
#: whatsnew/3.9.rst:1131
msgid ""
"Exclude ``PyFPE_START_PROTECT()`` and ``PyFPE_END_PROTECT()`` macros of "
"``pyfpe.h`` from the limited C API. (Contributed by Victor Stinner in :issue:"
"`38835`.)"
msgstr ""
#: whatsnew/3.9.rst:1135
msgid ""
"The ``tp_print`` slot of :ref:`PyTypeObject <type-structs>` has been "
"removed. It was used for printing objects to files in Python 2.7 and before. "
"Since Python 3.0, it has been ignored and unused. (Contributed by Jeroen "
"Demeyer in :issue:`36974`.)"
msgstr ""
#: whatsnew/3.9.rst:1142
msgid "Exclude the following functions from the limited C API:"
msgstr ""
#: whatsnew/3.9.rst:1144
msgid ""
"``PyThreadState_DeleteCurrent()`` (Contributed by Joannah Nanjekye in :issue:"
"`37878`.)"
msgstr ""
#: whatsnew/3.9.rst:1146
msgid "``_Py_CheckRecursionLimit``"
msgstr ""
#: whatsnew/3.9.rst:1147
msgid "``_Py_NewReference()``"
msgstr ""
#: whatsnew/3.9.rst:1148
msgid "``_Py_ForgetReference()``"
msgstr ""
#: whatsnew/3.9.rst:1149
msgid "``_PyTraceMalloc_NewReference()``"
msgstr ""
#: whatsnew/3.9.rst:1150
msgid "``_Py_GetRefTotal()``"
msgstr ""
#: whatsnew/3.9.rst:1151
msgid "The trashcan mechanism which never worked in the limited C API."
msgstr ""
#: whatsnew/3.9.rst:1152
msgid "``PyTrash_UNWIND_LEVEL``"
msgstr ""
#: whatsnew/3.9.rst:1153
msgid "``Py_TRASHCAN_BEGIN_CONDITION``"
msgstr ""
#: whatsnew/3.9.rst:1154
msgid "``Py_TRASHCAN_BEGIN``"
msgstr ""
#: whatsnew/3.9.rst:1155
msgid "``Py_TRASHCAN_END``"
msgstr ""
#: whatsnew/3.9.rst:1156
msgid "``Py_TRASHCAN_SAFE_BEGIN``"
msgstr ""
#: whatsnew/3.9.rst:1157
msgid "``Py_TRASHCAN_SAFE_END``"
msgstr ""
#: whatsnew/3.9.rst:1159
msgid "Move following functions and definitions to the internal C API:"
msgstr ""
#: whatsnew/3.9.rst:1161
msgid "``_PyDebug_PrintTotalRefs()``"
msgstr ""
#: whatsnew/3.9.rst:1162
msgid "``_Py_PrintReferences()``"
msgstr ""
#: whatsnew/3.9.rst:1163
msgid "``_Py_PrintReferenceAddresses()``"
msgstr ""
#: whatsnew/3.9.rst:1164
msgid "``_Py_tracemalloc_config``"
msgstr ""
#: whatsnew/3.9.rst:1165
msgid "``_Py_AddToAllObjects()`` (specific to ``Py_TRACE_REFS`` build)"
msgstr ""
#: whatsnew/3.9.rst:1169
msgid ""
"Remove ``_PyRuntime.getframe`` hook and remove ``_PyThreadState_GetFrame`` "
"macro which was an alias to ``_PyRuntime.getframe``. They were only exposed "
"by the internal C API. Remove also ``PyThreadFrameGetter`` type. "
"(Contributed by Victor Stinner in :issue:`39946`.)"
msgstr ""
#: whatsnew/3.9.rst:1174
msgid ""
"Remove the following functions from the C API. Call :c:func:`PyGC_Collect` "
"explicitly to clear all free lists. (Contributed by Inada Naoki and Victor "
"Stinner in :issue:`37340`, :issue:`38896` and :issue:`40428`.)"
msgstr ""
#: whatsnew/3.9.rst:1179
msgid "``PyAsyncGen_ClearFreeLists()``"
msgstr ""
#: whatsnew/3.9.rst:1180
msgid "``PyContext_ClearFreeList()``"
msgstr ""
#: whatsnew/3.9.rst:1181
msgid "``PyDict_ClearFreeList()``"
msgstr ""
#: whatsnew/3.9.rst:1182
msgid "``PyFloat_ClearFreeList()``"
msgstr ""
#: whatsnew/3.9.rst:1183
msgid "``PyFrame_ClearFreeList()``"
msgstr ""
#: whatsnew/3.9.rst:1184
msgid "``PyList_ClearFreeList()``"
msgstr ""
#: whatsnew/3.9.rst:1185
msgid ""
"``PyMethod_ClearFreeList()`` and ``PyCFunction_ClearFreeList()``: the free "
"lists of bound method objects have been removed."
msgstr ""
#: whatsnew/3.9.rst:1187
msgid ""
"``PySet_ClearFreeList()``: the set free list has been removed in Python 3.4."
msgstr ""
#: whatsnew/3.9.rst:1189
msgid "``PyTuple_ClearFreeList()``"
msgstr ""
#: whatsnew/3.9.rst:1190
msgid ""
"``PyUnicode_ClearFreeList()``: the Unicode free list has been removed in "
"Python 3.3."
msgstr ""
#: whatsnew/3.9.rst:1193
msgid ""
"Remove ``_PyUnicode_ClearStaticStrings()`` function. (Contributed by Victor "
"Stinner in :issue:`39465`.)"
msgstr ""
#: whatsnew/3.9.rst:1196
msgid ""
"Remove ``Py_UNICODE_MATCH``. It has been deprecated by :pep:`393`, and "
"broken since Python 3.3. The :c:func:`PyUnicode_Tailmatch` function can be "
"used instead. (Contributed by Inada Naoki in :issue:`36346`.)"
msgstr ""