Struct KeyTranslator 

pub struct KeyTranslator { /* private fields */ }

Key translation table that normalizes terminal input

Maps raw terminal events to expected/normalized events. For example, if a terminal sends Char(‘\x7f’) for backspace, this translator can map it to KeyCode::Backspace.

Implementations

impl KeyTranslator

pub fn new() -> Self

Create a new empty translator (no translations)

pub fn translate(&self, raw: KeyEvent) -> KeyEvent

Translate a raw terminal event to a normalized event

If a translation exists for the raw event, returns the normalized event. Otherwise, returns the raw event unchanged.

pub fn has_translation(&self, raw: &KeyEvent) -> bool

Check if a translation exists for the given key

pub fn add_translation(&mut self, raw: KeyEvent, expected: KeyEvent)

Add a translation mapping

pub fn remove_translation(&mut self, raw: &KeyEvent)

Remove a translation mapping

pub fn len(&self) -> usize

Get the number of translations

pub fn is_empty(&self) -> bool

Check if there are no translations

pub fn clear(&mut self)

Clear all translations

pub fn load_from_file(path: &Path) -> Result<Self, Error>

Load translations from a JSON file

Returns an empty translator if the file doesn’t exist. Returns an error if the file exists but is invalid.

pub fn save_to_file(&self, path: &Path) -> Result<(), Error>

Save translations to a JSON file

pub fn calibration_path(config_dir: &Path) -> PathBuf

Get the calibration file path for a given config directory.

pub fn load_from_config_dir(config_dir: &Path) -> Result<Self, Error>

Load from the config directory.

pub fn save_to_config_dir(&self, config_dir: &Path) -> Result<(), Error>

Save to the config directory.

Trait Implementations

impl Clone for KeyTranslator

fn clone(&self) -> KeyTranslator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KeyTranslator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for KeyTranslator

fn default() -> KeyTranslator

Returns the “default value” for a type.