a7n-core 0.21.1

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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

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

use super::*;

#[test]
fn poll_hold_deadline_fires_home_once() {
    // Arrange
    for trigger in ["right_alt", "f13"] {
        let mut matcher = matcher();
        matcher.bindings.trigger_mode = TriggerMode::Hold;
        matcher.bindings.double_tap = DoubleTap::parse(trigger).unwrap();
        let usage = key_usage(trigger).unwrap();
        let now = Instant::now();
        let press = matcher.on_key(usage, true, now);
        let deadline = now + matcher.bindings.hold;
        matcher.on_key(
            usage,
            true,
            deadline.checked_sub(Duration::from_millis(1)).unwrap(),
        );

        // Act
        let before = matcher.poll(deadline.checked_sub(Duration::from_millis(1)).unwrap());
        let due = matcher.poll(deadline);
        let again = matcher.poll(deadline);
        let release = matcher.on_key(usage, false, deadline);

        // Assert
        assert_eq!(before, None);
        assert_eq!(due, Some(Hotkey::Home));
        assert_eq!(again, None);
        assert_eq!(release.action, None);
        assert_eq!(matcher.next_deadline(), None);
        assert!(press.forward);
        assert_eq!(release.forward, trigger == "right_alt");
    }
}

#[test]
fn poll_release_or_another_key_cancels_hold() {
    // Arrange
    for (usage, down) in [
        (0x0007_00e6, false),
        (0x0007_0004, true),
        (0x0007_00e0, true),
        (0x0007_00e2, true),
        (0x000c_0001, true),
    ] {
        let mut matcher = matcher();
        matcher.bindings.trigger_mode = TriggerMode::Hold;
        matcher.bindings.double_tap = DoubleTap::parse("either_alt").unwrap();
        let now = Instant::now();
        matcher.on_key(0x0007_00e6, true, now);
        matcher.on_key(usage, down, now + Duration::from_millis(100));
        if down {
            matcher.on_key(0x0007_00e6, true, now + Duration::from_millis(200));
        }

        // Act
        let action = matcher.poll(now + matcher.bindings.hold);

        // Assert
        assert_eq!(action, None);
        assert_eq!(matcher.next_deadline(), None);
    }
}

#[test]
fn poll_trigger_modes_enable_expected_gestures() {
    // Arrange
    for mode in [TriggerMode::DoubleTap, TriggerMode::Hold, TriggerMode::Both] {
        let mut matcher = matcher();
        matcher.bindings.trigger_mode = mode;
        let now = Instant::now();
        let alt = 0x0007_00e6;
        matcher.on_key(alt, true, now);
        let deadline = now + matcher.bindings.hold;

        // Act
        let hold = matcher.poll(deadline);
        matcher.on_key(alt, false, deadline);
        matcher.on_key(alt, true, deadline + Duration::from_secs(1));
        matcher.on_key(alt, false, deadline + Duration::from_secs(1));
        let tap = matcher.on_key(alt, true, deadline + Duration::from_millis(1100));

        // Assert
        assert_eq!(
            hold,
            (mode != TriggerMode::DoubleTap).then_some(Hotkey::Home)
        );
        assert_eq!(
            tap.action,
            (mode != TriggerMode::Hold).then_some(Hotkey::Home)
        );
        if mode != TriggerMode::Hold {
            assert_eq!(matcher.next_deadline(), None);
        }
    }
}

#[test]
fn parse_trigger_keys_accepts_only_non_typing_keys() {
    // Arrange
    let accepted = [
        "f1",
        "f12",
        "f13",
        "f24",
        "scroll_lock",
        "pause",
        "menu",
        "left_ctrl",
        "right_alt",
        "either_shift",
        "none",
    ];
    let rejected = [
        "a",
        "1",
        "space",
        "caps_lock",
        "escape",
        "num_lock",
        "enter",
        "tab",
        "backspace",
        "left",
        "f0",
        "f25",
    ];

    // Act
    let valid = accepted.map(DoubleTap::parse);
    let invalid = rejected.map(DoubleTap::parse);

    // Assert
    assert!(valid.iter().all(Result::is_ok));
    assert!(invalid.iter().all(Result::is_err));
}