user_reviews 0.0.7

data/.gitignore

@@ -0,0 +1,19 @@
+*.rbc
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.pairs
+user_reviews-*.gem
+scripts
+scripts/**/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in user_reviews.gemspec
+gemspec
+
+group :test do
+  gem 'rspec'
+  gem 'pry'
+end

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    user_reviews (0.0.7)
+      activesupport (~> 3.2.11)
+      httparty
+      json
+      oauth
+      rake
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.2.11)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    coderay (1.0.8)
+    diff-lcs (1.1.3)
+    httparty (0.10.2)
+      multi_json (~> 1.0)
+      multi_xml (>= 0.5.2)
+    i18n (0.6.1)
+    json (1.7.6)
+    method_source (0.8.1)
+    multi_json (1.5.0)
+    multi_xml (0.5.2)
+    oauth (0.4.7)
+    pry (0.9.11.4)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (10.0.3)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    slop (3.4.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pry
+  rspec
+  user_reviews!

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Unpakt LLC
+
+MIT License
+
+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.md

@@ -0,0 +1,100 @@
+# UserReviews
+
+[![Build Status](https://secure.travis-ci.org/Unpakt/user_reviews.png?branch=master)](http://travis-ci.org/unpakt/user_reviews)
+
+Is a simple api wrapper for:
+
+* Yelp
+* Citysearch
+* Google Ratings
+
+## Getting started
+
+### Add this line to your application's Gemfile:
+
+```ruby
+gem 'user_reviews'
+```
+
+### And then execute:
+
+```console
+$ bundle
+```
+
+### Or install it yourself as:
+
+```console
+$ gem install user_reviews
+```
+
+## Usage
+
+### Create an api_provider
+
+### For Citysearch
+
+```ruby
+auth_info = {publisher_key: 'your_city_search_api_key'}
+city_search = UserReviews.provider_factory(:citysearch, auth_info)
+```
+
+### For Google Reviews
+
+```ruby
+auth_info = {key: 'your_google_api_key'}
+google = UserReviews.provider_factory(:google, auth_info)
+```
+
+### For Yelp
+
+```ruby
+auth_info = {consumer_key: 'yelp_consumer_key', consumer_secret:'yelp_consumer_secret' ,token:'yelp_token' , token_secret:'yelp_token_secret'}
+yelp = UserReviews.provider_factory(:yelp, auth_info)
+```
+
+### Get reviews for a business
+
+```ruby
+city_search.find_reviews_for_business city_search_business_id
+```
+
+### Get information about a business
+
+```ruby
+city_search.find_business_by_id(business_id)
+```
+
+Each Review object has 4 attributes:
+* author_name
+* rating
+* reviewed_at
+* comment
+
+Each Business object has 4 attributes:
+* name
+* address
+* reference
+* average_rating
+* url
+
+
+More information about each API:
+
+* Yelp: http://www.yelp.com/developers/documentation/v2/overview
+* CitySearch: http://www.citygridmedia.com/developer/
+* GoogleReviews: https://developers.google.com/places/documentation/
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Add your own provider folder which inherits from the Providers::Base class and tests
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create new Pull Request
+
+## License
+
+MIT License. Copyright 2013. http://www.unpakt.com

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'bundler'
+require 'rspec/core/rake_task'
+
+Bundler::GemHelper.install_tasks
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/providers/base.rb

@@ -0,0 +1,20 @@
+require 'httparty'
+require 'oauth'
+require 'json'
+require 'open-uri'
+require 'date'
+
+module Providers
+  class Base
+
+    def find_business_by_name(name, business_type, city_state = "")
+    end
+
+    def find_reviews_for_business(ref)
+    end
+
+    def find_business_by_id(id)
+    end
+
+  end
+end

data/lib/providers/citysearch/api.rb

@@ -0,0 +1,72 @@
+module Providers
+  module Citysearch
+    class Api < Providers::Base
+
+      LOCALHOST_IP = "127.0.0.1"
+
+      def initialize(options)
+        @key = options[:publisher_key]
+        @ip = options[:client_ip] || LOCALHOST_IP
+      end
+
+      def find_business_by_name(name, business_type, city_state)
+        request_url = business_search_url(name, business_type, city_state)
+        json_results = HTTParty.get(request_url)
+        parse_business_results(json_results)
+      end
+
+      def find_business_by_id(citysearch_id)
+        request_url = business_url(citysearch_id)
+        json_results = HTTParty.get(request_url)
+        json = json_results["locations"] || []
+
+        return json if json.empty?
+        Providers::Citysearch::Business.build_business(json.first)
+      end
+
+      def find_reviews_for_business(citysearch_id)
+        request_url = reviews_url(citysearch_id)
+        json_results = HTTParty.get(request_url)
+        parse_reviews_results(json_results)
+      end
+
+      private
+
+      def business_url(citysearch_id)
+        "http://api.citygridmedia.com/content/places/v2/detail?publisher=#{@key}&id=#{citysearch_id}&id_type=cs&client_ip=127.0.0.1&format=json"
+      end
+
+      def business_search_url(name, business_type = "", city_state)
+        "http://api.citygridmedia.com/content/places/v2/search/where?where=#{URI::encode(city_state)}&what=#{URI::encode(name)}&publisher=#{@key}&format=json"
+      end
+
+      def reviews_url(citysearch_id)
+        "http://api.citygridmedia.com/content/reviews/v2/search/where?listing_id=#{citysearch_id}&publisher=#{@key}&format=json"
+      end
+
+      def parse_business_results(json)
+        result = []
+        return result if json.nil? || json["results"].nil?
+
+        json = json["results"] || []
+        json["locations"].each do |e|
+          result.push(Providers::Citysearch::Business.build_business(e))
+        end
+
+        result
+      end
+
+      def parse_reviews_results(json)
+        result = []
+        return result if json.nil? || json["results"].nil?
+
+        json = json["results"] || []
+        json["reviews"].each do |e|
+          result.push(Providers::Citysearch::Review.new(e))
+        end
+
+        result
+      end
+    end
+  end
+end

data/lib/providers/citysearch/business.rb

@@ -0,0 +1,23 @@
+module Providers
+  module Citysearch
+    class Business
+      attr_accessor :name, :address, :reference, :average_rating, :total_reviews
+
+      def self.build_business(node)
+        return nil if [node["name"], node["address"], node["review_info"], node["id"]].include?(nil)
+        new(node)
+      end
+
+      private
+
+      def initialize(node)
+        @name = node["name"]
+        full_address = node["address"]
+        @address = [full_address["street"], full_address["city"], full_address["state"], full_address["postal_code"]].join(" ")
+        @reference = node["id"]
+        @total_reviews = node['review_info']['total_user_reviews']
+        @average_rating = node['review_info']['overall_review_rating']
+      end
+    end
+  end
+end

data/lib/providers/citysearch/review.rb

@@ -0,0 +1,15 @@
+
+module Providers
+  module Citysearch
+    class Review
+      attr_accessor :rating, :author_name, :reviewed_at, :comment
+
+      def initialize(node)
+        @rating = node["review_rating"]
+        @author_name = node["review_author"]
+        @reviewed_at = DateTime.parse(node["review_date"]).to_time
+        @comment = node["review_text"]
+      end
+    end
+  end
+end

data/lib/providers/google/api.rb

@@ -0,0 +1,73 @@
+module Providers
+  module Google
+    class ExceededQueryLimitError < StandardError; end
+
+    class Api < Providers::Base
+
+      def initialize(options)
+        @key = options[:key]
+      end
+
+      def find_business_by_name(name, business_type, city_state = "")
+        request_url = business_url(name, business_type)
+        @json_results = HTTParty.get(request_url)
+        parse_business_results(@json_results)
+      end
+
+      def find_reviews_for_business(ref)
+        request_url = reviews_url(ref)
+        @json_results = HTTParty.get(request_url)
+        parse_reviews_results(@json_results)
+      end
+
+      def find_business_by_id(google_id)
+        request_url = reviews_url(google_id)
+        @json_results = HTTParty.get(request_url)
+        return @json_results if @json_results.nil?
+
+        json = @json_results["result"]
+        return json if json.nil?
+
+        Providers::Google::Business.build_business(json)
+      end
+
+      private
+
+      def query_limit_has_been_reached?
+        @json_results["status"] == 'OVER_QUERY_LIMIT'
+      end
+
+      def business_url(business_name, business_type)
+        "https://maps.googleapis.com/maps/api/place/textsearch/json?key=#{@key}&query=#{URI::encode(business_name)}=&sensor=false&type=#{URI::encode(business_type)}"
+      end
+
+      def reviews_url(reference)
+        "https://maps.googleapis.com/maps/api/place/details/json?key=#{@key}&reference=#{reference}&sensor=false"
+      end
+
+      def parse_business_results(json)
+        raise Providers::Google::ExceededQueryLimitError if query_limit_has_been_reached?
+
+        result = []
+        return result if json.nil? || json["results"].nil?
+
+        json["results"].each do |e|
+          result.push(Providers::Google::Business.build_business(e))
+        end
+
+        result
+      end
+
+      def parse_reviews_results(json)
+        result = []
+        return result if json.nil? || json["result"].nil? || json["result"]["reviews"].nil?
+
+        json["result"]["reviews"].each do |e|
+          result.push(Providers::GoogleReviews::Review.new(e))
+        end
+
+        result
+      end
+    end
+  end
+end

data/lib/providers/google/business.rb

@@ -0,0 +1,21 @@
+module Providers
+  module Google
+    class Business
+      attr_accessor :name, :address, :reference, :average_rating, :url
+
+      def self.build_business(node)
+        return nil if [node["name"], node["formatted_address"], node["reference"]].include?(nil)
+        new(node)
+      end
+
+      private
+      def initialize(node)
+        @name = node["name"]
+        @address = node["formatted_address"]
+        @reference = node["reference"]
+        @average_rating = node["rating"]
+        @url = node["url"]
+      end
+    end
+  end
+end

data/lib/providers/google/review.rb

@@ -0,0 +1,24 @@
+module Providers
+  module Google
+    class Review
+      attr_accessor :rating, :author_name, :reviewed_at, :comment
+
+      def initialize(node)
+        @rating = average_rating(node["aspects"])
+        @author_name = node["author_name"]
+        @reviewed_at = Time.at(node["time"].to_i)
+        @comment = node["text"]
+      end
+
+      private
+
+      def average_rating(arr)
+        return 0 if arr.nil? || arr.size < 1
+
+        sum = 0
+        arr.each { |el| sum += el["rating"].to_f }
+        sum.to_f / arr.size
+      end
+    end
+  end
+end

data/lib/providers/yelp/api.rb

@@ -0,0 +1,79 @@
+module Providers
+  module Yelp
+    class Api < Providers::Base
+
+      def initialize(options)
+        @consumer_key = options[:consumer_key]
+        @consumer_secret = options[:consumer_secret]
+        @token = options[:token]
+        @token_secret = options[:token_secret]
+      end
+
+      def find_business_by_name(name, business_type, city_state)
+        access_token = create_oauth_token
+        response = JSON.parse(access_token.get(business_path(name, business_type, city_state)).body)
+        parse_businesses(response["businesses"])
+      end
+
+      def find_reviews_for_business(yelp_id)
+        access_token = create_oauth_token
+        response = JSON.parse(access_token.get(review_path(yelp_id)).body)
+        parse_reviews(response["reviews"])
+      end
+
+      def find_business_by_id(yelp_id)
+        access_token = create_oauth_token
+        response = JSON.parse(access_token.get(review_path(yelp_id)).body)
+        Providers::YelpReviews::Business.build_business(response) if response &&
+          response["location"] &&
+          response["location"]["display_address"]
+
+      end
+
+      private
+
+      def create_oauth_token
+        consumer_key = @consumer_key
+        consumer_secret = @consumer_secret
+        token = @token
+        token_secret = @token_secret
+
+        consumer = OAuth::Consumer.new(consumer_key, consumer_secret, site: "http://api.yelp.com")
+        OAuth::AccessToken.new(consumer, token, token_secret)
+      end
+
+      def business_path(name, business_type, city_state)
+        "/v2/search?term=#{URI::encode(name)}&category_filter=#{URI::encode(business_type)}&location=#{URI::encode(city_state)}"
+      end
+
+      def review_path(yelp_id)
+        "/v2/business/#{yelp_id}"
+      end
+
+      def parse_businesses(business_list)
+        result = []
+        return result if business_list.nil? ||
+          business_list.empty? ||
+          business_list["location"].nil? ||
+          business_list["location"]["display_address"].nil?
+
+        business_list.each do |business|
+          result.push(Providers::YelpReviews::Business.build_business(business))
+        end
+
+        result
+      end
+
+      def parse_reviews(review_list)
+        result = []
+        return result if review_list.nil?
+
+        review_list.each do |review|
+          result.push(Providers::YelpReviews::Review.new(review))
+        end
+
+        result
+      end
+    end
+  end
+end

data/lib/providers/yelp/business.rb

@@ -0,0 +1,29 @@
+module Providers
+  module Yelp
+    class Business
+      attr_accessor :name, :address, :yelp_id, :average_rating, :total_reviews
+
+      def self.build_business(node)
+        return nil if [node["location"], node["rating"], node["id"]].include?(nil)
+        new(node)
+      end
+
+      private
+
+      def initialize(node)
+        return if [node,
+                  node["location"],
+                  node["location"]["display_address"],
+                  node["rating"],
+                  node["review_count"],
+                  node["id"]].include?(nil)
+
+        @address = node["location"]["display_address"].join(" ")
+        @name = node["name"]
+        @average_rating = node["rating"]
+        @total_reviews = node["review_count"]
+        @yelp_id = node["id"]
+      end
+    end
+  end
+end

data/lib/providers/yelp/review.rb

@@ -0,0 +1,14 @@
+module Providers
+  module Yelp
+    class Review
+      attr_accessor :rating, :author_name, :reviewed_at, :comment
+
+      def initialize(node)
+        @rating = node["rating"]
+        @author_name = node["name"]
+        @reviewed_at = Time.at(node["time_created"].to_i)
+        @comment = node["excerpt"]
+      end
+    end
+  end
+end

data/lib/user_reviews/version.rb

@@ -0,0 +1,3 @@
+module UserReviews
+  VERSION = "0.0.7".freeze
+end

data/lib/user_reviews.rb

@@ -0,0 +1,26 @@
+require "user_reviews/version"
+require 'active_support/inflector'
+
+Dir[File.dirname(__FILE__) + "/providers/*.rb"].each do |file|
+  require "#{file}"
+end
+
+Dir[File.dirname(__FILE__) + "/providers/**/*.rb"].each do |file|
+  require "#{file}"
+end
+
+module UserReviews
+  class ProviderNotFoundError < StandardError; end
+
+  include ActiveSupport::Inflector
+
+  def self.provider_factory(service, init_options)
+    service = service.to_s.classify
+
+    begin
+      "Providers::#{service}::Api".constantize.new(init_options)
+    rescue => e
+      raise ProviderNotFoundError.new(e)
+    end
+  end
+end

data/spec/providers/citysearch/api_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe Providers::Citysearch::Api do
+
+  describe "#initialize" do
+    it "initializes a new CitySearch provider" do
+      Providers::Citysearch::Api.new(publisher_key: "").should be
+    end
+  end
+
+  describe "#find_business_by_name" do
+    let(:json_result) { { "address" => {} } }
+    let(:business_url) { "http://www.example.com" }
+    let(:citysearch_wrapper) { Providers::Citysearch::Api.new(key: "") }
+    let(:query_result) { [Providers::Citysearch::Business.build_business(json_result)] }
+
+    it "returns an array of possible businesses" do
+      citysearch_wrapper.should_receive(:business_search_url).with("Unpakt", "moving company", "NY,NY") {  business_url }
+      HTTParty.should_receive(:get).with(business_url) { json_result }
+      citysearch_wrapper.should_receive(:parse_business_results).with(json_result) { query_result }
+
+      citysearch_wrapper.find_business_by_name("Unpakt", "moving company", "NY,NY").should eq query_result
+    end
+  end
+
+
+  describe "#find_reviews_for_business" do
+    let(:citysearch_id) { stub }
+    let(:json_result) { {"review_date" => "2007-03-07T21:53:41.000Z"} }
+    let(:reviews_url) { "http://www.example.com" }
+    let(:citysearch_wrapper) { Providers::Citysearch::Api.new(key: "") }
+    let(:query_result) { [Providers::Citysearch::Review.new(json_result)] }
+
+    it "returns the rating for a given entity" do
+      citysearch_wrapper.should_receive(:reviews_url).with(citysearch_id) {  reviews_url }
+      HTTParty.should_receive(:get).with(reviews_url) { json_result }
+      citysearch_wrapper.should_receive(:parse_reviews_results).with(json_result) { query_result }
+
+      citysearch_wrapper.find_reviews_for_business(citysearch_id).should eq query_result
+    end
+  end
+end

data/spec/providers/citysearch/business_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Providers::Citysearch::Business do
+  describe "#initialize" do
+    let(:address) { {"street" => '', "city" => '', "state" => '', "postal_code" => '' } }
+    let(:node) do
+      {
+        "name" => '',
+        "address" => address,
+        "id" => stub,
+        "rating" => stub,
+        "review_info" => {}
+      }
+    end
+
+    context "when required fields are not present" do
+      let(:node) { Hash.new(nil) }
+      it "returns nil" do
+        biz = Providers::Citysearch::Business.build_business(node)
+        biz.should be_nil
+      end
+    end
+
+    context "when required fields are present" do
+      it "returns an Bussiness object" do
+        Providers::Citysearch::Business.build_business(node).should be
+      end
+    end
+
+  end
+end

data/spec/providers/google/api_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe Providers::Google::Api do
+
+  describe "#initialize" do
+    it "initializes a new GoogleReviews provider" do
+      Providers::Google::Api.new(key: "").should be
+    end
+  end
+
+  describe "#find_business_by_name" do
+    let(:json_result) { "{}" }
+    let(:business_url) { "http://www.example.com" }
+    let(:google_wrapper) { Providers::Google::Api.new(key: "") }
+    let(:query_result) { [Providers::Google::Business.build_business(json_result)] }
+
+    context "when the api is valid" do
+      it "returns an array of possible businesses" do
+        google_wrapper.should_receive(:business_url).with("Unpakt", "moving_company") {  business_url }
+        HTTParty.should_receive(:get).with(business_url) { json_result }
+        google_wrapper.should_receive(:parse_business_results).with(json_result) { query_result }
+
+        google_wrapper.find_business_by_name("Unpakt", "moving_company").should eq query_result
+      end
+    end
+
+    context "when the api query limit is reached" do
+      let(:json_result) { {'status' => 'OVER_QUERY_LIMIT'} }
+
+       it "raises an error" do
+         google_wrapper.should_receive(:business_url).with("Unpakt", "moving_company") {  business_url }
+         HTTParty.should_receive(:get).with(business_url) { json_result }
+         lambda { google_wrapper.find_business_by_name("Unpakt", "moving_company") }.should raise_error Providers::Google::ExceededQueryLimitError
+       end
+    end
+  end
+
+  describe "#find_reviews_for_business" do
+    let(:reference) { stub }
+    let(:json_result) { "{}" }
+    let(:reviews_url) { "http://www.example.com" }
+    let(:google_wrapper) { Providers::Google::Api.new(key: "") }
+    let(:query_result) { [Providers::Google::Review.new(json_result)] }
+
+    it "returns the rating for a given entity" do
+      google_wrapper.should_receive(:reviews_url).with(reference) {  reviews_url }
+      HTTParty.should_receive(:get).with(reviews_url) { json_result }
+      google_wrapper.should_receive(:parse_reviews_results).with(json_result) { query_result }
+
+      google_wrapper.find_reviews_for_business(reference).should eq query_result
+    end
+  end
+
+end

data/spec/providers/google/business_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe Providers::Google::Business do
+  describe "#initialize" do
+    let(:node) do
+      {
+        "name" => '',
+        "formatted_address" => '',
+        "reference" => stub,
+        "url" => stub,
+        "rating" => stub
+      }
+    end
+
+    context "when required fields are not present" do
+      let(:node) { Hash.new(nil) }
+      it "returns nil" do
+        biz = Providers::Google::Business.build_business(node)
+        biz.should be_nil
+      end
+    end
+
+    context "when required fields are present" do
+      it "returns an Bussiness object" do
+        Providers::Google::Business.build_business(node).should be
+      end
+    end
+
+  end
+end

data/spec/providers/yelp/api_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+describe Providers::Yelp::Api do
+
+  describe "#initialize" do
+    it "initializes a new GoogleReviews provider" do
+      Providers::Yelp::Api.new(consumer_key: "",
+                                    consumer_secret: "",
+                                    token: "",
+                                    token_secret: "").should be
+    end
+  end
+
+  describe "#find_business_by_name" do
+    let(:token) { stub }
+    let(:api_result) { stub }
+    let(:response_body) { stub }
+    let(:business_path) { "super_path" }
+    let(:business_place) do
+      {"location" => {"display_address" => ["1 Place", "NY"]}}
+    end
+    let(:json_result) {{"businesses" => business_places }}
+    let(:business_places) { [business_place] }
+    let(:yelp_wrapper) { Providers::Yelp::Api.new({}) }
+    let(:query_result) { [Providers::Yelp::Business.build_business(business_place)] }
+
+    it "returns an array of possible businesses" do
+      yelp_wrapper.should_receive(:create_oauth_token) { token }
+      yelp_wrapper.should_receive(:business_path).with("Unpakt", "movers", "NY,NY") { business_path }
+      token.should_receive(:get).with(business_path) { api_result }
+      api_result.should_receive(:body) { response_body }
+
+
+      JSON.should_receive(:parse).with(response_body) { json_result }
+      yelp_wrapper.should_receive(:parse_businesses).with(business_places) { query_result }
+
+      yelp_wrapper.find_business_by_name("Unpakt", "movers", "NY,NY").should eq query_result
+    end
+  end
+
+
+  describe "#find_reviews_for_business" do
+    let(:token) { stub }
+    let(:api_result) { stub }
+    let(:response_body) { stub }
+    let(:review_path) { "super_path" }
+    let(:review) {{"rating" => 1}}
+    let(:reviews) { [review] }
+    let(:json_result) {{"reviews" => reviews }}
+    let(:yelp_wrapper) { Providers::Yelp::Api.new({}) }
+    let(:query_result) { [Providers::Yelp::Review.new(review)] }
+
+    it "returns an array of possible businesses" do
+      yelp_wrapper.should_receive(:create_oauth_token) { token }
+      yelp_wrapper.should_receive(:review_path).with("yelp-Unpakt") { review_path }
+      token.should_receive(:get).with(review_path) { api_result }
+      api_result.should_receive(:body) { response_body }
+
+
+      JSON.should_receive(:parse).with(response_body) { json_result }
+      yelp_wrapper.should_receive(:parse_reviews).with(reviews) { query_result }
+
+      yelp_wrapper.find_reviews_for_business("yelp-Unpakt").should eq query_result
+    end
+  end
+end

data/spec/providers/yelp/business_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Providers::Yelp::Business do
+  describe "#initialize" do
+    let(:node) do
+      {
+        "location" => '',
+        "rating" => '',
+        "id" => stub,
+      }
+    end
+
+    context "when required fields are not present" do
+      let(:node) { Hash.new(nil) }
+      it "returns nil" do
+        biz = Providers::Yelp::Business.build_business(node)
+        biz.should be_nil
+      end
+    end
+
+    context "when required fields are present" do
+      it "returns an Bussiness object" do
+        Providers::Yelp::Business.build_business(node).should be
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require_relative File.dirname(__FILE__) + "/../lib/user_reviews"
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+

data/spec/user_reviews_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe UserReviews do
+  describe "::provider_factory" do
+    context "when the provider exists" do
+      it "returns a new Yelp api provider object" do
+        UserReviews.provider_factory(:yelp, {}).should be_an_instance_of Providers::Yelp::Api
+      end
+
+      it "returns a new google api provider object" do
+        UserReviews.provider_factory(:google, {}).should be_an_instance_of Providers::Google::Api
+      end
+
+      it "returns a new citysearch api provider object" do
+        UserReviews.provider_factory(:citysearch, {}).should be_an_instance_of Providers::Citysearch::Api
+      end
+    end
+
+    context "when the :not_found provider doesn't exist" do
+      it "raises a provider not found error" do
+        lambda {UserReviews.provider_factory(:foobar, {}) }.should raise_error UserReviews::ProviderNotFoundError
+      end
+    end
+
+  end
+end

data/user_reviews.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'user_reviews/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "user_reviews"
+  gem.version       = UserReviews::VERSION.dup
+  gem.authors       = ["Unpakt LLC"]
+  gem.email         = ["info@unpakt.com"]
+  gem.description   = %q{Wrapper for mulitple user review APIs}
+  gem.summary       = %q{Wrapper for mulitple user review APIs}
+  gem.homepage      = "http://www.unpakt.com"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "activesupport", "~> 3.2.11"
+  gem.add_dependency "rake"
+  gem.add_dependency "httparty"
+  gem.add_dependency "oauth"
+  gem.add_dependency "json"
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: user_reviews
+version: !ruby/object:Gem::Version
+  version: 0.0.7
+  prerelease: 
+platform: ruby
+authors:
+- Unpakt LLC
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.11
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Wrapper for mulitple user review APIs
+email:
+- info@unpakt.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/providers/base.rb
+- lib/providers/citysearch/api.rb
+- lib/providers/citysearch/business.rb
+- lib/providers/citysearch/review.rb
+- lib/providers/google/api.rb
+- lib/providers/google/business.rb
+- lib/providers/google/review.rb
+- lib/providers/yelp/api.rb
+- lib/providers/yelp/business.rb
+- lib/providers/yelp/review.rb
+- lib/user_reviews.rb
+- lib/user_reviews/version.rb
+- spec/providers/citysearch/api_spec.rb
+- spec/providers/citysearch/business_spec.rb
+- spec/providers/google/api_spec.rb
+- spec/providers/google/business_spec.rb
+- spec/providers/yelp/api_spec.rb
+- spec/providers/yelp/business_spec.rb
+- spec/spec_helper.rb
+- spec/user_reviews_spec.rb
+- user_reviews.gemspec
+homepage: http://www.unpakt.com
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Wrapper for mulitple user review APIs
+test_files:
+- spec/providers/citysearch/api_spec.rb
+- spec/providers/citysearch/business_spec.rb
+- spec/providers/google/api_spec.rb
+- spec/providers/google/business_spec.rb
+- spec/providers/yelp/api_spec.rb
+- spec/providers/yelp/business_spec.rb
+- spec/spec_helper.rb
+- spec/user_reviews_spec.rb
+has_rdoc: