mtui 0.7.3

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

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

pub struct Hint {
    key: String,
    label: &'static str,
}

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

    pub fn pair(a: KeyCode, b: KeyCode, label: &'static str) -> Self {
        Self {
            key: format!("{}/{}", glyph(a), glyph(b)),
            label,
        }
    }

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

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(),
    }
}

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 min_width(min: u16, items: &[Hint]) -> u16 {
    min.max(width(items) as u16)
}

pub fn footer<const N: usize>(theme: &Theme, items: [Hint; N]) -> 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.into_iter().enumerate() {
        if i > 0 {
            spans.push(Span::styled(SEP, dim));
        }

        spans.push(Span::styled("[", dim));
        spans.push(Span::styled(h.key, key_style));
        spans.push(Span::styled("] ", dim));
        spans.push(Span::styled(h.label, 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)
}