`subprocess.md`

752 строк · 73.0 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.3/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.3/library/subprocess.html#module-subprocess) – Управление подпроцессами89Модуль [`subprocess`](https://python-all.ru/3.3/library/subprocess.html#module-subprocess) позволяет порождать новые процессы, подключаться к их каналам ввода/вывода/ошибок и получать коды возврата. Этот модуль призван заменить несколько более старых модулей и функций:1011```python12os.system13os.spawn*14```1516Информация о том, как модуль [`subprocess`](https://python-all.ru/3.3/library/subprocess.html#module-subprocess) может использоваться для замены этих модулей и функций, приведена в следующих разделах.1718> **См. также**19>20> [**PEP 324**](https://python-all.ru/3.3/library/subprocess.html) – PEP, предлагающий модуль подпроцесса2122## 17.5.1. Использование модуля [`subprocess`](https://python-all.ru/3.3/library/subprocess.html#module-subprocess)2324Рекомендуемый способ запуска подпроцессов – использовать следующие удобные функции во всех случаях, где они применимы. Для более сложных случаев можно напрямую использовать низкоуровневый интерфейс [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen).2526#### `subprocess.call(args, *, stdin=None, stdout=None, stderr=None, shell=False, timeout=None)`2728Выполняет команду, описанную аргументом *args*. Ожидает завершения команды, затем возвращает атрибут `returncode`.2930Аргументы, перечисленные выше, являются лишь наиболее распространёнными; они описаны ниже в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments) (отсюда использование нотации только ключевых слов в сокращённой сигнатуре). Полная сигнатура функции в значительной степени совпадает с сигнатурой конструктора [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) – эта функция передаёт все указанные аргументы, кроме *timeout*, напрямую этому интерфейсу.3132Аргумент *timeout* передаётся в [`Popen.wait()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.wait). Если время ожидания истекает, дочерний процесс будет убит, после чего ожидание повторяется. Исключение [`TimeoutExpired`](https://python-all.ru/3.3/library/subprocess.html#subprocess.TimeoutExpired) будет возбуждено повторно после завершения дочернего процесса.3334Примеры:3536```python37>>> subprocess.call(["ls", "-l"])3803940>>> subprocess.call("exit 1", shell=True)41142```4344> **Предупреждение**45>46> Вызов системной оболочки с `shell=True` может быть опасен для безопасности, если используется вместе с недоверенными входными данными. Подробнее см. предупреждение в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments).4748> **Примечание**49>50> Не используйте `stdout=PIPE` или `stderr=PIPE` с этой функцией. Поскольку каналы не читаются текущим процессом, дочерний процесс может заблокироваться, если он генерирует достаточно выходных данных для заполнения буфера канала ОС.5152Изменено в версии 3.3: добавлен *timeout*.5354#### `subprocess.check_call(args, *, stdin=None, stdout=None, stderr=None, shell=False, timeout=None)`5556Выполняет команду с аргументами. Ожидает завершения команды. Если код возврата равен нулю, возвращает управление, иначе возбуждает [`CalledProcessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError). Объект [`CalledProcessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError) будет содержать код возврата в атрибуте [`returncode`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError.returncode).5758Аргументы, перечисленные выше, являются лишь наиболее распространёнными; они описаны ниже в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments) (отсюда использование нотации только ключевых слов в сокращённой сигнатуре). Полная сигнатура функции в значительной степени совпадает с сигнатурой конструктора [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) – эта функция передаёт все указанные аргументы, кроме *timeout*, напрямую этому интерфейсу.5960Аргумент *timeout* передаётся в [`Popen.wait()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.wait). Если время ожидания истекает, дочерний процесс будет убит, после чего ожидание повторяется. Исключение [`TimeoutExpired`](https://python-all.ru/3.3/library/subprocess.html#subprocess.TimeoutExpired) будет возбуждено повторно после завершения дочернего процесса.6162Примеры:6364```python65>>> subprocess.check_call(["ls", "-l"])6606768>>> subprocess.check_call("exit 1", shell=True)69Traceback (most recent call last):70   ...71subprocess.CalledProcessError: Command 'exit 1' returned non-zero exit status 172```7374> **Предупреждение**75>76> Вызов системной оболочки с `shell=True` может быть опасен для безопасности, если используется вместе с недоверенными входными данными. Подробнее см. предупреждение в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments).7778> **Примечание**79>80> Не используйте `stdout=PIPE` или `stderr=PIPE` с этой функцией. Поскольку каналы не читаются текущим процессом, дочерний процесс может заблокироваться, если он генерирует достаточно выходных данных для заполнения буфера канала ОС.8182Изменено в версии 3.3: добавлен *timeout*.8384#### `subprocess.check_output(args, *, stdin=None, stderr=None, shell=False, universal_newlines=False, timeout=None)`8586Выполняет команду с аргументами и возвращает её вывод.8788Если код возврата был ненулевым, возбуждается исключение [`CalledProcessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError). Объект [`CalledProcessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError) будет содержать код возврата в атрибуте [`returncode`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError.returncode) и весь вывод в атрибуте [`output`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError.output).8990Аргументы, показанные выше, – это лишь самые распространённые, описанные ниже в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments) (отсюда использование нотации только ключевых слов в сокращённой сигнатуре). Полная сигнатура функции в значительной мере совпадает с сигнатурой конструктора [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) – эта функция передаёт все переданные аргументы, кроме *timeout*, непосредственно через этот интерфейс. Кроме того, *stdout* не допускается в качестве аргумента, так как он используется внутри для сбора вывода от подпроцесса.9192Аргумент *timeout* передаётся в [`Popen.wait()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.wait). Если время ожидания истекает, дочерний процесс будет убит, после чего ожидание повторяется. Исключение [`TimeoutExpired`](https://python-all.ru/3.3/library/subprocess.html#subprocess.TimeoutExpired) будет возбуждено повторно после завершения дочернего процесса.9394Примеры:9596```python97>>> subprocess.check_output(["echo", "Hello World!"])98b'Hello World!\n'99100>>> subprocess.check_output(["echo", "Hello World!"], universal_newlines=True)101'Hello World!\n'102103>>> subprocess.check_output("exit 1", shell=True)104Traceback (most recent call last):105   ...106subprocess.CalledProcessError: Command 'exit 1' returned non-zero exit status 1107```108109По умолчанию эта функция возвращает данные в виде закодированных байтов. Фактическая кодировка выходных данных может зависеть от вызываемой команды, поэтому декодирование в текст часто приходится выполнять на уровне приложения.110111Это поведение можно переопределить, установив *universal\_newlines* в `True`, как описано ниже в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments).112113Чтобы также захватить стандартный поток ошибок в результате, используйте `stderr=subprocess.STDOUT`:114115```python116>>> subprocess.check_output(117...     "ls non_existent_file; exit 0",118...     stderr=subprocess.STDOUT,119...     shell=True)120'ls: non_existent_file: No such file or directory\n'121```122123Новое в версии 3.1.124125> **Предупреждение**126>127> Вызов системной оболочки с `shell=True` может быть опасен для безопасности, если используется вместе с недоверенными входными данными. Подробнее см. предупреждение в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments).128129> **Примечание**130>131> Не используйте `stderr=PIPE` с этой функцией. Поскольку канал не читается текущим процессом, дочерний процесс может заблокироваться, если он генерирует достаточно выходных данных для заполнения буфера канала ОС.132133Изменено в версии 3.3: добавлен *timeout*.134135#### `subprocess.DEVNULL`136137Специальное значение, которое может использоваться в качестве аргумента *stdin*, *stdout* или *stderr* для [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) и указывает, что будет использоваться специальный файл [`os.devnull`](https://python-all.ru/3.3/library/os.html#os.devnull).138139Новое в версии 3.3.140141#### `subprocess.PIPE`142143Специальное значение, которое может использоваться в качестве аргумента *stdin*, *stdout* или *stderr* для [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) и указывает, что должен быть открыт канал к стандартному потоку.144145#### `subprocess.STDOUT`146147Специальное значение, которое может использоваться в качестве аргумента *stderr* для [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) и указывает, что стандартный поток ошибок должен направляться в тот же дескриптор, что и стандартный вывод.148149#### `exception subprocess.SubprocessError`150151Базовый класс для всех остальных исключений из этого модуля.152153Новое в версии 3.3.154155#### `exception subprocess.TimeoutExpired`156157Подкласс [`SubprocessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.SubprocessError), возникающий при истечении тайм-аута в ожидании дочернего процесса.158159#### `cmd`160161Команда, которая использовалась для запуска дочернего процесса.162163#### `timeout`164165Тайм-аут в секундах.166167#### `output`168169Вывод дочернего процесса, если это исключение вызвано [`check_output()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_output). В противном случае – `None`.170171Новое в версии 3.3.172173#### `exception subprocess.CalledProcessError`174175Подкласс [`SubprocessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.SubprocessError), возникающий, когда процесс, запущенный [`check_call()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_call) или [`check_output()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_output), возвращает ненулевой код возврата.176177#### `returncode`178179Код возврата дочернего процесса.180181#### `cmd`182183Команда, которая использовалась для запуска дочернего процесса.184185#### `output`186187Вывод дочернего процесса, если это исключение вызвано [`check_output()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_output). В противном случае – `None`.188189### 17.5.1.1. Часто используемые аргументы190191Для поддержки широкого круга сценариев использования конструктор [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) (и удобные функции) принимают большое количество необязательных аргументов. В большинстве типичных случаев многие из этих аргументов можно смело оставить со значениями по умолчанию. Наиболее часто требуемые аргументы:192193> *args* обязателен для всех вызовов и должен быть строкой или последовательностью аргументов программы. Передача последовательности аргументов, как правило, предпочтительнее, поскольку позволяет модулю позаботиться о необходимом экранировании и кавычках (например, для пробелов в именах файлов). Если передаётся одна строка, то либо *shell* должен быть [`True`](https://python-all.ru/3.3/library/constants.html#True) (см. ниже), либо строка должна просто задавать имя исполняемой программы без указания аргументов.194>195> *stdin*, *stdout* и *stderr* задают дескрипторы стандартного ввода, стандартного вывода и стандартного вывода ошибок выполняемой программы. Допустимые значения: [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), [`DEVNULL`](https://python-all.ru/3.3/library/subprocess.html#subprocess.DEVNULL), существующий файловый дескриптор (положительное целое число), существующий файловый объект и `None`. [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE) означает, что следует создать новый канал к дочернему процессу. [`DEVNULL`](https://python-all.ru/3.3/library/subprocess.html#subprocess.DEVNULL) означает, что будет использоваться специальный файл [`os.devnull`](https://python-all.ru/3.3/library/os.html#os.devnull). При настройках по умолчанию (`None`) перенаправление не происходит; дескрипторы файлов дочернего процесса наследуются от родительского. Кроме того, *stderr* может быть [`STDOUT`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STDOUT), что означает, что данные stderr дочернего процесса должны быть направлены в тот же дескриптор, что и *stdout*.196>197> Если *universal\_newlines* равен `False`, файловые объекты *stdin*, *stdout* и *stderr* открываются как бинарные потоки, и преобразование концов строк не выполняется.198>199> Если *universal\_newlines* равен `True`, эти файловые объекты открываются как текстовые потоки в режиме [*universal newlines*](https://python-all.ru/3.3/glossary.html#term-universal-newlines) с использованием кодировки, возвращаемой [`locale.getpreferredencoding(False)`](https://python-all.ru/3.3/library/locale.html#locale.getpreferredencoding). Для *stdin* символы конца строки `'\n'` во входных данных преобразуются в разделитель строк по умолчанию [`os.linesep`](https://python-all.ru/3.3/library/os.html#os.linesep). Для *stdout* и *stderr* все концы строк в выводе преобразуются в `'\n'`. Дополнительную информацию см. в документации класса [`io.TextIOWrapper`](https://python-all.ru/3.3/library/io.html#io.TextIOWrapper), когда аргумент *newline* его конструктора равен `None`.200>201> > **Примечание**202> >203> > Атрибут newlines файловых объектов [`Popen.stdin`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.stdin), [`Popen.stdout`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.stdout) и [`Popen.stderr`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.stderr) не обновляется методом [`Popen.communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate).204>205> Если *shell* равен `True`, указанная команда будет выполняться через оболочку. Это может быть полезно, если Python используется в первую очередь из-за улучшенного управления потоком выполнения по сравнению с большинством системных оболочек, и при этом нужен удобный доступ к другим возможностям оболочки, таким как конвейеры, маски имён файлов, подстановка переменных окружения и подстановка `~` в домашний каталог пользователя. Однако следует отметить, что сам Python предоставляет реализации многих возможностей, похожих на оболочку (в частности, [`glob`](https://python-all.ru/3.3/library/glob.html#module-glob), [`fnmatch`](https://python-all.ru/3.3/library/fnmatch.html#module-fnmatch), [`os.walk()`](https://python-all.ru/3.3/library/os.html#os.walk), [`os.path.expandvars()`](https://python-all.ru/3.3/library/os.path.html#os.path.expandvars), [`os.path.expanduser()`](https://python-all.ru/3.3/library/os.path.html#os.path.expanduser) и [`shutil`](https://python-all.ru/3.3/library/shutil.html#module-shutil)).206>207> Изменено в версии 3.3: Когда *universal\_newlines* равен `True`, класс использует кодировку [`locale.getpreferredencoding(False)`](https://python-all.ru/3.3/library/locale.html#locale.getpreferredencoding) вместо `locale.getpreferredencoding()`. Подробнее об этом изменении см. в документации класса [`io.TextIOWrapper`](https://python-all.ru/3.3/library/io.html#io.TextIOWrapper).208>209> > **Предупреждение**210> >211> > Выполнение команд оболочки, содержащих непроверенные входные данные из недоверенного источника, делает программу уязвимой к [внедрению в оболочку](https://python-all.ru/3.3/library/subprocess.html) – серьёзной уязвимости безопасности, которая может привести к выполнению произвольных команд. По этой причине использование `shell=True` **настоятельно не рекомендуется** в случаях, когда командная строка формируется из внешних данных:212> >213> > ```python214> > >>> from subprocess import call215> > >>> filename = input("What file would you like to display?\n")216> > What file would you like to display?217> > non_existent; rm -rf / #218> > >>> call("cat " + filename, shell=True) # Ой-ой. Это плохо кончится...219> > ```220> >221> > `shell=False` отключает все функции на основе оболочки, но не подвержен этой уязвимости; обратитесь к примечанию в документации конструктора [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) за полезными советами по настройке `shell=False`.222> >223> > При использовании `shell=True`, [`shlex.quote()`](https://python-all.ru/3.3/library/shlex.html#shlex.quote) может использоваться для правильного экранирования пробелов и метасимволов оболочки в строках, которые будут использоваться для построения команд оболочки.224225Эти параметры, как и все остальные, более подробно описаны в документации конструктора [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen).226227### 17.5.1.2. Конструктор Popen228229Создание и управление процессами в этом модуле осуществляется классом [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen). Он предоставляет большую гибкость, позволяя разработчикам обрабатывать менее распространённые случаи, не охваченные удобными функциями.230231#### `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=())`232233Запускает дочернюю программу в новом процессе. На Unix класс использует поведение, подобное [`os.execvp()`](https://python-all.ru/3.3/library/os.html#os.execvp), для выполнения дочерней программы. На Windows класс использует функцию Windows `CreateProcess()`. Аргументы [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) следующие.234235*args* должен быть последовательностью аргументов программы или отдельной строкой. По умолчанию, если *args* является последовательностью, исполняемая программа – это первый элемент в *args*. Если *args* – строка, интерпретация зависит от платформы и описана ниже. Дополнительные отличия от поведения по умолчанию см. в аргументах *shell* и *executable*. Если не указано иное, рекомендуется передавать *args* как последовательность.236237В Unix, если *args* является строкой, она интерпретируется как имя или путь к выполняемой программе. Однако это можно сделать только в том случае, если программе не передаются аргументы.238239> **Примечание**240>241> [`shlex.split()`](https://python-all.ru/3.3/library/shlex.html#shlex.split) может быть полезен при определении правильной токенизации *args*, особенно в сложных случаях:242>243> ```python244> >>> import shlex, subprocess245> >>> command_line = input()246> /bin/vikings -input eggs.txt -output "spam spam.txt" -cmd "echo '$MONEY'"247> >>> args = shlex.split(command_line)248> >>> print(args)249> ['/bin/vikings', '-input', 'eggs.txt', '-output', 'spam spam.txt', '-cmd', "echo '$MONEY'"]250> >>> p = subprocess.Popen(args) # Успешно!251> ```252>253> Обратите внимание, что опции (такие как *-input*) и аргументы (такие как *eggs.txt*), разделённые пробелами в оболочке, помещаются в отдельные элементы списка, в то время как аргументы, требующие кавычек или обратной косой черты в оболочке (например, имена файлов, содержащие пробелы, или команда *echo*, показанная выше), являются отдельными элементами списка.254255В Windows, если *args* является последовательностью, она будет преобразована в строку способом, описанным в разделе [*Преобразование последовательности аргументов в строку в Windows*](https://python-all.ru/3.3/library/subprocess.html#converting-argument-sequence). Это связано с тем, что базовая функция `CreateProcess()` работает со строками.256257Аргумент *shell* (по умолчанию *False*) указывает, следует ли использовать оболочку в качестве выполняемой программы. Если *shell* равен *True*, рекомендуется передавать *args* в виде строки, а не последовательности.258259В Unix с `shell=True` оболочкой по умолчанию является `/bin/sh`. Если *args* – строка, она задаёт команду для выполнения через оболочку. Это означает, что строка должна быть отформатирована точно так, как если бы она была введена в приглашении оболочки. Сюда входит, например, экранирование кавычками или обратной косой чертой имён файлов с пробелами. Если *args* – последовательность, первый элемент задаёт командную строку, а все дополнительные элементы будут рассматриваться как дополнительные аргументы для самой оболочки. Иными словами, [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) делает эквивалент следующего:260261```python262Popen(['/bin/sh', '-c', args[0], args[1], ...])263```264265В Windows с `shell=True` переменная окружения `COMSPEC` задаёт оболочку по умолчанию. Единственный случай, когда нужно указывать `shell=True` в Windows – это когда команда, которую требуется выполнить, встроена в оболочку (например, **dir** или **copy**). Для запуска пакетного файла или консольного исполняемого файла `shell=True` не требуется.266267> **Предупреждение**268>269> Передача `shell=True` может быть опасна для безопасности при использовании с недоверенными входными данными. Подробнее см. предупреждение в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments).270271*bufsize* будет передан как соответствующий аргумент функции [`open()`](https://python-all.ru/3.3/library/functions.html#open) при создании файловых объектов каналов stdin/stdout/stderr: `0` означает отсутствие буферизации (чтение и запись – один системный вызов, может вернуть меньше данных), `1` означает построчную буферизацию, любое другое положительное значение означает использование буфера приблизительно этого размера. Отрицательное значение bufsize (по умолчанию) означает, что будет использоваться системное значение по умолчанию io.DEFAULT\_BUFFER\_SIZE.272273Изменено в версии 3.3.1: *bufsize* теперь по умолчанию равен -1, чтобы включить буферизацию по умолчанию, как того ожидает большинство кода. В версиях до Python 3.2.4 и 3.3.1 по умолчанию ошибочно использовалось `0`, что означало отсутствие буферизации и допускало короткие чтения. Это было непреднамеренно и не соответствовало поведению Python 2, как ожидал большинство кода.274275Аргумент *executable* задаёт заменяющую программу для выполнения. Он требуется очень редко. Когда `shell=False`, *executable* заменяет программу, указанную в *args*. Однако исходный *args* всё равно передаётся программе. Большинство программ рассматривают программу, указанную в *args*, как имя команды, которое затем может отличаться от фактически выполняемой программы. В Unix имя *args* становится отображаемым именем для исполняемого файла в таких утилитах, как **ps**. Если `shell=True`, в Unix аргумент *executable* задаёт заменяющую оболочку для оболочки по умолчанию `/bin/sh`.276277*stdin*, *stdout* и *stderr* задают файловые дескрипторы стандартного ввода, стандартного вывода и стандартного вывода ошибок выполняемой программы соответственно. Допустимые значения: [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), [`DEVNULL`](https://python-all.ru/3.3/library/subprocess.html#subprocess.DEVNULL), существующий файловый дескриптор (положительное целое число), существующий [*файловый объект*](https://python-all.ru/3.3/glossary.html#term-file-object) и `None`. [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE) означает, что должен быть создан новый канал к дочернему процессу. [`DEVNULL`](https://python-all.ru/3.3/library/subprocess.html#subprocess.DEVNULL) означает, что будет использоваться специальный файл [`os.devnull`](https://python-all.ru/3.3/library/os.html#os.devnull). При настройках по умолчанию `None` перенаправления не происходит; файловые дескрипторы дочернего процесса наследуются от родительского. Кроме того, *stderr* может быть [`STDOUT`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STDOUT), что означает, что данные stderr из приложений должны захватываться в тот же файловый дескриптор, что и stdout.278279Если *preexec\_fn* установлен в вызываемый объект, этот объект будет вызван в дочернем процессе непосредственно перед выполнением дочернего процесса. (только Unix)280281> **Предупреждение**282>283> Параметр *preexec\_fn* небезопасно использовать при наличии потоков в приложении. Дочерний процесс может зависнуть до вызова exec. Если его всё же нужно использовать, пусть он будет тривиальным! Сведите к минимуму количество вызываемых библиотек.284285> **Примечание**286>287> Если нужно изменить окружение для дочернего процесса, используйте параметр *env* вместо изменения в *preexec\_fn*. Параметр *start\_new\_session* может заменить ранее распространённое использование *preexec\_fn* для вызова os.setsid() в дочернем процессе.288289Если *close\_fds* имеет значение true, все файловые дескрипторы, кроме `0`, `1` и `2`, будут закрыты перед выполнением дочернего процесса. (Только Unix). Значение по умолчанию зависит от платформы: на Unix всегда true. На Windows оно равно true, когда *stdin*/*stdout*/*stderr* равны [`None`](https://python-all.ru/3.3/library/constants.html#None), и false в противном случае. На Windows, если *close\_fds* равно true, то дочерний процесс не наследует ни одного дескриптора. Обратите внимание, что в Windows нельзя одновременно установить *close\_fds* в true и перенаправлять стандартные дескрипторы, задавая *stdin*, *stdout* или *stderr*.290291Изменено в версии 3.2: Значение по умолчанию для *close\_fds* было изменено с [`False`](https://python-all.ru/3.3/library/constants.html#False) на описанное выше.292293*pass\_fds* – это необязательная последовательность файловых дескрипторов, которые должны оставаться открытыми между родительским и дочерним процессами. Если задан любой *pass\_fds*, то *close\_fds* принудительно устанавливается в [`True`](https://python-all.ru/3.3/library/constants.html#True). (Только Unix)294295Новое в версии 3.2: Добавлен параметр *pass\_fds*.296297Если *cwd* не равен `None`, функция меняет рабочий каталог на *cwd* перед выполнением дочернего процесса. В частности, функция ищет *executable* (или первый элемент в *args*) относительно *cwd*, если путь к исполняемому файлу является относительным.298299Если *restore\_signals* имеет значение true (по умолчанию), все сигналы, которые Python установил в SIG\_IGN, восстанавливаются до SIG\_DFL в дочернем процессе перед exec. В настоящее время это включает сигналы SIGPIPE, SIGXFZ и SIGXFSZ. (Только Unix)300301Изменено в версии 3.2: Добавлен *restore\_signals*.302303Если *start\_new\_session* имеет значение true, системный вызов setsid() будет выполнен в дочернем процессе перед запуском подпроцесса. (Только Unix)304305Изменено в версии 3.2: добавлен *start\_new\_session*.306307Если *env* не равен `None`, он должен быть отображением, определяющим переменные окружения для нового процесса; они используются вместо поведения по умолчанию, заключающегося в наследовании окружения текущего процесса.308309> **Примечание**310>311> Если задан, то *env* должен предоставлять все переменные, необходимые для выполнения программы. В Windows, для запуска [side-by-side assembly](https://python-all.ru/3.3/library/subprocess.html), указанный *env* **обязан** включать корректный `SystemRoot`.312313Если *universal\_newlines* равен `True`, файловые объекты *stdin*, *stdout* и *stderr* открываются как текстовые потоки в режиме универсальных новых строк, как описано выше в разделе [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments); в противном случае они открываются как двоичные потоки.314315Если указан, *startupinfo* будет объектом [`STARTUPINFO`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO), который передаётся базовой функции `CreateProcess`. *creationflags*, если заданы, могут быть [`CREATE_NEW_CONSOLE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CREATE_NEW_CONSOLE) или [`CREATE_NEW_PROCESS_GROUP`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CREATE_NEW_PROCESS_GROUP) (только Windows).316317Объекты Popen поддерживаются в качестве контекстных менеджеров с помощью оператора [`with`](https://python-all.ru/3.3/reference/compound_stmts.html#with): при выходе стандартные файловые дескрипторы закрываются, и выполняется ожидание завершения процесса.318319```python320with Popen(["ifconfig"], stdout=PIPE) as proc:321    log.write(proc.stdout.read())322```323324Изменено в версии 3.2: добавлена поддержка менеджера контекста.325326### 17.5.1.3. Исключения327328Исключения, возникшие в дочернем процессе до того, как новая программа начала выполнение, будут повторно возбуждены в родительском процессе. Кроме того, объект исключения будет иметь дополнительный атрибут с именем `child_traceback`, представляющий собой строку, содержащую информацию о трассировке с точки зрения дочернего процесса.329330Наиболее часто возбуждаемым исключением является [`OSError`](https://python-all.ru/3.3/library/exceptions.html#OSError). Оно возникает, например, при попытке выполнить несуществующий файл. Приложения должны быть готовы к исключениям [`OSError`](https://python-all.ru/3.3/library/exceptions.html#OSError).331332Исключение [`ValueError`](https://python-all.ru/3.3/library/exceptions.html#ValueError) будет возбуждено, если [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) вызван с недопустимыми аргументами.333334[`check_call()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_call) и [`check_output()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_output) возбудят [`CalledProcessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError), если вызванный процесс вернёт ненулевой код возврата.335336Все функции и методы, принимающие параметр *timeout*, такие как [`call()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.call) и [`Popen.communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate), возбудят [`TimeoutExpired`](https://python-all.ru/3.3/library/subprocess.html#subprocess.TimeoutExpired), если время ожидания истечёт до выхода процесса.337338Все исключения, определённые в этом модуле, наследуются от [`SubprocessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.SubprocessError).339340> Новое в версии 3.3: Был добавлен базовый класс [`SubprocessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.SubprocessError).341342### 17.5.1.4. Безопасность343344В отличие от некоторых других функций popen, данная реализация никогда не вызывает системную оболочку неявно. Это означает, что все символы, включая метасимволы оболочки, можно безопасно передавать дочерним процессам. Очевидно, если оболочка вызывается явно, то приложение отвечает за то, чтобы все пробелы и метасимволы были правильно экранированы.345346## 17.5.2. Объекты Popen347348Экземпляры класса [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) имеют следующие методы:349350#### `Popen.poll()`351352Проверяет, завершился ли дочерний процесс. Устанавливает и возвращает атрибут [`returncode`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.returncode).353354#### `Popen.wait(timeout=None)`355356Ожидает завершения дочернего процесса. Устанавливает и возвращает атрибут [`returncode`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.returncode).357358Если процесс не завершается по истечении *timeout* секунд, возбуждается исключение [`TimeoutExpired`](https://python-all.ru/3.3/library/subprocess.html#subprocess.TimeoutExpired). Это исключение можно безопасно перехватить и повторить ожидание.359360> **Предупреждение**361>362> Это приведёт к взаимоблокировке при использовании `stdout=PIPE` и/или `stderr=PIPE`, если дочерний процесс генерирует достаточно выходных данных для канала, так что он блокируется в ожидании, пока буфер канала ОС сможет принять больше данных. Используйте [`communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate), чтобы избежать этого.363364Изменено в версии 3.3: добавлен *timeout*.365366#### `Popen.communicate(input=None, timeout=None)`367368Взаимодействует с процессом: отправляет данные в stdin. Читает данные из stdout и stderr до достижения конца файла. Ожидает завершения процесса. Необязательный аргумент *input* должен содержать данные для отправки дочернему процессу, или `None`, если данные отправлять не нужно. Тип *input* должен быть bytes или, если *universal\_newlines* был `True`, строкой.369370[`communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate) возвращает кортеж `(stdoutdata, stderrdata)`.371372Обратите внимание: для отправки данных в stdin процесса объект Popen должен быть создан с `stdin=PIPE`. Аналогично, чтобы получить в результирующем кортеже что-либо, кроме `None`, нужно также указать `stdout=PIPE` и/или `stderr=PIPE`.373374Если процесс не завершится через *timeout* секунд, будет возбуждено исключение [`TimeoutExpired`](https://python-all.ru/3.3/library/subprocess.html#subprocess.TimeoutExpired). Перехват этого исключения и повторный вызов communication не приведёт к потере вывода.375376Дочерний процесс не уничтожается по истечении тайм-аута, поэтому для корректной очистки хорошо написанное приложение должно уничтожить дочерний процесс и завершить обмен данными:377378```python379proc = subprocess.Popen(...)380try:381    outs, errs = proc.communicate(timeout=15)382except TimeoutExpired:383    proc.kill()384    outs, errs = proc.communicate()385```386387> **Примечание**388>389> Прочитанные данные буферизуются в памяти, поэтому не используйте этот метод, если размер данных велик или неограничен.390391Изменено в версии 3.3: добавлен *timeout*.392393#### `Popen.send_signal(signal)`394395Отправляет сигнал *signal* дочернему процессу.396397> **Примечание**398>399> В Windows SIGTERM – это псевдоним для [`terminate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.terminate). Сигналы CTRL\_C\_EVENT и CTRL\_BREAK\_EVENT можно отправлять процессам, запущенным с параметром *creationflags*, включающим *CREATE\_NEW\_PROCESS\_GROUP*.400401#### `Popen.terminate()`402403Останавливает дочерний процесс. В ОС POSIX метод отправляет дочернему процессу сигнал SIGTERM. В Windows для остановки дочернего процесса вызывается функция Win32 API `TerminateProcess()`.404405#### `Popen.kill()`406407Завершает дочерний процесс. В ОС POSIX функция отправляет дочернему процессу сигнал SIGKILL. В Windows [`kill()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.kill) – это псевдоним для [`terminate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.terminate).408409Также доступны следующие атрибуты:410411> **Предупреждение**412>413> Используйте [`communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate) вместо [`.stdin.write`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.stdin), [`.stdout.read`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.stdout) или [`.stderr.read`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.stderr), чтобы избежать взаимоблокировок из-за переполнения любого из буферов других каналов ОС, что блокирует дочерний процесс.414415#### `Popen.args`416417Аргумент *args* в том виде, в котором он был передан [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen): последовательность аргументов программы или одна строка.418419Новое в версии 3.3.420421#### `Popen.stdin`422423Если аргумент *stdin* был равен [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), этот атрибут содержит потоковый объект для записи, как возвращаемый функцией [`open()`](https://python-all.ru/3.3/library/functions.html#open). Если аргумент *universal\_newlines* был равен `True`, поток будет текстовым, иначе – байтовым. Если аргумент *stdin* не был равен [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), этот атрибут равен `None`.424425#### `Popen.stdout`426427Если аргумент *stdout* был равен [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), этот атрибут содержит потоковый объект для чтения, как возвращаемый функцией [`open()`](https://python-all.ru/3.3/library/functions.html#open). Чтение из потока даёт вывод дочернего процесса. Если аргумент *universal\_newlines* был равен `True`, поток будет текстовым, иначе – байтовым. Если аргумент *stdout* не был равен [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), этот атрибут равен `None`.428429#### `Popen.stderr`430431Если аргумент *stderr* был равен [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), этот атрибут содержит потоковый объект для чтения, как возвращаемый функцией [`open()`](https://python-all.ru/3.3/library/functions.html#open). Чтение из потока даёт вывод ошибок дочернего процесса. Если аргумент *universal\_newlines* был равен `True`, поток будет текстовым, иначе – байтовым. Если аргумент *stderr* не был равен [`PIPE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.PIPE), этот атрибут равен `None`.432433#### `Popen.pid`434435PID дочернего процесса.436437Обратите внимание: если установить аргумент *shell* в значение `True`, то это будет идентификатор процесса запущенной оболочки.438439#### `Popen.returncode`440441Код возврата дочернего процесса, устанавливаемый методами [`poll()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.poll) и [`wait()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.wait) (а косвенно и [`communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate)). Значение `None` указывает, что процесс ещё не завершён.442443Отрицательное значение `-N` означает, что дочерний процесс был завершён сигналом `N` (только в Unix).444445## 17.5.3. Вспомогательные средства Popen для Windows446447Класс [`STARTUPINFO`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO) и следующие константы доступны только в Windows.448449#### `class subprocess.STARTUPINFO`450451Частичная поддержка структуры Windows [STARTUPINFO](https://python-all.ru/3.3/library/subprocess.html) используется при создании [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen).452453#### `dwFlags`454455Битовое поле, определяющее, используются ли некоторые атрибуты структуры [`STARTUPINFO`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO) при создании окна процесса.456457```python458si = subprocess.STARTUPINFO()459si.dwFlags = subprocess.STARTF_USESTDHANDLES | subprocess.STARTF_USESHOWWINDOW460```461462#### `hStdInput`463464Если в [`dwFlags`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указан флаг [`STARTF_USESTDHANDLES`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTF_USESTDHANDLES), этот атрибут является дескриптором стандартного ввода процесса. Если [`STARTF_USESTDHANDLES`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTF_USESTDHANDLES) не указан, по умолчанию для стандартного ввода используется буфер клавиатуры.465466#### `hStdOutput`467468Если в [`dwFlags`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указан флаг [`STARTF_USESTDHANDLES`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTF_USESTDHANDLES), этот атрибут является дескриптором стандартного вывода процесса. В противном случае этот атрибут игнорируется, и по умолчанию для стандартного вывода используется буфер окна консоли.469470#### `hStdError`471472If [`dwFlags`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) specifies [`STARTF_USESTDHANDLES`](https://python-all.ru/3.3/library/subprocess.html#subprocess.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.473474#### `wShowWindow`475476Если в [`dwFlags`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.dwFlags) указан флаг [`STARTF_USESHOWWINDOW`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTF_USESHOWWINDOW), то этот атрибут может принимать любое из значений, допустимых для параметра `nCmdShow` функции [ShowWindow](https://python-all.ru/3.3/library/subprocess.html), за исключением `SW_SHOWDEFAULT`. В противном случае данный атрибут игнорируется.477478Для этого атрибута предусмотрено значение [`SW_HIDE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.SW_HIDE). Оно используется, когда [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) вызывается с параметром `shell=True`.479480### 17.5.3.1. Константы481482Модуль [`подпроцесс`](https://python-all.ru/3.3/library/subprocess.html#module-subprocess) предоставляет следующие константы.483484#### `subprocess.STD_INPUT_HANDLE`485486Устройство стандартного ввода. Изначально это буфер ввода консоли, `CONIN$`.487488#### `subprocess.STD_OUTPUT_HANDLE`489490Устройство стандартного вывода. Изначально это активный экранный буфер консоли, `CONOUT$`.491492#### `subprocess.STD_ERROR_HANDLE`493494Устройство стандартного вывода ошибок. Изначально это активный экранный буфер консоли, `CONOUT$`.495496#### `subprocess.SW_HIDE`497498Скрывает окно. Другое окно будет активировано.499500#### `subprocess.STARTF_USESTDHANDLES`501502Указывает, что атрибуты [`STARTUPINFO.hStdInput`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.hStdInput), [`STARTUPINFO.hStdOutput`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.hStdOutput) и [`STARTUPINFO.hStdError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.hStdError) содержат дополнительную информацию.503504#### `subprocess.STARTF_USESHOWWINDOW`505506Указывает, что атрибут [`STARTUPINFO.wShowWindow`](https://python-all.ru/3.3/library/subprocess.html#subprocess.STARTUPINFO.wShowWindow) содержит дополнительную информацию.507508#### `subprocess.CREATE_NEW_CONSOLE`509510Новый процесс получает новую консоль вместо наследования консоли родителя (по умолчанию).511512Этот флаг всегда устанавливается, когда [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) создаётся с `shell=True`.513514#### `subprocess.CREATE_NEW_PROCESS_GROUP`515516Параметр `creationflags` функции [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen), указывающий, что будет создана новая группа процессов. Этот флаг необходим для использования [`os.kill()`](https://python-all.ru/3.3/library/os.html#os.kill) для подпроцесса.517518Этот флаг игнорируется, если указан [`CREATE_NEW_CONSOLE`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CREATE_NEW_CONSOLE).519520## 17.5.4. Замена старых функций модулем [`подпроцесс`](https://python-all.ru/3.3/library/subprocess.html#module-subprocess)521522В этом разделе «a становится b» означает, что b можно использовать как замену для a.523524> **Примечание**525>526> Все функции «a» в этом разделе при ненахождении исполняемой программы выдают ошибку (более или менее) молча; замены «b» вместо этого возбуждают исключение [`OSError`](https://python-all.ru/3.3/library/exceptions.html#OSError).527>528> Кроме того, замены с использованием [`check_output()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.check_output) завершатся ошибкой с исключением [`CalledProcessError`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError), если запрошенная операция вернёт ненулевой код возврата. Вывод по-прежнему доступен как атрибут [`output`](https://python-all.ru/3.3/library/subprocess.html#subprocess.CalledProcessError.output) возбуждённого исключения.529530В следующих примерах предполагается, что соответствующие функции уже импортированы из модуля [`подпроцесс`](https://python-all.ru/3.3/library/subprocess.html#module-subprocess).531532### 17.5.4.1. Замена обратной кавычки оболочки /bin/sh533534```python535output=`mycmd myarg`536# becomes537output = check_output(["mycmd", "myarg"])538```539540### 17.5.4.2. Замена конвейера оболочки541542```python543output=`dmesg | grep hda`544# becomes545p1 = Popen(["dmesg"], stdout=PIPE)546p2 = Popen(["grep", "hda"], stdin=p1.stdout, stdout=PIPE)547p1.stdout.close()  # Allow p1 to receive a SIGPIPE if p2 exits.548output = p2.communicate()[0]549```550551Вызов p1.stdout.close() после запуска p2 важен для того, чтобы p1 получил SIGPIPE, если p2 завершится раньше p1.552553В качестве альтернативы, для доверенного ввода можно по-прежнему напрямую использовать встроенную поддержку конвейеров оболочки:554555```python556output=`dmesg | grep hda`557# becomes558output=check_output("dmesg | grep hda", shell=True)559```560561### 17.5.4.3. Замена [`os.system()`](https://python-all.ru/3.3/library/os.html#os.system)562563```python564sts = os.system("mycmd" + " myarg")565# становится566sts = call("mycmd" + " myarg", shell=True)567```568569Примечания:570571- Вызов программы через оболочку обычно не требуется.572573Более реалистичный пример выглядит так:574575```python576try:577    retcode = call("mycmd" + " myarg", shell=True)578    if retcode < 0:579        print("Child was terminated by signal", -retcode, file=sys.stderr)580    else:581        print("Child returned", retcode, file=sys.stderr)582except OSError as e:583    print("Execution failed:", e, file=sys.stderr)584```585586### 17.5.4.4. Замена семейства [`os.spawn`](https://python-all.ru/3.3/library/os.html#os.spawnl)587588Пример P\_NOWAIT:589590```python591pid = os.spawnlp(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg")592==>593pid = Popen(["/bin/mycmd", "myarg"]).pid594```595596Пример P\_WAIT:597598```python599retcode = os.spawnlp(os.P_WAIT, "/bin/mycmd", "mycmd", "myarg")600==>601retcode = call(["/bin/mycmd", "myarg"])602```603604Пример с вектором:605606```python607os.spawnvp(os.P_NOWAIT, path, args)608==>609Popen([path] + args[1:])610```611612Пример с окружением:613614```python615os.spawnlpe(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg", env)616==>617Popen(["/bin/mycmd", "myarg"], env={"PATH": "/usr/bin"})618```619620### 17.5.4.5. Замена [`os.popen()`](https://python-all.ru/3.3/library/os.html#os.popen), `os.popen2()`, `os.popen3()`621622```python623(child_stdin, child_stdout) = os.popen2(cmd, mode, bufsize)624==>625p = Popen(cmd, shell=True, bufsize=bufsize,626          stdin=PIPE, stdout=PIPE, close_fds=True)627(child_stdin, child_stdout) = (p.stdin, p.stdout)628```629630```python631(child_stdin,632 child_stdout,633 child_stderr) = os.popen3(cmd, mode, bufsize)634==>635p = Popen(cmd, shell=True, bufsize=bufsize,636          stdin=PIPE, stdout=PIPE, stderr=PIPE, close_fds=True)637(child_stdin,638 child_stdout,639 child_stderr) = (p.stdin, p.stdout, p.stderr)640```641642```python643(child_stdin, child_stdout_and_stderr) = os.popen4(cmd, mode, bufsize)644==>645p = Popen(cmd, shell=True, bufsize=bufsize,646          stdin=PIPE, stdout=PIPE, stderr=STDOUT, close_fds=True)647(child_stdin, child_stdout_and_stderr) = (p.stdin, p.stdout)648```649650Обработка кода возврата выполняется следующим образом:651652```python653pipe = os.popen(cmd, 'w')654...655rc = pipe.close()656if rc is not None and rc >> 8:657    print("There were some errors")658==>659process = Popen(cmd, 'w', stdin=PIPE)660...661process.stdin.close()662if process.wait() != 0:663    print("There were some errors")664```665666### 17.5.4.6. Замена функций из модуля `popen2`667668> **Примечание**669>670> Если аргумент cmd функций popen2 является строкой, команда выполняется через /bin/sh. Если это список, команда выполняется напрямую.671672```python673(child_stdout, child_stdin) = popen2.popen2("somestring", bufsize, mode)674==>675p = Popen(["somestring"], shell=True, bufsize=bufsize,676          stdin=PIPE, stdout=PIPE, close_fds=True)677(child_stdout, child_stdin) = (p.stdout, p.stdin)678```679680```python681(child_stdout, child_stdin) = popen2.popen2(["mycmd", "myarg"], bufsize, mode)682==>683p = Popen(["mycmd", "myarg"], bufsize=bufsize,684          stdin=PIPE, stdout=PIPE, close_fds=True)685(child_stdout, child_stdin) = (p.stdout, p.stdin)686```687688`popen2.Popen3` и `popen2.Popen4` в основном работают как [`subprocess.Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen), за исключением того, что:689690- [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) возбуждает исключение, если выполнение завершается неудачей.691- аргумент *capturestderr* заменён аргументом *stderr*.692- Необходимо указать `stdin=PIPE` и `stdout=PIPE`.693- popen2 по умолчанию закрывает все файловые дескрипторы, но для гарантии такого поведения на всех платформах или в старых версиях Python необходимо указать `close_fds=True` вместе с [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen).694695## 17.5.5. Устаревшие функции вызова оболочки696697Этот модуль также предоставляет следующие устаревшие функции из модуля `commands` версии 2.x. Эти операции неявно вызывают системную оболочку, и ни одно из описанных выше гарантий безопасности и согласованности обработки исключений для этих функций не действует.698699#### `subprocess.getstatusoutput(cmd)`700701Возвращает `(status, output)` выполнения *cmd* в оболочке.702703Выполняет строку *cmd* в оболочке с помощью [`Popen`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen) и возвращает кортеж из двух элементов `(status, output)` через [`Popen.communicate()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.Popen.communicate). Используется режим универсальных новых строк; подробнее см. в примечаниях к [*Часто используемые аргументы*](https://python-all.ru/3.3/library/subprocess.html#frequently-used-arguments).704705Завершающий символ новой строки удаляется из вывода. Код возврата команды можно интерпретировать по правилам для C-функции `wait()`. Пример:706707```python708>>> subprocess.getstatusoutput('ls /bin/ls')709(0, '/bin/ls')710>>> subprocess.getstatusoutput('cat /bin/junk')711(256, 'cat: /bin/junk: No such file or directory')712>>> subprocess.getstatusoutput('/bin/junk')713(256, 'sh: /bin/junk: not found')714```715716Доступность: Unix и Windows717718Изменено в версии 3.3.4: Добавлена поддержка Windows719720#### `subprocess.getoutput(cmd)`721722Возвращает вывод (stdout и stderr) выполнения *cmd* в оболочке.723724Аналогично [`getstatusoutput()`](https://python-all.ru/3.3/library/subprocess.html#subprocess.getstatusoutput), за исключением того, что код возврата игнорируется, а возвращаемое значение – строка, содержащая вывод команды. Пример:725726```python727>>> subprocess.getoutput('ls /bin/ls')728'/bin/ls'729```730731Доступность: Unix и Windows732733Изменено в версии 3.3.4: Добавлена поддержка Windows734735## 17.5.6. Примечания736737### 17.5.6.1. Преобразование последовательности аргументов в строку в Windows738739В Windows последовательность *args* преобразуется в строку, которая может быть разобрана с помощью следующих правил (которые соответствуют правилам, используемым в MS C runtime):7407411. Аргументы разделяются пробельными символами, то есть пробелом или табуляцией.7422. Строка, заключённая в двойные кавычки, интерпретируется как один аргумент, независимо от пробельных символов внутри неё. Строка в кавычках может быть встроена в аргумент.7433. Двойная кавычка, перед которой стоит обратная косая черта, интерпретируется как литеральная двойная кавычка.7444. Обратные косые черты интерпретируются буквально, если только они не стоят непосредственно перед двойной кавычкой.7455. Если обратные косые черты стоят непосредственно перед двойной кавычкой, каждая пара обратных косых черт интерпретируется как литеральная обратная косая черта. Если количество обратных косых черт нечётное, последняя обратная косая черта экранирует следующую за ней двойную кавычку, как описано в правиле 3.746747> **См. также**748>749> **[`shlex`](https://python-all.ru/3.3/library/shlex.html#module-shlex)**750>751> Модуль, предоставляющий функцию для разбора и экранирования командных строк.752