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

/// Format ranked commands as CSV (RFC 4180 quoting).
///
/// ```rust
/// let ranked = vec![("ls".to_string(), 10)];
/// let csv = shellist::format_csv(&ranked);
/// assert!(csv.starts_with("command,count"));
/// ```
pub fn format_csv(ranked: &[(String, usize)]) -> String {
    let mut out = String::from("command,count\n");
    for (cmd, count) in ranked {
        out.push_str(&csv_field(cmd));
        out.push(',');
        out.push_str(&count.to_string());
        out.push('\n');
    }
    out
}

fn csv_field(s: &str) -> String {
    if s.contains(',') || s.contains('"') || s.contains('\n') || s.contains('\r') {
        let escaped = s.replace('"', "\"\"");
        format!("\"{escaped}\"")
    } else {
        s.to_string()
    }
}

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

    #[test]
    fn csv_header_and_rows() {
        let ranked = vec![("ls".to_string(), 10), ("git".to_string(), 5)];
        let out = format_csv(&ranked);
        assert_eq!(out, "command,count\nls,10\ngit,5\n");
    }

    #[test]
    fn csv_quotes_commas() {
        let ranked = vec![("a,b".to_string(), 1)];
        assert_eq!(format_csv(&ranked), "command,count\n\"a,b\",1\n");
    }

    #[test]
    fn csv_doubles_quotes() {
        let ranked = vec![("say \"hi\"".to_string(), 2)];
        assert_eq!(format_csv(&ranked), "command,count\n\"say \"\"hi\"\"\",2\n");
    }

    #[test]
    fn csv_empty_input_has_header_only() {
        assert_eq!(format_csv(&[]), "command,count\n");
    }
}