a7n-core 0.29.0

Pure state machines for the Apeirogon software KVM
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

// SPDX-License-Identifier: GPL-3.0-or-later

//! Physical inputs reserved for the local machine.

use a7n_proto::v1::{Button, input_event::Event};

use crate::hotkey::{key_name, key_usage};

#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
pub enum LocalInput {
    Key(u32),
    Button(i32),
}

impl LocalInput {
    /// # Errors
    /// Rejects unknown names and primary mouse buttons.
    pub fn parse(name: &str) -> Result<Self, &'static str> {
        match name {
            "left" | "right" => Err("left/right mouse buttons cannot stay local"),
            "middle" => Ok(Self::Button(Button::Middle.into())),
            "back" => Ok(Self::Button(Button::Back.into())),
            "forward" => Ok(Self::Button(Button::Forward.into())),
            _ => key_usage(name)
                .map(Self::Key)
                .ok_or("unknown key or button name"),
        }
    }

    #[must_use]
    pub fn from_event(event: &Event) -> Option<(Self, bool)> {
        match event {
            Event::Key(key) => Some((Self::Key(key.usage), key.down)),
            Event::Button(button) => Some((Self::Button(button.button), button.down)),
            _ => None,
        }
    }

    #[must_use]
    pub fn name(self) -> Option<String> {
        match self {
            Self::Key(usage) => key_name(usage).filter(|name| Self::parse(name) == Ok(self)),
            Self::Button(button) => match Button::try_from(button).ok()? {
                Button::Middle => Some("middle".into()),
                Button::Back => Some("back".into()),
                Button::Forward => Some("forward".into()),
                _ => None,
            },
        }
    }
}