Overview

roul

Roul (from "roulette") is a tiny Clojure library for working with random numbers more easily.

For example:

(require '[roul.random :as rr])

; Get a random integer between 0 and 10
(rand-int 10)    ; Default Clojure
(rr/rand-int 10) ; Roul

; Get a random integer between 10 and 20
(+ 10 (rand-int 10)) ; Default Clojure
(rr/rand-int 10 20)  ; Roul

; Get a random element from a weighted collection

; Returns coffee roughly 80% of the time, tea 15%, and soda 5%.
(rr/rand-nth-weighted {:coffee 0.80 :tea 0.15 :soda 0.05})

; Returns cats roughly twice as often as boots.
(rr/rand-nth-weighted [[:boots 14] [:cats 28]])

Installation

You need Leiningen 2 to use this. Sorry.

[roul "0.2.0"]

Usage

Read the documentation.

License

Copyright © 2012 Steve Losh and Contributors

MIT/X11 Licensed