Craps

TODO: Write a gem description

Installation

Add this line to your application's Gemfile:

gem 'craps'

And then execute:

$ bundle

Or install it yourself as:

$ gem install craps

First include Craps

require 'craps'
include Craps

Then instantiate a new six sided die with:

dice = Dice.new(6)

Alternatively use the subclass:

dice = D6.new

Throw a single die with:

dice.roll

Throw multiple dice with:

dice.roll(2)

To get the result array use .result

dice.roll(12).result
# or 
dice.result # if dice has already been rolled.

Returns results above a threshold

def above(int)
...
end

# chain on a roll or on the instance to get the latest result.

dice.roll(10).above(3)
# or
dice.above(3) #if already rolled.

The same for bellow. Returns results bellow a threshold

def bellow(int)
...
end

To count the results just use .count

dice.roll(10).above(3).count

For the probability of getting any one reuslt on a dice.

# For a six sided dice
dice.base_prob

To get the probability of throwing equal to or above a certain number on a die you can use the higher_or_equal_to method.

# On a 6 sided die there is a chance 33.3% to get 5 or above:
dice.higher_or_equal_to(5)
# returns 0.33333333333333326

You can also do the oposite. Calculate the chanse to get equal to or bellow a certain number:

# On a 6 sided die there is a 83.33333% chance to get 5 or bellow:
dice.lower_or_equal_to(5)
# returns 0.8333333333333334