term-basics-linux 1.0.1

A simple crate with basic functionality for terminal 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
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

use term_basics_linux as tbl;

pub fn main() {
    test_test_chars();
    test_getch();
    test_input_field_simple();
    test_number_parse();
    test_input_history_new();
    test_input_history_add();
    test_input_history_get_index();
    test_input_field_scrollable();
    test_prompt_char();
    test_prompt_custom();
}

#[allow(unused)]
fn test_getch() {
    let x = tbl::getch();
    println!("{}", x as char);
}

#[allow(unused)]
fn test_test_chars() {
    tbl::test_chars();
}

#[allow(unused)]
fn test_input_field_simple() {
    print!("type your name: ");
    let name = tbl::input_field_simple(true);
    println!("your name: {name}");
}

#[allow(unused)]
fn test_number_parse() {
    print!("type your age: ");
    let user_input = tbl::input_field_simple(true);
    let age: Option<u8> = tbl::string_to_value(&user_input);
    if let Some(agev) = age { println!("Your age: {}", agev); }
    else { println!("Invalid age!"); }
}

#[allow(unused)]
fn test_input_history_new() {
    let mut his = tbl::InputList::new(10);
    let _ = tbl::input_field_scrollable(&mut his, true);
}

#[allow(unused)]
fn test_input_history_add() {
    let mut his = tbl::InputList::new(2);
    his.add("zero");
    his.add("one");
    his.add("two");
    // only "one" and "two" will remain, as "zero" is removed.
    println!("{}", tbl::input_field_scrollable(&mut his, true));
}

#[allow(unused)]
fn test_input_history_get_index() {
    let mut his = tbl::InputList::new(3);
    his.add("0");
    his.add("1");
    his.add("2");
    println!("at -2: {:?}", his.get_index(-2));
    println!("at -1: {:?}", his.get_index(-1));
    println!("at  0: {:?}", his.get_index(0));
    println!("at  1: {:?}", his.get_index(1));
    println!("at  2: {:?}", his.get_index(2));
    println!("at  3: {:?}", his.get_index(3));
    println!("at  4: {:?}", his.get_index(4));
}

#[allow(unused)]
fn test_input_field_scrollable() {
    let mut his = tbl::InputList::new(10);
    his.add("previously typed in name");
    print!("type your name: ");
    let name = tbl::input_field_scrollable(&mut his, true);
    println!("your name: {name}");
}

#[allow(unused)]
fn test_prompt_char() {
    println!("{}", tbl::input_field(&mut tbl::InputList::new(0), tbl::PrintChar::Copy, true));
    println!("{}",
        tbl::input_field(&mut tbl::InputList::new(0), tbl::PrintChar::Substitute('*'), true)
    );
    println!("{}", tbl::input_field(&mut tbl::InputList::new(0), tbl::PrintChar::None, true));
}

#[allow(unused)]
fn test_prompt_custom() {
    let mut his = tbl::InputList::new(2);
    his.add("hidden option 0");
    his.add("hidden option 1"); // provide options but the user can't see them.
    print!("enter input: ");
    let x = tbl::input_field(&mut his, tbl::PrintChar::None, true);
    println!("{x}");
}

// documentation integration tests, that are not included above

#[allow(unused)]
fn test_getch_docu() {
    // print user input until spacebar is pressed
    loop{
        let x = tbl::getch();
        if x == 32 { break; }
        print!("{}", x as char);
    }
}