Merge pull request #1 from eonrubia/master

Accessing via proxy

Author: mabarroso

README.md

@@ -1,11 +1,11 @@
-# TrueRandom  
+# TrueRandom
 Get true random numbers from [RANDOM.ORG](http://random.org).
 
-# Description  
+# Description
 Use the true random number service of [RANDOM.ORG](http://random.org). The randomness comes from atmospheric noise, which for many purposes is better than the pseudo-random number algorithms typically used in computer programs.
 
 
-#Installation  
+#Installation
 ##From the command line.
 
 ```shell
@@ -26,23 +26,23 @@ gem 'true-random'
   bundle install
 ```
 
-##Important note!  
+##Important note!
 To access [RANDOM.ORG](http://random.org) via an automated client, please make sure you observe the [Guidelines for Automated Clients](http://www.random.org/clients/) or your computer may be banned.
 
-#Usage  
-##Integer Generator  
+#Usage
+##Integer Generator
 The Integer Generator will generate truly random integers in configurable intervals.
 
 ```ruby
   rnd = TrueRandom::Random.new
   puts rnd.integer
 ```
 
-**Parameters**  
-*n*     The number of integers requested. 1 by default.  
-*min*   The smallest value allowed for each integer. 1 by default.  
-*max*   The largest value allowed for each integer. 100 by default.  
-*base*  The base that will be used to print the numbers, i.e., binary, octal, decimal or hexadecimal. Possible values are 2, 8, 10 or 16. 10 by default.  
+**Parameters**
+*n*     The number of integers requested. 1 by default.
+*min*   The smallest value allowed for each integer. 1 by default.
+*max*   The largest value allowed for each integer. 100 by default.
+*base*  The base that will be used to print the numbers, i.e., binary, octal, decimal or hexadecimal. Possible values are 2, 8, 10 or 16. 10 by default.
 
 The same example with full parameters
 
@@ -59,9 +59,9 @@ The Sequence Generator will randomize a given interval of integers, i.e., arrang
   puts rnd.sequence
 ```
 
-**Parameters**  
-*min*   The lower bound of the interval (inclusive). 1 by default.  
-*max*   The upper bound of the interval (inclusive). 100 by default.  
+**Parameters**
+*min*   The lower bound of the interval (inclusive). 1 by default.
+*max*   The upper bound of the interval (inclusive). 100 by default.
 
 The sequence requested must 10,000 numbers or shorter in length, i.e., max-min+1=1e4.
 
@@ -73,13 +73,13 @@ The String Generator will generate truly random strings of various length and ch
   puts rnd.string
 ```
 
-**Parameters**  
-*n*           The number of strings requested. 1 by default.  
-*len*         The length of the strings. All the strings produced will have the same length. Max length 20. 20 by default.  
-*digits*      Determines whether digits (0-9) are allowed to occur in the strings. Possible values are true or false. True by default.  
-*upperalpha*  Determines whether uppercase alphabetic characters (A-Z) are allowed to occur in the strings. Possible values are true or false. True by default.  
-*loweralpha*  Determines lowercase alphabetic characters (a-z) are allowed to occur in the strings. Possible values are true or false. True by default.  
-*unique*      Determines whether the strings picked should be unique (as a series of raffle tickets drawn from a hat) or not (as a series of die rolls). If unique is set to on, then there is the additional constraint that the number of strings requested (num) must be less than or equal to the number of strings that exist with the selected length and characters. Possible values are true or false. True by default.  
+**Parameters**
+*n*           The number of strings requested. 1 by default.
+*len*         The length of the strings. All the strings produced will have the same length. Max length 20. 20 by default.
+*digits*      Determines whether digits (0-9) are allowed to occur in the strings. Possible values are true or false. True by default.
+*upperalpha*  Determines whether uppercase alphabetic characters (A-Z) are allowed to occur in the strings. Possible values are true or false. True by default.
+*loweralpha*  Determines lowercase alphabetic characters (a-z) are allowed to occur in the strings. Possible values are true or false. True by default.
+*unique*      Determines whether the strings picked should be unique (as a series of raffle tickets drawn from a hat) or not (as a series of die rolls). If unique is set to on, then there is the additional constraint that the number of strings requested (num) must be less than or equal to the number of strings that exist with the selected length and characters. Possible values are true or false. True by default.
 
 ##Quota Checker
 The Quota Checker allows you to examine your quota at any point in time. The quota system works on the basis of IP addresses. Each IP address has a base quota of 1,000,000 bits. When your client makes a request for random numbers (or strings, etc.), the server deducts the number of bits it took to satisfy your request from the quota associated with your client's IP address.
@@ -98,3 +98,15 @@ You can request for certain IP.
 
 n.n.n.n is the IP address for which you wish to examine the quota. Each value for n should be an integer in the [0,255] interval. This parameter is optional. If you leave it out, it defaults to the IP address of the machine from which you are issuing the request.
 
+##Using proxy server
+To enable proxy feature, set a proxy host.
+
+```ruby
+  rnd = TrueRandom::Random.new
+  rnd.proxy host, port
+  puts rnd.integer
+```
+
+Set host to false to disable proxy.
+
+Default port is 8080.

lib/true-random.rb

@@ -2,6 +2,10 @@
 
 module TrueRandom
   class Random
+	  def initialize
+  	  @proxy_url = false
+	  end
+
     def integer n=1, min=1, max=100, base = 10
       return integers "integers/?num=#{n}&min=#{min}&max=#{max}&col=1&base=#{base}"
     end
@@ -20,9 +24,13 @@ def quota ip = false
     	else
     		return integers "quota/?ip=#{ip}"
     	end
-
   	end
 
+  	def proxy url = false, port = 8080
+  	  @proxy_url = url
+  	  @proxy_port = port
+    end
+
     private
     def on_off value = false
     	return value == true ? 'on' : 'off'
@@ -45,7 +53,12 @@ def strings uri
     end
 
     def request uri
-      http_response = Net::HTTP.get_response(URI.parse('http://www.random.org/' + uri + '&format=plain&rnd=new'))
+      url = URI.parse('http://www.random.org/' + uri + '&format=plain&rnd=new')
+        http_response = Net::HTTP::Proxy(@proxy_url, @proxy_port).get_response(url)
+      if @proxy_url
+      else
+        http_response = Net::HTTP.get_response(url)
+      end
       return false unless http_response.code.to_i == 200
       results = []
       http_response.body.split("\n").each do |item|

lib/true-random/version.rb

@@ -1,3 +1,3 @@
 module TrueRandom
-  VERSION = "1.1.0"
+  VERSION = "1.1.2"
 end

true_random.gemspec

@@ -1,21 +1,21 @@
-$:.push File.expand_path("../lib", __FILE__)
-
-# Maintain your gem's version:
-require "true-random/version"
-
-# Describe your gem and declare its dependencies:
-Gem::Specification.new do |s|
-  s.name        = "true-random"
-  s.version     = TrueRandom::VERSION
-  s.authors     = ["Miguel Adolfo Barroso"]
-  s.email       = ["mabarroso@mabarroso.com"]
-  s.homepage    = "http://github.com/mabarroso/true-random"
-  s.platform    = Gem::Platform::RUBY
-  s.summary     = "Get true random numbers from RANDOM.ORG."
-  s.description = "Use the true random number service of RANDOM.ORG. The randomness comes from atmospheric noise, which for many purposes is better than the pseudo-random number algorithms typically used in computer programs."
-
-  s.files = Dir["{app,config,db,lib}/**/*"] + ["MIT-LICENSE", "Rakefile", "README.rdoc"]
-  s.test_files = Dir["test/**/*"]
-
-  s.add_development_dependency "rspec", "~> 2.7.0"
-end
+$:.push File.expand_path("../lib", __FILE__)
+
+# Maintain your gem's version:
+require "true-random/version"
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = "true-random"
+  s.version     = TrueRandom::VERSION
+  s.authors     = ["Miguel Adolfo Barroso", "eonrubia"]
+  s.email       = ["mabarroso@mabarroso.com"]
+  s.homepage    = "http://github.com/mabarroso/true-random"
+  s.platform    = Gem::Platform::RUBY
+  s.summary     = "Get true random numbers from RANDOM.ORG."
+  s.description = "Use the true random number service of RANDOM.ORG. The randomness comes from atmospheric noise, which for many purposes is better than the pseudo-random number algorithms typically used in computer programs."
+
+  s.files = Dir["{app,config,db,lib}/**/*"] + ["MIT-LICENSE", "Rakefile", "README.md"]
+  s.test_files = Dir["test/**/*"]
+
+  s.add_development_dependency "rspec", "~> 2.7.0"
+end