mikedamage-random-org 0.1.0

data/README.textile

@@ -0,0 +1,38 @@
+h1. Random.org Gem
+
+_Random integers, baked fresh daily._
+
+by Mike Green
+
+
+h2. Summary
+
+This is my first attempt at creating a Ruby gem. It's a really simple class that uses "Random.org's":http://random.org key-value interface to generate a user-specified number of random integers. It's mostly just so I can teach myself basic gem development, but I can see it being useful in web applications that need a reliable, _true_ random number generator.
+
+The Random.org Gem is a module that currently contains only one class: @RandomOrg::Integer@, which is an interface to Random.org's "random integer generator":http://random.org/integers/ service. Eventually it will also contain a class that generates sequences of random integers, corresponding to Random.org's "sequence generator":http://random.org/sequences/. Obviously, the Random.org Gem requires an active internet connection to work.
+
+h2. Usage
+
+Usage is pretty straightforward -- the only method is @new(min, max, base)@, where @base@ is either 2, 8, 10, or 16. The default setting is to generate a random base 10 (decimal) integer. Right now, if you choose to generate a hexidecimal integer, it will give you a string. Mostly because I'm lazy.
+
+<pre>
+	require 'random_org'
+	
+	int = RandomOrg::Integer.new(0, 100) # base defaults to 10
+	puts int.value # That's your randomly generated integer.
+</pre>
+
+h2. Dependencies
+
+* Ruby Standard Library _(that's it)_
+
+h2. About "Random.org":http://random.org
+
+_From their website:_
+
+*RANDOM.ORG* offers true random numbers to anyone on the Internet. The randomness comes from atmospheric noise, which for many purposes is better than the pseudo-random number algorithms typically used in computer programs. People use RANDOM.ORG for holding draws, lotteries and sweepstakes, to drive games and gambling sites, for scientific applications and for art and music. The service has existed since 1998 and was built and is being operated by Mads Haahr of the School of Computer Science and Statistics at Trinity College, Dublin in Ireland.
+
+
+h2. COPYRIGHT
+
+Copyright (c) 2008 Mike Green. See LICENSE for details.

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:minor: 1
+:patch: 0
+:major: 0

data/lib/random_org.rb

@@ -0,0 +1,31 @@
+require 'uri'
+require 'net/http'
+
+module RandomOrg
+	
+	class Integer
+		@@url = URI.parse("http://random.org/integers/")
+		ValidBases = [2, 8, 10, 16]
+		
+		attr_reader :min, :max, :base, :value, :opts
+		
+		def initialize(min, max, base=10)
+			@min = min.to_s
+			@max = max.to_s
+			@base = base.to_s
+			@@url.query = "num=1&min=#{@min}&max=#{@max}&col=1&base=#{@base}&format=plain&rnd=new"
+			
+			begin
+				res = Net::HTTP.get(@@url).chomp
+				if @base.to_i == 16
+					@value = res
+				else
+					@value = res.to_i
+				end
+			rescue Net::HTTPFatalError => e
+				puts "Error: " + e
+			end
+		end
+		
+	end
+end

data/test/random_org_test.rb

@@ -0,0 +1,7 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class RandomOrgTest < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'mocha'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'random_org'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: mikedamage-random-org
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Mike Green
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-28 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: TODO
+email: mike.is.green@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.textile
+- VERSION.yml
+- lib/random_org.rb
+- test/random_org_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/mikedamage/random-org
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: TODO
+test_files: []
+