cpython/Lib/commands.py

91 lines
2.5 KiB
Python
Raw Normal View History

"""Execute shell commands via os.popen() and return status, output.
Interface summary:
2001-01-14 19:36:06 -04:00
import commands
2001-01-14 19:36:06 -04:00
outtext = commands.getoutput(cmd)
(exitstatus, outtext) = commands.getstatusoutput(cmd)
outtext = commands.getstatus(file) # returns output of "ls -ld file"
A trailing newline is removed from the output string.
Encapsulates the basic operation:
2001-01-14 19:36:06 -04:00
pipe = os.popen('{ ' + cmd + '; } 2>&1', 'r')
text = pipe.read()
sts = pipe.close()
[Note: it would be nice to add functions to interpret the exit status.]
"""
from warnings import warnpy3k
warnpy3k("the commands module has been removed in Python 3.0; "
"use the subprocess module instead", stacklevel=2)
del warnpy3k
__all__ = ["getstatusoutput","getoutput","getstatus"]
1990-10-13 16:23:40 -03:00
# Module 'commands'
#
# Various tools for executing commands and looking at their output and status.
1992-03-31 15:02:55 -04:00
#
# NB This only works (and is only relevant) for UNIX.
1990-10-13 16:23:40 -03:00
# Get 'ls -l' status for an object into a string
#
def getstatus(file):
"""Return output of "ls -ld <file>" in a string."""
2007-03-13 18:32:01 -03:00
import warnings
warnings.warn("commands.getstatus() is deprecated", DeprecationWarning)
return getoutput('ls -ld' + mkarg(file))
1990-10-13 16:23:40 -03:00
# Get the output from a shell command into a string.
# The exit status is ignored; a trailing newline is stripped.
1991-08-16 10:23:29 -03:00
# Assume the command will work with '{ ... ; } 2>&1' around it..
1990-10-13 16:23:40 -03:00
#
def getoutput(cmd):
"""Return output (stdout or stderr) of executing cmd in a shell."""
return getstatusoutput(cmd)[1]
1990-10-13 16:23:40 -03:00
# Ditto but preserving the exit status.
# Returns a pair (sts, output)
#
def getstatusoutput(cmd):
"""Return (status, output) of executing cmd in a shell."""
import os
pipe = os.popen('{ ' + cmd + '; } 2>&1', 'r')
text = pipe.read()
sts = pipe.close()
if sts is None: sts = 0
if text[-1:] == '\n': text = text[:-1]
return sts, text
1990-10-13 16:23:40 -03:00
# Make command argument from directory and pathname (prefix space, add quotes).
#
def mk2arg(head, x):
import os
return mkarg(os.path.join(head, x))
1990-10-13 16:23:40 -03:00
# Make a shell command argument from a string.
1995-01-04 15:20:00 -04:00
# Return a string beginning with a space followed by a shell-quoted
# version of the argument.
1990-10-13 16:23:40 -03:00
# Two strategies: enclose in single quotes if it contains none;
1991-08-16 10:23:29 -03:00
# otherwise, enclose in double quotes and prefix quotable characters
1990-10-13 16:23:40 -03:00
# with backslash.
#
def mkarg(x):
if '\'' not in x:
return ' \'' + x + '\''
s = ' "'
for c in x:
if c in '\\$"`':
s = s + '\\'
s = s + c
s = s + '"'
return s