keymap 1.0.0-rc.5

A lightweight key mapping library with compile-time validated derive macros and declarative configuration for multiple backends.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

use keymap::{KeyMap, ToKeyMap};
use serde::Deserialize;
use std::collections::HashMap;

#[path = "./backend/mod.rs"]
mod backend;
use crate::backend::{print, quit, run};

#[derive(Debug, Deserialize, PartialEq)]
enum Action {
    Jump,
    Up,
    Down,
    Left,
    Right,
    Quit,
}

#[allow(unused)]
#[derive(Debug, Deserialize)]
struct Config(pub HashMap<KeyMap, Action>);

#[allow(unused)]
const CONFIG: &str = r#"
up     = "Up"
down   = "Down"
left   = "Left"
right  = "Right"
ctrl-g = "Jump"
space  = "Jump"
q      = "Quit"
esc    = "Quit"
"#;

fn main() -> std::io::Result<()> {
    let config: Config = toml::from_str(CONFIG).unwrap();
    println!("# Example: Basic key mapping without derive macros");

    run(|key| {
        let Some((_, action)) = config.0.get_key_value(&key.to_keymap().unwrap()) else {
            print(&format!("{key:?}"));
            return false;
        };

        match action {
            Action::Up => print("Up!"),
            Action::Down => print("Down!"),
            Action::Jump => print("Jump!"),
            Action::Left => print("Left!"),
            Action::Right => print("Right!"),
            Action::Quit => quit("quit"),
        }
    })
}