1
0
Fork 0
python-docs-fr/library/asyncio-task.po

839 lines
28 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

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

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-12-01 07:43+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../Doc/library/asyncio-task.rst:4
msgid "Tasks and coroutines"
msgstr "Tâches et coroutines"
#: ../Doc/library/asyncio-task.rst:6
msgid "**Source code:** :source:`Lib/asyncio/tasks.py`"
msgstr ""
#: ../Doc/library/asyncio-task.rst:8
msgid "**Source code:** :source:`Lib/asyncio/coroutines.py`"
msgstr ""
#: ../Doc/library/asyncio-task.rst:13
msgid "Coroutines"
msgstr "Coroutines"
#: ../Doc/library/asyncio-task.rst:15
msgid ""
"Coroutines used with :mod:`asyncio` may be implemented using the :keyword:"
"`async def` statement, or by using :term:`generators <generator>`. The :"
"keyword:`async def` type of coroutine was added in Python 3.5, and is "
"recommended if there is no need to support older Python versions."
msgstr ""
#: ../Doc/library/asyncio-task.rst:20
msgid ""
"Generator-based coroutines should be decorated with :func:`@asyncio."
"coroutine <asyncio.coroutine>`, although this is not strictly enforced. The "
"decorator enables compatibility with :keyword:`async def` coroutines, and "
"also serves as documentation. Generator-based coroutines use the ``yield "
"from`` syntax introduced in :pep:`380`, instead of the original ``yield`` "
"syntax."
msgstr ""
#: ../Doc/library/asyncio-task.rst:27
msgid ""
"The word \"coroutine\", like the word \"generator\", is used for two "
"different (though related) concepts:"
msgstr ""
#: ../Doc/library/asyncio-task.rst:30
msgid ""
"The function that defines a coroutine (a function definition using :keyword:"
"`async def` or decorated with ``@asyncio.coroutine``). If disambiguation is "
"needed we will call this a *coroutine function* (:func:`iscoroutinefunction` "
"returns ``True``)."
msgstr ""
#: ../Doc/library/asyncio-task.rst:36
msgid ""
"The object obtained by calling a coroutine function. This object represents "
"a computation or an I/O operation (usually a combination) that will complete "
"eventually. If disambiguation is needed we will call it a *coroutine "
"object* (:func:`iscoroutine` returns ``True``)."
msgstr ""
#: ../Doc/library/asyncio-task.rst:41
msgid "Things a coroutine can do:"
msgstr "Les choses que les coroutines peuvent faire :"
#: ../Doc/library/asyncio-task.rst:43
msgid ""
"``result = await future`` or ``result = yield from future`` -- suspends the "
"coroutine until the future is done, then returns the future's result, or "
"raises an exception, which will be propagated. (If the future is cancelled, "
"it will raise a ``CancelledError`` exception.) Note that tasks are futures, "
"and everything said about futures also applies to tasks."
msgstr ""
#: ../Doc/library/asyncio-task.rst:50
msgid ""
"``result = await coroutine`` or ``result = yield from coroutine`` -- wait "
"for another coroutine to produce a result (or raise an exception, which will "
"be propagated). The ``coroutine`` expression must be a *call* to another "
"coroutine."
msgstr ""
#: ../Doc/library/asyncio-task.rst:55
msgid ""
"``return expression`` -- produce a result to the coroutine that is waiting "
"for this one using :keyword:`await` or ``yield from``."
msgstr ""
#: ../Doc/library/asyncio-task.rst:58
msgid ""
"``raise exception`` -- raise an exception in the coroutine that is waiting "
"for this one using :keyword:`await` or ``yield from``."
msgstr ""
#: ../Doc/library/asyncio-task.rst:61
msgid ""
"Calling a coroutine does not start its code running -- the coroutine object "
"returned by the call doesn't do anything until you schedule its execution. "
"There are two basic ways to start it running: call ``await coroutine`` or "
"``yield from coroutine`` from another coroutine (assuming the other "
"coroutine is already running!), or schedule its execution using the :func:"
"`ensure_future` function or the :meth:`AbstractEventLoop.create_task` method."
msgstr ""
#: ../Doc/library/asyncio-task.rst:70
msgid "Coroutines (and tasks) can only run when the event loop is running."
msgstr ""
#: ../Doc/library/asyncio-task.rst:74
msgid ""
"Decorator to mark generator-based coroutines. This enables the generator "
"use :keyword:`!yield from` to call :keyword:`async def` coroutines, and also "
"enables the generator to be called by :keyword:`async def` coroutines, for "
"instance using an :keyword:`await` expression."
msgstr ""
#: ../Doc/library/asyncio-task.rst:80
msgid ""
"There is no need to decorate :keyword:`async def` coroutines themselves."
msgstr ""
#: ../Doc/library/asyncio-task.rst:82
msgid ""
"If the generator is not yielded from before it is destroyed, an error "
"message is logged. See :ref:`Detect coroutines never scheduled <asyncio-"
"coroutine-not-scheduled>`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:88
msgid ""
"In this documentation, some methods are documented as coroutines, even if "
"they are plain Python functions returning a :class:`Future`. This is "
"intentional to have a freedom of tweaking the implementation of these "
"functions in the future. If such a function is needed to be used in a "
"callback-style code, wrap its result with :func:`ensure_future`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:98
msgid "Example: Hello World coroutine"
msgstr "Exemple : Coroutine \"Hello World\""
#: ../Doc/library/asyncio-task.rst:100
msgid "Example of coroutine displaying ``\"Hello World\"``::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:114
msgid ""
"The :ref:`Hello World with call_soon() <asyncio-hello-world-callback>` "
"example uses the :meth:`AbstractEventLoop.call_soon` method to schedule a "
"callback."
msgstr ""
#: ../Doc/library/asyncio-task.rst:122
msgid "Example: Coroutine displaying the current date"
msgstr "Exemple : Coroutine affichant la date actuelle"
#: ../Doc/library/asyncio-task.rst:124
msgid ""
"Example of coroutine displaying the current date every second during 5 "
"seconds using the :meth:`sleep` function::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:145
msgid ""
"The :ref:`display the current date with call_later() <asyncio-date-"
"callback>` example uses a callback with the :meth:`AbstractEventLoop."
"call_later` method."
msgstr ""
#: ../Doc/library/asyncio-task.rst:151
msgid "Example: Chain coroutines"
msgstr "Exemple : Chaîner des coroutines"
#: ../Doc/library/asyncio-task.rst:153
msgid "Example chaining coroutines::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:170
msgid ""
"``compute()`` is chained to ``print_sum()``: ``print_sum()`` coroutine waits "
"until ``compute()`` is completed before returning its result."
msgstr ""
#: ../Doc/library/asyncio-task.rst:173
msgid "Sequence diagram of the example:"
msgstr ""
#: ../Doc/library/asyncio-task.rst:178
msgid ""
"The \"Task\" is created by the :meth:`AbstractEventLoop.run_until_complete` "
"method when it gets a coroutine object instead of a task."
msgstr ""
#: ../Doc/library/asyncio-task.rst:181
msgid ""
"The diagram shows the control flow, it does not describe exactly how things "
"work internally. For example, the sleep coroutine creates an internal future "
"which uses :meth:`AbstractEventLoop.call_later` to wake up the task in 1 "
"second."
msgstr ""
#: ../Doc/library/asyncio-task.rst:187
msgid "InvalidStateError"
msgstr "InvalidStateError"
#: ../Doc/library/asyncio-task.rst:191
msgid "The operation is not allowed in this state."
msgstr "L'opération n'est pas autorisée dans cet état."
#: ../Doc/library/asyncio-task.rst:195
msgid "TimeoutError"
msgstr "TimeoutError"
#: ../Doc/library/asyncio-task.rst:199
msgid "The operation exceeded the given deadline."
msgstr "L'opération a dépassé la deadline donnée."
#: ../Doc/library/asyncio-task.rst:203
msgid ""
"This exception is different from the builtin :exc:`TimeoutError` exception!"
msgstr ""
#: ../Doc/library/asyncio-task.rst:207
msgid "Future"
msgstr ""
#: ../Doc/library/asyncio-task.rst:211
msgid ""
"This class is *almost* compatible with :class:`concurrent.futures.Future`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:213
msgid "Differences:"
msgstr "Différences :"
#: ../Doc/library/asyncio-task.rst:215
msgid ""
":meth:`result` and :meth:`exception` do not take a timeout argument and "
"raise an exception when the future isn't done yet."
msgstr ""
#: ../Doc/library/asyncio-task.rst:218
msgid ""
"Callbacks registered with :meth:`add_done_callback` are always called via "
"the event loop's :meth:`~AbstractEventLoop.call_soon`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:221
msgid ""
"This class is not compatible with the :func:`~concurrent.futures.wait` and :"
"func:`~concurrent.futures.as_completed` functions in the :mod:`concurrent."
"futures` package."
msgstr ""
#: ../Doc/library/asyncio-task.rst:225 ../Doc/library/asyncio-task.rst:392
msgid "This class is :ref:`not thread safe <asyncio-multithreading>`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:229
msgid "Cancel the future and schedule callbacks."
msgstr ""
#: ../Doc/library/asyncio-task.rst:231
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 ""
#: ../Doc/library/asyncio-task.rst:237
msgid "Return ``True`` if the future was cancelled."
msgstr ""
#: ../Doc/library/asyncio-task.rst:241
msgid "Return ``True`` if the future is done."
msgstr ""
#: ../Doc/library/asyncio-task.rst:243
msgid ""
"Done means either that a result / exception are available, or that the "
"future was cancelled."
msgstr ""
#: ../Doc/library/asyncio-task.rst:248
msgid "Return the result this future represents."
msgstr ""
#: ../Doc/library/asyncio-task.rst:250
msgid ""
"If the future has been cancelled, raises :exc:`CancelledError`. If the "
"future's result isn't yet available, raises :exc:`InvalidStateError`. If the "
"future is done and has an exception set, this exception is raised."
msgstr ""
#: ../Doc/library/asyncio-task.rst:256
msgid "Return the exception that was set on this future."
msgstr ""
#: ../Doc/library/asyncio-task.rst:258
msgid ""
"The exception (or ``None`` if no exception was set) is returned only if the "
"future is done. If the future has been cancelled, raises :exc:"
"`CancelledError`. If the future isn't done yet, raises :exc:"
"`InvalidStateError`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:265
msgid "Add a callback to be run when the future becomes done."
msgstr ""
#: ../Doc/library/asyncio-task.rst:267
msgid ""
"The callback is called with a single argument - the future object. If the "
"future is already done when this is called, the callback is scheduled with :"
"meth:`~AbstractEventLoop.call_soon`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:271
msgid ""
":ref:`Use functools.partial to pass parameters to the callback <asyncio-pass-"
"keywords>`. For example, ``fut.add_done_callback(functools.partial(print, "
"\"Future:\", flush=True))`` will call ``print(\"Future:\", fut, "
"flush=True)``."
msgstr ""
#: ../Doc/library/asyncio-task.rst:278
msgid "Remove all instances of a callback from the \"call when done\" list."
msgstr ""
#: ../Doc/library/asyncio-task.rst:280
msgid "Returns the number of callbacks removed."
msgstr "Donne le nombre de fonctions de rappel supprimées."
#: ../Doc/library/asyncio-task.rst:284
msgid "Mark the future done and set its result."
msgstr "Marque le futur comme terminé et définit son résultat."
#: ../Doc/library/asyncio-task.rst:286 ../Doc/library/asyncio-task.rst:293
msgid ""
"If the future is already done when this method is called, raises :exc:"
"`InvalidStateError`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:291
msgid "Mark the future done and set an exception."
msgstr "Marque le futur comme terminé et définit une exception."
#: ../Doc/library/asyncio-task.rst:298
msgid "Example: Future with run_until_complete()"
msgstr "Exemple : Futur avec ``run_until_complete()``"
#: ../Doc/library/asyncio-task.rst:300
msgid ""
"Example combining a :class:`Future` and a :ref:`coroutine function "
"<coroutine>`::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:316
msgid ""
"The coroutine function is responsible for the computation (which takes 1 "
"second) and it stores the result into the future. The :meth:"
"`~AbstractEventLoop.run_until_complete` method waits for the completion of "
"the future."
msgstr ""
#: ../Doc/library/asyncio-task.rst:322
msgid ""
"The :meth:`~AbstractEventLoop.run_until_complete` method uses internally "
"the :meth:`~Future.add_done_callback` method to be notified when the future "
"is done."
msgstr ""
#: ../Doc/library/asyncio-task.rst:328
msgid "Example: Future with run_forever()"
msgstr "Exemple : Futur avec ``run_forever()``"
#: ../Doc/library/asyncio-task.rst:330
msgid ""
"The previous example can be written differently using the :meth:`Future."
"add_done_callback` method to describe explicitly the control flow::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:353
msgid ""
"In this example, the future is used to link ``slow_operation()`` to "
"``got_result()``: when ``slow_operation()`` is done, ``got_result()`` is "
"called with the result."
msgstr ""
#: ../Doc/library/asyncio-task.rst:359
msgid "Task"
msgstr ""
#: ../Doc/library/asyncio-task.rst:363
msgid ""
"Schedule the execution of a :ref:`coroutine <coroutine>`: wrap it in a "
"future. A task is a subclass of :class:`Future`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:366
msgid ""
"A task is responsible for executing a coroutine object in an event loop. If "
"the wrapped coroutine yields from a future, the task suspends the execution "
"of the wrapped coroutine and waits for the completion of the future. When "
"the future is done, the execution of the wrapped coroutine restarts with the "
"result or the exception of the future."
msgstr ""
#: ../Doc/library/asyncio-task.rst:372
msgid ""
"Event loops use cooperative scheduling: an event loop only runs one task at "
"a time. Other tasks may run in parallel if other event loops are running in "
"different threads. While a task waits for the completion of a future, the "
"event loop executes a new task."
msgstr ""
#: ../Doc/library/asyncio-task.rst:377
msgid ""
"The cancellation of a task is different from the cancelation of a future. "
"Calling :meth:`cancel` will throw a :exc:`~concurrent.futures."
"CancelledError` to the wrapped coroutine. :meth:`~Future.cancelled` only "
"returns ``True`` if the wrapped coroutine did not catch the :exc:"
"`~concurrent.futures.CancelledError` exception, or raised a :exc:"
"`~concurrent.futures.CancelledError` exception."
msgstr ""
#: ../Doc/library/asyncio-task.rst:385
msgid ""
"If a pending task is destroyed, the execution of its wrapped :ref:`coroutine "
"<coroutine>` did not complete. It is probably a bug and a warning is logged: "
"see :ref:`Pending task destroyed <asyncio-pending-task-destroyed>`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:389
msgid ""
"Don't directly create :class:`Task` instances: use the :func:`ensure_future` "
"function or the :meth:`AbstractEventLoop.create_task` method."
msgstr ""
#: ../Doc/library/asyncio-task.rst:396
msgid "Return a set of all tasks for an event loop."
msgstr "Donne l'ensemble des tâches d'une boucle d'évènements."
#: ../Doc/library/asyncio-task.rst:398
msgid "By default all tasks for the current event loop are returned."
msgstr ""
#: ../Doc/library/asyncio-task.rst:402
msgid "Return the currently running task in an event loop or ``None``."
msgstr ""
#: ../Doc/library/asyncio-task.rst:404
msgid "By default the current task for the current event loop is returned."
msgstr ""
#: ../Doc/library/asyncio-task.rst:406
msgid "``None`` is returned when called not in the context of a :class:`Task`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:410
msgid "Request that this task cancel itself."
msgstr "Demande à ce qu'une tâche s'annule elle même."
#: ../Doc/library/asyncio-task.rst:412
msgid ""
"This arranges for a :exc:`~concurrent.futures.CancelledError` to be thrown "
"into the wrapped coroutine on the next cycle through the event loop. The "
"coroutine then has a chance to clean up or even deny the request using try/"
"except/finally."
msgstr ""
#: ../Doc/library/asyncio-task.rst:417
msgid ""
"Unlike :meth:`Future.cancel`, this does not guarantee that the task will be "
"cancelled: the exception might be caught and acted upon, delaying "
"cancellation of the task or preventing cancellation completely. The task may "
"also return a value or raise a different exception."
msgstr ""
#: ../Doc/library/asyncio-task.rst:422
msgid ""
"Immediately after this method is called, :meth:`~Future.cancelled` will not "
"return ``True`` (unless the task was already cancelled). A task will be "
"marked as cancelled when the wrapped coroutine terminates with a :exc:"
"`~concurrent.futures.CancelledError` exception (even if :meth:`cancel` was "
"not called)."
msgstr ""
#: ../Doc/library/asyncio-task.rst:430
msgid "Return the list of stack frames for this task's coroutine."
msgstr ""
#: ../Doc/library/asyncio-task.rst:432
msgid ""
"If the coroutine is not done, this returns the stack where it is suspended. "
"If the coroutine has completed successfully or was cancelled, this returns "
"an empty list. If the coroutine was terminated by an exception, this "
"returns the list of traceback frames."
msgstr ""
#: ../Doc/library/asyncio-task.rst:438
msgid "The frames are always ordered from oldest to newest."
msgstr ""
#: ../Doc/library/asyncio-task.rst:440
msgid ""
"The optional limit gives the maximum number of frames to return; by default "
"all available frames are returned. Its meaning differs depending on whether "
"a stack or a traceback is returned: the newest frames of a stack are "
"returned, but the oldest frames of a traceback are returned. (This matches "
"the behavior of the traceback module.)"
msgstr ""
#: ../Doc/library/asyncio-task.rst:446
msgid ""
"For reasons beyond our control, only one stack frame is returned for a "
"suspended coroutine."
msgstr ""
#: ../Doc/library/asyncio-task.rst:451
msgid "Print the stack or traceback for this task's coroutine."
msgstr ""
#: ../Doc/library/asyncio-task.rst:453
msgid ""
"This produces output similar to that of the traceback module, for the frames "
"retrieved by get_stack(). The limit argument is passed to get_stack(). The "
"file argument is an I/O stream to which the output is written; by default "
"output is written to sys.stderr."
msgstr ""
#: ../Doc/library/asyncio-task.rst:460
msgid "Example: Parallel execution of tasks"
msgstr "Exemple : Exécution parallèle de tâches"
#: ../Doc/library/asyncio-task.rst:462
msgid "Example executing 3 tasks (A, B, C) in parallel::"
msgstr "Exemple d'exécution de trois tâches (A, B, C) en parallèle : ::"
#: ../Doc/library/asyncio-task.rst:482
msgid "Output::"
msgstr "Sortie::"
#: ../Doc/library/asyncio-task.rst:494
msgid ""
"A task is automatically scheduled for execution when it is created. The "
"event loop stops when all tasks are done."
msgstr ""
#: ../Doc/library/asyncio-task.rst:499
msgid "Task functions"
msgstr ""
#: ../Doc/library/asyncio-task.rst:503
msgid ""
"In the functions below, the optional *loop* argument allows explicitly "
"setting the event loop object used by the underlying task or coroutine. If "
"it's not provided, the default event loop is used."
msgstr ""
#: ../Doc/library/asyncio-task.rst:509
msgid ""
"Return an iterator whose values, when waited for, are :class:`Future` "
"instances."
msgstr ""
#: ../Doc/library/asyncio-task.rst:512
msgid ""
"Raises :exc:`asyncio.TimeoutError` if the timeout occurs before all Futures "
"are done."
msgstr ""
#: ../Doc/library/asyncio-task.rst:515
msgid "Example::"
msgstr "Exemples ::"
#: ../Doc/library/asyncio-task.rst:523
msgid "The futures ``f`` are not necessarily members of fs."
msgstr ""
#: ../Doc/library/asyncio-task.rst:527
msgid ""
"Schedule the execution of a :ref:`coroutine object <coroutine>`: wrap it in "
"a future. Return a :class:`Task` object."
msgstr ""
#: ../Doc/library/asyncio-task.rst:530
msgid "If the argument is a :class:`Future`, it is returned directly."
msgstr ""
#: ../Doc/library/asyncio-task.rst:534
msgid "The function accepts any :term:`awaitable` object."
msgstr "La fonction accepte n'importe quel objet :term:`awaitable`."
#: ../Doc/library/asyncio-task.rst:539
msgid "The :meth:`AbstractEventLoop.create_task` method."
msgstr ""
#: ../Doc/library/asyncio-task.rst:543
msgid "A deprecated alias to :func:`ensure_future`."
msgstr "Un alias déprécié de :func:`ensure_future`."
#: ../Doc/library/asyncio-task.rst:549
msgid ""
"Wrap a :class:`concurrent.futures.Future` object in a :class:`Future` object."
msgstr ""
#: ../Doc/library/asyncio-task.rst:554
msgid ""
"Return a future aggregating results from the given coroutine objects or "
"futures."
msgstr ""
#: ../Doc/library/asyncio-task.rst:557
msgid ""
"All futures must share the same event loop. If all the tasks are done "
"successfully, the returned future's result is the list of results (in the "
"order of the original sequence, not necessarily the order of results "
"arrival). If *return_exceptions* is true, exceptions in the tasks are "
"treated the same as successful results, and gathered in the result list; "
"otherwise, the first raised exception will be immediately propagated to the "
"returned future."
msgstr ""
#: ../Doc/library/asyncio-task.rst:565
msgid ""
"Cancellation: if the outer Future is cancelled, all children (that have not "
"completed yet) are also cancelled. If any child is cancelled, this is "
"treated as if it raised :exc:`~concurrent.futures.CancelledError` -- the "
"outer Future is *not* cancelled in this case. (This is to prevent the "
"cancellation of one child to cause other children to be cancelled.)"
msgstr ""
#: ../Doc/library/asyncio-task.rst:573
msgid ""
"Return ``True`` if *obj* is a :ref:`coroutine object <coroutine>`, which may "
"be based on a generator or an :keyword:`async def` coroutine."
msgstr ""
#: ../Doc/library/asyncio-task.rst:578
msgid ""
"Return ``True`` if *func* is determined to be a :ref:`coroutine function "
"<coroutine>`, which may be a decorated generator function or an :keyword:"
"`async def` function."
msgstr ""
#: ../Doc/library/asyncio-task.rst:584
msgid "Submit a :ref:`coroutine object <coroutine>` to a given event loop."
msgstr ""
#: ../Doc/library/asyncio-task.rst:586
msgid "Return a :class:`concurrent.futures.Future` to access the result."
msgstr ""
#: ../Doc/library/asyncio-task.rst:588
msgid ""
"This function is meant to be called from a different thread than the one "
"where the event loop is running. Usage::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:598
msgid ""
"If an exception is raised in the coroutine, the returned future will be "
"notified. It can also be used to cancel the task in the event loop::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:611
msgid ""
"See the :ref:`concurrency and multithreading <asyncio-multithreading>` "
"section of the documentation."
msgstr ""
#: ../Doc/library/asyncio-task.rst:616
msgid ""
"Unlike other functions from the module, :func:`run_coroutine_threadsafe` "
"requires the *loop* argument to be passed explicitly."
msgstr ""
#: ../Doc/library/asyncio-task.rst:624
msgid ""
"Create a :ref:`coroutine <coroutine>` that completes after a given time (in "
"seconds). If *result* is provided, it is produced to the caller when the "
"coroutine completes."
msgstr ""
#: ../Doc/library/asyncio-task.rst:628
msgid ""
"The resolution of the sleep depends on the :ref:`granularity of the event "
"loop <asyncio-delayed-calls>`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:631 ../Doc/library/asyncio-task.rst:695
msgid "This function is a :ref:`coroutine <coroutine>`."
msgstr "Cette fonction est une :ref:`coroutine <coroutine>`."
#: ../Doc/library/asyncio-task.rst:635
msgid "Wait for a future, shielding it from cancellation."
msgstr "Attends un future, en le protégeant des annulations."
#: ../Doc/library/asyncio-task.rst:637
msgid "The statement::"
msgstr "L'instruction : ::"
#: ../Doc/library/asyncio-task.rst:641
msgid "is exactly equivalent to the statement::"
msgstr "est exactement équivalente à l'instruction : ::"
#: ../Doc/library/asyncio-task.rst:645
msgid ""
"*except* that if the coroutine containing it is cancelled, the task running "
"in ``something()`` is not cancelled. From the point of view of "
"``something()``, the cancellation did not happen. But its caller is still "
"cancelled, so the yield-from expression still raises :exc:`~concurrent."
"futures.CancelledError`. Note: If ``something()`` is cancelled by other "
"means this will still cancel ``shield()``."
msgstr ""
#: ../Doc/library/asyncio-task.rst:652
msgid ""
"If you want to completely ignore cancellation (not recommended) you can "
"combine ``shield()`` with a try/except clause, as follows::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:664
msgid ""
"Wait for the Futures and coroutine objects given by the sequence *futures* "
"to complete. Coroutines will be wrapped in Tasks. Returns two sets of :"
"class:`Future`: (done, pending)."
msgstr ""
#: ../Doc/library/asyncio-task.rst:668
msgid "The sequence *futures* must not be empty."
msgstr ""
#: ../Doc/library/asyncio-task.rst:670
msgid ""
"*timeout* can be used to control the maximum number of seconds to wait "
"before returning. *timeout* can be an int or float. If *timeout* is not "
"specified or ``None``, there is no limit to the wait time."
msgstr ""
#: ../Doc/library/asyncio-task.rst:674
msgid ""
"*return_when* indicates when this function should return. It must be one of "
"the following constants of the :mod:`concurrent.futures` module:"
msgstr ""
#: ../Doc/library/asyncio-task.rst:680
msgid "Constant"
msgstr "Constante"
#: ../Doc/library/asyncio-task.rst:680
msgid "Description"
msgstr "Description"
#: ../Doc/library/asyncio-task.rst:682
msgid ":const:`FIRST_COMPLETED`"
msgstr ":const:`FIRST_COMPLETED`"
#: ../Doc/library/asyncio-task.rst:682
msgid "The function will return when any future finishes or is cancelled."
msgstr ""
#: ../Doc/library/asyncio-task.rst:685
msgid ":const:`FIRST_EXCEPTION`"
msgstr ":const:`FIRST_EXCEPTION`"
#: ../Doc/library/asyncio-task.rst:685
msgid ""
"The function will return when any future finishes by raising an exception. "
"If no future raises an exception then it is equivalent to :const:"
"`ALL_COMPLETED`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:691
msgid ":const:`ALL_COMPLETED`"
msgstr ":const:`ALL_COMPLETED`"
#: ../Doc/library/asyncio-task.rst:691
msgid "The function will return when all futures finish or are cancelled."
msgstr ""
#: ../Doc/library/asyncio-task.rst:697
msgid "Usage::"
msgstr ""
#: ../Doc/library/asyncio-task.rst:703
msgid ""
"This does not raise :exc:`asyncio.TimeoutError`! Futures that aren't done "
"when the timeout occurs are returned in the second set."
msgstr ""
#: ../Doc/library/asyncio-task.rst:709
msgid ""
"Wait for the single :class:`Future` or :ref:`coroutine object <coroutine>` "
"to complete with timeout. If *timeout* is ``None``, block until the future "
"completes."
msgstr ""
#: ../Doc/library/asyncio-task.rst:713
msgid "Coroutine will be wrapped in :class:`Task`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:715
msgid ""
"Returns result of the Future or coroutine. When a timeout occurs, it "
"cancels the task and raises :exc:`asyncio.TimeoutError`. To avoid the task "
"cancellation, wrap it in :func:`shield`."
msgstr ""
#: ../Doc/library/asyncio-task.rst:719
msgid "If the wait is cancelled, the future *fut* is also cancelled."
msgstr ""
#: ../Doc/library/asyncio-task.rst:721
msgid "This function is a :ref:`coroutine <coroutine>`, usage::"
msgstr "Cette fonction est une :ref:`coroutine <coroutine>`, utilisation : ::"
#: ../Doc/library/asyncio-task.rst:725
msgid "If the wait is cancelled, the future *fut* is now also cancelled."
msgstr ""
#~ msgid "The same coroutine implemented using a generator::"
#~ msgstr "La même coroutine implémentée en utilisant un générateur : ::"