1# Copyright (c) 2011 The Chromium OS Authors. 2# 3# SPDX-License-Identifier: GPL-2.0+ 4# 5 6import os 7import cros_subprocess 8 9"""Shell command ease-ups for Python.""" 10 11class CommandResult: 12 """A class which captures the result of executing a command. 13 14 Members: 15 stdout: stdout obtained from command, as a string 16 stderr: stderr obtained from command, as a string 17 return_code: Return code from command 18 exception: Exception received, or None if all ok 19 """ 20 def __init__(self): 21 self.stdout = None 22 self.stderr = None 23 self.return_code = None 24 self.exception = None 25 26 27def RunPipe(pipe_list, infile=None, outfile=None, 28 capture=False, capture_stderr=False, oneline=False, 29 raise_on_error=True, cwd=None, **kwargs): 30 """ 31 Perform a command pipeline, with optional input/output filenames. 32 33 Args: 34 pipe_list: List of command lines to execute. Each command line is 35 piped into the next, and is itself a list of strings. For 36 example [ ['ls', '.git'] ['wc'] ] will pipe the output of 37 'ls .git' into 'wc'. 38 infile: File to provide stdin to the pipeline 39 outfile: File to store stdout 40 capture: True to capture output 41 capture_stderr: True to capture stderr 42 oneline: True to strip newline chars from output 43 kwargs: Additional keyword arguments to cros_subprocess.Popen() 44 Returns: 45 CommandResult object 46 """ 47 result = CommandResult() 48 last_pipe = None 49 pipeline = list(pipe_list) 50 user_pipestr = '|'.join([' '.join(pipe) for pipe in pipe_list]) 51 kwargs['stdout'] = None 52 kwargs['stderr'] = None 53 while pipeline: 54 cmd = pipeline.pop(0) 55 if last_pipe is not None: 56 kwargs['stdin'] = last_pipe.stdout 57 elif infile: 58 kwargs['stdin'] = open(infile, 'rb') 59 if pipeline or capture: 60 kwargs['stdout'] = cros_subprocess.PIPE 61 elif outfile: 62 kwargs['stdout'] = open(outfile, 'wb') 63 if capture_stderr: 64 kwargs['stderr'] = cros_subprocess.PIPE 65 66 try: 67 last_pipe = cros_subprocess.Popen(cmd, cwd=cwd, **kwargs) 68 except Exception, err: 69 result.exception = err 70 if raise_on_error: 71 raise Exception("Error running '%s': %s" % (user_pipestr, str)) 72 result.return_code = 255 73 return result 74 75 if capture: 76 result.stdout, result.stderr, result.combined = ( 77 last_pipe.CommunicateFilter(None)) 78 if result.stdout and oneline: 79 result.output = result.stdout.rstrip('\r\n') 80 result.return_code = last_pipe.wait() 81 else: 82 result.return_code = os.waitpid(last_pipe.pid, 0)[1] 83 if raise_on_error and result.return_code: 84 raise Exception("Error running '%s'" % user_pipestr) 85 return result 86 87def Output(*cmd): 88 return RunPipe([cmd], capture=True, raise_on_error=False).stdout 89 90def OutputOneLine(*cmd, **kwargs): 91 raise_on_error = kwargs.pop('raise_on_error', True) 92 return (RunPipe([cmd], capture=True, oneline=True, 93 raise_on_error=raise_on_error, 94 **kwargs).stdout.strip()) 95 96def Run(*cmd, **kwargs): 97 return RunPipe([cmd], **kwargs).stdout 98 99def RunList(cmd): 100 return RunPipe([cmd], capture=True).stdout 101 102def StopAll(): 103 cros_subprocess.stay_alive = False 104