subprocess — Управление дочерними процессами

Часто используемые аргументы

Для поддержки широкого круга вариантов использования конструктор Popen (и вспомогательные функции) принимают большое количество необязательных аргументов. Для большинства типичных случаев использования многие из этих аргументов можно безопасно оставить по умолчанию. Аргументы, которые чаще всего необходимы:

args требуется для всех вызовов и должен быть строкой или последовательностью аргументов программы. Передача последовательности аргументов обычно предпочтительнее, так как это позволяет модулю позаботиться о необходимой экранировке и цитировании аргументов (например, чтобы разрешить пробелы в именах файлов). Если передается одиночная строка, либо shell должен быть True (см. ниже), либо же строка должна просто называть программу для выполнения без указания каких-либо аргументов.

stdin, stdout и stderr указывают соответственно стандартный ввод, стандартный вывод и стандартную ошибку выполняемой программы. Допустимые значения — PIPE, DEVNULL, существующий дескриптор файла (положительное целое число), существующий объект файла с действительным дескриптором файла и None. PIPE указывает на создание нового канала связи с дочерним процессом. DEVNULL указывает, что будет использован специальный файл os.devnull. При стандартных настройках None, перенаправления не будет; дескрипторы файлов дочернего процесса будут унаследованы от родительского. Кроме того, stderr может быть STDOUT, что указывает на то, что данные stderr дочернего процесса должны быть захвачены в тот же файловый дескриптор, что и stdout.

Если указаны encoding или errors, или text (также известное как universal_newlines) истинно, объекты файлов stdin, stdout и stderr будут открыты в текстовом режиме с использованием указанных в вызове encoding и errors или по умолчанию для io.TextIOWrapper.

Для stdin символы конца строки '\n' во входных данных будут преобразованы в разделитель строк по умолчанию os.linesep. Для stdout и stderr все символы конца строки в выводе будут преобразованы в '\n'. Дополнительную информацию см. в документации класса io.TextIOWrapper, когда аргумент newline конструктора принимает значение None.

Если текстовый режим не используется, stdin, stdout и stderr будут открыты как двоичные потоки. Преобразование кодировки или символов конца строки не выполняется.

Если shell True, указанная команда будет выполнена через оболочку. Это может быть полезно, если вы используете Python в основном для улучшенного управления потоком, по сравнению с большинством системных оболочек, и всё ещё хотите получить удобный доступ к другим функциям оболочки, таким как каналы оболочки, подстановка имен файлов, расширение переменных среды и расширение ~ до домашнего каталога пользователя. Однако обратите внимание, что сам Python предлагает реализации многих функций, подобных оболочке (в частности, glob, fnmatch, os.walk(), os.path.expandvars(), os.path.expanduser() и shutil).

Эти параметры, а также все остальные, описаны более подробно в документации конструктора Popen.

Конструктор Popen

Поддержка создания и управления процессами в этом модуле осуществляется классом Popen. Он предлагает значительную гибкость, чтобы разработчики могли обрабатывать менее распространенные случаи, не охваченные вспомогательными функциями.

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=None, startupinfo=None, creationflags=0, restore_signals=True, start_new_session=False, pass_fds=(), *, group=None, extra_groups=None, user=None, umask=-1, encoding=None, errors=None, text=None)

Выполнить дочернюю программу в новом процессе. В POSIX, класс использует поведение, подобное os.execvp(), для выполнения дочерней программы. В Windows, класс использует функцию Windows CreateProcess(). Аргументы для Popen следующие.

args должно быть последовательностью аргументов программы, либо одной строкой или объектом, подобным пути. По умолчанию, программа для выполнения — это первый элемент в args, если args является последовательностью. Если args является строкой, интерпретация зависит от платформы и описана ниже. См. аргументы shell и executable для дополнительных различий с поведением по умолчанию. Если не указано иное, рекомендуется передавать args как последовательность.

Пример передачи некоторых аргументов внешней программе как последовательности:

Popen(["/usr/bin/git", "commit", "-m", "Fixes a bug."])

В POSIX, если args является строкой, строка интерпретируется как имя или путь к программе для выполнения. Однако, это возможно только если не передаются аргументы программе.

Примечание

Может быть не очевидно, как разбить командную строку на последовательность аргументов, особенно в сложных случаях. shlex.split() может проиллюстрировать, как определить правильную токенизацию для args:

