# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2018-06-10 11:27+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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 `. 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 `, 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 `." 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() ` " "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() ` 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 `." 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 `. 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 " "`::" 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 `: 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 " "` did not complete. It is probably a bug and a warning is logged: " "see :ref:`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 `: 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 obsolète 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:571 msgid "" "If the *gather* itself is cancelled, the cancellation is propagated " "regardless of *return_exceptions*." msgstr "" #: ../Doc/library/asyncio-task.rst:577 msgid "" "Return ``True`` if *obj* is a :ref:`coroutine object `, which may " "be based on a generator or an :keyword:`async def` coroutine." msgstr "" #: ../Doc/library/asyncio-task.rst:582 msgid "" "Return ``True`` if *func* is determined to be a :ref:`coroutine function " "`, which may be a decorated generator function or an :keyword:" "`async def` function." msgstr "" #: ../Doc/library/asyncio-task.rst:588 msgid "Submit a :ref:`coroutine object ` to a given event loop." msgstr "" #: ../Doc/library/asyncio-task.rst:590 msgid "Return a :class:`concurrent.futures.Future` to access the result." msgstr "" #: ../Doc/library/asyncio-task.rst:592 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:602 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:615 msgid "" "See the :ref:`concurrency and multithreading ` " "section of the documentation." msgstr "" #: ../Doc/library/asyncio-task.rst:620 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:628 msgid "" "Create a :ref:`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:632 msgid "" "The resolution of the sleep depends on the :ref:`granularity of the event " "loop `." msgstr "" #: ../Doc/library/asyncio-task.rst:635 ../Doc/library/asyncio-task.rst:699 msgid "This function is a :ref:`coroutine `." msgstr "Cette fonction est une :ref:`coroutine `." #: ../Doc/library/asyncio-task.rst:639 msgid "Wait for a future, shielding it from cancellation." msgstr "Attends un future, en le protégeant des annulations." #: ../Doc/library/asyncio-task.rst:641 msgid "The statement::" msgstr "L'instruction : ::" #: ../Doc/library/asyncio-task.rst:645 msgid "is exactly equivalent to the statement::" msgstr "est exactement équivalente à l'instruction : ::" #: ../Doc/library/asyncio-task.rst:649 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:656 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:668 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:672 msgid "The sequence *futures* must not be empty." msgstr "" #: ../Doc/library/asyncio-task.rst:674 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:678 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:684 msgid "Constant" msgstr "Constante" #: ../Doc/library/asyncio-task.rst:684 msgid "Description" msgstr "Description" #: ../Doc/library/asyncio-task.rst:686 msgid ":const:`FIRST_COMPLETED`" msgstr ":const:`FIRST_COMPLETED`" #: ../Doc/library/asyncio-task.rst:686 msgid "The function will return when any future finishes or is cancelled." msgstr "" #: ../Doc/library/asyncio-task.rst:689 msgid ":const:`FIRST_EXCEPTION`" msgstr ":const:`FIRST_EXCEPTION`" #: ../Doc/library/asyncio-task.rst:689 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:695 msgid ":const:`ALL_COMPLETED`" msgstr ":const:`ALL_COMPLETED`" #: ../Doc/library/asyncio-task.rst:695 msgid "The function will return when all futures finish or are cancelled." msgstr "" #: ../Doc/library/asyncio-task.rst:701 msgid "Usage::" msgstr "" #: ../Doc/library/asyncio-task.rst:707 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:713 msgid "" "Wait for the single :class:`Future` or :ref:`coroutine object ` " "to complete with timeout. If *timeout* is ``None``, block until the future " "completes." msgstr "" #: ../Doc/library/asyncio-task.rst:717 msgid "Coroutine will be wrapped in :class:`Task`." msgstr "" #: ../Doc/library/asyncio-task.rst:719 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:723 msgid "If the wait is cancelled, the future *fut* is also cancelled." msgstr "" #: ../Doc/library/asyncio-task.rst:725 msgid "This function is a :ref:`coroutine `, usage::" msgstr "Cette fonction est une :ref:`coroutine `, utilisation : ::" #: ../Doc/library/asyncio-task.rst:729 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 : ::"