summaryrefslogtreecommitdiffstats
path: root/Doc/library/subprocess.rst
Commit message (Collapse)AuthorAgeFilesLines
* [3.8] gh-114539: Clarify implicit launching of shells by subprocess ↵Miss Islington (bot)2024-05-071-2/+10
| | | | | | | (GH-117996) (GH-118006) (cherry picked from commit a4b44d39cd6941cc03590fee7538776728bdfd0a) Co-authored-by: Steve Dower <steve.dower@python.org>
* [3.8] gh-101283: Improved fallback logic for subprocess with shell=True on ↵Miss Islington (bot)2023-02-091-0/+40
| | | | | | Windows (GH-101286) (#101710) Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net> Co-authored-by: Steve Dower <steve.dower@microsoft.com>
* bpo-42388: Fix subprocess.check_output input=None when text=True (GH-23467)Miss Islington (bot)2020-12-251-2/+3
| | | | | | | | | | | | | When the modern text= spelling of the universal_newlines= parameter was added for Python 3.7, check_output's special case around input=None was overlooked. So it behaved differently with universal_newlines=True vs text=True. This reconciles the behavior to be consistent and adds a test to guarantee it. Also clarifies the existing check_output documentation. Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru> (cherry picked from commit 64abf373444944a240274a9b6d66d1cb01ecfcdd) Co-authored-by: Gregory P. Smith <greg@krypto.org>
* bpo-40707: Document that Popen.communicate sets the returncode attribute ↵Miss Islington (bot)2020-06-241-4/+5
| | | | | | | (GH-20283) (cherry picked from commit bf2e515fa43406d4bd9c4c53ecc9364034d8f9f6) Co-authored-by: Gareth Rees <gdr@garethrees.org>
* bpo-39976: Add **other_popen_kwargs to subprocess docs (GH-20145)Miss Islington (bot)2020-05-191-4/+8
| | | | | (cherry picked from commit 46545000c2a30b46aed717b546bc09e5bae7148f) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* Doc: change 'Posix' for 'POSIX' (GH-20001)Miss Islington (bot)2020-05-171-2/+2
| | | | | (cherry picked from commit 65460565df99fbda6a74b6bb4bf99affaaf8bd95) Co-authored-by: Mathieu Dupuy <mathieu.dupuy@doctolib.com>
* bpo-13826: Clarify Popen constructor example (GH-18438)Miss Islington (bot)2020-02-101-2/+8
| | | | | | | | | Clarifies that the use of `shlex.split` is more instructive than normative, and provides a simpler example. https://bugs.python.org/issue13826 (cherry picked from commit 95d024d585bd3ed627437a2f0cbc783c8a014c8a) Co-authored-by: Tim D. Smith <github@tim-smith.us>
* [3.8] Added missing coma after end of list in subprocess.rst (GH-17389)Jules Lasne (jlasne)2019-11-291-1/+1
| | | (cherry picked from commit f25875af425a3480e557aaedf49c3bb867bcbd5d)
* Minor ReST formatting fixes in subprocess docs (GH-14876)Miss Islington (bot)2019-09-111-4/+4
| | | | | (cherry picked from commit 1a13efb7e05b545def26f29c954751fdb6b22fa3) Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
* bpo-37951: Lift subprocess's fork() restriction (GH-15544)Miss Islington (bot)2019-08-271-0/+7
| | | | | (cherry picked from commit 98d90f745d35d5d07bffcb46788b50e05eea56c6) Co-authored-by: Christian Heimes <christian@python.org>
* Replace backquote with command substitution in subprocess doc example (GH-13941)Miss Islington (bot)2019-07-161-5/+5
| | | | | | Replace backquotes with POSIXy command substitution in example. (cherry picked from commit 6a61714cde7037cd9a1bcc11ecccb17fe3081295) Co-authored-by: David Jones <drj@pobox.com>
* bpo-37390: Add audit event table to documentations (GH-14406)Miss Islington (bot)2019-06-271-1/+1
| | | | | | Also updates some (unreleased) event names to be consistent with the others. (cherry picked from commit 44f91c388a6f4da9ed3300df32ca290b8aa104ea) Co-authored-by: Steve Dower <steve.dower@python.org>
* bpo-37363: Add audit events for a range of modules (GH-14301)Miss Islington (bot)2019-06-241-0/+7
| | | | | (cherry picked from commit 60419a7e96577cf783b3b45bf3984f9fb0d7ddff) Co-authored-by: Steve Dower <steve.dower@python.org>
* bpo-31961: Fix support of path-like executables in subprocess. (GH-5914)Serhiy Storchaka2019-05-281-3/+26
|
* bpo-36760: Clarify subprocess capture_output docs. (GH-13322)Gregory P. Smith2019-05-141-1/+3
| | | Clarify how to capture stdout and stderr combined into one stream.
* bpo-35537: Document posix_spawn() change in subprocess (GH-11668)Victor Stinner2019-04-251-0/+7
| | | | | Document that subprocess.Popen no longer raise an exception on error like missing program on very specific platforms when using os.posix_spawn() is used.
* bpo-33319: Clarify subprocess call docs. (GH-12508)Gregory P. Smith2019-03-231-12/+13
| | | | | Clarify capturing or suppressing stdout and stderr on the old call APIs. Do not state that they are equivalent to run() calls when they are not implemented using run as that was misleading. Unlike run they cannot handle stdout or stderr being set to PIPE without a risk of deadlock.
* Fixed a missing . and a missing capital letter. (GH-12170)Jules Lasne (jlasne)2019-03-041-2/+2
|
* bpo-31450: Remove documentation mentioning that subprocess's child_traceback ↵Harmandeep Singh2019-01-031-3/+1
| | | | is available with the parent process (GH-11422)
* Update subprocess.Popen documentation wrt universal_newlines arg (GH-10337)Jakub Stasiak2018-11-121-3/+8
| | | | | | | | * universal_newlines defaulting to False would suggest, that not specifying universal_newlines explicitly and setting text to True should cause an error, which is not the case. * The run function didn't have the universal_newlines parameter documented * The check_output function didn't have its text parameter documented
* bpo-11233: Create availability directive for documentation (GH-9692)Cheryl Sabella2018-10-121-2/+2
| | | | | | Replace "Availability: xxx" with ".. availability:: xxx" in the doc. Original patch by Georg Brandl. Co-Authored-By: Georg Brandl <georg@python.org>
* Make docs of exitcode for subprocess.getstatusoutput more clear. (GH-9477)Xiang Zhang2018-09-211-2/+3
| | | Make it more accurate and not limited to UNIX.
* Doc: add missing capture_output arg to subprocess.run() signature (#8374)Andriy Maletsky2018-08-091-2/+2
|
* versionadded -> versionchanged for all 'X parameter was added' for ↵Sergey Fedoseev2018-07-061-1/+1
| | | | | | uniformity. (GH8114) Per the recommendation in our Developer's Guide: https://devguide.python.org/documenting/#paragraph-level-markup
* bpo-32392: Document env keyword argument of subprocess.run() (GH-7289)Tobias Kunze2018-06-051-1/+6
|
* Clarify fd inheritance when close_fds=False. (GH-6240)Gregory P. Smith2018-03-251-1/+4
| | | Clarify the subprocess documentation.
* Revert "bpo-31961: subprocess now accepts path-like args (GH-4329)" (#5912)Serhiy Storchaka2018-02-271-10/+6
| | | | | | * Revert "bpo-31961: subprocess now accepts path-like args (GH-4329)" This reverts commit dd42cb71f2cb02f3a32f016137b12a146bc0d0e2.
* bpo-32815: Improve docs on the subprocess API *text* parameter (GH-5622)Pablo Galindo2018-02-111-8/+15
| | | Describe *text* as an alias for *universal_newlines* in more places that people are likely to be referred to.
* bpo-6135: Fix subprocess.check_output doc to mention changes in 3.6 (GH-5564)Brice Gros2018-02-071-0/+3
| | | Fixes the documentation for `subprocess.check_output()` not mentioning that the encoding and errors parameters were added in 3.6.
* bpo-31961: subprocess now accepts path-like args (GH-4329)Anders Lorentsen2018-01-301-6/+10
| | | Allow os.PathLike args in subprocess APIs.
* bpo-32102 Add "capture_output=True" to subprocess.run (GH-5149)Bo Bayles2018-01-301-8/+11
| | | | Add "capture_output=True" option to subprocess.run, this is equivalent to setting stdout=PIPE, stderr=PIPE but is much more readable.
* bpo-19764: Implemented support for subprocess.Popen(close_fds=True) on ↵Segev Finer2017-12-181-6/+36
| | | | | | | | | | | | | | | | | Windows (#1218) Even though Python marks any handles it opens as non-inheritable there is still a race when using `subprocess.Popen` since creating a process with redirected stdio requires temporarily creating inheritable handles. By implementing support for `subprocess.Popen(close_fds=True)` we fix this race. In order to implement this we use PROC_THREAD_ATTRIBUTE_HANDLE_LIST which is available since Windows Vista. Which allows to pass an explicit list of handles to inherit when creating a process. This commit also adds `STARTUPINFO.lpAttributeList["handle_list"]` which can be used to control PROC_THREAD_ATTRIBUTE_HANDLE_LIST directly.
* bpo-31884 subprocess: add Windows constants for process priority (#4150)James2017-11-081-4/+94
|
* bpo-31756: subprocess.run should alias universal_newlines to text (#4049)andyclegg2017-10-231-7/+12
| | | | | | | | | Improve human friendliness of the Popen API: Add text=False as a keyword-only argument to subprocess.Popen along with a Popen attribute .text_mode and set this based on the encoding/errors/universal_newlines/text arguments. The universal_newlines parameter and attribute are maintained for backwards compatibility.
* bpo-22635: subprocess.getstatusoutput doc update. (#3398)Gregory P. Smith2017-09-071-7/+12
| | | | | The `subprocess.getstatusoutput` API was inadvertently changed in Python 3.3.4. Document the change, it is too late to undo the API change now as it has shipped in many stable releases.
* bpo-31065: Add doc about Popen.poll returning None. (#3169)Ivan Chernoff2017-08-291-1/+1
|
* bpo-30420: List cwd parameter in subprocess convenience APIs (GH-1685)Alex Gaynor2017-05-261-4/+4
| | | | | | | | | | Partially clarify the subprocess convenience API documentation by explicitly listing the `cwd` parameter in their abbreviated signatures. While this has been merged as an improvement, it doesn't fully resolve the issue, as the `cwd` should also be covered in the "Frequently Used Arguments" section, and the fact these APIs pass unlisted keyword arguments down to the lower level APIs is currently still unclear.
* Tweak subprocess.STARTUPINFO documentation (#347)Berker Peksag2017-03-011-5/+7
| | | | * Document STARTUPINFO constructor * Move versionchanged directive to above of attributes
* bpo-28624: Add a test that checks that cwd parameter of Popen() accepts ↵Sayan Chowdhury2017-02-261-3/+7
| | | | PathLike objects (#157)
* bpo-26128: Added __init__to subprocess.STARTUPINFO (#171)Subhendu Ghosh2017-02-251-1/+4
| | | | | | | The Windows-specific subprocess.STARTUPINFO class now accepts keyword-only arguments to its constructor to set the various data attributes. Patch by Subhendu Ghosh.
* issue 20572: remove the deprecation notice for the deleted endtime parameter.Gregory P. Smith2016-11-211-6/+0
|
* Issue #19795: Improved more markups of True/False.Serhiy Storchaka2016-10-191-4/+4
|\
| * Issue #19795: Improved more markups of True/False.Serhiy Storchaka2016-10-191-1/+1
| |
* | Issue #19795: Mark up True and False as literal text instead of bold.Serhiy Storchaka2016-10-191-2/+2
|\ \ | |/
| * Issue #19795: Mark up True and False as literal text instead of bold.Serhiy Storchaka2016-10-191-2/+2
| |
* | Issue #19795: Mark up None as literal text.Serhiy Storchaka2016-10-191-3/+3
|\ \ | |/
| * Issue #19795: Mark up None as literal text.Serhiy Storchaka2016-10-191-3/+3
| |
* | Issue #6135: Adds encoding and errors parameters to subprocessSteve Dower2016-09-071-40/+63
| |
* | Issue #26462: Merge code block fixes from 3.5Martin Panter2016-07-291-7/+14
|\ \ | |/
| * Issue #26462: Doc: reduce literal_block warnings, fix syntax highlighting.Martin Panter2016-07-261-7/+14
| | | | | | | | Patch by Julien Palard.