terminal_cli 0.2.0

A standalone library with no-std support for command line terminal interfaces. With autocomplete support, helpers for commands and properties and a prompt implementation.
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

use prelude::v1::*;
use keys::*;

/// Terminal key decoder, from raw bytes to decoded key sequences
pub struct TerminalKeyDecoder {
    buffer: Vec<u8>
}

impl TerminalKeyDecoder {
    /// Create a new decoder
	pub fn new() -> TerminalKeyDecoder {
		TerminalKeyDecoder {
			buffer: Vec::new()
		}
	}
}

impl KeyDecoder for TerminalKeyDecoder {
	fn decode(&mut self, byte: u8) -> Result<Key, KeyDecoderError> {
		self.buffer.push(byte);

		let mut more_input_required = false;

		let r = match self.buffer[0] {
			// ESC
			0x1B => {
                match self.buffer.get(1).cloned() {
					Some(0x5B) => {
						match self.buffer.get(2).cloned() {
							Some(0x41) => {
                                Ok(Key::Arrow(DirectionKey::Up))
                            },
                            Some(0x42) => {
                                Ok(Key::Arrow(DirectionKey::Down))
                            },
                            Some(0x43) => {
                                Ok(Key::Arrow(DirectionKey::Right))
                            },
                            Some(0x44) => {
                                Ok(Key::Arrow(DirectionKey::Left))
                            },
                            Some(_) => Err(KeyDecoderError::UnknownSequence),
                            None => Err(KeyDecoderError::MoreInputRequired)
						}
					},
					Some(_) => Err(KeyDecoderError::UnknownSequence),
					None => Err(KeyDecoderError::MoreInputRequired)
				}
			},

            0x7F => {
                Ok(Key::Backspace)
            },
            0x09 => {
                Ok(Key::Tab)
            },            
            0xA => {
                Ok(Key::Newline)
            },
            0x3 => {
                Ok(Key::Break)
            },
            0xD => {
                Ok(Key::CarriageReturn)
            },
            4 => {
                Ok(Key::Eot)
            },
            c => {
            	Ok(Key::Character(c))
            }
		};

        match r {
            Ok(_) | Err(KeyDecoderError::UnknownSequence) => {
                self.buffer.clear()
            },
            Err(KeyDecoderError::MoreInputRequired) => {
                
            }
        }

		r
	}
}

#[test]
fn test_escape_sequences() {
    {
        let mut decoder = TerminalKeyDecoder::new();
        assert_eq!(Err(KeyDecoderError::MoreInputRequired), decoder.decode(27));
        assert_eq!(Err(KeyDecoderError::MoreInputRequired), decoder.decode(91));
        assert_eq!(Ok(Key::Arrow(DirectionKey::Up)), decoder.decode(65));
    }
}