subprocess的popen函数

subprocess的进程创建和管理由Popen类处理。原型:(原型中参数带有的值都是默认值)

class subprocess.Popen(argsbufsize=-1executable=Nonestdin=Nonestdout=Nonestderr=Nonepreexec_fn=Noneclose_fds=Trueshell=Falsecwd=Noneenv=Noneuniversal_newlines=Nonestartupinfo=Nonecreationflags=0restore_signals=Truestart_new_session=Falsepass_fds=()*group=Noneextra_groups=Noneuser=Noneumask=-1encoding=Noneerrors=Nonetext=None)

args参数:一个需要运行的参数序列;默认情况下,如果args是序列,则运行的程序是这个序列中的第一项,比如[“python”,“--version”],运行的cmd就是这个列表中的第一项python;但是如果args是字符串,具体如何实现依赖于具体平台。如果在Windows 上 shell 为 False 并且序列包含字节串和路径类对象则 args 形参可以接受一个 path-like object。参数 shell (默认为 False)指定是否使用 shell 执行程序。如果 shell 为 True,更推荐将 args 作为字符串传递而非序列。如果 args 是一个字符串,则字符串的格式必须和在命令行中所输出的完全相同。在 Windows,使用  shell=True,环境变量 COMSPEC 指定了默认 shell。在 Windows 唯一需要指定 shell=True 的情况是想要执行内置在 shell 中的命令(例如 dir 或者 copy)。在运行一个批处理文件或者基于控制台的可执行文件时,不需要 shell=True。

def cmd_run(cmd):

    print("the cmd is {}".format(cmd))

   subproc = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, universal_newlines=True, creationflags=subprocess.CREATE_NEW_PROCESS_GROUP,shell=True) #设置shell为true

    while True:

        out = subproc.stdout.readline()

        if out:

            print(out)

        else:

            break

cmd_run("dir")

输出:

windows上运行dir

如果没有设置shell为True,则在windows上无法运行这个cmd。

executable 参数指定一个要执行的替换程序,比较少用到这个参数。当 shell=True, executable 替换 args 指定运行的程序。但是,原始的 args 仍然被传递给程序。

在 3.6 版更改: 在POSIX 上 executable 形参可以接受一个 path-like object。

在 3.8 版更改: 在Windows 上 executable 形参可以接受一个字节串和 path-like object。

stdinstdout 和 stderr 分别指定被运行的程序的标准输入、输出和标准错误的文件句柄。合法的值有 PIPE , DEVNULL , 一个存在的文件描述符(一个正整数),一个存在的 文件对象 以及 None。 PIPE 表示应创建一个新的对子进程的管道。 DEVNULL 表示使用特殊的 os.devnull 文件。使用默认的 None,则不进行成定向;子进程的文件流将继承自父进程。另外, stderr 可设为 STDOUT,表示应用程序的标准错误数据应和标准输出一同捕获。

如果 close_fds 为真,所有文件描述符除了 0, 1, 2 之外都会在子进程执行前关闭。而当 close_fds 为假时,文件描述符遵守它们继承的标志如 文件描述符的继承 所述。在 Windows,如果 close_fds 为真, 则子进程不会继承任何句柄,除非在  STARTUPINFO.IpAttributeList 的  handle_list的键中显式传递,或者通过标准句柄重定向传递。

如果 cwd 不为 None,此函数在执行子进程前会将当前工作目录改为 cwd。 cwd 可以是一个字符串、字节串或 路径类对象 。 特别地,当可执行文件的路径为相对路径时,此函数会相对于*cwd* 来查找 executable (或 args 中的第一个条目)。

在 3.6 版更改: 在 POSIX 上 cwd 形参接受一个 path-like object。

在 3.7 版更改: 在 Windows 上 cwd 形参接受一个 path-like object。

在 3.8 版更改: 在 Windows 上 cwd 形参接受一个字节串对象。

如果 encoding 或 errors 被指定,或者 text 为 true,则文件对象 stdinstdout 和 stderr 将会以指定的编码和 errors 以文本模式打开,如同 常用参数 所述。 

universal_newlines 参数等同于 text 并且提供向后兼容性。默认情况下,文件对象都以二进制模式打开。

如果给出, startupinfo 将是一个将被传递给底层的 CreateProcess 函数的 STARTUPINFO 对象。

creationflags,如果给出,可以是一个或多个以下标志之一:

CREATE_NEW_CONSOLE

CREATE_NEW_PROCESS_GROUP

ABOVE_NORMAL_PRIORITY_CLASS

BELOW_NORMAL_PRIORITY_CLASS

HIGH_PRIORITY_CLASS

IDLE_PRIORITY_CLASS

NORMAL_PRIORITY_CLASS

REALTIME_PRIORITY_CLASS

CREATE_NO_WINDOW

DETACHED_PROCESS

CREATE_DEFAULT_ERROR_MODE

CREATE_BREAKAWAY_FROM_JOB

Popen 对象支持通过 with 语句作为上下文管理器,在退出时关闭文件描述符并等待进程:。

在 3.6 版更改: 现在,如果 Popen 析构时子进程仍然在运行,则析构器会发送一个 ResourceWarning 警告。

在 3.8 版更改: 在某些情况下 Popen 可以使用 os.posix_spawn() 以获得更好的性能。在适用于 Linux 的 Windows 子系统和 QEMU 用户模拟器上,使用 os.posix_spawn() 的 Popen 构造器不再会因找不到程序等错误而引发异常,而是上下级进程失败并返回一个非零的 returncode。

异常

在子进程中抛出的异常,在新的进程开始执行前,将会被再次在父进程中抛出。

最常见的被抛出异常是 OSError。例如,当尝试执行一个不存在的文件时就会发生。应用程序需要为 OSError 异常做好保护。

如果 Popen 调用时有无效的参数,则一个 ValueError 将被抛出

check_all() 与 check_output() 在调用的进程返回非零退出码时将抛出 CalledProcessError。

所有接受 timeout 形参的函数与方法,例如 call() 和 Popen.communicate() 将会在进程退出前超时到期时抛出 TimeoutExpired。

此模块中定义的异常都继承自 SubprocessError。

你可能感兴趣的:(subprocess的popen函数)