Terminal

Ein terminal.host führt Lua-Skripte mit Standard-Eingabe-, Standard-Ausgabe- und Standard-Fehlerströmen aus. Diese Seite ist eine Konfigurationsreferenz; das Lua-Beispiel ist ein Handler-Fragment, das die Ausführung über diesen Host voraussetzt.

Ein Terminal-Host führt genau einen Prozess gleichzeitig aus. Der Prozess selbst ist ein regulärer Lua-Prozess mit Zugriff auf Terminal-I/O-Kontext.

Entry-Typ

Art Beschreibung
terminal.host Terminal-Sitzungs-Host

Konfiguration

- name: cli_host
  kind: terminal.host
  hide_logs: false
  lifecycle:
    auto_start: true
Feld Typ Standard Beschreibung
hide_logs bool false Logs an den Event-Bus streamen und dabei die nachgelagerte Log-Weiterleitung unterdrücken

Terminal-Kontext

Skripte, die auf einem Terminal-Host laufen, erhalten einen Terminal-Kontext mit:

  • stdin - Standard-Eingabe-Reader
  • stdout - Standard-Ausgabe-Writer
  • stderr - Standard-Fehler-Writer
  • args - Kommandozeilenargumente

Komponierbare Terminals

Das Terminal, das ein Prozess sieht, ist ein Port, kein Gerät. Damit wird die Terminal-Zugehörigkeit komponierbar.

Ein Prozess auf einem Terminal-Host hält den physischen Port. Er ruft tty.surface() auf, um die Präsentations-Lease des Ports zu übernehmen, und veröffentlicht vollständige Frames — er besitzt den gesamten Bildschirm.

Ein Shell-Prozess hostet andere Prozesse, indem er mit tty.viewport() virtuelle Terminals erstellt. Er übergibt viewport:grant() über die Spawn-Option terminal an einen Kindprozess; der Kindprozess löst diesen Grant in einen gewöhnlichen Terminal-Port auf und läuft unverändert, ohne zu wissen, dass er nicht an einem Gerät hängt. Die Shell liest die Frames des Kindprozesses mit viewport:snapshot(), platziert sie beliebig in ihrem eigenen Layout und übersetzt Eingaben mit viewport:send() in die Koordinaten des Kindprozesses.

local view = assert(tty.viewport({width = 78, height = 20}))
local child = assert(process.with_options({terminal = assert(view:grant())})
    :spawn_monitored("app:child", "app:workers"))

Ein Grant ist einmalig: Die Prozesszulassung verbraucht ihn, ein abgelehnter Start lässt ihn unaufgelöst, und ein Host, der keine Terminals anhängen kann, lehnt den Spawn ab, statt die Option zu verwerfen.

Byte-orientierte Programme fügen sich über exec in dasselbe Modell ein. Ein Kindprozess allokiert einen PTY-Prozess und ruft process:attach_terminal() auf; dieser Adapter übernimmt PTY-Emulation, Eingabekodierung, Größenänderung und Beendigung und präsentiert auf dem Port, den der Kindprozess hält — physisch oder virtuell.

physisches Terminal -> Shell-Surface -> Viewport -> Kindprozess -> PTY-Proxy

Lua-API

Das IO-Modul bietet zeilenorientierte Terminal-Operationen:

local io = require("io")

local _, write_err = io.write("Enter name: ")
if write_err then return nil, write_err end

local name, read_err = io.readline()
if read_err then return nil, read_err end

local _, print_err = io.print("Hello, " .. name)
if print_err then return nil, print_err end

local args = io.args()

io.write, io.print und io.readline geben außerhalb eines Terminal-Kontexts Fehler zurück. io.args() gibt eine leere Tabelle zurück, wenn kein Terminal-Kontext verfügbar ist.

Für rohe Eingabeereignisse, gestaltetes Rendering, Surfaces und Viewports siehe TTY. Für PTY-Prozesse und Terminal-Sessions siehe Kommandoausführung.

Siehe auch

  • Terminal I/O — stdin/stdout/stderr-Operationen
  • TTY — Eingabeereignisse, Surfaces, Canvases und Viewports
  • Kommandoausführung — PTY-Prozesse und Terminal-Sessions
  • Terminal-UI — eine Shell bauen, die einen Kindprozess in einem Viewport hostet