indix 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c30a8ec0c8134ae18fe904a480b1ff2d33dcbc9a
+  data.tar.gz: 844fb6b2e8a2c29fbb82ca40971c239f8f6a060a
+SHA512:
+  metadata.gz: 6d2f71b18a055c4f60d2d34bbfc44752d332b91beef580288e1beac3fca347dfadaa52b10acbca4bf4d918c969b6f244560bf94862532ee0267ed68194452bdb
+  data.tar.gz: 22bbb43dc66ec2fc96a9974c72869629e80ca237132079db5bb966dba7d4cf37a81a2c5a33d485c3333df51aea2b25967b36549c61613599a3912fb840922173

data/README.md

@@ -0,0 +1,48 @@
+# Indix
+
+Offical Ruby Wrapper for Indix API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'indix'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install indix
+
+## Usage
+
+Require the Gem:
+
+    require 'indix'
+
+Configure Indix client with the app_id and app_key provided to you
+
+    Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+
+    or
+
+    Indix::Config.app_id = '12345'
+    Indix::Config.app_key = '12345abcde'
+
+Call the API endpoints
+
+    Indix::Stores.search('amazon')
+    Indix::Products.search(query: 'nike', store_id: 1234)
+
+Use the response
+
+    products_response = Indix::Products.search(query: 'nike')
+    puts products_response.count
+    puts products_response.products[0].id
+    puts products_response.products[0].offers_count
+
+
+
+

data/lib/indix.rb

