Browse Source

bpo-14879: [doc] clarify how to check for errors from subprocess.Popen(..., shell=True) (GH-26755)

pull/27297/head
Jack DeVries 4 years ago
committed by GitHub
parent
commit
50ffbe3daf
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 5
      Doc/library/subprocess.rst

5
Doc/library/subprocess.rst

@ -689,7 +689,10 @@ execute, will be re-raised in the parent.
The most common exception raised is :exc:`OSError`. This occurs, for example,
when trying to execute a non-existent file. Applications should prepare for
:exc:`OSError` exceptions.
:exc:`OSError` exceptions. Note that, when ``"shell=True"``, :exc:`OSError`
will be raised by the child only if the selected shell itself was not found.
To determine if the shell failed to find the requested application, it is
necessary to check the return code or output from the subprocess.
A :exc:`ValueError` will be raised if :class:`Popen` is called with invalid
arguments.

Loading…
Cancel
Save