dm_x 0.2.0

A library for using dmenu as an option picker
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

# `dm_x`

A Rust crate for using [`dmenu`](https://tools.suckless.org/dmenu/), a
keyboard-driven menu originally written for use with tiling window managers.

Using this crate involves implementing the `Item` trait for your type,
and then passing a slice of those to the `Dmx::select()` method.

`Item` is already implemented for `&str`, so the following should work:

```rust
let choices: &[&str] = &[
    "Choice A",
    "Choice B",
    "Choice C",
    "Both A and B",
    "Both B and C",
    "All Three",
    "None of the Above",
];

let dmx = Dmx::default();

match dmx.select("Pick One:", choices).unwrap() {
    None => {
        println!("You declined to select an option.");
    },
    Some(n) => match choices.get(n) {
        None => {
            println!("You somehow chose an invalid choice.");
        },
        Some(choice) => {
            println!("You chose \"{}\".", choice);
        }
    }
}
```

See the `examples/` for non-trivial implementation of `Item`.