Terminal

The Terminal class manages a child process running in a pseudo-terminal with VT100 emulation.

Creating Terminals

Use the terminal fixture (a factory function):

def test_example(terminal):
    # Default: 30 rows, 80 columns
    term = terminal("python my_app.py")

    # Custom dimensions
    term = terminal("python my_app.py", rows=24, cols=120)

    # Custom environment variables
    term = terminal("python my_app.py", env={"DEBUG": "1"})

Reading the Screen

# Full buffer as 2D list of characters
buffer = term.get_buffer()      # list[list[str]]

# Visible portion (same as get_buffer for now)
visible = term.get_viewable_buffer()

# Screen as string (for debugging)
text = term._get_screen_text()

Cursor Position

cursor = term.get_cursor()  # CursorPosition(x=0, y=5)
print(cursor.x, cursor.y)

Resizing

term.set_size(rows=40, cols=120)

The child process receives a SIGWINCH signal, just like a real terminal resize.

Cleanup

Terminals are automatically killed when the test ends (via the fixture). You can also kill manually:

term.kill()