Сообщить об ошибке.

Исключения модуля subprocess

В этом разделе представлены исключения, возникающие во время запуска программы, а так же исключения, определенные модулем subprocess.

Содержание:


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

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

Наиболее распространенное исключение - OSError. В основном поднимается при попытке выполнить несуществующий файл. Приложения должны быть готовы к исключениям OSError.

Ошибка ValueError будет вызываться, если subprocess.Popen() вызывается с недопустимыми аргументами.

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

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

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


subprocess.SubprocessError:

Исключение subprocess.SubprocessError это базовый класс для всех других исключений из этого модуля.


subprocess.TimeoutExpired:

Подкласс subprocess.SubprocessError, возникает при истечении времени в ожидании завершения дочернего процесса.

timeout.cmd:

Возвращает команду, которая использовалась для порождения дочернего процесса.

timeout.timeout:

Возвращает заданный тайм-аут в секундах.

timeout.output

Возвращает вывод дочернего процесса, если он был захвачен subprocess.run() или subprocess.check_output().

В противном случае возвращает None.

timeout.stdout:

Псевдоним для вывода из timeout.stderr.

timeout.stderr:

Возвращает вывод stderr дочернего процесса, если он был захвачен функцией subprocess.run().

В противном случае возвращает None.


subprocess.CalledProcessError:

Подкласс subprocess.SubprocessError, возникает, когда процесс, запущенный check_call() или check_output(), возвращает ненулевое состояние выхода.

callerror.returncode:

Возвращает состояние выхода из дочернего процесса. Если процесс завершился из-за сигнала, это будет отрицательный номер сигнала.

callerror.cmd:

Возвращает команду, которая использовалась для порождения дочернего процесса.

callerror.output:

Возвращает вывод дочернего процесса, если он был захвачен subprocess.run() или subprocess.check_output().

В противном случае возвращает None.

callerror.stdout:

Псевдоним для вывода из callerror.stderr.

callerror.stderr:

Возвращает вывод stderr дочернего процесса, если он был захвачен функцией subprocess.run().