| Current File : //lib/python2.7/site-packages/vdo/utils/Command.pyo |
�
.�t_c @ s� d Z d d l m Z d d l m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z d e
f d � � YZ d e f d � � YZ
d
� Z d � Z d S( s
Command - runs commands and manages their results
$Id: //eng/vdo-releases/magnesium/src/python/vdo/utils/Command.py#3 $
i ( t Loggeri����( t Popent PIPENt CommandErrorc B sD e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s� Exception raised to indicate an error running a command.
Arguments:
exitCode (int): The exit code of the command
stdout (string): The output from the command
stderr (string): The error output from the command
message (string): The (localized) error text; will be formatted with
the remaining arguments
args: Arguments for formatting the message
c C s | j S( N( t _exitCode( t self( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt getExitCode0 s c C s | j S( N( t _stderr( R ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt getStandardError4 s c C s | | j � | | j � d S( s� Log the outputs of the failed command which generated this exception.
Arguments:
logMethod (callable): The method to log with
N( t _stdoutR ( R t logMethod( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt
logOutputs8 s
c G s | j | � | _ d S( s� Set the error message in this exception.
Arguments:
message (string): The (localized) message text; will be formatted
with *args
args: Values to pass to the format of message
N( t formatt _message( R t messaget args( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt
setMessageB s c G sB t t | � j � | | _ | | _ | | _ | j | | � d S( N( t superR t __init__R R R R ( R t exitCodet stdoutt stderrR R ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR O s
c C s | j S( N( R
( R ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt __str__W s ( t __name__t
__module__t __doc__R R R R R R ( ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR " s
t Commandc B s� e Z d Z e Z d Z e j e j d � Z
e d � � Z e e e d � � Z
d � Z d � Z d
d � Z d � Z d d d d
� Z d � Z d � Z RS( sV Command encapsulates shell commands, runs them, and manages the result.
Attributes:
noRun (bool): if True, don't run the command, and always succeed
shell (bool): if True, run this command using shell -c
verbose (int): if > 0, print commands to stdout before executing them
_commandList (list): command and its arguments
i s .Commandc C s | j S( s+ Returns True iff Commands default to noRun.( t defaultNoRun( t cls( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt noRunModek s c C s1 | r | | _ t | _ n | r- | | _ n d S( s� Sets the verbose and noRun default values.
Arguments:
verbose: (boolean) If True, operate verbosely.
noRun: (boolean) If True, do not actually execute.
N( R t Truet defaultVerbose( R t verboset noRun( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt setDefaultsq s
c C s | j d S( s3 Returns an identifier (argv[0]) for error messages.i ( t _commandList( R ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt commandName� s c K s� | j d d � } | j d d � } | j sE | j d t � | _ n | j � } | d k ry | j j d j | � � n yxt | � D]} | d k r� | j j d j | | � � n | j d k r� d | GH| j j
| � n | j r� d Sy3 | j | � } | j d
t � r | j
� S| SWq� t k
r�} | | d k r~| d k ru| j t d � | j � | � n | � n t j d � q� Xq� WWn/ t k
r�} | j d t � r�d
S| � n Xd S( s� Run a command.
Returns the output of running the command.
Arguments:
noThrow: If True, will return an empty string instead of throwing on
error.
retries: The number of times to try the command before giving up.
Defaults to 1.
shell: Indicate that this is a shell command
stdin: If not None, the stream from which the command should take
its input, defaults to None.
strip: If True, strip leading and trailing whitespace from the
command output before returning it.
Exceptions:
CommandError: if the command failed and noThrow is False
t retriesi t stdint shells Waiting for '{0}'s
... {0}/{1}i s Nt strips {0}: timed out after {1} secondst noThrowt ( t gett NoneR' t Falset _getCommandLinet logt debugR t rangeR t infoR! t _executeR( R R t _R$ t timet sleep( R t kwargsR% R& t commandLinet countt outputt e( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt run� s< $ c C s� t t | � j � t j | _ t | _ t j | _ | | _ | r� t
j t j
� | _ x3 | j � D] \ } } | | j | <qe Wn d | _ d S( N( R R R R R! R- R' R R R# t copyt deepcopyt ost environt envt itemsR, ( R t commandListt environmentt vart value( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR � s c C s d j | j � d S( Nt ( t joinR# ( R ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR � s R* c C s� z� | d k r8 | j j t d � j | j � � � | S| d k rP t d � n t d � } t d � j | j � | t | � � } | j j | � t | | | | � � Wd | j j d | j � � | j j d | j � � Xd S( s� Sets the result values of this object. Raises an exception if there was
an error, or returns the output of the command if there was not.
Arguments:
exitCode (int): the process exit code
stdout (str): the standard output
stderr (str): the standard error
logResults (bool): if True, the results will be logged
Exceptions:
CommandError: if exitCode is non-zero
i s {0}: command succeededs exit statust signals {0}: command failed, {1} {2}Ns stdout: s stderr: ( R/ R0 R4 R R$ t absR t rstrip( R R R R t failureTypet status( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt
_checkResults� s
%$c C s$ | j r | j � n | j } yw t | d t d t d t d t d | j d | j �} | j | � \ } } | j | j d j
| � d j
| � � SWn� t k
r� } | j | j d d j
| j
� | j g � � nH t k
r } | j j t j � d } | r| j | � n | � n Xd
S( s� Execute the command once.
Returns the output of the command.
Arguments:
stdin: If not None, the stream from which the command should take its
input.
Exceptions:
CommandError: if the command failed
R& R R t close_fdsRA R' R* s : i N( R' R. R# R R R RA t communicateRN t
returncodeRH t OSErrort errnoR$ t strerrorR R t splitR? t linesepR ( R R& t commandt pt
stdoutdatat
stderrdataR; t error( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR3 � s "c C s. d j | j r | j n t t j | j � � S( s. Returns the appropriately quoted command line.RG ( RH R' R# t mapt pipest quote( R ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR.
s N( R R R R- R R t loggingt getLoggerR t mynameR/ t classmethodR R" R$ R< R, R R RN R3 R. ( ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyR [ s 6 c K s" t | | j d d � � j | � S( s` Run a command.
Returns the output of the command (but see Keyword Arguments).
Arguments:
commandList: The command as a list of strings.
Keyword Arguments:
environment: A dict of environment variables and their values to use for
the command.
noThrow: If True, will return an empty string instead of throwing on
error.
retries: The number of times to try the command before giving up.
Defaults to 1.
shell: Indicate that this is a shell command.
stdin: If not None, the stream from which the command should take its
input, defaults to None.
strip: If True, strip leading and trailing whitespace from the
command output before returning it.
Exceptions:
CommandError: if the command failed and noThrow is False
RD N( R t popR, R< ( RC R7 ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt
runCommand s c K s~ d } | j d t � } x; | D]3 } y t | | � SWq t k
rQ } | } q Xq W| re d } n | d k rz | � n d S( s$ Try each of a series of commands in turn until one succeeds. If all the
commands fail, give up and raise an exception.
Arguments:
commands: A list of command lists
Keyword Arguments:
Supports all of the arguments which may be passed to runCommand().
Returns:
the output of the first successful command
Exceptions:
CommandError: if none of the commands succeeds and the noThrow keyword
option is False (or omitted); the error will be the one
raised by the last command in the list
R) N( R, Rc R- Rd R ( t commandsR7 R[ R) RW R; ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt tryCommandsUntilSuccess+ s
( R R t
subprocessR R R= R_ R? R] R5 t ExceptionR t objectR Rd Rf ( ( ( s5 /usr/lib/python2.7/site-packages/vdo/utils/Command.pyt <module> s 9