Skip to main content

35.8. pty —伪终端实用程序

源代码: Lib/pty.py


pty 模块定义用于处理伪终端概念的操作:启动另一个进程并且能够以编程方式对其控制终端进行写入和读取。

因为伪终端处理高度依赖于平台,所以有代码只为Linux做它。 (Linux代码应该在其他平台上工作,但还没有经过测试。)

pty 模块定义以下功能:

pty.fork()

叉子。将孩子的控制终端连接到伪终端。返回值为 (pid, fd)。注意,孩子得到 pid 0,而 fdinvalid。父的返回值是孩子的 pidfd 是连接到孩子的控制终端(以及孩子的标准输入和输出)的文件描述符。

pty.openpty()

打开一个新的伪终端对,如果可能使用 os.openpty(),或仿真代码为通用的Unix系统。返回一对文件描述符 (master, slave),分别用于主端和从端。

pty.spawn(argv[, master_read[, stdin_read]])

产生一个进程,并将其控制终端与当前进程的标准io连接。这通常用于阻挡坚持从控制终端读取的程序。

函数 master_readstdin_read 应该是从文件描述符读取的函数。默认值尝试在每次调用时读取1024字节。

在 3.4 版更改: spawn() 现在从子进程的 os.waitpid() 返回状态值。

35.8.1. 例

以下程序的行为类似于Unix命令 script(1),使用伪终端在“typescript”中记录终端会话的所有输入和输出。

import argparse
import os
import pty
import sys
import time

parser = argparse.ArgumentParser()
parser.add_argument('-a', dest='append', action='store_true')
parser.add_argument('-p', dest='use_python', action='store_true')
parser.add_argument('filename', nargs='?', default='typescript')
options = parser.parse_args()

shell = sys.executable if options.use_python else os.environ.get('SHELL', 'sh')
filename = options.filename
mode = 'ab' if options.append else 'wb'

with open(filename, mode) as script:
    def read(fd):
        data = os.read(fd, 1024)
        script.write(data)
        return data

    print('Script started, file is', filename)
    script.write(('Script started on %s\n' % time.asctime()).encode())

    pty.spawn(shell, read)

    script.write(('Script done on %s\n' % time.asctime()).encode())
    print('Script done, file is', filename)