mtui 0.5.0

An extensive Modbus client (TCP, RTU & mock) 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

use crate::input::KeyCode;
use crate::tui::theme::Theme;
use ratatui::style::Style;
use ratatui::text::{Line, Span};

pub struct Hint {
    key: String,
    label: String,
}

impl Hint {
    pub fn key(kc: KeyCode, label: &str) -> Self {
        Self {
            key: glyph(kc),
            label: label.to_string(),
        }
    }

    pub fn keys(key: impl Into<String>, label: &str) -> Self {
        Self {
            key: key.into(),
            label: label.to_string(),
        }
    }

    pub fn note(label: &str) -> Self {
        Self {
            key: String::new(),
            label: label.to_string(),
        }
    }

    fn width(&self) -> usize {
        if self.key.is_empty() {
            self.label.chars().count()
        } else {
            1 + self.key.chars().count() + 2 + self.label.chars().count()
        }
    }
}

pub fn glyph(kc: KeyCode) -> String {
    match kc {
        KeyCode::Up => "\u{2191}".to_string(),
        KeyCode::Down => "\u{2193}".to_string(),
        KeyCode::Left => "\u{2190}".to_string(),
        KeyCode::Right => "\u{2192}".to_string(),
        KeyCode::PageUp => "PgUp".to_string(),
        KeyCode::PageDown => "PgDn".to_string(),
        other => other.to_string(),
    }
}

pub fn pair(a: KeyCode, b: KeyCode) -> String {
    let arrow = |k| {
        matches!(
            k,
            KeyCode::Up | KeyCode::Down | KeyCode::Left | KeyCode::Right
        )
    };
    if arrow(a) && arrow(b) {
        format!("{}{}", glyph(a), glyph(b))
    } else {
        format!("{}/{}", glyph(a), glyph(b))
    }
}

const SEP: &str = " ";

pub fn width(items: &[Hint]) -> usize {
    let tokens: usize = items.iter().map(Hint::width).sum::<usize>()
        + SEP.chars().count() * items.len().saturating_sub(1);
    tokens + 2 + 2
}

pub fn footer(theme: &Theme, items: &[Hint]) -> Line<'static> {
    let key_style = Style::default().fg(theme.accent);
    let dim = theme.dim_style();
    let mut spans: Vec<Span<'static>> = Vec::with_capacity(items.len() * 5 + 2);
    spans.push(Span::styled(" ", dim));
    for (i, h) in items.iter().enumerate() {
        if i > 0 {
            spans.push(Span::styled(SEP, dim));
        }
        if h.key.is_empty() {
            spans.push(Span::styled(h.label.clone(), dim));
        } else {
            spans.push(Span::styled("[", dim));
            spans.push(Span::styled(h.key.clone(), key_style));
            spans.push(Span::styled("] ", dim));
            spans.push(Span::styled(h.label.clone(), dim));
        }
    }
    spans.push(Span::styled(" ", dim));
    Line::from(spans)
}

pub fn more(theme: &Theme, above: usize, below: usize) -> Line<'static> {
    let dim = theme.dim_style();
    let mut spans: Vec<Span<'static>> = Vec::new();
    if above > 0 {
        spans.push(Span::styled(format!(" \u{2191} {above} more"), dim));
    }
    if above > 0 && below > 0 {
        spans.push(Span::styled(SEP, dim));
    }
    if below > 0 {
        spans.push(Span::styled(format!("\u{2193} {below} more"), dim));
    }
    Line::from(spans)
}