摘要：限于，可選的文件描述符序列，用于在父子進(jìn)程間保持開放。如果設(shè)置了，表示派生的進(jìn)程號(hào)子進(jìn)程返回碼，表示進(jìn)程未終止。如果未捕獲標(biāo)準(zhǔn)錯(cuò)誤返回方法如果非，拋出異常異常模塊的異?；愖舆M(jìn)程執(zhí)行超時(shí)。

subprocess.DEVNULL：可傳遞給stdin, stdout, stderr參數(shù)的特殊值，意味著將使用特殊文件os.devnull重定向輸入輸出

subprocess.PIPE：可傳遞給stdin, stdout, stderr參數(shù)的特殊值，意味著使用管道重定向輸入輸出

subprocess.STDOUT：可傳遞給stderr參數(shù)的特殊值，表示重定向標(biāo)準(zhǔn)錯(cuò)誤到標(biāo)準(zhǔn)輸出

在一個(gè)新的進(jìn)程中執(zhí)行子程序。

構(gòu)造參數(shù)

(args, bufsize=-1, executable=None, stdin=None, stdout=None, stderr=None, preexec_fn=None, close_fds=True, shell=False, cwd=None, env=None, universal_newlines=None, startupinfo=None, creationflags=0, restore_signals=True, start_new_session=False, pass_fds=(), *, encoding=None, errors=None, text=None)

args：字符串或序列。如果是序列，則args中的第一個(gè)元素是要執(zhí)行的程序；如果是字符串，解釋執(zhí)行與平臺(tái)有關(guān)，在POSIX系統(tǒng)args將被解釋為要執(zhí)行的程序的名稱或路徑(前提是不傳遞任何參數(shù)給程序)。

shell：指定是否使用shell作為要執(zhí)行的程序。如果設(shè)置為True，更推薦和字符串類型的args參數(shù)使用。
在POSIX系統(tǒng)，shell=True默認(rèn)使用/bin/sh作為shell。如果args為字符串，該字符串表示要通過shell執(zhí)行的命令；如果args為序列，第一個(gè)元素指定要執(zhí)行的程序，其他元素視為參數(shù)。
在Windows系統(tǒng)，shell=True默認(rèn)使用COMSPEC環(huán)境變量指定的shell，一般是C:WINDOWSsystem32cmd.exe。唯一需要指定shell=True的場(chǎng)景是要執(zhí)行的指令是shell內(nèi)置的，如dir, copy。

bufsize：創(chuàng)建stdin/stdout/stderr管道文件對(duì)象時(shí)作為對(duì)應(yīng)的參數(shù)傳遞給open()函數(shù)。
0：不始用緩沖
1：使用行緩沖
其他正整數(shù)：緩沖大小
負(fù)整數(shù)（默認(rèn)）：使用系統(tǒng)默認(rèn)值

executable：使用shell=True的場(chǎng)景很少。shell=True時(shí)，在POSIX系統(tǒng)上此參數(shù)表示指定一個(gè)新的shell程序替換默認(rèn)shell/bin/sh。

stdin/stdout/stderr：分別指定程序執(zhí)行的標(biāo)準(zhǔn)輸入，標(biāo)準(zhǔn)輸出，標(biāo)準(zhǔn)錯(cuò)誤?？蛇x值包括PIPE，DEVNULL，已存在的文件描述符(正整數(shù))，已存在的文件對(duì)象，None。子進(jìn)程文件句柄繼承自父進(jìn)程。除此之外，stderr還可以是STDOUT,表示標(biāo)準(zhǔn)錯(cuò)誤輸出重定向到標(biāo)準(zhǔn)輸出。

preexec_fn：限于POSIX系統(tǒng)，設(shè)置一個(gè)可調(diào)用對(duì)象，先于子進(jìn)程中的程序執(zhí)行。

close_fds：如果為False，文件描述符遵循Inheritance of File Descriptors中描述的inheritable標(biāo)識(shí)。
如果為True，在POSIX系統(tǒng)下，在子進(jìn)程執(zhí)行前關(guān)閉除0，1，2外的文件描述符。

pass_fds：限于POSIX，可選的文件描述符序列，用于在父子進(jìn)程間保持開放。只要提供了此參數(shù)，close_fds強(qiáng)制設(shè)為True。

cwd：在子進(jìn)程執(zhí)行前改變工作目錄為cwd，可以是字符串或path-like對(duì)象。

restore_signals：限于POSIX，略

start_new_session：限于POSIX，略

env：dict對(duì)象，為新進(jìn)程定義環(huán)境變量，替換繼承自父進(jìn)程的變量。在Windows下，要運(yùn)行side-by-side assembly必須包含可用的環(huán)境變量SystemRoot。如果指定了env，就必須提供程序執(zhí)行依賴的所有環(huán)境變量

