api-query-provider 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.2

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5
+
+gem 'httparty'
+gem 'json'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", ">= 0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.8.3"
+  gem "simplecov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,43 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    httparty (0.8.1)
+      multi_json
+      multi_xml
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.5)
+    multi_json (1.1.0)
+    multi_xml (0.4.2)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    simplecov (0.6.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  httparty
+  jeweler (~> 1.8.3)
+  json
+  rdoc (~> 3.12)
+  rspec
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Femaref
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,10 @@
+= api-query-provider
+
+This gem provides an interface to an arbitrary json api. It provides ActiveRecord-like methods,
+which can be chained together.
+
+== Copyright
+
+Copyright (c) 2012 Femaref. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "api-query-provider"
+  gem.homepage = "http://github.com/Femaref/api-query-provider"
+  gem.license = "MIT"
+  gem.summary = %Q{Provides an easy interface to arbitrary json apis}
+  gem.description = %Q{Provides an easy interface to arbitrary json apis}
+  gem.email = "femaref@googlemail.com"
+  gem.authors = ["Femaref"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec
+
+task :simplecov do
+  ENV['COVERAGE'] = "true"
+  Rake::Task[:spec].execute
+end
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "api-query-provider #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO

@@ -0,0 +1,8 @@
+- improve ApiQueryProvider::Base.shadow (allow user defined aliasing)
+- improve field definition on non autogenerated models (rename custom_fields -> field, allow call with no block for default behaviour)
+- probably should split ApiQueryProvider::Base into Base and Object, Base serving as interaction layer, Object contains all field handling methods, would allow anonymous objects without much hassle
+- improve ApiQueryProvider::Provider.system_symbols, should be a constant as it won't change at runtime
+- think about ApiQueryProvider::Provider.execute, does it really need a forced array, could easily just return a single object
+- ApiQueryProvider::Base.required_symbols should be cached, api_path shouldn't really change
+- make configuration setters private, not needed to expose them
+- ApiQueryProvider::Base should automatically try to create objects from nested hashes, also should iterate over arrays

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/api-query-provider.gemspec

@@ -0,0 +1,85 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "api-query-provider"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Femaref"]
+  s.date = "2012-04-21"
+  s.description = "Provides an easy interface to arbitrary json apis"
+  s.email = "femaref@googlemail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc",
+    "TODO"
+  ]
+  s.files = [
+    ".document",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "TODO",
+    "VERSION",
+    "api-query-provider.gemspec",
+    "lib/api-query-provider.rb",
+    "lib/api-query-provider/base.rb",
+    "lib/api-query-provider/provider.rb",
+    "spec/attr_spec.rb",
+    "spec/autogeneration_spec.rb",
+    "spec/base_spec.rb",
+    "spec/constructor_spec.rb",
+    "spec/github_api_spec.rb",
+    "spec/lib/auto_generate_test_class.rb",
+    "spec/lib/github_commits.rb",
+    "spec/lib/github_user.rb",
+    "spec/lib/optional_where_test_class.rb",
+    "spec/lib/parameterless_auto_generate_test_class.rb",
+    "spec/lib/test_class.rb",
+    "spec/provider_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/where_spec.rb"
+  ]
+  s.homepage = "http://github.com/Femaref/api-query-provider"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Provides an easy interface to arbitrary json apis"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/lib/api-query-provider.rb

@@ -0,0 +1,6 @@
+require "httparty"
+require "uri"
+require "json"
+
+require "api-query-provider/provider"
+require "api-query-provider/base"

data/lib/api-query-provider/base.rb

@@ -0,0 +1,152 @@
+module ApiQueryProvider
+  # This class serves as a base class for any API Requests, it has several settings:
+  # +api_url+: sets the base url requests are made to_sym
+  # +api_path+: sets the path specific to this class, can contain replaceable elements
+  # +data_selector+: if the data is wrapped in an object, you can define a +Proc+ taking
+  # the parsed response as Hash and returning a portion of that Hash for further parsing
+  # the keys are +String+s.
+  # Be aware that if the data contains any fields named like a ruby internal method or field,
+  # it will be shadowed if you define it explicitly, it autogeneration is enabled, the name will
+  # have a underscore appended.
+  class Base
+  
+    def self.api_url
+      @api_url
+    end
+    
+    def self.api_url= (value)
+      @api_url = value
+    end
+    
+    def self.api_path
+      @api_path
+    end
+    
+    def self.api_path= (value)
+      @api_path = value
+    end
+    
+    def self.required_symbols
+      @api_path.scan(/:(\w+)/).flatten.map { |e| e.to_sym } - ApiQueryProvider::Provider.system_symbols
+    end
+    
+    def self.data_selector
+      @data_selector || Proc.new { |e| e }
+    end
+    
+    def self.data_selector= (value)
+      @data_selector = value
+    end
+    
+    def self.autogenerate
+      if @autogenerate.nil?
+        false
+      else
+        @autogenerate
+      end
+    end
+    
+    def self.autogenerate= (value)
+      @autogenerate = value
+    end
+    
+    def self.custom_field(field, &block)
+      @custom_fields ||= {}
+      
+      @custom_fields[field.to_sym] = block.to_proc
+    end
+    
+    def self.custom_fields
+      @custom_fields || {}
+    end
+    
+    def self.shadow(key)
+      key.to_sym == :class ? "class_".to_sym : key
+    end
+    
+    attr_reader :provided_symbols
+    
+     
+    # basic parsing constructor
+    # takes the json data and tries to assign it to +attr_accessor+ methods
+    # make sure to define them for any field present in the response
+    def initialize(data)
+      if self.class == ApiQueryProvider::Base
+        raise "this class should never be instanciated directly"
+      end
+      
+      @provided_symbols = []
+    
+      data.each do |key, value|
+        @provided_symbols << key.to_sym
+             
+        key = self.class.shadow key
+      
+        if !self.respond_to? key.to_sym
+          if self.class.autogenerate
+            self.class.class_eval do
+              attr_accessor key.to_sym
+            end
+          else
+            raise "field not found: #{key}. Either enable auto generation or add attr_accessor :#{key}"
+          end
+        end
+
+        if self.class.custom_fields.include? key.to_sym
+          value = self.class.custom_fields[key.to_sym].call(value)
+        end
+        
+        self.send("#{key}=".to_sym, value)
+      end
+    end
+    
+    def extend
+      if !(self.class.required_symbols - provided_symbols).empty?
+        raise "not all needed values are present"
+      end
+      
+      request = self.class.where
+      
+      self.class.required_symbols.each do |sym|
+        request = request.where(sym => self.send(self.class.shadow(sym).to_sym))
+      end
+      
+      response = request.execute
+      
+      if response.count != 1
+        raise "the request did not return exactly one element"
+      end
+      
+      response.first 
+    end
+    
+    def extend!
+      local = self.extend
+      
+      local.provided_symbols.each do |symbol|
+        shadow = self.class.shadow(symbol).to_sym
+        self.send("#{shadow}=".to_sym, local.send("#{shadow}".to_sym))
+      end
+      
+      @provided_symbols = local.provided_symbols
+      
+      self
+    end   
+    
+    def self.interface
+      ApiQueryProvider::Provider.new(self)
+    end
+    
+    def self.where(opt = {})
+      interface.where(opt)
+    end
+    
+    def self.limit(count)
+      interface.limit(count)
+    end
+    
+    def self.select(*fields)
+      interface.select(fields)
+    end
+  end
+end

data/lib/api-query-provider/provider.rb

@@ -0,0 +1,99 @@
+module ApiQueryProvider
+  # Provides method chaining support
+  # replaces parameters in the api_path
+  # named parameters will be replaced by the assosicated value from where calls
+  # if a :where symbol is present in the string, any further values provided by where will be
+  # concatted to a key1=value,key2=value string and replaced there
+  # a value provided by limit will be replaced in to the :limit symbol
+  # if you can request additional fields or restrict the fields provided, place a :select symbol in the string
+  class Provider   
+    attr_reader :where_constraints
+    attr_reader :count_constraint
+    attr_reader :select_fields
+    attr_reader :klass
+    
+    def initialize (base)    
+      api_url = base.api_url
+      api_path = base.api_path
+      if base.is_a? Class
+        @where_constraints = {}
+        @select_fields = []
+        @count_constraint = 0
+        @klass = base
+      else
+        @where_constraints = base.where_constraints
+        @select_fields = base.select_fields
+        @count_constraint = base.count_constraint
+      end
+
+    end
+    
+    def where(opt = {})
+      @where_constraints.merge! opt
+      
+      return self
+    end
+    
+    def limit(count)
+      @count_constraint = count
+      
+      return self
+    end
+    
+    def select(*fields)
+      @select_fields |= fields.flatten
+      
+      return self
+    end
+    
+    def replace_path
+      replaced_path = klass.api_path.dup
+      
+      used_keys = []
+      
+      @where_constraints.each do |key, value|
+        if replaced_path.gsub! /:#{key}/, value.to_s
+          used_keys << key
+        end
+      end
+      
+      @where_constraints.reject! { |key, value| used_keys.include? key }
+      
+      replaced_path.gsub! /:where/, @where_constraints.to_a.map { |e| e.join("=") }.join("&")
+      replaced_path.gsub! /:select/, @select_fields.join(",")
+      replaced_path.gsub! /:limit/, @count_constraint.to_s
+      
+      if replaced_path.include?(":")
+        raise "you didn't replace all fields in the api_path"
+      end
+      
+      replaced_path
+    end
+    
+    def response
+      begin
+        uri = URI.join(klass.api_url, self.replace_path)
+      rescue
+        raise "invalid uri"
+      end
+      
+      HTTParty.get(uri.to_s)
+    end
+    
+    def execute
+      local_response = self.response
+      
+      [klass.data_selector.call(JSON.parse(local_response.body))].flatten.map do |elem|
+        klass.new elem
+      end
+    end
+    
+    def self.interface
+      ApiQueryProvider::Provider.new(self)
+    end
+    
+    def self.system_symbols
+      [ :where, :count, :select ]
+    end
+  end
+end

data/spec/attr_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+require 'lib/test_class'
+require 'lib/github_commits'
+
+describe "ApiQueryProvider::Provider" do
+  it "should not replace api_url and api_path of two classes" do
+    TestClass.api_url.should == "http://example.com"
+    TestClass.api_path.should == "/foo/:id/id"
+    
+    GithubCommits.api_url.should == "http://github.com/api/v2/json/"
+    GithubCommits.api_path.should == "commits/list/:user_id/:repository/:branch"
+  end
+end

data/spec/autogeneration_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+require 'lib/auto_generate_test_class'
+require 'lib/test_class'
+
+describe AutoGenerateTestClass do
+  it "should auto generate fields" do
+    real = AutoGenerateTestClass.new({:foo => :bar})
+    
+    real.respond_to?(:foo).should == true
+    real.respond_to?(:bar).should == false
+  end
+end
+
+describe TestClass do
+  it "should raise exception encountering a non existant field" do
+    lambda { real = TestClass.new({:foo => :bar}) }.should raise_error 
+  end
+  
+  # TODO move to own test
+  it "should return :id as required symbol" do
+    TestClass.required_symbols.should == [ :id ]
+  end
+  
+  # TODO move to own test
+  it "should raise on non-replaced mandatory field" do
+    lambda { TestClass.where().replace_path }.should raise_error(Exception, "you didn't replace all fields in the api_path")
+  end
+  
+end

data/spec/base_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+require 'lib/auto_generate_test_class'
+require 'lib/parameterless_auto_generate_test_class'
+
+describe ApiQueryProvider::Base do
+  it "should raise an exception being instanciated directly" do
+    lambda { real = ApiQueryProvider::Base.new({}) }.should raise_error(Exception, "this class should never be instanciated directly")
+  end
+  
+  it "should not be manipulated if a deriving class is manipulated" do
+    AutoGenerateTestClass.new({:foo => :bar})
+    
+    ApiQueryProvider::Base.instance_methods.include?(:foo).should == false
+  end
+  
+  describe "extend" do
+    it "should raise on missing symbol" do
+      real = AutoGenerateTestClass.new({})
+      
+      lambda { real.extend }.should raise_error(Exception, "not all needed values are present")
+    end
+    
+    it "should allow parameterless api calls" do
+      HTTParty.stub(:get) { double(:body => %q({ "id" : "1", "name": "test" })) }
+    
+      real = ParameterlessAutoGenerateTestClass.new({})
+      
+      lambda { real.extend }.should_not raise_error
+    end
+  end
+  
+  describe "extend!" do
+    it "should copy additional fields to the current object" do
+      HTTParty.stub(:get) { double(:body => %q({ "id" : "1", "name": "test" })) }
+      
+      real = AutoGenerateTestClass.new({:id => 1})
+      
+      real.extend!
+      
+      real.name.should == "test"
+    end
+  end
+end

data/spec/constructor_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+require 'lib/test_class'
+
+describe "ApiQueryProvider::Provider" do
+  it "should save the base class" do
+    real = TestClass.interface
+    
+    real.klass.should == TestClass
+  end
+end

data/spec/github_api_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+require 'lib/github_commits'
+require 'lib/github_user'
+
+describe "github commit api" do
+  it "should construct a valid object" do
+    lambda do 
+      GithubCommits.where(:user_id => "Femaref")
+                   .where(:repository => "c2dm-rails")
+                   .where(:branch => "master")
+                   .execute
+    end.should_not raise_error
+  end
+end

data/spec/lib/auto_generate_test_class.rb

@@ -0,0 +1,6 @@
+class AutoGenerateTestClass < ApiQueryProvider::Base
+
+  self.api_url = "http://example.com"
+  self.api_path = "/foo/:id/id"
+  self.autogenerate = true
+end

data/spec/lib/github_commits.rb

@@ -0,0 +1,10 @@
+class GithubCommits < ApiQueryProvider::Base
+  self.api_url = "http://github.com/api/v2/json/"
+  self.api_path = "commits/list/:user_id/:repository/:branch"
+  self.data_selector = Proc.new {|element| element["commits"] }
+  self.autogenerate = true
+  
+  self.custom_field :author do |input|
+    GithubUser.new input
+  end
+end

data/spec/lib/github_user.rb

@@ -0,0 +1,6 @@
+class GithubUser < ApiQueryProvider::Base
+  self.api_url = "http://github.com/api/v2/json/"
+  self.api_path = "user/show/:name"
+  self.data_selector = Proc.new {|element| element["user"] }
+  self.autogenerate = true
+end

data/spec/lib/optional_where_test_class.rb

@@ -0,0 +1,5 @@
+class OptionalWhereTestClass < ApiQueryProvider::Base
+
+  self.api_url = "example.com"
+  self.api_path = "/foo/?:where"
+end

data/spec/lib/parameterless_auto_generate_test_class.rb

@@ -0,0 +1,6 @@
+class ParameterlessAutoGenerateTestClass < ApiQueryProvider::Base
+
+  self.api_url = "http://example.com"
+  self.api_path = "/foo/id"
+  self.autogenerate = true
+end

data/spec/lib/test_class.rb

@@ -0,0 +1,5 @@
+class TestClass < ApiQueryProvider::Base
+
+  self.api_url = "http://example.com"
+  self.api_path = "/foo/:id/id"
+end

data/spec/provider_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require 'lib/auto_generate_test_class'
+
+# uses the auto generation test class as interface
+
+describe AutoGenerateTestClass do
+  it "should not modify @api_path" do
+    HTTParty.stub(:get) { double(:body => %q({ "id" : "1", "name": "test" })) }
+    
+    real = AutoGenerateTestClass.api_path.dup
+    
+    AutoGenerateTestClass.where(:id => 1).execute
+    
+    AutoGenerateTestClass.api_path.should == real
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'simplecov'
+
+module SimpleCov::Configuration
+  def clean_filters
+    @filters = []
+  end
+end
+
+SimpleCov.configure do
+  clean_filters
+  load_adapter 'test_frameworks'
+end
+
+ENV["COVERAGE"] && SimpleCov.start do
+  add_filter "/.rvm/"
+end
+
+
+require 'rspec'
+require 'api-query-provider'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/where_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+require 'lib/test_class'
+require 'lib/optional_where_test_class'
+
+describe "Where" do
+  it "should merge the where_constraint hash" do
+    real = TestClass.where(:id => 1).where(:name => "foo")
+    
+    real.where_constraints.should == ({ :id => 1, :name => "foo" })
+  end
+  
+  it "should replace only symbols" do
+    real = TestClass.where(:id => 1)
+    
+    real.replace_path.should == "/foo/1/id"
+  end
+  
+  it "should not add non-defined symbol values" do
+    real = TestClass.where(:id => 1, :name => "something")
+    
+    real.replace_path.should == "/foo/1/id"
+  end
+end
+
+describe OptionalWhereTestClass do
+  it "should replace optional :where symbol" do
+    real = OptionalWhereTestClass.where(:ref_id => 1, :ref_type => 2)
+    
+    real.replace_path.should == "/foo/?ref_id=1&ref_type=2"
+  end
+end
+

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: api-query-provider
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Femaref
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: &70154304918460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70154304918460
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &70154304917980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70154304917980
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70154304917500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70154304917500
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: &70154304917020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: *70154304917020
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70154304916540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *70154304916540
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &70154304916060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+  type: :development
+  prerelease: false
+  version_requirements: *70154304916060
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70154304915580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70154304915580
+description: Provides an easy interface to arbitrary json apis
+email: femaref@googlemail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+- TODO
+files:
+- .document
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- TODO
+- VERSION
+- api-query-provider.gemspec
+- lib/api-query-provider.rb
+- lib/api-query-provider/base.rb
+- lib/api-query-provider/provider.rb
+- spec/attr_spec.rb
+- spec/autogeneration_spec.rb
+- spec/base_spec.rb
+- spec/constructor_spec.rb
+- spec/github_api_spec.rb
+- spec/lib/auto_generate_test_class.rb
+- spec/lib/github_commits.rb
+- spec/lib/github_user.rb
+- spec/lib/optional_where_test_class.rb
+- spec/lib/parameterless_auto_generate_test_class.rb
+- spec/lib/test_class.rb
+- spec/provider_spec.rb
+- spec/spec_helper.rb
+- spec/where_spec.rb
+homepage: http://github.com/Femaref/api-query-provider
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -771518329520128874
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Provides an easy interface to arbitrary json apis
+test_files: []