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

2114 lines
68 KiB
Plaintext
Raw Permalink Normal View History

2018-07-04 09:06:45 +00:00
# Copyright (C) 2001-2018, Python Software Foundation
2018-07-04 09:08:42 +00:00
# For licence information, see README file.
2016-10-30 09:46:26 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2016-10-30 09:46:26 +00:00
"Report-Msgid-Bugs-To: \n"
2023-04-14 11:20:40 +00:00
"POT-Creation-Date: 2023-04-14 13:19+0200\n"
"PO-Revision-Date: 2019-06-10 15:50+0200\n"
2018-07-05 09:39:28 +00:00
"Last-Translator: Julien Palard <julien@palard.fr>\n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-23 22:40:56 +00:00
"Language: fr\n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 2.0.2\n"
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:8
2018-10-13 15:54:03 +00:00
msgid "Event Loop"
2018-10-14 22:47:12 +00:00
msgstr "Boucle d'évènements"
2017-08-01 11:29:09 +00:00
#: library/asyncio-eventloop.rst:10
msgid ""
"**Source code:** :source:`Lib/asyncio/events.py`, :source:`Lib/asyncio/"
"base_events.py`"
msgstr ""
#: library/asyncio-eventloop.rst:16
2018-10-13 15:54:03 +00:00
msgid "Preface"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:17
2018-10-13 15:54:03 +00:00
msgid ""
"The event loop is the core of every asyncio application. Event loops run "
"asynchronous tasks and callbacks, perform network IO operations, and run "
"subprocesses."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:21
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Application developers should typically use the high-level asyncio "
"functions, such as :func:`asyncio.run`, and should rarely need to reference "
"the loop object or call its methods. This section is intended mostly for "
"authors of lower-level code, libraries, and frameworks, who need finer "
"control over the event loop behavior."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:28
2018-10-13 15:54:03 +00:00
msgid "Obtaining the Event Loop"
msgstr "Obtenir une boucle d'évènements"
#: library/asyncio-eventloop.rst:29
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The following low-level functions can be used to get, set, or create an "
"event loop:"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:34
2018-10-13 15:54:03 +00:00
msgid "Return the running event loop in the current OS thread."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:36
msgid "Raise a :exc:`RuntimeError` if there is no running event loop."
msgstr ""
#: library/asyncio-eventloop.rst:38
msgid "This function can only be called from a coroutine or a callback."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:44
2020-02-04 10:14:03 +00:00
#, fuzzy
msgid "Get the current event loop."
msgstr "Arrête l'exécution de la boucle d'évènements."
#: library/asyncio-eventloop.rst:46
msgid ""
"When called from a coroutine or a callback (e.g. scheduled with call_soon or "
"similar API), this function will always return the running event loop."
msgstr ""
#: library/asyncio-eventloop.rst:50
2018-10-13 15:54:03 +00:00
msgid ""
"If there is no running event loop set, the function will return the result "
"of the ``get_event_loop_policy().get_event_loop()`` call."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:53
2018-10-13 15:54:03 +00:00
msgid ""
"Because this function has rather complex behavior (especially when custom "
"event loop policies are in use), using the :func:`get_running_loop` function "
"is preferred to :func:`get_event_loop` in coroutines and callbacks."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:58
2016-10-30 09:46:26 +00:00
msgid ""
"As noted above, consider using the higher-level :func:`asyncio.run` "
"function, instead of using these lower level functions to manually create "
"and close an event loop."
2018-10-13 15:54:03 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:63
msgid ""
"In Python versions 3.10.0--3.10.8 and 3.11.0 this function (and other "
"functions which use it implicitly) emitted a :exc:`DeprecationWarning` if "
"there was no running event loop, even if the current loop was set on the "
"policy. In Python versions 3.10.9, 3.11.1 and 3.12 they emit a :exc:"
"`DeprecationWarning` if there is no running event loop and no current loop "
"is set. In some future Python release this will become an error."
msgstr ""
#: library/asyncio-eventloop.rst:74
#, fuzzy
msgid "Set *loop* as the current event loop for the current OS thread."
2016-10-30 09:46:26 +00:00
msgstr ""
"Appelle le gestionnaire d'exception de la boucle d'évènements actuelle."
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:78
2021-12-31 10:41:52 +00:00
msgid "Create and return a new event loop object."
2018-10-13 15:54:03 +00:00
msgstr ""
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:80
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Note that the behaviour of :func:`get_event_loop`, :func:`set_event_loop`, "
"and :func:`new_event_loop` functions can be altered by :ref:`setting a "
"custom event loop policy <asyncio-policies>`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:86
2018-10-13 15:54:03 +00:00
msgid "Contents"
msgstr "Sommaire"
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:87
2018-10-13 15:54:03 +00:00
msgid "This documentation page contains the following sections:"
msgstr ""
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:89
2018-10-13 15:54:03 +00:00
msgid ""
"The `Event Loop Methods`_ section is the reference documentation of the "
"event loop APIs;"
msgstr ""
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:92
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The `Callback Handles`_ section documents the :class:`Handle` and :class:"
"`TimerHandle` instances which are returned from scheduling methods such as :"
"meth:`loop.call_soon` and :meth:`loop.call_later`;"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:96
2018-10-13 15:54:03 +00:00
msgid ""
"The `Server Objects`_ section documents types returned from event loop "
"methods like :meth:`loop.create_server`;"
msgstr ""
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:99
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The `Event Loop Implementations`_ section documents the :class:"
"`SelectorEventLoop` and :class:`ProactorEventLoop` classes;"
msgstr ""
#: library/asyncio-eventloop.rst:102
2018-10-13 15:54:03 +00:00
msgid ""
"The `Examples`_ section showcases how to work with some event loop APIs."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:109
2018-10-13 15:54:03 +00:00
msgid "Event Loop Methods"
msgstr "Méthodes de la boucle d'évènements"
#: library/asyncio-eventloop.rst:111
2018-10-13 15:54:03 +00:00
msgid "Event loops have **low-level** APIs for the following:"
msgstr ""
#: library/asyncio-eventloop.rst:119
2018-10-13 15:54:03 +00:00
msgid "Running and stopping the loop"
msgstr "Démarrer et arrêter une boucle d'évènements"
#: library/asyncio-eventloop.rst:123
2018-10-13 15:54:03 +00:00
msgid "Run until the *future* (an instance of :class:`Future`) has completed."
msgstr ""
"Lance la boucle jusqu'à ce que *future* (une instance de :class:`Future`) "
"soit terminée."
#: library/asyncio-eventloop.rst:126
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"If the argument is a :ref:`coroutine object <coroutine>` it is implicitly "
"scheduled to run as a :class:`asyncio.Task`."
msgstr ""
#: library/asyncio-eventloop.rst:129
2018-10-13 15:54:03 +00:00
msgid "Return the Future's result or raise its exception."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:133
2018-10-13 15:54:03 +00:00
msgid "Run the event loop until :meth:`stop` is called."
msgstr ""
#: library/asyncio-eventloop.rst:135
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"If :meth:`stop` is called before :meth:`run_forever()` is called, the loop "
"will poll the I/O selector once with a timeout of zero, run all callbacks "
"scheduled in response to I/O events (and those that were already scheduled), "
"and then exit."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:140
2017-04-02 20:14:06 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"If :meth:`stop` is called while :meth:`run_forever` is running, the loop "
"will run the current batch of callbacks and then exit. Note that new "
"callbacks scheduled by callbacks will not run in this case; instead, they "
"will run the next time :meth:`run_forever` or :meth:`run_until_complete` is "
"called."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:148
2018-10-13 15:54:03 +00:00
msgid "Stop the event loop."
msgstr "Arrête l'exécution de la boucle d'évènements."
#: library/asyncio-eventloop.rst:152
2018-10-13 15:54:03 +00:00
msgid "Return ``True`` if the event loop is currently running."
msgstr "Renvoie ``True`` si la boucle d'évènements est démarrée."
#: library/asyncio-eventloop.rst:156
2018-10-13 15:54:03 +00:00
msgid "Return ``True`` if the event loop was closed."
2018-10-14 22:47:12 +00:00
msgstr "Renvoie ``True`` si la boucle d'évènements est arrêtée."
2016-10-30 09:46:26 +00:00
#: library/asyncio-eventloop.rst:160
2018-10-13 15:54:03 +00:00
msgid "Close the event loop."
2018-10-14 22:47:12 +00:00
msgstr "Arrête la boucle d'évènements."
2018-10-13 15:54:03 +00:00
#: library/asyncio-eventloop.rst:162
2016-10-30 09:46:26 +00:00
msgid ""
2018-11-29 15:13:39 +00:00
"The loop must not be running when this function is called. Any pending "
"callbacks will be discarded."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:165
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This method clears all queues and shuts down the executor, but does not wait "
"for the executor to finish."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:168
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This method is idempotent and irreversible. No other methods should be "
"called after the event loop is closed."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/asyncio-eventloop.rst:173
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Schedule all currently open :term:`asynchronous generator` objects to close "
"with an :meth:`~agen.aclose()` call. After calling this method, the event "
"loop will issue a warning if a new asynchronous generator is iterated. This "
"should be used to reliably finalize all scheduled asynchronous generators."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:179
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Note that there is no need to call this function when :func:`asyncio.run` is "
"used."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:182 library/asyncio-eventloop.rst:1216
#: library/asyncio-eventloop.rst:1604
2018-10-13 15:54:03 +00:00
msgid "Example::"
msgstr "Exemple ::"
#: library/asyncio-eventloop.rst:194
2020-07-20 08:56:42 +00:00
msgid ""
"Schedule the closure of the default executor and wait for it to join all of "
2023-04-14 11:20:40 +00:00
"the threads in the :class:`~concurrent.futures.ThreadPoolExecutor`. Once "
"this method has been called, using the default executor with :meth:`loop."
"run_in_executor` will raise a :exc:`RuntimeError`."
2020-07-20 08:56:42 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:202
msgid ""
"Do not call this method when using :func:`asyncio.run`, as the latter "
"handles default executor shutdown automatically."
msgstr ""
#: library/asyncio-eventloop.rst:209
2018-10-13 15:54:03 +00:00
msgid "Scheduling callbacks"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:213
2018-10-13 15:54:03 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"Schedule the *callback* :term:`callback` to be called with *args* arguments "
"at the next iteration of the event loop."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:216
2018-10-13 15:54:03 +00:00
msgid ""
2023-04-14 11:20:40 +00:00
"Return an instance of :class:`asyncio.Handle`, which can be used later to "
"cancel the callback."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:219
2018-06-28 13:32:56 +00:00
msgid ""
2023-04-14 11:20:40 +00:00
"Callbacks are called in the order in which they are registered. Each "
"callback will be called exactly once."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:222
2016-10-30 09:46:26 +00:00
msgid ""
2023-04-14 11:20:40 +00:00
"The optional keyword-only *context* argument specifies a custom :class:"
"`contextvars.Context` for the *callback* to run in. Callbacks use the "
"current context when no *context* is provided."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:226
msgid "Unlike :meth:`call_soon_threadsafe`, this method is not thread-safe."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:230
2016-10-30 09:46:26 +00:00
msgid ""
2023-04-14 11:20:40 +00:00
"A thread-safe variant of :meth:`call_soon`. When scheduling callbacks from "
"another thread, this function *must* be used, since :meth:`call_soon` is not "
"thread-safe."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:234
msgid ""
"Raises :exc:`RuntimeError` if called on a loop that's been closed. This can "
"happen on a secondary thread when the main application is shutting down."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:238
2018-10-13 15:54:03 +00:00
msgid ""
"See the :ref:`concurrency and multithreading <asyncio-multithreading>` "
"section of the documentation."
msgstr ""
2019-05-28 12:44:15 +00:00
"Voir la section :ref:`exécution concurrente et multi-fils d'exécution "
"<asyncio-multithreading>` de la documentation."
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:241 library/asyncio-eventloop.rst:291
#: library/asyncio-eventloop.rst:311
2018-06-28 13:32:56 +00:00
msgid ""
"The *context* keyword-only parameter was added. See :pep:`567` for more "
"details."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:249
2018-10-13 15:54:03 +00:00
msgid ""
"Most :mod:`asyncio` scheduling functions don't allow passing keyword "
"arguments. To do that, use :func:`functools.partial`::"
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:256
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Using partial objects is usually more convenient than using lambdas, as "
"asyncio can render partial objects better in debug and error messages."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:264
2018-10-13 15:54:03 +00:00
msgid "Scheduling delayed callbacks"
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:266
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Event loop provides mechanisms to schedule callback functions to be called "
"at some point in the future. Event loop uses monotonic clocks to track time."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:273
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Schedule *callback* to be called after the given *delay* number of seconds "
"(can be either an int or a float)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:276 library/asyncio-eventloop.rst:308
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"An instance of :class:`asyncio.TimerHandle` is returned which can be used to "
"cancel the callback."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:279
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*callback* will be called exactly once. If two callbacks are scheduled for "
"exactly the same time, the order in which they are called is undefined."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:283
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The optional positional *args* will be passed to the callback when it is "
"called. If you want the callback to be called with keyword arguments use :"
"func:`functools.partial`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:287
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-eventloop.rst:295
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"In Python 3.7 and earlier with the default event loop implementation, the "
"*delay* could not exceed one day. This has been fixed in Python 3.8."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:302
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Schedule *callback* to be called at the given absolute timestamp *when* (an "
"int or a float), using the same time reference as :meth:`loop.time`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:306
2016-10-30 09:46:26 +00:00
msgid "This method's behavior is the same as :meth:`call_later`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:315
2018-10-13 15:54:03 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"In Python 3.7 and earlier with the default event loop implementation, the "
2018-10-13 15:54:03 +00:00
"difference between *when* and the current time could not exceed one day. "
2019-09-04 09:35:23 +00:00
"This has been fixed in Python 3.8."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:322
2016-10-30 09:46:26 +00:00
msgid ""
"Return the current time, as a :class:`float` value, according to the event "
2018-10-13 15:54:03 +00:00
"loop's internal monotonic clock."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:326
2018-10-13 15:54:03 +00:00
msgid ""
"In Python 3.7 and earlier timeouts (relative *delay* or absolute *when*) "
"should not exceed one day. This has been fixed in Python 3.8."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:332
2016-10-30 09:46:26 +00:00
msgid "The :func:`asyncio.sleep` function."
msgstr "La fonction :func:`asyncio.sleep`."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:336
2018-10-13 15:54:03 +00:00
msgid "Creating Futures and Tasks"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:340
2018-10-13 15:54:03 +00:00
msgid "Create an :class:`asyncio.Future` object attached to the event loop."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:342
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This is the preferred way to create Futures in asyncio. This lets third-"
"party event loops provide alternative implementations of the Future object "
2016-10-30 09:46:26 +00:00
"(with better performance or instrumentation)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:350
2016-10-30 09:46:26 +00:00
msgid ""
"Schedule the execution of :ref:`coroutine <coroutine>` *coro*. Return a :"
"class:`Task` object."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:353
2016-10-30 09:46:26 +00:00
msgid ""
"Third-party event loops can use their own subclass of :class:`Task` for "
"interoperability. In this case, the result type is a subclass of :class:"
"`Task`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:357
2019-09-04 09:35:23 +00:00
msgid ""
"If the *name* argument is provided and not ``None``, it is set as the name "
"of the task using :meth:`Task.set_name`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:360
2022-03-23 17:40:12 +00:00
msgid ""
"An optional keyword-only *context* argument allows specifying a custom :"
"class:`contextvars.Context` for the *coro* to run in. The current context "
"copy is created when no *context* is provided."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:364
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "Added the *name* parameter."
msgstr "ajout du paramètre ``name``."
2019-09-04 09:35:23 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:367
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "Added the *context* parameter."
msgstr "ajout du paramètre ``name``."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:372
2018-10-13 15:54:03 +00:00
msgid "Set a task factory that will be used by :meth:`loop.create_task`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:375
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"If *factory* is ``None`` the default task factory will be set. Otherwise, "
2022-03-23 17:40:12 +00:00
"*factory* must be a *callable* with the signature matching ``(loop, coro, "
"context=None)``, where *loop* is a reference to the active event loop, and "
"*coro* is a coroutine object. The callable must return a :class:`asyncio."
"Future`-compatible object."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:383
2018-10-13 15:54:03 +00:00
msgid "Return a task factory or ``None`` if the default one is in use."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:387
2018-10-13 15:54:03 +00:00
msgid "Opening network connections"
2018-10-14 22:47:12 +00:00
msgstr "Créer des connexions"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:397
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Open a streaming transport connection to a given address specified by *host* "
"and *port*."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:400
2018-10-13 15:54:03 +00:00
msgid ""
"The socket family can be either :py:data:`~socket.AF_INET` or :py:data:"
"`~socket.AF_INET6` depending on *host* (or the *family* argument, if "
"provided)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:404
2018-10-13 15:54:03 +00:00
msgid "The socket type will be :py:data:`~socket.SOCK_STREAM`."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:406 library/asyncio-eventloop.rst:1132
#: library/asyncio-eventloop.rst:1148
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*protocol_factory* must be a callable returning an :ref:`asyncio protocol "
"<asyncio-protocol>` implementation."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:409
2016-10-30 09:46:26 +00:00
msgid ""
2018-06-28 13:32:56 +00:00
"This method will try to establish the connection in the background. When "
"successful, it returns a ``(transport, protocol)`` pair."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:412
2016-10-30 09:46:26 +00:00
msgid "The chronological synopsis of the underlying operation is as follows:"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:414
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The connection is established and a :ref:`transport <asyncio-transport>` is "
"created for it."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:417
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*protocol_factory* is called without arguments and is expected to return a :"
"ref:`protocol <asyncio-protocol>` instance."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:420
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The protocol instance is coupled with the transport by calling its :meth:"
"`~BaseProtocol.connection_made` method."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:423
2018-10-13 15:54:03 +00:00
msgid "A ``(transport, protocol)`` tuple is returned on success."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:425
2016-10-30 09:46:26 +00:00
msgid ""
"The created transport is an implementation-dependent bidirectional stream."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:428 library/asyncio-eventloop.rst:549
2018-10-13 15:54:03 +00:00
msgid "Other arguments:"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:430
2016-10-30 09:46:26 +00:00
msgid ""
"*ssl*: if given and not false, a SSL/TLS transport is created (by default a "
"plain TCP transport is created). If *ssl* is a :class:`ssl.SSLContext` "
"object, this context is used to create the transport; if *ssl* is :const:"
2018-10-13 15:54:03 +00:00
"`True`, a default context returned from :func:`ssl.create_default_context` "
"is used."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:436
2016-10-30 09:46:26 +00:00
msgid ":ref:`SSL/TLS security considerations <ssl-security>`"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:438
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*server_hostname* sets or overrides the hostname that the target server's "
"certificate will be matched against. Should only be passed if *ssl* is not "
"``None``. By default the value of the *host* argument is used. If *host* "
"is empty, there is no default and you must pass a value for "
"*server_hostname*. If *server_hostname* is an empty string, hostname "
"matching is disabled (which is a serious security risk, allowing for "
"potential man-in-the-middle attacks)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:446
2016-10-30 09:46:26 +00:00
msgid ""
"*family*, *proto*, *flags* are the optional address family, protocol and "
"flags to be passed through to getaddrinfo() for *host* resolution. If given, "
"these should all be integers from the corresponding :mod:`socket` module "
"constants."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:451
2019-09-04 09:35:23 +00:00
msgid ""
"*happy_eyeballs_delay*, if given, enables Happy Eyeballs for this "
"connection. It should be a floating-point number representing the amount of "
"time in seconds to wait for a connection attempt to complete, before "
2022-03-23 17:40:12 +00:00
"starting the next attempt in parallel. This is the \"Connection Attempt "
"Delay\" as defined in :rfc:`8305`. A sensible default value recommended by "
"the RFC is ``0.25`` (250 milliseconds)."
2019-09-04 09:35:23 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:459
2019-09-04 09:35:23 +00:00
msgid ""
"*interleave* controls address reordering when a host name resolves to "
"multiple IP addresses. If ``0`` or unspecified, no reordering is done, and "
"addresses are tried in the order returned by :meth:`getaddrinfo`. If a "
"positive integer is specified, the addresses are interleaved by address "
2022-03-23 17:40:12 +00:00
"family, and the given integer is interpreted as \"First Address Family "
"Count\" as defined in :rfc:`8305`. The default is ``0`` if "
"*happy_eyeballs_delay* is not specified, and ``1`` if it is."
2019-09-04 09:35:23 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:468
2016-10-30 09:46:26 +00:00
msgid ""
"*sock*, if given, should be an existing, already connected :class:`socket."
"socket` object to be used by the transport. If *sock* is given, none of "
2019-09-04 09:35:23 +00:00
"*host*, *port*, *family*, *proto*, *flags*, *happy_eyeballs_delay*, "
"*interleave* and *local_addr* should be specified."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:476 library/asyncio-eventloop.rst:580
#: library/asyncio-eventloop.rst:804
msgid ""
"The *sock* argument transfers ownership of the socket to the transport "
"created. To close the socket, call the transport's :meth:`~asyncio."
"BaseTransport.close` method."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:480
2016-10-30 09:46:26 +00:00
msgid ""
"*local_addr*, if given, is a ``(local_host, local_port)`` tuple used to bind "
2021-06-04 11:47:25 +00:00
"the socket locally. The *local_host* and *local_port* are looked up using "
"``getaddrinfo()``, similarly to *host* and *port*."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:484 library/asyncio-eventloop.rst:895
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*ssl_handshake_timeout* is (for a TLS connection) the time in seconds to "
"wait for the TLS handshake to complete before aborting the connection. "
2018-06-28 13:32:56 +00:00
"``60.0`` seconds if ``None`` (default)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:488 library/asyncio-eventloop.rst:721
#: library/asyncio-eventloop.rst:815 library/asyncio-eventloop.rst:899
2022-03-23 17:40:12 +00:00
msgid ""
"*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown "
"to complete before aborting the connection. ``30.0`` seconds if ``None`` "
"(default)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:494 library/asyncio-eventloop.rst:733
2022-03-23 17:40:12 +00:00
msgid "Added support for SSL/TLS in :class:`ProactorEventLoop`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:498
2022-03-23 17:40:12 +00:00
msgid ""
"The socket option :py:data:`~socket.TCP_NODELAY` is set by default for all "
"TCP connections."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:503 library/asyncio-eventloop.rst:825
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "Added the *ssl_handshake_timeout* parameter."
msgstr "ajout du paramètre ``name``."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:507
2020-05-24 14:31:50 +00:00
msgid "Added the *happy_eyeballs_delay* and *interleave* parameters."
2019-09-04 09:35:23 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:509
2020-05-24 14:31:50 +00:00
msgid ""
"Happy Eyeballs Algorithm: Success with Dual-Stack Hosts. When a server's "
"IPv4 path and protocol are working, but the server's IPv6 path and protocol "
"are not working, a dual-stack client application experiences significant "
"connection delay compared to an IPv4-only client. This is undesirable "
2023-04-14 11:20:40 +00:00
"because it causes the dual-stack client to have a worse user experience. "
2020-05-24 14:31:50 +00:00
"This document specifies requirements for algorithms that reduce this user-"
"visible delay and provides an algorithm."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:518
2020-05-24 14:31:50 +00:00
msgid "For more information: https://tools.ietf.org/html/rfc6555"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:522 library/asyncio-eventloop.rst:641
#: library/asyncio-eventloop.rst:747 library/asyncio-eventloop.rst:782
#: library/asyncio-eventloop.rst:829 library/asyncio-eventloop.rst:907
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "Added the *ssl_shutdown_timeout* parameter."
msgstr "ajout du paramètre ``name``."
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:526
2018-10-13 15:54:03 +00:00
msgid ""
"The :func:`open_connection` function is a high-level alternative API. It "
"returns a pair of (:class:`StreamReader`, :class:`StreamWriter`) that can be "
"used directly in async/await code."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:536
2018-10-13 15:54:03 +00:00
msgid "Create a datagram connection."
2018-10-14 22:47:12 +00:00
msgstr "Créer une connexion par datagramme"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:538
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The socket family can be either :py:data:`~socket.AF_INET`, :py:data:"
"`~socket.AF_INET6`, or :py:data:`~socket.AF_UNIX`, depending on *host* (or "
"the *family* argument, if provided)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:542
2018-10-13 15:54:03 +00:00
msgid "The socket type will be :py:data:`~socket.SOCK_DGRAM`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:544 library/asyncio-eventloop.rst:664
#: library/asyncio-eventloop.rst:796
2016-10-30 09:46:26 +00:00
msgid ""
2018-06-28 13:32:56 +00:00
"*protocol_factory* must be a callable returning a :ref:`protocol <asyncio-"
2018-10-13 15:54:03 +00:00
"protocol>` implementation."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:547 library/asyncio-eventloop.rst:623
2018-10-13 15:54:03 +00:00
msgid "A tuple of ``(transport, protocol)`` is returned on success."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:551
2016-10-30 09:46:26 +00:00
msgid ""
"*local_addr*, if given, is a ``(local_host, local_port)`` tuple used to bind "
2021-06-04 11:47:25 +00:00
"the socket locally. The *local_host* and *local_port* are looked up using :"
"meth:`getaddrinfo`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:555
2016-10-30 09:46:26 +00:00
msgid ""
"*remote_addr*, if given, is a ``(remote_host, remote_port)`` tuple used to "
"connect the socket to a remote address. The *remote_host* and *remote_port* "
"are looked up using :meth:`getaddrinfo`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:559
2016-10-30 09:46:26 +00:00
msgid ""
"*family*, *proto*, *flags* are the optional address family, protocol and "
"flags to be passed through to :meth:`getaddrinfo` for *host* resolution. If "
"given, these should all be integers from the corresponding :mod:`socket` "
"module constants."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:564
2016-10-30 09:46:26 +00:00
msgid ""
"*reuse_port* tells the kernel to allow this endpoint to be bound to the same "
"port as other existing endpoints are bound to, so long as they all set this "
"flag when being created. This option is not supported on Windows and some "
2018-10-13 15:54:03 +00:00
"Unixes. If the :py:data:`~socket.SO_REUSEPORT` constant is not defined then "
2016-10-30 09:46:26 +00:00
"this capability is unsupported."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:570
2016-10-30 09:46:26 +00:00
msgid ""
"*allow_broadcast* tells the kernel to allow this endpoint to send messages "
"to the broadcast address."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:573
2016-10-30 09:46:26 +00:00
msgid ""
"*sock* can optionally be specified in order to use a preexisting, already "
"connected, :class:`socket.socket` object to be used by the transport. If "
"specified, *local_addr* and *remote_addr* should be omitted (must be :const:"
"`None`)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:584
2016-10-30 09:46:26 +00:00
msgid ""
"See :ref:`UDP echo client protocol <asyncio-udp-echo-client-protocol>` and :"
"ref:`UDP echo server protocol <asyncio-udp-echo-server-protocol>` examples."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:587
2018-06-10 09:32:30 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"The *family*, *proto*, *flags*, *reuse_address*, *reuse_port*, "
2018-06-10 09:32:30 +00:00
"*allow_broadcast*, and *sock* parameters were added."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:591
2020-02-04 10:14:03 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"The *reuse_address* parameter is no longer supported, as using :py:data:"
"`~sockets.SO_REUSEADDR` poses a significant security concern for UDP. "
"Explicitly passing ``reuse_address=True`` will raise an exception."
2020-02-04 10:14:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:596
2022-03-23 17:40:12 +00:00
msgid ""
"When multiple processes with differing UIDs assign sockets to an identical "
"UDP socket address with ``SO_REUSEADDR``, incoming packets can become "
"randomly distributed among the sockets."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:600
2022-03-23 17:40:12 +00:00
msgid ""
"For supported platforms, *reuse_port* can be used as a replacement for "
"similar functionality. With *reuse_port*, :py:data:`~sockets.SO_REUSEPORT` "
"is used instead, which specifically prevents processes with differing UIDs "
"from assigning sockets to the same socket address."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:606
2019-09-04 09:35:23 +00:00
msgid "Added support for Windows."
2019-09-16 10:08:42 +00:00
msgstr "Prise en charge sur Windows."
2019-09-04 09:35:23 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:609
2022-03-23 17:40:12 +00:00
msgid ""
"The *reuse_address* parameter, disabled since Python 3.9.0, 3.8.1, 3.7.6 and "
"3.6.10, has been entirely removed."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:618
2018-10-13 15:54:03 +00:00
msgid "Create a Unix connection."
2018-10-14 22:47:12 +00:00
msgstr "Créer une connexion Unix"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:620
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The socket family will be :py:data:`~socket.AF_UNIX`; socket type will be :"
"py:data:`~socket.SOCK_STREAM`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:625
2017-04-02 20:14:06 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*path* is the name of a Unix domain socket and is required, unless a *sock* "
"parameter is specified. Abstract Unix sockets, :class:`str`, :class:"
2018-06-28 13:32:56 +00:00
"`bytes`, and :class:`~pathlib.Path` paths are supported."
2017-04-02 20:14:06 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:630
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"See the documentation of the :meth:`loop.create_connection` method for "
"information about arguments to this method."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:633 library/asyncio-eventloop.rst:773
#: library/asyncio-eventloop.rst:1199
2018-11-29 15:13:39 +00:00
msgid ":ref:`Availability <availability>`: Unix."
msgstr ":ref:`Disponibilité <availability>` : Unix."
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:635
2022-03-23 17:40:12 +00:00
msgid ""
"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be "
"a :term:`path-like object`."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:645
2018-10-13 15:54:03 +00:00
msgid "Creating network servers"
msgstr "Créer des serveurs"
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:657
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Create a TCP server (socket type :data:`~socket.SOCK_STREAM`) listening on "
"*port* of the *host* address."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:660
2018-10-13 15:54:03 +00:00
msgid "Returns a :class:`Server` object."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:662
2020-02-14 10:18:53 +00:00
#, fuzzy
2018-10-13 15:54:03 +00:00
msgid "Arguments:"
msgstr "Arguments :"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:667
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The *host* parameter can be set to several types which determine where the "
"server would be listening:"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:670
2018-10-13 15:54:03 +00:00
msgid ""
"If *host* is a string, the TCP server is bound to a single network interface "
"specified by *host*."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:673
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"If *host* is a sequence of strings, the TCP server is bound to all network "
"interfaces specified by the sequence."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:676
2018-10-13 15:54:03 +00:00
msgid ""
"If *host* is an empty string or ``None``, all interfaces are assumed and a "
"list of multiple sockets will be returned (most likely one for IPv4 and "
"another one for IPv6)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:680
2016-10-30 09:46:26 +00:00
msgid ""
"The *port* parameter can be set to specify which port the server should "
"listen on. If ``0`` or ``None`` (the default), a random unused port will be "
"selected (note that if *host* resolves to multiple network interfaces, a "
"different random port will be selected for each interface)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:685
msgid ""
2016-10-30 09:46:26 +00:00
"*family* can be set to either :data:`socket.AF_INET` or :data:`~socket."
2018-10-13 15:54:03 +00:00
"AF_INET6` to force the socket to use IPv4 or IPv6. If not set, the *family* "
"will be determined from host name (defaults to :data:`~socket.AF_UNSPEC`)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:690
2016-10-30 09:46:26 +00:00
msgid "*flags* is a bitmask for :meth:`getaddrinfo`."
msgstr "*flags* est un masque de bits pour :meth:`getaddrinfo`."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:692
2016-10-30 09:46:26 +00:00
msgid ""
"*sock* can optionally be specified in order to use a preexisting socket "
2018-10-13 15:54:03 +00:00
"object. If specified, *host* and *port* must not be specified."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:697
msgid ""
"The *sock* argument transfers ownership of the socket to the server created. "
"To close the socket, call the server's :meth:`~asyncio.Server.close` method."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:701
2016-10-30 09:46:26 +00:00
msgid ""
"*backlog* is the maximum number of queued connections passed to :meth:"
"`~socket.socket.listen` (defaults to 100)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:704
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*ssl* can be set to an :class:`~ssl.SSLContext` instance to enable TLS over "
"the accepted connections."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:707
2020-02-04 10:14:03 +00:00
msgid ""
"*reuse_address* tells the kernel to reuse a local socket in ``TIME_WAIT`` "
"state, without waiting for its natural timeout to expire. If not specified "
"will automatically be set to ``True`` on Unix."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:712
2016-10-30 09:46:26 +00:00
msgid ""
"*reuse_port* tells the kernel to allow this endpoint to be bound to the same "
"port as other existing endpoints are bound to, so long as they all set this "
"flag when being created. This option is not supported on Windows."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:717
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*ssl_handshake_timeout* is (for a TLS server) the time in seconds to wait "
"for the TLS handshake to complete before aborting the connection. ``60.0`` "
2018-06-28 13:32:56 +00:00
"seconds if ``None`` (default)."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:725
2018-06-28 13:32:56 +00:00
msgid ""
"*start_serving* set to ``True`` (the default) causes the created server to "
"start accepting connections immediately. When set to ``False``, the user "
"should await on :meth:`Server.start_serving` or :meth:`Server.serve_forever` "
"to make the server to start accepting connections."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:737
2022-03-23 17:40:12 +00:00
msgid "The *host* parameter can be a sequence of strings."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:741
2022-03-23 17:40:12 +00:00
msgid ""
"Added *ssl_handshake_timeout* and *start_serving* parameters. The socket "
"option :py:data:`~socket.TCP_NODELAY` is set by default for all TCP "
"connections."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:751
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The :func:`start_server` function is a higher-level alternative API that "
"returns a pair of :class:`StreamReader` and :class:`StreamWriter` that can "
"be used in an async/await code."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:762
2018-10-13 15:54:03 +00:00
msgid ""
"Similar to :meth:`loop.create_server` but works with the :py:data:`~socket."
"AF_UNIX` socket family."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:765
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*path* is the name of a Unix domain socket, and is required, unless a *sock* "
"argument is provided. Abstract Unix sockets, :class:`str`, :class:`bytes`, "
"and :class:`~pathlib.Path` paths are supported."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:770
2018-10-13 15:54:03 +00:00
msgid ""
"See the documentation of the :meth:`loop.create_server` method for "
"information about arguments to this method."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:777
2022-03-23 17:40:12 +00:00
msgid ""
"Added the *ssl_handshake_timeout* and *start_serving* parameters. The *path* "
"parameter can now be a :class:`~pathlib.Path` object."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:789
2018-10-13 15:54:03 +00:00
msgid "Wrap an already accepted connection into a transport/protocol pair."
2017-04-02 20:14:06 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:791
2017-04-02 20:14:06 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This method can be used by servers that accept connections outside of "
"asyncio but that use asyncio to handle them."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:794 library/asyncio-eventloop.rst:881
2018-10-13 15:54:03 +00:00
msgid "Parameters:"
msgstr "Paramètres :"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:799
2018-10-13 15:54:03 +00:00
msgid ""
"*sock* is a preexisting socket object returned from :meth:`socket.accept "
"<socket.socket.accept>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:808
2018-10-13 15:54:03 +00:00
msgid ""
"*ssl* can be set to an :class:`~ssl.SSLContext` to enable SSL over the "
"accepted connections."
2017-04-02 20:14:06 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:811
2018-10-13 15:54:03 +00:00
msgid ""
"*ssl_handshake_timeout* is (for an SSL connection) the time in seconds to "
"wait for the SSL handshake to complete before aborting the connection. "
"``60.0`` seconds if ``None`` (default)."
2017-04-02 20:14:06 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:819
2018-10-13 15:54:03 +00:00
msgid "Returns a ``(transport, protocol)`` pair."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:833
2018-10-13 15:54:03 +00:00
msgid "Transferring files"
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:838
2017-04-02 20:14:06 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Send a *file* over a *transport*. Return the total number of bytes sent."
2017-04-02 20:14:06 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:841
2018-06-28 13:32:56 +00:00
msgid "The method uses high-performance :meth:`os.sendfile` if available."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:843
2018-06-28 13:32:56 +00:00
msgid "*file* must be a regular file object opened in binary mode."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:845 library/asyncio-eventloop.rst:1087
2018-06-28 13:32:56 +00:00
msgid ""
"*offset* tells from where to start reading the file. If specified, *count* "
"is the total number of bytes to transmit as opposed to sending the file "
2018-10-13 15:54:03 +00:00
"until EOF is reached. File position is always updated, even when this method "
"raises an error, and :meth:`file.tell() <io.IOBase.tell>` can be used to "
"obtain the actual number of bytes sent."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:852
2018-06-28 13:32:56 +00:00
msgid ""
"*fallback* set to ``True`` makes asyncio to manually read and send the file "
2018-10-13 15:54:03 +00:00
"when the platform does not support the sendfile system call (e.g. Windows or "
"SSL socket on Unix)."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:856
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Raise :exc:`SendfileNotAvailableError` if the system does not support the "
2018-06-28 13:32:56 +00:00
"*sendfile* syscall and *fallback* is ``False``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:863
2018-06-28 13:32:56 +00:00
msgid "TLS Upgrade"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:870
2018-10-13 15:54:03 +00:00
msgid "Upgrade an existing transport-based connection to TLS."
2018-07-05 09:39:28 +00:00
msgstr "Convertit une connexion existante en connexion TLS."
2018-06-28 13:32:56 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:872
2018-06-28 13:32:56 +00:00
msgid ""
"Create a TLS coder/decoder instance and insert it between the *transport* "
"and the *protocol*. The coder/decoder implements both *transport*-facing "
"protocol and *protocol*-facing transport."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:876
msgid ""
"Return the created two-interface instance. After *await*, the *protocol* "
"must stop using the original *transport* and communicate with the returned "
"object only because the coder caches *protocol*-side data and sporadically "
"exchanges extra TLS session packets with *transport*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:883
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*transport* and *protocol* instances that methods like :meth:`~loop."
"create_server` and :meth:`~loop.create_connection` return."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:887
2018-06-28 13:32:56 +00:00
msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:889
2018-06-28 13:32:56 +00:00
msgid ""
"*server_side* pass ``True`` when a server-side connection is being upgraded "
2018-10-13 15:54:03 +00:00
"(like the one created by :meth:`~loop.create_server`)."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:892
2018-06-28 13:32:56 +00:00
msgid ""
"*server_hostname*: sets or overrides the host name that the target server's "
"certificate will be matched against."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:912
2018-10-13 15:54:03 +00:00
msgid "Watching file descriptors"
2016-10-30 09:46:26 +00:00
msgstr "Surveiller des descripteurs de fichiers"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:916
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Start monitoring the *fd* file descriptor for read availability and invoke "
"*callback* with the specified arguments once *fd* is available for reading."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:922
msgid ""
"Stop monitoring the *fd* file descriptor for read availability. Returns "
"``True`` if *fd* was previously being monitored for reads."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:927
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Start monitoring the *fd* file descriptor for write availability and invoke "
"*callback* with the specified arguments once *fd* is available for writing."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:931 library/asyncio-eventloop.rst:1186
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Use :func:`functools.partial` :ref:`to pass keyword arguments <asyncio-pass-"
2018-12-24 13:20:55 +00:00
"keywords>` to *callback*."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:936
msgid ""
"Stop monitoring the *fd* file descriptor for write availability. Returns "
"``True`` if *fd* was previously being monitored for writes."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:939
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"See also :ref:`Platform Support <asyncio-platform-support>` section for some "
"limitations of these methods."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:944
2018-10-13 15:54:03 +00:00
msgid "Working with socket objects directly"
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:946
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"In general, protocol implementations that use transport-based APIs such as :"
"meth:`loop.create_connection` and :meth:`loop.create_server` are faster than "
"implementations that work with sockets directly. However, there are some use "
"cases when performance is not critical, and working with :class:`~socket."
"socket` objects directly is more convenient."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:955
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Receive up to *nbytes* from *sock*. Asynchronous version of :meth:`socket."
"recv() <socket.socket.recv>`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:958
2018-10-13 15:54:03 +00:00
msgid "Return the received data as a bytes object."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:960 library/asyncio-eventloop.rst:974
#: library/asyncio-eventloop.rst:985 library/asyncio-eventloop.rst:997
#: library/asyncio-eventloop.rst:1012 library/asyncio-eventloop.rst:1027
#: library/asyncio-eventloop.rst:1037 library/asyncio-eventloop.rst:1063
#: library/asyncio-eventloop.rst:1101
2018-10-13 15:54:03 +00:00
msgid "*sock* must be a non-blocking socket."
msgstr "Le connecteur *sock* ne doit pas être bloquant."
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:962
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Even though this method was always documented as a coroutine method, "
"releases before Python 3.7 returned a :class:`Future`. Since Python 3.7 this "
"is an ``async def`` method."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:969
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Receive data from *sock* into the *buf* buffer. Modeled after the blocking :"
"meth:`socket.recv_into() <socket.socket.recv_into>` method."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:972
2018-10-13 15:54:03 +00:00
msgid "Return the number of bytes written to the buffer."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:980
2022-03-23 17:40:12 +00:00
msgid ""
"Receive a datagram of up to *bufsize* from *sock*. Asynchronous version of :"
"meth:`socket.recvfrom() <socket.socket.recvfrom>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:983
2022-03-23 17:40:12 +00:00
msgid "Return a tuple of (received data, remote address)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:991
2022-03-23 17:40:12 +00:00
msgid ""
"Receive a datagram of up to *nbytes* from *sock* into *buf*. Asynchronous "
"version of :meth:`socket.recvfrom_into() <socket.socket.recvfrom_into>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:995
2022-03-23 17:40:12 +00:00
msgid "Return a tuple of (number of bytes received, remote address)."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1003
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Send *data* to the *sock* socket. Asynchronous version of :meth:`socket."
"sendall() <socket.socket.sendall>`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1006
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This method continues to send to the socket until either all data in *data* "
"has been sent or an error occurs. ``None`` is returned on success. On "
"error, an exception is raised. Additionally, there is no way to determine "
"how much data, if any, was successfully processed by the receiving end of "
"the connection."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1014 library/asyncio-eventloop.rst:1065
2018-06-28 13:32:56 +00:00
msgid ""
"Even though the method was always documented as a coroutine method, before "
2022-03-23 17:40:12 +00:00
"Python 3.7 it returned a :class:`Future`. Since Python 3.7, this is an "
2018-06-28 13:32:56 +00:00
"``async def`` method."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1021
2022-03-23 17:40:12 +00:00
msgid ""
"Send a datagram from *sock* to *address*. Asynchronous version of :meth:"
"`socket.sendto() <socket.socket.sendto>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1025
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "Return the number of bytes sent."
msgstr "Active le mode débogage pour la boucle d'évènements."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1033
2018-10-13 15:54:03 +00:00
msgid "Connect *sock* to a remote socket at *address*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1035
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Asynchronous version of :meth:`socket.connect() <socket.socket.connect>`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1039
2016-10-30 09:46:26 +00:00
msgid ""
"``address`` no longer needs to be resolved. ``sock_connect`` will try to "
"check if the *address* is already resolved by calling :func:`socket."
2018-10-13 15:54:03 +00:00
"inet_pton`. If not, :meth:`loop.getaddrinfo` will be used to resolve the "
"*address*."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1048
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
":meth:`loop.create_connection` and :func:`asyncio.open_connection() "
"<open_connection>`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1054
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Accept a connection. Modeled after the blocking :meth:`socket.accept() "
"<socket.socket.accept>` method."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1057
2016-10-30 09:46:26 +00:00
msgid ""
"The socket must be bound to an address and listening for connections. The "
"return value is a pair ``(conn, address)`` where *conn* is a *new* socket "
"object usable to send and receive data on the connection, and *address* is "
"the address bound to the socket on the other end of the connection."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1072
2018-10-13 15:54:03 +00:00
msgid ":meth:`loop.create_server` and :func:`start_server`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1077
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Send a file using high-performance :mod:`os.sendfile` if possible. Return "
"the total number of bytes sent."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1080
2018-10-13 15:54:03 +00:00
msgid ""
"Asynchronous version of :meth:`socket.sendfile() <socket.socket.sendfile>`."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1082
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*sock* must be a non-blocking :const:`socket.SOCK_STREAM` :class:`~socket."
"socket`."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1085
2018-10-13 15:54:03 +00:00
msgid "*file* must be a regular file object open in binary mode."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1094
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"*fallback*, when set to ``True``, makes asyncio manually read and send the "
"file when the platform does not support the sendfile syscall (e.g. Windows "
"or SSL socket on Unix)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1098
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Raise :exc:`SendfileNotAvailableError` if the system does not support "
"*sendfile* syscall and *fallback* is ``False``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1107
2018-10-13 15:54:03 +00:00
msgid "DNS"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1112
2018-10-13 15:54:03 +00:00
msgid "Asynchronous version of :meth:`socket.getaddrinfo`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1116
2018-10-13 15:54:03 +00:00
msgid "Asynchronous version of :meth:`socket.getnameinfo`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1118
2018-06-28 13:32:56 +00:00
msgid ""
"Both *getaddrinfo* and *getnameinfo* methods were always documented to "
"return a coroutine, but prior to Python 3.7 they were, in fact, returning :"
"class:`asyncio.Future` objects. Starting with Python 3.7 both methods are "
"coroutines."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1126
2018-10-13 15:54:03 +00:00
msgid "Working with pipes"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1130
2018-10-13 15:54:03 +00:00
msgid "Register the read end of *pipe* in the event loop."
2018-10-18 08:16:44 +00:00
msgstr ""
"Branche l'extrémité en lecture du tube *pipe* à la boucle d'évènements."
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1135
2018-10-13 15:54:03 +00:00
msgid "*pipe* is a :term:`file-like object <file object>`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1137
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Return pair ``(transport, protocol)``, where *transport* supports the :class:"
"`ReadTransport` interface and *protocol* is an object instantiated by the "
"*protocol_factory*."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1141 library/asyncio-eventloop.rst:1157
2016-10-30 09:46:26 +00:00
msgid ""
"With :class:`SelectorEventLoop` event loop, the *pipe* is set to non-"
"blocking mode."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1146
2018-10-13 15:54:03 +00:00
msgid "Register the write end of *pipe* in the event loop."
msgstr "Branche l'extrémité en écriture de *pipe* à la boucle d'évènements."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1151
2018-10-13 15:54:03 +00:00
msgid "*pipe* is :term:`file-like object <file object>`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1153
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Return pair ``(transport, protocol)``, where *transport* supports :class:"
"`WriteTransport` interface and *protocol* is an object instantiated by the "
"*protocol_factory*."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1162
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
":class:`SelectorEventLoop` does not support the above methods on Windows. "
"Use :class:`ProactorEventLoop` instead for Windows."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1167
2018-10-13 15:54:03 +00:00
msgid ""
"The :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell` methods."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1172
2018-10-13 15:54:03 +00:00
msgid "Unix signals"
msgstr "Signaux Unix"
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1176
2018-10-13 15:54:03 +00:00
msgid "Set *callback* as the handler for the *signum* signal."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1178
2016-10-30 09:46:26 +00:00
msgid ""
2018-12-24 13:20:55 +00:00
"The callback will be invoked by *loop*, along with other queued callbacks "
"and runnable coroutines of that event loop. Unlike signal handlers "
"registered using :func:`signal.signal`, a callback registered with this "
"function is allowed to interact with the event loop."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1183
2018-12-24 13:20:55 +00:00
msgid ""
2016-10-30 09:46:26 +00:00
"Raise :exc:`ValueError` if the signal number is invalid or uncatchable. "
"Raise :exc:`RuntimeError` if there is a problem setting up the handler."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1189
2018-12-24 13:20:55 +00:00
msgid ""
"Like :func:`signal.signal`, this function must be invoked in the main thread."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1194
2018-10-13 15:54:03 +00:00
msgid "Remove the handler for the *sig* signal."
2018-10-18 08:16:44 +00:00
msgstr "Supprime le gestionnaire du signal *sig*."
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1196
2018-10-13 15:54:03 +00:00
msgid ""
"Return ``True`` if the signal handler was removed, or ``False`` if no "
"handler was set for the given signal."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1203
2016-10-30 09:46:26 +00:00
msgid "The :mod:`signal` module."
msgstr "Le module :mod:`signal`."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1207
2018-10-13 15:54:03 +00:00
msgid "Executing code in thread or process pools"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1211
2018-10-13 15:54:03 +00:00
msgid "Arrange for *func* to be called in the specified executor."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1213
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The *executor* argument should be an :class:`concurrent.futures.Executor` "
2016-10-30 09:46:26 +00:00
"instance. The default executor is used if *executor* is ``None``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1258
msgid ""
"Note that the entry point guard (``if __name__ == '__main__'``) is required "
"for option 3 due to the peculiarities of :mod:`multiprocessing`, which is "
"used by :class:`~concurrent.futures.ProcessPoolExecutor`. See :ref:`Safe "
"importing of main module <multiprocessing-safe-main-import>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1263
2018-10-13 15:54:03 +00:00
msgid "This method returns a :class:`asyncio.Future` object."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1265
2018-12-24 13:20:55 +00:00
msgid ""
"Use :func:`functools.partial` :ref:`to pass keyword arguments <asyncio-pass-"
"keywords>` to *func*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1268
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
":meth:`loop.run_in_executor` no longer configures the ``max_workers`` of the "
"thread pool executor it creates, instead leaving it up to the thread pool "
"executor (:class:`~concurrent.futures.ThreadPoolExecutor`) to set the "
"default."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1277
2018-10-13 15:54:03 +00:00
msgid ""
"Set *executor* as the default executor used by :meth:`run_in_executor`. "
2022-03-23 17:40:12 +00:00
"*executor* must be an instance of :class:`~concurrent.futures."
2018-10-13 15:54:03 +00:00
"ThreadPoolExecutor`."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1281
2018-10-13 15:54:03 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"*executor* must be an instance of :class:`~concurrent.futures."
2018-10-13 15:54:03 +00:00
"ThreadPoolExecutor`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1287
2016-10-30 09:46:26 +00:00
msgid "Error Handling API"
msgstr "API de gestion d'erreur"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1289
2016-10-30 09:46:26 +00:00
msgid "Allows customizing how exceptions are handled in the event loop."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1293
2016-10-30 09:46:26 +00:00
msgid "Set *handler* as the new event loop exception handler."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1295
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"If *handler* is ``None``, the default exception handler will be set. "
"Otherwise, *handler* must be a callable with the signature matching ``(loop, "
"context)``, where ``loop`` is a reference to the active event loop, and "
"``context`` is a ``dict`` object containing the details of the exception "
"(see :meth:`call_exception_handler` documentation for details about context)."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1305
2018-10-13 15:54:03 +00:00
msgid ""
"Return the current exception handler, or ``None`` if no custom exception "
"handler was set."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1312
2016-10-30 09:46:26 +00:00
msgid "Default exception handler."
msgstr "Gestionnaire d'exception par défaut."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1314
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This is called when an exception occurs and no exception handler is set. "
"This can be called by a custom exception handler that wants to defer to the "
"default handler behavior."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1318
2016-10-30 09:46:26 +00:00
msgid ""
"*context* parameter has the same meaning as in :meth:"
"`call_exception_handler`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1323
2016-10-30 09:46:26 +00:00
msgid "Call the current event loop exception handler."
msgstr ""
"Appelle le gestionnaire d'exception de la boucle d'évènements actuelle."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1325
2016-10-30 09:46:26 +00:00
msgid ""
"*context* is a ``dict`` object containing the following keys (new keys may "
2018-10-13 15:54:03 +00:00
"be introduced in future Python versions):"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1328
2016-10-30 09:46:26 +00:00
msgid "'message': Error message;"
msgstr "``message`` : Message d'erreur ;"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1329
2016-10-30 09:46:26 +00:00
msgid "'exception' (optional): Exception object;"
msgstr "``exception`` (optionnel): Un objet exception ;"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1330
2016-10-30 09:46:26 +00:00
msgid "'future' (optional): :class:`asyncio.Future` instance;"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1331
msgid "'task' (optional): :class:`asyncio.Task` instance;"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1332
2016-10-30 09:46:26 +00:00
msgid "'handle' (optional): :class:`asyncio.Handle` instance;"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1333
2016-10-30 09:46:26 +00:00
msgid "'protocol' (optional): :ref:`Protocol <asyncio-protocol>` instance;"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1334
2016-10-30 09:46:26 +00:00
msgid "'transport' (optional): :ref:`Transport <asyncio-transport>` instance;"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1335
msgid "'socket' (optional): :class:`socket.socket` instance;"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1337
msgid "'asyncgen' (optional): Asynchronous generator that caused"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1337
#, fuzzy
msgid "the exception."
msgstr "Gestionnaire d'exception par défaut."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1341
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"This method should not be overloaded in subclassed event loops. For custom "
"exception handling, use the :meth:`set_exception_handler()` method."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1346
2018-10-13 15:54:03 +00:00
msgid "Enabling debug mode"
msgstr "Active le mode débogage"
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1350
2016-10-30 09:46:26 +00:00
msgid "Get the debug mode (:class:`bool`) of the event loop."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1352
2016-10-30 09:46:26 +00:00
msgid ""
"The default value is ``True`` if the environment variable :envvar:"
"`PYTHONASYNCIODEBUG` is set to a non-empty string, ``False`` otherwise."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1358
2016-10-30 09:46:26 +00:00
msgid "Set the debug mode of the event loop."
msgstr "Active le mode débogage pour la boucle d'évènements."
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1362
2018-10-13 15:54:03 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"The new :ref:`Python Development Mode <devmode>` can now also be used to "
"enable the debug mode."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1367
2016-10-30 09:46:26 +00:00
msgid "The :ref:`debug mode of asyncio <asyncio-debug-mode>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1371
2018-10-13 15:54:03 +00:00
msgid "Running Subprocesses"
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1373
2018-10-13 15:54:03 +00:00
msgid ""
"Methods described in this subsections are low-level. In regular async/await "
"code consider using the high-level :func:`asyncio.create_subprocess_shell` "
"and :func:`asyncio.create_subprocess_exec` convenience functions instead."
msgstr ""
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1380
2018-06-28 13:32:56 +00:00
msgid ""
2021-12-31 10:41:52 +00:00
"On Windows, the default event loop :class:`ProactorEventLoop` supports "
"subprocesses, whereas :class:`SelectorEventLoop` does not. See :ref:"
"`Subprocess Support on Windows <asyncio-windows-subprocess>` for details."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1389
2018-10-13 15:54:03 +00:00
msgid ""
"Create a subprocess from one or more string arguments specified by *args*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1392
2018-10-13 15:54:03 +00:00
msgid "*args* must be a list of strings represented by:"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1394
2020-02-14 10:18:53 +00:00
#, fuzzy
2018-10-13 15:54:03 +00:00
msgid ":class:`str`;"
2020-02-14 10:18:53 +00:00
msgstr ":class:`str`"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1395
2018-10-13 15:54:03 +00:00
msgid ""
"or :class:`bytes`, encoded to the :ref:`filesystem encoding <filesystem-"
"encoding>`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1398
2018-10-13 15:54:03 +00:00
msgid ""
"The first string specifies the program executable, and the remaining strings "
"specify the arguments. Together, string arguments form the ``argv`` of the "
"program."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1402
2018-10-13 15:54:03 +00:00
msgid ""
"This is similar to the standard library :class:`subprocess.Popen` class "
"called with ``shell=False`` and the list of strings passed as the first "
"argument; however, where :class:`~subprocess.Popen` takes a single argument "
"which is list of strings, *subprocess_exec* takes multiple string arguments."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1408
2018-10-13 15:54:03 +00:00
msgid ""
"The *protocol_factory* must be a callable returning a subclass of the :class:"
"`asyncio.SubprocessProtocol` class."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1411
2018-10-13 15:54:03 +00:00
msgid "Other parameters:"
msgstr "Autres paramètres :"
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1413
2019-09-04 09:35:23 +00:00
msgid "*stdin* can be any of these:"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1415
2018-10-13 15:54:03 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"a file-like object representing a pipe to be connected to the subprocess's "
"standard input stream using :meth:`~loop.connect_write_pipe`"
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1418 library/asyncio-eventloop.rst:1430
#: library/asyncio-eventloop.rst:1442
2018-10-13 15:54:03 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"the :const:`subprocess.PIPE` constant (default) which will create a new pipe "
"and connect it,"
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1420 library/asyncio-eventloop.rst:1432
#: library/asyncio-eventloop.rst:1444
2018-10-13 15:54:03 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"the value ``None`` which will make the subprocess inherit the file "
"descriptor from this process"
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1422 library/asyncio-eventloop.rst:1434
#: library/asyncio-eventloop.rst:1446
2018-10-13 15:54:03 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"the :const:`subprocess.DEVNULL` constant which indicates that the special :"
"data:`os.devnull` file will be used"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1425
2019-09-04 09:35:23 +00:00
msgid "*stdout* can be any of these:"
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1427
2019-09-04 09:35:23 +00:00
msgid ""
"a file-like object representing a pipe to be connected to the subprocess's "
"standard output stream using :meth:`~loop.connect_write_pipe`"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1437
2019-09-04 09:35:23 +00:00
msgid "*stderr* can be any of these:"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1439
2019-09-04 09:35:23 +00:00
msgid ""
"a file-like object representing a pipe to be connected to the subprocess's "
"standard error stream using :meth:`~loop.connect_write_pipe`"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1448
2019-09-04 09:35:23 +00:00
msgid ""
"the :const:`subprocess.STDOUT` constant which will connect the standard "
"error stream to the process' standard output stream"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1451
2018-10-13 15:54:03 +00:00
msgid ""
"All other keyword arguments are passed to :class:`subprocess.Popen` without "
2019-09-04 09:35:23 +00:00
"interpretation, except for *bufsize*, *universal_newlines*, *shell*, *text*, "
"*encoding* and *errors*, which should not be specified at all."
2018-10-13 15:54:03 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1456
2019-09-04 09:35:23 +00:00
msgid ""
"The ``asyncio`` subprocess API does not support decoding the streams as "
"text. :func:`bytes.decode` can be used to convert the bytes returned from "
"the stream to text."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1460
2018-10-13 15:54:03 +00:00
msgid ""
"See the constructor of the :class:`subprocess.Popen` class for documentation "
"on other arguments."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1463
2018-10-13 15:54:03 +00:00
msgid ""
"Returns a pair of ``(transport, protocol)``, where *transport* conforms to "
"the :class:`asyncio.SubprocessTransport` base class and *protocol* is an "
"object instantiated by the *protocol_factory*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1471
2018-10-13 15:54:03 +00:00
msgid ""
"Create a subprocess from *cmd*, which can be a :class:`str` or a :class:"
"`bytes` string encoded to the :ref:`filesystem encoding <filesystem-"
"encoding>`, using the platform's \"shell\" syntax."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1476
2018-10-13 15:54:03 +00:00
msgid ""
"This is similar to the standard library :class:`subprocess.Popen` class "
"called with ``shell=True``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1479
2018-10-13 15:54:03 +00:00
msgid ""
"The *protocol_factory* must be a callable returning a subclass of the :class:"
"`SubprocessProtocol` class."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1482
2018-10-13 15:54:03 +00:00
msgid ""
"See :meth:`~loop.subprocess_exec` for more details about the remaining "
"arguments."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1485
2018-10-13 15:54:03 +00:00
msgid ""
"Returns a pair of ``(transport, protocol)``, where *transport* conforms to "
"the :class:`SubprocessTransport` base class and *protocol* is an object "
"instantiated by the *protocol_factory*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1490
2018-10-13 15:54:03 +00:00
msgid ""
"It is the application's responsibility to ensure that all whitespace and "
"special characters are quoted appropriately to avoid `shell injection "
"<https://en.wikipedia.org/wiki/Shell_injection#Shell_injection>`_ "
"vulnerabilities. The :func:`shlex.quote` function can be used to properly "
"escape whitespace and special characters in strings that are going to be "
"used to construct shell commands."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1499
2018-10-13 15:54:03 +00:00
msgid "Callback Handles"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1503
2018-10-13 15:54:03 +00:00
msgid ""
"A callback wrapper object returned by :meth:`loop.call_soon`, :meth:`loop."
"call_soon_threadsafe`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1508
2018-10-13 15:54:03 +00:00
msgid ""
"Cancel the callback. If the callback has already been canceled or executed, "
"this method has no effect."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1513
2018-10-13 15:54:03 +00:00
msgid "Return ``True`` if the callback was cancelled."
msgstr "Renvoie ``True`` si la fonction de rappel à été annulé."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1519
2018-10-13 15:54:03 +00:00
msgid ""
"A callback wrapper object returned by :meth:`loop.call_later`, and :meth:"
"`loop.call_at`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1522
2018-10-13 15:54:03 +00:00
msgid "This class is a subclass of :class:`Handle`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1526
2018-10-13 15:54:03 +00:00
msgid "Return a scheduled callback time as :class:`float` seconds."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1528
2018-10-13 15:54:03 +00:00
msgid ""
"The time is an absolute timestamp, using the same time reference as :meth:"
"`loop.time`."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1535
2018-10-13 15:54:03 +00:00
msgid "Server Objects"
msgstr "Objets Serveur"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1537
2018-10-13 15:54:03 +00:00
msgid ""
"Server objects are created by :meth:`loop.create_server`, :meth:`loop."
"create_unix_server`, :func:`start_server`, and :func:`start_unix_server` "
"functions."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1541
2018-10-13 15:54:03 +00:00
msgid "Do not instantiate the class directly."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1545
2016-10-30 09:46:26 +00:00
msgid ""
2018-06-28 13:32:56 +00:00
"*Server* objects are asynchronous context managers. When used in an ``async "
"with`` statement, it's guaranteed that the Server object is closed and not "
"accepting new connections when the ``async with`` statement is completed::"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1558
2018-06-28 13:32:56 +00:00
msgid "Server object is an asynchronous context manager since Python 3.7."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1563
2016-10-30 09:46:26 +00:00
msgid ""
"Stop serving: close listening sockets and set the :attr:`sockets` attribute "
"to ``None``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1566
2016-10-30 09:46:26 +00:00
msgid ""
"The sockets that represent existing incoming client connections are left "
"open."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1569
2016-10-30 09:46:26 +00:00
msgid ""
"The server is closed asynchronously, use the :meth:`wait_closed` coroutine "
"to wait until the server is closed."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1574
2018-10-13 15:54:03 +00:00
msgid "Return the event loop associated with the server object."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1580
2018-06-28 13:32:56 +00:00
msgid "Start accepting connections."
2018-07-21 09:33:24 +00:00
msgstr "Commence à accepter les connexions."
2018-06-28 13:32:56 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1582
2018-06-28 13:32:56 +00:00
msgid ""
"This method is idempotent, so it can be called when the server is already "
2022-03-23 17:40:12 +00:00
"serving."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1585
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"The *start_serving* keyword-only parameter to :meth:`loop.create_server` "
"and :meth:`asyncio.start_server` allows creating a Server object that is not "
"accepting connections initially. In this case ``Server.start_serving()``, "
"or :meth:`Server.serve_forever` can be used to make the Server start "
"accepting connections."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1596
2018-06-28 13:32:56 +00:00
msgid ""
"Start accepting connections until the coroutine is cancelled. Cancellation "
"of ``serve_forever`` task causes the server to be closed."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1600
2018-06-28 13:32:56 +00:00
msgid ""
"This method can be called if the server is already accepting connections. "
"Only one ``serve_forever`` task can exist per one *Server* object."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1622
2018-06-28 13:32:56 +00:00
msgid "Return ``True`` if the server is accepting new connections."
2018-07-05 09:39:28 +00:00
msgstr "Donne ``True`` si le serveur accepte de nouvelles connexions."
2018-06-28 13:32:56 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1628
2016-10-30 09:46:26 +00:00
msgid "Wait until the :meth:`close` method completes."
msgstr "Attends que la méthode :meth:`close` se termine."
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1632
2019-09-04 09:35:23 +00:00
msgid "List of :class:`socket.socket` objects the server is listening on."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1634
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Prior to Python 3.7 ``Server.sockets`` used to return an internal list of "
"server sockets directly. In 3.7 a copy of that list is returned."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1644
2018-10-13 15:54:03 +00:00
msgid "Event Loop Implementations"
msgstr "Implémentations de boucle d'évènements"
2016-10-30 09:46:26 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1646
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"asyncio ships with two different event loop implementations: :class:"
"`SelectorEventLoop` and :class:`ProactorEventLoop`."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1649
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"By default asyncio is configured to use :class:`SelectorEventLoop` on Unix "
"and :class:`ProactorEventLoop` on Windows."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1655
2018-10-13 15:54:03 +00:00
msgid "An event loop based on the :mod:`selectors` module."
msgstr ""
2018-06-28 13:32:56 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1657
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Uses the most efficient *selector* available for the given platform. It is "
"also possible to manually configure the exact selector implementation to be "
"used::"
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1672
2018-11-29 15:13:39 +00:00
msgid ":ref:`Availability <availability>`: Unix, Windows."
msgstr ":ref:`Disponibilité <availability>` : Unix, Windows."
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1677
2018-10-13 15:54:03 +00:00
msgid "An event loop for Windows that uses \"I/O Completion Ports\" (IOCP)."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1679
2018-11-29 15:13:39 +00:00
msgid ":ref:`Availability <availability>`: Windows."
msgstr ":ref:`Disponibilité <availability>` : Windows."
2018-10-13 15:54:03 +00:00
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1683
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"`MSDN documentation on I/O Completion Ports <https://docs.microsoft.com/en-"
"ca/windows/desktop/FileIO/i-o-completion-ports>`_."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1689
2018-10-13 15:54:03 +00:00
msgid "Abstract base class for asyncio-compliant event loops."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1691
2018-10-13 15:54:03 +00:00
msgid ""
"The :ref:`asyncio-event-loop-methods` section lists all methods that an "
"alternative implementation of ``AbstractEventLoop`` should have defined."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1697
2018-10-13 15:54:03 +00:00
msgid "Examples"
msgstr "Exemples"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1699
2018-06-28 13:32:56 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Note that all examples in this section **purposefully** show how to use the "
"low-level event loop APIs, such as :meth:`loop.run_forever` and :meth:`loop."
"call_soon`. Modern asyncio applications rarely need to be written this way; "
"consider using the high-level functions like :func:`asyncio.run`."
2018-06-28 13:32:56 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1709
2016-10-30 09:46:26 +00:00
msgid "Hello World with call_soon()"
msgstr "\"Hello World\" avec ``call_soon()``"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1711
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"An example using the :meth:`loop.call_soon` method to schedule a callback. "
"The callback displays ``\"Hello World\"`` and then stops the event loop::"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1735
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"A similar :ref:`Hello World <coroutine>` example created with a coroutine "
"and the :func:`run` function."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1742
2016-10-30 09:46:26 +00:00
msgid "Display the current date with call_later()"
msgstr "Afficher la date actuelle avec ``call_later()``"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1744
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"An example of a callback displaying the current date every second. The "
"callback uses the :meth:`loop.call_later` method to reschedule itself after "
"5 seconds, and then stops the event loop::"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1772
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"A similar :ref:`current date <asyncio_example_sleep>` example created with a "
"coroutine and the :func:`run` function."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1779
2016-10-30 09:46:26 +00:00
msgid "Watch a file descriptor for read events"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1781
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Wait until a file descriptor received some data using the :meth:`loop."
"add_reader` method and then close the event loop::"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1819
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"A similar :ref:`example <asyncio_example_create_connection>` using "
"transports, protocols, and the :meth:`loop.create_connection` method."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1823
2016-10-30 09:46:26 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Another similar :ref:`example <asyncio_example_create_connection-streams>` "
2019-10-09 16:10:12 +00:00
"using the high-level :func:`asyncio.open_connection` function and streams."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1831
2016-10-30 09:46:26 +00:00
msgid "Set signal handlers for SIGINT and SIGTERM"
msgstr "Définit les gestionnaires de signaux pour *SIGINT* et *SIGTERM*"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1833
2018-10-13 15:54:03 +00:00
msgid "(This ``signals`` example only works on Unix.)"
msgstr "(Cet exemple ne fonctionne que sur Unix.)"
2023-04-14 11:20:40 +00:00
#: library/asyncio-eventloop.rst:1835
2016-10-30 09:46:26 +00:00
msgid ""
"Register handlers for signals :py:data:`SIGINT` and :py:data:`SIGTERM` using "
2018-10-13 15:54:03 +00:00
"the :meth:`loop.add_signal_handler` method::"
2016-10-30 09:46:26 +00:00
msgstr ""