shellist 0.2.0

Shell history analysis. Parses bash, zsh, and fish history, counts commands, and ranks by frequency.
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

use super::{Align, render_table};

/// Toggles for optional table columns.
#[derive(Default, Clone, Copy)]
pub struct TableOptions {
    /// Show a percentage column (share of total count).
    pub percent: bool,
    /// Show an ASCII bar chart column scaled to the top entry.
    pub bars: bool,
}

/// Format ranked commands as an aligned text table.
///
/// ```rust
/// use shellist::{format_table, TableOptions};
/// let ranked = vec![("ls".to_string(), 10), ("git".to_string(), 5)];
/// let out = format_table(&ranked, &TableOptions::default());
/// assert!(out.contains("Rank"));
/// assert!(out.contains("Command"));
/// ```
pub fn format_table(ranked: &[(String, usize)], opts: &TableOptions) -> String {
    if ranked.is_empty() {
        return String::new();
    }
    let total: usize = ranked.iter().map(|(_, c)| *c).sum();
    let max_count = ranked.iter().map(|(_, c)| *c).max().unwrap_or(1);
    const BAR_MAX: usize = 30;

    let mut headers = vec![
        "Rank".to_string(),
        "Command".to_string(),
        "Count".to_string(),
    ];
    let mut aligns = vec![Align::Right, Align::Left, Align::Right];
    if opts.percent {
        headers.push("Pct".to_string());
        aligns.push(Align::Right);
    }
    if opts.bars {
        headers.push("Bars".to_string());
        aligns.push(Align::Left);
    }

    let mut rows = Vec::with_capacity(ranked.len());
    for (i, (cmd, count)) in ranked.iter().enumerate() {
        let mut row = vec![(i + 1).to_string(), cmd.clone(), count.to_string()];
        if opts.percent {
            let pct = if total == 0 {
                0.0
            } else {
                *count as f64 * 100.0 / total as f64
            };
            row.push(format!("{pct:.1}%"));
        }
        if opts.bars {
            let bar_len = if max_count == 0 {
                0
            } else {
                ((*count as f64 * BAR_MAX as f64) / max_count as f64).round() as usize
            };
            row.push("#".repeat(bar_len));
        }
        rows.push(row);
    }

    render_table(&headers, &rows, &aligns)
}

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

    fn ranked() -> Vec<(String, usize)> {
        vec![
            ("ls".to_string(), 10),
            ("git".to_string(), 5),
            ("cd".to_string(), 2),
        ]
    }

    #[test]
    fn table_has_headers_and_separator() {
        let out = format_table(&ranked(), &TableOptions::default());
        assert!(out.contains("Rank"));
        assert!(out.contains("Command"));
        assert!(out.contains("Count"));
        assert!(out.contains("----"));
    }

    #[test]
    fn table_empty_returns_empty_string() {
        assert!(format_table(&[], &TableOptions::default()).is_empty());
    }

    #[test]
    fn percent_column_present() {
        let out = format_table(
            &ranked(),
            &TableOptions {
                percent: true,
                bars: false,
            },
        );
        assert!(out.contains("Pct"));
        assert!(out.contains("58.8%")); // 10/17
    }

    #[test]
    fn bars_column_present_and_top_is_full() {
        let out = format_table(
            &ranked(),
            &TableOptions {
                percent: false,
                bars: true,
            },
        );
        assert!(out.contains("Bars"));
        // Top entry (10) is the max → 30 '#'s.
        assert!(out.contains(&"#".repeat(30)));
    }

    #[test]
    fn percent_and_bars_together() {
        let out = format_table(
            &ranked(),
            &TableOptions {
                percent: true,
                bars: true,
            },
        );
        assert!(out.contains("Pct"));
        assert!(out.contains("Bars"));
    }
}