>>> import shlex, subprocess
>>> command_line = input()
/bin/vikings -input eggs.txt -output "spam spam.txt" -cmd "echo '$MONEY'"
>>> args = shlex.split(command_line)
>>> print(args)
['/bin/vikings', '-input', 'eggs.txt', '-output', 'spam spam.txt', '-cmd', "echo '$MONEY'"]
>>> p = subprocess.Popen(args) # Success!

Обратите внимание, что опции (такие как -input) и аргументы (такие как eggs.txt), разделенные пробелами в командной строке, попадают в отдельные элементы списка, в то время как аргументы, требующие кавычек или экранирования обратной косой чертой при использовании в командной строке (например, имена файлов с пробелами или команда echo, показанная выше), являются отдельными элементами списка.

В Windows, если args является последовательностью, она будет преобразована в строку способом, описанным в Преобразование последовательности аргументов в строку в Windows. Это потому, что базовая CreateProcess() работает со строками.

Изменено в версии 3.6: Параметр args принимает объект, подобный пути, если shell является False и последовательность, содержащую объекты, подобные пути, в POSIX.

Изменено в версии 3.8: Параметр args принимает объект, подобный пути, если shell является False и последовательность, содержащую байты и объекты, подобные пути, в Windows.

Аргумент shell (который по умолчанию False указывает, использовать ли оболочку как программу для выполнения. Если shell является True, рекомендуется передавать args как строку, а не как последовательность.

В POSIX с shell=True, оболочка по умолчанию /bin/sh. Если args является строкой, строка задаёт команду для выполнения через оболочку. Это означает, что строка должна быть отформатирована точно так же, как она вводилась бы в командной строке. Это включает, например, кавычки или экранирование обратной косой чертой имён файлов с пробелами в них. Если args является последовательностью, первый элемент задаёт строку команды, а все дополнительные элементы будут обрабатываться как дополнительные аргументы самой оболочке. Это означает, что Popen делает эквивалент:

Popen(['/bin/sh', '-c', args[0], args[1], ...])

В Windows с shell=True, переменная среды COMSPEC задаёт оболочку по умолчанию. Единственный случай, когда необходимо указывать shell=True в Windows — это когда команда, которую вы хотите выполнить, встроена в оболочку (например, dir или copy). Вам не нужно shell=True для запуска пакетного файла или консольной исполняемой программы.

Примечание

Прочитайте раздел Рекомендации по безопасности перед использованием shell=True.

bufsize будет передан соответствующим аргументом функции open() при создании объектов файлов stdin/stdout/stderr:

• 0 означает небуферизованный (чтение и запись — одно системное вызов и могут вернуть короткий результат)
• 1 означает буферизованный по строкам (только если universal_newlines=True т.е. в текстовом режиме)
• любое другое положительное значение означает использование буфера приблизительно этого размера
• отрицательное значение bufsize (по умолчанию) означает использование системного значения io.DEFAULT_BUFFER_SIZE.

Изменено в версии 3.3.1: bufsize теперь по умолчанию равен -1, чтобы включить буферизацию по умолчанию, что соответствует поведению, ожидаемому большинством кода. В версиях до Python 3.2.4 и 3.3.1 он неправильно по умолчанию был 0, что было небуферизованно и позволяло короткие чтения. Это было непреднамеренным и не соответствовало поведению Python 2, как ожидалось большинством кода.

Аргумент executable задаёт заменяемую программу для выполнения. Он крайне редко используется. Когда shell=False, executable заменяет программу для выполнения, указанную параметром args. Однако, исходное args всё ещё передаётся программе. Большинство программ обрабатывают программу, указанную args, как имя команды, что может отличаться от фактически исполняемой программы. В POSIX, имя args становится отображаемым именем исполняемой программы в таких утилитах, как ps. Если shell=True, в POSIX аргумент executable указывает заменяемую оболочку для стандартной /bin/sh.

Изменено в версии 3.6: Параметр executable принимает объект, подобный пути в POSIX.

Изменено в версии 3.8: Параметр executable принимает байты и объекты, подобные пути в Windows.

stdin, stdout и stderr задают стандартный ввод, стандартный вывод и стандартную ошибку исполняемой программы, соответственно. Допустимые значения — PIPE, DEVNULL, существующий дескриптор файла (положительное целое число), существующий объект файла с допустимым дескриптором файла и None. PIPE указывает, что должна быть создана новая труба для дочернего процесса. DEVNULL указывает, что будет использован специальный файл os.devnull. При настройках по умолчанию None, перенаправления не будет; дескрипторы файлов дочернего процесса будут унаследованы от родительского. Кроме того, stderr может быть STDOUT, что означает, что данные stderr приложения должны быть захвачены в тот же дескриптор файла, что и stdout.

Если preexec_fn задан как вызываемый объект, этот объект будет вызван в дочернем процессе непосредственно перед выполнением дочернего процесса. (Только POSIX)

Предупреждение

Параметр preexec_fn не безопасен для использования при наличии потоков в вашем приложении. Дочерний процесс может заблокироваться до вызова exec. Если вам необходимо его использовать, сделайте его простым! Минимизируйте количество используемых библиотек.

Примечание

Если вам нужно изменить среду для дочернего процесса, используйте параметр env, а не делайте это в preexec_fn. Параметр start_new_session может заменить ранее часто используемый preexec_fn для вызова os.setsid() в дочернем процессе.

Изменено в версии 3.8: Параметр preexec_fn больше не поддерживается в подинтерпретаторах. Использование параметра в подинтерпретаторе вызывает RuntimeError. Новое ограничение может повлиять на приложения, развернутые в mod_wsgi, uWSGI и других встроенных средах.

Если close_fds равно true, все дескрипторы файлов, кроме 0, 1 и 2, будут закрыты перед выполнением дочернего процесса. В противном случае, когда close_fds равно false, дескрипторы файлов следуют своему флагу наследуемости, как описано в Наследование дескрипторов файлов.

В Windows, если close_fds равно true, никакие дескрипторы не будут унаследованы дочерним процессом, если не указаны явно в элементе handle_list STARTUPINFO.lpAttributeList или стандартным перенаправлением дескрипторов.

Изменено в версии 3.2: Значение по умолчанию для close_fds было изменено с False на то, что описано выше.

Изменено в версии 3.7: В Windows, значение по умолчанию для close_fds было изменено с False на True при перенаправлении стандартных дескрипторов. Теперь можно установить close_fds на True при перенаправлении стандартных дескрипторов.

pass_fds — это необязательная последовательность дескрипторов файлов, которые должны оставаться открытыми между родительским и дочерним процессами. Передача pass_fds приводит к тому, что close_fds становится True. (Только POSIX)

Изменено в версии 3.2: Параметр pass_fds был добавлен.

Если cwd не None, функция изменяет рабочую директорию на cwd перед выполнением дочернего процесса. cwd может быть строкой, байтовым объектом или объектом, подобным пути. В частности, функция ищет executable (или первый элемент в args) относительно cwd, если путь к исполняемому файлу — относительный.

Изменено в версии 3.6: Параметр cwd принимает объект, подобный пути на POSIX.

Изменено в версии 3.7: Параметр cwd принимает объект, подобный пути на Windows.

Изменено в версии 3.8: Параметр cwd принимает байтовый объект на Windows.

Если restore_signals имеет значение true (по умолчанию), все сигналы, которые Python установил в SIG_IGN, восстанавливаются в SIG_DFL в дочернем процессе перед exec. В настоящее время это включает сигналы SIGPIPE, SIGXFZ и SIGXFSZ. (Только POSIX)

Изменено в версии 3.2: Добавлен restore_signals.

Если start_new_session имеет значение true, вызов системной функции setsid() будет выполнен в дочернем процессе перед выполнением подпроцесса. (Только POSIX)

Изменено в версии 3.2: Добавлен start_new_session.

Если group не None, вызов системной функции setregid() будет выполнен в дочернем процессе перед выполнением подпроцесса. Если предоставленное значение является строкой, оно будет найдено с помощью grp.getgrnam(), и будет использовано значение в gr_gid. Если значение является целым числом, оно будет передано без изменений. (Только POSIX)

Доступность: POSIX

Новое в версии 3.9.

Если extra_groups не None, вызов системной функции setgroups() будет выполнен в дочернем процессе перед выполнением подпроцесса. Строковые значения в extra_groups будут найдены с помощью grp.getgrnam(), и значения в gr_gid будут использованы. Целочисленные значения будут переданы без изменений. (Только POSIX)

Доступность: POSIX

Новое в версии 3.9.

Если user не None, вызов системной функции setreuid() будет выполнен в дочернем процессе перед выполнением подпроцесса. Если предоставленное значение является строкой, оно будет найдено с помощью pwd.getpwnam(), и будет использовано значение в pw_uid. Если значение является целым числом, оно будет передано без изменений. (Только POSIX)

Доступность: POSIX

Новое в версии 3.9.

Если umask не отрицательное значение, вызов системной функции umask() будет выполнен в дочернем процессе перед выполнением подпроцесса.

Доступность: POSIX

Новое в версии 3.9.

Если env не None, это должно быть отображение, определяющее переменные среды для нового процесса; они используются вместо стандартного поведения наследования среды текущего процесса.

Примечание

Если указано, env должен предоставить все переменные, необходимые для выполнения программы. В Windows, для запуска side-by-side assembly указанное env обязательно должно включать корректную SystemRoot.

Если указаны encoding или errors, или text имеет значение true, объекты файлов stdin, stdout и stderr открываются в текстовом режиме с указанным кодированием и errors, как описано выше в Часто используемые аргументы. Аргумент universal_newlines эквивалентен text и предоставляется для обратной совместимости. По умолчанию объекты файлов открываются в двоичном режиме.

Новое в версии 3.6: Были добавлены encoding и errors.

Новое в версии 3.7: Добавлен text как более удобочитаемый псевдоним для universal_newlines.

Если задано, startupinfo будет объектом STARTUPINFO, который передаётся в функцию CreateProcess. creationflags, если задано, может быть одним или несколькими из следующих флагов:

• CREATE_NEW_CONSOLE
• CREATE_NEW_PROCESS_GROUP
• ABOVE_NORMAL_PRIORITY_CLASS
• BELOW_NORMAL_PRIORITY_CLASS
• HIGH_PRIORITY_CLASS
• IDLE_PRIORITY_CLASS
• NORMAL_PRIORITY_CLASS
• REALTIME_PRIORITY_CLASS
• CREATE_NO_WINDOW
• DETACHED_PROCESS
• CREATE_DEFAULT_ERROR_MODE
• CREATE_BREAKAWAY_FROM_JOB

Объекты Popen поддерживаются как менеджеры контекста с помощью оператора with: при выходе стандартные дескрипторы файлов закрываются, и процесс ожидает завершения.

with Popen(["ifconfig"], stdout=PIPE) as proc:
    log.write(proc.stdout.read())

Объекты Popen и другие функции в этом модуле, использующие его, генерируют событие аудита аудита subprocess.Popen с аргументами executable, args, cwd, и env. Значение для args может быть строкой или списком строк в зависимости от платформы.

Изменено в версии 3.2: Добавлена поддержка менеджера контекста.

Изменено в версии 3.6: Деструктор Popen теперь генерирует предупреждение ResourceWarning, если дочерний процесс всё ещё работает.

Изменено в версии 3.8: Popen может использовать os.posix_spawn() в некоторых случаях для повышения производительности. В Windows Subsystem for Linux и QEMU User Emulation конструктор Popen, использующий os.posix_spawn(), больше не генерирует исключение при ошибках, таких как отсутствие программы, но дочерний процесс завершается с ненулевым returncode.

Исключения

Исключения, поднятые в дочернем процессе, прежде чем новая программа начнет выполняться, будут повторно подняты в родительском процессе.

Наиболее распространённое исключение — OSError. Оно возникает, например, при попытке выполнить несуществующий файл. Приложения должны быть готовы к исключениям OSError. Обратите внимание, что, когда shell=True, OSError будет поднято дочерним процессом только в том случае, если выбранная оболочка сама по себе не найдена. Чтобы определить, не смогла ли оболочка найти запрашиваемое приложение, необходимо проверить код возврата или вывод из подпроцесса.

Исключение ValueError будет поднято, если Popen вызван с недопустимыми аргументами.

check_call() и check_output() поднимут исключение CalledProcessError, если вызванный процесс вернёт код возврата, отличный от нуля.

Все функции и методы, принимающие параметр timeout, такие как call() и Popen.communicate(), поднимут исключение TimeoutExpired, если таймаут истечёт, прежде чем процесс завершит работу.

Все исключения, определённые в этом модуле, наследуются от SubprocessError.

Константы Windows

Модуль subprocess предоставляет следующие константы.

subprocess.STD_INPUT_HANDLE

Устройство стандартного ввода. Изначально это буфер ввода консоли, CONIN$.

subprocess.STD_OUTPUT_HANDLE

Устройство стандартного вывода. Изначально это активный буфер экрана консоли, CONOUT$.

subprocess.STD_ERROR_HANDLE

Устройство стандартной ошибки. Изначально это активный буфер экрана консоли, CONOUT$.

subprocess.SW_HIDE

Скрывает окно. Будет активировано другое окно.

subprocess.STARTF_USESTDHANDLES

Указывает, что атрибуты STARTUPINFO.hStdInput, STARTUPINFO.hStdOutput и STARTUPINFO.hStdError содержат дополнительную информацию.

subprocess.STARTF_USESHOWWINDOW

Указывает, что атрибут STARTUPINFO.wShowWindow содержит дополнительную информацию.

subprocess.CREATE_NEW_CONSOLE

Новый процесс получает новую консоль вместо наследования консоли родительского процесса (по умолчанию).

subprocess.CREATE_NEW_PROCESS_GROUP

Параметр для Popen, указывающий на создание новой группы процессов. Этот флаг необходим для использования os.kill() в дочернем процессе.

Этот флаг игнорируется, если указан CREATE_NEW_CONSOLE.

subprocess.ABOVE_NORMAL_PRIORITY_CLASS

Параметр для Popen, указывающий на более высокий приоритет нового процесса.

Добавлена в версии 3.7.

subprocess.BELOW_NORMAL_PRIORITY_CLASS

Параметр для Popen, указывающий на более низкий приоритет нового процесса.

Добавлена в версии 3.7.

subprocess.HIGH_PRIORITY_CLASS

Параметр для Popen, указывающий на высокий приоритет нового процесса.

Добавлена в версии 3.7.

subprocess.IDLE_PRIORITY_CLASS

Параметр для Popen, указывающий на низкий приоритет нового процесса.

Добавлена в версии 3.7.

subprocess.NORMAL_PRIORITY_CLASS

Параметр для Popen, указывающий на нормальный приоритет нового процесса (по умолчанию).

Добавлена в версии 3.7.

subprocess.REALTIME_PRIORITY_CLASS

Параметр для Popen, указывающий на приоритет реального времени нового процесса. Рекомендуется избегать использования REALTIME_PRIORITY_CLASS, так как это может привести к прерыванию системных потоков, управляющих вводом мыши, клавиатуры и кэшированием данных. Данный класс может быть подходящим для приложений, взаимодействующих напрямую с оборудованием или выполняющих кратковременные задачи, которые должны иметь ограниченное прерывание.

Добавлена в версии 3.7.

subprocess.CREATE_NO_WINDOW

Параметр для Popen, указывающий на отсутствие создания окна новым процессом.

Добавлена в версии 3.7.

subprocess.DETACHED_PROCESS

Параметр для Popen, указывающий на отсутствие наследования консоли родительского процесса новым процессом. Не может быть использовано вместе с CREATE_NEW_CONSOLE.

Добавлена в версии 3.7.

subprocess.CREATE_DEFAULT_ERROR_MODE

Параметр для Popen, указывающий на отсутствие наследования режима ошибок вызывающим процессом. Вместо этого новый процесс получает режим ошибок по умолчанию. Эта функция особенно полезна для многопоточных оболочек приложений, которые работают с отключенными ошибками.

Добавлена в версии 3.7.

subprocess.CREATE_BREAKAWAY_FROM_JOB

Параметр для Popen, указывающий на отсутствие связи нового процесса с задачей.

Добавлена в версии 3.7.

Замена подстановки командной оболочки /bin/sh

output=$(mycmd myarg)

становится:

output = check_output(["mycmd", "myarg"])

Замена конвейера оболочки

output=$(dmesg | grep hda)

становится:

p1 = Popen(["dmesg"], stdout=PIPE)
p2 = Popen(["grep", "hda"], stdin=p1.stdout, stdout=PIPE)
p1.stdout.close()  # Allow p1 to receive a SIGPIPE if p2 exits.
output = p2.communicate()[0]

Вызов p1.stdout.close() после запуска p2 важен, чтобы p1 получил SIGPIPE, если p2 завершится до p1.

В качестве альтернативы, для надёжного ввода, собственная поддержка конвейера оболочки всё ещё может быть использована напрямую:

output=$(dmesg | grep hda)

становится:

output=check_output("dmesg | grep hda", shell=True)

Замена os.system()

sts = os.system("mycmd" + " myarg")
# becomes
retcode = call("mycmd" + " myarg", shell=True)

Примечания:

• Вызов программы через оболочку обычно не требуется.
• Значение возврата call() закодировано иначе, чем значение возврата os.system().
• Функция os.system() игнорирует сигналы SIGINT и SIGQUIT во время выполнения команды, но вызывающая сторона должна сделать это отдельно при использовании модуля subprocess.

Более реалистичный пример выглядит так:

try:
    retcode = call("mycmd" + " myarg", shell=True)
    if retcode < 0:
        print("Child was terminated by signal", -retcode, file=sys.stderr)
    else:
        print("Child returned", retcode, file=sys.stderr)
except OSError as e:
    print("Execution failed:", e, file=sys.stderr)

Замена семейства os.spawn

Пример P_NOWAIT:

pid = os.spawnlp(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg")
==>
pid = Popen(["/bin/mycmd", "myarg"]).pid

Пример P_WAIT:

retcode = os.spawnlp(os.P_WAIT, "/bin/mycmd", "mycmd", "myarg")
==>
retcode = call(["/bin/mycmd", "myarg"])

Пример с вектором:

os.spawnvp(os.P_NOWAIT, path, args)
==>
Popen([path] + args[1:])

Пример со средой:

os.spawnlpe(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg", env)
==>
Popen(["/bin/mycmd", "myarg"], env={"PATH": "/usr/bin"})

Замена os.popen(), os.popen2(), os.popen3()

(child_stdin, child_stdout) = os.popen2(cmd, mode, bufsize)
==>
p = Popen(cmd, shell=True, bufsize=bufsize,
          stdin=PIPE, stdout=PIPE, close_fds=True)
(child_stdin, child_stdout) = (p.stdin, p.stdout)

(child_stdin,
 child_stdout,
 child_stderr) = os.popen3(cmd, mode, bufsize)
==>
p = Popen(cmd, shell=True, bufsize=bufsize,
          stdin=PIPE, stdout=PIPE, stderr=PIPE, close_fds=True)
(child_stdin,
 child_stdout,
 child_stderr) = (p.stdin, p.stdout, p.stderr)

(child_stdin, child_stdout_and_stderr) = os.popen4(cmd, mode, bufsize)
==>
p = Popen(cmd, shell=True, bufsize=bufsize,
          stdin=PIPE, stdout=PIPE, stderr=STDOUT, close_fds=True)
(child_stdin, child_stdout_and_stderr) = (p.stdin, p.stdout)

Обработка кода возврата переводится следующим образом:

pipe = os.popen(cmd, 'w')
...
rc = pipe.close()
if rc is not None and rc >> 8:
    print("There were some errors")
==>
process = Popen(cmd, stdin=PIPE)
...
process.stdin.close()
if process.wait() != 0:
    print("There were some errors")

Замена функций модуля popen2

(child_stdout, child_stdin) = popen2.popen2("somestring", bufsize, mode)
==>
p = Popen("somestring", shell=True, bufsize=bufsize,
          stdin=PIPE, stdout=PIPE, close_fds=True)
(child_stdout, child_stdin) = (p.stdout, p.stdin)

(child_stdout, child_stdin) = popen2.popen2(["mycmd", "myarg"], bufsize, mode)
==>
p = Popen(["mycmd", "myarg"], bufsize=bufsize,
          stdin=PIPE, stdout=PIPE, close_fds=True)
(child_stdout, child_stdin) = (p.stdout, p.stdin)

popen2.Popen3 и popen2.Popen4 в основном работают как subprocess.Popen, за исключением:

• Popen генерирует исключение, если выполнение завершается неудачей.
• Аргумент capturestderr заменён на аргумент stderr.
• stdin=PIPE и stdout=PIPE должны быть указаны.
• popen2 закрывает все дескрипторы файлов по умолчанию, но вы должны указать close_fds=True с Popen, чтобы гарантировать это поведение на всех платформах или в прошлых версиях Python.

Преобразование последовательности аргументов в строку в Windows

В Windows последовательность args преобразуется в строку, которая может быть обработана по следующим правилам (которые соответствуют правилам, используемым MS C runtime):

1. Аргументы разделяются пробелами, которые представляют собой либо пробел, либо табуляцию.
2. Строка, окружённая двойными кавычками, интерпретируется как один аргумент, независимо от содержащихся в ней пробелов. Цитата может быть вложена в аргумент.
3. Двойная кавычка, предваряемая обратным слешем, интерпретируется как буквальная двойная кавычка.
4. Обратные слеши интерпретируются буквально, за исключением случаев, когда они непосредственно предшествуют двойной кавычке.
5. Если обратные слеши непосредственно предшествуют двойной кавычке, каждая пара обратных слешей интерпретируется как буквальный обратный слеш. Если количество обратных слешей нечётное, последний обратный слеш экранирует следующую двойную кавычку, как описано в правиле 3.