netspd 0.1.1

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

//! Responsive layout helpers.

use ratatui::layout::Rect;

/// Coarse terminal-size classes the screens adapt to.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Breakpoint {
    /// Small terminals (~80x24): stacked cards, tight spacing.
    Compact,
    /// Medium terminals (~100x30): side-by-side cards.
    Normal,
    /// Large terminals (120x40 and beyond): generous whitespace.
    Wide,
}

/// Classifies a screen body area into a [`Breakpoint`].
///
/// Thresholds are body-relative: screens receive the frame minus the
/// header and footer (4 rows), so a 100×30 terminal arrives here as
/// 100×26.
#[must_use]
pub fn breakpoint(area: Rect) -> Breakpoint {
    if area.width >= 120 && area.height >= 32 {
        Breakpoint::Wide
    } else if area.width >= 96 && area.height >= 24 {
        Breakpoint::Normal
    } else {
        Breakpoint::Compact
    }
}

/// Centers a `width` x `height` box inside `area`, clamping to fit.
#[must_use]
pub fn centered(area: Rect, width: u16, height: u16) -> Rect {
    let width = width.min(area.width);
    let height = height.min(area.height);
    Rect {
        x: area.x + (area.width - width) / 2,
        y: area.y + (area.height - height) / 2,
        width,
        height,
    }
}

/// Shrinks an area by a horizontal and vertical margin on each side.
#[must_use]
pub fn padded(area: Rect, horizontal: u16, vertical: u16) -> Rect {
    let dx = horizontal.min(area.width / 2);
    let dy = vertical.min(area.height / 2);
    Rect {
        x: area.x + dx,
        y: area.y + dy,
        width: area.width - dx * 2,
        height: area.height - dy * 2,
    }
}