python-docs-fr/whatsnew/3.8.po

2923 lines
98 KiB
Plaintext
Raw Normal View History

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
2019-09-04 09:39:22 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2019-09-04 09:39:22 +00:00
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-01-15 22:33+0100\n"
"PO-Revision-Date: 2019-09-04 11:41+0200\n"
"Last-Translator: Fred-si <fred-si@zacly.net>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
2019-09-04 09:39:22 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: whatsnew/3.8.rst:3
2019-09-04 09:39:22 +00:00
msgid "What's New In Python 3.8"
msgstr "Nouveautés de Python 3.8"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:0
2019-09-04 09:39:22 +00:00
msgid "Editor"
msgstr "Rédacteur"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:45
2019-09-04 09:39:22 +00:00
msgid "Raymond Hettinger"
2019-09-16 10:08:42 +00:00
msgstr "Raymond Hettinger"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:47
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid ""
"This article explains the new features in Python 3.8, compared to 3.7. "
"Python 3.8 was released on October 14, 2019. For full details, see the :ref:"
"`changelog <changelog>`."
2019-09-04 09:39:22 +00:00
msgstr ""
"Cet article présente les nouvelles fonctionnalités de python 3.8 par rapport "
"à python 3.7. Pour le détail complet des changements voir le :ref:`journal "
"des modifications <changelog>`."
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:61
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Summary -- Release highlights"
msgstr "Résumé"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:72
2019-09-04 09:39:22 +00:00
msgid "New Features"
2019-09-16 10:08:42 +00:00
msgstr "Nouvelles fonctionnalités"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:75
2019-09-04 09:39:22 +00:00
msgid "Assignment expressions"
2020-02-14 10:18:53 +00:00
msgstr "Expression d'affectation"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:77
2019-09-04 09:39:22 +00:00
msgid ""
"There is new syntax ``:=`` that assigns values to variables as part of a "
"larger expression. It is affectionately known as \"the walrus operator\" due "
"to its resemblance to `the eyes and tusks of a walrus <https://en.wikipedia."
"org/wiki/Walrus#/media/File:Pacific_Walrus_-_Bull_(8247646168).jpg>`_."
2019-09-04 09:39:22 +00:00
msgstr ""
"La nouvelle syntaxe ``:=`` affecte une valeur à une variable au sein dune "
"expression plus large. Cette syntaxe est surnommée affectueusement "
 opérateur morse » (*walrus operator* en anglais) en raison de sa "
