shellist 0.3.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

use super::{Align, bar_len, 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);

    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 {
            row.push("#".repeat(bar_len(*count, max_count)));
        }
        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"));
    }
}