encoding/errors/text/universal_newlines：stdin/stdout/stderr默認(rèn)以二進(jìn)制模式打開。但如果指定了encoding/errors或者text為True，將使用指定的encoding和errors以文本模式打開stdin/stdout/stderr。universal_newlines參數(shù)等同于text，用于后向兼容。

startupinfo：僅限于Windows，略

creationflags：僅限于Windows，略

方法

poll()：檢查子進(jìn)程是否終止。返回None表示未終止，否則設(shè)置returncode屬性并返回。

wait(timeout=None)：如果子進(jìn)程在timeout后沒有終止，拋出TimeoutExpired異常。否則設(shè)置returncode屬性并返回。

communicate(input=None, timeout=None)：進(jìn)程交互：發(fā)送數(shù)據(jù)到stdin，讀取stdout或stderr的數(shù)據(jù)知道讀取到結(jié)束符。返回(stdout_data, stderr_data)形式的元組，元組類型是string或byte。
input為None或要發(fā)送到子進(jìn)程的數(shù)據(jù)，根據(jù)stream打開模式的不同，可以是string或byte類型。
如果要和進(jìn)程的stdin交互，創(chuàng)建Popen對(duì)象時(shí)需要指定stdin=PIPE。類似的，返回的tuple如果希望是非None，需要設(shè)置stdout=PIPE和/或stderr=PIPE。
如果子進(jìn)程在timeout后沒有終止，拋出TimeoutExpired異常，但子進(jìn)程并未kill掉，一個(gè)良好的應(yīng)用應(yīng)該kill掉子進(jìn)程并結(jié)束交互：

proc = subprocess.Popen(...)
try:
    outs, errs = proc.communicate(timeout=15)
except TimeoutExpired:
    proc.kill()
    outs, errs = proc.communicate()

send_signal(signal)：發(fā)送信號(hào)到子進(jìn)程

terminate()：終止子進(jìn)程。POSIX系統(tǒng)上，發(fā)送SIGTERM信號(hào)到子進(jìn)程，Windows系統(tǒng)上會(huì)調(diào)用TerminateProcess()終止進(jìn)程

kill()：強(qiáng)制終止子進(jìn)程。POSIX系統(tǒng)上，發(fā)送SIGKILL信號(hào)到子進(jìn)程。Windows系統(tǒng)上kill()是terminate()的別名

屬性

args：傳入Popen構(gòu)造器的第一個(gè)參數(shù)，list或string類型

stdin：如果傳遞給Popen的stdin參數(shù)是PIPE，該屬性表示string或byte類型的可寫stream對(duì)象。如果傳遞給Popen的stdin參數(shù)不是PIPE，此屬性值為None

stdout：與Popen.stdin相近，但stream對(duì)象是可讀的

stderr：與Popen.stdout相近

pid：子進(jìn)程進(jìn)程號(hào)。如果設(shè)置了shell=True，pid表示派生shell的進(jìn)程號(hào)

returncode：子進(jìn)程返回碼，None表示進(jìn)程未終止。負(fù)數(shù)-N表示進(jìn)程被信號(hào)N終止(僅限POSIX)。

run()函數(shù)運(yùn)行的返回值，表示進(jìn)程執(zhí)行完成。

屬性

args：傳入run()函數(shù)的第一個(gè)參數(shù)，list或string類型

returncode：子進(jìn)程退出碼。如果為負(fù)數(shù)，表示進(jìn)程因?yàn)槟硞€(gè)信號(hào)退出

stdout：捕獲的子進(jìn)程的標(biāo)準(zhǔn)輸出，默認(rèn)為byte類型，如果run()函數(shù)調(diào)用時(shí)指定了encoding或errors，或設(shè)置了text=True則為string類型。如果未捕獲標(biāo)準(zhǔn)輸出返回None

stderr：捕獲的子進(jìn)程的標(biāo)準(zhǔn)錯(cuò)誤，默認(rèn)為byte類型，如果run()函數(shù)調(diào)用時(shí)指定了encoding或errors，或設(shè)置了text=True則為string類型。如果未捕獲標(biāo)準(zhǔn)錯(cuò)誤返回None

方法

check_returncode()：如果returncode非0，拋出CalledProcessError異常

subprocess模塊的異?；?/p> subprocess.TimeoutExpired

子進(jìn)程執(zhí)行超時(shí)。

屬性

cmd：指令

timeout：秒為單位的時(shí)間

output：run()或check_output()函數(shù)捕獲到的子進(jìn)程的輸出，否則為None

stdout：output屬性別名

stderr：run()函數(shù)捕獲到的子進(jìn)程的錯(cuò)誤輸出，否則為None

check_call()或check_output()函數(shù)返回非0狀態(tài)碼時(shí)拋出。

屬性

returncode：子進(jìn)程退出碼。如果為負(fù)數(shù)，表示進(jìn)程因?yàn)槟硞€(gè)信號(hào)退出

cmd：同TimeoutExpired

output：同TimeoutExpired

stdout：同TimeoutExpired

stderr：同TimeoutExpired