lacquer 0.1.1

Style definitions for gorgeous terminal layouts 💅
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

//! Position and alignment definitions.

/// Horizontal and vertical positioning.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum Position {
    /// Align to the start (left/top).
    #[default]
    Start,
    /// Align to center.
    Center,
    /// Align to the end (right/bottom).
    End,
}

impl Position {
    /// Left alignment (alias for Start).
    pub const LEFT: Self = Self::Start;
    /// Right alignment (alias for End).
    pub const RIGHT: Self = Self::End;
    /// Top alignment (alias for Start).
    pub const TOP: Self = Self::Start;
    /// Bottom alignment (alias for End).
    pub const BOTTOM: Self = Self::End;

    /// Calculate offset for content of given size within container.
    pub fn offset(self, content_size: usize, container_size: usize) -> usize {
        if content_size >= container_size {
            return 0;
        }
        let space = container_size - content_size;
        match self {
            Position::Start => 0,
            Position::Center => space / 2,
            Position::End => space,
        }
    }
}

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

    #[test]
    fn test_position_offset() {
        // Content smaller than container
        assert_eq!(Position::Start.offset(5, 10), 0);
        assert_eq!(Position::Center.offset(5, 10), 2); // (10-5)/2 = 2
        assert_eq!(Position::End.offset(5, 10), 5);

        // Content equal to container
        assert_eq!(Position::Center.offset(10, 10), 0);

        // Content larger than container
        assert_eq!(Position::Center.offset(15, 10), 0);
    }

    #[test]
    fn test_position_aliases() {
        assert_eq!(Position::LEFT, Position::Start);
        assert_eq!(Position::RIGHT, Position::End);
        assert_eq!(Position::TOP, Position::Start);
        assert_eq!(Position::BOTTOM, Position::End);
    }
}