Crate destiny

This is a crate for dice rolling utilities.

Examples

Roll some dice using destiny::parse_dice_string:

use destiny::parse_dice_string;

println!("{}", parse_dice_string("1d4"));
println!("{}", parse_dice_string("1d6"));
println!("{}", parse_dice_string("2d6"));
println!("{}", parse_dice_string("1d8 + 3"));
println!("{}", parse_dice_string("1d6 + 2d8"));

Calculate distributions using destiny::DiceDistribution:

use destiny::DiceDistribution;
 
let dd = DiceDistribution::new("2d6");
dd.ptable();
/* this will output:
+------+--------+--------+
| Roll | #Rolls | Roll%  |
+======+========+========+
| 2    | 1      | 2.78%  |
+------+--------+--------+
| 3    | 2      | 5.56%  |
+------+--------+--------+
| 4    | 3      | 8.33%  |
+------+--------+--------+
| 5    | 4      | 11.11% |
+------+--------+--------+
| 6    | 5      | 13.89% |
+------+--------+--------+
| 7    | 6      | 16.67% |
+------+--------+--------+
| 8    | 5      | 13.89% |
+------+--------+--------+
| 9    | 4      | 11.11% |
+------+--------+--------+
| 10   | 3      | 8.33%  |
+------+--------+--------+
| 11   | 2      | 5.56%  |
+------+--------+--------+
| 12   | 1      | 2.78%  |
+------+--------+--------+
*/

Structs

DiceDistribution

A struct used to hold the information about a dice distribution.

Functions

parse_dice_string	Parses and evaluates Strings with dice notation.
possible_rolls	Calculates all the possible roll combinations for a given dice string.
roll_distribution	Calculates how many times each roll could have rolled to show the distribution.
roll_percentage	Takes a distribution and calculates the chance to roll every value