forked from AFPy/python-docs-fr
252 lines
7.6 KiB
Plaintext
252 lines
7.6 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: 2020-10-01 16:00+0200\n"
|
||
"PO-Revision-Date: 2018-10-13 17:38+0200\n"
|
||
"Last-Translator: Julien Palard <julien@palard.fr>\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-dev.rst:7
|
||
msgid "Developing with asyncio"
|
||
msgstr "Programmer avec *asyncio*"
|
||
|
||
#: library/asyncio-dev.rst:9
|
||
msgid ""
|
||
"Asynchronous programming is different from classic \"sequential\" "
|
||
"programming."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:12
|
||
msgid ""
|
||
"This page lists common mistakes and traps and explains how to avoid them."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:19
|
||
msgid "Debug Mode"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:21
|
||
msgid ""
|
||
"By default asyncio runs in production mode. In order to ease the "
|
||
"development asyncio has a *debug mode*."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:24
|
||
msgid "There are several ways to enable asyncio debug mode:"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:26
|
||
msgid "Setting the :envvar:`PYTHONASYNCIODEBUG` environment variable to ``1``."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:28
|
||
msgid "Using the :ref:`Python Development Mode <devmode>`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:30
|
||
msgid "Passing ``debug=True`` to :func:`asyncio.run`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:32
|
||
msgid "Calling :meth:`loop.set_debug`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:34
|
||
msgid "In addition to enabling the debug mode, consider also:"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:36
|
||
msgid ""
|
||
"setting the log level of the :ref:`asyncio logger <asyncio-logger>` to :py:"
|
||
"data:`logging.DEBUG`, for example the following snippet of code can be run "
|
||
"at startup of the application::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:42
|
||
msgid ""
|
||
"configuring the :mod:`warnings` module to display :exc:`ResourceWarning` "
|
||
"warnings. One way of doing that is by using the :option:`-W` ``default`` "
|
||
"command line option."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:47
|
||
msgid "When the debug mode is enabled:"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:49
|
||
msgid ""
|
||
"asyncio checks for :ref:`coroutines that were not awaited <asyncio-coroutine-"
|
||
"not-scheduled>` and logs them; this mitigates the \"forgotten await\" "
|
||
"pitfall."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:53
|
||
msgid ""
|
||
"Many non-threadsafe asyncio APIs (such as :meth:`loop.call_soon` and :meth:"
|
||
"`loop.call_at` methods) raise an exception if they are called from a wrong "
|
||
"thread."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:57
|
||
msgid ""
|
||
"The execution time of the I/O selector is logged if it takes too long to "
|
||
"perform an I/O operation."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:60
|
||
msgid ""
|
||
"Callbacks taking longer than 100ms are logged. The :attr:`loop."
|
||
"slow_callback_duration` attribute can be used to set the minimum execution "
|
||
"duration in seconds that is considered \"slow\"."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:68
|
||
msgid "Concurrency and Multithreading"
|
||
msgstr "Concourance et *multithreading*"
|
||
|
||
#: library/asyncio-dev.rst:70
|
||
msgid ""
|
||
"An event loop runs in a thread (typically the main thread) and executes all "
|
||
"callbacks and Tasks in its thread. While a Task is running in the event "
|
||
"loop, no other Tasks can run in the same thread. When a Task executes an "
|
||
"``await`` expression, the running Task gets suspended, and the event loop "
|
||
"executes the next Task."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:76
|
||
msgid ""
|
||
"To schedule a :term:`callback` from another OS thread, the :meth:`loop."
|
||
"call_soon_threadsafe` method should be used. Example::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:81
|
||
msgid ""
|
||
"Almost all asyncio objects are not thread safe, which is typically not a "
|
||
"problem unless there is code that works with them from outside of a Task or "
|
||
"a callback. If there's a need for such code to call a low-level asyncio "
|
||
"API, the :meth:`loop.call_soon_threadsafe` method should be used, e.g.::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:89
|
||
msgid ""
|
||
"To schedule a coroutine object from a different OS thread, the :func:"
|
||
"`run_coroutine_threadsafe` function should be used. It returns a :class:"
|
||
"`concurrent.futures.Future` to access the result::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:102
|
||
msgid ""
|
||
"To handle signals and to execute subprocesses, the event loop must be run in "
|
||
"the main thread."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:105
|
||
msgid ""
|
||
"The :meth:`loop.run_in_executor` method can be used with a :class:"
|
||
"`concurrent.futures.ThreadPoolExecutor` to execute blocking code in a "
|
||
"different OS thread without blocking the OS thread that the event loop runs "
|
||
"in."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:110
|
||
msgid ""
|
||
"There is currently no way to schedule coroutines or callbacks directly from "
|
||
"a different process (such as one started with :mod:`multiprocessing`). The :"
|
||
"ref:`Event Loop Methods <asyncio-event-loop>` section lists APIs that can "
|
||
"read from pipes and watch file descriptors without blocking the event loop. "
|
||
"In addition, asyncio's :ref:`Subprocess <asyncio-subprocess>` APIs provide a "
|
||
"way to start a process and communicate with it from the event loop. Lastly, "
|
||
"the aforementioned :meth:`loop.run_in_executor` method can also be used with "
|
||
"a :class:`concurrent.futures.ProcessPoolExecutor` to execute code in a "
|
||
"different process."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:124
|
||
msgid "Running Blocking Code"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:126
|
||
msgid ""
|
||
"Blocking (CPU-bound) code should not be called directly. For example, if a "
|
||
"function performs a CPU-intensive calculation for 1 second, all concurrent "
|
||
"asyncio Tasks and IO operations would be delayed by 1 second."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:131
|
||
msgid ""
|
||
"An executor can be used to run a task in a different thread or even in a "
|
||
"different process to avoid blocking the OS thread with the event loop. See "
|
||
"the :meth:`loop.run_in_executor` method for more details."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:140
|
||
msgid "Logging"
|
||
msgstr "Journalisation"
|
||
|
||
#: library/asyncio-dev.rst:142
|
||
msgid ""
|
||
"asyncio uses the :mod:`logging` module and all logging is performed via the "
|
||
"``\"asyncio\"`` logger."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:145
|
||
msgid ""
|
||
"The default log level is :py:data:`logging.INFO`, which can be easily "
|
||
"adjusted::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:154
|
||
msgid "Detect never-awaited coroutines"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:156
|
||
msgid ""
|
||
"When a coroutine function is called, but not awaited (e.g. ``coro()`` "
|
||
"instead of ``await coro()``) or the coroutine is not scheduled with :meth:"
|
||
"`asyncio.create_task`, asyncio will emit a :exc:`RuntimeWarning`::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:216
|
||
msgid "Output::"
|
||
msgstr "Sortie ::"
|
||
|
||
#: library/asyncio-dev.rst:232
|
||
msgid "Output in debug mode::"
|
||
msgstr "Affichage en mode débogage ::"
|
||
|
||
#: library/asyncio-dev.rst:189
|
||
msgid ""
|
||
"The usual fix is to either await the coroutine or call the :meth:`asyncio."
|
||
"create_task` function::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:197
|
||
msgid "Detect never-retrieved exceptions"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:199
|
||
msgid ""
|
||
"If a :meth:`Future.set_exception` is called but the Future object is never "
|
||
"awaited on, the exception would never be propagated to the user code. In "
|
||
"this case, asyncio would emit a log message when the Future object is "
|
||
"garbage collected."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:204
|
||
msgid "Example of an unhandled exception::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-dev.rst:227
|
||
msgid ""
|
||
":ref:`Enable the debug mode <asyncio-debug-mode>` to get the traceback where "
|
||
"the task was created::"
|
||
msgstr ""
|