charm.input.handler — de.timokramer/charm.clj 0.1.42

Terminal input handling.

Reads raw terminal input and converts it to structured key and mouse events.

create-handler clj

(create-handler terminal)

Create an input handler for a terminal.

Returns a map with: :terminal - The terminal :keymap - Terminal-aware KeyMap for escape sequences :read-event - Function to read next event :stop - Function to stop the handler

parse-input clj

(parse-input byte-val)

(parse-input byte-val escape-seq)

(parse-input byte-val escape-seq keymap)

Parse a raw input byte into an event. For escape sequences, pass the sequence after ESC. Optionally accepts a KeyMap for terminal-aware sequence lookup.

read-event clj

(read-event terminal & {:keys [timeout-ms keymap] :or {timeout-ms 50}})

Read a single input event from the terminal. Returns an event map with :type and other keys, or nil on timeout.

Options: :timeout-ms - Timeout for reading (default 50) :keymap - KeyMap for escape sequence lookup (optional, creates terminal-aware one if nil)

read-events clj

(read-events terminal & opts)

Create a lazy sequence of input events from the terminal. Blocks waiting for each event.

Options: :timeout-ms - Timeout for reading (default 50) :keymap - KeyMap for escape sequence lookup (optional)