forked from AFPy/python-docs-fr
Julien Palard
76b5c8ea62
Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>
353 lines
10 KiB
Plaintext
353 lines
10 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2021-11-27 10:27+0100\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
|
"Language: fr\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: library/asyncio-future.rst:8
|
|
msgid "Futures"
|
|
msgstr "Futurs"
|
|
|
|
#: library/asyncio-future.rst:10
|
|
msgid ""
|
|
"**Source code:** :source:`Lib/asyncio/futures.py`, :source:`Lib/asyncio/"
|
|
"base_futures.py`"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:15
|
|
msgid ""
|
|
"*Future* objects are used to bridge **low-level callback-based code** with "
|
|
"high-level async/await code."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:20
|
|
msgid "Future Functions"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:24
|
|
msgid "Return ``True`` if *obj* is either of:"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:26
|
|
msgid "an instance of :class:`asyncio.Future`,"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:27
|
|
msgid "an instance of :class:`asyncio.Task`,"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:28
|
|
msgid "a Future-like object with a ``_asyncio_future_blocking`` attribute."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:36
|
|
msgid "Return:"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:38
|
|
msgid ""
|
|
"*obj* argument as is, if *obj* is a :class:`Future`, a :class:`Task`, or a "
|
|
"Future-like object (:func:`isfuture` is used for the test.)"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:42
|
|
msgid ""
|
|
"a :class:`Task` object wrapping *obj*, if *obj* is a coroutine (:func:"
|
|
"`iscoroutine` is used for the test); in this case the coroutine will be "
|
|
"scheduled by ``ensure_future()``."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:47
|
|
msgid ""
|
|
"a :class:`Task` object that would await on *obj*, if *obj* is an awaitable (:"
|
|
"func:`inspect.isawaitable` is used for the test.)"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:50
|
|
msgid "If *obj* is neither of the above a :exc:`TypeError` is raised."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:54
|
|
msgid ""
|
|
"See also the :func:`create_task` function which is the preferred way for "
|
|
"creating new Tasks."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:57
|
|
msgid ""
|
|
"Save a reference to the result of this function, to avoid a task "
|
|
"disappearing mid execution."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:60
|
|
msgid "The function accepts any :term:`awaitable` object."
|
|
msgstr "La fonction accepte n'importe quel objet :term:`awaitable`."
|
|
|
|
#: library/asyncio-future.rst:63
|
|
msgid ""
|
|
"Deprecation warning is emitted if *obj* is not a Future-like object and "
|
|
"*loop* is not specified and there is no running event loop."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:70
|
|
msgid ""
|
|
"Wrap a :class:`concurrent.futures.Future` object in a :class:`asyncio."
|
|
"Future` object."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:73
|
|
msgid ""
|
|
"Deprecation warning is emitted if *future* is not a Future-like object and "
|
|
"*loop* is not specified and there is no running event loop."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:79
|
|
msgid "Future Object"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:83
|
|
msgid ""
|
|
"A Future represents an eventual result of an asynchronous operation. Not "
|
|
"thread-safe."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:86
|
|
msgid ""
|
|
"Future is an :term:`awaitable` object. Coroutines can await on Future "
|
|
"objects until they either have a result or an exception set, or until they "
|
|
"are cancelled."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:90
|
|
msgid ""
|
|
"Typically Futures are used to enable low-level callback-based code (e.g. in "
|
|
"protocols implemented using asyncio :ref:`transports <asyncio-transports-"
|
|
"protocols>`) to interoperate with high-level async/await code."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:95
|
|
msgid ""
|
|
"The rule of thumb is to never expose Future objects in user-facing APIs, and "
|
|
"the recommended way to create a Future object is to call :meth:`loop."
|
|
"create_future`. This way alternative event loop implementations can inject "
|
|
"their own optimized implementations of a Future object."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:101
|
|
msgid "Added support for the :mod:`contextvars` module."
|
|
msgstr "Ajout du support du module :mod:`contextvars`."
|
|
|
|
#: library/asyncio-future.rst:104
|
|
msgid ""
|
|
"Deprecation warning is emitted if *loop* is not specified and there is no "
|
|
"running event loop."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:110
|
|
msgid "Return the result of the Future."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:112
|
|
msgid ""
|
|
"If the Future is *done* and has a result set by the :meth:`set_result` "
|
|
"method, the result value is returned."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:115
|
|
msgid ""
|
|
"If the Future is *done* and has an exception set by the :meth:"
|
|
"`set_exception` method, this method raises the exception."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:206
|
|
#, fuzzy
|
|
msgid ""
|
|
"If the Future has been *cancelled*, this method raises a :exc:"
|
|
"`CancelledError` exception."
|
|
msgstr ""
|
|
"Si la tâche a été *annulée*, cette méthode lève une exception :exc:"
|
|
"`CancelledError`."
|
|
|
|
#: library/asyncio-future.rst:121
|
|
#, fuzzy
|
|
msgid ""
|
|
"If the Future's result isn't yet available, this method raises a :exc:"
|
|
"`InvalidStateError` exception."
|
|
msgstr ""
|
|
"Si le résultat de la tâche n'est pas encore disponible, cette méthode lève "
|
|
"une exception :exc:`InvalidStateError`."
|
|
|
|
#: library/asyncio-future.rst:126
|
|
#, fuzzy
|
|
msgid "Mark the Future as *done* and set its result."
|
|
msgstr "Marque le futur comme terminé et définit son résultat."
|
|
|
|
#: library/asyncio-future.rst:135
|
|
msgid ""
|
|
"Raises a :exc:`InvalidStateError` error if the Future is already *done*."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:133
|
|
#, fuzzy
|
|
msgid "Mark the Future as *done* and set an exception."
|
|
msgstr "Marque le futur comme terminé et définit une exception."
|
|
|
|
#: library/asyncio-future.rst:140
|
|
msgid "Return ``True`` if the Future is *done*."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:142
|
|
msgid ""
|
|
"A Future is *done* if it was *cancelled* or if it has a result or an "
|
|
"exception set with :meth:`set_result` or :meth:`set_exception` calls."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:148
|
|
msgid "Return ``True`` if the Future was *cancelled*."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:150
|
|
msgid ""
|
|
"The method is usually used to check if a Future is not *cancelled* before "
|
|
"setting a result or an exception for it::"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:158
|
|
msgid "Add a callback to be run when the Future is *done*."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:160
|
|
msgid "The *callback* is called with the Future object as its only argument."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:163
|
|
msgid ""
|
|
"If the Future is already *done* when this method is called, the callback is "
|
|
"scheduled with :meth:`loop.call_soon`."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:166
|
|
msgid ""
|
|
"An optional keyword-only *context* argument allows specifying a custom :"
|
|
"class:`contextvars.Context` for the *callback* to run in. The current "
|
|
"context is used when no *context* is provided."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:170
|
|
msgid ""
|
|
":func:`functools.partial` can be used to pass parameters to the callback, e."
|
|
"g.::"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:177
|
|
msgid ""
|
|
"The *context* keyword-only parameter was added. See :pep:`567` for more "
|
|
"details."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:183
|
|
msgid "Remove *callback* from the callbacks list."
|
|
msgstr "Retire *callback* de la liste de fonctions de rappel."
|
|
|
|
#: library/asyncio-future.rst:185
|
|
msgid ""
|
|
"Returns the number of callbacks removed, which is typically 1, unless a "
|
|
"callback was added more than once."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:190
|
|
msgid "Cancel the Future and schedule callbacks."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:192
|
|
msgid ""
|
|
"If the Future is already *done* or *cancelled*, return ``False``. Otherwise, "
|
|
"change the Future's state to *cancelled*, schedule the callbacks, and return "
|
|
"``True``."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:196
|
|
msgid "Added the ``msg`` parameter."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:201
|
|
msgid "Return the exception that was set on this Future."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:203
|
|
msgid ""
|
|
"The exception (or ``None`` if no exception was set) is returned only if the "
|
|
"Future is *done*."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:209
|
|
#, fuzzy
|
|
msgid ""
|
|
"If the Future isn't *done* yet, this method raises an :exc:"
|
|
"`InvalidStateError` exception."
|
|
msgstr ""
|
|
"Si la tâche n'est pas encore *achevée*, cette méthode lève une exception :"
|
|
"exc:`InvalidStateError`."
|
|
|
|
#: library/asyncio-future.rst:214
|
|
msgid "Return the event loop the Future object is bound to."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:221
|
|
msgid ""
|
|
"This example creates a Future object, creates and schedules an asynchronous "
|
|
"Task to set result for the Future, and waits until the Future has a result::"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:256
|
|
msgid ""
|
|
"The Future object was designed to mimic :class:`concurrent.futures.Future`. "
|
|
"Key differences include:"
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:259
|
|
msgid ""
|
|
"unlike asyncio Futures, :class:`concurrent.futures.Future` instances cannot "
|
|
"be awaited."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:262
|
|
msgid ""
|
|
":meth:`asyncio.Future.result` and :meth:`asyncio.Future.exception` do not "
|
|
"accept the *timeout* argument."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:265
|
|
msgid ""
|
|
":meth:`asyncio.Future.result` and :meth:`asyncio.Future.exception` raise an :"
|
|
"exc:`InvalidStateError` exception when the Future is not *done*."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:269
|
|
msgid ""
|
|
"Callbacks registered with :meth:`asyncio.Future.add_done_callback` are not "
|
|
"called immediately. They are scheduled with :meth:`loop.call_soon` instead."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:273
|
|
msgid ""
|
|
"asyncio Future is not compatible with the :func:`concurrent.futures.wait` "
|
|
"and :func:`concurrent.futures.as_completed` functions."
|
|
msgstr ""
|
|
|
|
#: library/asyncio-future.rst:277
|
|
msgid ""
|
|
":meth:`asyncio.Future.cancel` accepts an optional ``msg`` argument, but :"
|
|
"func:`concurrent.futures.cancel` does not."
|
|
msgstr ""
|