[issue15789] mention shell-like parts of the std lib in the subprocess docs

New submission from Chris Rebert: To further dissuade people from using subprocess.Popen's shell=True option unnecessarily, this patch points out that some common shell features are also available directly in Python via certain modules & functions. ---------- assignee: docs@python components: Documentation files: subprocess.rst.patch keywords: patch messages: 169188 nosy: cvrebert, docs@python priority: normal severity: normal status: open title: mention shell-like parts of the std lib in the subprocess docs versions: Python 2.7, Python 3.3, Python 3.4 Added file: http://bugs.python.org/file27013/subprocess.rst.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________

Éric Araujo added the comment: Thanks, LGTM. Maybe there’s a section about walking files in the os module doc that you could also link to? Also shutil. ---------- nosy: +eric.araujo versions: +Python 3.2 -Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________

Chris Jerdonek added the comment: This is a nit, but can you adhere to an 80-character line length? Much (but not all) of the documentation does. ---------- nosy: +cjerdonek _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________

Chris Rebert added the comment: Revised patch in response to comments. ---------- Added file: http://bugs.python.org/file27029/subprocess.rst.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________

Chris Rebert added the comment: Ping. Any further comments? ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________

Roundup Robot added the comment: New changeset 820032281f49 by Ezio Melotti in branch '2.7': #15789: mention shell-like parts of the stdlib in the subprocess docs. Patch by Chris Rebert. http://hg.python.org/cpython/rev/820032281f49 New changeset 9794f69c1d09 by Ezio Melotti in branch '3.2': #15789: mention shell-like parts of the stdlib in the subprocess docs. Patch by Chris Rebert. http://hg.python.org/cpython/rev/9794f69c1d09 New changeset 09011896374d by Ezio Melotti in branch 'default': #15789: merge with 3.2. http://hg.python.org/cpython/rev/09011896374d ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________

Ezio Melotti added the comment: Pong, thanks for the patch! ---------- assignee: docs@python -> ezio.melotti nosy: +ezio.melotti resolution: -> fixed stage: -> committed/rejected status: open -> closed type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15789> _______________________________________
participants (5)
-
Chris Jerdonek
-
Chris Rebert
-
Ezio Melotti
-
Roundup Robot
-
Éric Araujo