[Python-checkins] bpo-13826: Clarify Popen constructor example (GH-18438)
Tim D. Smith
webhook-mailer at python.org
Mon Feb 10 17:51:05 EST 2020
https://github.com/python/cpython/commit/95d024d585bd3ed627437a2f0cbc783c8a014c8a
commit: 95d024d585bd3ed627437a2f0cbc783c8a014c8a
branch: master
author: Tim D. Smith <github at tim-smith.us>
committer: GitHub <noreply at github.com>
date: 2020-02-10T14:51:01-08:00
summary:
bpo-13826: Clarify Popen constructor example (GH-18438)
Clarifies that the use of `shlex.split` is more instructive than
normative, and provides a simpler example.
https://bugs.python.org/issue13826
files:
M Doc/library/subprocess.rst
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 74857480360dc..24497a2edd357 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -356,14 +356,20 @@ functions.
arguments for additional differences from the default behavior. Unless
otherwise stated, it is recommended to pass *args* as a sequence.
+ An example of passing some arguments to an external program
+ as a sequence is::
+
+ Popen(["/usr/bin/git", "commit", "-m", "Fixes a bug."])
+
On POSIX, if *args* is a string, the string is interpreted as the name or
path of the program to execute. However, this can only be done if not
passing arguments to the program.
.. note::
- :meth:`shlex.split` can be useful when determining the correct
- tokenization for *args*, especially in complex cases::
+ It may not be obvious how to break a shell command into a sequence of arguments,
+ especially in complex cases. :meth:`shlex.split` can illustrate how to
+ determine the correct tokenization for *args*::
>>> import shlex, subprocess
>>> command_line = input()
More information about the Python-checkins
mailing list