rdice-cli 0.1.2

Command-line dice roller powered by rdice-core
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

# rdice-cli

`rdice-cli` provides the `rdice` command-line dice roller. It uses
`rdice-core` for dice definitions, expression parsing, rolling, and
deterministic analysis.

## Install

```sh
cargo install rdice-cli
```

## Usage

```sh
rdice roll [-f|--folded] [-x|--expanded] [-E|--ev] [-R|--range] <dice-expr...>
rdice [-E|--ev] [-R|--range] <dice-expr...>
rdice list
rdice config path
rdice config edit
rdice help [--no-color]
```

Examples:

```sh
rdice roll 5d6
rdice roll -x 4d6
rdice roll -f -E -R 3d13 2coin 5 -3
rdice -E -R 3d6 5 -3
```

CLI output uses ANSI colors by default. Pass `--no-color` or set `NO_COLOR` to
disable color output for scripts and plain-text logs.

## Custom Dice

The CLI reads custom dice from `RDICE_CONFIG_PATH` when set. Otherwise it uses:

```text
~/.config/rdice/config.toml
```

Example:

```toml
[[dice]]
name = "coin"
faces = ["heads", "tails"]

[[dice]]
name = "fate"
faces = [-1, 0, 1]
```

Custom dice can be referenced without the internal custom prefix, so `2coin`
resolves to the configured `coin` die.

## License

Licensed under the MIT License.