ichoose 0.3.0

Interactive terminal list selection (lib+bin)
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

# `ichoose`

[![ichoose crate](https://img.shields.io/crates/v/ichoose?label=ichoose)](https://crates.io/crates/ichoose)
[![ichoose documentation](https://img.shields.io/docsrs/ichoose/latest?label=ichoose%20docs)](https://docs.rs/ichoose)

A TUI interactive selection menu built on [ratatui](https://ratatui.rs/). Used by
[iforgor](../iforgor/README.md), but usable standalone as a binary or Rust library.

## Binary usage

Pipe a list to `ichoose` via stdin, one entry per line:

```
ID @ NAME
ID @ NAME @ DESCRIPTION
```

If ` @ ` is not found, the whole line is used as both ID and name. Selected IDs are
printed to stdout, one per line.

```sh
echo -e "a @ Alpha\nb @ Beta\nc @ Gamma" | ichoose --title "Pick one"
# Outputs selected ID, e.g.: b

# Multi-select:
echo -e "1 @ One\n2 @ Two\n3 @ Three" | ichoose --multi --title "Pick many"
```

Flags: `--title <TITLE>`, `--text <TEXT>`, `--multi`.

## Library usage

```rust
let items = vec![
    ichoose::ListEntry { key: 0, name: "Alpha".into(), description: None },
    ichoose::ListEntry { key: 1, name: "Beta".into(), description: Some("second".into()) },
];

let result = ichoose::ListSearch {
    items: &items,
    filter_callback: None,
    preview_callback: None,
    extra: ichoose::ListSearchExtra {
        title: " Pick one ".into(),
        ..Default::default()
    },
}
.run()?;

// result.selected: BTreeSet<K> of chosen keys
// result.action: Option<String> if a custom action key was pressed
```

### Features

- **Search**: type to filter by name/description. Comma-separated terms use AND logic.
- **Key:value filters**: `tag:x`, `shell:bash`, etc. via `filter_callback`.
- **Preview pane**: Tab toggles a side panel via `preview_callback`.
- **Multi-select**: Right toggles item, Left toggles all visible.
- **Action keys**: `ActionKey` enum (F-keys, Ctrl+char, Alt+char, etc.) for custom actions that exit the picker with an action name.
- **History list**: `empty_search_list` shows an alternate list when search is empty.
- **Preserved order**: `preserve_order` skips alphabetic sorting.
- **Visual**: rounded borders, reverse-video highlight, scrollbar, item count, block cursor.