dice-roller 0.1.3

Roll dice from the command line.
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

Dice Roller
===========

A handy `roll` command for rolling dice on the command line.

Usage
-----

```
roll [--verbose] [DEFINITION]
roll --version
```

### Options

* `--verbose`: include the individual dice rolls in the output; by default displays only the total.
* `--version`: display the version information.

### Definition

Uses standard [dice notation][wiki-dice-notation] to define which dice and modifiers to use.

* `roll`: an easy-peasy six-sided dice roll.
* `roll d20`: specify to roll a 20-sided die.
* `roll 2d8`: roll two 20-sided dice.
* `roll 2d10+4`: roll 2 10-sided dice and add 4 to the result.
* `roll 3d4-2`: roll 3 4-sided dice and subtract 2 from the result.

Installation
------------

### Via Cargo

If you already have the Rust toolchain installed:

```
cargo install dice-roller
```

### Via Homebrew

```
# add this repo as a tap
brew tap pbyrne/roller https://github.com/pbyrne/roller
# then you can install like any other package
brew install dice-roller
```

### Download the binaries

OS-specific binaries are attached to [each release][releases] automatically. Download the one that's right for you and place it somewhere you can call it.

TODOs
-----

* `2d5+4d20`
* Graceful error handling on invalid input

[wiki-dice-notation]:https://en.wikipedia.org/wiki/Dice_notation
[releases]:https://github.com/pbyrne/roller/releases