# Dicer
version 1.0.1
## About
A simple library for evaluating strings representing dice rolls in rust. Dicer uses an _LL(1)_ grammar and a recursive descent parser to parse strings and
simulate randomly rolled dice. See [grammar.md](https://github.com/gnullByte/dicer/blob/main/grammar.md) for examples of valid strings.
## Example
```rust
use dicer::eval;
fn main() {
// simple expression
let test = String::from("1d20 + 4 + min([2d4-MAX], 3) {3}");
println!("parse: \"{}\"\n", test);
let result = eval(&test).unwrap();
for res in result {
println!("{} = {}", res.str, res.value);
}
}
```
output:
```
parse: "1d20 * (3+2) + min([2d4 - MAX], 3)"
(6) * (3 + 2) + min([ (3 + 1) -3 ], 3) = 31
```