"ressemblance avec `les yeux et les défenses dun morse <https://en.wikipedia."
"org/wiki/Walrus#/media/File:Pacific_Walrus_-_Bull_(8247646168).jpg>`_."
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:82
2019-09-04 09:39:22 +00:00
msgid ""
"In this example, the assignment expression helps avoid calling :func:`len` "
"twice::"
msgstr ""
"Dans cet exemple, lopérateur daffectation permet de ne pas appeler :func:"
"`len` deux fois ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:88
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid ""
"A similar benefit arises during regular expression matching where match "
"objects are needed twice, once to test whether a match occurred and another "
"to extract a subgroup::"
msgstr ""
"Lintérêt est similaire lorsque lon cherche des correspondances sur des "
"expressions rationnelles et que lobjet de correspondance doit être appelé "
"deux fois, une fois pour tester si le motif a été trouvé et une autre pour "
"extraire le sous-groupe ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:96
2019-09-04 09:39:22 +00:00
msgid ""
"The operator is also useful with while-loops that compute a value to test "
"loop termination and then need that same value again in the body of the "
"loop::"
msgstr ""
"Lopérateur est également utile avec une boucle *while* qui calcule une "
"valeur pour tester la condition de fin et que cette valeur est également "
"nécessaire dans le corps de la boucle ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:104
2019-09-04 09:39:22 +00:00
msgid ""
"Another motivating use case arises in list comprehensions where a value "
"computed in a filtering condition is also needed in the expression body::"
msgstr ""
"Un autre usage intéressant est lutilisation dans les compréhensions de "
"listes lorsquune valeur calculée dans une condition de filtrage est aussi "
"utilisée dans le corps de lexpression ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:111
2019-09-04 09:39:22 +00:00
msgid ""
"Try to limit use of the walrus operator to clean cases that reduce "
"complexity and improve readability."
msgstr ""
"Essayer de limiter lusage de lopérateur morse aux cas clairs permet de "
"réduire la complexité et augmente la lisibilité."
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:114
2019-09-04 09:39:22 +00:00
msgid "See :pep:`572` for a full description."
msgstr "Voir :pep:`572` pour une description complète."
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:116
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Emily Morehouse in :issue:`35224`.)"
msgstr ""
#: whatsnew/3.8.rst:120
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Positional-only parameters"
msgstr "Paramètres uniquement positionnels"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:122
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid ""
"There is a new function parameter syntax ``/`` to indicate that some "
"function parameters must be specified positionally and cannot be used as "
"keyword arguments. This is the same notation shown by ``help()`` for C "
"functions annotated with Larry Hastings' :ref:`Argument Clinic <howto-"
"clinic>` tool."
2019-09-04 09:39:22 +00:00
msgstr ""
"La nouvelle syntaxe ``/`` pour les paramètres de fonction permet dindiquer "
"que certains paramètres de fonction sont uniquement positionnels et ne "
"peuvent pas être utilisés comme des arguments nommés. Cette notation est la "
"même que celle affichée par ``help()`` pour les fonctions C annotées avec "
"loutil `Argument Clinic <https://docs.python..org/3/howto/clinic.html>`_ de "
"Larry Hastings."
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:128
2019-09-04 09:39:22 +00:00
msgid ""
"In the following example, parameters *a* and *b* are positional-only, while "
"*c* or *d* can be positional or keyword, and *e* or *f* are required to be "
"keywords::"
msgstr ""
"Dans lexemple suivant, les paramètres *a* et *b* sont uniquement "
"positionnels alors que *c* et *d* peuvent être positionnels ou nommés tandis "
"que *e* et *f* doivent être obligatoirement nommés ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:135
2019-09-04 09:39:22 +00:00
msgid "The following is a valid call::"
msgstr "Lappel suivant est valide ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:139
2019-09-04 09:39:22 +00:00
msgid "However, these are invalid calls::"
msgstr "En revanche, celui-ci ne lest pas ::"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:144
2019-09-04 09:39:22 +00:00
msgid ""
"One use case for this notation is that it allows pure Python functions to "
"fully emulate behaviors of existing C coded functions. For example, the "
2020-05-24 14:31:50 +00:00
"built-in :func:`divmod` function does not accept keyword arguments::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:152
2019-09-04 09:39:22 +00:00
msgid ""
"Another use case is to preclude keyword arguments when the parameter name is "
"not helpful. For example, the builtin :func:`len` function has the "
"signature ``len(obj, /)``. This precludes awkward calls such as::"
msgstr ""
#: whatsnew/3.8.rst:158
2019-09-04 09:39:22 +00:00
msgid ""
"A further benefit of marking a parameter as positional-only is that it "
"allows the parameter name to be changed in the future without risk of "
"breaking client code. For example, in the :mod:`statistics` module, the "
"parameter name *dist* may be changed in the future. This was made possible "
"with the following function specification::"
msgstr ""
#: whatsnew/3.8.rst:167
2019-09-04 09:39:22 +00:00
msgid ""
"Since the parameters to the left of ``/`` are not exposed as possible "
"keywords, the parameters names remain available for use in ``**kwargs``::"
msgstr ""
#: whatsnew/3.8.rst:176
2019-09-04 09:39:22 +00:00
msgid ""
"This greatly simplifies the implementation of functions and methods that "
"need to accept arbitrary keyword arguments. For example, here is an excerpt "
2019-09-04 09:39:22 +00:00
"from code in the :mod:`collections` module::"
msgstr ""
#: whatsnew/3.8.rst:185
2019-09-04 09:39:22 +00:00
msgid "See :pep:`570` for a full description."
msgstr "Voir :pep:`570` pour une description complète."
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:187
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Pablo Galindo in :issue:`36540`.)"
msgstr "(Contribution de Pablo Galindo dans :issue:`36540`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:193
2019-09-04 09:39:22 +00:00
msgid "Parallel filesystem cache for compiled bytecode files"
msgstr ""
#: whatsnew/3.8.rst:195
2019-09-04 09:39:22 +00:00
msgid ""
"The new :envvar:`PYTHONPYCACHEPREFIX` setting (also available as :option:`-"
"X` ``pycache_prefix``) configures the implicit bytecode cache to use a "
"separate parallel filesystem tree, rather than the default ``__pycache__`` "
"subdirectories within each source directory."
msgstr ""
#: whatsnew/3.8.rst:201
2019-09-04 09:39:22 +00:00
msgid ""
"The location of the cache is reported in :data:`sys.pycache_prefix` (:const:"
"`None` indicates the default location in ``__pycache__`` subdirectories)."
msgstr ""
#: whatsnew/3.8.rst:205
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Carl Meyer in :issue:`33499`.)"
msgstr ""
#: whatsnew/3.8.rst:209
2019-09-04 09:39:22 +00:00
msgid "Debug build uses the same ABI as release build"
msgstr ""
#: whatsnew/3.8.rst:211
2019-09-04 09:39:22 +00:00
msgid ""
"Python now uses the same ABI whether it's built in release or debug mode. On "
2019-09-04 09:39:22 +00:00
"Unix, when Python is built in debug mode, it is now possible to load C "
"extensions built in release mode and C extensions built using the stable ABI."
msgstr ""
#: whatsnew/3.8.rst:215
2019-09-04 09:39:22 +00:00
msgid ""
"Release builds and :ref:`debug builds <debug-build>` are now ABI compatible: "
"defining the ``Py_DEBUG`` macro no longer implies the ``Py_TRACE_REFS`` "
"macro, which introduces the only ABI incompatibility. The ``Py_TRACE_REFS`` "
"macro, which adds the :func:`sys.getobjects` function and the :envvar:"
"`PYTHONDUMPREFS` environment variable, can be set using the new :option:`./"
"configure --with-trace-refs <--with-trace-refs>` build option. (Contributed "
"by Victor Stinner in :issue:`36465`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:223
2019-09-04 09:39:22 +00:00
msgid ""
"On Unix, C extensions are no longer linked to libpython except on Android "
"and Cygwin. It is now possible for a statically linked Python to load a C "
"extension built using a shared library Python. (Contributed by Victor "
"Stinner in :issue:`21536`.)"
msgstr ""
#: whatsnew/3.8.rst:230
2019-09-04 09:39:22 +00:00
msgid ""
"On Unix, when Python is built in debug mode, import now also looks for C "
"extensions compiled in release mode and for C extensions compiled with the "
"stable ABI. (Contributed by Victor Stinner in :issue:`36722`.)"
msgstr ""
#: whatsnew/3.8.rst:235
2019-09-04 09:39:22 +00:00
msgid ""
"To embed Python into an application, a new ``--embed`` option must be passed "
"to ``python3-config --libs --embed`` to get ``-lpython3.8`` (link the "
"application to libpython). To support both 3.8 and older, try ``python3-"
"config --libs --embed`` first and fallback to ``python3-config --libs`` "
"(without ``--embed``) if the previous command fails."
msgstr ""
#: whatsnew/3.8.rst:241
2019-09-04 09:39:22 +00:00
msgid ""
"Add a pkg-config ``python-3.8-embed`` module to embed Python into an "
"application: ``pkg-config python-3.8-embed --libs`` includes ``-"
"lpython3.8``. To support both 3.8 and older, try ``pkg-config python-X.Y-"
"embed --libs`` first and fallback to ``pkg-config python-X.Y --libs`` "
"(without ``--embed``) if the previous command fails (replace ``X.Y`` with "
"the Python version)."
msgstr ""
#: whatsnew/3.8.rst:247
2019-09-04 09:39:22 +00:00
msgid ""
"On the other hand, ``pkg-config python3.8 --libs`` no longer contains ``-"
"lpython3.8``. C extensions must not be linked to libpython (except on "
"Android and Cygwin, whose cases are handled by the script); this change is "
"backward incompatible on purpose. (Contributed by Victor Stinner in :issue:"
"`36721`.)"
msgstr ""
#: whatsnew/3.8.rst:256
2019-09-04 09:39:22 +00:00
msgid "f-strings support ``=`` for self-documenting expressions and debugging"
msgstr ""
#: whatsnew/3.8.rst:258
2019-09-04 09:39:22 +00:00
msgid ""
"Added an ``=`` specifier to :term:`f-string`\\s. An f-string such as "
"``f'{expr=}'`` will expand to the text of the expression, an equal sign, "
"then the representation of the evaluated expression. For example:"
msgstr ""
"Le spécificateur ``=`` a été ajouté aux :term:`f-string`\\s. Une f-string "
"telle que ``f'{expr=}'`` est transformée en : le texte de lexpression, le "
"signe égal et le résultat de lévaluation de lexpression. Par exemple :"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:267
2019-09-04 09:39:22 +00:00
msgid ""
"The usual :ref:`f-string format specifiers <f-strings>` allow more control "
"over how the result of the expression is displayed::"
msgstr ""
#: whatsnew/3.8.rst:274
2019-09-04 09:39:22 +00:00
msgid ""
"The ``=`` specifier will display the whole expression so that calculations "
"can be shown::"
msgstr ""
#: whatsnew/3.8.rst:280
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Eric V. Smith and Larry Hastings in :issue:`36817`.)"
msgstr ""
#: whatsnew/3.8.rst:284
msgid "PEP 578: Python Runtime Audit Hooks"
msgstr ""
#: whatsnew/3.8.rst:286
msgid ""
"The PEP adds an Audit Hook and Verified Open Hook. Both are available from "
"Python and native code, allowing applications and frameworks written in pure "
"Python code to take advantage of extra notifications, while also allowing "
"embedders or system administrators to deploy builds of Python where auditing "
"is always enabled."
msgstr ""
#: whatsnew/3.8.rst:292
msgid "See :pep:`578` for full details."
msgstr ""
#: whatsnew/3.8.rst:296
2019-09-04 09:39:22 +00:00
msgid "PEP 587: Python Initialization Configuration"
msgstr ""
#: whatsnew/3.8.rst:298
2019-09-04 09:39:22 +00:00
msgid ""
"The :pep:`587` adds a new C API to configure the Python Initialization "
"providing finer control on the whole configuration and better error "
"reporting."
msgstr ""
#: whatsnew/3.8.rst:301
2019-09-04 09:39:22 +00:00
msgid "New structures:"
msgstr ""
#: whatsnew/3.8.rst:303
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyConfig`"
msgstr ""
#: whatsnew/3.8.rst:304
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyPreConfig`"
msgstr ""
#: whatsnew/3.8.rst:305
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyStatus`"
msgstr ""
#: whatsnew/3.8.rst:306
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyWideStringList`"
msgstr ""
#: whatsnew/3.8.rst:308
2019-09-04 09:39:22 +00:00
msgid "New functions:"
2019-09-16 10:08:42 +00:00
msgstr "Nouvelles fonctions :"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:310
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_Clear`"
msgstr ""
#: whatsnew/3.8.rst:311
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_InitIsolatedConfig`"
msgstr ""
#: whatsnew/3.8.rst:312
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_InitPythonConfig`"
msgstr ""
#: whatsnew/3.8.rst:313
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_Read`"
msgstr ""
#: whatsnew/3.8.rst:314
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetArgv`"
msgstr ""
#: whatsnew/3.8.rst:315
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetBytesArgv`"
msgstr ""
#: whatsnew/3.8.rst:316
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetBytesString`"
msgstr ""
#: whatsnew/3.8.rst:317
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetString`"
msgstr ""
#: whatsnew/3.8.rst:318
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyPreConfig_InitIsolatedConfig`"
msgstr ""
#: whatsnew/3.8.rst:319
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyPreConfig_InitPythonConfig`"
msgstr ""
#: whatsnew/3.8.rst:320
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Error`"
msgstr ""
#: whatsnew/3.8.rst:321
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Exception`"
msgstr ""
#: whatsnew/3.8.rst:322
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Exit`"
msgstr ""
#: whatsnew/3.8.rst:323
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_IsError`"
msgstr ""
#: whatsnew/3.8.rst:324
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_IsExit`"
msgstr ""
#: whatsnew/3.8.rst:325
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_NoMemory`"
msgstr ""
#: whatsnew/3.8.rst:326
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Ok`"
msgstr ""
#: whatsnew/3.8.rst:327
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyWideStringList_Append`"
msgstr ""
#: whatsnew/3.8.rst:328
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyWideStringList_Insert`"
msgstr ""
#: whatsnew/3.8.rst:329
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_BytesMain`"
msgstr ""
#: whatsnew/3.8.rst:330
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_ExitStatusException`"
msgstr ""
#: whatsnew/3.8.rst:331
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_InitializeFromConfig`"
msgstr ""
#: whatsnew/3.8.rst:332
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_PreInitialize`"
msgstr ""
#: whatsnew/3.8.rst:333
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_PreInitializeFromArgs`"
msgstr ""
#: whatsnew/3.8.rst:334
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_PreInitializeFromBytesArgs`"
msgstr ""
#: whatsnew/3.8.rst:335
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_RunMain`"
msgstr ""
#: whatsnew/3.8.rst:337
2019-09-04 09:39:22 +00:00
msgid ""
"This PEP also adds ``_PyRuntimeState.preconfig`` (:c:type:`PyPreConfig` "
"type) and ``PyInterpreterState.config`` (:c:type:`PyConfig` type) fields to "
"these internal structures. ``PyInterpreterState.config`` becomes the new "
"reference configuration, replacing global configuration variables and other "
"private variables."
msgstr ""
#: whatsnew/3.8.rst:343
2019-09-04 09:39:22 +00:00
msgid ""
"See :ref:`Python Initialization Configuration <init-config>` for the "
"documentation."
msgstr ""
#: whatsnew/3.8.rst:346
2019-09-04 09:39:22 +00:00
msgid "See :pep:`587` for a full description."
msgstr ""
#: whatsnew/3.8.rst:348
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Victor Stinner in :issue:`36763`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Victor Stinner; :issue:`21233`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:352
2020-07-20 08:56:42 +00:00
msgid "PEP 590: Vectorcall: a fast calling protocol for CPython"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:354
2019-09-04 09:39:22 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
":ref:`vectorcall` is added to the Python/C API. It is meant to formalize "
"existing optimizations which were already done for various classes. Any :ref:"
"`static type <static-types>` implementing a callable can use this protocol."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:360
2019-09-04 09:39:22 +00:00
msgid ""
"This is currently provisional. The aim is to make it fully public in Python "
2019-09-04 09:39:22 +00:00
"3.9."
msgstr ""
#: whatsnew/3.8.rst:363
2019-09-04 09:39:22 +00:00
msgid "See :pep:`590` for a full description."
msgstr ""
#: whatsnew/3.8.rst:365
2020-07-20 08:56:42 +00:00
msgid ""
"(Contributed by Jeroen Demeyer, Mark Shannon and Petr Viktorin in :issue:"
"`36974`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:369
2019-09-04 09:39:22 +00:00
msgid "Pickle protocol 5 with out-of-band data buffers"
msgstr ""
#: whatsnew/3.8.rst:371
2019-09-04 09:39:22 +00:00
msgid ""
"When :mod:`pickle` is used to transfer large data between Python processes "
"in order to take advantage of multi-core or multi-machine processing, it is "
"important to optimize the transfer by reducing memory copies, and possibly "
"by applying custom techniques such as data-dependent compression."
msgstr ""
#: whatsnew/3.8.rst:376
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`pickle` protocol 5 introduces support for out-of-band buffers "
"where :pep:`3118`-compatible data can be transmitted separately from the "
"main pickle stream, at the discretion of the communication layer."
msgstr ""
#: whatsnew/3.8.rst:380
2019-09-04 09:39:22 +00:00
msgid "See :pep:`574` for a full description."
msgstr ""
#: whatsnew/3.8.rst:382
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Antoine Pitrou in :issue:`36785`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Antoine Pitrou; :issue:`13748`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:386
2019-09-04 09:39:22 +00:00
msgid "Other Language Changes"
msgstr ""
#: whatsnew/3.8.rst:388
2019-09-04 09:39:22 +00:00
msgid ""
"A :keyword:`continue` statement was illegal in the :keyword:`finally` clause "
"due to a problem with the implementation. In Python 3.8 this restriction "
"was lifted. (Contributed by Serhiy Storchaka in :issue:`32489`.)"
msgstr ""
#: whatsnew/3.8.rst:393
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`bool`, :class:`int`, and :class:`fractions.Fraction` types now "
"have an :meth:`~int.as_integer_ratio` method like that found in :class:"
"`float` and :class:`decimal.Decimal`. This minor API extension makes it "
"possible to write ``numerator, denominator = x.as_integer_ratio()`` and have "
"it work across multiple numeric types. (Contributed by Lisa Roach in :issue:"
"`33073` and Raymond Hettinger in :issue:`37819`.)"
msgstr ""
#: whatsnew/3.8.rst:401
2019-09-04 09:39:22 +00:00
msgid ""
"Constructors of :class:`int`, :class:`float` and :class:`complex` will now "
"use the :meth:`~object.__index__` special method, if available and the "
"corresponding method :meth:`~object.__int__`, :meth:`~object.__float__` or :"
"meth:`~object.__complex__` is not available. (Contributed by Serhiy "
"Storchaka in :issue:`20092`.)"
msgstr ""
#: whatsnew/3.8.rst:407
2019-09-04 09:39:22 +00:00
msgid ""
"Added support of ``\\N{name}`` escapes in :mod:`regular expressions <re>`::"
msgstr ""
#: whatsnew/3.8.rst:414
2019-09-04 09:39:22 +00:00
msgid ""
"(Contributed by Jonathan Eunice and Serhiy Storchaka in :issue:`30688`.)"
msgstr ""
#: whatsnew/3.8.rst:416
2019-09-04 09:39:22 +00:00
msgid ""
"Dict and dictviews are now iterable in reversed insertion order using :func:"
"`reversed`. (Contributed by Rémi Lapeyre in :issue:`33462`.)"
msgstr ""
#: whatsnew/3.8.rst:419
2019-09-04 09:39:22 +00:00
msgid ""
"The syntax allowed for keyword names in function calls was further "
"restricted. In particular, ``f((keyword)=arg)`` is no longer allowed. It was "
"never intended to permit more than a bare name on the left-hand side of a "
"keyword argument assignment term. (Contributed by Benjamin Peterson in :"
"issue:`34641`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:425
2019-09-04 09:39:22 +00:00
msgid ""
"Generalized iterable unpacking in :keyword:`yield` and :keyword:`return` "
"statements no longer requires enclosing parentheses. This brings the *yield* "
"and *return* syntax into better agreement with normal assignment syntax::"
msgstr ""
#: whatsnew/3.8.rst:437
2019-09-04 09:39:22 +00:00
msgid "(Contributed by David Cuthbert and Jordan Chapman in :issue:`32117`.)"
msgstr ""
#: whatsnew/3.8.rst:439
2019-09-04 09:39:22 +00:00
msgid ""
"When a comma is missed in code such as ``[(10, 20) (30, 40)]``, the compiler "
"displays a :exc:`SyntaxWarning` with a helpful suggestion. This improves on "
"just having a :exc:`TypeError` indicating that the first tuple was not "
"callable. (Contributed by Serhiy Storchaka in :issue:`15248`.)"
msgstr ""
#: whatsnew/3.8.rst:445
2019-09-04 09:39:22 +00:00
msgid ""
"Arithmetic operations between subclasses of :class:`datetime.date` or :class:"
"`datetime.datetime` and :class:`datetime.timedelta` objects now return an "
"instance of the subclass, rather than the base class. This also affects the "
"return type of operations whose implementation (directly or indirectly) "
"uses :class:`datetime.timedelta` arithmetic, such as :meth:`~datetime."
2019-09-04 09:39:22 +00:00
"datetime.astimezone`. (Contributed by Paul Ganssle in :issue:`32417`.)"
msgstr ""
#: whatsnew/3.8.rst:453
2019-09-04 09:39:22 +00:00
msgid ""
"When the Python interpreter is interrupted by Ctrl-C (SIGINT) and the "
"resulting :exc:`KeyboardInterrupt` exception is not caught, the Python "
"process now exits via a SIGINT signal or with the correct exit code such "
"that the calling process can detect that it died due to a Ctrl-C. Shells on "
"POSIX and Windows use this to properly terminate scripts in interactive "
"sessions. (Contributed by Google via Gregory P. Smith in :issue:`1054041`.)"
msgstr ""
#: whatsnew/3.8.rst:460
2019-09-04 09:39:22 +00:00
msgid ""
"Some advanced styles of programming require updating the :class:`types."
"CodeType` object for an existing function. Since code objects are "
"immutable, a new code object needs to be created, one that is modeled on the "
"existing code object. With 19 parameters, this was somewhat tedious. Now, "
"the new ``replace()`` method makes it possible to create a clone with a few "
"altered parameters."
msgstr ""
#: whatsnew/3.8.rst:467
2019-09-04 09:39:22 +00:00
msgid ""
"Here's an example that alters the :func:`statistics.mean` function to "
"prevent the *data* parameter from being used as a keyword argument::"
msgstr ""
#: whatsnew/3.8.rst:479
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Victor Stinner in :issue:`37032`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Victor Stinner; :issue:`12049`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:481
2019-09-04 09:39:22 +00:00
msgid ""
"For integers, the three-argument form of the :func:`pow` function now "
"permits the exponent to be negative in the case where the base is relatively "
"prime to the modulus. It then computes a modular inverse to the base when "
"the exponent is ``-1``, and a suitable power of that inverse for other "
"negative exponents. For example, to compute the `modular multiplicative "
"inverse <https://en.wikipedia.org/wiki/Modular_multiplicative_inverse>`_ of "
"38 modulo 137, write::"
msgstr ""
#: whatsnew/3.8.rst:495
2019-09-04 09:39:22 +00:00
msgid ""
"Modular inverses arise in the solution of `linear Diophantine equations "
"<https://en.wikipedia.org/wiki/Diophantine_equation>`_. For example, to find "
"integer solutions for ``4258𝑥 + 147𝑦 = 369``, first rewrite as ``4258𝑥 ≡ 369 "
"(mod 147)`` then solve:"
msgstr ""
#: whatsnew/3.8.rst:505
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Mark Dickinson in :issue:`36027`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Mark Dickinson; :issue:`4707`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:507
2019-09-04 09:39:22 +00:00
msgid ""
"Dict comprehensions have been synced-up with dict literals so that the key "
"is computed first and the value second::"
msgstr ""
#: whatsnew/3.8.rst:522
2019-09-04 09:39:22 +00:00
msgid ""
"The guaranteed execution order is helpful with assignment expressions "
"because variables assigned in the key expression will be available in the "
"value expression::"
msgstr ""
#: whatsnew/3.8.rst:532
msgid "(Contributed by Jörn Heissler in :issue:`35224`.)"
msgstr ""
#: whatsnew/3.8.rst:534
msgid ""
"The :meth:`object.__reduce__` method can now return a tuple from two to six "
"elements long. Formerly, five was the limit. The new, optional sixth "
"element is a callable with a ``(obj, state)`` signature. This allows the "
"direct control over the state-updating behavior of a specific object. If "
"not *None*, this callable will have priority over the object's :meth:"
"`~__setstate__` method. (Contributed by Pierre Glaser and Olivier Grisel in :"
"issue:`35900`.)"
msgstr ""
#: whatsnew/3.8.rst:543
2019-09-04 09:39:22 +00:00
msgid "New Modules"
msgstr ""
#: whatsnew/3.8.rst:545
2019-09-04 09:39:22 +00:00
msgid ""
"The new :mod:`importlib.metadata` module provides (provisional) support for "
"reading metadata from third-party packages. For example, it can extract an "
"installed package's version number, list of entry points, and more::"
msgstr ""
#: whatsnew/3.8.rst:564
msgid "(Contributed by Barry Warsaw and Jason R. Coombs in :issue:`34632`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:568
2019-09-04 09:39:22 +00:00
msgid "Improved Modules"
msgstr ""
#: whatsnew/3.8.rst:571
2019-09-04 09:39:22 +00:00
msgid "ast"
2019-09-16 10:08:42 +00:00
msgstr "ast"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:573
2019-09-04 09:39:22 +00:00
msgid ""
"AST nodes now have ``end_lineno`` and ``end_col_offset`` attributes, which "
"give the precise location of the end of the node. (This only applies to "
"nodes that have ``lineno`` and ``col_offset`` attributes.)"
msgstr ""
#: whatsnew/3.8.rst:577
msgid ""
"New function :func:`ast.get_source_segment` returns the source code for a "
"specific AST node."
msgstr ""
#: whatsnew/3.8.rst:580
msgid "(Contributed by Ivan Levkivskyi in :issue:`33416`.)"
msgstr ""
#: whatsnew/3.8.rst:582
2019-09-04 09:39:22 +00:00
msgid "The :func:`ast.parse` function has some new flags:"
msgstr ""
#: whatsnew/3.8.rst:584
2019-09-04 09:39:22 +00:00
msgid ""
"``type_comments=True`` causes it to return the text of :pep:`484` and :pep:"
"`526` type comments associated with certain AST nodes;"
msgstr ""
#: whatsnew/3.8.rst:587
2019-09-04 09:39:22 +00:00
msgid ""
"``mode='func_type'`` can be used to parse :pep:`484` \"signature type "
"comments\" (returned for function definition AST nodes);"
msgstr ""
#: whatsnew/3.8.rst:590
2019-09-04 09:39:22 +00:00
msgid ""
"``feature_version=(3, N)`` allows specifying an earlier Python 3 version. "
"For example, ``feature_version=(3, 4)`` will treat :keyword:`async` and :"
"keyword:`await` as non-reserved words."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:594
msgid "(Contributed by Guido van Rossum in :issue:`35766`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:598
2019-09-04 09:39:22 +00:00
msgid "asyncio"
2019-09-16 10:08:42 +00:00
msgstr "asyncio"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:600
msgid ""
":func:`asyncio.run` has graduated from the provisional to stable API. This "
"function can be used to execute a :term:`coroutine` and return the result "
"while automatically managing the event loop. For example::"
msgstr ""
#: whatsnew/3.8.rst:612
msgid "This is *roughly* equivalent to::"
msgstr ""
#: whatsnew/3.8.rst:629
msgid ""
"The actual implementation is significantly more complex. Thus, :func:"
"`asyncio.run` should be the preferred way of running asyncio programs."
msgstr ""
#: whatsnew/3.8.rst:632
msgid "(Contributed by Yury Selivanov in :issue:`32314`.)"
msgstr ""
#: whatsnew/3.8.rst:634
msgid ""
"Running ``python -m asyncio`` launches a natively async REPL. This allows "
"rapid experimentation with code that has a top-level :keyword:`await`. "
"There is no longer a need to directly call ``asyncio.run()`` which would "
"spawn a new event loop on every invocation:"
msgstr ""
#: whatsnew/3.8.rst:649
msgid "(Contributed by Yury Selivanov in :issue:`37028`.)"
msgstr ""
#: whatsnew/3.8.rst:1967
msgid ""
"The exception :class:`asyncio.CancelledError` now inherits from :class:"
2020-09-11 07:11:46 +00:00
"`BaseException` rather than :class:`Exception` and no longer inherits from :"
"class:`concurrent.futures.CancelledError`. (Contributed by Yury Selivanov "
"in :issue:`32528`.)"
msgstr ""
#: whatsnew/3.8.rst:656
2019-09-04 09:39:22 +00:00
msgid ""
"On Windows, the default event loop is now :class:`~asyncio."
"ProactorEventLoop`. (Contributed by Victor Stinner in :issue:`34687`.)"
msgstr ""
#: whatsnew/3.8.rst:659
2019-09-04 09:39:22 +00:00
msgid ""
":class:`~asyncio.ProactorEventLoop` now also supports UDP. (Contributed by "
"Adam Meily and Andrew Svetlov in :issue:`29883`.)"
msgstr ""
#: whatsnew/3.8.rst:662
2019-09-04 09:39:22 +00:00
msgid ""
":class:`~asyncio.ProactorEventLoop` can now be interrupted by :exc:"
"`KeyboardInterrupt` (\"CTRL+C\"). (Contributed by Vladimir Matveev in :issue:"
"`23057`.)"
msgstr ""
#: whatsnew/3.8.rst:666
msgid ""
"Added :meth:`asyncio.Task.get_coro` for getting the wrapped coroutine within "
"an :class:`asyncio.Task`. (Contributed by Alex Grönholm in :issue:`36999`.)"
msgstr ""
#: whatsnew/3.8.rst:670
msgid ""
"Asyncio tasks can now be named, either by passing the ``name`` keyword "
"argument to :func:`asyncio.create_task` or the :meth:`~asyncio.loop."
"create_task` event loop method, or by calling the :meth:`~asyncio.Task."
"set_name` method on the task object. The task name is visible in the "
"``repr()`` output of :class:`asyncio.Task` and can also be retrieved using "
"the :meth:`~asyncio.Task.get_name` method. (Contributed by Alex Grönholm in :"
"issue:`34270`.)"
msgstr ""
#: whatsnew/3.8.rst:678
msgid ""
"Added support for `Happy Eyeballs <https://en.wikipedia.org/wiki/"
"Happy_Eyeballs>`_ to :func:`asyncio.loop.create_connection`. To specify the "
"behavior, two new parameters have been added: *happy_eyeballs_delay* and "
"*interleave*. The Happy Eyeballs algorithm improves responsiveness in "
"applications that support IPv4 and IPv6 by attempting to simultaneously "
"connect using both. (Contributed by twisteroid ambassador in :issue:`33530`.)"
msgstr ""
#: whatsnew/3.8.rst:688
2019-09-04 09:39:22 +00:00
msgid "builtins"
msgstr ""
#: whatsnew/3.8.rst:690
2019-09-04 09:39:22 +00:00
msgid ""
"The :func:`compile` built-in has been improved to accept the ``ast."
"PyCF_ALLOW_TOP_LEVEL_AWAIT`` flag. With this new flag passed, :func:"
"`compile` will allow top-level ``await``, ``async for`` and ``async with`` "
"constructs that are usually considered invalid syntax. Asynchronous code "
"object marked with the ``CO_COROUTINE`` flag may then be returned. "
"(Contributed by Matthias Bussonnier in :issue:`34616`)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:699
msgid "collections"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:701
msgid ""
"The :meth:`~collections.somenamedtuple._asdict` method for :func:"
"`collections.namedtuple` now returns a :class:`dict` instead of a :class:"
"`collections.OrderedDict`. This works because regular dicts have guaranteed "
"ordering since Python 3.7. If the extra features of :class:`OrderedDict` are "
"required, the suggested remediation is to cast the result to the desired "
"type: ``OrderedDict(nt._asdict())``. (Contributed by Raymond Hettinger in :"
"issue:`35864`.)"
msgstr ""
#: whatsnew/3.8.rst:711
msgid "cProfile"
msgstr ""
#: whatsnew/3.8.rst:713
msgid ""
"The :class:`cProfile.Profile <profile.Profile>` class can now be used as a "
"context manager. Profile a block of code by running::"
msgstr ""
#: whatsnew/3.8.rst:722
msgid "(Contributed by Scott Sanderson in :issue:`29235`.)"
msgstr ""
#: whatsnew/3.8.rst:726
msgid "csv"
2019-12-06 09:55:45 +00:00
msgstr "csv"
#: whatsnew/3.8.rst:728
msgid ""
"The :class:`csv.DictReader` now returns instances of :class:`dict` instead "
"of a :class:`collections.OrderedDict`. The tool is now faster and uses less "
2020-02-04 10:14:03 +00:00
"memory while still preserving the field order. (Contributed by Michael Selik "
"in :issue:`34003`.)"
msgstr ""
#: whatsnew/3.8.rst:735
msgid "curses"
2019-12-06 09:55:45 +00:00
msgstr "curses"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:737
2019-09-04 09:39:22 +00:00
msgid ""
"Added a new variable holding structured version information for the "
"underlying ncurses library: :data:`~curses.ncurses_version`. (Contributed by "
"Serhiy Storchaka in :issue:`31680`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:743
2019-09-04 09:39:22 +00:00
msgid "ctypes"
2019-09-16 10:08:42 +00:00
msgstr "ctypes"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:745
2019-09-04 09:39:22 +00:00
msgid ""
"On Windows, :class:`~ctypes.CDLL` and subclasses now accept a *winmode* "
"parameter to specify flags for the underlying ``LoadLibraryEx`` call. The "
"default flags are set to only load DLL dependencies from trusted locations, "
"including the path where the DLL is stored (if a full or partial path is "
"used to load the initial DLL) and paths added by :func:`~os."
"add_dll_directory`. (Contributed by Steve Dower in :issue:`36085`.)"
msgstr ""
#: whatsnew/3.8.rst:754
msgid "datetime"
msgstr "datetime"
#: whatsnew/3.8.rst:756
msgid ""
"Added new alternate constructors :meth:`datetime.date.fromisocalendar` and :"
"meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and :"
"class:`datetime` objects respectively from ISO year, week number, and "
"weekday; these are the inverse of each class's ``isocalendar`` method. "
"(Contributed by Paul Ganssle in :issue:`36004`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:764
2019-09-04 09:39:22 +00:00
msgid "functools"
msgstr ""
#: whatsnew/3.8.rst:766
2019-09-04 09:39:22 +00:00
msgid ""
":func:`functools.lru_cache` can now be used as a straight decorator rather "
"than as a function returning a decorator. So both of these are now "
"supported::"
msgstr ""
#: whatsnew/3.8.rst:777
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Raymond Hettinger in :issue:`36772`.)"
msgstr ""
#: whatsnew/3.8.rst:779
msgid ""
"Added a new :func:`functools.cached_property` decorator, for computed "
"properties cached for the life of the instance. ::"
msgstr ""
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:793
msgid "(Contributed by Carl Meyer in :issue:`21145`)"
msgstr ""
#: whatsnew/3.8.rst:796
2019-09-04 09:39:22 +00:00
msgid ""
"Added a new :func:`functools.singledispatchmethod` decorator that converts "
"methods into :term:`generic functions <generic function>` using :term:"
"`single dispatch`::"
msgstr ""
#: whatsnew/3.8.rst:818
msgid "(Contributed by Ethan Smith in :issue:`32380`)"
msgstr ""
#: whatsnew/3.8.rst:821
msgid "gc"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:823
msgid ""
":func:`~gc.get_objects` can now receive an optional *generation* parameter "
"indicating a generation to get objects from. (Contributed by Pablo Galindo "
"in :issue:`36016`.)"
msgstr ""
#: whatsnew/3.8.rst:829
2019-09-04 09:39:22 +00:00
msgid "gettext"
msgstr ""
#: whatsnew/3.8.rst:831
2019-09-04 09:39:22 +00:00
msgid ""
"Added :func:`~gettext.pgettext` and its variants. (Contributed by Franz "
"Glasner, Éric Araujo, and Cheryl Sabella in :issue:`2504`.)"
msgstr ""
#: whatsnew/3.8.rst:836
msgid "gzip"
msgstr "gzip"
#: whatsnew/3.8.rst:838
msgid ""
"Added the *mtime* parameter to :func:`gzip.compress` for reproducible "
"output. (Contributed by Guo Ci Teo in :issue:`34898`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:841
msgid ""
"A :exc:`~gzip.BadGzipFile` exception is now raised instead of :exc:`OSError` "
"for certain types of invalid or corrupt gzip files. (Contributed by Filip "
"Gruszczyński, Michele Orrù, and Zackery Spytz in :issue:`6584`.)"
msgstr ""
#: whatsnew/3.8.rst:848
msgid "IDLE and idlelib"
msgstr ""
#: whatsnew/3.8.rst:850
2019-09-04 09:39:22 +00:00
msgid ""
"Output over N lines (50 by default) is squeezed down to a button. N can be "
"changed in the PyShell section of the General page of the Settings dialog. "
"Fewer, but possibly extra long, lines can be squeezed by right clicking on "
"the output. Squeezed output can be expanded in place by double-clicking the "
"button or into the clipboard or a separate window by right-clicking the "
"button. (Contributed by Tal Einat in :issue:`1529353`.)"
msgstr ""
#: whatsnew/3.8.rst:857
2019-09-04 09:39:22 +00:00
msgid ""
"Add \"Run Customized\" to the Run menu to run a module with customized "
"settings. Any command line arguments entered are added to sys.argv. They "
"also re-appear in the box for the next customized run. One can also "
"suppress the normal Shell main module restart. (Contributed by Cheryl "
"Sabella, Terry Jan Reedy, and others in :issue:`5680` and :issue:`37627`.)"
msgstr ""
#: whatsnew/3.8.rst:863
2019-09-04 09:39:22 +00:00
msgid ""
"Added optional line numbers for IDLE editor windows. Windows open without "
"line numbers unless set otherwise in the General tab of the configuration "
2019-09-04 09:39:22 +00:00
"dialog. Line numbers for an existing window are shown and hidden in the "
"Options menu. (Contributed by Tal Einat and Saimadhav Heblikar in :issue:"
"`17535`.)"
msgstr ""
#: whatsnew/3.8.rst:869
msgid ""
"OS native encoding is now used for converting between Python strings and Tcl "
"objects. This allows IDLE to work with emoji and other non-BMP characters. "
"These characters can be displayed or copied and pasted to or from the "
"clipboard. Converting strings from Tcl to Python and back now never fails. "
"(Many people worked on this for eight years but the problem was finally "
"solved by Serhiy Storchaka in :issue:`13153`.)"
msgstr ""
#: whatsnew/3.8.rst:876
2020-10-02 08:55:01 +00:00
msgid "New in 3.8.1:"
msgstr ""
#: whatsnew/3.8.rst:878
2020-10-02 08:55:01 +00:00
msgid ""
"Add option to toggle cursor blink off. (Contributed by Zackery Spytz in :"
"issue:`4603`.)"
msgstr ""
#: whatsnew/3.8.rst:881
2020-10-02 08:55:01 +00:00
msgid ""
"Escape key now closes IDLE completion windows. (Contributed by Johnny "
"Najera in :issue:`38944`.)"
msgstr ""
#: whatsnew/3.8.rst:884
2019-09-04 09:39:22 +00:00
msgid "The changes above have been backported to 3.7 maintenance releases."
msgstr ""
#: whatsnew/3.8.rst:886
2020-10-02 08:55:01 +00:00
msgid ""
"Add keywords to module name completion list. (Contributed by Terry J. Reedy "
"in :issue:`37765`.)"
msgstr ""
#: whatsnew/3.8.rst:890
2019-09-04 09:39:22 +00:00
msgid "inspect"
msgstr ""
#: whatsnew/3.8.rst:892
2019-09-04 09:39:22 +00:00
msgid ""
"The :func:`inspect.getdoc` function can now find docstrings for "
"``__slots__`` if that attribute is a :class:`dict` where the values are "
"docstrings. This provides documentation options similar to what we already "
"have for :func:`property`, :func:`classmethod`, and :func:`staticmethod`::"
msgstr ""
#: whatsnew/3.8.rst:904
msgid "(Contributed by Raymond Hettinger in :issue:`36326`.)"
msgstr ""
#: whatsnew/3.8.rst:908
2019-09-04 09:39:22 +00:00
msgid "io"
msgstr ""
#: whatsnew/3.8.rst:910
2019-09-04 09:39:22 +00:00
msgid ""
"In development mode (:option:`-X` ``env``) and in :ref:`debug build <debug-"
"build>`, the :class:`io.IOBase` finalizer now logs the exception if the "
"``close()`` method fails. The exception is ignored silently by default in "
"release build. (Contributed by Victor Stinner in :issue:`18748`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:917
msgid "itertools"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:919
2019-09-04 09:39:22 +00:00
msgid ""
"The :func:`itertools.accumulate` function added an option *initial* keyword "
"argument to specify an initial value::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:926
msgid "(Contributed by Lisa Roach in :issue:`34659`.)"
msgstr ""
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:930
msgid "json.tool"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:932
2019-09-04 09:39:22 +00:00
msgid ""
"Add option ``--json-lines`` to parse every input line as a separate JSON "
"object. (Contributed by Weipeng Hong in :issue:`31553`.)"
msgstr ""
#: whatsnew/3.8.rst:937
msgid "logging"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:939
2019-09-04 09:39:22 +00:00
msgid ""
"Added a *force* keyword argument to :func:`logging.basicConfig()` When set "
"to true, any existing handlers attached to the root logger are removed and "
"closed before carrying out the configuration specified by the other "
"arguments."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:944
msgid ""
"This solves a long-standing problem. Once a logger or *basicConfig()* had "
"been called, subsequent calls to *basicConfig()* were silently ignored. This "
"made it difficult to update, experiment with, or teach the various logging "
"configuration options using the interactive prompt or a Jupyter notebook."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:950
2019-09-04 09:39:22 +00:00
msgid ""
"(Suggested by Raymond Hettinger, implemented by Dong-hee Na, and reviewed by "
"Vinay Sajip in :issue:`33897`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:955
2019-09-04 09:39:22 +00:00
msgid "math"
msgstr ""
#: whatsnew/3.8.rst:957
2019-09-04 09:39:22 +00:00
msgid ""
"Added new function :func:`math.dist` for computing Euclidean distance "
"between two points. (Contributed by Raymond Hettinger in :issue:`33089`.)"
msgstr ""
#: whatsnew/3.8.rst:960
2019-09-04 09:39:22 +00:00
msgid ""
"Expanded the :func:`math.hypot` function to handle multiple dimensions. "
"Formerly, it only supported the 2-D case. (Contributed by Raymond Hettinger "
"in :issue:`33089`.)"
msgstr ""
#: whatsnew/3.8.rst:964
2019-09-04 09:39:22 +00:00
msgid ""
"Added new function, :func:`math.prod`, as analogous function to :func:`sum` "
"that returns the product of a 'start' value (default: 1) times an iterable "
"of numbers::"
msgstr ""
#: whatsnew/3.8.rst:973
msgid "(Contributed by Pablo Galindo in :issue:`35606`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:975
2019-09-04 09:39:22 +00:00
msgid ""
"Added two new combinatoric functions :func:`math.perm` and :func:`math."
"comb`::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:982
msgid ""
"(Contributed by Yash Aggarwal, Keller Fuchs, Serhiy Storchaka, and Raymond "
"Hettinger in :issue:`37128`, :issue:`37178`, and :issue:`35431`.)"
msgstr ""
#: whatsnew/3.8.rst:985
msgid ""
"Added a new function :func:`math.isqrt` for computing accurate integer "
"square roots without conversion to floating point. The new function "
"supports arbitrarily large integers. It is faster than ``floor(sqrt(n))`` "
"but slower than :func:`math.sqrt`::"
msgstr ""
#: whatsnew/3.8.rst:997
msgid "(Contributed by Mark Dickinson in :issue:`36887`.)"
msgstr ""
#: whatsnew/3.8.rst:999
2019-09-04 09:39:22 +00:00
msgid ""
"The function :func:`math.factorial` no longer accepts arguments that are not "
"int-like. (Contributed by Pablo Galindo in :issue:`33083`.)"
msgstr ""
#: whatsnew/3.8.rst:1004
2019-09-04 09:39:22 +00:00
msgid "mmap"
msgstr ""
#: whatsnew/3.8.rst:1006
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`mmap.mmap` class now has an :meth:`~mmap.mmap.madvise` method to "
"access the ``madvise()`` system call. (Contributed by Zackery Spytz in :"
"issue:`32941`.)"
msgstr ""
#: whatsnew/3.8.rst:1012
2019-09-04 09:39:22 +00:00
msgid "multiprocessing"
2019-09-16 10:08:42 +00:00
msgstr "multiprocessing"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1014
2019-09-04 09:39:22 +00:00
msgid ""
"Added new :mod:`multiprocessing.shared_memory` module. (Contributed by Davin "
2019-09-04 09:39:22 +00:00
"Potts in :issue:`35813`.)"
msgstr ""
#: whatsnew/3.8.rst:1017
2019-09-04 09:39:22 +00:00
msgid ""
"On macOS, the *spawn* start method is now used by default. (Contributed by "
"Victor Stinner in :issue:`33725`.)"
msgstr ""
#: whatsnew/3.8.rst:1022
2019-09-04 09:39:22 +00:00
msgid "os"
msgstr ""
#: whatsnew/3.8.rst:1024
2019-09-04 09:39:22 +00:00
msgid ""
"Added new function :func:`~os.add_dll_directory` on Windows for providing "
"additional search paths for native dependencies when importing extension "
"modules or loading DLLs using :mod:`ctypes`. (Contributed by Steve Dower in :"
"issue:`36085`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1029
2019-09-04 09:39:22 +00:00
msgid ""
"A new :func:`os.memfd_create` function was added to wrap the "
"``memfd_create()`` syscall. (Contributed by Zackery Spytz and Christian "
"Heimes in :issue:`26836`.)"
msgstr ""
#: whatsnew/3.8.rst:1033
2019-09-04 09:39:22 +00:00
msgid ""
"On Windows, much of the manual logic for handling reparse points (including "
"symlinks and directory junctions) has been delegated to the operating "
"system. Specifically, :func:`os.stat` will now traverse anything supported "
"by the operating system, while :func:`os.lstat` will only open reparse "
"points that identify as \"name surrogates\" while others are opened as for :"
"func:`os.stat`. In all cases, :attr:`stat_result.st_mode` will only have "
"``S_IFLNK`` set for symbolic links and not other kinds of reparse points. To "
"identify other kinds of reparse point, check the new :attr:`stat_result."
"st_reparse_tag` attribute."
msgstr ""
#: whatsnew/3.8.rst:1042
2019-09-04 09:39:22 +00:00
msgid ""
"On Windows, :func:`os.readlink` is now able to read directory junctions. "
"Note that :func:`~os.path.islink` will return ``False`` for directory "
"junctions, and so code that checks ``islink`` first will continue to treat "
"junctions as directories, while code that handles errors from :func:`os."
"readlink` may now treat junctions as links."
msgstr ""
#: whatsnew/3.8.rst:1073
msgid "(Contributed by Steve Dower in :issue:`37834`.)"
msgstr ""
#: whatsnew/3.8.rst:1052
2019-09-04 09:39:22 +00:00
msgid "os.path"
msgstr ""
#: whatsnew/3.8.rst:1054
2019-09-04 09:39:22 +00:00
msgid ""
":mod:`os.path` functions that return a boolean result like :func:`~os.path."
"exists`, :func:`~os.path.lexists`, :func:`~os.path.isdir`, :func:`~os.path."
"isfile`, :func:`~os.path.islink`, and :func:`~os.path.ismount` now return "
"``False`` instead of raising :exc:`ValueError` or its subclasses :exc:"
"`UnicodeEncodeError` and :exc:`UnicodeDecodeError` for paths that contain "
"characters or bytes unrepresentable at the OS level. (Contributed by Serhiy "
"Storchaka in :issue:`33721`.)"
msgstr ""
#: whatsnew/3.8.rst:1962
2019-09-04 09:39:22 +00:00
msgid ""
":func:`~os.path.expanduser` on Windows now prefers the :envvar:`USERPROFILE` "
"environment variable and does not use :envvar:`HOME`, which is not normally "
"set for regular user accounts. (Contributed by Anthony Sottile in :issue:"
"`36264`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1067
2019-09-04 09:39:22 +00:00
msgid ""
":func:`~os.path.isdir` on Windows no longer returns ``True`` for a link to a "
"non-existent directory."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1070
2019-09-04 09:39:22 +00:00
msgid ""
":func:`~os.path.realpath` on Windows now resolves reparse points, including "
"symlinks and directory junctions."
msgstr ""
#: whatsnew/3.8.rst:1077
2019-09-04 09:39:22 +00:00
msgid "pathlib"
2019-09-16 10:08:42 +00:00
msgstr "pathlib"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1079
2019-09-04 09:39:22 +00:00
msgid ""
":mod:`pathlib.Path` methods that return a boolean result like :meth:"
"`~pathlib.Path.exists()`, :meth:`~pathlib.Path.is_dir()`, :meth:`~pathlib."
"Path.is_file()`, :meth:`~pathlib.Path.is_mount()`, :meth:`~pathlib.Path."
"is_symlink()`, :meth:`~pathlib.Path.is_block_device()`, :meth:`~pathlib.Path."
"is_char_device()`, :meth:`~pathlib.Path.is_fifo()`, :meth:`~pathlib.Path."
"is_socket()` now return ``False`` instead of raising :exc:`ValueError` or "
"its subclass :exc:`UnicodeEncodeError` for paths that contain characters "
"unrepresentable at the OS level. (Contributed by Serhiy Storchaka in :issue:"
"`33721`.)"
msgstr ""
#: whatsnew/3.8.rst:1089
2019-09-04 09:39:22 +00:00
msgid ""
"Added :meth:`pathlib.Path.link_to()` which creates a hard link pointing to a "
"path. (Contributed by Joannah Nanjekye in :issue:`26978`)"
msgstr ""
#: whatsnew/3.8.rst:1095
2019-09-04 09:39:22 +00:00
msgid "pickle"
msgstr ""
#: whatsnew/3.8.rst:1097
2019-09-04 09:39:22 +00:00
msgid ""
":mod:`pickle` extensions subclassing the C-optimized :class:`~pickle."
"Pickler` can now override the pickling logic of functions and classes by "
"defining the special :meth:`~pickle.Pickler.reducer_override` method. "
"(Contributed by Pierre Glaser and Olivier Grisel in :issue:`35900`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1104
2019-09-04 09:39:22 +00:00
msgid "plistlib"
msgstr ""
#: whatsnew/3.8.rst:1106
2019-09-04 09:39:22 +00:00
msgid ""
"Added new :class:`plistlib.UID` and enabled support for reading and writing "
"NSKeyedArchiver-encoded binary plists. (Contributed by Jon Janzen in :issue:"
"`26707`.)"
msgstr ""
#: whatsnew/3.8.rst:1112
msgid "pprint"
msgstr ""
#: whatsnew/3.8.rst:1114
msgid ""
"The :mod:`pprint` module added a *sort_dicts* parameter to several "
"functions. By default, those functions continue to sort dictionaries before "
"rendering or printing. However, if *sort_dicts* is set to false, the "
"dictionaries retain the order that keys were inserted. This can be useful "
"for comparison to JSON inputs during debugging."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1120
2019-09-04 09:39:22 +00:00
msgid ""
"In addition, there is a convenience new function, :func:`pprint.pp` that is "
"like :func:`pprint.pprint` but with *sort_dicts* defaulting to ``False``::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1134
msgid "(Contributed by Rémi Lapeyre in :issue:`30670`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1138
msgid "py_compile"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1140
2019-09-04 09:39:22 +00:00
msgid ""
":func:`py_compile.compile` now supports silent mode. (Contributed by Joannah "
"Nanjekye in :issue:`22640`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1145
2019-09-04 09:39:22 +00:00
msgid "shlex"
msgstr ""
#: whatsnew/3.8.rst:1147
2019-09-04 09:39:22 +00:00
msgid ""
"The new :func:`shlex.join` function acts as the inverse of :func:`shlex."
"split`. (Contributed by Bo Bayles in :issue:`32102`.)"
msgstr ""
#: whatsnew/3.8.rst:1152
2019-09-04 09:39:22 +00:00
msgid "shutil"
msgstr ""
#: whatsnew/3.8.rst:1154
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.copytree` now accepts a new ``dirs_exist_ok`` keyword "
"argument. (Contributed by Josh Bronson in :issue:`20849`.)"
msgstr ""
#: whatsnew/3.8.rst:1157
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.make_archive` now defaults to the modern pax (POSIX.1-2001) "
"format for new archives to improve portability and standards conformance, "
"inherited from the corresponding change to the :mod:`tarfile` module. "
"(Contributed by C.A.M. Gerlach in :issue:`30661`.)"
msgstr ""
#: whatsnew/3.8.rst:1162
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.rmtree` on Windows now removes directory junctions without "
"recursively removing their contents first. (Contributed by Steve Dower in :"
"issue:`37834`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1168
msgid "socket"
msgstr ""
#: whatsnew/3.8.rst:1170
msgid ""
"Added :meth:`~socket.create_server()` and :meth:`~socket."
"has_dualstack_ipv6()` convenience functions to automate the necessary tasks "
"usually involved when creating a server socket, including accepting both "
"IPv4 and IPv6 connections on the same socket. (Contributed by Giampaolo "
"Rodolà in :issue:`17561`.)"
msgstr ""
#: whatsnew/3.8.rst:1175
msgid ""
"The :func:`socket.if_nameindex()`, :func:`socket.if_nametoindex()`, and :"
"func:`socket.if_indextoname()` functions have been implemented on Windows. "
"(Contributed by Zackery Spytz in :issue:`37007`.)"
msgstr ""
#: whatsnew/3.8.rst:1181
2019-09-04 09:39:22 +00:00
msgid "ssl"
msgstr ""
#: whatsnew/3.8.rst:1183
2019-09-04 09:39:22 +00:00
msgid ""
"Added :attr:`~ssl.SSLContext.post_handshake_auth` to enable and :meth:`~ssl."
2019-09-04 09:39:22 +00:00
"SSLSocket.verify_client_post_handshake` to initiate TLS 1.3 post-handshake "
"authentication. (Contributed by Christian Heimes in :issue:`34670`.)"
msgstr ""
#: whatsnew/3.8.rst:1190
2019-09-04 09:39:22 +00:00
msgid "statistics"
msgstr ""
#: whatsnew/3.8.rst:1192
2019-09-04 09:39:22 +00:00
msgid ""
"Added :func:`statistics.fmean` as a faster, floating point variant of :func:"
"`statistics.mean()`. (Contributed by Raymond Hettinger and Steven D'Aprano "
"in :issue:`35904`.)"
msgstr ""
#: whatsnew/3.8.rst:1196
2019-09-04 09:39:22 +00:00
msgid ""
"Added :func:`statistics.geometric_mean()` (Contributed by Raymond Hettinger "
"in :issue:`27181`.)"
msgstr ""
#: whatsnew/3.8.rst:1199
2019-09-04 09:39:22 +00:00
msgid ""
"Added :func:`statistics.multimode` that returns a list of the most common "
"values. (Contributed by Raymond Hettinger in :issue:`35892`.)"
msgstr ""
#: whatsnew/3.8.rst:1202
2019-09-04 09:39:22 +00:00
msgid ""
"Added :func:`statistics.quantiles` that divides data or a distribution in to "
"equiprobable intervals (e.g. quartiles, deciles, or percentiles). "
"(Contributed by Raymond Hettinger in :issue:`36546`.)"
msgstr ""
#: whatsnew/3.8.rst:1206
2019-09-04 09:39:22 +00:00
msgid ""
"Added :class:`statistics.NormalDist`, a tool for creating and manipulating "
"normal distributions of a random variable. (Contributed by Raymond Hettinger "
"in :issue:`36018`.)"
msgstr ""
#: whatsnew/3.8.rst:1236
2019-09-04 09:39:22 +00:00
msgid "sys"
2019-09-16 10:08:42 +00:00
msgstr "sys"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1238
2019-09-04 09:39:22 +00:00
msgid ""
"Add new :func:`sys.unraisablehook` function which can be overridden to "
"control how \"unraisable exceptions\" are handled. It is called when an "
"exception has occurred but there is no way for Python to handle it. For "
"example, when a destructor raises an exception or during garbage collection "
"(:func:`gc.collect`). (Contributed by Victor Stinner in :issue:`36829`.)"
msgstr ""
#: whatsnew/3.8.rst:1247
2019-09-04 09:39:22 +00:00
msgid "tarfile"
msgstr ""
#: whatsnew/3.8.rst:1249
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`tarfile` module now defaults to the modern pax (POSIX.1-2001) "
"format for new archives, instead of the previous GNU-specific one. This "
"improves cross-platform portability with a consistent encoding (UTF-8) in a "
"standardized and extensible format, and offers several other benefits. "
"(Contributed by C.A.M. Gerlach in :issue:`36268`.)"
msgstr ""
#: whatsnew/3.8.rst:1257
2019-09-04 09:39:22 +00:00
msgid "threading"
2019-09-16 10:08:42 +00:00
msgstr "threading"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1259
2019-09-04 09:39:22 +00:00
msgid ""
"Add a new :func:`threading.excepthook` function which handles uncaught :meth:"
"`threading.Thread.run` exception. It can be overridden to control how "
"uncaught :meth:`threading.Thread.run` exceptions are handled. (Contributed "
"by Victor Stinner in :issue:`1230540`.)"
msgstr ""
#: whatsnew/3.8.rst:1264
2019-09-04 09:39:22 +00:00
msgid ""
"Add a new :func:`threading.get_native_id` function and a :data:`~threading."
"Thread.native_id` attribute to the :class:`threading.Thread` class. These "
"return the native integral Thread ID of the current thread assigned by the "
"kernel. This feature is only available on certain platforms, see :func:"
"`get_native_id <threading.get_native_id>` for more information. (Contributed "
"by Jake Tesler in :issue:`36084`.)"
msgstr ""
#: whatsnew/3.8.rst:1274
2019-09-04 09:39:22 +00:00
msgid "tokenize"
msgstr ""
#: whatsnew/3.8.rst:1276
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`tokenize` module now implicitly emits a ``NEWLINE`` token when "
"provided with input that does not have a trailing new line. This behavior "
"now matches what the C tokenizer does internally. (Contributed by Ammar "
"Askar in :issue:`33899`.)"
msgstr ""
#: whatsnew/3.8.rst:1283
2019-09-04 09:39:22 +00:00
msgid "tkinter"
2019-09-16 10:08:42 +00:00
msgstr "tkinter"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1285
2019-09-04 09:39:22 +00:00
msgid ""
"Added methods :meth:`~tkinter.Spinbox.selection_from`, :meth:`~tkinter."
"Spinbox.selection_present`, :meth:`~tkinter.Spinbox.selection_range` and :"
"meth:`~tkinter.Spinbox.selection_to` in the :class:`tkinter.Spinbox` class. "
"(Contributed by Juliette Monsel in :issue:`34829`.)"
msgstr ""
#: whatsnew/3.8.rst:1292
2019-09-04 09:39:22 +00:00
msgid ""
"Added method :meth:`~tkinter.Canvas.moveto` in the :class:`tkinter.Canvas` "
"class. (Contributed by Juliette Monsel in :issue:`23831`.)"
msgstr ""
#: whatsnew/3.8.rst:1296
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`tkinter.PhotoImage` class now has :meth:`~tkinter.PhotoImage."
"transparency_get` and :meth:`~tkinter.PhotoImage.transparency_set` methods. "
"(Contributed by Zackery Spytz in :issue:`25451`.)"
msgstr ""
#: whatsnew/3.8.rst:1303
2019-09-04 09:39:22 +00:00
msgid "time"
2019-09-16 10:08:42 +00:00
msgstr "time"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1305
2019-09-04 09:39:22 +00:00
msgid ""
"Added new clock :data:`~time.CLOCK_UPTIME_RAW` for macOS 10.12. (Contributed "
"by Joannah Nanjekye in :issue:`35702`.)"
msgstr ""
#: whatsnew/3.8.rst:1310
2019-09-04 09:39:22 +00:00
msgid "typing"
msgstr ""
#: whatsnew/3.8.rst:1312
2019-09-04 09:39:22 +00:00
msgid "The :mod:`typing` module incorporates several new features:"
msgstr ""
#: whatsnew/3.8.rst:1314
2019-09-04 09:39:22 +00:00
msgid ""
"A dictionary type with per-key types. See :pep:`589` and :class:`typing."
"TypedDict`. TypedDict uses only string keys. By default, every key is "
"required to be present. Specify \"total=False\" to allow keys to be "
"optional::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1324
2019-09-04 09:39:22 +00:00
msgid ""
"Literal types. See :pep:`586` and :class:`typing.Literal`. Literal types "
"indicate that a parameter or return value is constrained to one or more "
"specific literal values::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1331
msgid ""
"\"Final\" variables, functions, methods and classes. See :pep:`591`, :class:"
"`typing.Final` and :func:`typing.final`. The final qualifier instructs a "
"static type checker to restrict subclassing, overriding, or reassignment::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1338
2019-09-04 09:39:22 +00:00
msgid ""
"Protocol definitions. See :pep:`544`, :class:`typing.Protocol` and :func:"
"`typing.runtime_checkable`. Simple ABCs like :class:`typing.SupportsInt` "
"are now ``Protocol`` subclasses."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1342
2019-09-04 09:39:22 +00:00
msgid "New protocol class :class:`typing.SupportsIndex`."
msgstr ""
#: whatsnew/3.8.rst:1344
2019-09-04 09:39:22 +00:00
msgid "New functions :func:`typing.get_origin` and :func:`typing.get_args`."
msgstr ""
#: whatsnew/3.8.rst:1348
2019-09-04 09:39:22 +00:00
msgid "unicodedata"
2019-09-16 10:08:42 +00:00
msgstr "unicodedata"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1350
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`unicodedata` module has been upgraded to use the `Unicode 12.1.0 "
"<https://blog.unicode.org/2019/05/unicode-12-1-en.html>`_ release."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1353
2019-09-04 09:39:22 +00:00
msgid ""
"New function :func:`~unicodedata.is_normalized` can be used to verify a "
"string is in a specific normal form, often much faster than by actually "
"normalizing the string. (Contributed by Max Belanger, David Euresti, and "
"Greg Price in :issue:`32285` and :issue:`37966`)."
msgstr ""
#: whatsnew/3.8.rst:1360
2019-09-04 09:39:22 +00:00
msgid "unittest"
2019-09-16 10:08:42 +00:00
msgstr "unittest"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1362
2019-09-04 09:39:22 +00:00
msgid ""
"Added :class:`~unittest.mock.AsyncMock` to support an asynchronous version "
"of :class:`~unittest.mock.Mock`. Appropriate new assert functions for "
"testing have been added as well. (Contributed by Lisa Roach in :issue:"
"`26467`)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1367
2019-09-04 09:39:22 +00:00
msgid ""
"Added :func:`~unittest.addModuleCleanup()` and :meth:`~unittest.TestCase."
"addClassCleanup()` to unittest to support cleanups for :func:`~unittest."
"setUpModule()` and :meth:`~unittest.TestCase.setUpClass()`. (Contributed by "
"Lisa Roach in :issue:`24412`.)"
msgstr ""
#: whatsnew/3.8.rst:1373
2019-09-04 09:39:22 +00:00
msgid ""
"Several mock assert functions now also print a list of actual calls upon "
"failure. (Contributed by Petter Strandmark in :issue:`35047`.)"
msgstr ""
#: whatsnew/3.8.rst:1376
2019-10-09 16:10:12 +00:00
msgid ""
":mod:`unittest` module gained support for coroutines to be used as test "
"cases with :class:`unittest.IsolatedAsyncioTestCase`. (Contributed by Andrew "
"Svetlov in :issue:`32972`.)"
msgstr ""
#: whatsnew/3.8.rst:1380
2019-10-09 16:10:12 +00:00
msgid "Example::"
msgstr "Exemple ::"
#: whatsnew/3.8.rst:1403
2019-09-04 09:39:22 +00:00
msgid "venv"
2019-09-16 10:08:42 +00:00
msgstr "venv"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1405
2019-09-04 09:39:22 +00:00
msgid ""
":mod:`venv` now includes an ``Activate.ps1`` script on all platforms for "
"activating virtual environments under PowerShell Core 6.1. (Contributed by "
"Brett Cannon in :issue:`32718`.)"
msgstr ""
#: whatsnew/3.8.rst:1411
2019-09-04 09:39:22 +00:00
msgid "weakref"
2019-09-16 10:08:42 +00:00
msgstr "weakref"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1413
2019-09-04 09:39:22 +00:00
msgid ""
"The proxy objects returned by :func:`weakref.proxy` now support the matrix "
"multiplication operators ``@`` and ``@=`` in addition to the other numeric "
"operators. (Contributed by Mark Dickinson in :issue:`36669`.)"
msgstr ""
#: whatsnew/3.8.rst:1419
2019-09-04 09:39:22 +00:00
msgid "xml"
msgstr ""
#: whatsnew/3.8.rst:1421
2019-09-04 09:39:22 +00:00
msgid ""
"As mitigation against DTD and external entity retrieval, the :mod:`xml.dom."
"minidom` and :mod:`xml.sax` modules no longer process external entities by "
"default. (Contributed by Christian Heimes in :issue:`17239`.)"
msgstr ""
#: whatsnew/3.8.rst:1426
2019-09-04 09:39:22 +00:00
msgid ""
"The ``.find*()`` methods in the :mod:`xml.etree.ElementTree` module support "
"wildcard searches like ``{*}tag`` which ignores the namespace and "
"``{namespace}*`` which returns all tags in the given namespace. (Contributed "
"by Stefan Behnel in :issue:`28238`.)"
msgstr ""
#: whatsnew/3.8.rst:1431
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`xml.etree.ElementTree` module provides a new function :func:`xml."
"etree.ElementTree.canonicalize()` that implements C14N 2.0. (Contributed by "
"Stefan Behnel in :issue:`13611`.)"
msgstr ""
#: whatsnew/3.8.rst:1435
2019-09-04 09:39:22 +00:00
msgid ""
"The target object of :class:`xml.etree.ElementTree.XMLParser` can receive "
"namespace declaration events through the new callback methods ``start_ns()`` "
"and ``end_ns()``. Additionally, the :class:`xml.etree.ElementTree."
"TreeBuilder` target can be configured to process events about comments and "
"processing instructions to include them in the generated tree. (Contributed "
"by Stefan Behnel in :issue:`36676` and :issue:`36673`.)"
msgstr ""
#: whatsnew/3.8.rst:1445
msgid "xmlrpc"
2019-12-06 09:55:45 +00:00
msgstr "xmlrpc"
#: whatsnew/3.8.rst:1447
msgid ""
":class:`xmlrpc.client.ServerProxy` now supports an optional *headers* "
"keyword argument for a sequence of HTTP headers to be sent with each "
"request. Among other things, this makes it possible to upgrade from default "
"basic authentication to faster session authentication. (Contributed by "
"Cédric Krier in :issue:`35153`.)"
msgstr ""
#: whatsnew/3.8.rst:1455
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Optimizations"
2020-02-14 10:18:53 +00:00
msgstr "Optimisation"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1457
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`subprocess` module can now use the :func:`os.posix_spawn` function "
"in some cases for better performance. Currently, it is only used on macOS "
"and Linux (using glibc 2.24 or newer) if all these conditions are met:"
msgstr ""
#: whatsnew/3.8.rst:1461
2019-09-04 09:39:22 +00:00
msgid "*close_fds* is false;"
msgstr ""
#: whatsnew/3.8.rst:1462
2019-09-04 09:39:22 +00:00
msgid ""
"*preexec_fn*, *pass_fds*, *cwd* and *start_new_session* parameters are not "
"set;"
msgstr ""
#: whatsnew/3.8.rst:1464
2019-09-04 09:39:22 +00:00
msgid "the *executable* path contains a directory."
msgstr ""
#: whatsnew/3.8.rst:1466
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Joannah Nanjekye and Victor Stinner in :issue:`35537`.)"
msgstr ""
#: whatsnew/3.8.rst:1468
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.copyfile`, :func:`shutil.copy`, :func:`shutil.copy2`, :func:"
2022-03-23 17:40:12 +00:00
"`shutil.copytree` and :func:`shutil.move` use platform-specific \"fast-"
"copy\" syscalls on Linux and macOS in order to copy the file more "
"efficiently. \"fast-copy\" means that the copying operation occurs within "
"the kernel, avoiding the use of userspace buffers in Python as in \"``outfd."
"write(infd.read())``\". On Windows :func:`shutil.copyfile` uses a bigger "
"default buffer size (1 MiB instead of 16 KiB) and a :func:`memoryview`-based "
"variant of :func:`shutil.copyfileobj` is used. The speedup for copying a 512 "
"MiB file within the same partition is about +26% on Linux, +50% on macOS and "
"+40% on Windows. Also, much less CPU cycles are consumed. See :ref:`shutil-"
"platform-dependent-efficient-copy-operations` section. (Contributed by "
"Giampaolo Rodolà in :issue:`33671`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1484
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.copytree` uses :func:`os.scandir` function and all copy "
"functions depending from it use cached :func:`os.stat` values. The speedup "
"for copying a directory with 8000 files is around +9% on Linux, +20% on "
"Windows and +30% on a Windows SMB share. Also the number of :func:`os.stat` "
"syscalls is reduced by 38% making :func:`shutil.copytree` especially faster "
"on network filesystems. (Contributed by Giampaolo Rodolà in :issue:`33695`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1491
2019-09-04 09:39:22 +00:00
msgid ""
"The default protocol in the :mod:`pickle` module is now Protocol 4, first "
"introduced in Python 3.4. It offers better performance and smaller size "
"compared to Protocol 3 available since Python 3.0."
msgstr ""
#: whatsnew/3.8.rst:1495
2019-09-04 09:39:22 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"Removed one :c:type:`Py_ssize_t` member from ``PyGC_Head``. All GC tracked "
2019-09-04 09:39:22 +00:00
"objects (e.g. tuple, list, dict) size is reduced 4 or 8 bytes. (Contributed "
"by Inada Naoki in :issue:`33597`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1499
2019-09-04 09:39:22 +00:00
msgid ""
":class:`uuid.UUID` now uses ``__slots__`` to reduce its memory footprint. "
"(Contributed by Wouter Bolsterlee and Tal Einat in :issue:`30977`)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1502
2019-09-04 09:39:22 +00:00
msgid ""
"Improved performance of :func:`operator.itemgetter` by 33%. Optimized "
"argument handling and added a fast path for the common case of a single non-"
"negative integer index into a tuple (which is the typical use case in the "
"standard library). (Contributed by Raymond Hettinger in :issue:`35664`.)"
msgstr ""
#: whatsnew/3.8.rst:1508
2019-09-04 09:39:22 +00:00
msgid ""
"Sped-up field lookups in :func:`collections.namedtuple`. They are now more "
"than two times faster, making them the fastest form of instance variable "
"lookup in Python. (Contributed by Raymond Hettinger, Pablo Galindo, and Joe "
"Jevnik, Serhiy Storchaka in :issue:`32492`.)"
msgstr ""
#: whatsnew/3.8.rst:1513
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`list` constructor does not overallocate the internal item buffer "
"if the input iterable has a known length (the input implements ``__len__``). "
"This makes the created list 12% smaller on average. (Contributed by Raymond "
"Hettinger and Pablo Galindo in :issue:`33234`.)"
msgstr ""
#: whatsnew/3.8.rst:1518
2019-09-04 09:39:22 +00:00
msgid ""
"Doubled the speed of class variable writes. When a non-dunder attribute was "
"updated, there was an unnecessary call to update slots. (Contributed by "
"Stefan Behnel, Pablo Galindo Salgado, Raymond Hettinger, Neil Schemenauer, "
"and Serhiy Storchaka in :issue:`36012`.)"
msgstr ""
#: whatsnew/3.8.rst:1523
2019-09-04 09:39:22 +00:00
msgid ""
"Reduced an overhead of converting arguments passed to many builtin functions "
"and methods. This sped up calling some simple builtin functions and methods "
"up to 20--50%. (Contributed by Serhiy Storchaka in :issue:`23867`, :issue:"
"`35582` and :issue:`36127`.)"
msgstr ""
#: whatsnew/3.8.rst:1528
2019-09-04 09:39:22 +00:00
msgid ""
"``LOAD_GLOBAL`` instruction now uses new \"per opcode cache\" mechanism. It "
"is about 40% faster now. (Contributed by Yury Selivanov and Inada Naoki in :"
"issue:`26219`.)"
msgstr ""
#: whatsnew/3.8.rst:1534
2019-09-04 09:39:22 +00:00
msgid "Build and C API Changes"
msgstr ""
#: whatsnew/3.8.rst:1536
2019-09-04 09:39:22 +00:00
msgid ""
"Default :data:`sys.abiflags` became an empty string: the ``m`` flag for "
"pymalloc became useless (builds with and without pymalloc are ABI "
"compatible) and so has been removed. (Contributed by Victor Stinner in :"
"issue:`36707`.)"
msgstr ""
#: whatsnew/3.8.rst:1540
2019-09-04 09:39:22 +00:00
msgid "Example of changes:"
msgstr ""
#: whatsnew/3.8.rst:1542
2019-09-04 09:39:22 +00:00
msgid ""
"Only ``python3.8`` program is installed, ``python3.8m`` program is gone."
msgstr ""
#: whatsnew/3.8.rst:1543
2019-09-04 09:39:22 +00:00
msgid ""
"Only ``python3.8-config`` script is installed, ``python3.8m-config`` script "
"is gone."
msgstr ""
#: whatsnew/3.8.rst:1545
2019-09-04 09:39:22 +00:00
msgid ""
"The ``m`` flag has been removed from the suffix of dynamic library "
"filenames: extension modules in the standard library as well as those "
"produced and installed by third-party packages, like those downloaded from "
"PyPI. On Linux, for example, the Python 3.7 suffix ``.cpython-37m-x86_64-"
"linux-gnu.so`` became ``.cpython-38-x86_64-linux-gnu.so`` in Python 3.8."
msgstr ""
#: whatsnew/3.8.rst:1552
2019-09-04 09:39:22 +00:00
msgid ""
"The header files have been reorganized to better separate the different "
"kinds of APIs:"
msgstr ""
#: whatsnew/3.8.rst:1555
2019-09-04 09:39:22 +00:00
msgid "``Include/*.h`` should be the portable public stable C API."
msgstr ""
#: whatsnew/3.8.rst:1556
2019-09-04 09:39:22 +00:00
msgid ""
"``Include/cpython/*.h`` should be the unstable C API specific to CPython; "
"public API, with some private API prefixed by ``_Py`` or ``_PY``."
msgstr ""
#: whatsnew/3.8.rst:1558
2019-09-04 09:39:22 +00:00
msgid ""
"``Include/internal/*.h`` is the private internal C API very specific to "
"CPython. This API comes with no backward compatibility warranty and should "
"not be used outside CPython. It is only exposed for very specific needs like "
"debuggers and profiles which has to access to CPython internals without "
"calling functions. This API is now installed by ``make install``."
msgstr ""
#: whatsnew/3.8.rst:1564
2019-09-04 09:39:22 +00:00
msgid ""
"(Contributed by Victor Stinner in :issue:`35134` and :issue:`35081`, work "
"initiated by Eric Snow in Python 3.7.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1567
2019-09-04 09:39:22 +00:00
msgid ""
"Some macros have been converted to static inline functions: parameter types "
"and return type are well defined, they don't have issues specific to macros, "
"variables have a local scopes. Examples:"
msgstr ""
#: whatsnew/3.8.rst:1571
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_INCREF`, :c:func:`Py_DECREF`"
msgstr ""
#: whatsnew/3.8.rst:1572
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_XINCREF`, :c:func:`Py_XDECREF`"
msgstr ""
#: whatsnew/3.8.rst:1573
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyObject_INIT`, :c:func:`PyObject_INIT_VAR`"
msgstr ""
#: whatsnew/3.8.rst:1574
2019-09-04 09:39:22 +00:00
msgid ""
"Private functions: :c:func:`_PyObject_GC_TRACK`, :c:func:"
"`_PyObject_GC_UNTRACK`, :c:func:`_Py_Dealloc`"
msgstr ""
#: whatsnew/3.8.rst:1577
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Victor Stinner in :issue:`35059`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Victor Stinner; :issue:`12049`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1579
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:func:`PyByteArray_Init` and :c:func:`PyByteArray_Fini` functions have "
"been removed. They did nothing since Python 2.7.4 and Python 3.2.0, were "
"excluded from the limited API (stable ABI), and were not documented. "
"(Contributed by Victor Stinner in :issue:`35713`.)"
msgstr ""
#: whatsnew/3.8.rst:1584
2019-09-04 09:39:22 +00:00
msgid ""
"The result of :c:func:`PyExceptionClass_Name` is now of type ``const char "
"*`` rather of ``char *``. (Contributed by Serhiy Storchaka in :issue:"
"`33818`.)"
msgstr ""
#: whatsnew/3.8.rst:1588
2019-09-04 09:39:22 +00:00
msgid ""
"The duality of ``Modules/Setup.dist`` and ``Modules/Setup`` has been "
"removed. Previously, when updating the CPython source tree, one had to "
"manually copy ``Modules/Setup.dist`` (inside the source tree) to ``Modules/"
"Setup`` (inside the build tree) in order to reflect any changes upstream. "
"This was of a small benefit to packagers at the expense of a frequent "
"annoyance to developers following CPython development, as forgetting to copy "
"the file could produce build failures."
msgstr ""
#: whatsnew/3.8.rst:1596
2019-09-04 09:39:22 +00:00
msgid ""
"Now the build system always reads from ``Modules/Setup`` inside the source "
"tree. People who want to customize that file are encouraged to maintain "
"their changes in a git fork of CPython or as patch files, as they would do "
"for any other change to the source tree."
msgstr ""
#: whatsnew/3.8.rst:1601
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Antoine Pitrou in :issue:`32430`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Antoine Pitrou; :issue:`9260`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1603
2019-09-04 09:39:22 +00:00
msgid ""
"Functions that convert Python number to C integer like :c:func:"
"`PyLong_AsLong` and argument parsing functions like :c:func:"
"`PyArg_ParseTuple` with integer converting format units like ``'i'`` will "
"now use the :meth:`~object.__index__` special method instead of :meth:"
"`~object.__int__`, if available. The deprecation warning will be emitted "
"for objects with the ``__int__()`` method but without the ``__index__()`` "
"method (like :class:`~decimal.Decimal` and :class:`~fractions.Fraction`). :"
"c:func:`PyNumber_Check` will now return ``1`` for objects implementing "
"``__index__()``. :c:func:`PyNumber_Long`, :c:func:`PyNumber_Float` and :c:"
"func:`PyFloat_AsDouble` also now use the ``__index__()`` method if "
"available. (Contributed by Serhiy Storchaka in :issue:`36048` and :issue:"
"`20092`.)"
msgstr ""
#: whatsnew/3.8.rst:1617
2019-09-04 09:39:22 +00:00
msgid ""
"Heap-allocated type objects will now increase their reference count in :c:"
"func:`PyObject_Init` (and its parallel macro ``PyObject_INIT``) instead of "
"in :c:func:`PyType_GenericAlloc`. Types that modify instance allocation or "
"deallocation may need to be adjusted. (Contributed by Eddie Elizondo in :"
"issue:`35810`.)"
msgstr ""
#: whatsnew/3.8.rst:1623
2019-09-04 09:39:22 +00:00
msgid ""
"The new function :c:func:`PyCode_NewWithPosOnlyArgs` allows to create code "
"objects like :c:func:`PyCode_New`, but with an extra *posonlyargcount* "
"parameter for indicating the number of positional-only arguments. "
"(Contributed by Pablo Galindo in :issue:`37221`.)"
msgstr ""
#: whatsnew/3.8.rst:1628
2019-10-09 16:10:12 +00:00
msgid ""
":c:func:`Py_SetPath` now sets :data:`sys.executable` to the program full "
"path (:c:func:`Py_GetProgramFullPath`) rather than to the program name (:c:"
"func:`Py_GetProgramName`). (Contributed by Victor Stinner in :issue:`38234`.)"
msgstr ""
#: whatsnew/3.8.rst:1635
2019-09-04 09:39:22 +00:00
msgid "Deprecated"
msgstr ""
#: whatsnew/3.8.rst:1637
2019-09-04 09:39:22 +00:00
msgid ""
"The distutils ``bdist_wininst`` command is now deprecated, use "
"``bdist_wheel`` (wheel packages) instead. (Contributed by Victor Stinner in :"
"issue:`37481`.)"
msgstr ""
#: whatsnew/3.8.rst:1641
2019-09-04 09:39:22 +00:00
msgid ""
"Deprecated methods ``getchildren()`` and ``getiterator()`` in the :mod:`~xml."
"etree.ElementTree` module now emit a :exc:`DeprecationWarning` instead of :"
2019-09-04 09:39:22 +00:00
"exc:`PendingDeprecationWarning`. They will be removed in Python 3.9. "
"(Contributed by Serhiy Storchaka in :issue:`29209`.)"
msgstr ""
#: whatsnew/3.8.rst:1647
2019-09-04 09:39:22 +00:00
msgid ""
"Passing an object that is not an instance of :class:`concurrent.futures."
"ThreadPoolExecutor` to :meth:`loop.set_default_executor() <asyncio.loop."
"set_default_executor>` is deprecated and will be prohibited in Python 3.9. "
"(Contributed by Elvis Pranskevichus in :issue:`34075`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1653
2019-09-04 09:39:22 +00:00
msgid ""
"The :meth:`__getitem__` methods of :class:`xml.dom.pulldom.DOMEventStream`, :"
"class:`wsgiref.util.FileWrapper` and :class:`fileinput.FileInput` have been "
"deprecated."
msgstr ""
#: whatsnew/3.8.rst:1657
2019-09-04 09:39:22 +00:00
msgid ""
"Implementations of these methods have been ignoring their *index* parameter, "
"and returning the next item instead. (Contributed by Berker Peksag in :issue:"
"`9372`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1661
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`typing.NamedTuple` class has deprecated the ``_field_types`` "
"attribute in favor of the ``__annotations__`` attribute which has the same "
"information. (Contributed by Raymond Hettinger in :issue:`36320`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1665
2019-09-04 09:39:22 +00:00
msgid ""
":mod:`ast` classes ``Num``, ``Str``, ``Bytes``, ``NameConstant`` and "
"``Ellipsis`` are considered deprecated and will be removed in future Python "
"versions. :class:`~ast.Constant` should be used instead. (Contributed by "
"Serhiy Storchaka in :issue:`32892`.)"
msgstr ""
#: whatsnew/3.8.rst:1670
2019-09-04 09:39:22 +00:00
msgid ""
":class:`ast.NodeVisitor` methods ``visit_Num()``, ``visit_Str()``, "
"``visit_Bytes()``, ``visit_NameConstant()`` and ``visit_Ellipsis()`` are "
"deprecated now and will not be called in future Python versions. Add the :"
"meth:`~ast.NodeVisitor.visit_Constant` method to handle all constant nodes. "
"(Contributed by Serhiy Storchaka in :issue:`36917`.)"
msgstr ""
#: whatsnew/3.8.rst:1677
msgid ""
"The :func:`asyncio.coroutine` :term:`decorator` is deprecated and will be "
"removed in version 3.10. Instead of ``@asyncio.coroutine``, use :keyword:"
"`async def` instead. (Contributed by Andrew Svetlov in :issue:`36921`.)"
msgstr ""
#: whatsnew/3.8.rst:1682
msgid ""
"In :mod:`asyncio`, the explicit passing of a *loop* argument has been "
"deprecated and will be removed in version 3.10 for the following: :func:"
"`asyncio.sleep`, :func:`asyncio.gather`, :func:`asyncio.shield`, :func:"
"`asyncio.wait_for`, :func:`asyncio.wait`, :func:`asyncio.as_completed`, :"
"class:`asyncio.Task`, :class:`asyncio.Lock`, :class:`asyncio.Event`, :class:"
"`asyncio.Condition`, :class:`asyncio.Semaphore`, :class:`asyncio."
"BoundedSemaphore`, :class:`asyncio.Queue`, :func:`asyncio."
"create_subprocess_exec`, and :func:`asyncio.create_subprocess_shell`."
msgstr ""
#: whatsnew/3.8.rst:1692
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 in :issue:`34790`.)"
msgstr ""
#: whatsnew/3.8.rst:1696
2019-09-04 09:39:22 +00:00
msgid ""
"The following functions and methods are deprecated in the :mod:`gettext` "
"module: :func:`~gettext.lgettext`, :func:`~gettext.ldgettext`, :func:"
"`~gettext.lngettext` and :func:`~gettext.ldngettext`. They return encoded "
"bytes, and it's possible that you will get unexpected Unicode-related "
"exceptions if there are encoding problems with the translated strings. It's "
"much better to use alternatives which return Unicode strings in Python 3. "
"These functions have been broken for a long time."
msgstr ""
#: whatsnew/3.8.rst:1704
2019-09-04 09:39:22 +00:00
msgid ""
"Function :func:`~gettext.bind_textdomain_codeset`, methods :meth:`~gettext."
"NullTranslations.output_charset` and :meth:`~gettext.NullTranslations."
"set_output_charset`, and the *codeset* parameter of functions :func:"
"`~gettext.translation` and :func:`~gettext.install` are also deprecated, "
2020-10-02 08:55:01 +00:00
"since they are only used for the ``l*gettext()`` functions. (Contributed by "
"Serhiy Storchaka in :issue:`33710`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1712
2019-09-04 09:39:22 +00:00
msgid ""
"The :meth:`~threading.Thread.isAlive()` method of :class:`threading.Thread` "
"has been deprecated. (Contributed by Dong-hee Na in :issue:`35283`.)"
msgstr ""
#: whatsnew/3.8.rst:1716
2019-09-04 09:39:22 +00:00
msgid ""
"Many builtin and extension functions that take integer arguments will now "
"emit a deprecation warning for :class:`~decimal.Decimal`\\ s, :class:"
"`~fractions.Fraction`\\ s and any other objects that can be converted to "
"integers only with a loss (e.g. that have the :meth:`~object.__int__` method "
"but do not have the :meth:`~object.__index__` method). In future version "
"they will be errors. (Contributed by Serhiy Storchaka in :issue:`36048`.)"
msgstr ""
#: whatsnew/3.8.rst:1724
2019-09-04 09:39:22 +00:00
msgid "Deprecated passing the following arguments as keyword arguments:"
msgstr ""
#: whatsnew/3.8.rst:1726
2019-09-04 09:39:22 +00:00
msgid ""
"*func* in :func:`functools.partialmethod`, :func:`weakref.finalize`, :meth:"
"`profile.Profile.runcall`, :meth:`cProfile.Profile.runcall`, :meth:`bdb.Bdb."
"runcall`, :meth:`trace.Trace.runfunc` and :func:`curses.wrapper`."
msgstr ""
#: whatsnew/3.8.rst:1730
2019-09-04 09:39:22 +00:00
msgid "*function* in :meth:`unittest.TestCase.addCleanup`."
msgstr ""
#: whatsnew/3.8.rst:1731
2019-09-04 09:39:22 +00:00
msgid ""
"*fn* in the :meth:`~concurrent.futures.Executor.submit` method of :class:"
"`concurrent.futures.ThreadPoolExecutor` and :class:`concurrent.futures."
"ProcessPoolExecutor`."
msgstr ""
#: whatsnew/3.8.rst:1734
2019-09-04 09:39:22 +00:00
msgid ""
"*callback* in :meth:`contextlib.ExitStack.callback`, :meth:`contextlib."
"AsyncExitStack.callback` and :meth:`contextlib.AsyncExitStack."
"push_async_callback`."
msgstr ""
#: whatsnew/3.8.rst:1737
2019-09-04 09:39:22 +00:00
msgid ""
"*c* and *typeid* in the :meth:`~multiprocessing.managers.Server.create` "
"method of :class:`multiprocessing.managers.Server` and :class:"
"`multiprocessing.managers.SharedMemoryServer`."
msgstr ""
#: whatsnew/3.8.rst:1740
2019-09-04 09:39:22 +00:00
msgid "*obj* in :func:`weakref.finalize`."
msgstr ""
#: whatsnew/3.8.rst:1742
2019-09-04 09:39:22 +00:00
msgid ""
"In future releases of Python, they will be :ref:`positional-only <positional-"
2019-09-04 09:39:22 +00:00
"only_parameter>`. (Contributed by Serhiy Storchaka in :issue:`36492`.)"
msgstr ""
#: whatsnew/3.8.rst:1748
2019-09-04 09:39:22 +00:00
msgid "API and Feature Removals"
msgstr ""
#: whatsnew/3.8.rst:1750
2019-09-04 09:39:22 +00:00
msgid "The following features and APIs have been removed from Python 3.8:"
msgstr ""
#: whatsnew/3.8.rst:1752
msgid ""
"Starting with Python 3.3, importing ABCs from :mod:`collections` was "
"deprecated, and importing should be done from :mod:`collections.abc`. Being "
"able to import from collections was marked for removal in 3.8, but has been "
"delayed to 3.9. (See :issue:`36952`.)"
msgstr ""
#: whatsnew/3.8.rst:1757
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`macpath` module, deprecated in Python 3.7, has been removed. "
"(Contributed by Victor Stinner in :issue:`35471`.)"
msgstr ""
#: whatsnew/3.8.rst:1879
2019-09-04 09:39:22 +00:00
msgid ""
"The function :func:`platform.popen` has been removed, after having been "
"deprecated since Python 3.3: use :func:`os.popen` instead. (Contributed by "
"Victor Stinner in :issue:`35345`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1764
2019-09-04 09:39:22 +00:00
msgid ""
"The function :func:`time.clock` has been removed, after having been "
"deprecated since Python 3.3: use :func:`time.perf_counter` or :func:`time."
"process_time` instead, depending on your requirements, to have well-defined "
"behavior. (Contributed by Matthias Bussonnier in :issue:`36895`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1770
2019-09-04 09:39:22 +00:00
msgid ""
"The ``pyvenv`` script has been removed in favor of ``python3.8 -m venv`` to "
"help eliminate confusion as to what Python interpreter the ``pyvenv`` script "
"is tied to. (Contributed by Brett Cannon in :issue:`25427`.)"
msgstr ""
#: whatsnew/3.8.rst:1774
2019-09-04 09:39:22 +00:00
msgid ""
"``parse_qs``, ``parse_qsl``, and ``escape`` are removed from the :mod:`cgi` "
"module. They are deprecated in Python 3.2 or older. They should be imported "
"from the ``urllib.parse`` and ``html`` modules instead."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1778
2019-09-04 09:39:22 +00:00
msgid ""
"``filemode`` function is removed from the :mod:`tarfile` module. It is not "
2019-09-04 09:39:22 +00:00
"documented and deprecated since Python 3.3."
msgstr ""
#: whatsnew/3.8.rst:1781
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`~xml.etree.ElementTree.XMLParser` constructor no longer accepts "
"the *html* argument. It never had an effect and was deprecated in Python "
"3.4. All other parameters are now :ref:`keyword-only <keyword-"
"only_parameter>`. (Contributed by Serhiy Storchaka in :issue:`29209`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1786
2019-09-04 09:39:22 +00:00
msgid ""
"Removed the ``doctype()`` method of :class:`~xml.etree.ElementTree."
"XMLParser`. (Contributed by Serhiy Storchaka in :issue:`29209`.)"
msgstr ""
#: whatsnew/3.8.rst:1789
2019-09-04 09:39:22 +00:00
msgid ""
"\"unicode_internal\" codec is removed. (Contributed by Inada Naoki in :issue:"
"`36297`.)"
msgstr ""
#: whatsnew/3.8.rst:1792
2019-09-04 09:39:22 +00:00
msgid ""
"The ``Cache`` and ``Statement`` objects of the :mod:`sqlite3` module are not "
"exposed to the user. (Contributed by Aviv Palivoda in :issue:`30262`.)"
msgstr ""
#: whatsnew/3.8.rst:1796
2019-09-04 09:39:22 +00:00
msgid ""
"The ``bufsize`` keyword argument of :func:`fileinput.input` and :func:"
"`fileinput.FileInput` which was ignored and deprecated since Python 3.6 has "
"been removed. :issue:`36952` (Contributed by Matthias Bussonnier.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1800
2019-09-04 09:39:22 +00:00
msgid ""
"The functions :func:`sys.set_coroutine_wrapper` and :func:`sys."
"get_coroutine_wrapper` deprecated in Python 3.7 have been removed; :issue:"
"`36933` (Contributed by Matthias Bussonnier.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1806
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Porting to Python 3.8"
2020-02-14 10:18:53 +00:00
msgstr "Portage vers Python 3.1"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:1808
2019-09-04 09:39:22 +00:00
msgid ""
"This section lists previously described changes and other bugfixes that may "
"require changes to your code."
msgstr ""
#: whatsnew/3.8.rst:1813
2019-09-04 09:39:22 +00:00
msgid "Changes in Python behavior"
msgstr ""
#: whatsnew/3.8.rst:1815
2019-09-04 09:39:22 +00:00
msgid ""
"Yield expressions (both ``yield`` and ``yield from`` clauses) are now "
"disallowed in comprehensions and generator expressions (aside from the "
"iterable expression in the leftmost :keyword:`!for` clause). (Contributed by "
"Serhiy Storchaka in :issue:`10544`.)"
msgstr ""
#: whatsnew/3.8.rst:1820
2019-09-04 09:39:22 +00:00
msgid ""
"The compiler now produces a :exc:`SyntaxWarning` when identity checks "
"(``is`` and ``is not``) are used with certain types of literals (e.g. "
"strings, numbers). These can often work by accident in CPython, but are not "
2019-09-04 09:39:22 +00:00
"guaranteed by the language spec. The warning advises users to use equality "
"tests (``==`` and ``!=``) instead. (Contributed by Serhiy Storchaka in :"
"issue:`34850`.)"
msgstr ""
#: whatsnew/3.8.rst:1827
2019-09-04 09:39:22 +00:00
msgid ""
"The CPython interpreter can swallow exceptions in some circumstances. In "
"Python 3.8 this happens in fewer cases. In particular, exceptions raised "
"when getting the attribute from the type dictionary are no longer ignored. "
2019-09-04 09:39:22 +00:00
"(Contributed by Serhiy Storchaka in :issue:`35459`.)"
msgstr ""
#: whatsnew/3.8.rst:1832
2019-09-04 09:39:22 +00:00
msgid ""
"Removed ``__str__`` implementations from builtin types :class:`bool`, :class:"
"`int`, :class:`float`, :class:`complex` and few classes from the standard "
"library. They now inherit ``__str__()`` from :class:`object`. As result, "
"defining the ``__repr__()`` method in the subclass of these classes will "
"affect their string representation. (Contributed by Serhiy Storchaka in :"
2019-09-04 09:39:22 +00:00
"issue:`36793`.)"
msgstr ""
#: whatsnew/3.8.rst:1839
2019-09-04 09:39:22 +00:00
msgid ""
"On AIX, :attr:`sys.platform` doesn't contain the major version anymore. It "
"is always ``'aix'``, instead of ``'aix3'`` .. ``'aix7'``. Since older "
"Python versions include the version number, so it is recommended to always "
"use ``sys.platform.startswith('aix')``. (Contributed by M. Felt in :issue:"
2019-09-04 09:39:22 +00:00
"`36588`.)"
msgstr ""
#: whatsnew/3.8.rst:1845
2019-09-04 09:39:22 +00:00
msgid ""
":c:func:`PyEval_AcquireLock` and :c:func:`PyEval_AcquireThread` now "
"terminate the current thread if called while the interpreter is finalizing, "
"making them consistent with :c:func:`PyEval_RestoreThread`, :c:func:"
"`Py_END_ALLOW_THREADS`, and :c:func:`PyGILState_Ensure`. If this behavior is "
"not desired, guard the call by checking :c:func:`_Py_IsFinalizing` or :c:"
"func:`sys.is_finalizing`. (Contributed by Joannah Nanjekye in :issue:"
"`36475`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1855
2019-09-04 09:39:22 +00:00
msgid "Changes in the Python API"
msgstr ""
#: whatsnew/3.8.rst:1857
2019-09-04 09:39:22 +00:00
msgid ""
"The :func:`os.getcwdb` function now uses the UTF-8 encoding on Windows, "
"rather than the ANSI code page: see :pep:`529` for the rationale. The "
"function is no longer deprecated on Windows. (Contributed by Victor Stinner "
"in :issue:`37412`.)"
msgstr ""
#: whatsnew/3.8.rst:1862
2019-09-04 09:39:22 +00:00
msgid ""
":class:`subprocess.Popen` can now use :func:`os.posix_spawn` in some cases "
"for better performance. On Windows Subsystem for Linux and QEMU User "
"Emulation, the :class:`Popen` constructor using :func:`os.posix_spawn` no "
"longer raises an exception on errors like \"missing program\". Instead the "
"child process fails with a non-zero :attr:`~Popen.returncode`. (Contributed "
"by Joannah Nanjekye and Victor Stinner in :issue:`35537`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1869
2019-09-04 09:39:22 +00:00
msgid ""
"The *preexec_fn* argument of * :class:`subprocess.Popen` is no longer "
"compatible with subinterpreters. The use of the parameter in a "
"subinterpreter now raises :exc:`RuntimeError`. (Contributed by Eric Snow in :"
"issue:`34651`, modified by Christian Heimes in :issue:`37951`.)"
msgstr ""
#: whatsnew/3.8.rst:1875
2019-09-04 09:39:22 +00:00
msgid ""
"The :meth:`imap.IMAP4.logout` method no longer silently ignores arbitrary "
"exceptions. (Contributed by Victor Stinner in :issue:`36348`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1883
2019-09-04 09:39:22 +00:00
msgid ""
"The :func:`statistics.mode` function no longer raises an exception when "
"given multimodal data. Instead, it returns the first mode encountered in "
"the input data. (Contributed by Raymond Hettinger in :issue:`35892`.)"
msgstr ""
#: whatsnew/3.8.rst:1888
2019-09-04 09:39:22 +00:00
msgid ""
"The :meth:`~tkinter.ttk.Treeview.selection` method of the :class:`tkinter."
"ttk.Treeview` class no longer takes arguments. Using it with arguments for "
"changing the selection was deprecated in Python 3.6. Use specialized "
"methods like :meth:`~tkinter.ttk.Treeview.selection_set` for changing the "
"selection. (Contributed by Serhiy Storchaka in :issue:`31508`.)"
msgstr ""
#: whatsnew/3.8.rst:1894
2019-09-04 09:39:22 +00:00
msgid ""
"The :meth:`writexml`, :meth:`toxml` and :meth:`toprettyxml` methods of :mod:"
"`xml.dom.minidom`, and the :meth:`write` method of :mod:`xml.etree`, now "
"preserve the attribute order specified by the user. (Contributed by Diego "
"Rojas and Raymond Hettinger in :issue:`34160`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1899
2019-09-04 09:39:22 +00:00
msgid ""
"A :mod:`dbm.dumb` database opened with flags ``'r'`` is now read-only. :func:"
"`dbm.dumb.open` with flags ``'r'`` and ``'w'`` no longer creates a database "
"if it does not exist. (Contributed by Serhiy Storchaka in :issue:`32749`.)"
msgstr ""
#: whatsnew/3.8.rst:1904
2019-09-04 09:39:22 +00:00
msgid ""
"The ``doctype()`` method defined in a subclass of :class:`~xml.etree."
"ElementTree.XMLParser` will no longer be called and will emit a :exc:"
"`RuntimeWarning` instead of a :exc:`DeprecationWarning`. Define the :meth:"
"`doctype() <xml.etree.ElementTree.TreeBuilder.doctype>` method on a target "
"for handling an XML doctype declaration. (Contributed by Serhiy Storchaka "
"in :issue:`29209`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1911
2019-09-04 09:39:22 +00:00
msgid ""
"A :exc:`RuntimeError` is now raised when the custom metaclass doesn't "
"provide the ``__classcell__`` entry in the namespace passed to ``type."
"__new__``. A :exc:`DeprecationWarning` was emitted in Python 3.6--3.7. "
"(Contributed by Serhiy Storchaka in :issue:`23722`.)"
msgstr ""
#: whatsnew/3.8.rst:1916
2019-09-04 09:39:22 +00:00
msgid ""
"The :class:`cProfile.Profile` class can now be used as a context manager. "
"(Contributed by Scott Sanderson in :issue:`29235`.)"
msgstr ""
#: whatsnew/3.8.rst:1919
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.copyfile`, :func:`shutil.copy`, :func:`shutil.copy2`, :func:"
2022-03-23 17:40:12 +00:00
"`shutil.copytree` and :func:`shutil.move` use platform-specific \"fast-"
"copy\" syscalls (see :ref:`shutil-platform-dependent-efficient-copy-"
"operations` section)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1924
2019-09-04 09:39:22 +00:00
msgid ""
":func:`shutil.copyfile` default buffer size on Windows was changed from 16 "
"KiB to 1 MiB."
msgstr ""
#: whatsnew/3.8.rst:1927
2019-09-04 09:39:22 +00:00
msgid ""
"The ``PyGC_Head`` struct has changed completely. All code that touched the "
"struct member should be rewritten. (See :issue:`33597`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1930
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:type:`PyInterpreterState` struct has been moved into the \"internal\" "
2019-09-04 09:39:22 +00:00
"header files (specifically Include/internal/pycore_pystate.h). An opaque "
"``PyInterpreterState`` is still available as part of the public API (and "
"stable ABI). The docs indicate that none of the struct's fields are public, "
"so we hope no one has been using them. However, if you do rely on one or "
"more of those private fields and have no alternative then please open a BPO "
"issue. We'll work on helping you adjust (possibly including adding accessor "
"functions to the public API). (See :issue:`35886`.)"
msgstr ""
#: whatsnew/3.8.rst:1940
2019-09-04 09:39:22 +00:00
msgid ""
"The :meth:`mmap.flush() <mmap.mmap.flush>` method now returns ``None`` on "
"success and raises an exception on error under all platforms. Previously, "
"its behavior was platform-dependent: a nonzero value was returned on "
"success; zero was returned on error under Windows. A zero value was "
"returned on success; an exception was raised on error under Unix. "
"(Contributed by Berker Peksag in :issue:`2122`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1947
2019-09-04 09:39:22 +00:00
msgid ""
":mod:`xml.dom.minidom` and :mod:`xml.sax` modules no longer process external "
"entities by default. (Contributed by Christian Heimes in :issue:`17239`.)"
msgstr ""
#: whatsnew/3.8.rst:1951
2019-09-04 09:39:22 +00:00
msgid ""
"Deleting a key from a read-only :mod:`dbm` database (:mod:`dbm.dumb`, :mod:"
"`dbm.gnu` or :mod:`dbm.ndbm`) raises :attr:`error` (:exc:`dbm.dumb.error`, :"
"exc:`dbm.gnu.error` or :exc:`dbm.ndbm.error`) instead of :exc:`KeyError`. "
"(Contributed by Xiang Zhang in :issue:`33106`.)"
msgstr ""
#: whatsnew/3.8.rst:1956
2020-05-24 14:31:50 +00:00
msgid ""
"Simplified AST for literals. All constants will be represented as :class:"
"`ast.Constant` instances. Instantiating old classes ``Num``, ``Str``, "
"``Bytes``, ``NameConstant`` and ``Ellipsis`` will return an instance of "
"``Constant``. (Contributed by Serhiy Storchaka in :issue:`32892`.)"
msgstr ""
#: whatsnew/3.8.rst:1972
msgid ""
"The function :func:`asyncio.wait_for` now correctly waits for cancellation "
"when using an instance of :class:`asyncio.Task`. Previously, upon reaching "
"*timeout*, it was cancelled and immediately returned. (Contributed by Elvis "
"Pranskevichus in :issue:`32751`.)"
msgstr ""
#: whatsnew/3.8.rst:1977
msgid ""
"The function :func:`asyncio.BaseTransport.get_extra_info` now returns a safe "
"to use socket object when 'socket' is passed to the *name* parameter. "
"(Contributed by Yury Selivanov in :issue:`37027`.)"
msgstr ""
#: whatsnew/3.8.rst:1981
msgid ":class:`asyncio.BufferedProtocol` has graduated to the stable API."
msgstr ""
#: whatsnew/3.8.rst:1985
2019-09-04 09:39:22 +00:00
msgid ""
"DLL dependencies for extension modules and DLLs loaded with :mod:`ctypes` on "
"Windows are now resolved more securely. Only the system paths, the directory "
"containing the DLL or PYD file, and directories added with :func:`~os."
"add_dll_directory` are searched for load-time dependencies. Specifically, :"
"envvar:`PATH` and the current working directory are no longer used, and "
"modifications to these will no longer have any effect on normal DLL "
"resolution. If your application relies on these mechanisms, you should check "
"for :func:`~os.add_dll_directory` and if it exists, use it to add your DLLs "
"directory while loading your library. Note that Windows 7 users will need to "
"ensure that Windows Update KB2533623 has been installed (this is also "
"verified by the installer). (Contributed by Steve Dower in :issue:`36085`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:1998
2019-09-04 09:39:22 +00:00
msgid ""
"The header files and functions related to pgen have been removed after its "
"replacement by a pure Python implementation. (Contributed by Pablo Galindo "
"in :issue:`36623`.)"
msgstr ""
#: whatsnew/3.8.rst:2002
2019-09-04 09:39:22 +00:00
msgid ""
":class:`types.CodeType` has a new parameter in the second position of the "
"constructor (*posonlyargcount*) to support positional-only arguments defined "
"in :pep:`570`. The first argument (*argcount*) now represents the total "
"number of positional arguments (including positional-only arguments). The "
"new ``replace()`` method of :class:`types.CodeType` can be used to make the "
"code future-proof."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:2009
msgid ""
"The parameter ``digestmod`` for :func:`hmac.new` no longer uses the MD5 "
"digest by default."
msgstr ""
#: whatsnew/3.8.rst:2013
2019-09-04 09:39:22 +00:00
msgid "Changes in the C API"
msgstr ""
#: whatsnew/3.8.rst:2015
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:struct:`PyCompilerFlags` structure got a new *cf_feature_version* "
2019-09-04 09:39:22 +00:00
"field. It should be initialized to ``PY_MINOR_VERSION``. The field is "
"ignored by default, and is used if and only if ``PyCF_ONLY_AST`` flag is set "
"in *cf_flags*. (Contributed by Guido van Rossum in :issue:`35766`.)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:2021
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:func:`PyEval_ReInitThreads` function has been removed from the C API. "
"It should not be called explicitly: use :c:func:`PyOS_AfterFork_Child` "
"instead. (Contributed by Victor Stinner in :issue:`36728`.)"
msgstr ""
#: whatsnew/3.8.rst:2026
2019-09-04 09:39:22 +00:00
msgid ""
"On Unix, C extensions are no longer linked to libpython except on Android "
"and Cygwin. When Python is embedded, ``libpython`` must not be loaded with "
"``RTLD_LOCAL``, but ``RTLD_GLOBAL`` instead. Previously, using "
"``RTLD_LOCAL``, it was already not possible to load C extensions which were "
"not linked to ``libpython``, like C extensions of the standard library built "
"by the ``*shared*`` section of ``Modules/Setup``. (Contributed by Victor "
"Stinner in :issue:`21536`.)"
msgstr ""
#: whatsnew/3.8.rst:2034
2019-09-04 09:39:22 +00:00
msgid ""
"Use of ``#`` variants of formats in parsing or building value (e.g. :c:func:"
"`PyArg_ParseTuple`, :c:func:`Py_BuildValue`, :c:func:"
"`PyObject_CallFunction`, etc.) without ``PY_SSIZE_T_CLEAN`` defined raises "
"``DeprecationWarning`` now. It will be removed in 3.10 or 4.0. Read :ref:"
"`arg-parsing` for detail. (Contributed by Inada Naoki in :issue:`36381`.)"
msgstr ""
#: whatsnew/3.8.rst:2040
2019-09-04 09:39:22 +00:00
msgid ""
"Instances of heap-allocated types (such as those created with :c:func:"
"`PyType_FromSpec`) hold a reference to their type object. Increasing the "
"reference count of these type objects has been moved from :c:func:"
"`PyType_GenericAlloc` to the more low-level functions, :c:func:"
"`PyObject_Init` and :c:func:`PyObject_INIT`. This makes types created "
"through :c:func:`PyType_FromSpec` behave like other classes in managed code."
msgstr ""
#: whatsnew/3.8.rst:2048
msgid ":ref:`Statically allocated types <static-types>` are not affected."
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:2050
2019-09-04 09:39:22 +00:00
msgid ""
"For the vast majority of cases, there should be no side effect. However, "
"types that manually increase the reference count after allocating an "
"instance (perhaps to work around the bug) may now become immortal. To avoid "
"this, these classes need to call Py_DECREF on the type object during "
"instance deallocation."
msgstr ""
#: whatsnew/3.8.rst:2056
2019-09-04 09:39:22 +00:00
msgid ""
"To correctly port these types into 3.8, please apply the following changes:"
msgstr ""
#: whatsnew/3.8.rst:2059
2019-09-04 09:39:22 +00:00
msgid ""
"Remove :c:macro:`Py_INCREF` on the type object after allocating an instance "
"- if any. This may happen after calling :c:func:`PyObject_New`, :c:func:"
"`PyObject_NewVar`, :c:func:`PyObject_GC_New`, :c:func:`PyObject_GC_NewVar`, "
"or any other custom allocator that uses :c:func:`PyObject_Init` or :c:func:"
"`PyObject_INIT`."
msgstr ""
#: whatsnew/3.8.rst:2085 whatsnew/3.8.rst:2104
msgid "Example:"
msgstr "Exemple :"
#: whatsnew/3.8.rst:2082
2019-09-04 09:39:22 +00:00
msgid ""
"Ensure that all custom ``tp_dealloc`` functions of heap-allocated types "
"decrease the type's reference count."
msgstr ""
#: whatsnew/3.8.rst:2099
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Eddie Elizondo in :issue:`35810`.)"
msgstr ""
#: whatsnew/3.8.rst:2101
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:macro:`Py_DEPRECATED()` macro has been implemented for MSVC. The "
"macro now must be placed before the symbol name."
msgstr ""
#: whatsnew/3.8.rst:2110
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Zackery Spytz in :issue:`33407`.)"
msgstr ""
#: whatsnew/3.8.rst:2112
2019-09-04 09:39:22 +00:00
msgid ""
"The interpreter does not pretend to support binary compatibility of "
"extension types across feature releases, anymore. A :c:type:`PyTypeObject` "
"exported by a third-party extension module is supposed to have all the slots "
"expected in the current Python version, including :c:member:`~PyTypeObject."
"tp_finalize` (:const:`Py_TPFLAGS_HAVE_FINALIZE` is not checked anymore "
"before reading :c:member:`~PyTypeObject.tp_finalize`)."
msgstr ""
#: whatsnew/3.8.rst:2119
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "(Contributed by Antoine Pitrou in :issue:`32388`.)"
2020-02-14 10:18:53 +00:00
msgstr "(Contribution par Antoine Pitrou; :issue:`13748`.)"
2019-09-04 09:39:22 +00:00
#: whatsnew/3.8.rst:2121
2019-09-04 09:39:22 +00:00
msgid ""
"The functions :c:func:`PyNode_AddChild` and :c:func:`PyParser_AddToken` now "
"accept two additional ``int`` arguments *end_lineno* and *end_col_offset*."
msgstr ""
#: whatsnew/3.8.rst:2124
2019-09-04 09:39:22 +00:00
msgid ""
"The :file:`libpython38.a` file to allow MinGW tools to link directly "
"against :file:`python38.dll` is no longer included in the regular Windows "
"distribution. If you require this file, it may be generated with the "
"``gendef`` and ``dlltool`` tools, which are part of the MinGW binutils "
"package:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: whatsnew/3.8.rst:2134
2019-09-04 09:39:22 +00:00
msgid ""
"The location of an installed :file:`pythonXY.dll` will depend on the "
"installation options and the version and language of Windows. See :ref:"
"`using-on-windows` for more information. The resulting library should be "
"placed in the same directory as :file:`pythonXY.lib`, which is generally "
"the :file:`libs` directory under your Python installation."
msgstr ""
#: whatsnew/3.8.rst:2140
msgid "(Contributed by Steve Dower in :issue:`37351`.)"
msgstr ""
#: whatsnew/3.8.rst:2144
2019-09-04 09:39:22 +00:00
msgid "CPython bytecode changes"
msgstr ""
#: whatsnew/3.8.rst:2146
2019-09-04 09:39:22 +00:00
msgid ""
"The interpreter loop has been simplified by moving the logic of unrolling "
"the stack of blocks into the compiler. The compiler emits now explicit "
"instructions for adjusting the stack of values and calling the cleaning-up "
"code for :keyword:`break`, :keyword:`continue` and :keyword:`return`."
msgstr ""
#: whatsnew/3.8.rst:2152
2019-09-04 09:39:22 +00:00
msgid ""
"Removed opcodes :opcode:`BREAK_LOOP`, :opcode:`CONTINUE_LOOP`, :opcode:"
"`SETUP_LOOP` and :opcode:`SETUP_EXCEPT`. Added new opcodes :opcode:"
"`ROT_FOUR`, :opcode:`BEGIN_FINALLY`, :opcode:`CALL_FINALLY` and :opcode:"
"`POP_FINALLY`. Changed the behavior of :opcode:`END_FINALLY` and :opcode:"
"`WITH_CLEANUP_START`."
msgstr ""
#: whatsnew/3.8.rst:2158
2019-09-04 09:39:22 +00:00
msgid ""
"(Contributed by Mark Shannon, Antoine Pitrou and Serhiy Storchaka in :issue:"
"`17611`.)"
msgstr ""
#: whatsnew/3.8.rst:2161
2019-09-04 09:39:22 +00:00
msgid ""
"Added new opcode :opcode:`END_ASYNC_FOR` for handling exceptions raised when "
"awaiting a next item in an :keyword:`async for` loop. (Contributed by Serhiy "
"Storchaka in :issue:`33041`.)"
msgstr ""
#: whatsnew/3.8.rst:2165
2019-09-04 09:39:22 +00:00
msgid ""
"The :opcode:`MAP_ADD` now expects the value as the first element in the "
"stack and the key as the second element. This change was made so the key is "
"always evaluated before the value in dictionary comprehensions, as proposed "
"by :pep:`572`. (Contributed by Jörn Heissler in :issue:`35224`.)"
msgstr ""
#: whatsnew/3.8.rst:2172
2019-09-04 09:39:22 +00:00
msgid "Demos and Tools"
msgstr ""
#: whatsnew/3.8.rst:2174
2019-09-04 09:39:22 +00:00
msgid ""
"Added a benchmark script for timing various ways to access variables: "
"``Tools/scripts/var_access_benchmark.py``. (Contributed by Raymond Hettinger "
"in :issue:`35884`.)"
msgstr ""
#: whatsnew/3.8.rst:2178
msgid "Here's a summary of performance improvements since Python 3.3:"
msgstr ""
2020-02-04 10:14:03 +00:00
#: whatsnew/3.8.rst:2225
2020-05-24 14:31:50 +00:00
msgid ""
"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/>`_. "
"The benchmark script displays timings in nanoseconds."
msgstr ""
#: whatsnew/3.8.rst:2234
2020-02-04 10:14:03 +00:00
msgid "Notable changes in Python 3.8.1"
msgstr ""
#: whatsnew/3.8.rst:2236
2020-02-04 10:14:03 +00:00
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.8.rst:2244
#, fuzzy
msgid "Notable changes in Python 3.8.8"
msgstr "Portage vers Python 3.1"
#: whatsnew/3.8.rst:2246
msgid ""
"Earlier Python versions allowed using both ``;`` and ``&`` as query "
"parameter separators in :func:`urllib.parse.parse_qs` and :func:`urllib."
"parse.parse_qsl`. Due to security concerns, and to conform with newer W3C "
"recommendations, this has been changed to allow only a single separator key, "
"with ``&`` as the default. This change also affects :func:`cgi.parse` and :"
"func:`cgi.parse_multipart` as they use the affected functions internally. "
"For more details, please see their respective documentation. (Contributed by "
"Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)"
msgstr ""
#: whatsnew/3.8.rst:2257
#, fuzzy
msgid "Notable changes in Python 3.8.12"
msgstr "Portage vers Python 3.1"
#: whatsnew/3.8.rst:2259
msgid ""
"Starting with Python 3.8.12 the :mod:`ipaddress` module no longer accepts "
"any leading zeros in IPv4 address strings. Leading zeros are ambiguous and "
"interpreted as octal notation by some libraries. For example the legacy "
"function :func:`socket.inet_aton` treats leading zeros as octal notation. "
"glibc implementation of modern :func:`~socket.inet_pton` does not accept any "
"leading zeros."
msgstr ""
#: whatsnew/3.8.rst:2266
msgid ""
"(Originally contributed by Christian Heimes in :issue:`36384`, and "
"backported to 3.8 by Achraf Merzouki.)"
msgstr ""
2020-07-20 08:56:42 +00:00
#~ msgid "Python 3.8 was released on October 14th, 2019."
#~ msgstr "Python 3.8 a été publié le 14 octobre 2019."