這篇文章帶給大家的內容是關於python中subprocess模組級方法的介紹(附程式碼),有一定的參考價值,有需要的朋友可以參考一下,希望對你有幫助。
subprocess.run()
執行並等待args參數指定的指令完成,並傳回CompletedProcess實例。
參數:(*popenargs, input=None, capture_output=False, timeout=None, check=False, **kwargs)。除input, capture_output, timeout, check,其他參數與Popen建構器參數一致。
capture_output:如果設定為True,表示重定向stdout和stderr到管道,且不能再傳遞stderr或stdout參數,否則拋出例外。
input:input參數將作為子程序的標準輸入傳遞給Popen.communicate()方法,必須是string(需要指定encoding或errors參數,或是設定text為True)或byte類型。非None的input參數不能和stdin參數一起使用,否則會拋出異常,構造Popen實例的stdin參數將指定為subprocess.PIPE。
timeout:傳給Popen.communicate()方法。
check:如果設定為True,進程執行回傳非0狀態碼將拋出CalledProcessError例外。
# 源码 def run(*popenargs, input=None, capture_output=False, timeout=None, check=False, **kwargs): if input is not None: if 'stdin' in kwargs: raise ValueError('stdin and input arguments may not both be used.') kwargs['stdin'] = PIPE if capture_output: if ('stdout' in kwargs) or ('stderr' in kwargs): raise ValueError('stdout and stderr arguments may not be used ' 'with capture_output.') kwargs['stdout'] = PIPE kwargs['stderr'] = PIPE with Popen(*popenargs, **kwargs) as process: try: stdout, stderr = process.communicate(input, timeout=timeout) except TimeoutExpired: process.kill() stdout, stderr = process.communicate() raise TimeoutExpired(process.args, timeout, output=stdout, stderr=stderr) except: # Including KeyboardInterrupt, communicate handled that. process.kill() # We don't call process.wait() as .__exit__ does that for us. raise retcode = process.poll() if check and retcode: raise CalledProcessError(retcode, process.args, output=stdout, stderr=stderr) return CompletedProcess(process.args, retcode, stdout, stderr)
python3.5版本前,call(), check_all(), checkoutput()三種方法構成了subprocess模組的高階API。
subprocess.call()
執行並等待args參數指定的指令完成,返回執行狀態碼(Popen實例的returncode屬性)。
參數:(*popenargs, timeout=None, **kwargs)。與Popen建構器參數基本上相同,除timeout外的所有參數都會傳遞給Popen介面。
呼叫call()函數不要使用stdout=PIPE或stderr=PIPE,因為如果子進程產生了足量的輸出到管道填滿OS管道緩衝區,子進程將因無法從管道讀取數據而導致阻塞。
# 源码 def call(*popenargs, timeout=None, **kwargs): with Popen(*popenargs, **kwargs) as p: try: return p.wait(timeout=timeout) except: p.kill() p.wait() raise
subprocess.check_call()
運行並等待args參數指定的指令完成,返回0狀態碼或拋出CalledProcessError異常,該異常的cmd和returncode屬性可以查看執行異常的指令和狀態碼。
參數:(*popenargs, **kwargs)。全部參數傳遞給call()函數。
注意事項同call()
# 源码 def check_call(*popenargs, **kwargs): retcode = call(*popenargs, **kwargs) if retcode: cmd = kwargs.get("args") if cmd is None: cmd = popenargs[0] raise CalledProcessError(retcode, cmd) return 0
subprocess.check_output()
執行並等待args參數指定的指令完成,傳回標準輸出(CompletedProcess實例的stdout屬性) ,類型預設是byte字節,位元組編碼可能取決於執行的指令,設定universal_newlines=True可以傳回string類型的值。
如果執行狀態碼非0,將拋出CalledProcessError異常。
參數:(*popenargs, timeout=None, **kwargs)。全部參數傳遞給run()函數,但不支援顯示地傳遞input=None繼承父程序的標準輸入檔句柄。
要在回傳值中捕獲標準錯誤,設定stderr=subprocess.STDOUT;也可以將標準錯誤重定向到管道stderr=subprocess.PIPE,透過CalledProcessError異常的stderr屬性存取。
# 源码 def check_output(*popenargs, timeout=None, **kwargs): if 'stdout' in kwargs: raise ValueError('stdout argument not allowed, it will be overridden.') if 'input' in kwargs and kwargs['input'] is None: # Explicitly passing input=None was previously equivalent to passing an # empty string. That is maintained here for backwards compatibility. kwargs['input'] = '' if kwargs.get('universal_newlines', False) else b'' return run(*popenargs, stdout=PIPE, timeout=timeout, check=True, **kwargs).stdout
subprocess模組也提供了python2.x版本中commands模組的相關函數。
subprocess.getstatusoutput(cmd)
其實是呼叫check_output()函數,在shell中執行string類型的cmd指令,傳回(exitcode, output)形式的元組,output(包含stderr和stdout)是使用locale encoding解碼的字串,並刪除了結尾的換行符號。
# 源码 try: data = check_output(cmd, shell=True, universal_newlines=True, stderr=STDOUT) exitcode = 0 except CalledProcessError as ex: data = ex.output exitcode = ex.returncode if data[-1:] == '\n': data = data[:-1] return exitcode, data
subprocess.getoutput(cmd)
與getstatusoutput()類似,但結果只會回傳output。
這篇文章到這裡就已經全部結束了,更多其他精彩內容可以關注PHP中文網的python影片教學專欄!
#以上是python中subprocess模組級方法的介紹(附程式碼)的詳細內容。更多資訊請關注PHP中文網其他相關文章!