python中subprocess模組級方法的介紹（附程式碼）

這篇文章帶給大家的內容是關於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中文網其他相關文章！