bitcoin_terminal_dashboard/inputs/
key.rs

1use std::fmt::{self, Display, Formatter};
2
3use crossterm::event;
4
5/// Represents an key.
6#[derive(PartialEq, Eq, Clone, Copy, Hash, Debug)]
7pub enum Key {
8    /// Both Enter (or Return) and numpad Enter
9    Enter,
10    /// Tabulation key
11    Tab,
12    /// Backspace key
13    Backspace,
14    /// Escape key
15    Esc,
16
17    /// Left arrow
18    Left,
19    /// Right arrow
20    Right,
21    /// Up arrow
22    Up,
23    /// Down arrow
24    Down,
25
26    /// Insert key
27    Ins,
28    /// Delete key
29    Delete,
30    /// Home key
31    Home,
32    /// End key
33    End,
34    /// Page Up key
35    PageUp,
36    /// Page Down key
37    PageDown,
38
39    /// F0 key
40    F0,
41    /// F1 key
42    F1,
43    /// F2 key
44    F2,
45    /// F3 key
46    F3,
47    /// F4 key
48    F4,
49    /// F5 key
50    F5,
51    /// F6 key
52    F6,
53    /// F7 key
54    F7,
55    /// F8 key
56    F8,
57    /// F9 key
58    F9,
59    /// F10 key
60    F10,
61    /// F11 key
62    F11,
63    /// F12 key
64    F12,
65    Char(char),
66    Ctrl(char),
67    Alt(char),
68    Unknown,
69}
70
71impl Key {
72    /// If exit
73    pub fn is_exit(&self) -> bool {
74        matches!(self, Key::Ctrl('c') | Key::Char('q') | Key::Esc)
75    }
76
77    /// Returns the function key corresponding to the given number
78    ///
79    /// 1 -> F1, etc...
80    ///
81    /// # Panics
82    ///
83    /// If `n == 0 || n > 12`
84    pub fn from_f(n: u8) -> Key {
85        match n {
86            0 => Key::F0,
87            1 => Key::F1,
88            2 => Key::F2,
89            3 => Key::F3,
90            4 => Key::F4,
91            5 => Key::F5,
92            6 => Key::F6,
93            7 => Key::F7,
94            8 => Key::F8,
95            9 => Key::F9,
96            10 => Key::F10,
97            11 => Key::F11,
98            12 => Key::F12,
99            _ => panic!("unknown function key: F{}", n),
100        }
101    }
102}
103
104impl Display for Key {
105    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
106        match *self {
107            Key::Alt(' ') => write!(f, "<Alt+Space>"),
108            Key::Ctrl(' ') => write!(f, "<Ctrl+Space>"),
109            Key::Char(' ') => write!(f, "<Space>"),
110            Key::Alt(c) => write!(f, "<Alt+{}>", c),
111            Key::Ctrl(c) => write!(f, "<Ctrl+{}>", c),
112            Key::Char(c) => write!(f, "<{}>", c),
113            _ => write!(f, "<{:?}>", self),
114        }
115    }
116}
117
118impl From<event::KeyEvent> for Key {
119    fn from(key_event: event::KeyEvent) -> Self {
120        match key_event {
121            event::KeyEvent {
122                code: event::KeyCode::Esc,
123                ..
124            } => Key::Esc,
125            event::KeyEvent {
126                code: event::KeyCode::Backspace,
127                ..
128            } => Key::Backspace,
129            event::KeyEvent {
130                code: event::KeyCode::Left,
131                ..
132            } => Key::Left,
133            event::KeyEvent {
134                code: event::KeyCode::Right,
135                ..
136            } => Key::Right,
137            event::KeyEvent {
138                code: event::KeyCode::Up,
139                ..
140            } => Key::Up,
141            event::KeyEvent {
142                code: event::KeyCode::Down,
143                ..
144            } => Key::Down,
145            event::KeyEvent {
146                code: event::KeyCode::Home,
147                ..
148            } => Key::Home,
149            event::KeyEvent {
150                code: event::KeyCode::End,
151                ..
152            } => Key::End,
153            event::KeyEvent {
154                code: event::KeyCode::PageUp,
155                ..
156            } => Key::PageUp,
157            event::KeyEvent {
158                code: event::KeyCode::PageDown,
159                ..
160            } => Key::PageDown,
161            event::KeyEvent {
162                code: event::KeyCode::Delete,
163                ..
164            } => Key::Delete,
165            event::KeyEvent {
166                code: event::KeyCode::Insert,
167                ..
168            } => Key::Ins,
169            event::KeyEvent {
170                code: event::KeyCode::F(n),
171                ..
172            } => Key::from_f(n),
173            event::KeyEvent {
174                code: event::KeyCode::Enter,
175                ..
176            } => Key::Enter,
177            event::KeyEvent {
178                code: event::KeyCode::Tab,
179                ..
180            } => Key::Tab,
181
182            // First check for char + modifier
183            event::KeyEvent {
184                code: event::KeyCode::Char(c),
185                modifiers: event::KeyModifiers::ALT,
186            } => Key::Alt(c),
187            event::KeyEvent {
188                code: event::KeyCode::Char(c),
189                modifiers: event::KeyModifiers::CONTROL,
190            } => Key::Ctrl(c),
191
192            event::KeyEvent {
193                code: event::KeyCode::Char(c),
194                ..
195            } => Key::Char(c),
196
197            _ => Key::Unknown,
198        }
199    }
200}