mtui 0.9.5

An extensive Modbus client for your terminal.
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

use num_traits::{CheckedAdd, CheckedDiv, CheckedMul, CheckedNeg, CheckedSub, Zero};

pub fn negate_opt_option<T>(v: &mut Option<T>)
where
    T: CheckedNeg,
{
    *v = v.take().and_then(|n| n.checked_neg());
}

pub fn digit_remove_option<T>(v: &mut Option<T>)
where
    T: Copy + PartialEq + From<u8> + CheckedDiv<Output = T>,
{
    *v = v.and_then(|n| {
        let ten = T::from(10);
        let zero = T::from(0);

        if n.checked_div(&ten) == Some(zero) {
            return None;
        }

        let mut c = n;
        digit_remove(&mut c);
        Some(c)
    });
}

pub fn digit_remove<T>(v: &mut T)
where
    T: Copy + PartialEq + From<u8> + CheckedDiv<Output = T>,
{
    let ten = T::from(10u8);
    if let Some(c) = v.checked_div(&ten) {
        *v = c;
    }
}

pub fn digit_add_option<T>(v: &mut Option<T>, digit: u8)
where
    T: Copy + From<u8> + CheckedAdd<Output = T> + CheckedMul<Output = T>,
{
    *v = v.map_or(Some(T::from(digit)), |n| {
        let mut c = n;
        digit_add(&mut c, digit);
        Some(c)
    });
}

pub fn digit_add<T>(v: &mut T, digit: u8)
where
    T: Copy + From<u8> + CheckedAdd<Output = T> + CheckedMul<Output = T>,
{
    assert!(digit < 10, "digit must be in 0..=9");

    let ten = T::from(10u8);
    let d = T::from(digit);

    if let Some(c) = v.checked_mul(&ten).and_then(|n| n.checked_add(&d)) {
        *v = c;
    }
}

pub fn decrement_option_by<T>(v: &mut Option<T>, by: u16)
where
    T: Copy + From<u16> + CheckedSub<Output = T>,
{
    let zero = T::from(0);

    *v = v.map_or(Some(zero), |c| c.checked_sub(&by.into()).or(Some(c)));
}

pub fn increment_option_by<T>(v: &mut Option<T>, by: u16)
where
    T: Copy + From<u16> + CheckedAdd<Output = T>,
{
    let zero = T::from(0);

    *v = v.map_or(Some(zero), |c| c.checked_add(&by.into()).or(Some(c)));
}

pub fn set_to_zero<T>(v: &mut T)
where
    T: Zero,
{
    *v = T::zero();
}

pub fn set_option_to_zero<T>(v: &mut Option<T>)
where
    T: Zero,
{
    if let Some(v) = v {
        *v = T::zero();
    }
}

pub fn wrap_index(index: u16, len: u16, forward: bool) -> u16 {
    if forward {
        (index + 1) % len
    } else {
        (index + len - 1) % len
    }
}

pub fn cycle<T: Copy + PartialEq>(items: &[T], current: T, forward: bool) -> T {
    if items.is_empty() {
        return current;
    }
    let i = items.iter().position(|x| *x == current).unwrap_or(0);
    let n = items.len();
    let j = if forward {
        (i + 1) % n
    } else {
        (i + n - 1) % n
    };
    items[j]
}

pub fn step_hscroll(current: u16, max: u16, right: bool) -> u16 {
    const STEP: u16 = 8;
    let current = current.min(max);
    if right {
        (current + STEP).min(max)
    } else {
        current.saturating_sub(STEP)
    }
}