shellist 0.1.2

Shell history analysis. Parses .bash_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

# Shellist

Parse `.bash_history`, count commands, rank by frequency. Library and CLI.

## Install

```sh
cargo install shellist
```

## CLI

```sh
shellist                      # reads ~/.bash_history, prints ranked table
shellist --top 5              # top 5 only
shellist --ignore ls,cd       # exclude ls and cd
shellist --no-default-ignore  # include bash internals (set, shopt)
shellist --min 3              # only commands used ≥ 3 times
shellist --path ./my_history.txt
```

Options:

| Flag              | Description                          |
|-------------------|--------------------------------------|
| `--top N`         | Show top N commands                  |
| `--ignore X,Y`    | Exclude commands (comma-separated)   |
| `--no-default-ignore` | Don't filter bash internals (set, shopt) |
| `--min N`         | Only commands with count ≥ N         |
| `--path PATH`     | Read from PATH (default: ~/.bash_history) |
| `--help`          | Print help                          |

By default, `set` and `shopt` are ignored — these are bash internals that often leak into `.bash_history` from shell init scripts, not commands you actually typed. Use `--no-default-ignore` to see them.

Example output:

```
Rank  Command  Count
----  -------  -----
   1  ls          120
   2  git          95
   3  cd           80
```

## Library

```rust
use shellist::{analyze, parse_history, count_commands, rank_commands,
                top_n, filter_commands, filter_by_min_frequency,
                load_history_file, default_history_path};

// Full pipeline
let ranked = analyze("ls\ngit\nls\ncd\ngit\nls");
assert_eq!(ranked, vec![
    ("ls".to_string(), 3),
    ("git".to_string(), 2),
    ("cd".to_string(), 1),
]);

// Step by step
let entries = parse_history("git push\ncd /\ngit commit");
let counts = count_commands(&entries);
let ranked = rank_commands(counts);
let top = top_n(ranked, 2);
let filtered = filter_commands(top, &["cd"]);

// From file
let content = load_history_file("/home/user/.bash_history")?;
```

## Benchmarks

```sh
cargo bench
```

Runs criterion benchmarks on `analyze()` with 100, 1k, 10k, and 100k history entries. Results
are written to `target/criterion/` with HTML reports.

To compare against a baseline:

```sh
cargo bench -- --save-baseline before
# make changes...
cargo bench -- --baseline before
```

## License

MIT