mirror of
https://github.com/python/cpython.git
synced 2025-08-18 07:41:05 +00:00
3885314b11
svn+ssh://pythondev@svn.python.org/python/trunk ........ r72007 | georg.brandl | 2009-04-27 17:09:25 +0200 (Mo, 27 Apr 2009) | 1 line #5856: fix typo s in traceback example. ........ r72008 | georg.brandl | 2009-04-27 17:10:44 +0200 (Mo, 27 Apr 2009) | 1 line Remove ".. warning::" markup that doesnt contain warnings for users, rather todo items. ........ r72009 | georg.brandl | 2009-04-27 17:29:09 +0200 (Mo, 27 Apr 2009) | 3 lines Demote warnings to notices where appropriate, following the goal that as few "red box" warnings should clutter the docs as possible. Part 1: stuff that gets merged to Py3k. ........ r72010 | georg.brandl | 2009-04-27 17:29:26 +0200 (Mo, 27 Apr 2009) | 2 lines Demote warnings to notices, part 2: stuff that is 2.x-only. ........ r72036 | georg.brandl | 2009-04-27 19:04:23 +0200 (Mo, 27 Apr 2009) | 1 line #5848: small unittest doc patch. ........ r72037 | georg.brandl | 2009-04-27 19:09:53 +0200 (Mo, 27 Apr 2009) | 1 line #5840: dont claim we dont support TLS. ........
74 lines
2.4 KiB
ReStructuredText
74 lines
2.4 KiB
ReStructuredText
|
|
:mod:`commands` --- Utilities for running commands
|
|
==================================================
|
|
|
|
.. module:: commands
|
|
:platform: Unix
|
|
:synopsis: Utility functions for running external commands.
|
|
.. sectionauthor:: Sue Williams <sbw@provis.com>
|
|
|
|
|
|
The :mod:`commands` module contains wrapper functions for :func:`os.popen` which
|
|
take a system command as a string and return any output generated by the command
|
|
and, optionally, the exit status.
|
|
|
|
The :mod:`subprocess` module provides more powerful facilities for spawning new
|
|
processes and retrieving their results. Using the :mod:`subprocess` module is
|
|
preferable to using the :mod:`commands` module.
|
|
|
|
.. note::
|
|
|
|
In Python 3.x, :func:`getstatus` and two undocumented functions
|
|
(:func:`mk2arg` and :func:`mkarg`) have been removed. Also,
|
|
:func:`getstatusoutput` and :func:`getoutput` have been moved to the
|
|
:mod:`subprocess` module.
|
|
|
|
The :mod:`commands` module defines the following functions:
|
|
|
|
|
|
.. function:: getstatusoutput(cmd)
|
|
|
|
Execute the string *cmd* in a shell with :func:`os.popen` and return a 2-tuple
|
|
``(status, output)``. *cmd* is actually run as ``{ cmd ; } 2>&1``, so that the
|
|
returned output will contain output or error messages. A trailing newline is
|
|
stripped from the output. The exit status for the command can be interpreted
|
|
according to the rules for the C function :cfunc:`wait`.
|
|
|
|
|
|
.. function:: getoutput(cmd)
|
|
|
|
Like :func:`getstatusoutput`, except the exit status is ignored and the return
|
|
value is a string containing the command's output.
|
|
|
|
|
|
.. function:: getstatus(file)
|
|
|
|
Return the output of ``ls -ld file`` as a string. This function uses the
|
|
:func:`getoutput` function, and properly escapes backslashes and dollar signs in
|
|
the argument.
|
|
|
|
.. deprecated:: 2.6
|
|
This function is nonobvious and useless. The name is also misleading in the
|
|
presence of :func:`getstatusoutput`.
|
|
|
|
|
|
Example::
|
|
|
|
>>> import commands
|
|
>>> commands.getstatusoutput('ls /bin/ls')
|
|
(0, '/bin/ls')
|
|
>>> commands.getstatusoutput('cat /bin/junk')
|
|
(256, 'cat: /bin/junk: No such file or directory')
|
|
>>> commands.getstatusoutput('/bin/junk')
|
|
(256, 'sh: /bin/junk: not found')
|
|
>>> commands.getoutput('ls /bin/ls')
|
|
'/bin/ls'
|
|
>>> commands.getstatus('/bin/ls')
|
|
'-rwxr-xr-x 1 root 13352 Oct 14 1994 /bin/ls'
|
|
|
|
|
|
.. seealso::
|
|
|
|
Module :mod:`subprocess`
|
|
Module for spawning and managing subprocesses.
|
|
|