subprocess 模組允許我們啟動一個新程序，並連線到它們的輸入/輸出/錯誤管道，從而獲取返回值。

使用 subprocess 模組

subprocess 模組首先推薦使用的是它的 run 方法，更高階的用法可以直接使用 Popen 介面。

run 方法語法格式如下：

subprocess.run(args, *, stdin=None, input=None, stdout=None, stderr=None, capture_output=False, shell=False, cwd=None, timeout=None, check=False, encoding=None, errors=None, text=None, env=None, universal_newlines=None)
 

• args：表示要執行的命令。必須是一個字串，字串引數列表。
• stdin、stdout 和 stderr：子程序的標準輸入、輸出和錯誤。其值可以是 subprocess.PIPE、subprocess.DEVNULL、一個已經存在的檔案描述符、已經開啟的檔案物件或者 None。subprocess.PIPE 表示為子程序建立新的管道。subprocess.DEVNULL 表示使用 os.devnull。預設使用的是 None，表示什麼都不做。另外，stderr 可以合併到 stdout 裡一起輸出。
• timeout：設定命令超時時間。如果命令執行時間超時，子程序將被殺死，並彈出 TimeoutExpired 異常。
• check：如果該引數設定為 True，並且程序退出狀態碼不是 0，則彈 出 CalledProcessError 異常。
• encoding: 如果指定了該引數，則 stdin、stdout 和 stderr 可以接收字串資料，並以該編碼方式編碼。否則只接收 bytes 型別的資料。
• shell：如果該引數為 True，將通過作業系統的 shell 執行指定的命令。

run 方法呼叫方式返回 CompletedProcess 例項，和直接 Popen 差不多，實現是一樣的，實際也是呼叫 Popen，與 Popen 建構函式大致相同，例如:

例項

#執行ls -l /dev/null 命令
>>>subprocess.run(["ls","-l","/dev/null"])
crw-rw-rw- 1root wheel 3,25413:34/dev/null
CompletedProcess(args=['ls','-l','/dev/null'],returncode=0)

returncode

: 執行完子程序狀態，通常返回狀態為0則表明它已經執行完畢，若值為負值 "-N",表明子程序被終。

簡單例項：

例項

importsubprocess
defruncmd(command):
ret=subprocess.run(command,shell=True,stdout=subprocess.PIPE,stderr=subprocess.PIPE,encoding="utf-8",timeout=1)
ifret.returncode==0:
print("success:",ret)
else:
print("error:",ret)


runcmd(["dir","/b"])#序列引數
runcmd("exit 1")#字串引數

輸出結果如下：

success: CompletedProcess(args=['dir', '/b'], returncode=0, stdout='test.py\n', stderr='')
error: CompletedProcess(args='exit 1', returncode=1, stdout='', stderr='')

---

Popen() 方法

Popen 是 subprocess的核心，子程序的建立和管理都靠它處理。

建構函式：

class subprocess.Popen(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=False, 
startupinfo=None, creationflags=0,restore_signals=True, start_new_session=False, pass_fds=(),
*, encoding=None, errors=None)

常用引數：

• args：shell命令，可以是字串或者序列型別（如：list，元組）
• bufsize：緩衝區大小。當建立標準流的管道物件時使用，預設-1。
  0：不使用緩衝區
  1：表示行緩衝，僅當universal_newlines=True時可用，也就是文字模式
  正數：表示緩衝區大小
  負數：表示使用系統預設的緩衝區大小。
• stdin, stdout, stderr：分別表示程式的標準輸入、輸出、錯誤控制代碼
• preexec_fn：只在 Unix 平臺下有效，用於指定一個可執行物件（callable object），它將在子程序執行之前被呼叫
• shell：如果該引數為 True，將通過作業系統的 shell 執行指定的命令。
• cwd：用於設定子程序的當前目錄。
• env：用於指定子程序的環境變數。如果 env = None，子程序的環境變數將從父程序中繼承。

建立一個子程序，然後執行一個簡單的命令:

例項

>>>importsubprocess
>>>p=subprocess.Popen('ls -l',shell=True)
>>>total164
-rw-r--r-- 1root root 133Jul 416:25admin-openrc.sh
-rw-r--r-- 1root root 268Jul1015:55admin-openrc-v3.sh
...
>>>p.returncode
>>>p.wait()
0
>>>p.returncode

這裡也可以使用p = subprocess.Popen(['ls', '-cl'])來建立子程序。

Popen 物件方法

• poll(): 檢查程序是否終止，如果終止返回 returncode，否則返回 None。
• wait(timeout): 等待子程序終止。
• communicate(input,timeout): 和子程序互動，傳送和讀取資料。
• send_signal(singnal): 傳送訊號到子程序 。
• terminate(): 停止子程序,也就是傳送SIGTERM訊號到子程序。
• kill(): 殺死子程序。傳送 SIGKILL 訊號到子程序。

例項

importtime
importsubprocess

defcmd(command):
subp=subprocess.Popen(command,shell=True,stdout=subprocess.PIPE,stderr=subprocess.PIPE,encoding="utf-8")
subp.wait(2)
ifsubp.poll()==0:
print(subp.communicate()[1])
else:
print("失敗")



cmd("java -version")
cmd("exit 1")

輸出結果如下：

java version "1.8.0_31"
Java(TM) SE Runtime Environment (build 1.8.0_31-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.31-b07, mixed mode)

失敗