gitstack 5.3.0

Git history viewer with insights - Author stats, file heatmap, code ownership
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

/// A struct providing common state and operations for list navigation
#[derive(Debug, Clone)]
pub struct ListNavigation {
    pub selected_index: usize,
    pub scroll_offset: usize,
}

impl ListNavigation {
    pub fn new() -> Self {
        Self {
            selected_index: 0,
            scroll_offset: 0,
        }
    }

    /// Move selection up (also adjusts scroll offset)
    pub fn move_up(&mut self) {
        if self.selected_index > 0 {
            self.selected_index -= 1;
            if self.selected_index < self.scroll_offset {
                self.scroll_offset = self.selected_index;
            }
        }
    }

    /// Move selection down
    pub fn move_down(&mut self, max_len: usize) {
        if max_len > 0 && self.selected_index < max_len - 1 {
            self.selected_index += 1;
        }
    }

    /// Adjust scroll offset based on visible line count
    pub fn adjust_scroll(&mut self, visible_lines: usize) {
        if visible_lines == 0 {
            return;
        }
        if self.selected_index >= self.scroll_offset + visible_lines {
            self.scroll_offset = self.selected_index - visible_lines + 1;
        }
    }

    /// Reset selection and scroll
    pub fn reset(&mut self) {
        self.selected_index = 0;
        self.scroll_offset = 0;
    }
}

impl Default for ListNavigation {
    fn default() -> Self {
        Self::new()
    }
}

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

    #[test]
    fn test_new_initializes_to_zero() {
        let nav = ListNavigation::new();
        assert_eq!(nav.selected_index, 0);
        assert_eq!(nav.scroll_offset, 0);
    }

    #[test]
    fn test_move_up_decrements_index() {
        let mut nav = ListNavigation::new();
        nav.selected_index = 3;
        nav.move_up();
        assert_eq!(nav.selected_index, 2);
    }

    #[test]
    fn test_move_up_does_not_go_below_zero() {
        let mut nav = ListNavigation::new();
        nav.move_up();
        assert_eq!(nav.selected_index, 0);
    }

    #[test]
    fn test_move_up_adjusts_scroll_offset() {
        let mut nav = ListNavigation::new();
        nav.selected_index = 5;
        nav.scroll_offset = 5;
        nav.move_up();
        assert_eq!(nav.selected_index, 4);
        assert_eq!(nav.scroll_offset, 4);
    }

    #[test]
    fn test_move_down_increments_index() {
        let mut nav = ListNavigation::new();
        nav.move_down(5);
        assert_eq!(nav.selected_index, 1);
    }

    #[test]
    fn test_move_down_does_not_exceed_max() {
        let mut nav = ListNavigation::new();
        nav.selected_index = 4;
        nav.move_down(5);
        assert_eq!(nav.selected_index, 4);
    }

    #[test]
    fn test_move_down_empty_list() {
        let mut nav = ListNavigation::new();
        nav.move_down(0);
        assert_eq!(nav.selected_index, 0);
    }

    #[test]
    fn test_adjust_scroll_scrolls_down() {
        let mut nav = ListNavigation::new();
        nav.selected_index = 10;
        nav.adjust_scroll(5);
        assert_eq!(nav.scroll_offset, 6);
    }

    #[test]
    fn test_adjust_scroll_zero_visible() {
        let mut nav = ListNavigation::new();
        nav.selected_index = 10;
        nav.adjust_scroll(0);
        assert_eq!(nav.scroll_offset, 0);
    }

    #[test]
    fn test_reset() {
        let mut nav = ListNavigation::new();
        nav.selected_index = 5;
        nav.scroll_offset = 3;
        nav.reset();
        assert_eq!(nav.selected_index, 0);
        assert_eq!(nav.scroll_offset, 0);
    }
}