forked from AFPy/python-docs-fr
517 lines
18 KiB
Plaintext
517 lines
18 KiB
Plaintext
# Copyright (C) 2001-2018, 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: 2018-06-28 15:29+0200\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/concurrent.futures.rst:2
|
|
msgid ":mod:`concurrent.futures` --- Launching parallel tasks"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:9
|
|
msgid ""
|
|
"**Source code:** :source:`Lib/concurrent/futures/thread.py` and :source:`Lib/"
|
|
"concurrent/futures/process.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:14
|
|
msgid ""
|
|
"The :mod:`concurrent.futures` module provides a high-level interface for "
|
|
"asynchronously executing callables."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:17
|
|
msgid ""
|
|
"The asynchronous execution can be performed with threads, using :class:"
|
|
"`ThreadPoolExecutor`, or separate processes, using :class:"
|
|
"`ProcessPoolExecutor`. Both implement the same interface, which is defined "
|
|
"by the abstract :class:`Executor` class."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:24
|
|
msgid "Executor Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:28
|
|
msgid ""
|
|
"An abstract class that provides methods to execute calls asynchronously. It "
|
|
"should not be used directly, but through its concrete subclasses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:33
|
|
msgid ""
|
|
"Schedules the callable, *fn*, to be executed as ``fn(*args **kwargs)`` and "
|
|
"returns a :class:`Future` object representing the execution of the "
|
|
"callable. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:43
|
|
msgid "Similar to :func:`map(func, *iterables) <map>` except:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:45
|
|
msgid "the *iterables* are collected immediately rather than lazily;"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:47
|
|
msgid ""
|
|
"*func* is executed asynchronously and several calls to *func* may be made "
|
|
"concurrently."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:50
|
|
msgid ""
|
|
"The returned iterator raises a :exc:`concurrent.futures.TimeoutError` if :"
|
|
"meth:`~iterator.__next__` is called and the result isn't available after "
|
|
"*timeout* seconds from the original call to :meth:`Executor.map`. *timeout* "
|
|
"can be an int or a float. If *timeout* is not specified or ``None``, there "
|
|
"is no limit to the wait time."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:56
|
|
msgid ""
|
|
"If a *func* call raises an exception, then that exception will be raised "
|
|
"when its value is retrieved from the iterator."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:59
|
|
msgid ""
|
|
"When using :class:`ProcessPoolExecutor`, this method chops *iterables* into "
|
|
"a number of chunks which it submits to the pool as separate tasks. The "
|
|
"(approximate) size of these chunks can be specified by setting *chunksize* "
|
|
"to a positive integer. For very long iterables, using a large value for "
|
|
"*chunksize* can significantly improve performance compared to the default "
|
|
"size of 1. With :class:`ThreadPoolExecutor`, *chunksize* has no effect."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:67
|
|
msgid "Added the *chunksize* argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:72
|
|
msgid ""
|
|
"Signal the executor that it should free any resources that it is using when "
|
|
"the currently pending futures are done executing. Calls to :meth:`Executor."
|
|
"submit` and :meth:`Executor.map` made after shutdown will raise :exc:"
|
|
"`RuntimeError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:77
|
|
msgid ""
|
|
"If *wait* is ``True`` then this method will not return until all the pending "
|
|
"futures are done executing and the resources associated with the executor "
|
|
"have been freed. If *wait* is ``False`` then this method will return "
|
|
"immediately and the resources associated with the executor will be freed "
|
|
"when all pending futures are done executing. Regardless of the value of "
|
|
"*wait*, the entire Python program will not exit until all pending futures "
|
|
"are done executing."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:85
|
|
msgid ""
|
|
"You can avoid having to call this method explicitly if you use the :keyword:"
|
|
"`with` statement, which will shutdown the :class:`Executor` (waiting as if :"
|
|
"meth:`Executor.shutdown` were called with *wait* set to ``True``)::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:99
|
|
msgid "ThreadPoolExecutor"
|
|
msgstr "ThreadPoolExecutor"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:101
|
|
msgid ""
|
|
":class:`ThreadPoolExecutor` is an :class:`Executor` subclass that uses a "
|
|
"pool of threads to execute calls asynchronously."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:104
|
|
msgid ""
|
|
"Deadlocks can occur when the callable associated with a :class:`Future` "
|
|
"waits on the results of another :class:`Future`. For example::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:123
|
|
msgid "And::"
|
|
msgstr "Et : ::"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:137
|
|
msgid ""
|
|
"An :class:`Executor` subclass that uses a pool of at most *max_workers* "
|
|
"threads to execute calls asynchronously."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:140
|
|
msgid ""
|
|
"*initializer* is an optional callable that is called at the start of each "
|
|
"worker thread; *initargs* is a tuple of arguments passed to the "
|
|
"initializer. Should *initializer* raise an exception, all currently pending "
|
|
"jobs will raise a :exc:`~concurrent.futures.thread.BrokenThreadPool`, as "
|
|
"well any attempt to submit more jobs to the pool."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:146
|
|
msgid ""
|
|
"If *max_workers* is ``None`` or not given, it will default to the number of "
|
|
"processors on the machine, multiplied by ``5``, assuming that :class:"
|
|
"`ThreadPoolExecutor` is often used to overlap I/O instead of CPU work and "
|
|
"the number of workers should be higher than the number of workers for :class:"
|
|
"`ProcessPoolExecutor`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:154
|
|
msgid ""
|
|
"The *thread_name_prefix* argument was added to allow users to control the "
|
|
"threading.Thread names for worker threads created by the pool for easier "
|
|
"debugging."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:159
|
|
#: ../Doc/library/concurrent.futures.rst:239
|
|
msgid "Added the *initializer* and *initargs* arguments."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:166
|
|
msgid "ThreadPoolExecutor Example"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:198
|
|
msgid "ProcessPoolExecutor"
|
|
msgstr "ProcessPoolExecutor"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:200
|
|
msgid ""
|
|
"The :class:`ProcessPoolExecutor` class is an :class:`Executor` subclass that "
|
|
"uses a pool of processes to execute calls asynchronously. :class:"
|
|
"`ProcessPoolExecutor` uses the :mod:`multiprocessing` module, which allows "
|
|
"it to side-step the :term:`Global Interpreter Lock` but also means that only "
|
|
"picklable objects can be executed and returned."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:206
|
|
msgid ""
|
|
"The ``__main__`` module must be importable by worker subprocesses. This "
|
|
"means that :class:`ProcessPoolExecutor` will not work in the interactive "
|
|
"interpreter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:209
|
|
msgid ""
|
|
"Calling :class:`Executor` or :class:`Future` methods from a callable "
|
|
"submitted to a :class:`ProcessPoolExecutor` will result in deadlock."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:214
|
|
msgid ""
|
|
"An :class:`Executor` subclass that executes calls asynchronously using a "
|
|
"pool of at most *max_workers* processes. If *max_workers* is ``None`` or "
|
|
"not given, it will default to the number of processors on the machine. If "
|
|
"*max_workers* is lower or equal to ``0``, then a :exc:`ValueError` will be "
|
|
"raised. *mp_context* can be a multiprocessing context or None. It will be "
|
|
"used to launch the workers. If *mp_context* is ``None`` or not given, the "
|
|
"default multiprocessing context is used."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:223
|
|
msgid ""
|
|
"*initializer* is an optional callable that is called at the start of each "
|
|
"worker process; *initargs* is a tuple of arguments passed to the "
|
|
"initializer. Should *initializer* raise an exception, all currently pending "
|
|
"jobs will raise a :exc:`~concurrent.futures.thread.BrokenThreadPool`, as "
|
|
"well any attempt to submit more jobs to the pool."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:229
|
|
msgid ""
|
|
"When one of the worker processes terminates abruptly, a :exc:"
|
|
"`BrokenProcessPool` error is now raised. Previously, behaviour was "
|
|
"undefined but operations on the executor or its futures would often freeze "
|
|
"or deadlock."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:235
|
|
msgid ""
|
|
"The *mp_context* argument was added to allow users to control the "
|
|
"start_method for worker processes created by the pool."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:245
|
|
msgid "ProcessPoolExecutor Example"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:279
|
|
msgid "Future Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:281
|
|
msgid ""
|
|
"The :class:`Future` class encapsulates the asynchronous execution of a "
|
|
"callable. :class:`Future` instances are created by :meth:`Executor.submit`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:286
|
|
msgid ""
|
|
"Encapsulates the asynchronous execution of a callable. :class:`Future` "
|
|
"instances are created by :meth:`Executor.submit` and should not be created "
|
|
"directly except for testing."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:292
|
|
msgid ""
|
|
"Attempt to cancel the call. If the call is currently being executed and "
|
|
"cannot be cancelled then the method will return ``False``, otherwise the "
|
|
"call will be cancelled and the method will return ``True``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:298
|
|
msgid "Return ``True`` if the call was successfully cancelled."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:302
|
|
msgid ""
|
|
"Return ``True`` if the call is currently being executed and cannot be "
|
|
"cancelled."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:307
|
|
msgid ""
|
|
"Return ``True`` if the call was successfully cancelled or finished running."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:312
|
|
msgid ""
|
|
"Return the value returned by the call. If the call hasn't yet completed then "
|
|
"this method will wait up to *timeout* seconds. If the call hasn't completed "
|
|
"in *timeout* seconds, then a :exc:`concurrent.futures.TimeoutError` will be "
|
|
"raised. *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/concurrent.futures.rst:319
|
|
#: ../Doc/library/concurrent.futures.rst:333
|
|
msgid ""
|
|
"If the future is cancelled before completing then :exc:`.CancelledError` "
|
|
"will be raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:322
|
|
msgid "If the call raised, this method will raise the same exception."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:326
|
|
msgid ""
|
|
"Return the exception raised by the call. If the call hasn't yet completed "
|
|
"then this method will wait up to *timeout* seconds. If the call hasn't "
|
|
"completed in *timeout* seconds, then a :exc:`concurrent.futures."
|
|
"TimeoutError` will be raised. *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/concurrent.futures.rst:336
|
|
msgid "If the call completed without raising, ``None`` is returned."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:340
|
|
msgid ""
|
|
"Attaches the callable *fn* to the future. *fn* will be called, with the "
|
|
"future as its only argument, when the future is cancelled or finishes "
|
|
"running."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:344
|
|
msgid ""
|
|
"Added callables are called in the order that they were added and are always "
|
|
"called in a thread belonging to the process that added them. If the "
|
|
"callable raises an :exc:`Exception` subclass, it will be logged and "
|
|
"ignored. If the callable raises a :exc:`BaseException` subclass, the "
|
|
"behavior is undefined."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:350
|
|
msgid ""
|
|
"If the future has already completed or been cancelled, *fn* will be called "
|
|
"immediately."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:353
|
|
msgid ""
|
|
"The following :class:`Future` methods are meant for use in unit tests and :"
|
|
"class:`Executor` implementations."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:358
|
|
msgid ""
|
|
"This method should only be called by :class:`Executor` implementations "
|
|
"before executing the work associated with the :class:`Future` and by unit "
|
|
"tests."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:362
|
|
msgid ""
|
|
"If the method returns ``False`` then the :class:`Future` was cancelled, i."
|
|
"e. :meth:`Future.cancel` was called and returned `True`. Any threads "
|
|
"waiting on the :class:`Future` completing (i.e. through :func:`as_completed` "
|
|
"or :func:`wait`) will be woken up."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:367
|
|
msgid ""
|
|
"If the method returns ``True`` then the :class:`Future` was not cancelled "
|
|
"and has been put in the running state, i.e. calls to :meth:`Future.running` "
|
|
"will return `True`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:371
|
|
msgid ""
|
|
"This method can only be called once and cannot be called after :meth:`Future."
|
|
"set_result` or :meth:`Future.set_exception` have been called."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:377
|
|
msgid ""
|
|
"Sets the result of the work associated with the :class:`Future` to *result*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:380
|
|
#: ../Doc/library/concurrent.futures.rst:388
|
|
msgid ""
|
|
"This method should only be used by :class:`Executor` implementations and "
|
|
"unit tests."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:385
|
|
msgid ""
|
|
"Sets the result of the work associated with the :class:`Future` to the :"
|
|
"class:`Exception` *exception*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:393
|
|
msgid "Module Functions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:397
|
|
msgid ""
|
|
"Wait for the :class:`Future` instances (possibly created by different :class:"
|
|
"`Executor` instances) given by *fs* to complete. Returns a named 2-tuple of "
|
|
"sets. The first set, named ``done``, contains the futures that completed "
|
|
"(finished or were cancelled) before the wait completed. The second set, "
|
|
"named ``not_done``, contains uncompleted futures."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:403
|
|
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/concurrent.futures.rst:407
|
|
msgid ""
|
|
"*return_when* indicates when this function should return. It must be one of "
|
|
"the following constants:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:413
|
|
msgid "Constant"
|
|
msgstr "Constante"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:413
|
|
msgid "Description"
|
|
msgstr "Description"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:415
|
|
msgid ":const:`FIRST_COMPLETED`"
|
|
msgstr ":const:`FIRST_COMPLETED`"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:415
|
|
msgid "The function will return when any future finishes or is cancelled."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:418
|
|
msgid ":const:`FIRST_EXCEPTION`"
|
|
msgstr ":const:`FIRST_EXCEPTION`"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:418
|
|
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/concurrent.futures.rst:424
|
|
msgid ":const:`ALL_COMPLETED`"
|
|
msgstr ":const:`ALL_COMPLETED`"
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:424
|
|
msgid "The function will return when all futures finish or are cancelled."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:430
|
|
msgid ""
|
|
"Returns an iterator over the :class:`Future` instances (possibly created by "
|
|
"different :class:`Executor` instances) given by *fs* that yields futures as "
|
|
"they complete (finished or were cancelled). Any futures given by *fs* that "
|
|
"are duplicated will be returned once. Any futures that completed before :"
|
|
"func:`as_completed` is called will be yielded first. The returned iterator "
|
|
"raises a :exc:`concurrent.futures.TimeoutError` if :meth:`~iterator."
|
|
"__next__` is called and the result isn't available after *timeout* seconds "
|
|
"from the original call to :func:`as_completed`. *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/concurrent.futures.rst:444
|
|
msgid ":pep:`3148` -- futures - execute computations asynchronously"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:444
|
|
msgid ""
|
|
"The proposal which described this feature for inclusion in the Python "
|
|
"standard library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:449
|
|
msgid "Exception classes"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:455
|
|
msgid "Raised when a future is cancelled."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:459
|
|
msgid "Raised when a future operation exceeds the given timeout."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:463
|
|
msgid ""
|
|
"Derived from :exc:`RuntimeError`, this exception class is raised when an "
|
|
"executor is broken for some reason, and cannot be used to submit or execute "
|
|
"new tasks."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:473
|
|
msgid ""
|
|
"Derived from :exc:`~concurrent.futures.BrokenExecutor`, this exception class "
|
|
"is raised when one of the workers of a :class:`ThreadPoolExecutor` has "
|
|
"failed initializing."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/concurrent.futures.rst:483
|
|
msgid ""
|
|
"Derived from :exc:`~concurrent.futures.BrokenExecutor` (formerly :exc:"
|
|
"`RuntimeError`), this exception class is raised when one of the workers of "
|
|
"a :class:`ProcessPoolExecutor` has terminated in a non-clean fashion (for "
|
|
"example, if it was killed from the outside)."
|
|
msgstr ""
|