forked from AFPy/python-docs-fr
3de5dcdad9
* make merge from cpython:25ce77dd2455abbb6e2c9e055bbc98954642fa7c * Fixed silly fuzzies for CI * More make merge from my PRs
464 lines
15 KiB
Plaintext
464 lines
15 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2019-11-15 18:54+0100\n"
|
|
"PO-Revision-Date: 2018-10-15 00:37+0200\n"
|
|
"Last-Translator: Julien Palard <julien@palard.fr>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
|
"Language: fr\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:7
|
|
msgid "Subprocesses"
|
|
msgstr "Sous-processus"
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:9
|
|
msgid ""
|
|
"**Source code:** :source:`Lib/asyncio/subprocess.py`, :source:`Lib/asyncio/"
|
|
"base_subprocess.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:14
|
|
msgid ""
|
|
"This section describes high-level async/await asyncio APIs to create and "
|
|
"manage subprocesses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:19
|
|
msgid ""
|
|
"Here's an example of how asyncio can run a shell command and obtain its "
|
|
"result::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:40
|
|
msgid "will print::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:46
|
|
msgid ""
|
|
"Because all asyncio subprocess functions are asynchronous and asyncio "
|
|
"provides many tools to work with such functions, it is easy to execute and "
|
|
"monitor multiple subprocesses in parallel. It is indeed trivial to modify "
|
|
"the above example to run several commands simultaneously::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:58
|
|
msgid "See also the `Examples`_ subsection."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:62
|
|
msgid "Creating Subprocesses"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:68
|
|
msgid "Create a subprocess."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:70
|
|
#: ../Doc/library/asyncio-subprocess.rst:89
|
|
msgid ""
|
|
"The *limit* argument sets the buffer limit for :class:`StreamReader` "
|
|
"wrappers for :attr:`Process.stdout` and :attr:`Process.stderr` (if :attr:"
|
|
"`subprocess.PIPE` is passed to *stdout* and *stderr* arguments)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:74
|
|
#: ../Doc/library/asyncio-subprocess.rst:93
|
|
msgid "Return a :class:`~asyncio.subprocess.Process` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:76
|
|
msgid ""
|
|
"See the documentation of :meth:`loop.subprocess_exec` for other parameters."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:81
|
|
#: ../Doc/library/asyncio-subprocess.rst:109
|
|
#, fuzzy
|
|
msgid "The *loop* parameter."
|
|
msgstr "Autres paramètres :"
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:87
|
|
msgid "Run the *cmd* shell command."
|
|
msgstr "Exécute la commande *cmd* dans un *shell*."
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:95
|
|
msgid ""
|
|
"See the documentation of :meth:`loop.subprocess_shell` for other parameters."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:100
|
|
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 shell characters in strings that are going to "
|
|
"be used to construct shell commands."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:113
|
|
msgid ""
|
|
"The default asyncio event loop implementation on **Windows** does not "
|
|
"support subprocesses. Subprocesses are available for Windows if a :class:"
|
|
"`ProactorEventLoop` is used. See :ref:`Subprocess Support on Windows "
|
|
"<asyncio-windows-subprocess>` for details."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:121
|
|
msgid ""
|
|
"asyncio also has the following *low-level* APIs to work with subprocesses: :"
|
|
"meth:`loop.subprocess_exec`, :meth:`loop.subprocess_shell`, :meth:`loop."
|
|
"connect_read_pipe`, :meth:`loop.connect_write_pipe`, as well as the :ref:"
|
|
"`Subprocess Transports <asyncio-subprocess-transports>` and :ref:`Subprocess "
|
|
"Protocols <asyncio-subprocess-protocols>`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:129
|
|
msgid "Constants"
|
|
msgstr "Constantes"
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:133
|
|
msgid "Can be passed to the *stdin*, *stdout* or *stderr* parameters."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:135
|
|
msgid ""
|
|
"If *PIPE* is passed to *stdin* argument, the :attr:`Process.stdin <asyncio."
|
|
"subprocess.Process.stdin>` attribute will point to a :class:`StreamWriter` "
|
|
"instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:139
|
|
msgid ""
|
|
"If *PIPE* is passed to *stdout* or *stderr* arguments, the :attr:`Process."
|
|
"stdout <asyncio.subprocess.Process.stdout>` and :attr:`Process.stderr "
|
|
"<asyncio.subprocess.Process.stderr>` attributes will point to :class:"
|
|
"`StreamReader` instances."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:146
|
|
msgid ""
|
|
"Special value that can be used as the *stderr* argument and indicates that "
|
|
"standard error should be redirected into standard output."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:151
|
|
msgid ""
|
|
"Special value that can be used as the *stdin*, *stdout* or *stderr* argument "
|
|
"to process creation functions. It indicates that the special file :data:`os."
|
|
"devnull` will be used for the corresponding subprocess stream."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:157
|
|
msgid "Interacting with Subprocesses"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:159
|
|
msgid ""
|
|
"Both :func:`create_subprocess_exec` and :func:`create_subprocess_shell` "
|
|
"functions return instances of the *Process* class. *Process* is a high-"
|
|
"level wrapper that allows communicating with subprocesses and watching for "
|
|
"their completion."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:166
|
|
msgid ""
|
|
"An object that wraps OS processes created by the :func:"
|
|
"`create_subprocess_exec` and :func:`create_subprocess_shell` functions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:170
|
|
msgid ""
|
|
"This class is designed to have a similar API to the :class:`subprocess."
|
|
"Popen` class, but there are some notable differences:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:174
|
|
msgid ""
|
|
"unlike Popen, Process instances do not have an equivalent to the :meth:"
|
|
"`~subprocess.Popen.poll` method;"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:177
|
|
msgid ""
|
|
"the :meth:`~asyncio.subprocess.Process.communicate` and :meth:`~asyncio."
|
|
"subprocess.Process.wait` methods don't have a *timeout* parameter: use the :"
|
|
"func:`wait_for` function;"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:181
|
|
msgid ""
|
|
"the :meth:`Process.wait() <asyncio.subprocess.Process.wait>` method is "
|
|
"asynchronous, whereas :meth:`subprocess.Popen.wait` method is implemented as "
|
|
"a blocking busy loop;"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:185
|
|
msgid "the *universal_newlines* parameter is not supported."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:187
|
|
msgid "This class is :ref:`not thread safe <asyncio-multithreading>`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:189
|
|
msgid ""
|
|
"See also the :ref:`Subprocess and Threads <asyncio-subprocess-threads>` "
|
|
"section."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:194
|
|
msgid "Wait for the child process to terminate."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:196
|
|
msgid "Set and return the :attr:`returncode` attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:200
|
|
msgid ""
|
|
"This method can deadlock when using ``stdout=PIPE`` or ``stderr=PIPE`` and "
|
|
"the child process generates so much output that it blocks waiting for the OS "
|
|
"pipe buffer to accept more data. Use the :meth:`communicate` method when "
|
|
"using pipes to avoid this condition."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:208
|
|
msgid "Interact with process:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:210
|
|
msgid "send data to *stdin* (if *input* is not ``None``);"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:211
|
|
msgid "read data from *stdout* and *stderr*, until EOF is reached;"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:212
|
|
msgid "wait for process to terminate."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:214
|
|
msgid ""
|
|
"The optional *input* argument is the data (:class:`bytes` object) that will "
|
|
"be sent to the child process."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:217
|
|
msgid "Return a tuple ``(stdout_data, stderr_data)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:219
|
|
msgid ""
|
|
"If either :exc:`BrokenPipeError` or :exc:`ConnectionResetError` exception is "
|
|
"raised when writing *input* into *stdin*, the exception is ignored. This "
|
|
"condition occurs when the process exits before all data are written into "
|
|
"*stdin*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:224
|
|
msgid ""
|
|
"If it is desired to send data to the process' *stdin*, the process needs to "
|
|
"be created with ``stdin=PIPE``. Similarly, to get anything other than "
|
|
"``None`` in the result tuple, the process has to be created with "
|
|
"``stdout=PIPE`` and/or ``stderr=PIPE`` arguments."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:230
|
|
msgid ""
|
|
"Note, that the data read is buffered in memory, so do not use this method if "
|
|
"the data size is large or unlimited."
|
|
msgstr ""
|
|
"Notez que les données lues sont mises en cache en mémoire, donc n'utilisez "
|
|
"pas cette méthode si la taille des données est importante voire illimitée."
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:235
|
|
msgid "Sends the signal *signal* to the child process."
|
|
msgstr "Envoie le signal *signal* au sous-processus."
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:239
|
|
msgid ""
|
|
"On Windows, :py:data:`SIGTERM` is an alias for :meth:`terminate`. "
|
|
"``CTRL_C_EVENT`` and ``CTRL_BREAK_EVENT`` can be sent to processes started "
|
|
"with a *creationflags* parameter which includes ``CREATE_NEW_PROCESS_GROUP``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:246
|
|
msgid "Stop the child process."
|
|
msgstr "Arrête le sous-processus."
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:248
|
|
msgid ""
|
|
"On POSIX systems this method sends :py:data:`signal.SIGTERM` to the child "
|
|
"process."
|
|
msgstr ""
|
|
"Sur les systèmes POSIX, cette méthode envoie un :py:data:`signal.SIGTERM` au "
|
|
"sous-processus."
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:251
|
|
msgid ""
|
|
"On Windows the Win32 API function :c:func:`TerminateProcess` is called to "
|
|
"stop the child process."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:256
|
|
msgid "Kill the child."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:258
|
|
msgid ""
|
|
"On POSIX systems this method sends :py:data:`SIGKILL` to the child process."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:261
|
|
msgid "On Windows this method is an alias for :meth:`terminate`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:265
|
|
msgid ""
|
|
"Standard input stream (:class:`StreamWriter`) or ``None`` if the process was "
|
|
"created with ``stdin=None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:270
|
|
msgid ""
|
|
"Standard output stream (:class:`StreamReader`) or ``None`` if the process "
|
|
"was created with ``stdout=None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:275
|
|
msgid ""
|
|
"Standard error stream (:class:`StreamReader`) or ``None`` if the process was "
|
|
"created with ``stderr=None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:280
|
|
msgid ""
|
|
"Use the :meth:`communicate` method rather than :attr:`process.stdin.write() "
|
|
"<stdin>`, :attr:`await process.stdout.read() <stdout>` or :attr:`await "
|
|
"process.stderr.read <stderr>`. This avoids deadlocks due to streams pausing "
|
|
"reading or writing and blocking the child process."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:289
|
|
msgid "Process identification number (PID)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:291
|
|
msgid ""
|
|
"Note that for processes created by the :func:`create_subprocess_shell` "
|
|
"function, this attribute is the PID of the spawned shell."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:296
|
|
msgid "Return code of the process when it exits."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:298
|
|
msgid "A ``None`` value indicates that the process has not terminated yet."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:300
|
|
msgid ""
|
|
"A negative value ``-N`` indicates that the child was terminated by signal "
|
|
"``N`` (POSIX only)."
|
|
msgstr ""
|
|
"Une valeur négative ``-N`` indique que le sous-processus a été terminé par "
|
|
"un signal ``N`` (seulement sur les systèmes *POSIX*)."
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:307
|
|
msgid "Subprocess and Threads"
|
|
msgstr "Sous-processus et fils d'exécution"
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:309
|
|
msgid ""
|
|
"Standard asyncio event loop supports running subprocesses from different "
|
|
"threads by default."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:312
|
|
msgid ""
|
|
"On Windows subprocesses are provided by :class:`ProactorEventLoop` only "
|
|
"(default), :class:`SelectorEventLoop` has no subprocess support."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:315
|
|
msgid ""
|
|
"On UNIX *child watchers* are used for subprocess finish waiting, see :ref:"
|
|
"`asyncio-watchers` for more info."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:321
|
|
msgid ""
|
|
"UNIX switched to use :class:`ThreadedChildWatcher` for spawning subprocesses "
|
|
"from different threads without any limitation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:324
|
|
msgid ""
|
|
"Spawning a subprocess with *inactive* current child watcher raises :exc:"
|
|
"`RuntimeError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:327
|
|
msgid ""
|
|
"Note that alternative event loop implementations might have own limitations; "
|
|
"please refer to their documentation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:332
|
|
msgid ""
|
|
"The :ref:`Concurrency and multithreading in asyncio <asyncio-"
|
|
"multithreading>` section."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:337
|
|
msgid "Examples"
|
|
msgstr "Exemples"
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:339
|
|
msgid ""
|
|
"An example using the :class:`~asyncio.subprocess.Process` class to control a "
|
|
"subprocess and the :class:`StreamReader` class to read from its standard "
|
|
"output."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:345
|
|
msgid ""
|
|
"The subprocess is created by the :func:`create_subprocess_exec` function::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/asyncio-subprocess.rst:372
|
|
msgid ""
|
|
"See also the :ref:`same example <asyncio_example_subprocess_proto>` written "
|
|
"using low-level APIs."
|
|
msgstr ""
|
|
|
|
#~ msgid "An event loop must run in the main thread."
|
|
#~ msgstr ""
|
|
#~ "Une boucle d'évènements doit être exécutée sur le fil d'exécution "
|
|
#~ "principal."
|
|
|
|
#~ msgid "Windows event loop"
|
|
#~ msgstr "Boucle d'évènements Windows"
|
|
|
|
#~ msgid "Create a subprocess: high-level API using Process"
|
|
#~ msgstr "Créer un processus fils : API de haut niveau utilisant ``Process``"
|
|
|
|
#~ msgid "This function is a :ref:`coroutine <coroutine>`."
|
|
#~ msgstr "Cette fonction est une :ref:`coroutine <coroutine>`."
|
|
|
|
#~ msgid "This method is a :ref:`coroutine <coroutine>`."
|
|
#~ msgstr "Cette méthode est une :ref:`coroutine <coroutine>`."
|
|
|
|
#~ msgid "The identifier of the process."
|
|
#~ msgstr "L'identifiant du processus."
|