# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:40+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/subprocess.rst:2 msgid ":mod:`subprocess` --- Subprocess management" msgstr "" #: ../Doc/library/subprocess.rst:10 msgid "**Source code:** :source:`Lib/subprocess.py`" msgstr "" #: ../Doc/library/subprocess.rst:14 msgid "" "The :mod:`subprocess` module allows you to spawn new processes, connect to " "their input/output/error pipes, and obtain their return codes. This module " "intends to replace several older modules and functions::" msgstr "" #: ../Doc/library/subprocess.rst:21 msgid "" "Information about how the :mod:`subprocess` module can be used to replace " "these modules and functions can be found in the following sections." msgstr "" #: ../Doc/library/subprocess.rst:26 msgid ":pep:`324` -- PEP proposing the subprocess module" msgstr "" #: ../Doc/library/subprocess.rst:30 msgid "Using the :mod:`subprocess` Module" msgstr "" #: ../Doc/library/subprocess.rst:32 msgid "" "The recommended approach to invoking subprocesses is to use the :func:`run` " "function for all use cases it can handle. For more advanced use cases, the " "underlying :class:`Popen` interface can be used directly." msgstr "" #: ../Doc/library/subprocess.rst:36 msgid "" "The :func:`run` function was added in Python 3.5; if you need to retain " "compatibility with older versions, see the :ref:`call-function-trio` section." msgstr "" #: ../Doc/library/subprocess.rst:44 msgid "" "Run the command described by *args*. Wait for command to complete, then " "return a :class:`CompletedProcess` instance." msgstr "" #: ../Doc/library/subprocess.rst:47 msgid "" "The arguments shown above are merely the most common ones, described below " "in :ref:`frequently-used-arguments` (hence the use of keyword-only notation " "in the abbreviated signature). The full function signature is largely the " "same as that of the :class:`Popen` constructor - apart from *timeout*, " "*input* and *check*, all the arguments to this function are passed through " "to that interface." msgstr "" #: ../Doc/library/subprocess.rst:54 msgid "" "This does not capture stdout or stderr by default. To do so, pass :data:" "`PIPE` for the *stdout* and/or *stderr* arguments." msgstr "" #: ../Doc/library/subprocess.rst:57 msgid "" "The *timeout* argument is passed to :meth:`Popen.communicate`. If the " "timeout expires, the child process will be killed and waited for. The :exc:" "`TimeoutExpired` exception will be re-raised after the child process has " "terminated." msgstr "" #: ../Doc/library/subprocess.rst:62 msgid "" "The *input* argument is passed to :meth:`Popen.communicate` and thus to the " "subprocess's stdin. If used it must be a byte sequence, or a string if " "*encoding* or *errors* is specified or *universal_newlines* is true. When " "used, the internal :class:`Popen` object is automatically created with " "``stdin=PIPE``, and the *stdin* argument may not be used as well." msgstr "" #: ../Doc/library/subprocess.rst:68 msgid "" "If *check* is true, and the process exits with a non-zero exit code, a :exc:" "`CalledProcessError` exception will be raised. Attributes of that exception " "hold the arguments, the exit code, and stdout and stderr if they were " "captured." msgstr "" #: ../Doc/library/subprocess.rst:73 msgid "" "If *encoding* or *errors* are specified, or *universal_newlines* is true, " "file objects for stdin, stdout and stderr are opened in text mode using the " "specified *encoding* and *errors* or the :class:`io.TextIOWrapper` default. " "Otherwise, file objects are opened in binary mode." msgstr "" #: ../Doc/library/subprocess.rst:78 msgid "Examples::" msgstr "Exemples : ::" #: ../Doc/library/subprocess.rst:96 msgid "Added *encoding* and *errors* parameters" msgstr "" #: ../Doc/library/subprocess.rst:100 msgid "" "The return value from :func:`run`, representing a process that has finished." msgstr "" #: ../Doc/library/subprocess.rst:104 msgid "" "The arguments used to launch the process. This may be a list or a string." msgstr "" #: ../Doc/library/subprocess.rst:108 msgid "" "Exit status of the child process. Typically, an exit status of 0 indicates " "that it ran successfully." msgstr "" #: ../Doc/library/subprocess.rst:111 ../Doc/library/subprocess.rst:741 msgid "" "A negative value ``-N`` indicates that the child was terminated by signal " "``N`` (POSIX only)." msgstr "" #: ../Doc/library/subprocess.rst:116 msgid "" "Captured stdout from the child process. A bytes sequence, or a string if :" "func:`run` was called with an encoding or errors. ``None`` if stdout was not " "captured." msgstr "" #: ../Doc/library/subprocess.rst:120 msgid "" "If you ran the process with ``stderr=subprocess.STDOUT``, stdout and stderr " "will be combined in this attribute, and :attr:`stderr` will be ``None``." msgstr "" #: ../Doc/library/subprocess.rst:126 msgid "" "Captured stderr from the child process. A bytes sequence, or a string if :" "func:`run` was called with an encoding or errors. ``None`` if stderr was not " "captured." msgstr "" #: ../Doc/library/subprocess.rst:132 msgid "If :attr:`returncode` is non-zero, raise a :exc:`CalledProcessError`." msgstr "" #: ../Doc/library/subprocess.rst:138 msgid "" "Special value that can be used as the *stdin*, *stdout* or *stderr* argument " "to :class:`Popen` and indicates that the special file :data:`os.devnull` " "will be used." msgstr "" #: ../Doc/library/subprocess.rst:147 msgid "" "Special value that can be used as the *stdin*, *stdout* or *stderr* argument " "to :class:`Popen` and indicates that a pipe to the standard stream should be " "opened. Most useful with :meth:`Popen.communicate`." msgstr "" #: ../Doc/library/subprocess.rst:154 msgid "" "Special value that can be used as the *stderr* argument to :class:`Popen` " "and indicates that standard error should go into the same handle as standard " "output." msgstr "" #: ../Doc/library/subprocess.rst:161 msgid "Base class for all other exceptions from this module." msgstr "" #: ../Doc/library/subprocess.rst:168 msgid "" "Subclass of :exc:`SubprocessError`, raised when a timeout expires while " "waiting for a child process." msgstr "" #: ../Doc/library/subprocess.rst:173 ../Doc/library/subprocess.rst:210 msgid "Command that was used to spawn the child process." msgstr "" #: ../Doc/library/subprocess.rst:177 msgid "Timeout in seconds." msgstr "" #: ../Doc/library/subprocess.rst:181 ../Doc/library/subprocess.rst:214 msgid "" "Output of the child process if it was captured by :func:`run` or :func:" "`check_output`. Otherwise, ``None``." msgstr "" #: ../Doc/library/subprocess.rst:186 ../Doc/library/subprocess.rst:219 msgid "Alias for output, for symmetry with :attr:`stderr`." msgstr "" #: ../Doc/library/subprocess.rst:190 ../Doc/library/subprocess.rst:223 msgid "" "Stderr output of the child process if it was captured by :func:`run`. " "Otherwise, ``None``." msgstr "" #: ../Doc/library/subprocess.rst:195 ../Doc/library/subprocess.rst:226 msgid "*stdout* and *stderr* attributes added" msgstr "" #: ../Doc/library/subprocess.rst:200 msgid "" "Subclass of :exc:`SubprocessError`, raised when a process run by :func:" "`check_call` or :func:`check_output` returns a non-zero exit status." msgstr "" #: ../Doc/library/subprocess.rst:205 msgid "" "Exit status of the child process. If the process exited due to a signal, " "this will be the negative signal number." msgstr "" #: ../Doc/library/subprocess.rst:233 msgid "Frequently Used Arguments" msgstr "" #: ../Doc/library/subprocess.rst:235 msgid "" "To support a wide variety of use cases, the :class:`Popen` constructor (and " "the convenience functions) accept a large number of optional arguments. For " "most typical use cases, many of these arguments can be safely left at their " "default values. The arguments that are most commonly needed are:" msgstr "" #: ../Doc/library/subprocess.rst:240 msgid "" "*args* is required for all calls and should be a string, or a sequence of " "program arguments. Providing a sequence of arguments is generally preferred, " "as it allows the module to take care of any required escaping and quoting of " "arguments (e.g. to permit spaces in file names). If passing a single string, " "either *shell* must be :const:`True` (see below) or else the string must " "simply name the program to be executed without specifying any arguments." msgstr "" #: ../Doc/library/subprocess.rst:248 msgid "" "*stdin*, *stdout* and *stderr* specify the executed program's standard " "input, standard output and standard error file handles, respectively. Valid " "values are :data:`PIPE`, :data:`DEVNULL`, an existing file descriptor (a " "positive integer), an existing file object, and ``None``. :data:`PIPE` " "indicates that a new pipe to the child should be created. :data:`DEVNULL` " "indicates that the special file :data:`os.devnull` will be used. With the " "default settings of ``None``, no redirection will occur; the child's file " "handles will be inherited from the parent. Additionally, *stderr* can be :" "data:`STDOUT`, which indicates that the stderr data from the child process " "should be captured into the same file handle as for *stdout*." msgstr "" #: ../Doc/library/subprocess.rst:262 msgid "" "If *encoding* or *errors* are specified, or *universal_newlines* is true, " "the file objects *stdin*, *stdout* and *stderr* will be opened in text mode " "using the *encoding* and *errors* specified in the call or the defaults for :" "class:`io.TextIOWrapper`." msgstr "" #: ../Doc/library/subprocess.rst:267 msgid "" "For *stdin*, line ending characters ``'\\n'`` in the input will be converted " "to the default line separator :data:`os.linesep`. For *stdout* and *stderr*, " "all line endings in the output will be converted to ``'\\n'``. For more " "information see the documentation of the :class:`io.TextIOWrapper` class " "when the *newline* argument to its constructor is ``None``." msgstr "" #: ../Doc/library/subprocess.rst:273 msgid "" "If text mode is not used, *stdin*, *stdout* and *stderr* will be opened as " "binary streams. No encoding or line ending conversion is performed." msgstr "" #: ../Doc/library/subprocess.rst:276 msgid "Added *encoding* and *errors* parameters." msgstr "" #: ../Doc/library/subprocess.rst:281 msgid "" "The newlines attribute of the file objects :attr:`Popen.stdin`, :attr:`Popen." "stdout` and :attr:`Popen.stderr` are not updated by the :meth:`Popen." "communicate` method." msgstr "" #: ../Doc/library/subprocess.rst:285 msgid "" "If *shell* is ``True``, the specified command will be executed through the " "shell. This can be useful if you are using Python primarily for the " "enhanced control flow it offers over most system shells and still want " "convenient access to other shell features such as shell pipes, filename " "wildcards, environment variable expansion, and expansion of ``~`` to a " "user's home directory. However, note that Python itself offers " "implementations of many shell-like features (in particular, :mod:`glob`, :" "mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`, :func:`os.path." "expanduser`, and :mod:`shutil`)." msgstr "" #: ../Doc/library/subprocess.rst:295 msgid "" "When *universal_newlines* is ``True``, the class uses the encoding :func:" "`locale.getpreferredencoding(False) ` instead " "of ``locale.getpreferredencoding()``. See the :class:`io.TextIOWrapper` " "class for more information on this change." msgstr "" #: ../Doc/library/subprocess.rst:303 ../Doc/library/subprocess.rst:387 msgid "" "Read the `Security Considerations`_ section before using ``shell=True``." msgstr "" #: ../Doc/library/subprocess.rst:305 msgid "" "These options, along with all of the other options, are described in more " "detail in the :class:`Popen` constructor documentation." msgstr "" #: ../Doc/library/subprocess.rst:310 msgid "Popen Constructor" msgstr "" #: ../Doc/library/subprocess.rst:312 msgid "" "The underlying process creation and management in this module is handled by " "the :class:`Popen` class. It offers a lot of flexibility so that developers " "are able to handle the less common cases not covered by the convenience " "functions." msgstr "" #: ../Doc/library/subprocess.rst:325 msgid "" "Execute a child program in a new process. On POSIX, the class uses :meth:" "`os.execvp`-like behavior to execute the child program. On Windows, the " "class uses the Windows ``CreateProcess()`` function. The arguments to :" "class:`Popen` are as follows." msgstr "" #: ../Doc/library/subprocess.rst:330 msgid "" "*args* should be a sequence of program arguments or else a single string. By " "default, the program to execute is the first item in *args* if *args* is a " "sequence. If *args* is a string, the interpretation is platform-dependent " "and described below. See the *shell* and *executable* arguments for " "additional differences from the default behavior. Unless otherwise stated, " "it is recommended to pass *args* as a sequence." msgstr "" #: ../Doc/library/subprocess.rst:337 msgid "" "On POSIX, if *args* is a string, the string is interpreted as the name or " "path of the program to execute. However, this can only be done if not " "passing arguments to the program." msgstr "" #: ../Doc/library/subprocess.rst:343 msgid "" ":meth:`shlex.split` can be useful when determining the correct tokenization " "for *args*, especially in complex cases::" msgstr "" #: ../Doc/library/subprocess.rst:354 msgid "" "Note in particular that options (such as *-input*) and arguments (such as " "*eggs.txt*) that are separated by whitespace in the shell go in separate " "list elements, while arguments that need quoting or backslash escaping when " "used in the shell (such as filenames containing spaces or the *echo* command " "shown above) are single list elements." msgstr "" #: ../Doc/library/subprocess.rst:360 msgid "" "On Windows, if *args* is a sequence, it will be converted to a string in a " "manner described in :ref:`converting-argument-sequence`. This is because " "the underlying ``CreateProcess()`` operates on strings." msgstr "" #: ../Doc/library/subprocess.rst:364 msgid "" "The *shell* argument (which defaults to ``False``) specifies whether to use " "the shell as the program to execute. If *shell* is ``True``, it is " "recommended to pass *args* as a string rather than as a sequence." msgstr "" #: ../Doc/library/subprocess.rst:368 msgid "" "On POSIX with ``shell=True``, the shell defaults to :file:`/bin/sh`. If " "*args* is a string, the string specifies the command to execute through the " "shell. This means that the string must be formatted exactly as it would be " "when typed at the shell prompt. This includes, for example, quoting or " "backslash escaping filenames with spaces in them. If *args* is a sequence, " "the first item specifies the command string, and any additional items will " "be treated as additional arguments to the shell itself. That is to say, :" "class:`Popen` does the equivalent of::" msgstr "" #: ../Doc/library/subprocess.rst:379 msgid "" "On Windows with ``shell=True``, the :envvar:`COMSPEC` environment variable " "specifies the default shell. The only time you need to specify " "``shell=True`` on Windows is when the command you wish to execute is built " "into the shell (e.g. :command:`dir` or :command:`copy`). You do not need " "``shell=True`` to run a batch file or console-based executable." msgstr "" #: ../Doc/library/subprocess.rst:389 msgid "" "*bufsize* will be supplied as the corresponding argument to the :func:`open` " "function when creating the stdin/stdout/stderr pipe file objects:" msgstr "" #: ../Doc/library/subprocess.rst:393 msgid "" ":const:`0` means unbuffered (read and write are one system call and can " "return short)" msgstr "" #: ../Doc/library/subprocess.rst:395 msgid "" ":const:`1` means line buffered (only usable if ``universal_newlines=True`` i." "e., in a text mode)" msgstr "" #: ../Doc/library/subprocess.rst:397 msgid "any other positive value means use a buffer of approximately that size" msgstr "" #: ../Doc/library/subprocess.rst:399 msgid "" "negative bufsize (the default) means the system default of io." "DEFAULT_BUFFER_SIZE will be used." msgstr "" #: ../Doc/library/subprocess.rst:402 msgid "" "*bufsize* now defaults to -1 to enable buffering by default to match the " "behavior that most code expects. In versions prior to Python 3.2.4 and " "3.3.1 it incorrectly defaulted to :const:`0` which was unbuffered and " "allowed short reads. This was unintentional and did not match the behavior " "of Python 2 as most code expected." msgstr "" #: ../Doc/library/subprocess.rst:409 msgid "" "The *executable* argument specifies a replacement program to execute. It " "is very seldom needed. When ``shell=False``, *executable* replaces the " "program to execute specified by *args*. However, the original *args* is " "still passed to the program. Most programs treat the program specified by " "*args* as the command name, which can then be different from the program " "actually executed. On POSIX, the *args* name becomes the display name for " "the executable in utilities such as :program:`ps`. If ``shell=True``, on " "POSIX the *executable* argument specifies a replacement shell for the " "default :file:`/bin/sh`." msgstr "" #: ../Doc/library/subprocess.rst:419 msgid "" "*stdin*, *stdout* and *stderr* specify the executed program's standard " "input, standard output and standard error file handles, respectively. Valid " "values are :data:`PIPE`, :data:`DEVNULL`, an existing file descriptor (a " "positive integer), an existing :term:`file object`, and ``None``. :data:" "`PIPE` indicates that a new pipe to the child should be created. :data:" "`DEVNULL` indicates that the special file :data:`os.devnull` will be used. " "With the default settings of ``None``, no redirection will occur; the " "child's file handles will be inherited from the parent. Additionally, " "*stderr* can be :data:`STDOUT`, which indicates that the stderr data from " "the applications should be captured into the same file handle as for stdout." msgstr "" #: ../Doc/library/subprocess.rst:430 msgid "" "If *preexec_fn* is set to a callable object, this object will be called in " "the child process just before the child is executed. (POSIX only)" msgstr "" #: ../Doc/library/subprocess.rst:436 msgid "" "The *preexec_fn* parameter is not safe to use in the presence of threads in " "your application. The child process could deadlock before exec is called. " "If you must use it, keep it trivial! Minimize the number of libraries you " "call into." msgstr "" #: ../Doc/library/subprocess.rst:444 msgid "" "If you need to modify the environment for the child use the *env* parameter " "rather than doing it in a *preexec_fn*. The *start_new_session* parameter " "can take the place of a previously common use of *preexec_fn* to call os." "setsid() in the child." msgstr "" #: ../Doc/library/subprocess.rst:449 msgid "" "If *close_fds* is true, all file descriptors except :const:`0`, :const:`1` " "and :const:`2` will be closed before the child process is executed. (POSIX " "only). The default varies by platform: Always true on POSIX. On Windows it " "is true when *stdin*/*stdout*/*stderr* are :const:`None`, false otherwise. " "On Windows, if *close_fds* is true then no handles will be inherited by the " "child process. Note that on Windows, you cannot set *close_fds* to true and " "also redirect the standard handles by setting *stdin*, *stdout* or *stderr*." msgstr "" #: ../Doc/library/subprocess.rst:457 msgid "" "The default for *close_fds* was changed from :const:`False` to what is " "described above." msgstr "" #: ../Doc/library/subprocess.rst:461 msgid "" "*pass_fds* is an optional sequence of file descriptors to keep open between " "the parent and child. Providing any *pass_fds* forces *close_fds* to be :" "const:`True`. (POSIX only)" msgstr "" #: ../Doc/library/subprocess.rst:465 msgid "The *pass_fds* parameter was added." msgstr "" #: ../Doc/library/subprocess.rst:468 msgid "" "If *cwd* is not ``None``, the function changes the working directory to " "*cwd* before executing the child. In particular, the function looks for " "*executable* (or for the first item in *args*) relative to *cwd* if the " "executable path is a relative path." msgstr "" #: ../Doc/library/subprocess.rst:473 msgid "" "If *restore_signals* is true (the default) all signals that Python has set " "to SIG_IGN are restored to SIG_DFL in the child process before the exec. " "Currently this includes the SIGPIPE, SIGXFZ and SIGXFSZ signals. (POSIX only)" msgstr "" #: ../Doc/library/subprocess.rst:478 msgid "*restore_signals* was added." msgstr "" #: ../Doc/library/subprocess.rst:481 msgid "" "If *start_new_session* is true the setsid() system call will be made in the " "child process prior to the execution of the subprocess. (POSIX only)" msgstr "" #: ../Doc/library/subprocess.rst:484 msgid "*start_new_session* was added." msgstr "" #: ../Doc/library/subprocess.rst:487 msgid "" "If *env* is not ``None``, it must be a mapping that defines the environment " "variables for the new process; these are used instead of the default " "behavior of inheriting the current process' environment." msgstr "" #: ../Doc/library/subprocess.rst:493 msgid "" "If specified, *env* must provide any variables required for the program to " "execute. On Windows, in order to run a `side-by-side assembly`_ the " "specified *env* **must** include a valid :envvar:`SystemRoot`." msgstr "" #: ../Doc/library/subprocess.rst:499 msgid "" "If *encoding* or *errors* are specified, the file objects *stdin*, *stdout* " "and *stderr* are opened in text mode with the specified encoding and " "*errors*, as described above in :ref:`frequently-used-arguments`. If " "*universal_newlines* is ``True``, they are opened in text mode with default " "encoding. Otherwise, they are opened as binary streams." msgstr "" #: ../Doc/library/subprocess.rst:505 msgid "*encoding* and *errors* were added." msgstr "" #: ../Doc/library/subprocess.rst:508 msgid "" "If given, *startupinfo* will be a :class:`STARTUPINFO` object, which is " "passed to the underlying ``CreateProcess`` function. *creationflags*, if " "given, can be :data:`CREATE_NEW_CONSOLE` or :data:" "`CREATE_NEW_PROCESS_GROUP`. (Windows only)" msgstr "" #: ../Doc/library/subprocess.rst:513 msgid "" "Popen objects are supported as context managers via the :keyword:`with` " "statement: on exit, standard file descriptors are closed, and the process is " "waited for. ::" msgstr "" #: ../Doc/library/subprocess.rst:520 msgid "Added context manager support." msgstr "" #: ../Doc/library/subprocess.rst:523 msgid "" "Popen destructor now emits a :exc:`ResourceWarning` warning if the child " "process is still running." msgstr "" #: ../Doc/library/subprocess.rst:529 msgid "Exceptions" msgstr "Les exceptions" #: ../Doc/library/subprocess.rst:531 msgid "" "Exceptions raised in the child process, before the new program has started " "to execute, will be re-raised in the parent. Additionally, the exception " "object will have one extra attribute called :attr:`child_traceback`, which " "is a string containing traceback information from the child's point of view." msgstr "" #: ../Doc/library/subprocess.rst:536 msgid "" "The most common exception raised is :exc:`OSError`. This occurs, for " "example, when trying to execute a non-existent file. Applications should " "prepare for :exc:`OSError` exceptions." msgstr "" #: ../Doc/library/subprocess.rst:540 msgid "" "A :exc:`ValueError` will be raised if :class:`Popen` is called with invalid " "arguments." msgstr "" #: ../Doc/library/subprocess.rst:543 msgid "" ":func:`check_call` and :func:`check_output` will raise :exc:" "`CalledProcessError` if the called process returns a non-zero return code." msgstr "" #: ../Doc/library/subprocess.rst:547 msgid "" "All of the functions and methods that accept a *timeout* parameter, such as :" "func:`call` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` " "if the timeout expires before the process exits." msgstr "" #: ../Doc/library/subprocess.rst:551 msgid "" "Exceptions defined in this module all inherit from :exc:`SubprocessError`." msgstr "" #: ../Doc/library/subprocess.rst:553 msgid "The :exc:`SubprocessError` base class was added." msgstr "" #: ../Doc/library/subprocess.rst:558 msgid "Security Considerations" msgstr "" #: ../Doc/library/subprocess.rst:560 msgid "" "Unlike some other popen functions, this implementation will never implicitly " "call a system shell. This means that all characters, including shell " "metacharacters, can safely be passed to child processes. If the shell is " "invoked explicitly, via ``shell=True``, it is the application's " "responsibility to ensure that all whitespace and metacharacters are quoted " "appropriately to avoid `shell injection `_ vulnerabilities." msgstr "" #: ../Doc/library/subprocess.rst:569 msgid "" "When using ``shell=True``, the :func:`shlex.quote` function can be used to " "properly escape whitespace and shell metacharacters in strings that are " "going to be used to construct shell commands." msgstr "" #: ../Doc/library/subprocess.rst:575 msgid "Popen Objects" msgstr "" #: ../Doc/library/subprocess.rst:577 msgid "Instances of the :class:`Popen` class have the following methods:" msgstr "" #: ../Doc/library/subprocess.rst:582 msgid "" "Check if child process has terminated. Set and return :attr:`~Popen." "returncode` attribute." msgstr "" #: ../Doc/library/subprocess.rst:588 msgid "" "Wait for child process to terminate. Set and return :attr:`~Popen." "returncode` attribute." msgstr "" #: ../Doc/library/subprocess.rst:591 msgid "" "If the process does not terminate after *timeout* seconds, raise a :exc:" "`TimeoutExpired` exception. It is safe to catch this exception and retry " "the wait." msgstr "" #: ../Doc/library/subprocess.rst:597 msgid "" "This will deadlock when using ``stdout=PIPE`` or ``stderr=PIPE`` and the " "child process generates enough output to a pipe such that it blocks waiting " "for the OS pipe buffer to accept more data. Use :meth:`Popen.communicate` " "when using pipes to avoid that." msgstr "" #: ../Doc/library/subprocess.rst:604 msgid "" "The function is implemented using a busy loop (non-blocking call and short " "sleeps). Use the :mod:`asyncio` module for an asynchronous wait: see :class:" "`asyncio.create_subprocess_exec`." msgstr "" #: ../Doc/library/subprocess.rst:608 ../Doc/library/subprocess.rst:654 #: ../Doc/library/subprocess.rst:878 ../Doc/library/subprocess.rst:906 #: ../Doc/library/subprocess.rst:949 msgid "*timeout* was added." msgstr "" #: ../Doc/library/subprocess.rst:613 msgid "" "Do not use the *endtime* parameter. It is was unintentionally exposed in " "3.3 but was left undocumented as it was intended to be private for internal " "use. Use *timeout* instead." msgstr "" #: ../Doc/library/subprocess.rst:619 msgid "" "Interact with process: Send data to stdin. Read data from stdout and " "stderr, until end-of-file is reached. Wait for process to terminate. The " "optional *input* argument should be data to be sent to the child process, or " "``None``, if no data should be sent to the child. If streams were opened in " "text mode, *input* must be a string. Otherwise, it must be bytes." msgstr "" #: ../Doc/library/subprocess.rst:625 msgid "" ":meth:`communicate` returns a tuple ``(stdout_data, stderr_data)``. The data " "will be strings if streams were opened in text mode; otherwise, bytes." msgstr "" #: ../Doc/library/subprocess.rst:629 msgid "" "Note that if you want to send data to the process's stdin, you need to " "create the Popen object with ``stdin=PIPE``. Similarly, to get anything " "other than ``None`` in the result tuple, you need to give ``stdout=PIPE`` " "and/or ``stderr=PIPE`` too." msgstr "" #: ../Doc/library/subprocess.rst:634 msgid "" "If the process does not terminate after *timeout* seconds, a :exc:" "`TimeoutExpired` exception will be raised. Catching this exception and " "retrying communication will not lose any output." msgstr "" #: ../Doc/library/subprocess.rst:638 msgid "" "The child process is not killed if the timeout expires, so in order to " "cleanup properly a well-behaved application should kill the child process " "and finish communication::" msgstr "" #: ../Doc/library/subprocess.rst:651 msgid "" "The data read is buffered in memory, so do not use this method if the data " "size is large or unlimited." msgstr "" #: ../Doc/library/subprocess.rst:660 msgid "Sends the signal *signal* to the child." msgstr "Envoie le signal *signal* au fils." #: ../Doc/library/subprocess.rst:664 msgid "" "On Windows, 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/subprocess.rst:671 msgid "" "Stop the child. On Posix OSs the method sends SIGTERM to the child. On " "Windows the Win32 API function :c:func:`TerminateProcess` is called to stop " "the child." msgstr "" #: ../Doc/library/subprocess.rst:678 msgid "" "Kills the child. On Posix OSs the function sends SIGKILL to the child. On " "Windows :meth:`kill` is an alias for :meth:`terminate`." msgstr "" #: ../Doc/library/subprocess.rst:682 msgid "The following attributes are also available:" msgstr "" #: ../Doc/library/subprocess.rst:686 msgid "" "The *args* argument as it was passed to :class:`Popen` -- a sequence of " "program arguments or else a single string." msgstr "" #: ../Doc/library/subprocess.rst:693 msgid "" "If the *stdin* argument was :data:`PIPE`, this attribute is a writeable " "stream object as returned by :func:`open`. If the *encoding* or *errors* " "arguments were specified or the *universal_newlines* argument was ``True``, " "the stream is a text stream, otherwise it is a byte stream. If the *stdin* " "argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" #: ../Doc/library/subprocess.rst:702 msgid "" "If the *stdout* argument was :data:`PIPE`, this attribute is a readable " "stream object as returned by :func:`open`. Reading from the stream provides " "output from the child process. If the *encoding* or *errors* arguments were " "specified or the *universal_newlines* argument was ``True``, the stream is a " "text stream, otherwise it is a byte stream. If the *stdout* argument was " "not :data:`PIPE`, this attribute is ``None``." msgstr "" #: ../Doc/library/subprocess.rst:712 msgid "" "If the *stderr* argument was :data:`PIPE`, this attribute is a readable " "stream object as returned by :func:`open`. Reading from the stream provides " "error output from the child process. If the *encoding* or *errors* arguments " "were specified or the *universal_newlines* argument was ``True``, the stream " "is a text stream, otherwise it is a byte stream. If the *stderr* argument " "was not :data:`PIPE`, this attribute is ``None``." msgstr "" #: ../Doc/library/subprocess.rst:721 msgid "" "Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write `, :attr:`.stdout.read ` or :attr:`.stderr.read ` to avoid deadlocks due to any of the other OS pipe buffers filling " "up and blocking the child process." msgstr "" #: ../Doc/library/subprocess.rst:729 msgid "The process ID of the child process." msgstr "" #: ../Doc/library/subprocess.rst:731 msgid "" "Note that if you set the *shell* argument to ``True``, this is the process " "ID of the spawned shell." msgstr "" #: ../Doc/library/subprocess.rst:737 msgid "" "The child return code, set by :meth:`poll` and :meth:`wait` (and indirectly " "by :meth:`communicate`). A ``None`` value indicates that the process hasn't " "terminated yet." msgstr "" #: ../Doc/library/subprocess.rst:746 msgid "Windows Popen Helpers" msgstr "" #: ../Doc/library/subprocess.rst:748 msgid "" "The :class:`STARTUPINFO` class and following constants are only available on " "Windows." msgstr "" #: ../Doc/library/subprocess.rst:753 msgid "" "Partial support of the Windows `STARTUPINFO `__ structure is used for :class:`Popen` " "creation." msgstr "" #: ../Doc/library/subprocess.rst:759 msgid "" "A bit field that determines whether certain :class:`STARTUPINFO` attributes " "are used when the process creates a window. ::" msgstr "" #: ../Doc/library/subprocess.rst:767 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard input handle for the process. If :data:`STARTF_USESTDHANDLES` " "is not specified, the default for standard input is the keyboard buffer." msgstr "" #: ../Doc/library/subprocess.rst:774 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard output handle for the process. Otherwise, this attribute is " "ignored and the default for standard output is the console window's buffer." msgstr "" #: ../Doc/library/subprocess.rst:781 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard error handle for the process. Otherwise, this attribute is " "ignored and the default for standard error is the console window's buffer." msgstr "" #: ../Doc/library/subprocess.rst:787 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this attribute " "can be any of the values that can be specified in the ``nCmdShow`` parameter " "for the `ShowWindow `__ function, except for ``SW_SHOWDEFAULT``. " "Otherwise, this attribute is ignored." msgstr "" #: ../Doc/library/subprocess.rst:794 msgid "" ":data:`SW_HIDE` is provided for this attribute. It is used when :class:" "`Popen` is called with ``shell=True``." msgstr "" #: ../Doc/library/subprocess.rst:799 msgid "Constants" msgstr "Constantes" #: ../Doc/library/subprocess.rst:801 msgid "The :mod:`subprocess` module exposes the following constants." msgstr "" #: ../Doc/library/subprocess.rst:805 msgid "" "The standard input device. Initially, this is the console input buffer, " "``CONIN$``." msgstr "" #: ../Doc/library/subprocess.rst:810 msgid "" "The standard output device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" #: ../Doc/library/subprocess.rst:815 msgid "" "The standard error device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" #: ../Doc/library/subprocess.rst:820 msgid "Hides the window. Another window will be activated." msgstr "" #: ../Doc/library/subprocess.rst:824 msgid "" "Specifies that the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO." "hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes contain additional " "information." msgstr "" #: ../Doc/library/subprocess.rst:830 msgid "" "Specifies that the :attr:`STARTUPINFO.wShowWindow` attribute contains " "additional information." msgstr "" #: ../Doc/library/subprocess.rst:835 msgid "" "The new process has a new console, instead of inheriting its parent's " "console (the default)." msgstr "" #: ../Doc/library/subprocess.rst:840 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "group will be created. This flag is necessary for using :func:`os.kill` on " "the subprocess." msgstr "" #: ../Doc/library/subprocess.rst:844 msgid "This flag is ignored if :data:`CREATE_NEW_CONSOLE` is specified." msgstr "" #: ../Doc/library/subprocess.rst:849 msgid "Older high-level API" msgstr "" #: ../Doc/library/subprocess.rst:851 msgid "" "Prior to Python 3.5, these three functions comprised the high level API to " "subprocess. You can now use :func:`run` in many cases, but lots of existing " "code calls these functions." msgstr "" #: ../Doc/library/subprocess.rst:857 msgid "" "Run the command described by *args*. Wait for command to complete, then " "return the :attr:`~Popen.returncode` attribute." msgstr "" #: ../Doc/library/subprocess.rst:860 ../Doc/library/subprocess.rst:888 #: ../Doc/library/subprocess.rst:921 msgid "This is equivalent to::" msgstr "C’est équivalent à ::" #: ../Doc/library/subprocess.rst:864 msgid "(except that the *input* and *check* parameters are not supported)" msgstr "" #: ../Doc/library/subprocess.rst:866 ../Doc/library/subprocess.rst:894 msgid "" "The arguments shown above are merely the most common ones. The full function " "signature is largely the same as that of the :class:`Popen` constructor - " "this function passes all supplied arguments other than *timeout* directly " "through to that interface." msgstr "" #: ../Doc/library/subprocess.rst:873 ../Doc/library/subprocess.rst:901 msgid "" "Do not use ``stdout=PIPE`` or ``stderr=PIPE`` with this function. The child " "process will block if it generates enough output to a pipe to fill up the OS " "pipe buffer as the pipes are not being read from." msgstr "" #: ../Doc/library/subprocess.rst:883 msgid "" "Run command with arguments. Wait for command to complete. If the return " "code was zero then return, otherwise raise :exc:`CalledProcessError`. The :" "exc:`CalledProcessError` object will have the return code in the :attr:" "`~CalledProcessError.returncode` attribute." msgstr "" #: ../Doc/library/subprocess.rst:892 msgid "(except that the *input* parameter is not supported)" msgstr "" #: ../Doc/library/subprocess.rst:914 msgid "Run command with arguments and return its output." msgstr "" #: ../Doc/library/subprocess.rst:916 msgid "" "If the return code was non-zero it raises a :exc:`CalledProcessError`. The :" "exc:`CalledProcessError` object will have the return code in the :attr:" "`~CalledProcessError.returncode` attribute and any output in the :attr:" "`~CalledProcessError.output` attribute." msgstr "" #: ../Doc/library/subprocess.rst:925 msgid "" "The arguments shown above are merely the most common ones. The full function " "signature is largely the same as that of :func:`run` - most arguments are " "passed directly through to that interface. However, explicitly passing " "``input=None`` to inherit the parent's standard input file handle is not " "supported." msgstr "" #: ../Doc/library/subprocess.rst:931 msgid "" "By default, this function will return the data as encoded bytes. The actual " "encoding of the output data may depend on the command being invoked, so the " "decoding to text will often need to be handled at the application level." msgstr "" #: ../Doc/library/subprocess.rst:935 msgid "" "This behaviour may be overridden by setting *universal_newlines* to ``True`` " "as described above in :ref:`frequently-used-arguments`." msgstr "" #: ../Doc/library/subprocess.rst:938 msgid "" "To also capture standard error in the result, use ``stderr=subprocess." "STDOUT``::" msgstr "" #: ../Doc/library/subprocess.rst:952 msgid "Support for the *input* keyword argument was added." msgstr "" #: ../Doc/library/subprocess.rst:958 msgid "Replacing Older Functions with the :mod:`subprocess` Module" msgstr "" #: ../Doc/library/subprocess.rst:960 msgid "" "In this section, \"a becomes b\" means that b can be used as a replacement " "for a." msgstr "" #: ../Doc/library/subprocess.rst:964 msgid "" "All \"a\" functions in this section fail (more or less) silently if the " "executed program cannot be found; the \"b\" replacements raise :exc:" "`OSError` instead." msgstr "" #: ../Doc/library/subprocess.rst:968 msgid "" "In addition, the replacements using :func:`check_output` will fail with a :" "exc:`CalledProcessError` if the requested operation produces a non-zero " "return code. The output is still available as the :attr:`~CalledProcessError." "output` attribute of the raised exception." msgstr "" #: ../Doc/library/subprocess.rst:973 msgid "" "In the following examples, we assume that the relevant functions have " "already been imported from the :mod:`subprocess` module." msgstr "" #: ../Doc/library/subprocess.rst:978 msgid "Replacing /bin/sh shell backquote" msgstr "" #: ../Doc/library/subprocess.rst:984 ../Doc/library/subprocess.rst:995 #: ../Doc/library/subprocess.rst:1012 msgid "becomes::" msgstr "" #: ../Doc/library/subprocess.rst:989 msgid "Replacing shell pipeline" msgstr "" #: ../Doc/library/subprocess.rst:1002 msgid "" "The p1.stdout.close() call after starting the p2 is important in order for " "p1 to receive a SIGPIPE if p2 exits before p1." msgstr "" #: ../Doc/library/subprocess.rst:1005 msgid "" "Alternatively, for trusted input, the shell's own pipeline support may still " "be used directly:" msgstr "" #: ../Doc/library/subprocess.rst:1018 msgid "Replacing :func:`os.system`" msgstr "" #: ../Doc/library/subprocess.rst:1026 msgid "Notes:" msgstr "Notes : " #: ../Doc/library/subprocess.rst:1028 msgid "Calling the program through the shell is usually not required." msgstr "" #: ../Doc/library/subprocess.rst:1030 msgid "A more realistic example would look like this::" msgstr "" #: ../Doc/library/subprocess.rst:1043 msgid "Replacing the :func:`os.spawn ` family" msgstr "" #: ../Doc/library/subprocess.rst:1045 msgid "P_NOWAIT example::" msgstr "" #: ../Doc/library/subprocess.rst:1051 msgid "P_WAIT example::" msgstr "" #: ../Doc/library/subprocess.rst:1057 msgid "Vector example::" msgstr "" #: ../Doc/library/subprocess.rst:1063 msgid "Environment example::" msgstr "" #: ../Doc/library/subprocess.rst:1072 msgid "Replacing :func:`os.popen`, :func:`os.popen2`, :func:`os.popen3`" msgstr "" #: ../Doc/library/subprocess.rst:1102 msgid "Return code handling translates as follows::" msgstr "" #: ../Doc/library/subprocess.rst:1118 msgid "Replacing functions from the :mod:`popen2` module" msgstr "" #: ../Doc/library/subprocess.rst:1122 msgid "" "If the cmd argument to popen2 functions is a string, the command is executed " "through /bin/sh. If it is a list, the command is directly executed." msgstr "" #: ../Doc/library/subprocess.rst:1141 msgid "" ":class:`popen2.Popen3` and :class:`popen2.Popen4` basically work as :class:" "`subprocess.Popen`, except that:" msgstr "" #: ../Doc/library/subprocess.rst:1144 msgid ":class:`Popen` raises an exception if the execution fails." msgstr "" #: ../Doc/library/subprocess.rst:1146 msgid "the *capturestderr* argument is replaced with the *stderr* argument." msgstr "" #: ../Doc/library/subprocess.rst:1148 msgid "``stdin=PIPE`` and ``stdout=PIPE`` must be specified." msgstr "" #: ../Doc/library/subprocess.rst:1150 msgid "" "popen2 closes all file descriptors by default, but you have to specify " "``close_fds=True`` with :class:`Popen` to guarantee this behavior on all " "platforms or past Python versions." msgstr "" #: ../Doc/library/subprocess.rst:1156 msgid "Legacy Shell Invocation Functions" msgstr "" #: ../Doc/library/subprocess.rst:1158 msgid "" "This module also provides the following legacy functions from the 2.x " "``commands`` module. These operations implicitly invoke the system shell and " "none of the guarantees described above regarding security and exception " "handling consistency are valid for these functions." msgstr "" #: ../Doc/library/subprocess.rst:1165 msgid "Return ``(status, output)`` of executing *cmd* in a shell." msgstr "" #: ../Doc/library/subprocess.rst:1167 msgid "" "Execute the string *cmd* in a shell with :meth:`Popen.check_output` and " "return a 2-tuple ``(status, output)``. The locale encoding is used; see the " "notes on :ref:`frequently-used-arguments` for more details." msgstr "" #: ../Doc/library/subprocess.rst:1171 msgid "" "A trailing newline is stripped from the output. The exit status for the " "command can be interpreted according to the rules for the C function :c:func:" "`wait`. Example::" msgstr "" #: ../Doc/library/subprocess.rst:1182 ../Doc/library/subprocess.rst:1198 msgid "Availability: POSIX & Windows" msgstr "" #: ../Doc/library/subprocess.rst:1184 ../Doc/library/subprocess.rst:1200 msgid "Windows support added" msgstr "" #: ../Doc/library/subprocess.rst:1190 msgid "Return output (stdout and stderr) of executing *cmd* in a shell." msgstr "" #: ../Doc/library/subprocess.rst:1192 msgid "" "Like :func:`getstatusoutput`, except the exit status is ignored and the " "return value is a string containing the command's output. Example::" msgstr "" #: ../Doc/library/subprocess.rst:1205 msgid "Notes" msgstr "Notes" #: ../Doc/library/subprocess.rst:1210 msgid "Converting an argument sequence to a string on Windows" msgstr "" #: ../Doc/library/subprocess.rst:1212 msgid "" "On Windows, an *args* sequence is converted to a string that can be parsed " "using the following rules (which correspond to the rules used by the MS C " "runtime):" msgstr "" #: ../Doc/library/subprocess.rst:1216 msgid "" "Arguments are delimited by white space, which is either a space or a tab." msgstr "" #: ../Doc/library/subprocess.rst:1219 msgid "" "A string surrounded by double quotation marks is interpreted as a single " "argument, regardless of white space contained within. A quoted string can " "be embedded in an argument." msgstr "" #: ../Doc/library/subprocess.rst:1224 msgid "" "A double quotation mark preceded by a backslash is interpreted as a literal " "double quotation mark." msgstr "" #: ../Doc/library/subprocess.rst:1227 msgid "" "Backslashes are interpreted literally, unless they immediately precede a " "double quotation mark." msgstr "" #: ../Doc/library/subprocess.rst:1230 msgid "" "If backslashes immediately precede a double quotation mark, every pair of " "backslashes is interpreted as a literal backslash. If the number of " "backslashes is odd, the last backslash escapes the next double quotation " "mark as described in rule 3." msgstr "" #: ../Doc/library/subprocess.rst:1239 msgid ":mod:`shlex`" msgstr "" #: ../Doc/library/subprocess.rst:1240 msgid "Module which provides function to parse and escape command lines." msgstr ""