sparcli 0.3.0

Lightweight, cross-platform toolkit for styled CLI output and interactive input widgets
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

//! Internal line-level layout helpers shared by output widgets.

use crate::core::geometry::Align;
use crate::core::style::Style;
use crate::core::text::{Line, Span};

/// Builds a line of `width` spaces with the given fill style.
pub(crate) fn blank_line(width: usize, fill: Style) -> Line {
    if width == 0 {
        return Line::default();
    }
    Line::new(vec![Span::styled(" ".repeat(width), fill)])
}

/// Pads `line` to exactly `width` columns according to `align`.
///
/// Lines already at or beyond `width` are returned unchanged.
pub(crate) fn pad_line(
    line: Line,
    width: usize,
    align: Align,
    fill: Style,
) -> Line {
    let current = line.width();
    if current >= width {
        return line;
    }
    let total = width - current;
    let (left, right) = match align {
        Align::Left => (0, total),
        Align::Right => (total, 0),
        Align::Center => (total / 2, total - total / 2),
    };
    let mut spans = Vec::with_capacity(line.spans.len() + 2);
    if left > 0 {
        spans.push(Span::styled(" ".repeat(left), fill));
    }
    spans.extend(line.spans);
    if right > 0 {
        spans.push(Span::styled(" ".repeat(right), fill));
    }
    Line::new(spans)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn pad_line_left_aligns_by_default() {
        let line = pad_line(Line::raw("hi"), 5, Align::Left, Style::new());
        assert_eq!(line.plain(), "hi   ");
    }

    #[test]
    fn pad_line_centers_content() {
        let line = pad_line(Line::raw("hi"), 6, Align::Center, Style::new());
        assert_eq!(line.plain(), "  hi  ");
    }

    #[test]
    fn pad_line_right_aligns_content() {
        let line = pad_line(Line::raw("hi"), 5, Align::Right, Style::new());
        assert_eq!(line.plain(), "   hi");
    }
}