pytty

Pytty is a Python library designed to provide a convenient interface to pseudo-terminals (PTYs) and terminal emulation. It abstracts the underlying OS PTY APIs to let Python programs spawn subprocesses with an attached controlling terminal, manage window sizes, and handle bidirectional I/O.

Key features include creation of PTY pairs (master and slave), spawning subprocesses with the slave end as their controlling TTY, non-blocking and asynchronous I/O, resizing of the terminal window, and optional raw input modes. The library aims for portability on Unix-like systems where PTYs are available; Windows support is limited and may depend on platform-specific components.

Pytty is built to be lightweight and minimally invasive. It typically uses the standard library facilities such as os.openpty, pty, and selectors (or asyncio in higher-level integrations) to provide a clean API that hides lower-level file descriptor management from the user.

Usage generally involves creating a PTY pair, launching a subprocess with the slave end as its standard streams, then reading from and writing to the master end to communicate with the process. Optional features include terminal resize handling, terminal modes, and event-driven I/O.

Applications for pytty include interactive shells, automation and testing of command-line programs, terminal multiplexing, and remote-terminal tooling. The project emphasizes a stable, documented API and careful handling of platform differences to support reliable integration into larger Python applications.