`subprocess.md`

820 строк · 76.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.5/library/subprocess.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 17.5. [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess) – Управление подпроцессами89**Исходный код:** [Lib/subprocess.py](https://python-all.ru/src/3.5/Lib/subprocess.py)1011---1213Модуль [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess) позволяет создавать новые процессы, подключаться к их каналам ввода/вывода/ошибок и получать их коды возврата. Этот модуль призван заменить несколько более старых модулей и функций:1415```python16os.system17os.spawn*18```1920Информация о том, как с помощью модуля [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess) заменить эти модули и функции, приведена в следующих разделах.2122> **См. также**23>24> [**PEP 324**](https://python-all.ru/3.5/library/subprocess.html) – PEP, предлагающий модуль подпроцесса2526## 17.5.1. Использование модуля [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess)2728Рекомендуемый способ вызова подпроцессов – использовать функцию [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) для всех случаев, с которыми она может справиться. Для более сложных случаев можно напрямую использовать нижележащий интерфейс [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen).2930Функция [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) была добавлена в Python 3.5; если требуется сохранить совместимость со старыми версиями, см. раздел [Старого высокоуровневого API](https://python-all.ru/3.5/library/subprocess.html#call-function-trio).3132#### `subprocess.run(args, *, stdin=None, input=None, stdout=None, stderr=None, shell=False, timeout=None, check=False)`3334Выполняет команду, описанную аргументом *args*. Ожидает завершения команды и возвращает экземпляр [`CompletedProcess`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CompletedProcess).3536Аргументы, показанные выше, – лишь наиболее распространённые; они описаны ниже в разделе [Часто используемые аргументы](https://python-all.ru/3.5/library/subprocess.html#frequently-used-arguments) (отсюда использование только именованных аргументов в сокращённой сигнатуре). Полная сигнатура функции в основном совпадает с сигнатурой конструктора [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) – за исключением *timeout*, *input* и *check*; все остальные аргументы этой функции передаются этому интерфейсу.3738По умолчанию stdout и stderr не захватываются. Чтобы это сделать, передайте [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE) для аргументов *stdout* и/или *stderr*.3940Аргумент *timeout* передаётся в [`Popen.communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate). Если время ожидания истекает, дочерний процесс будет завершён, и он будет ожидаться. Исключение [`TimeoutExpired`](https://python-all.ru/3.5/library/subprocess.html#subprocess.TimeoutExpired) будет возбуждено повторно после завершения дочернего процесса.4142Аргумент *input* передаётся в [`Popen.communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate), а через него – в stdin подпроцесса. Если он используется, то должен представлять собой последовательность байтов или строку, если `universal_newlines=True`. При использовании внутренний объект [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) автоматически создаётся с `stdin=PIPE`, и аргумент *stdin* не может быть использован.4344Если *check* истинно и процесс завершается с ненулевым кодом возврата, будет возбуждено исключение [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError). Атрибуты этого исключения содержат аргументы, код возврата, а также stdout и stderr, если они были захвачены.4546Примеры:4748```python49>>> subprocess.run(["ls", "-l"])  # не захватывает вывод50CompletedProcess(args=['ls', '-l'], returncode=0)5152>>> subprocess.run("exit 1", shell=True, check=True)53Traceback (most recent call last):54  ...55subprocess.CalledProcessError: Command 'exit 1' returned non-zero exit status 15657>>> subprocess.run(["ls", "-l", "/dev/null"], stdout=subprocess.PIPE)58CompletedProcess(args=['ls', '-l', '/dev/null'], returncode=0,59stdout=b'crw-rw-rw- 1 root root 1, 3 Jan 23 16:23 /dev/null\n')60```6162Новое в версии 3.5.6364#### `class subprocess.CompletedProcess`6566Возвращаемое значение [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run), представляющее завершившийся процесс.6768#### `args`6970Аргументы, использованные для запуска процесса. Это может быть список или строка.7172#### `returncode`7374Статус выхода дочернего процесса. Обычно статус выхода 0 указывает на успешное завершение.7576Отрицательное значение `-N` указывает, что дочерний процесс был завершён сигналом `N` (только POSIX).7778#### `stdout`7980Захваченный stdout дочернего процесса. Последовательность байтов или строка, если [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) был вызван с `universal_newlines=True`. `None`, если stdout не был захвачен.8182Если процесс был запущен с `stderr=subprocess.STDOUT`, stdout и stderr будут объединены в этом атрибуте, а [`stderr`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CompletedProcess.stderr) будет равно `None`.8384#### `stderr`8586Захваченный stderr дочернего процесса. Последовательность байтов или строка, если [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) был вызван с `universal_newlines=True`. `None`, если stderr не был захвачен.8788#### `check_returncode()`8990Если [`returncode`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CompletedProcess.returncode) ненулевой, возбуждается [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError).9192Новое в версии 3.5.9394#### `subprocess.DEVNULL`9596Специальное значение, которое можно использовать в качестве аргумента *stdin*, *stdout* или *stderr* для [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) и указывает, что будет использоваться специальный файл [`os.devnull`](https://python-all.ru/3.5/library/os.html#os.devnull).9798Новое в версии 3.3.99100#### `subprocess.PIPE`101102Специальное значение, которое можно использовать в качестве аргумента *stdin*, *stdout* или *stderr* для [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) и указывает, что должен быть открыт канал (pipe) для стандартного потока. Наиболее полезен с [`Popen.communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate).103104#### `subprocess.STDOUT`105106Специальное значение, которое можно использовать в качестве аргумента *stderr* для [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) и указывает, что стандартный поток ошибок должен направляться в тот же дескриптор, что и стандартный вывод.107108#### `exception subprocess.SubprocessError`109110Базовый класс для всех остальных исключений из этого модуля.111112Новое в версии 3.3.113114#### `exception subprocess.TimeoutExpired`115116Подкласс [`SubprocessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.SubprocessError), возбуждается при истечении тайм-аута во время ожидания дочернего процесса.117118#### `cmd`119120Команда, которая использовалась для запуска дочернего процесса.121122#### `timeout`123124Тайм-аут в секундах.125126#### `output`127128Вывод дочернего процесса, если он был захвачен с помощью [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) или [`check_output()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_output). В противном случае `None`.129130#### `stdout`131132Псевдоним для output, для симметрии с [`stderr`](https://python-all.ru/3.5/library/subprocess.html#subprocess.TimeoutExpired.stderr).133134#### `stderr`135136Вывод stderr дочернего процесса, если он был захвачен с помощью [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run). В противном случае – `None`.137138Новое в версии 3.3.139140Изменено в версии 3.5: добавлены атрибуты *stdout* и *stderr*141142#### `exception subprocess.CalledProcessError`143144Подкласс [`SubprocessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.SubprocessError), вызываемый, когда процесс, запущенный через [`check_call()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_call) или [`check_output()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_output), возвращает ненулевой код завершения.145146#### `returncode`147148Статус выхода дочернего процесса. Если процесс завершился из-за сигнала, это будет отрицательный номер сигнала.149150#### `cmd`151152Команда, которая использовалась для запуска дочернего процесса.153154#### `output`155156Вывод дочернего процесса, если он был захвачен с помощью [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) или [`check_output()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_output). В противном случае `None`.157158#### `stdout`159160Псевдоним для output, для симметрии с [`stderr`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError.stderr).161162#### `stderr`163164Вывод stderr дочернего процесса, если он был захвачен с помощью [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run). В противном случае – `None`.165166Изменено в версии 3.5: добавлены атрибуты *stdout* и *stderr*167168### 17.5.1.1. Часто используемые аргументы169170Чтобы поддерживать широкий спектр сценариев использования, конструктор [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) (и удобные функции) принимает большое количество необязательных аргументов. Для большинства типичных случаев многие из этих аргументов можно безопасно оставить со значениями по умолчанию. Наиболее часто требуемые аргументы:171172> *args* обязателен для всех вызовов и должен быть строкой или последовательностью аргументов программы. Как правило, предпочтительнее передавать последовательность аргументов, так как это позволяет модулю позаботиться о любом необходимом экранировании и кавычках аргументов (например, для пробелов в именах файлов). Если передаётся одна строка, то либо *shell* должен быть [`True`](https://python-all.ru/3.5/library/constants.html#True) (см. ниже), либо строка должна просто указывать имя программы для запуска без указания каких-либо аргументов.173>174> *stdin*, *stdout* и *stderr* задают файловые дескрипторы стандартного ввода, стандартного вывода и стандартного вывода ошибок выполняемой программы соответственно. Допустимые значения: [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), [`DEVNULL`](https://python-all.ru/3.5/library/subprocess.html#subprocess.DEVNULL), существующий файловый дескриптор (положительное целое число), существующий файловый объект и `None`. [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE) указывает, что должен быть создан новый канал к дочернему процессу. [`DEVNULL`](https://python-all.ru/3.5/library/subprocess.html#subprocess.DEVNULL) указывает, что будет использоваться специальный файл [`os.devnull`](https://python-all.ru/3.5/library/os.html#os.devnull). При настройках по умолчанию (`None`) перенаправление не выполняется; файловые дескрипторы дочернего процесса наследуются от родительского. Кроме того, *stderr* может быть [`STDOUT`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STDOUT), что означает, что данные stderr дочернего процесса должны быть направлены в тот же файловый дескриптор, что и для *stdout*.175>176> Если *universal\_newlines* имеет значение `False`, файловые объекты *stdin*, *stdout* и *stderr* будут открыты как бинарные потоки, и преобразование концов строк не выполняется.177>178> Если *universal\_newlines* имеет значение `True`, эти файловые объекты будут открыты как текстовые потоки в режиме [универсальные новые строки](https://python-all.ru/3.5/glossary.html#term-universal-newlines) с использованием кодировки, возвращаемой [`locale.getpreferredencoding(False)`](https://python-all.ru/3.5/library/locale.html#locale.getpreferredencoding). Для *stdin* символы концов строк `'\n'` во входных данных будут преобразованы в разделитель строк по умолчанию [`os.linesep`](https://python-all.ru/3.5/library/os.html#os.linesep). Для *stdout* и *stderr* все концы строк в выходных данных будут преобразованы в `'\n'`. Дополнительную информацию см. в документации класса [`io.TextIOWrapper`](https://python-all.ru/3.5/library/io.html#io.TextIOWrapper), когда аргумент *newline* его конструктора равен `None`.179>180> > **Примечание**181> >182> > Атрибут newlines файловых объектов [`Popen.stdin`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.stdin), [`Popen.stdout`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.stdout) и [`Popen.stderr`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.stderr) не обновляется методом [`Popen.communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate).183>184> Если *shell* равен `True`, указанная команда будет выполняться через оболочку. Это может быть полезно, если вы используете Python в основном из-за улучшенного управления потоком, которое он предлагает по сравнению с большинством системных оболочек, и при этом хотите удобного доступа к другим возможностям оболочки, таким как конвейеры, подстановка имен файлов, подстановка переменных окружения и раскрытие `~` в домашний каталог пользователя. Однако имейте в виду, что сам Python предлагает реализации многих функций, подобных оболочке (в частности, [`glob`](https://python-all.ru/3.5/library/glob.html#module-glob), [`fnmatch`](https://python-all.ru/3.5/library/fnmatch.html#module-fnmatch), [`os.walk()`](https://python-all.ru/3.5/library/os.html#os.walk), [`os.path.expandvars()`](https://python-all.ru/3.5/library/os.path.html#os.path.expandvars), [`os.path.expanduser()`](https://python-all.ru/3.5/library/os.path.html#os.path.expanduser) и [`shutil`](https://python-all.ru/3.5/library/shutil.html#module-shutil)).185>186> Изменено в версии 3.3: Когда *universal\_newlines* имеет значение `True`, класс использует кодировку [`locale.getpreferredencoding(False)`](https://python-all.ru/3.5/library/locale.html#locale.getpreferredencoding) вместо `locale.getpreferredencoding()`. Подробнее об этом изменении см. в документации класса [`io.TextIOWrapper`](https://python-all.ru/3.5/library/io.html#io.TextIOWrapper).187>188> > **Примечание**189> >190> > Перед использованием `shell=True` прочтите раздел [Рекомендации по безопасности](https://python-all.ru/3.5/library/subprocess.html#security-considerations).191192Эти опции, как и все остальные, подробно описаны в документации конструктора [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen).193194### 17.5.1.2. Конструктор Popen195196Создание и управление базовыми процессами в этом модуле осуществляется классом [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen). Он предоставляет большую гибкость, чтобы разработчики могли обрабатывать менее распространённые случаи, не охваченные удобными функциями.197198#### `class subprocess.Popen(args, bufsize=-1, executable=None, stdin=None, stdout=None, stderr=None, preexec_fn=None, close_fds=True, shell=False, cwd=None, env=None, universal_newlines=False, startupinfo=None, creationflags=0, restore_signals=True, start_new_session=False, pass_fds=())`199200Запускает дочернюю программу в новом процессе. На POSIX класс использует поведение, подобное [`os.execvp()`](https://python-all.ru/3.5/library/os.html#os.execvp), для выполнения дочерней программы. На Windows класс использует функцию Windows `CreateProcess()`. Аргументы [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) описаны ниже.201202*args* должен быть последовательностью аргументов программы или отдельной строкой. По умолчанию, если *args* является последовательностью, исполняемая программа – это первый элемент в *args*. Если *args* – строка, интерпретация зависит от платформы и описана ниже. Дополнительные отличия от поведения по умолчанию см. в аргументах *shell* и *executable*. Если не указано иное, рекомендуется передавать *args* как последовательность.203204На POSIX, если *args* – строка, она интерпретируется как имя или путь к программе для запуска. Однако это можно сделать только в том случае, если программе не передаются аргументы.205206> **Примечание**207>208> [`shlex.split()`](https://python-all.ru/3.5/library/shlex.html#shlex.split) может быть полезен при определении правильной токенизации для *args*, особенно в сложных случаях:209>210> ```python211> >>> import shlex, subprocess212> >>> command_line = input()213> /bin/vikings -input eggs.txt -output "spam spam.txt" -cmd "echo '$MONEY'"214> >>> args = shlex.split(command_line)215> >>> print(args)216> ['/bin/vikings', '-input', 'eggs.txt', '-output', 'spam spam.txt', '-cmd', "echo '$MONEY'"]217> >>> p = subprocess.Popen(args) # Успешно!218> ```219>220> Обратите внимание, что опции (такие как *-input*) и аргументы (такие как *eggs.txt*), разделённые пробелами в оболочке, помещаются в отдельные элементы списка, в то время как аргументы, требующие кавычек или обратной косой черты в оболочке (например, имена файлов, содержащие пробелы, или команда *echo*, показанная выше), являются отдельными элементами списка.221222На Windows, если *args* – последовательность, она будет преобразована в строку способом, описанным в разделе [Преобразование последовательности аргументов в строку на Windows](https://python-all.ru/3.5/library/subprocess.html#converting-argument-sequence). Это связано с тем, что базовая функция `CreateProcess()` работает со строками.223224Аргумент *shell* (по умолчанию `False`) определяет, нужно ли использовать оболочку в качестве исполняемой программы. Если *shell* равен `True`, рекомендуется передавать *args* в виде строки, а не последовательности.225226На POSIX с `shell=True` оболочка по умолчанию – `/bin/sh`. Если *args* – строка, она задаёт команду для выполнения через оболочку. Это означает, что строка должна быть оформлена точно так же, как если бы она была введена в командной строке оболочки. Например, это включает экранирование кавычками или обратной косой черты имён файлов с пробелами. Если *args* – последовательность, первый элемент задаёт строку команды, а все остальные элементы рассматриваются как дополнительные аргументы для самой оболочки. Иначе говоря, [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) эквивалентно:227228```python229Popen(['/bin/sh', '-c', args[0], args[1], ...])230```231232На Windows с `shell=True` переменная окружения `COMSPEC` задаёт оболочку по умолчанию. Указывать `shell=True` в Windows нужно только тогда, когда команда, которую требуется выполнить, встроена в оболочку (например, **dir** или **copy**). Для запуска пакетного файла или консольного исполняемого файла `shell=True` не требуется.233234> **Примечание**235>236> Перед использованием `shell=True` прочтите раздел [Рекомендации по безопасности](https://python-all.ru/3.5/library/subprocess.html#security-considerations).237238*bufsize* будет передан как соответствующий аргумент функции [`open()`](https://python-all.ru/3.5/library/functions.html#open) при создании файловых объектов каналов stdin/stdout/stderr:239240- `0` означает без буферизации (чтение и запись – один системный вызов, могут возвращать меньше данных, чем запрошено)241- `1` означает буферизацию по строкам (работает только при `universal_newlines=True`, т.е. в текстовом режиме)242- любое другое положительное значение означает использование буфера примерно такого размера243- отрицательное значение bufsize (по умолчанию) означает, что будет использовано системное значение по умолчанию io.DEFAULT\_BUFFER\_SIZE.244245Изменено в версии 3.3.1: *bufsize* теперь по умолчанию равен -1, чтобы включить буферизацию по умолчанию, как того ожидает большинство кода. В версиях до Python 3.2.4 и 3.3.1 по умолчанию ошибочно использовалось `0`, что означало отсутствие буферизации и допускало короткие чтения. Это было непреднамеренно и не соответствовало поведению Python 2, как ожидал большинство кода.246247Аргумент *executable* задаёт альтернативную программу для выполнения. Он требуется очень редко. Если `shell=False`, *executable* заменяет программу, указанную в *args*. Однако исходное значение *args* всё равно передаётся программе. Большинство программ воспринимают программу, указанную через *args*, как имя команды, которое может отличаться от фактически выполняемой программы. На POSIX имя из *args* становится отображаемым именем исполняемого файла в утилитах вроде **ps**. Если `shell=True`, на POSIX аргумент *executable* задаёт альтернативную оболочку вместо `/bin/sh`.248249*stdin*, *stdout* и *stderr* задают файловые дескрипторы стандартного ввода, стандартного вывода и стандартного вывода ошибок выполняемой программы соответственно. Допустимые значения: [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), [`DEVNULL`](https://python-all.ru/3.5/library/subprocess.html#subprocess.DEVNULL), существующий файловый дескриптор (положительное целое число), существующий [файловый объект](https://python-all.ru/3.5/glossary.html#term-file-object) и `None`. [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE) указывает, что должен быть создан новый канал к дочернему процессу. [`DEVNULL`](https://python-all.ru/3.5/library/subprocess.html#subprocess.DEVNULL) указывает, что будет использоваться специальный файл [`os.devnull`](https://python-all.ru/3.5/library/os.html#os.devnull). При настройках по умолчанию (`None`) перенаправление не выполняется; файловые дескрипторы дочернего процесса наследуются от родительского. Кроме того, *stderr* может быть [`STDOUT`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STDOUT), что означает, что данные stderr приложений должны быть направлены в тот же файловый дескриптор, что и для stdout.250251Если *preexec\_fn* задан как вызываемый объект, этот объект будет вызван в дочернем процессе непосредственно перед его выполнением. (Только POSIX)252253> **Предупреждение**254>255> Параметр *preexec\_fn* небезопасно использовать при наличии потоков в приложении. Дочерний процесс может зависнуть до вызова exec. Если его всё же нужно использовать, пусть он будет тривиальным! Сведите к минимуму количество вызываемых библиотек.256257> **Примечание**258>259> Если нужно изменить окружение для дочернего процесса, используйте параметр *env* вместо изменения в *preexec\_fn*. Параметр *start\_new\_session* может заменить ранее распространённое использование *preexec\_fn* для вызова os.setsid() в дочернем процессе.260261Если *close\_fds* равно True, все файловые дескрипторы, кроме `0`, `1` и `2`, будут закрыты перед выполнением дочернего процесса (только POSIX). Значение по умолчанию зависит от платформы: всегда True на POSIX. На Windows оно равно True, когда *stdin*/*stdout*/*stderr* равны [`None`](https://python-all.ru/3.5/library/constants.html#None), иначе False. На Windows, если *close\_fds* равно True, то дочерний процесс не унаследует ни один дескриптор. Обратите внимание, что в Windows нельзя установить *close\_fds* в True и одновременно перенаправлять стандартные дескрипторы, задавая *stdin*, *stdout* или *stderr*.262263Изменено в версии 3.2: Значение по умолчанию для *close\_fds* было изменено с [`False`](https://python-all.ru/3.5/library/constants.html#False) на то, что описано выше.264265*pass\_fds* – необязательная последовательность файловых дескрипторов, которые должны оставаться открытыми между родительским и дочерним процессами. Указание любого *pass\_fds* принуждает *close\_fds* принимать значение [`True`](https://python-all.ru/3.5/library/constants.html#True). (Только POSIX)266267Новое в версии 3.2: Добавлен параметр *pass\_fds*.268269Если *cwd* не равно `None`, функция меняет рабочий каталог на *cwd* перед запуском дочернего процесса. В частности, функция ищет *executable* (или первый элемент в *args*) относительно *cwd*, если путь к исполняемому файлу является относительным.270271Если *restore\_signals* равен true (по умолчанию), все сигналы, которые Python установил в SIG\_IGN, восстанавливаются в SIG\_DFL в дочернем процессе перед exec. В настоящее время это включает сигналы SIGPIPE, SIGXFZ и SIGXFSZ. (Только POSIX)272273Изменено в версии 3.2: Добавлен *restore\_signals*.274275Если *start\_new\_session* равен true, системный вызов setsid() будет выполнен в дочернем процессе перед запуском подпроцесса. (только POSIX)276277Изменено в версии 3.2: добавлен *start\_new\_session*.278279Если *env* не равен `None`, он должен быть отображением (mapping), определяющим переменные окружения для нового процесса; они используются вместо поведения по умолчанию, заключающегося в наследовании окружения текущего процесса.280281> **Примечание**282>283> Если указано, *env* должен предоставить все переменные, необходимые для выполнения программы. В Windows для запуска [сборки side-by-side](https://python-all.ru/3.5/library/subprocess.html) указанный *env* **должен** включать корректный `SystemRoot`.284285Если *universal\_newlines* имеет значение `True`, файловые объекты *stdin*, *stdout* и *stderr* открываются как текстовые потоки в режиме универсальных новых строк, как описано выше в разделе [Часто используемые аргументы](https://python-all.ru/3.5/library/subprocess.html#frequently-used-arguments), в противном случае они открываются как бинарные потоки.286287Если задан, *startupinfo* будет объектом [`STARTUPINFO`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO), который передаётся нижележащей функции `CreateProcess`. *creationflags*, если задан, может быть [`CREATE_NEW_CONSOLE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CREATE_NEW_CONSOLE) или [`CREATE_NEW_PROCESS_GROUP`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CREATE_NEW_PROCESS_GROUP) (только Windows).288289Объекты Popen поддерживаются как менеджеры контекста через оператор [`with`](https://python-all.ru/3.5/reference/compound_stmts.html#with): при выходе стандартные файловые дескрипторы закрываются, и процесс ожидается.290291```python292with Popen(["ifconfig"], stdout=PIPE) as proc:293    log.write(proc.stdout.read())294```295296Изменено в версии 3.2: добавлена поддержка менеджера контекста.297298### 17.5.1.3. Исключения299300Исключения, возникающие в дочернем процессе до начала выполнения новой программы, будут повторно возбуждены в родительском процессе. Кроме того, объект исключения будет иметь дополнительный атрибут с именем `child_traceback`, который представляет собой строку, содержащую информацию о трассировке с точки зрения дочернего процесса.301302Наиболее часто вызываемое исключение – [`OSError`](https://python-all.ru/3.5/library/exceptions.html#OSError). Оно возникает, например, при попытке выполнить несуществующий файл. Приложения должны быть готовы к исключениям [`OSError`](https://python-all.ru/3.5/library/exceptions.html#OSError).303304[`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError) будет вызван, если [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) вызвана с недопустимыми аргументами.305306[`check_call()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_call) и [`check_output()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_output) вызовут [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError), если вызванный процесс вернёт ненулевой код возврата.307308Все функции и методы, которые принимают параметр *тайм-аут*, например [`call()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.call) и [`Popen.communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate), будут возбуждать исключение [`TimeoutExpired`](https://python-all.ru/3.5/library/subprocess.html#subprocess.TimeoutExpired), если тайм-аут истекает до завершения процесса.309310Все исключения, определённые в этом модуле, наследуются от [`SubprocessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.SubprocessError).311312> Новое в версии 3.3: добавлен базовый класс [`SubprocessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.SubprocessError).313314## 17.5.2. Рекомендации по безопасности315316В отличие от некоторых других функций popen, данная реализация никогда не вызывает системную оболочку неявно. Это означает, что все символы, включая метасимволы оболочки, можно безопасно передавать дочерним процессам. Если оболочка вызывается явно через `shell=True`, приложение должно само позаботиться о том, чтобы все пробелы и метасимволы были правильно экранированы во избежание уязвимостей [внедрения команд оболочки](https://python-all.ru/3.5/library/subprocess.html).317318При использовании `shell=True` функция [`shlex.quote()`](https://python-all.ru/3.5/library/shlex.html#shlex.quote) может быть использована для правильного экранирования пробелов и метасимволов оболочки в строках, которые будут использоваться для построения команд оболочки.319320## 17.5.3. Объекты Popen321322Экземпляры класса [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) имеют следующие методы:323324#### `Popen.poll()`325326Проверяет, завершён ли дочерний процесс. Устанавливает и возвращает атрибут [`returncode`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.returncode).327328#### `Popen.wait(timeout=None)`329330Ожидает завершения дочернего процесса. Устанавливает и возвращает атрибут [`returncode`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.returncode).331332Если процесс не завершается через *тайм-аут* секунд, возбуждается исключение [`TimeoutExpired`](https://python-all.ru/3.5/library/subprocess.html#subprocess.TimeoutExpired). Это исключение можно безопасно перехватить и повторить ожидание.333334> **Примечание**335>336> Это приведёт к взаимоблокировке при использовании `stdout=PIPE` или `stderr=PIPE` и когда дочерний процесс порождает достаточно выходных данных в канал, так что он блокируется в ожидании, когда буфер канала ОС примет больше данных. Используйте [`Popen.communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate) при работе с каналами, чтобы избежать этого.337338> **Примечание**339>340> Функция реализована с помощью busy-цикла (неблокирующий вызов и короткие паузы). Используйте модуль [`asyncio`](https://python-all.ru/3.5/library/asyncio.html#module-asyncio) для асинхронного ожидания: см. [`asyncio.create_subprocess_exec`](https://python-all.ru/3.5/library/asyncio-subprocess.html#asyncio.create_subprocess_exec).341342Изменено в версии 3.3: добавлен *timeout*.343344Устарело с версии 3.4: Не используйте параметр *endtime*. Он был случайно открыт в версии 3.3, но остался недокументированным, так как предполагался приватным для внутреннего использования. Вместо него используйте *timeout*.345346#### `Popen.communicate(input=None, timeout=None)`347348Взаимодействует с процессом: отправляет данные в stdin. Читает данные из stdout и stderr, до достижения конца файла. Ожидает завершения процесса. Необязательный аргумент *input* должен содержать данные для отправки дочернему процессу или `None`, если данные не нужно отправлять. Тип *input* должен быть bytes или, если *universal\_newlines* было `True`, строкой.349350[`communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate) возвращает кортеж `(stdout_data, stderr_data)`. Данные будут в формате bytes или, если *universal\_newlines* было `True`, строк.351352Обратите внимание: если вы хотите отправить данные в stdin процесса, необходимо создать объект Popen с `stdin=PIPE`. Аналогично, чтобы получить что-то, кроме `None`, в результирующем кортеже, нужно также передать `stdout=PIPE` и/или `stderr=PIPE`.353354Если процесс не завершится за *timeout* секунд, будет вызвано исключение [`TimeoutExpired`](https://python-all.ru/3.5/library/subprocess.html#subprocess.TimeoutExpired). Перехват этого исключения и повторное обращение к обмену данными не приведет к потере вывода.355356Дочерний процесс не уничтожается по истечении тайм-аута, поэтому для корректной очистки хорошо написанное приложение должно уничтожить дочерний процесс и завершить обмен данными:357358```python359proc = subprocess.Popen(...)360try:361    outs, errs = proc.communicate(timeout=15)362except TimeoutExpired:363    proc.kill()364    outs, errs = proc.communicate()365```366367> **Примечание**368>369> Прочитанные данные буферизуются в памяти, поэтому не используйте этот метод, если размер данных велик или неограничен.370371Изменено в версии 3.3: добавлен *timeout*.372373#### `Popen.send_signal(signal)`374375Отправляет сигнал *signal* дочернему процессу.376377> **Примечание**378>379> В Windows SIGTERM является псевдонимом для [`terminate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.terminate). CTRL\_C\_EVENT и CTRL\_BREAK\_EVENT можно отправлять процессам, запущенным с параметром *creationflags*, включающим *CREATE\_NEW\_PROCESS\_GROUP*.380381#### `Popen.terminate()`382383Останавливает дочерний процесс. В ОС POSIX метод отправляет SIGTERM дочернему процессу. В Windows для остановки дочернего процесса вызывается функция Win32 API `TerminateProcess()`.384385#### `Popen.kill()`386387Завершает дочерний процесс. В ОС POSIX функция отправляет SIGKILL дочернему процессу. В Windows [`kill()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.kill) является псевдонимом для [`terminate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.terminate).388389Также доступны следующие атрибуты:390391#### `Popen.args`392393Аргумент *args* в том виде, в котором он был передан в [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) – последовательность аргументов программы или одна строка.394395Новое в версии 3.3.396397#### `Popen.stdin`398399Если аргумент *stdin* был [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), этот атрибут представляет собой записываемый объект потока, возвращаемый [`open()`](https://python-all.ru/3.5/library/functions.html#open). Если аргумент *universal\_newlines* был `True`, поток является текстовым, в противном случае – байтовым потоком. Если аргумент *stdin* не был [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), этот атрибут равен `None`.400401#### `Popen.stdout`402403Если аргумент *stdout* был [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), этот атрибут представляет собой читаемый объект потока, возвращаемый [`open()`](https://python-all.ru/3.5/library/functions.html#open). Чтение из потока предоставляет вывод дочернего процесса. Если аргумент *universal\_newlines* был `True`, поток является текстовым, в противном случае – байтовым потоком. Если аргумент *stdout* не был [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), этот атрибут равен `None`.404405#### `Popen.stderr`406407Если аргумент *stderr* был [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), этот атрибут представляет собой читаемый объект потока, возвращаемый [`open()`](https://python-all.ru/3.5/library/functions.html#open). Чтение из потока предоставляет вывод ошибок дочернего процесса. Если аргумент *universal\_newlines* был `True`, поток является текстовым, в противном случае – байтовым потоком. Если аргумент *stderr* не был [`PIPE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.PIPE), этот атрибут равен `None`.408409> **Предупреждение**410>411> Используйте [`communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate) вместо [`.stdin.write`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.stdin), [`.stdout.read`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.stdout) или [`.stderr.read`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.stderr), чтобы избежать взаимоблокировок из-за переполнения буферов каналов ОС и блокировки дочернего процесса.412413#### `Popen.pid`414415PID дочернего процесса.416417Обратите внимание: если аргумент *shell* установлен в `True`, это PID запущенной оболочки.418419#### `Popen.returncode`420421Код возврата дочернего процесса, устанавливаемый методами [`poll()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.poll) и [`wait()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.wait) (а косвенно – [`communicate()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.communicate)). Значение `None` указывает, что процесс ещё не завершён.422423Отрицательное значение `-N` указывает, что дочерний процесс был завершён сигналом `N` (только POSIX).424425## 17.5.4. Вспомогательные классы Popen для Windows426427Класс [`STARTUPINFO`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO) и следующие константы доступны только в Windows.428429#### `class subprocess.STARTUPINFO`430431Частичная поддержка структуры Windows [STARTUPINFO](https://python-all.ru/3.5/library/subprocess.html) используется для создания [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen).432433#### `dwFlags`434435Битовое поле, определяющее, используются ли определённые атрибуты [`STARTUPINFO`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO) при создании окна процессом.436437```python438si = subprocess.STARTUPINFO()439si.dwFlags = subprocess.STARTF_USESTDHANDLES | subprocess.STARTF_USESHOWWINDOW440```441442#### `hStdInput`443444Если [`dwFlags`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указывает [`STARTF_USESTDHANDLES`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTF_USESTDHANDLES), этот атрибут является дескриптором стандартного ввода процесса. Если [`STARTF_USESTDHANDLES`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTF_USESTDHANDLES) не указан, по умолчанию для стандартного ввода используется буфер клавиатуры.445446#### `hStdOutput`447448Если [`dwFlags`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указывает [`STARTF_USESTDHANDLES`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTF_USESTDHANDLES), этот атрибут является дескриптором стандартного вывода процесса. В противном случае этот атрибут игнорируется, и по умолчанию для стандартного вывода используется буфер окна консоли.449450#### `hStdError`451452Если [`dwFlags`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указывает [`STARTF_USESTDHANDLES`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTF_USESTDHANDLES), этот атрибут является дескриптором стандартного вывода ошибок процесса. В противном случае этот атрибут игнорируется, и по умолчанию для стандартного вывода ошибок используется буфер окна консоли.453454#### `wShowWindow`455456Если в [`dwFlags`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указан [`STARTF_USESHOWWINDOW`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTF_USESHOWWINDOW), этот атрибут может принимать любое значение, которое можно указать в параметре `nCmdShow` для функции [ShowWindow](https://python-all.ru/3.5/library/subprocess.html), за исключением `SW_SHOWDEFAULT`. В противном случае этот атрибут игнорируется.457458Для этого атрибута предоставляется [`SW_HIDE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.SW_HIDE). Он используется, когда [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) вызывается с `shell=True`.459460### 17.5.4.1. Константы461462Модуль [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess) предоставляет следующие константы.463464#### `subprocess.STD_INPUT_HANDLE`465466Устройство стандартного ввода. Изначально это буфер консольного ввода, `CONIN$`.467468#### `subprocess.STD_OUTPUT_HANDLE`469470Устройство стандартного вывода. Изначально это активный буфер консольного экрана, `CONOUT$`.471472#### `subprocess.STD_ERROR_HANDLE`473474Устройство стандартного вывода ошибок. Изначально это активный буфер консольного экрана, `CONOUT$`.475476#### `subprocess.SW_HIDE`477478Скрывает окно. Другое окно будет активировано.479480#### `subprocess.STARTF_USESTDHANDLES`481482Указывает, что атрибуты [`STARTUPINFO.hStdInput`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.hStdInput), [`STARTUPINFO.hStdOutput`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.hStdOutput) и [`STARTUPINFO.hStdError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.hStdError) содержат дополнительную информацию.483484#### `subprocess.STARTF_USESHOWWINDOW`485486Указывает, что атрибут [`STARTUPINFO.wShowWindow`](https://python-all.ru/3.5/library/subprocess.html#subprocess.STARTUPINFO.wShowWindow) содержит дополнительную информацию.487488#### `subprocess.CREATE_NEW_CONSOLE`489490Новый процесс получает новую консоль вместо наследования консоли родителя (по умолчанию).491492#### `subprocess.CREATE_NEW_PROCESS_GROUP`493494Параметр [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) `creationflags`, указывающий, что будет создана новая группа процессов. Этот флаг необходим для использования [`os.kill()`](https://python-all.ru/3.5/library/os.html#os.kill) в подпроцессе.495496Этот флаг игнорируется, если указан [`CREATE_NEW_CONSOLE`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CREATE_NEW_CONSOLE).497498## 17.5.5. Старый высокоуровневый API499500До Python 3.5 эти три функции представляли собой высокоуровневый API для subprocess. Теперь во многих случаях можно использовать [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run), но значительная часть существующего кода по-прежнему вызывает эти функции.501502#### `subprocess.call(args, *, stdin=None, stdout=None, stderr=None, shell=False, timeout=None)`503504Запускает команду, описанную параметром *args*. Ожидает завершения команды и затем возвращает атрибут [`returncode`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen.returncode).505506Это эквивалентно:507508```python509run(...).returncode510```511512(за исключением того, что параметры *input* и *check* не поддерживаются)513514Показанные выше аргументы – лишь самые распространённые. Полная сигнатура функции в основном совпадает с сигнатурой конструктора [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) – эта функция передаёт все переданные аргументы, кроме *timeout*, напрямую в этот интерфейс.515516> **Примечание**517>518> Не используйте `stdout=PIPE` или `stderr=PIPE` с этой функцией. Дочерний процесс будет заблокирован, если он выдаст в канал достаточно данных, чтобы заполнить буфер канала ОС, поскольку каналы не читаются.519520Изменено в версии 3.3: добавлен *timeout*.521522#### `subprocess.check_call(args, *, stdin=None, stdout=None, stderr=None, shell=False, timeout=None)`523524Выполняет команду с аргументами. Ожидает завершения команды. Если код возврата равен нулю, возвращает результат, иначе вызывает [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError). Объект [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError) будет содержать код возврата в атрибуте [`returncode`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError.returncode).525526Это эквивалентно:527528```python529run(..., check=True)530```531532(за исключением того, что параметр *input* не поддерживается)533534Показанные выше аргументы – лишь самые распространённые. Полная сигнатура функции в основном совпадает с сигнатурой конструктора [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) – эта функция передаёт все переданные аргументы, кроме *timeout*, напрямую в этот интерфейс.535536> **Примечание**537>538> Не используйте `stdout=PIPE` или `stderr=PIPE` с этой функцией. Дочерний процесс будет заблокирован, если он выдаст в канал достаточно данных, чтобы заполнить буфер канала ОС, поскольку каналы не читаются.539540Изменено в версии 3.3: добавлен *timeout*.541542#### `subprocess.check_output(args, *, stdin=None, stderr=None, shell=False, universal_newlines=False, timeout=None)`543544Выполняет команду с аргументами и возвращает её вывод.545546Если код возврата был ненулевым, возбуждается исключение [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError). Объект [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError) будет содержать код возврата в атрибуте [`returncode`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError.returncode), а вывод – в атрибуте [`output`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError.output).547548Это эквивалентно:549550```python551run(..., check=True, stdout=PIPE).stdout552```553554Показанные выше аргументы – лишь самые распространённые. Полная сигнатура функции в основном та же, что и у [`run()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.run) – большинство аргументов передаются напрямую в этот интерфейс. Однако явная передача `input=None` для наследования дескриптора стандартного ввода родительского процесса не поддерживается.555556По умолчанию эта функция возвращает данные в виде закодированных байтов. Фактическая кодировка выходных данных может зависеть от вызываемой команды, поэтому декодирование в текст часто приходится выполнять на уровне приложения.557558Это поведение можно переопределить, установив *universal\_newlines* в `True`, как описано выше в разделе [Часто используемые аргументы](https://python-all.ru/3.5/library/subprocess.html#frequently-used-arguments).559560Чтобы также захватывать стандартный поток ошибок в результате, используйте `stderr=subprocess.STDOUT`:561562```python563>>> subprocess.check_output(564...     "ls non_existent_file; exit 0",565...     stderr=subprocess.STDOUT,566...     shell=True)567'ls: non_existent_file: No such file or directory\n'568```569570Новое в версии 3.1.571572Изменено в версии 3.3: добавлен *timeout*.573574Изменено в версии 3.4: добавлена поддержка именованного аргумента *input*.575576## 17.5.6. Замена старых функций модулем [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess)577578В этом разделе «a становится b» означает, что b можно использовать как замену для a.579580> **Примечание**581>582> Все функции вида «a» в этом разделе завершаются ошибкой (более или менее) молча, если выполняемая программа не найдена; замены «b» вместо этого возбуждают [`OSError`](https://python-all.ru/3.5/library/exceptions.html#OSError).583>584> Кроме того, замены, использующие [`check_output()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.check_output), будут завершаться ошибкой с [`CalledProcessError`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError), если запрошенная операция возвращает ненулевой код возврата. Вывод по-прежнему доступен как атрибут [`output`](https://python-all.ru/3.5/library/subprocess.html#subprocess.CalledProcessError.output) возбуждённого исключения.585586В следующих примерах предполагается, что соответствующие функции уже импортированы из модуля [`subprocess`](https://python-all.ru/3.5/library/subprocess.html#module-subprocess).587588### 17.5.6.1. Замена обратных кавычек оболочки /bin/sh589590```bash591output=`mycmd myarg`592```593594становится:595596```python597output = check_output(["mycmd", "myarg"])598```599600### 17.5.6.2. Замена конвейера оболочки601602```bash603output=`dmesg | grep hda`604```605606становится:607608```python609p1 = Popen(["dmesg"], stdout=PIPE)610p2 = Popen(["grep", "hda"], stdin=p1.stdout, stdout=PIPE)611p1.stdout.close()  # Разрешить p1 получать SIGPIPE, если p2 завершается.612output = p2.communicate()[0]613```614615Вызов p1.stdout.close() после запуска p2 важен для того, чтобы p1 получил SIGPIPE, если p2 завершится раньше p1.616617В качестве альтернативы, для доверенного ввода можно по-прежнему напрямую использовать встроенную поддержку конвейеров оболочки:618619```bash620output=`dmesg | grep hda`621```622623становится:624625```python626output=check_output("dmesg | grep hda", shell=True)627```628629### 17.5.6.3. Замена [`os.system()`](https://python-all.ru/3.5/library/os.html#os.system)630631```python632sts = os.system("mycmd" + " myarg")633# становится634sts = call("mycmd" + " myarg", shell=True)635```636637Примечания:638639- Вызов программы через оболочку обычно не требуется.640641Более реалистичный пример выглядит так:642643```python644try:645    retcode = call("mycmd" + " myarg", shell=True)646    if retcode < 0:647        print("Child was terminated by signal", -retcode, file=sys.stderr)648    else:649        print("Child returned", retcode, file=sys.stderr)650except OSError as e:651    print("Execution failed:", e, file=sys.stderr)652```653654### 17.5.6.4. Замена семейства [`os.spawn`](https://python-all.ru/3.5/library/os.html#os.spawnl)655656Пример P\_NOWAIT:657658```python659pid = os.spawnlp(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg")660==>661pid = Popen(["/bin/mycmd", "myarg"]).pid662```663664Пример P\_WAIT:665666```python667retcode = os.spawnlp(os.P_WAIT, "/bin/mycmd", "mycmd", "myarg")668==>669retcode = call(["/bin/mycmd", "myarg"])670```671672Пример с вектором:673674```python675os.spawnvp(os.P_NOWAIT, path, args)676==>677Popen([path] + args[1:])678```679680Пример с окружением:681682```python683os.spawnlpe(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg", env)684==>685Popen(["/bin/mycmd", "myarg"], env={"PATH": "/usr/bin"})686```687688### 17.5.6.5. Замена [`os.popen()`](https://python-all.ru/3.5/library/os.html#os.popen), `os.popen2()`, `os.popen3()`689690```python691(child_stdin, child_stdout) = os.popen2(cmd, mode, bufsize)692==>693p = Popen(cmd, shell=True, bufsize=bufsize,694          stdin=PIPE, stdout=PIPE, close_fds=True)695(child_stdin, child_stdout) = (p.stdin, p.stdout)696```697698```python699(child_stdin,700 child_stdout,701 child_stderr) = os.popen3(cmd, mode, bufsize)702==>703p = Popen(cmd, shell=True, bufsize=bufsize,704          stdin=PIPE, stdout=PIPE, stderr=PIPE, close_fds=True)705(child_stdin,706 child_stdout,707 child_stderr) = (p.stdin, p.stdout, p.stderr)708```709710```python711(child_stdin, child_stdout_and_stderr) = os.popen4(cmd, mode, bufsize)712==>713p = Popen(cmd, shell=True, bufsize=bufsize,714          stdin=PIPE, stdout=PIPE, stderr=STDOUT, close_fds=True)715(child_stdin, child_stdout_and_stderr) = (p.stdin, p.stdout)716```717718Обработка кода возврата выполняется следующим образом:719720```python721pipe = os.popen(cmd, 'w')722...723rc = pipe.close()724if rc is not None and rc >> 8:725    print("There were some errors")726==>727process = Popen(cmd, stdin=PIPE)728...729process.stdin.close()730if process.wait() != 0:731    print("There were some errors")732```733734### 17.5.6.6. Замена функций из модуля `popen2`735736> **Примечание**737>738> Если аргумент cmd функций popen2 является строкой, команда выполняется через /bin/sh. Если это список, команда выполняется напрямую.739740```python741(child_stdout, child_stdin) = popen2.popen2("somestring", bufsize, mode)742==>743p = Popen("somestring", shell=True, bufsize=bufsize,744          stdin=PIPE, stdout=PIPE, close_fds=True)745(child_stdout, child_stdin) = (p.stdout, p.stdin)746```747748```python749(child_stdout, child_stdin) = popen2.popen2(["mycmd", "myarg"], bufsize, mode)750==>751p = Popen(["mycmd", "myarg"], bufsize=bufsize,752          stdin=PIPE, stdout=PIPE, close_fds=True)753(child_stdout, child_stdin) = (p.stdout, p.stdin)754```755756`popen2.Popen3` и `popen2.Popen4` в основном работают как [`subprocess.Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen), за исключением того, что:757758- [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen) вызывает исключение, если выполнение завершается неудачей.759- аргумент *capturestderr* заменён аргументом *stderr*.760- `stdin=PIPE` и `stdout=PIPE` должны быть указаны.761- popen2 по умолчанию закрывает все файловые дескрипторы, но необходимо указать `close_fds=True` с [`Popen`](https://python-all.ru/3.5/library/subprocess.html#subprocess.Popen), чтобы гарантировать такое поведение на всех платформах или в старых версиях Python.762763## 17.5.7. Устаревшие функции вызова оболочки764765Этот модуль также предоставляет следующие устаревшие функции из модуля `commands` версии 2.x. Эти операции неявно вызывают системную оболочку, и ни одно из описанных выше гарантий безопасности и согласованности обработки исключений не действует для этих функций.766767#### `subprocess.getstatusoutput(cmd)`768769Возвращает `(status, output)` выполнения *cmd* в оболочке.770771Выполняет строку *cmd* в оболочке с `Popen.check_output()` и возвращает кортеж из двух элементов `(status, output)`. Используется режим универсальных новых строк; см. примечания к [Часто используемые аргументы](https://python-all.ru/3.5/library/subprocess.html#frequently-used-arguments) для подробностей.772773Конечный символ новой строки удаляется из вывода. Статус выхода команды можно интерпретировать в соответствии с правилами для функции C `wait()`. Пример:774775```python776>>> subprocess.getstatusoutput('ls /bin/ls')777(0, '/bin/ls')778>>> subprocess.getstatusoutput('cat /bin/junk')779(256, 'cat: /bin/junk: No such file or directory')780>>> subprocess.getstatusoutput('/bin/junk')781(256, 'sh: /bin/junk: not found')782```783784Доступность: POSIX и Windows785786Изменено в версии 3.3.4: Добавлена поддержка Windows787788#### `subprocess.getoutput(cmd)`789790Возвращает вывод (stdout и stderr) выполнения *cmd* в оболочке.791792Как [`getstatusoutput()`](https://python-all.ru/3.5/library/subprocess.html#subprocess.getstatusoutput), за исключением того, что статус выхода игнорируется, а возвращаемое значение – строка, содержащая вывод команды. Пример:793794```python795>>> subprocess.getoutput('ls /bin/ls')796'/bin/ls'797```798799Доступность: POSIX и Windows800801Изменено в версии 3.3.4: Добавлена поддержка Windows802803## 17.5.8. Примечания804805### 17.5.8.1. Преобразование последовательности аргументов в строку в Windows806807В Windows последовательность *args* преобразуется в строку, которая может быть разобрана с помощью следующих правил (которые соответствуют правилам, используемым в MS C runtime):8088091. Аргументы разделяются пробельными символами, то есть пробелом или табуляцией.8102. Строка, заключённая в двойные кавычки, интерпретируется как один аргумент, независимо от пробельных символов внутри неё. Строка в кавычках может быть встроена в аргумент.8113. Двойная кавычка, перед которой стоит обратная косая черта, интерпретируется как литеральная двойная кавычка.8124. Обратные косые черты интерпретируются буквально, если только они не стоят непосредственно перед двойной кавычкой.8135. Если обратные косые черты стоят непосредственно перед двойной кавычкой, каждая пара обратных косых черт интерпретируется как литеральная обратная косая черта. Если количество обратных косых черт нечётное, последняя обратная косая черта экранирует следующую за ней двойную кавычку, как описано в правиле 3.814815> **См. также**816>817> **[`shlex`](https://python-all.ru/3.5/library/shlex.html#module-shlex)**818>819> Модуль, предоставляющий функцию для разбора и экранирования командных строк.820