mame 0.3.0

Common building blocks to build TUI applications.
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
55
56
57
58
59
60
61
62
63
64
65
66
67

use std::collections::BTreeMap;

use crate::action::{Action, BindingContextName};
use crate::matcher::InputMatcher;

#[derive(Debug, Clone)]
pub(crate) struct ContextualBindings<A> {
    pub(crate) bindings: BTreeMap<BindingContextName, Vec<Binding<A>>>,
}

impl<'text, 'raw, A: Action> TryFrom<nojson::RawJsonValue<'text, 'raw>> for ContextualBindings<A> {
    type Error = nojson::JsonParseError;

    fn try_from(value: nojson::RawJsonValue<'text, 'raw>) -> Result<Self, Self::Error> {
        Ok(Self {
            bindings: value
                .to_object()?
                .map(|(k, v)| {
                    let context_name = k.try_into()?;
                    let bindings = v.try_into()?;
                    Ok((context_name, bindings))
                })
                .collect::<Result<_, _>>()?,
        })
    }
}

/// A single input binding that maps terminal input patterns to actions within a context.
#[derive(Debug, Clone)]
pub struct Binding<A> {
    /// Input patterns that trigger this binding (keyboard keys, mouse events, etc.)
    pub triggers: Vec<InputMatcher>,

    /// Optional human-readable label for display purposes
    pub label: Option<String>,

    /// Optional action to execute when the binding is triggered
    pub action: Option<A>,

    /// Optional context to switch to when this binding is activated
    pub context: Option<BindingContextName>,
}

impl<A: Action> Binding<A> {
    /// Checks if this binding matches the given terminal input.
    ///
    /// Returns `true` if any of the binding's triggers match the provided input.
    pub fn matches(&self, input: tuinix::TerminalInput) -> bool {
        self.triggers.iter().any(|t| t.matches(input))
    }
}

impl<'text, 'raw, A: Action> TryFrom<nojson::RawJsonValue<'text, 'raw>> for Binding<A> {
    type Error = nojson::JsonParseError;

    fn try_from(value: nojson::RawJsonValue<'text, 'raw>) -> Result<Self, Self::Error> {
        Ok(Self {
            triggers: value
                .to_member("triggers")?
                .map(TryFrom::try_from)?
                .unwrap_or_default(),
            label: value.to_member("label")?.map(TryFrom::try_from)?,
            action: value.to_member("action")?.map(TryFrom::try_from)?,
            context: value.to_member("context")?.map(TryFrom::try_from)?,
        })
    }
}