NOW DEPRECATED!

Dicer is still available on hex.pm, but will not be worked on anymore. Check out my new replacement project at gitlab.com named Rollex.

Dicer

A dice roller expression evaluator written in Elixir!

Installation

Pre-requisites

Erlang 17 or greater
Elixir 1.0.1
git (to clone the repository)

Creating a command line binary

mix escript.build

From here, execute rolls like this:

$ dicer "1+2+3"

Running in interactive shell

iex -S mix

From here, execute rolls like this:

iex(1)> Dicer.roll "1+2+3"

Adding as a mix dependency

In your mix.exs file:

  def application do
    [mod: {MyApp, []},
     applications: [:dicer]]
  end

and this:

  defp deps do
    [{:dicer, "0.4.0"}]
  end

Details

Dicer is an elixir application that lets you evaluate dice rolls with simple arithmetic operators.

The operators supported are +, -, /, *.
Grouping is via parentheses
Polyhedral dice are designated using the <quantity>d<sides> format (Ex. 20d8 or D100).
Fudge/Fate dice are designated using the <quantity>dF format (Ex. 42dF)
You can ask Dicer to take the top or bottom X rolls via the ^<quantity> (take top) and v<quantity> (take bottom) symbols (Ex. 10d100^5 [take top 5 results from 10 rolls of a 100-sided die])

Why?

Because it was a fun, somewhat non-trivial way to work in Elixir.

Thanks

Thanks to Lukasz Wrobel for his short series on parsing. Part 3 was my template for my code, even if it took me way too long to translate the loops into recursive function calls!

olhado / dicer