netspd 0.1.7

A beautiful, modern, minimalistic network speed testing terminal application
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

//! Glyph sets: rich Unicode by default, plain ASCII with `--ascii`.
//!
//! Widgets take their characters from here instead of hardcoding them,
//! so terminals and fonts without braille or block-drawing support get a
//! clean fallback rather than tofu boxes. The active set is chosen once
//! at startup and read everywhere, like a theme.

use std::sync::OnceLock;

use ratatui::symbols::border;

/// One coherent set of UI characters.
#[derive(Debug, Clone, Copy)]
pub struct Glyphs {
    /// Spinner animation frames.
    pub spinner: &'static [&'static str],
    /// Progress bar fill character.
    pub bar_fill: &'static str,
    /// Progress bar sub-cell fills, from thinnest to full.
    pub bar_partials: &'static [&'static str],
    /// Progress bar empty track character.
    pub bar_track: &'static str,
    /// Download direction marker.
    pub down: &'static str,
    /// Upload direction marker.
    pub up: &'static str,
    /// Latency marker.
    pub latency: &'static str,
    /// Success/completion marker.
    pub check: &'static str,
    /// Repeat/auto-restart marker.
    pub repeat: &'static str,
    /// List cursor marker.
    pub cursor: &'static str,
    /// Active list entry marker.
    pub active: &'static str,
    /// Border character set for cards and popups.
    pub border: border::Set<'static>,
    /// Whether braille/block art (dial, big digits, sparklines) is
    /// available.
    pub fancy: bool,
}

/// The default Unicode set.
pub const UNICODE: Glyphs = Glyphs {
    spinner: &["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
    bar_fill: "█",
    bar_partials: &["▏", "▎", "▍", "▌", "▋", "▊", "▉", "█"],
    bar_track: "╌",
    down: "↓",
    up: "↑",
    latency: "⇄",
    check: "✓",
    repeat: "⟳",
    cursor: "▸ ",
    active: " ●",
    border: border::ROUNDED,
    fancy: true,
};

/// The plain ASCII fallback for `--ascii`.
pub const ASCII: Glyphs = Glyphs {
    spinner: &["|", "/", "-", "\\"],
    bar_fill: "#",
    bar_partials: &["#"],
    bar_track: "-",
    down: "v",
    up: "^",
    latency: "<>",
    check: "OK",
    repeat: "~",
    cursor: "> ",
    active: " *",
    border: border::Set {
        top_left: "+",
        top_right: "+",
        bottom_left: "+",
        bottom_right: "+",
        vertical_left: "|",
        vertical_right: "|",
        horizontal_top: "-",
        horizontal_bottom: "-",
    },
    fancy: false,
};

static ACTIVE: OnceLock<&'static Glyphs> = OnceLock::new();

/// Selects the glyph set for the whole session. Call once at startup;
/// later calls are ignored.
pub fn select(ascii: bool) {
    let _ = ACTIVE.set(if ascii { &ASCII } else { &UNICODE });
}

/// The active glyph set (Unicode until [`select`] is called).
#[must_use]
pub fn current() -> &'static Glyphs {
    ACTIVE.get().copied().unwrap_or(&UNICODE)
}

impl Glyphs {
    /// The spinner frame for a UI tick.
    #[must_use]
    pub fn spinner_frame(&self, tick: u64) -> &'static str {
        self.spinner[(tick as usize) % self.spinner.len()]
    }
}