module-subprocess 文档

subprocess，译子进程。
在运行Python程序时，都是在创建并运行一个进程。在Python中，可通过标准库的subprocess模块来fork一个子进程，并运行一个外部程序（如执行一条cmd命令）。subprocess还提供了管理标准流（standard stream）和管道（pipe）的工具，从而在进程之间使用文本通信。

subprocess模块是Python 2.4新增的一个模块，用来替换几个旧的模块和方法（如os.system()、os.spawn*()，甚至os.popen，当然commands更是舍弃了）。

subprocess.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)

Python 3.5中新增的函数。执行指定的命令，等待命令执行完成后返回一个包含执行结果的CompleteProcess类的实例。Python官方建议是尽量使用subprocess.run()函数。

1.1 特有的一些参数：

1.2 常见一些参数：

1.3 举例

import subprocess

cmd = 'pwd'

result = subprocess.run(cmd, shell=True, timeout=3, stderr=subprocess.PIPE, stdout=subprocess.PIPE)

print (result)
CompletedProcess(args='pwd', returncode=0, stdout=b'/home/ta\n', stderr=b'')

print (result.returncode)
0

print (result.stdout)
b'/home/ta\n'

try:
    result = subprocess.run('d', shell=True, timeout=3, stderr=subprocess.PIPE, stdout=subprocess.PIPE, check=True)
except Exception as e:
     print (e.args)
     print (e.cmd)
     print (e.stderr)
     print (e.stdout)
     print (e.returncode)

(127, 'd')
d
b'/bin/sh: d: command not found\n'
b''
127


result = subprocess.run('d', shell=True, timeout=3, stderr=subprocess.PIPE, stdout=subprocess.PIPE)

print (result)
CompletedProcess(args='d', returncode=127, stdout=b'', stderr=b'/bin/sh: d: command not found\n')

subprocess.popen类：

subprocess.Popen类用于创建一个新的进程，让其执行一个子程序，并与它进行通信，获取标准输入、输出、错误以及返回码。
subprocess中的run()、call()、check_call()、check_output()这些函数均是基于subprocess.Popen类实现的，所以当现有函数都无法满足需求时，可使用subprocess.Popen类来封装实现。

2.1 subprocess.Popen类 的构造函数：

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)

Popen类的对象创建之后，主程序不会自动等待子进程完成。所以必须调用wait()方法，父进程才会等待（即阻塞 block）。

参数说明：

• args： 要执行的shell命令，可以是字符串，也可以是序列。
• bufsize： 指定缓存策略，0表示不缓冲，1表示行缓冲，其他大于1的正值数字表示缓冲区大小，负数表示使用系统默认缓冲策略。
• stdin, stdout, stderr： 分别表示程序标准输入、输出、错误句柄。
• preexec_fn： 用于指定一个将在子进程运行之前被调用的可执行对象，只在Unix平台下有效。
• close_fds： 如果该参数的值为True，则除了0,1和2之外的所有文件描述符都将会在子进程执行之前被关闭。
• env： 用于指定子进程的环境变量，如果env=None，那么子进程的环境变量将从父进程中继承。如果env!=None，它的值必须是一个映射对象。
• universal_newlines： 如果该参数值为True，则该文件对象的stdin，stdout和stderr将会作为文本流被打开，否则他们将会被作为二进制流被打开。

2.2 subprocess.Popen类的实例（对象）可调用的方法：

communicate()方法详解：该方法会阻塞父进程，直到子进程完成。

• 该方法中的可选参数 input 应该是将被发送给子进程的数据，默认input=None表示没有数据发送给子进程。input参数的数据类型必须是字节序列或者字符串。
• 该方法返回一个元组(stdout_data, stderr_data)，这些数据将会是字节或字符串。
• timeout秒数后超时，将会抛出一个TimeoutExpired异常。捕获这个异常，然后重新通信不会丢失任何输出的数据。但是超时之后子进程并没有被杀死，所以手动杀死这个子进程来结束通信。
• 注意读取的数据是缓冲在内存中的，所以数据非常大或者是无限大时不建议使用这个方法。

2.3 subprocess.Popen类的实例（对象）拥有的属性：

其他变量

其他函数

上述函数均是父进程等待子进程完成，然后返回对应的结果。

• 在Python 3.5之后的版本，在使用subprocess模块的功能时，官方文档提倡使用subprocess.run()函数 来替代其他函数；这也就是官方文档中提到的Older high-level API。
• 在Python 3.5之前的版本，在使用subprocess模块的功能时，可使用上述如subprocess.call()、subprocess.getoutput()等函数。
• subprocess.run()、subprocess.call()、subprocess.check_call()、subprocess.check_output()都是通过对subprocess.Popen类的封装来实现的高级函数。因此，若要实现更复杂的功能，可通过subprocess.Popen类来完成。
• subprocess.getoutput()、subprocess.getstatusoutput()函数均是来自Python 2.7的commands模块的两个遗留函数。它们隐式地调用系统shell，并且不保证其他函数所具有的安全性和异常处理的一致性。而且，两者从Python 3.3.4才开始支持Windows平台。

归纳

在编码时，需要根据Python 版本的使用不同的subprocess函数。
当然，如果以上函数都无法满足需求时，可使用subprocess.Popen类来封装实现。

引用：

• https://docs.python.org/zh-cn/3/library/subprocess.html?highlight=subprocess#
• https://blog.csdn.net/weixin_38256474/article/details/83117270