Ruby gem to generate random numbers from web providers of real randomness sources like radioactive decay or atmospheric noise.
MIT License
= Random Sources
Random Sources is a Ruby gem that provides genuine random numbers, generated by processes fundamentally governed by inherent uncertainty instead of some pseudo-random number algorithm. It uses services from different online providers.
Current supported random numbers providers:
{}[http://travis-ci.org/xuanxu/random_sources] {}[http://badge.fury.io/rb/random_sources]
== Getting started
Install the gem: $ [sudo] gem install random_sources
Then depending on your project you may:
Require the gem directly: require 'random_sources' or add it to your Gemfile: gem 'random_sources', git: 'git://github.com/xuanxu/random_sources.git'
== Usage
Your entry point is the RandomSources module. With it you can get a list of supported providers and instantiate any of them:
RandomSources.list #=> "HotBits, RandomOrg"
RandomSources.generator 'RandomOrg' #=> <RandomSources::RandomOrg>
Once you have your generator you can ask for the random bytes:
generator = RandomSources.generator 'RandomOrg'
# five integers between 1 and 100:
generator.integers(num: 5, min: 1, max: 100)
# => [45, 61, 22, 96, 70]
# two strings of 10 unique characters including digits and uppercase letters:
generator.strings(num: 2, unique: 'on', digits: 'on', upperalpha: 'on', loweralpha: 'off')
# => ["6ESR61Y1", "K7520E6L"]
You can get integers, strings, sequences, bytes, etc... For a list of all the options of any supported source, check the doc in {the wiki}[https://github.com/xuanxu/random_sources/wiki]
== Credits
Author:: Juanjo Bazán Copyright:: Copyright (c) 2010 - ∞ Juanjo Bazán License:: Released under the {MIT license}[https://github.com/xuanxu/random_sources/blob/master/MIT-LICENSE.txt].