kewt-test/dev.kewt.test/TestTerminal

TestTerminal

class TestTerminal(width: Int = 80, height: Int = 24) : Terminal(source)

A mock implementation of Terminal for use in unit and integration tests.

It allows simulating user input, tracking terminal state changes (like cursor movement or raw mode transitions), and capturing raw ANSI output.

Parameters

width

The initial width of the terminal.

height

The initial height of the terminal.

Constructors

TestTerminal

constructor(width: Int = 80, height: Int = 24)

Properties

cursorX

var cursorX: Int

The current horizontal position of the cursor (0-indexed).

cursorY

var cursorY: Int

The current vertical position of the cursor (0-indexed).

isCursorHidden

var isCursorHidden: Boolean

Whether the terminal cursor is currently hidden.

isRawMode

var isRawMode: Boolean

Whether the terminal is currently in raw mode.

windowTitle

var windowTitle: String

The current window title.

Functions

clear

open override fun clear()

clearLine

open override fun clearLine()

enterRawMode

open override fun enterRawMode()

exitRawMode

open override fun exitRawMode()

flush

open override fun flush()

hideCursor

open override fun hideCursor()

moveCursor

open override fun moveCursor(x: Int, y: Int)

output

fun output(): String

Returns the raw ANSI output captured since the last clear.

poll

open override fun poll(timeoutMs: Int): Boolean

In a test environment, poll returns true immediately if there are pending events.

read

open override fun read(): Event?

resize

fun resize(width: Int, height: Int)

Simulates a terminal resize event.

sendChar

fun sendChar(c: Char)

Simulates the user typing a single character.

sendKey

fun sendKey(key: Key, modifiers: Set<KeyModifier> = emptySet())

Simulates the user pressing a specific key.

setTitle

open override fun setTitle(title: String)

showCursor

open override fun showCursor()

size

open override fun size(): Size

write

open override fun write(text: String)