2 releases
0.1.1 | Nov 24, 2023 |
---|---|
0.1.0 | Nov 24, 2023 |
#1520 in Game dev
33KB
747 lines
evaluroll
Evaluroll is a dice roll evaluator for tabletop games. It supports dice notation and basic arithmetic, as specified in the roll20 spec. It also supports keeping and dropping dice, as well as parenthesized expressions.
It also supports parsing into an AST, which can be used to evaluate the expression multiple times.
Examples
Parsing an expression into an AST:
let ast = evaluroll::parse("1d20")?;
Evaluating an AST:
use evaluroll::Eval;
let ast = evaluroll::parse("1d20")?;
let mut rng = rand::thread_rng();
let output = ast.eval(&mut rng)?;
assert_eq!(1, output.rolls.len());
assert!((1..=20).contains(&output.total));
Evaluating an expression directly:
let mut rng = rand::thread_rng();
let output = evaluroll::eval(&mut rng, "1d20")?;
assert_eq!(1, output.rolls.len());
assert!((1..=20).contains(&output.total));
Features
Evaluroll has the following features:
trace
: Enables tracing of the AST and the output of the parser.
License: MIT
Dependencies
~285–450KB