ketraterm-testkit/io.github.ketraterm.testkit

Package-level declarations

Types

MockConnector

class MockConnector : TerminalConnector

In-memory connector for session and transport-adapter tests.

TerminalByteSequence

class TerminalByteSequence

Immutable byte sequence with content-based value semantics.

TerminalCellSnapshot

data class TerminalCellSnapshot(val codepoint: Int, val cluster: String?, val attributes: Long, val extraAttributes: Long, val flags: Int, val hyperlinkId: Int)

One public-render-ABI cell in a conformance snapshot.

TerminalConformanceDiff

data class TerminalConformanceDiff(val differences: List<TerminalConformanceDifference>, val truncated: Boolean)

Bounded comparison result for two terminal conformance snapshots.

TerminalConformanceDiffer

object TerminalConformanceDiffer

Field-level comparer for canonical terminal conformance snapshots.

TerminalConformanceDifference

data class TerminalConformanceDifference(val path: String, val expected: String, val actual: String, val context: String? = null)

One field-level mismatch between two terminal conformance snapshots.

TerminalConformanceHarness

class TerminalConformanceHarness @JvmOverloads constructor(columns: Int, rows: Int, maxHistory: Int = 1000)

Deterministic headless parser-to-core conformance harness.

TerminalConformanceSnapshot

data class TerminalConformanceSnapshot(val columns: Int, val visibleRows: Int, val historyRows: Int, val discardedRows: Long, val liveRowStart: Int, val activeBuffer: TerminalSnapshotBufferKind, val cursor: TerminalCursorSnapshot, val modes: TerminalModeStateSnapshot, val retainedRows: List<TerminalRowSnapshot>, val windowTitle: String, val iconTitle: String, val activeHyperlinkUri: String?, val activeHyperlinkId: String?, val outboundBytes: TerminalByteSequence)

Canonical observable result of a parser-to-core terminal replay.

TerminalCursorSnapshot

data class TerminalCursorSnapshot(val column: Int, val row: Int, val visible: Boolean, val blinking: Boolean, val shape: String)

Cursor state detached from a short-lived render frame.

TerminalDifferentialComparator

object TerminalDifferentialComparator

Compares only semantics exposed by both KetraTerm and the public xterm.js API.

TerminalDifferentialOracle

fun interface TerminalDifferentialOracle

Independent terminal implementation capable of replaying KetraTerm transcripts.

TerminalDifferentialResult

data class TerminalDifferentialResult(val oracle: TerminalOracleIdentity, val differences: List<TerminalConformanceDifference>, val truncated: Boolean)

Result of comparing KetraTerm with an independent terminal implementation.

TerminalModeStateSnapshot

data class TerminalModeStateSnapshot(val insertMode: Boolean, val autoWrap: Boolean, val applicationCursorKeys: Boolean, val applicationKeypad: Boolean, val backarrowKeyModeExplicit: Boolean, val backarrowKeySendsBackspace: Boolean, val originMode: Boolean, val newLineMode: Boolean, val leftRightMarginMode: Boolean, val reverseVideo: Boolean, val cursorVisible: Boolean, val cursorBlinking: Boolean, val bracketedPaste: Boolean, val focusReporting: Boolean, val ambiguousWidthIsWide: Boolean, val mouseTrackingMode: String, val mouseEncodingMode: String, val modifyOtherKeysMode: Int, val formatOtherKeysMode: Int, val kittyKeyboardFlags: Int, val synchronizedOutput: Boolean, val bellIsUrgent: Boolean, val popOnBell: Boolean)

Semantic durable-mode snapshot for differential comparisons.

TerminalOracleCellSnapshot

data class TerminalOracleCellSnapshot(val text: String, val width: Int, val foreground: TerminalOracleColor, val background: TerminalOracleColor, val bold: Boolean, val italic: Boolean, val dim: Boolean, val underline: Boolean, val blink: Boolean, val inverse: Boolean, val invisible: Boolean, val strikethrough: Boolean, val overline: Boolean)

Cell state available through the public xterm.js buffer API.

TerminalOracleColor

data class TerminalOracleColor(val kind: String, val value: Int)

Normalized color exposed by an independent terminal oracle.

TerminalOracleIdentity

data class TerminalOracleIdentity(val name: String, val version: String)

Identity reported by an independent terminal-emulation oracle.

TerminalOracleModeSnapshot

data class TerminalOracleModeSnapshot(val insertMode: Boolean, val autoWrap: Boolean, val applicationCursorKeys: Boolean, val applicationKeypad: Boolean, val originMode: Boolean, val bracketedPaste: Boolean, val focusReporting: Boolean, val mouseTrackingMode: String, val synchronizedOutput: Boolean)

Modes exposed by the stable public intersection with xterm.js.

TerminalOracleRowSnapshot

data class TerminalOracleRowSnapshot(val wrapsToNext: Boolean, val cells: List<TerminalOracleCellSnapshot>)

One normalized retained row from an independent oracle.

TerminalOracleSnapshot

data class TerminalOracleSnapshot(val oracle: TerminalOracleIdentity, val columns: Int, val visibleRows: Int, val historyRows: Int, val liveRowStart: Int, val activeBuffer: String, val cursorColumn: Int, val cursorRow: Int, val modes: TerminalOracleModeSnapshot, val retainedRows: List<TerminalOracleRowSnapshot>, val windowTitle: String, val outboundBytes: TerminalByteSequence)

Canonical state returned by a process-isolated terminal oracle.

TerminalPersistentProcessOracle

class TerminalPersistentProcessOracle(command: List<String>, workingDirectory: Path? = null, timeout: Duration = Duration.ofSeconds(10)) : TerminalDifferentialOracle, AutoCloseable

Persistent JSON-lines oracle client for high-volume differential campaigns.

TerminalProcessOracle

class TerminalProcessOracle(command: List<String>, workingDirectory: Path? = null, timeout: Duration = Duration.ofSeconds(10)) : TerminalDifferentialOracle

Versioned JSON-process implementation of TerminalDifferentialOracle.

TerminalReplayChunking

data class TerminalReplayChunking(val name: String, val transcript: TerminalReplayTranscript)

Named parser-chunking variant for one logical host byte stream.

TerminalReplayChunkings

object TerminalReplayChunkings

Generates deterministic parser chunk partitions for conformance tests.

TerminalReplayEvent

sealed interface TerminalReplayEvent

One deterministic operation in a headless terminal replay.

TerminalReplayTranscript

class TerminalReplayTranscript(events: List<TerminalReplayEvent>)

Immutable ordered terminal replay artifact.

TerminalRowSnapshot

data class TerminalRowSnapshot(val wrapped: Boolean, val cells: List<TerminalCellSnapshot>)

One retained terminal row.

TerminalSnapshotBufferKind

enum TerminalSnapshotBufferKind : Enum<TerminalSnapshotBufferKind>

Identifies the active screen in a conformance snapshot.