@@ -0,0 +1,38 @@
+require 'httpclient'
+require 'cgi'
+require 'json'
+require 'hashie'
+
+require 'indix/resource'
+Dir[File.join(File.dirname(__FILE__), 'indix', '*.rb')].each { |lib| require lib }
+
+class String
+
+  # borrowed from ActiveSupport
+  def underscore
+    word = self.dup
+    word.gsub!(/::/, '/')
+    word.gsub!(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
+    word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+    word.tr!("-", "_")
+    word.downcase!
+    word
+  end
+end
+
+class Mash < ::Hashie::Mash
+
+  # rubify keys
+  def convert_key(key)
+    key.to_s.underscore
+  end
+
+  def count
+    if self['count']
+      self['count']
+    else
+      super
+    end
+  end
+end
+

data/lib/indix/brands.rb

@@ -0,0 +1,13 @@
+module Indix
+  class Brands
+    extend Indix::Resource
+
+    # Get the brands matching the query text
+    #
+    # @param query [String]
+    # @return [Mash] an array containing each matching brand's Id and name
+    def self.search(query)
+      get('/brands', {:query => query})
+    end
+  end
+end

data/lib/indix/categories.rb

@@ -0,0 +1,12 @@
+module Indix
+  class Categories
+    extend Indix::Resource
+
+    # Get all categories
+    #
+    # @return [Mash] an array containing each category's Id, name, Id path and name path
+    def self.all
+      get('/categories')
+    end
+  end
+end

data/lib/indix/config.rb

@@ -0,0 +1,55 @@
+module Indix
+
+  #Thrown when app_id or app_key missing
+  ConfigurationError = Class.new StandardError
+
+  #Thrown when the arguments passed do not confirm to pre-conditions
+  ArgumentError = Class.new StandardError
+
+  #Thrown when the API has received too many requests from this client in a given amount of time
+  LimitExceededError = Class.new StandardError
+
+  #Thrown when app_id or app_key passed are invalid
+  AuthenticationError = Class.new StandardError
+
+  #Thrown when the app_id/app_key is not authorized to access a resource
+  UnauthorizedAccessError = Class.new StandardError
+
+  module Config
+
+    module_function
+
+    # Sets the app_id
+    def app_id=(app_id)
+      @app_id = app_id
+    end
+
+    # Sets the app_key
+    def app_key=(app_key)
+      @app_key = app_key
+    end
+
+    def app_id
+      if @app_id
+        @app_id
+      else
+        raise ConfigurationError.new "Cannot complete request. Please provide app_id first"
+      end
+    end
+
+    def app_key
+      if @app_key
+        @app_key
+      else
+        raise ConfigurationError.new "Cannot complete request. Please provide app_key first"
+      end
+    end
+
+    # Set app_id and app_key
+    def setup(options={})
+      options.map do |k,v|
+          send("#{k}=", v)
+      end
+    end
+  end
+end

data/lib/indix/offers.rb

@@ -0,0 +1,15 @@
+ module Indix
+  class Offers
+    extend Indix::Resource
+
+    # Get the offers for a product at a store
+    #
+    # @param product_id [String]
+    # @param store_id [Fixnum]
+    # @return [Mash] an object containing the count and offers array
+    def self.find(product_id, store_id)
+      request_params = {:storeId => store_id}
+      get("/products/#{product_id}/offers", request_params)
+    end
+  end
+end

data/lib/indix/prices.rb

@@ -0,0 +1,15 @@
+module Indix
+  class Prices
+    extend Indix::Resource
+
+    # Get the prices for a product at a store
+    #
+    # @param product_id [String]
+    # @param store_id [Fixnum]
+    # @return [Mash] an object containing a few product details like the store, brand etc and an array of prices and recorded time
+    def self.find(product_id, store_id)
+      request_params = {:storeId => store_id}
+      get("/products/#{product_id}/prices", request_params)
+    end
+  end
+end

data/lib/indix/products.rb

@@ -0,0 +1,65 @@
+ module Indix
+  class Products
+    extend Indix::Resource
+
+    # Get the products that match the search criteria
+    #
+    # @param query [String]
+    # @param upc [String]
+    # @param mpn [String]
+    # @param sku [String]
+    # @param url [String] product URL
+    # @param stores [String] (Comma seperated list of store Ids)
+    # @param brands [String](Comma seperated list of brand Ids)
+    # @param category_id [Fixnum]
+    # @param start_price [BigDecimal]
+    # @param end_price [BigDecimal]
+    # @param availability [String] Possible values: 'IN_STOCK', 'OUT_OF_STOCK'
+    # @param price_history_available [Boolean]
+    # @param offers_count [Fixnum] Minimum number of offers the matched product should have
+    # @param price_change [String] Possible values: 'PRICE_INCREASED', 'PRICE_DECREASED'
+    # @param sort_by [String] Possible values: 'PRICE_LOW_TO_HIGH', 'PRICE_HIGH_TO_LOW', 'MOST_RECENT'
+    # @param page_number [Fixnum]
+
+    # @return [Mash] an object containing the count, products array and page_number
+    def self.search(query: nil, upc: nil, mpn: nil, sku: nil, url: nil, stores: nil, brands: nil, category_id: nil,
+      start_price: nil, end_price: nil, availability: nil, price_history_available: nil, offers_count: nil, price_change: nil, sort_by: nil, page_number: 1)
+      request_params = {}
+      request_params[:query] = query unless query.nil?
+      request_params[:upc] = upc unless upc.nil?
+      request_params[:mpn] = mpn unless mpn.nil?
+      request_params[:sku] = sku unless sku.nil?
+      request_params[:url] = url unless url.nil?
+      request_params[:storeId] = stores unless stores.nil?
+      request_params[:brandId] = brands unless brands.nil?
+      request_params[:categoryId] = category_id unless category_id.nil?
+
+      raise Indix::ArgumentError.new('Atleast one required parameter should be passed') if request_params.empty?
+
+      request_params[:startPrice] = start_price unless start_price.nil?
+      request_params[:endPrice] = end_price unless end_price.nil?
+      request_params[:availability] = availability unless availability.nil?
+      request_params[:priceHistoryAvailable] = price_history_available unless price_history_available.nil?
+      request_params[:offersCount] = offers_count unless offers_count.nil?
+      request_params[:priceChange] = price_change unless price_change.nil?
+      request_params[:sortBy] = sort_by unless sort_by.nil?
+      request_params[:pageNumber] = page_number
+
+      get("/products", request_params)
+    end
+
+    # Get the details of a product
+    #
+    # @param product_id [String]
+    # @param view [Fixnum] (Optional) Possible values: 'offers', 'offers_catalog' and 'catalog'
+    # @params page_number [Fixnum] Use to paginate through the offers array
+    #
+    # @return [Mash] an object containing the product details like the store, brand etc and an array of offers (presence depends on the view type) and page_number
+    def self.find(id, view: nil, page_number: 1)
+      request_params = {}
+      request_params[:view] = view unless view.nil?
+      request_params[:pageNumber] = page_number
+      get("/products/#{id}", request_params)
+    end
+  end
+end

data/lib/indix/resource.rb

@@ -0,0 +1,64 @@
+require 'httpclient'
+require 'json'
+require 'cgi'
+
+module Indix
+  module Resource
+
+    def base_uri
+      @base_uri ||= 'https://api.indix.com/v1'
+    end
+
+    def client
+      @client ||= HTTPClient.new
+    end
+
+    def get(path, params = {})
+      params[:app_id] = Indix::Config.app_id
+      params[:app_key] = Indix::Config.app_key
+
+      # no need to escape params as httpclient does it anyways
+      target = base_uri + path
+      client.ssl_config.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      response = client.get(target, :query => params)
+      if response.status == 200
+        content = JSON.parse(response.content)
+        data = content["response"]
+        data = to_hashie(data)
+      elsif response.status == 401
+        raise AuthenticationError.new('Cannot complete request. Authentication failed. Please provide a valid app_id and app_key')
+      elsif response.status == 402
+        raise UnauthorizedAccessError.new('Cannot complete request. Not authorized to access this resource')
+      elsif response.status == 429
+        raise LimitExceededError.new('Too many requests')
+      else
+        raise StandardError.new('Cannot complete request. Response Code: ' + response.status.to_s + ' Response Body: ' + response.content)
+      end
+
+    end
+
+    private
+
+    def to_hashie(json)
+      if json.is_a? Array
+        json.collect! { |x| x.is_a?(Hash) ? Mash.new(x) : x }
+      else
+        Mash.new(json)
+      end
+    end
+
+    def can_escape(value)
+      case value
+      when Fixnum
+        return false
+      when TrueClass
+        return false
+      when FalseClass
+        return false
+      end
+      true
+    end
+  end
+end
+
+

data/lib/indix/stores.rb

@@ -0,0 +1,13 @@
+module Indix
+  class Stores
+    extend Indix::Resource
+
+    # Get the stores matching the query text
+    #
+    # @param query [String]
+    # @return [Mash] an array containing each matching store's Id and name
+    def self.search(query)
+      get('/stores', {:query => query})
+    end
+  end
+end

data/lib/indix/version.rb

@@ -0,0 +1,3 @@
+module Indix
+  VERSION = "1.0"
+end

data/spec/lib/indix/brands_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Indix::Brands do
+
+  describe "Brands Search API" do
+    it "must succeed when valid parameters are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/brands', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :query => 'wal'}}).returns(mock_response('brands'))
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      brands = Indix::Brands.search('wal')
+      brands.length.must_equal 10
+      brands[0].id.must_equal "6715"
+      brands[0].name.must_equal "Walgreens"
+    end
+  end
+
+end

data/spec/lib/indix/categories_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Indix::Categories do
+
+  describe "Categories export API" do
+    it "must succeed when valid parameters are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/categories', {:query => {:app_id=>'12345', :app_key=>'12345abcde'}}).returns(mock_response('categories'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      categories = Indix::Categories.all
+      categories.length.must_equal 9
+      categories[0].id.must_equal 10001
+      categories[0].name.must_equal "Apparel"
+      categories[6].id.must_equal 10019
+      categories[6].name.must_equal "Home Care"
+      categories[6].name_path.must_equal "Grocery, Health & Personal Care > Home Care"
+      categories[6].id_path.must_equal "10018 > 10019"
+    end
+  end
+
+end

data/spec/lib/indix/config_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Indix::Config do
+
+  describe "Request to Indix API" do
+    it "must fail when no app_id or app_key is configured" do
+      Indix::Config.app_id = nil
+      Indix::Config.app_key = nil
+      lambda {Indix::Brands.search('wal')}.must_raise Indix::ConfigurationError
+    end
+  end
+
+  describe "Indix API configuration" do
+    it "must be properly setup" do
+      Indix::Config.setup({:app_id => 'abc12345', :app_key => 'abcd1234567890'})
+      Indix::Config.app_id.must_equal 'abc12345'
+      Indix::Config.app_key.must_equal 'abcd1234567890'
+    end
+  end
+
+end

data/spec/lib/indix/offers_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe Indix::Offers do
+  describe "Store Offers API" do
+   it "must return proper response when a valid product_id and store_id are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products/01aec3dc861c642805cb4be5784e2521/offers', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :storeId => 57}}).returns(mock_response('offers'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      store_offer_response = Indix::Offers.find('01aec3dc861c642805cb4be5784e2521', 57)
+      store_offer_response.count.must_equal 1
+      store_offer_response.offers.count.must_equal 1
+      store_offer_response.offers[0].id.must_equal '01aec3dc861c642805cb4be5784e2521'
+      store_offer_response.offers[0].title.must_equal 'Nike Revolution 2 Wolf Grey/Cool Grey/Volt/Black'
+      store_offer_response.offers[0].store_id.must_equal 57
+      store_offer_response.offers[0].store_name.must_equal 'Zappos.com'
+      store_offer_response.offers[0].brand_id.must_equal 5572
+      store_offer_response.offers[0].brand_name.must_equal 'Nike'
+      store_offer_response.offers[0].product_url.must_equal 'http://www.zappos.com/nike-revolution-2-dark-grey-cool-grey-total-crimson-hyper-blue'
+      store_offer_response.offers[0].image_url.must_equal 'http://www.zappos.com/images/z/2/0/8/4/1/6/2084160-p-DETAILED.jpg'
+      store_offer_response.offers[0].category_id_path.must_equal '10003 > 11200 > 11211'
+      store_offer_response.offers[0].category_name_path.must_equal 'Shoes & Accessories > Shoes > Men\'s Shoes'
+      store_offer_response.offers[0].upc.must_equal 'NA'
+      store_offer_response.offers[0].sku.must_equal '8064765'
+      store_offer_response.offers[0].mpn.must_equal 'NA'
+      store_offer_response.offers[0].price.list_price.must_equal 55
+      store_offer_response.offers[0].price.sale_price.must_equal 55
+      store_offer_response.offers[0].cart_price.must_equal false
+      store_offer_response.offers[0].last_recorded_at.must_equal 1399287717330
+      store_offer_response.offers[0].price_history_available.must_equal true
+      store_offer_response.offers[0].availability.must_equal 'In Stock'
+      store_offer_response.offers[0].buy_box_winner.must_equal false
+      store_offer_response.offers[0].add_on_item.must_equal false
+      store_offer_response.offers[0].new_offers.must_equal 0
+      store_offer_response.offers[0].used_offers.must_equal 0
+      store_offer_response.offers[0].refurbished_offers.must_equal 0
+      store_offer_response.offers[0].user_ratings.must_equal 0
+      store_offer_response.offers[0].average_rating.must_equal 0
+      store_offer_response.offers[0].max_rating.must_equal 0
+      store_offer_response.offers[0].sales_rank.must_equal 0
+      store_offer_response.offers[0].tags.count.must_equal 15
+      store_offer_response.offers[0].tags[0].must_equal 'nike'
+    end
+  end
+
+end

data/spec/lib/indix/prices_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Indix::Prices do
+  describe "Price History API" do
+   it "must return proper response when a valid product_id and store_id are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products/01aec3dc861c642805cb4be5784e2521/prices', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :storeId => 57}}).returns(mock_response('prices'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      price_history_response = Indix::Prices.find('01aec3dc861c642805cb4be5784e2521', 57)
+      price_history_response.id.must_equal '01aec3dc861c642805cb4be5784e2521'
+      price_history_response.store_id.must_equal 57
+      price_history_response.brand_id.must_equal 5572
+      price_history_response.category_id.must_equal 11211
+      price_history_response.price_history.count.must_equal 8
+      price_history_response.price_history[0].sale_price.must_equal 55
+      price_history_response.price_history[0].list_price.must_equal 55
+      price_history_response.price_history[0].recorded_at.must_equal 1398729599999
+    end
+  end
+
+end

data/spec/lib/indix/products_spec.rb

@@ -0,0 +1,150 @@
+require 'spec_helper'
+
+describe Indix::Products do
+
+  describe "Products Search API" do
+    it "must fail when no required parameters are passed" do
+      lambda {Indix::Products.search()}.must_raise Indix::ArgumentError
+    end
+
+    it "must return proper response when a valid query is passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :query => 'nike', :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(query: 'nike')
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+      products_response.products[0].id.must_equal '01aec3dc861c642805cb4be5784e2521'
+      products_response.products[0].title.must_equal 'Nike Revolution 2 Wolf Grey/Cool Grey/Volt/Black'
+      products_response.products[0].brand_id.must_equal 5572
+      products_response.products[0].brand_name.must_equal 'Nike'
+      products_response.products[0].image_url.must_equal 'http://www.zappos.com/images/z/2/0/8/4/1/6/2084160-p-DETAILED.jpg'
+      products_response.products[0].category_id_path.must_equal '10003 > 11200 > 11211'
+      products_response.products[0].category_name_path.must_equal 'Shoes & Accessories > Shoes > Men\'s Shoes'
+      products_response.products[0].upc.must_equal 'NA'
+      products_response.products[0].mpn.must_equal 'NA'
+      products_response.products[0].store_count.must_equal 1
+      products_response.products[0].offers_count.must_equal 1
+      products_response.products[0].offers_price_range.must_equal '55.0-55.0'
+    end
+
+    it "must return proper response when a valid upc is passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :upc => 81732301143, :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(upc: 81732301143)
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+
+    it "must return proper response when a valid sku is passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :sku => 486053, :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(sku: 486053)
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+
+    it "must return proper response when a valid mpn is passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :mpn => '5217TZG', :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(mpn: '5217TZG')
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+
+    it "must return proper response when valid store_id, brand_id and category_id are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :storeId => 123, :brandId => 234, :categoryId => 345, :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(stores: 123, brands: 234, category_id: 345)
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+
+    it "must return proper response when valid store_id, price_change, price_history_available and availability are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :storeId => 123, :priceChange => 'PRICE_DECREASED', :availability => 'IN_STOCK', :priceHistoryAvailable => true, :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(stores: 123, price_change: 'PRICE_DECREASED', availability: 'IN_STOCK', price_history_available: true)
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+
+    it "must return proper response when valid query, start_price, end_rice, sort_by and page_number are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :query => 'nike', :startPrice => 100, :endPrice => 200, :sortBy => 'PRICE_LOW_TO_HIGH', :pageNumber => 2}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(query: 'nike', start_price: 100, end_price: 200, sort_by: 'PRICE_LOW_TO_HIGH', page_number: 2)
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+
+    it "must return proper response when valid url and offers_count are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :url => 'www.google.com', :offersCount => 5, :pageNumber => 1}}).returns(mock_response('products'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      products_response = Indix::Products.search(url: 'www.google.com', offers_count: 5)
+      products_response.count.must_equal 2010
+      products_response.products.length.must_equal 10
+    end
+  end
+
+  describe "Products Details API" do
+    it "must return proper response when a valid product_id is passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products/12345', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :pageNumber => 1}}).returns(mock_response('product'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      product = Indix::Products.find(12345)
+      product.id.must_equal '01aec3dc861c642805cb4be5784e2521'
+      product.title.must_equal 'Nike Revolution 2 Wolf Grey/Cool Grey/Volt/Black'
+      product.brand_id.must_equal 5572
+      product.brand_name.must_equal 'Nike'
+      product.image_url.must_equal 'http://www.zappos.com/images/z/2/0/8/4/1/6/2084160-p-DETAILED.jpg'
+      product.category_id_path.must_equal '10003 > 11200 > 11211'
+      product.category_name_path.must_equal 'Shoes & Accessories > Shoes > Men\'s Shoes'
+      product.upc.must_equal 'NA'
+      product.offers_count.must_equal 1
+      product.offers.count.must_equal 1
+      product.offers[0].id.must_equal '01aec3dc861c642805cb4be5784e2521'
+      product.offers[0].title.must_equal 'Nike Revolution 2 Wolf Grey/Cool Grey/Volt/Black'
+      product.offers[0].store_id.must_equal 57
+      product.offers[0].store_name.must_equal 'Zappos.com'
+      product.offers[0].product_url.must_equal 'http://www.zappos.com/nike-revolution-2-dark-grey-cool-grey-total-crimson-hyper-blue'
+      product.offers[0].image_url.must_equal 'http://www.zappos.com/images/z/2/0/8/4/1/6/2084160-p-DETAILED.jpg'
+      product.offers[0].sku.must_equal '8064765'
+      product.offers[0].mpn.must_equal 'NA'
+      product.offers[0].last_recorded_at.must_equal 1399287717330
+      product.offers[0].tags.count.must_equal 15
+      product.offers[0].tags[0].must_equal 'nike'
+      product.offers[0].price.list_price.must_equal 55
+      product.offers[0].price.sale_price.must_equal 55
+      product.offers[0].cart_price.must_equal false
+      product.offers[0].price_history_available.must_equal true
+      product.offers[0].availability.must_equal 'In Stock'
+      product.offers[0].buy_box_winner.must_equal false
+      product.offers[0].add_on_item.must_equal false
+      product.offers[0].new_offers.must_equal 0
+      product.offers[0].used_offers.must_equal 0
+      product.offers[0].refurbished_offers.must_equal 0
+      product.offers[0].user_ratings.must_equal 0
+      product.offers[0].average_rating.must_equal 0
+      product.offers[0].max_rating.must_equal 0
+      product.offers[0].sales_rank.must_equal 0
+      product.offers[0].attributes.count.must_equal 8
+      product.offers[0].attributes.keys[0].must_equal 'liningmaterial'
+      product.offers[0].attributes[:liningmaterial].must_equal 'Fabric'
+    end
+
+    it "must return proper response when a valid product_id, view and page_number are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/products/12345', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :view => 'offers', :pageNumber => 2}}).returns(mock_response('product'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      product = Indix::Products.find(12345, view: 'offers', page_number: 2)
+      product.id.must_equal '01aec3dc861c642805cb4be5784e2521'
+    end
+  end
+
+end

data/spec/lib/indix/resource_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Indix::Resource do
+
+  before do
+    @object = Object.new
+    @object.extend(Indix::Resource)
+  end
+
+  it "must throw AuthenticationError when the API returns 401" do
+    HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/categories', {:query => {:app_id=>'12345', :app_key=>'12345abcde'}}).returns(mock_authentication_error_response())
+
+    Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+    lambda {Indix::Categories.all}.must_raise Indix::AuthenticationError
+  end
+
+  it "must throw LimitExceededError when the API returns 429" do
+    HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/categories', {:query => {:app_id=>'12345', :app_key=>'12345abcde'}}).returns(mock_limit_exceeded_response())
+
+    Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+    lambda {Indix::Categories.all}.must_raise Indix::LimitExceededError
+  end
+
+  it "must throw UnauthorizedAccessError when the API returns 402" do
+    HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/categories', {:query => {:app_id=>'12345', :app_key=>'12345abcde'}}).returns(mock_unauthorized_response())
+
+    Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+    lambda {Indix::Categories.all}.must_raise Indix::UnauthorizedAccessError
+  end
+
+end

data/spec/lib/indix/stores_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Indix::Stores do
+
+  describe "Stores Search API" do
+    it "must succeed when valid parameters are passed" do
+      HTTPClient.any_instance.stubs(:get).with('https://api.indix.com/v1/stores', {:query => {:app_id=>'12345', :app_key=>'12345abcde', :query => 'wal'}}).returns(mock_response('stores'))
+
+      Indix::Config.setup({:app_id => '12345', :app_key => '12345abcde'})
+      stores = Indix::Stores.search('wal')
+      stores.length.must_equal 5
+      stores[2].id.must_equal "95"
+      stores[2].name.must_equal "Walgreens"
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+require 'indix'
+require 'minitest/spec'
+require 'minitest/autorun'
+require 'httpclient'
+require 'mocha/mini_test'
+
+def fixture_path
+  @path ||= File.expand_path('../fixtures', __FILE__)
+end
+
+def mock_response(request_type)
+  content = File.read(File.open(fixture_path + '/' + request_type + '.json'))
+  http_message = HTTP::Message.new_response(content)
+end
+
+def mock_authentication_error_response
+  http_message = HTTP::Message.new_response('{"status":401,"message":"Authentication error"')
+  http_message.status = 401
+  http_message
+end
+
+def mock_limit_exceeded_response
+  http_message = HTTP::Message.new_response('{"status":429,"message":"Too many requests"')
+  http_message.status = 429
+  http_message
+end
+
+def mock_unauthorized_response
+  http_message = HTTP::Message.new_response('{"status":402,"message":"Unauthorized"')
+  http_message.status = 402
+  http_message
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: indix
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- indix
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.4.1
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+description: Official Ruby wrapper for Indix API
+email:
+- support@indix.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/indix.rb
+- lib/indix/brands.rb
+- lib/indix/prices.rb
+- lib/indix/version.rb
+- lib/indix/config.rb
+- lib/indix/offers.rb
+- lib/indix/categories.rb
+- lib/indix/products.rb
+- lib/indix/resource.rb
+- lib/indix/stores.rb
+- spec/lib/indix/categories_spec.rb
+- spec/lib/indix/prices_spec.rb
+- spec/lib/indix/config_spec.rb
+- spec/lib/indix/stores_spec.rb
+- spec/lib/indix/products_spec.rb
+- spec/lib/indix/offers_spec.rb
+- spec/lib/indix/resource_spec.rb
+- spec/lib/indix/brands_spec.rb
+- spec/spec_helper.rb
+homepage: http://www.indix.com
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.9
+signing_key: 
+specification_version: 4
+summary: Official Ruby wrapper for Indix API
+test_files:
+- spec/lib/indix/categories_spec.rb
+- spec/lib/indix/prices_spec.rb
+- spec/lib/indix/config_spec.rb
+- spec/lib/indix/stores_spec.rb
+- spec/lib/indix/products_spec.rb
+- spec/lib/indix/offers_spec.rb
+- spec/lib/indix/resource_spec.rb
+- spec/lib/indix/brands_spec.rb
+- spec/spec_helper.rb
+has_rdoc: