Numbers: random numbers facts

lib/tlaws.rb

@@ -3,3 +3,5 @@
 module Tlaws
   # Your code goes here...
 end
+
+require_relative 'tlaws/numbers'

lib/tlaws/numbers.rb

@@ -0,0 +1,82 @@
+require 'tlaw'
+
+
+module Tlaws
+  class Numbers < TLAW::API
+    define do
+      desc %Q{
+        Wrapper for [Numbers API](http://numbersapi.com). Facts about numbers.
+      }
+
+      docs 'http://numbersapi.com'
+
+      base 'http://numbersapi.com'
+
+      namespaces = {
+        random: nil,
+        :[] => '/{number}'
+      }
+
+      namespaces.each_pair do |ns, path|
+
+        namespace ns, path do
+
+          end_path = '?json'
+
+          if ns == :[]
+            desc %Q{
+              Facts about numbers.
+                example: numbers_api[42].{type} 
+            }
+            param :number, required: true, desc: %Q{
+              The number you need to know about
+              Can be a:
+                * singe number     - numbers_api[42].{type}
+                * range of numbers - numbers_api[42..56].{type}
+                * combined array   - numbers_api[[42..56, 77, 285, 770..777]].{type}
+            } 
+          else 
+            desc %Q{
+              Facts about random numbers.
+              Can be called in such ways:
+                * numbers_api.random.{type}
+                * numbers_api.random(min).{type}
+                    where: min - lower bound for a random number
+                * numbers_api.random(min, max).{type}
+                    where: min - lower bound for a random number
+                    where: max - upper bound for a random number
+            }
+            param :min, keyword: false, default: nil, desc: %Q{
+              Minimal number for random
+            }
+            param :max, keyword: false, default: nil, desc: %Q{
+              Maximum number for random
+            }
+            end_path += '&min={min}&max={max}'
+          end
+
+          endpoint :math, '/math' + end_path do
+            desc %Q{
+              Get an interesting mathematical fact about the number.
+            }
+          end
+          endpoint :year, '/year' + end_path do
+            desc %Q{
+              Get an interesting fact about the year.
+            }
+          end
+          endpoint :date, '/date' + end_path do
+            desc %Q{
+              Get an interesting fact about the date number.
+            }
+          end
+          endpoint :trivia, '/trivia' + end_path do
+            desc %Q{
+              Get an interesting fact about the number.
+            }
+          end
+        end
+      end
+    end
+  end
+end

spec/tlaws_spec.rb

@@ -5,7 +5,47 @@
     expect(Tlaws::VERSION).not_to be nil
   end
 
-  it "does something useful" do
-    expect(false).to eq(true)
-  end
+  let(:numbersapi){ Tlaws::Numbers.new	}
+
+  types = %w!math year date trivia! 
+
+  describe '.random' do 
+
+	  it "get an answer" do
+	  	res = numbersapi.random.math
+	  	expect(res).to be_instance_of Hash
+	  end
+
+  	types.each do |type|
+	  	describe ".#{type}" do
+		  	it "get a '#{type}' response on '#{type}' request" do
+		  		res = numbersapi.random.send(type)
+		  		expect(res["type"]).to eq type
+		  	end
+		  end
+		  describe ".#{type}(min, max)" do
+		  	it "get a random '#{type}' number in a range" do
+		  		min = 10
+		  		max = 20
+		  		res = numbersapi.random(min, max).send(type)
+		  		expect(res["number"]).to be_between(min, max)
+		  	end
+		  end
+  	end
+	end
+
+	describe '[number]' do
+		it "get an answer" do
+	  	res = numbersapi[42].math
+	  	expect(res).to be_instance_of Hash
+	  end
+	  types.each do |type|
+	  	describe ".#{type}" do
+		  	it "get a '#{type}' response on '#{type}' request" do
+		  		expect(numbersapi[15].send(type)["type"]).to eq type
+		  	end
+	  	end
+	  end
+	end
+
 end

tlaws.gemspec

@@ -6,12 +6,12 @@ require "tlaws/version"
 Gem::Specification.new do |spec|
   spec.name          = "tlaws"
   spec.version       = Tlaws::VERSION
-  spec.authors       = ["TODO: Write your name"]
-  spec.email         = ["TODO: Write your email address"]
+  spec.authors       = ["Yuri Valigursky"]
+  spec.email         = ["[email protected]"]
 
-  spec.summary       = %q{TODO: Write a short summary, because Rubygems requires one.}
-  spec.description   = %q{TODO: Write a longer description or delete this line.}
-  spec.homepage      = "TODO: Put your gem's website or public repo URL here."
+  spec.summary       = %q{A repository for TLAW-based thin API wrappers, for all the world}
+  spec.description   = %q{A repository for TLAW-based thin API wrappers, for all the world}
+  spec.homepage      = "https://github.com/molybdenum-99/tlaws"
   spec.license       = "MIT"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'