mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-25 12:14:38 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

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

Browse source
This commit is contained in:
Jack DeVries 2021-07-22 14:23:29 -04:00 • committed by GitHub
parent c05a790693
commit 50ffbe3daf
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

5
Doc/library/subprocess.rst
View file

@ -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.