tophatter-merchant 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8de1362487600774b5ef62b300902aa00bcbd078
+  data.tar.gz: d43f56863dc7cf280b01a85c0a5b4a3fb7de54d6
+SHA512:
+  metadata.gz: ceacd0c967b71400e9c001b6979a804f1f92b4ca18d236fc130c12c24eaac066f6220fe702e902c1de2ccc984d97301c91e7b6586a8422c9f1cfad292b7f0967
+  data.tar.gz: 3d077e9be766d053332a4708bcfe29b78b4c9398000dbd08fa23b82a6ae55f4f0f3433a7c3234caadbcc52425a588993060185191a0c73c562fa2e8949edc1b3

data/.gitignore

@@ -0,0 +1,7 @@
+Gemfile.lock
+.DS_Store
+*.swp
+/.bundle
+.idea
+.api_path
+.access_token

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/CHANGELOG

@@ -0,0 +1,3 @@
+=== 2.1.10 2016-01-28
+
+* Created GitHub project with initial code.

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+gemspec
+
+group :development, :test do
+  gem 'awesome_print'
+  gem 'pry'
+  gem 'rspec'
+  gem 'webmock'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2016 Tophatter, Inc
+
+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,120 @@
+### Tophatter Merchant API
+Full documentation is available [here](https://tophatter.readme.io/v1/docs).
+
+### Console Testing (Development)
+```bash
+echo http://tophatter.dev/merchant_api/v1 > .api_host
+echo a42880c4b7d0809300bed27c453f883d > .access_token
+bin/console
+```
+
+### API Authentication
+```ruby
+TophatterMerchant.access_token = <YOUR ACCESS TOKEN>
+```
+
+### Products
+
+#### List the product definition.
+```ruby
+TophatterMerchant::Product.schema
+```
+
+#### List all of the products in your inventory.
+```ruby
+TophatterMerchant::Product.all(page: 1, per_page: 100)
+```
+
+#### Search for products.
+```ruby
+TophatterMerchant::Product.search(query: 'Shirt', page: 1, per_page: 100)
+```
+
+#### Retrieve a specific product.
+```ruby
+TophatterMerchant::Product.retrieve('WAH5282')
+```
+
+#### Create a product.
+```ruby
+TophatterMerchant::Product.create(
+  identifier: '6631A',
+  category: 'Electronics|Hardware (Computers/Tablets/Phones)|Mobile',
+  title: 'Apple iPhone 6S',
+  description: 'This is the description.',
+  condition: 'Refurbished - Manufacturer',
+  starting_bid: 1,
+  buy_now_price: 150,
+  cost_basis: 75,
+  shipping_price: 5.0,
+  shipping_origin: 'United States',
+  weight: 6,
+  days_to_fulfill: 3,
+  days_to_deliver: 5,
+  variations: {
+    '6631A-WHITE': { identifier: '6631A-WHITE', color: 'White', quantity: 1 },
+    '6631A-BLACK': { identifier: '6631A-BLACK', color: 'Black', quantity: 2 }
+  },
+  primary_image: 'https://d38eepresuu519.cloudfront.net/b2aa7d2708324f756ffee551ba43a74f/original.jpg',
+  extra_images: 'https://d38eepresuu519.cloudfront.net/e615c55184c06f391dbd768f855904e6/original.jpg|https://d38eepresuu519.cloudfront.net/7cd125f0fa42c965675eabaf3309aa6d/original.jpg'
+)
+```
+
+#### Update a product.
+```ruby
+TophatterMerchant::Product.update('6631A', buy_now_price: 100)
+```
+
+#### Disable an enabled product.
+```ruby
+TophatterMerchant::Product.disable('6631A')
+```
+
+#### Enable a disabled product.
+```ruby
+TophatterMerchant::Product.enable('6631A')
+```
+
+### Variations
+
+#### Retrieve a specific variation.
+```ruby
+TophatterMerchant::Variation.retrieve('6631A-BLACK')
+```
+
+#### Create a variation.
+```ruby
+TophatterMerchant::Variation.create(product_identifier: '6631A', identifier: '6631A-PINK', color: 'Pink', quantity: 33)
+```
+
+#### Update a variation.
+```ruby
+TophatterMerchant::Variation.update('6631A-PINK', quantity: 999)
+```
+
+### Orders
+
+#### List all orders.
+```ruby
+TophatterMerchant::Order.all(filter: 'unfulfilled', page: 1, per_page: 100)
+```
+
+#### Retrieve a specific order.
+```ruby
+TophatterMerchant::Order.retrieve(1035509247)
+```
+
+#### Fulfill an order.
+```ruby
+TophatterMerchant::Order.fulfill(1035509247, carrier: 'USPS', tracking_number: '9400111899562173406594')
+```
+
+#### Refund the shipping fee for an order.
+```ruby
+TophatterMerchant::Order.refund(1035509249, type: 'partial', reason: 'delay_in_shipping', fees: ['shipping_fee'])
+```
+
+#### Refund an order in full.
+```ruby
+TophatterMerchant::Order.refund(1035509249, type: 'full', reason: 'out_of_stock')
+```

data/VERSION

@@ -0,0 +1 @@
+1.0

data/bin/console

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'rest-client'
+require 'tophatter_merchant'
+require 'awesome_print'
+require 'pry'
+
+begin
+  TophatterMerchant.api_path = File.read('.api_path').chomp
+rescue Errno::ENOENT
+end
+
+begin
+  TophatterMerchant.access_token = File.read('.access_token').chomp
+rescue Errno::ENOENT
+end
+
+puts "TophatterMerchant.api_path: #{TophatterMerchant.api_path}"
+puts "TophatterMerchant.access_token: #{TophatterMerchant.access_token}"
+
+Pry.config.color = false
+Pry.start

data/lib/tophatter_merchant.rb

@@ -0,0 +1,34 @@
+require 'active_model'
+
+require File.dirname(__FILE__) + '/tophatter_merchant/version'
+require File.dirname(__FILE__) + '/tophatter_merchant/exceptions'
+
+# Resources:
+require File.dirname(__FILE__) + '/tophatter_merchant/resource'
+require File.dirname(__FILE__) + '/tophatter_merchant/account'
+require File.dirname(__FILE__) + '/tophatter_merchant/api_key'
+require File.dirname(__FILE__) + '/tophatter_merchant/image'
+require File.dirname(__FILE__) + '/tophatter_merchant/metadata'
+require File.dirname(__FILE__) + '/tophatter_merchant/order'
+require File.dirname(__FILE__) + '/tophatter_merchant/product'
+require File.dirname(__FILE__) + '/tophatter_merchant/variation'
+
+module TophatterMerchant
+
+  def self.access_token
+    defined?(@@access_token) ? @@access_token : nil
+  end
+
+  def self.access_token=(token)
+    @@access_token = token
+  end
+
+  def self.api_path
+    defined?(@@api_path) ? @@api_path : 'https://tophatter.com/merchant_api/v1'
+  end
+
+  def self.api_path=(path)
+    @@api_path = path
+  end
+
+end

data/lib/tophatter_merchant/account.rb

@@ -0,0 +1,53 @@
+module TophatterMerchant
+  class Account < Resource
+
+    attr_accessor :access_token, :first_name, :last_name, :store_name, :email, :country, :time_zone
+
+    def id
+      email
+    end
+
+    class << self
+
+      # ap TophatterMerchant::Account.schema
+      def schema
+        get(url: "#{path}/schema.json")
+      end
+
+      # ap TophatterMerchant::Account.authenticate(email: 'megatron@autobot.com', password: 'ipipip').to_h
+      def authenticate(email:, password:)
+        Account.new post(url: "#{path}/authenticate.json", params: {
+          email: email,
+          password: password
+        })
+      end
+
+      # ap TophatterMerchant::Account.me.to_h
+      def me
+        Account.new get(url: "#{path}/me.json")
+      end
+
+      # ap TophatterMerchant::Account.create(first_name: 'Foo', last_name: 'Bar', store_name: 'Foo Bar, Inc', email: 'foo@bar.com', password: 'ipipip', country: 'United States', time_zone: 'Pacific Time (US & Canada)').to_h
+      def create(data)
+        Account.new post(url: "#{path}.json", params: data)
+      end
+
+      # Change first & last name:
+      # ap TophatterMerchant::Account.update(first_name: 'Mega', last_name: 'Tron').to_h
+      # Change password:
+      # ap TophatterMerchant::Account.update(password: 'qwer1234').to_h
+      # ap TophatterMerchant::Account.authenticate(email: 'megatron@autobot.com', password: 'qwer1234').to_h
+      # ap TophatterMerchant::Account.update(password: 'ipipip').to_h
+      def update(data)
+        Account.new post(url: "#{path}/update.json", params: data)
+      end
+
+      protected
+
+      def path
+        super + '/account'
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/api_key.rb

@@ -0,0 +1,45 @@
+module TophatterMerchant
+  class ApiKey < Resource
+
+    attr_accessor :id, :access_token, :created_at
+
+    class << self
+
+      # ap TophatterMerchant::ApiKey.schema
+      def schema
+        get(url: "#{path}/schema.json")
+      end
+
+      # ap TophatterMerchant::ApiKey.all.map(&:to_h)
+      def all
+        get(url: "#{path}.json").map do |hash|
+          ApiKey.new(hash)
+        end
+      end
+
+      # ap TophatterMerchant::ApiKey.retrieve(1).to_h
+      def retrieve(id)
+        ApiKey.new get(url: "#{path}/#{id}.json")
+      end
+
+      # ap TophatterMerchant::ApiKey.create.to_h
+      def create
+        ApiKey.new post(url: "#{path}.json")
+      end
+
+      # ap TophatterMerchant::ApiKey.destroy(TophatterMerchant::ApiKey.all.last.id).map(&:to_h)
+      def destroy(id)
+        delete(url: "#{path}/#{id}.json").map do |hash|
+          ApiKey.new(hash)
+        end
+      end
+
+      protected
+
+      def path
+        super + '/api_keys'
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/exceptions.rb

@@ -0,0 +1,8 @@
+module TophatterMerchant
+  class BaseException < StandardError; end
+  class BadContentTypeException < BaseException; end
+  class UnauthorizedException < BaseException; end
+  class BadRequestException < BaseException; end
+  class NotFoundException < BaseException; end
+  class ServerErrorException < BaseException; end
+end

data/lib/tophatter_merchant/image.rb

@@ -0,0 +1,24 @@
+module TophatterMerchant
+  class Image < Resource
+
+    attr_accessor :id, :fingerprint, :url
+
+    class << self
+
+      # request = RestClient::Request.new(method: :get, url: 'https://img0.etsystatic.com/101/0/7856452/il_fullxfull.882030160_r0tn.jpg')
+      # response = request.execute
+      # File.open('/tmp/foo.jpg', 'w') { |file| file.write(response.body) }
+      # ap TophatterMerchant::Image.create(File.open('/tmp/foo.jpg')).to_h
+      def create(file)
+        Image.new post(url: "#{path}.json", params: { data: file })
+      end
+
+      protected
+
+      def path
+        super + '/images'
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/metadata.rb

@@ -0,0 +1,76 @@
+module TophatterMerchant
+  class Metadata < Resource
+    class << self
+
+      # ap TophatterMerchant::Metadata.all
+      def all
+        get(url: "#{path}.json")
+      end
+
+      # ap TophatterMerchant::Metadata.conditions
+      def conditions
+        get(url: "#{path}/conditions.json")
+      end
+
+      # ap TophatterMerchant::Metadata.categories
+      def categories
+        get(url: "#{path}/categories.json")
+      end
+
+      # ap TophatterMerchant::Metadata.sizes
+      def sizes
+        get(url: "#{path}/sizes.json")
+      end
+
+      # ap TophatterMerchant::Metadata.countries
+      def countries
+        get(url: "#{path}/countries.json")
+      end
+
+      # ap TophatterMerchant::Metadata.country_codes
+      def country_codes
+        get(url: "#{path}/country_codes.json")
+      end
+
+      # ap TophatterMerchant::Metadata.states
+      def states
+        get(url: "#{path}/states.json")
+      end
+
+      # ap TophatterMerchant::Metadata.provinces
+      def provinces
+        get(url: "#{path}/provinces.json")
+      end
+
+      # ap TophatterMerchant::Metadata.territories
+      def territories
+        get(url: "#{path}/territories.json")
+      end
+
+      # ap TophatterMerchant::Metadata.carriers
+      def carriers
+        get(url: "#{path}/carriers.json")
+      end
+
+      # ap TophatterMerchant::Metadata.brands
+      def brands
+        get(url: "#{path}/brands.json")
+      end
+
+      def materials
+        get(url: "#{path}/materials.json")
+      end
+
+      def gemstones
+        get(url: "#{path}/gemstones.json")
+      end
+
+      protected
+
+      def path
+        super + '/metadata'
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/order.rb

@@ -0,0 +1,67 @@
+module TophatterMerchant
+  class Order < Resource
+
+    attr_accessor :order_id, :status
+    attr_accessor :carrier, :tracking_number
+    attr_accessor :product_name, :product_identifier, :variation_identifier
+    attr_accessor :customer_name, :address1, :address2, :city, :state, :postal_code, :country
+    attr_accessor :available_refunds, :refund_amount
+    attr_accessor :disbursement_amount, :seller_fees_amount, :seller_fees
+    attr_accessor :paid_at, :created_at
+
+    class << self
+
+      # ap TophatterMerchant::Order.schema
+      def schema
+        get(url: "#{path}/schema.json")
+      end
+
+      # ap TophatterMerchant::Order.all.map(&:to_h)
+      # ap TophatterMerchant::Order.all(filter: 'unfulfilled').map(&:to_h)
+      # ap TophatterMerchant::Order.all(filter: 'fulfilled').map(&:to_h)
+      def all(filter: nil, page: 1, per_page: 50)
+        get(url: "#{path}.json", params: { filter: filter, page: page, per_page: per_page }).map do |hash|
+          Order.new(hash)
+        end
+      end
+
+      # ap TophatterMerchant::Order.retrieve(681195262).to_h
+      def retrieve(id)
+        Order.new get(url: "#{path}/retrieve.json", params: {
+          order_id: id
+        })
+      end
+
+      # ap TophatterMerchant::Order.fulfill(417953232, carrier: 'other', tracking_number: 'ABC123').to_h
+      def fulfill(id, carrier:, tracking_number:)
+        Order.new post(url: "#{path}/fulfill.json", params: {
+          order_id: id,
+          carrier: carrier,
+          tracking_number: tracking_number
+        })
+      end
+
+      def unfulfill(id)
+        post(url: "#{path}/#{id}/unfulfill.json")
+      end
+
+      # ap TophatterMerchant::Order.refund(417953232, type: 'full', reason: 'delay_in_shipping').to_h
+      # ap TophatterMerchant::Order.refund(417953232, type: 'partial', reason: 'other', fees: ['shipping_fee']).to_h
+      def refund(id, type:, reason:, fees: [])
+        Order.new post(url: "#{path}/refund.json", params: {
+          order_id: id,
+          type: type,
+          reason: reason,
+          fees: fees
+        })
+      end
+
+      protected
+
+      def path
+        super + '/orders'
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/product.rb

@@ -0,0 +1,130 @@
+module TophatterMerchant
+  class Product < Resource
+
+    attr_accessor :identifier
+    attr_accessor :category, :title, :description # Basics
+    attr_accessor :condition, :brand, :material # Facets
+    attr_accessor :available_quantity, :variations # Variations
+    attr_accessor :starting_bid, :buy_now_price, :retail_price, :cost_basis, :minimum_alerts_needed # Pricing
+    attr_accessor :shipping_origin, :shipping_price, :expedited_shipping_price, :days_to_fulfill, :days_to_deliver, :expedited_days_to_deliver, :weight # Shipping
+    attr_accessor :buy_one_get_one_price, :accessory_price, :accessory_description # Upsells
+    attr_accessor :primary_image, :extra_images, :all_images # Images
+    attr_accessor :slug, :ratings_average, :ratings_count # Ratings
+    attr_accessor :created_at, :updated_at, :disabled_at, :deleted_at # Timestamps
+    attr_accessor :blacklisted_at, :admin_hold_at, :slug, :internal_id # Other
+
+    def id
+      created_at.present? ? identifier : nil
+    end
+
+    # Available: thumbnail, square, medium, large, original.
+    def images(size: 'square')
+      if persisted?
+        all_images.collect { |image| image[size] }
+      else
+        ([primary_image] + extra_images.to_s.split('|')).compact
+      end
+    end
+
+    def copy
+      attributes = to_h
+
+      # Delete the attributes that shouldn't be copied.
+      %w(identifier primary_image extra_images all_images ratings_average ratings_count created_at updated_at disabled_at deleted_at blacklisted_at slug admin_hold_at).each do |attribute|
+        attributes.delete(attribute)
+        attributes['variations'].each { |variation| variation.delete(attribute) }
+      end
+
+      Product.new(attributes)
+    end
+
+    def to_param
+      slug || identifier
+    end
+
+    class << self
+
+      # ap TophatterMerchant::Product.schema
+      def schema
+        get(url: "#{path}/schema.json")
+      end
+
+      def search(query:, page: 1, per_page: 50, pagination: nil)
+        result = get(url: "#{path}/search.json", params: {
+          query: query,
+          page: page,
+          per_page: per_page,
+          pagination: pagination
+        })
+
+        if pagination.present?
+          result['results'] = result['results'].map { |hash| Product.new(hash) }
+        else
+          result.map { |hash| Product.new(hash) }
+        end
+
+        result
+      end
+
+      # ap TophatterMerchant::Product.all.map(&:to_h)
+      def all(status: nil, category: nil, page: 1, per_page: 50, pagination: nil, sort: nil)
+        result = get(url: "#{path}.json", params: {
+          status: status,
+          category: category,
+          page: page,
+          per_page: per_page,
+          pagination: pagination,
+          sort: sort
+        })
+
+        if pagination.present?
+          result['results'] = result['results'].map { |hash| Product.new(hash) }
+        else
+          result = result.map { |hash| Product.new(hash) }
+        end
+
+        result
+      end
+
+      def retrieve(id)
+        Product.new get(url: "#{path}/retrieve.json", params: { identifier: id })
+      end
+
+      # ap TophatterMerchant::Product.create(TophatterMerchant::Product.new({}).fill!.to_h).to_h
+      def create(data)
+        Product.new post(url: "#{path}.json", params: data)
+      end
+
+      # ap TophatterMerchant::Product.update('FOOBAR', buy_now_price: 11).to_h
+      def update(id, data)
+        Product.new post(url: "#{path}/update.json", params: data.merge(identifier: id))
+      end
+
+      # ap TophatterMerchant::Product.delete('FOOBAR').to_h
+      def delete(id)
+        Product.new post(url: "#{path}/delete.json", params: { identifier: id })
+      end
+
+      # ap TophatterMerchant::Product.disable('FOOBAR').to_h
+      def disable(id)
+        Product.new post(url: "#{path}/disable.json", params: { identifier: id })
+      end
+
+      # ap TophatterMerchant::Product.enable('FOOBAR').to_h
+      def enable(id)
+        Product.new post(url: "#{path}/enable.json", params: { identifier: id })
+      end
+
+      def upload(file, template:)
+        Product.new post(url: "#{path}/upload.json", params: { file: file, template: template })
+      end
+
+      protected
+
+      def path
+        super + '/products'
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/resource.rb

@@ -0,0 +1,110 @@
+require 'active_model'
+
+module TophatterMerchant
+  class Resource
+
+    include ActiveModel::Model
+
+    def self.attr_accessor(*vars)
+      attributes!(*vars)
+      super(*vars)
+    end
+
+    def initialize(hash)
+      self.attributes = hash
+    end
+
+    def attributes=(hash)
+      hash.each do |key, value|
+        if respond_to?(key)
+          self.class.attributes!(key)
+          send("#{key}=", value)
+        end
+      end
+    end
+
+    def to_h
+      self.class.attributes.keys.collect { |key| [key, send(key)] }.to_h
+    end
+
+    def persisted?
+      id.present?
+    end
+
+    private
+
+    def self.attributes
+      @attributes || {}
+    end
+
+    def self.attributes!(*vars)
+      @attributes ||= {}
+      vars.map(&:to_s).each { |var| @attributes[var] = true }
+      @attributes
+    end
+
+    class << self
+
+      protected
+
+      def get(url:, params: {})
+        execute request(method: :get, url: url, params: params)
+      end
+
+      def post(url:, params: {})
+        execute request(method: :post, url: url, params: params)
+      end
+
+      def put(url:, params: {})
+        execute request(method: :put, url: url, params: params)
+      end
+
+      def delete(url:, params: {})
+        execute request(method: :delete, url: url, params: params)
+      end
+
+      def execute(request)
+        begin
+          puts "#{request.method.upcase} #{request.url} #{request.payload.inspect}"
+          response = request.execute
+          raise BadContentTypeException.new, "The server didn't return JSON. You probably made a bad request." if response.headers[:content_type] == 'text/html; charset=utf-8'
+          JSON.parse(response.body)
+        rescue RestClient::Request::Unauthorized => e
+          raise UnauthorizedException.new, parse_error(e, e.message)
+        rescue RestClient::BadRequest => e
+          raise BadRequestException.new, parse_error(e, e.message)
+        rescue RestClient::ResourceNotFound => e
+          raise NotFoundException.new, parse_error(e, 'The API path you requested does not exist.')
+        rescue RestClient::InternalServerError => e
+          raise ServerErrorException.new, parse_error(e, 'The server encountered an internal error. This is probably a bug, and you should contact support.')
+        end
+      end
+
+      def request(method:, url:, params:)
+        payload = if TophatterMerchant.access_token.present?
+          params.merge(access_token: TophatterMerchant.access_token)
+        else
+          params
+        end
+
+        RestClient::Request.new(method: method, url: url, payload: payload, accept: :json)
+      end
+
+      def path
+        TophatterMerchant.api_path
+      end
+
+      private
+
+      def parse_error(exception, fallback)
+        error = begin
+          JSON.parse(exception.response)
+        rescue
+          {}
+        end
+        raise BadRequestException.new, error['message'] || fallback
+      end
+
+    end
+  end
+end

data/lib/tophatter_merchant/variation.rb

@@ -0,0 +1,41 @@
+module TophatterMerchant
+  class Variation < Resource
+
+    attr_accessor :identifier, :size, :color, :quantity, :created_at
+
+    def id
+      created_at.present? ? identifier : nil
+    end
+
+    class << self
+
+      # ap TophatterMerchant::Variation.schema
+      def schema
+        get(url: "#{path}/schema.json")
+      end
+
+      # ap TophatterMerchant::Variation.retrieve('FOOBAR-R').to_h
+      def retrieve(identifier)
+        Variation.new get(url: "#{path}/retrieve.json", params: { identifier: identifier })
+      end
+
+      # ap Variation.create(product_identifier: '6631A', identifier: '6631A-GRAY', color: 'Gray', quantity: 33).to_h
+      def create(params)
+        Variation.new post(url: "#{path}.json", params: params)
+      end
+
+      # ap TophatterMerchant::Variation.update('FOOBAR-R', quantity: 100).to_h
+      def update(identifier, data)
+        Variation.new post(url: "#{path}/update.json", params: data.merge(identifier: identifier))
+      end
+
+      protected
+
+      def path
+        super + '/variations'
+      end
+
+    end
+
+  end
+end

data/lib/tophatter_merchant/version.rb

@@ -0,0 +1,3 @@
+module TophatterMerchant
+  VERSION = '1.0'
+end

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+require 'rest-client'
+require 'tophatter_merchant'
+require 'webmock/rspec'
+
+WebMock.disable_net_connect!(allow_localhost: true)
+
+# http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.before(:each) do
+    stub_request(:get, /.*metadata\.json/).to_return(File.new(File.dirname(__FILE__) + '/../tmp/stubs/metadata.json'))
+    stub_request(:get, /.*conditions\.json/).to_return(File.new(File.dirname(__FILE__) + '/../tmp/stubs/metadata/conditions.json'))
+    stub_request(:get, /.*gemstones\.json/).to_return(File.new(File.dirname(__FILE__) + '/../tmp/stubs/metadata/gemstones.json'))
+  end
+
+end

data/spec/tophatter_merchant/metadata_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+# rspec spec/tophatter_merchant/metadata_spec.rb
+describe TophatterMerchant::Metadata do
+
+  it 'returns metadata' do
+    metadata = TophatterMerchant::Metadata.all
+    expect(metadata.keys.include?('categories')).to be true
+    expect(metadata.keys.include?('conditions')).to be true
+    expect(metadata.keys.include?('sizes')).to be true
+    expect(metadata.keys.include?('colors')).to be true
+    expect(metadata.keys.include?('countries')).to be true
+    expect(metadata.keys.include?('states')).to be true
+    expect(metadata.keys.include?('provinces')).to be true
+    expect(metadata.keys.include?('territories')).to be true
+    expect(metadata.keys.include?('carriers')).to be true
+    expect(metadata.keys.include?('brands')).to be true
+    expect(metadata.keys.include?('materials')).to be true
+    expect(metadata.keys.include?('gemstones')).to be true
+  end
+
+  it 'returns conditions' do
+    conditions = TophatterMerchant::Metadata.conditions
+    expect(conditions.include?('New')).to be true
+    expect(conditions.include?('New with Tags')).to be true
+    expect(conditions.include?('New with Defects')).to be true
+    expect(conditions.include?('Used')).to be true
+    expect(conditions.include?('Refurbished')).to be true
+  end
+
+  it 'returns gemstones' do
+    gemstones = TophatterMerchant::Metadata.gemstones
+    expect(gemstones['Gemstones'].include?('Diamond')).to be true
+    expect(gemstones['Gemstones'].include?('Ruby')).to be true
+    expect(gemstones['Gemstones'].include?("Micheal Jackson's Hair Diamond")).to be false
+  end
+
+end

data/spec/tophatter_merchant/product_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+# rspec spec/tophatter_merchant/product_spec.rb
+describe TophatterMerchant::Product do
+
+  it 'instantiates' do
+    product = TophatterMerchant::Product.new({})
+    expect(product.persisted?).to be false
+  end
+
+end

data/tmp/stubs/metadata.json

@@ -0,0 +1,12 @@
+HTTP/1.1 200 OK
+X-Frame-Options: SAMEORIGIN
+X-XSS-Protection: 1; mode=block
+X-Content-Type-Options: nosniff
+Content-Type: application/json; charset=utf-8
+ETag: W/"45b19639776dd1683511d9f9d258665d"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: 75fb5e61-0b1a-480d-b9c0-1708968dd02a
+X-Runtime: 0.103416
+Transfer-Encoding: chunked
+
+{"categories":["Accessories | Bags | Clutches & Evening Bags","Accessories | Bags | Crossbody","Accessories | Bags | Satchels","Accessories | Bags | Shoulder Bags & Hobos","Accessories | Bags | Totes & Backpacks","Accessories | Bags | Weekenders & Duffles","Accessories | Bags | Other","Accessories | Sunglasses","Accessories | Watches","Accessories | Wallets","Accessories | Wristlets","Accessories | Other Accessories | Scarves","Accessories | Other Accessories | Keychains","Accessories | Other Accessories | Hats","Accessories | Other Accessories | Hair Accessories","Accessories | Other Accessories | Electronic Accessories","Accessories | Other Accessories | Belts","Accessories | Other Accessories | Ties","Accessories | Other Accessories | Tights/Socks","Accessories | Other Accessories | Other","Apparel | Intimates | Bras","Apparel | Intimates | Underwear","Apparel | Intimates | Shapewear","Apparel | Intimates | Other","Apparel | Tops | T-Shirts","Apparel | Tops | Blouses","Apparel | Tops | Shirts","Apparel | Tops | Sweaters","Apparel | Tops | Sweatshirts","Apparel | Tops | Vests","Apparel | Tops | Tanks","Apparel | Tops | Other","Apparel | Jackets/Outerwear | Jackets","Apparel | Jackets/Outerwear | Coats","Apparel | Jackets/Outerwear | Other","Apparel | Bottoms | Shorts","Apparel | Bottoms | Skirts","Apparel | Bottoms | Pants","Apparel | Bottoms | Leggings","Apparel | Bottoms | Other","Apparel | Dresses","Apparel | Sports & Fitness","Apparel | Swim | Tops","Apparel | Swim | Bottoms","Apparel | Swim | One-pieces","Apparel | Swim | Sets (Top & Bottom)","Apparel | Swim | Coverups","Apparel | Other","Beauty | Skincare | Cleansers","Beauty | Skincare | Moisturizer","Beauty | Skincare | Other","Beauty | Haircare | Shampoo","Beauty | Haircare | Conditioner","Beauty | Haircare | Styling Tools","Beauty | Haircare | Other","Beauty | Hair Tools | Flat Iron","Beauty | Hair Tools | Blow Dryer","Beauty | Hair Tools | Curling Iron","Beauty | Hair Tools | Brushes","Beauty | Hair Tools | Other","Beauty | Fragrance","Beauty | Makeup (Cosmetics) | Lip","Beauty | Makeup (Cosmetics) | Eye","Beauty | Makeup (Cosmetics) | Face","Beauty | Makeup (Cosmetics) | Cheek","Beauty | Makeup (Cosmetics) | Other","Beauty | Nails | Nail Polish","Beauty | Nails | Nail Art","Beauty | Nails | Manicure Set","Beauty | Nails | Nail Tools & Files","Beauty | Nails | Other","Beauty | Brushes | Face","Beauty | Brushes | Eyes","Beauty | Brushes | Lip","Beauty | Brushes | Sets","Beauty | Brushes | Other","Beauty | Bath & Body","Beauty | Other","Collectibles | Memorabilia","Collectibles | Coins","Collectibles | Other","Edibles | Healthy","Edibles | Desserts","Edibles | Gourmet","Edibles | Non Alcoholic Beverages","Edibles | Other","Electronics | Audio | Headphones","Electronics | Audio | Home Theater Systems","Electronics | Audio | Turntables","Electronics | Audio | MP3 Players","Electronics | Audio | Shelf Systems","Electronics | Audio | Speakers","Electronics | Audio | Other","Electronics | Hardware (Computers/Tablets/Phones) | TV","Electronics | Hardware (Computers/Tablets/Phones) | Audio","Electronics | Hardware (Computers/Tablets/Phones) | Mobile","Electronics | Hardware (Computers/Tablets/Phones) | Video","Electronics | Hardware (Computers/Tablets/Phones) | Computers/Tablets","Electronics | Hardware (Computers/Tablets/Phones) | Printers","Electronics | Hardware (Computers/Tablets/Phones) | Other","Electronics | TV & Projectors","Electronics | Photography/Camera","Electronics | Gaming","Electronics | Accessories","Electronics | Other","Home | Bed | Pillows","Home | Bed | Sheets","Home | Bed | Comforter/Duvet","Home | Bed | Throw","Home | Bed | Other","Home | Bath | Towels","Home | Bath | Other","Home | Kitchen & Dining | Dinnerware","Home | Kitchen & Dining | Flatware","Home | Kitchen & Dining | Serveware","Home | Kitchen & Dining | Bar & Glassware","Home | Kitchen & Dining | Linens","Home | Kitchen & Dining | Other","Home | Lighting","Home | Furniture","Home | Storage & Organization","Home | Electrics & Appliances | Kitchen","Home | Electrics & Appliances | Cleaning","Home | Electrics & Appliances | Other","Home | Decor | Art","Home | Decor | Wall Decor & Mirrors","Home | Decor | Vases","Home | Decor | Other","Home | Outdoor | Tool","Home | Outdoor | Seeds","Home | Outdoor | Outdoor Furniture","Home | Outdoor | Outdoor Accessories","Home | Outdoor | Other","Home | Pet Supplies","Home | Other","Jewelry | Rings","Jewelry | Necklaces","Jewelry | Bracelets","Jewelry | Earrings","Jewelry | Other","Jewelry | Sets","Kids | Baby Apparel | Jackets/Outerwear","Kids | Baby Apparel | Tops","Kids | Baby Apparel | Bottoms","Kids | Baby Apparel | Dresses","Kids | Baby Apparel | Onesies","Kids | Baby Apparel | Pajamas","Kids | Baby Apparel | Sets","Kids | Baby Apparel | Other","Kids | Toddler Apparel | Jackets/Outerwear","Kids | Toddler Apparel | Tops","Kids | Toddler Apparel | Bottoms","Kids | Toddler Apparel | Dresses","Kids | Toddler Apparel | Onesies","Kids | Toddler Apparel | Pajamas","Kids | Toddler Apparel | Sets","Kids | Toddler Apparel | Other","Kids | Kids/Youth Apparel | Jackets/Outerwear","Kids | Kids/Youth Apparel | Tops","Kids | Kids/Youth Apparel | Bottoms","Kids | Kids/Youth Apparel | Dresses","Kids | Kids/Youth Apparel | Onesies","Kids | Kids/Youth Apparel | Pajamas","Kids | Kids/Youth Apparel | Sets","Kids | Kids/Youth Apparel | Other","Kids | Baby Shoes | Boots","Kids | Baby Shoes | Sneakers","Kids | Baby Shoes | Sandals","Kids | Baby Shoes | Booties","Kids | Baby Shoes | Other","Kids | Toddler Shoes | Boots","Kids | Toddler Shoes | Sneakers","Kids | Toddler Shoes | Sandals","Kids | Toddler Shoes | Booties","Kids | Toddler Shoes | Other","Kids | Kids/Youth Shoes | Boots","Kids | Kids/Youth Shoes | Sneakers","Kids | Kids/Youth Shoes | Sandals","Kids | Kids/Youth Shoes | Booties","Kids | Kids/Youth Shoes | Other","Kids | Games & Toys","Shoes | Flats","Shoes | Heels","Shoes | Boots","Shoes | Sneakers","Shoes | Sandals","Shoes | Wedges","Shoes | Other","Supplies | Jewelry Supplies | Beads","Supplies | Jewelry Supplies | Charms","Supplies | Jewelry Supplies | Pins","Supplies | Jewelry Supplies | Gemstones","Supplies | Jewelry Supplies | Accessories","Supplies | Jewelry Supplies | Tools","Supplies | Jewelry Supplies | Findings","Supplies | Jewelry Supplies | Other","Supplies | Craft Supplies | Kits","Supplies | Craft Supplies | Fabric","Supplies | Craft Supplies | Accessories","Supplies | Craft Supplies | Tools","Supplies | Craft Supplies | Other","Supplies | Other","Other | Other"],"conditions":["New","New with Tags","New with Defects","Used - Excellent","Used - Good","Used - Fair","Refurbished - Manufacturer","Refurbished - Seller"],"sizes":{"Accessories":["Small","Medium","Large","Extra Large"],"Apparel":["XS","S","M","L","XL","XXL","XXXL","1x","2x","3x","4x","0","2","4","6","8","10","12","14","16","18","20","22","24","26","28","30"],"Beauty":["Full","Travel","Deluxe Sample","Sample","Tester","Palette","Set","Mini"],"Shoes":["5","5.5","6","6.5","7","7.5","8","8.5","9","9.5","10","10.5","11","11.5","12"],"Rings":["4","4.5","5","5.5","6","6.5","7","7.5","8","8.5","9","9.5","10","10.5","11","11.5","12","12.5","13","13.5","14"],"Necklaces":["Extra Short (<16\")","Short (16\"-20\")","Medium (20\"-24\")","Long (24\"-28\")","Extra Long(28\"+)"],"Baby Apparel":["Preemie (P)","Newborn (NB)","0/3","3M","3/6","6M","6/9","9M","12M","18M","24M"],"Toddler Apparel":["2T","3T","4T","5T"],"Kids/Youth Apparel":["4","5","6","6X","7","8","10","12","14","16","18","XS","S","M","L","XL"],"Baby Shoes":["0","0.5","1","1.5","2","2.5","3","3.5","4","4.5","5","5.5","6","6.5","7"],"Toddler Shoes":["7.5","8","8.5","9","9.5","10","10.5","11","11.5","12"],"Kids/Youth Shoes":["12.5","13","13.5","1Y","1.5Y","2Y","2.5Y","3Y","3.5Y","4Y","4.5Y","5Y","5.5Y","6Y","6.5Y","7Y"]},"colors":["Red","Orange","Yellow","Green","Blue","Purple","Black","White","Gray","Pink","Brown","Silver","Gold","Clear"],"countries":["United States","Canada","India","China","Hong Kong","Afghanistan","Aland Islands","Albania","Algeria","American Samoa","Andorra","Angola","Anguilla","Antarctica","Antigua and Barbuda","Argentina","Armenia","Aruba","Australia","Austria","Azerbaijan","Bahamas","Bahrain","Bangladesh","Barbados","Belarus","Belgium","Belize","Benin","Bermuda","Bhutan","Bolivia","Bonaire, Sint Eustatius and Saba","Bosnia and Herzegovina","Botswana","Bouvet Island","Brazil","British Indian Ocean Territory","Brunei Darussalam","Bulgaria","Burkina Faso","Burundi","Cambodia","Cameroon","Cape Verde","Cayman Islands","Central African Republic","Chad","Chile","Christmas Island","Cocos (Keeling) Islands","Colombia","Comoros","Congo","Congo, The Democratic Republic Of The","Cook Islands","Costa Rica","Croatia","Cuba","Curaçao","Cyprus","Czech Republic","Côte D'Ivoire","Denmark","Djibouti","Dominica","Dominican Republic","Ecuador","Egypt","El Salvador","Equatorial Guinea","Eritrea","Estonia","Ethiopia","Falkland Islands (Malvinas)","Faroe Islands","Fiji","Finland","France","French Guiana","French Polynesia","French Southern Territories","Gabon","Gambia","Georgia","Germany","Ghana","Gibraltar","Greece","Greenland","Grenada","Guadeloupe","Guam","Guatemala","Guernsey","Guinea","Guinea-Bissau","Guyana","Haiti","Heard and McDonald Islands","Holy See (Vatican City State)","Honduras","Hungary","Iceland","Indonesia","Iran, Islamic Republic Of","Iraq","Ireland","Isle of Man","Israel","Italy","Jamaica","Japan","Jersey","Jordan","Kazakhstan","Kenya","Kiribati","Korea, Democratic People's Republic Of","Korea, Republic of","Kuwait","Kyrgyzstan","Lao People's Democratic Republic","Latvia","Lebanon","Lesotho","Liberia","Libya","Liechtenstein","Lithuania","Luxembourg","Macao","Macedonia, the Former Yugoslav Republic Of","Madagascar","Malawi","Malaysia","Maldives","Mali","Malta","Marshall Islands","Martinique","Mauritania","Mauritius","Mayotte","Mexico","Micronesia, Federated States Of","Moldova, Republic of","Monaco","Mongolia","Montenegro","Montserrat","Morocco","Mozambique","Myanmar","Namibia","Nauru","Nepal","Netherlands","Netherlands Antilles","New Caledonia","New Zealand","Nicaragua","Niger","Nigeria","Niue","Norfolk Island","Northern Mariana Islands","Norway","Oman","Pakistan","Palau","Palestinian Territory, Occupied","Panama","Papua New Guinea","Paraguay","Peru","Philippines","Pitcairn","Poland","Portugal","Puerto Rico","Qatar","Romania","Russian Federation","Rwanda","Réunion","Saint Barthélemy","Saint Helena","Saint Kitts And Nevis","Saint Lucia","Saint Martin","Saint Pierre And Miquelon","Saint Vincent And The Grenedines","Samoa","San Marino","Sao Tome and Principe","Saudi Arabia","Senegal","Serbia","Seychelles","Sierra Leone","Singapore","Sint Maarten","Slovakia","Slovenia","Solomon Islands","Somalia","South Africa","South Georgia and the South Sandwich Islands","South Sudan","Spain","Sri Lanka","Sudan","Suriname","Svalbard And Jan Mayen","Swaziland","Sweden","Switzerland","Syrian Arab Republic","Taiwan, Republic Of China","Tajikistan","Tanzania, United Republic of","Thailand","Timor-Leste","Togo","Tokelau","Tonga","Trinidad and Tobago","Tunisia","Turkey","Turkmenistan","Turks and Caicos Islands","Tuvalu","Uganda","Ukraine","United Arab Emirates","United Kingdom","United States Minor Outlying Islands","Uruguay","Uzbekistan","Vanuatu","Venezuela, Bolivarian Republic of","Vietnam","Virgin Islands, British","Virgin Islands, U.S.","Wallis and Futuna","Western Sahara","Yemen","Zambia","Zimbabwe"],"country_codes":{"United States":"USA","Canada":"CAN","India":"IND","China":"CHN","Hong Kong":"HKG","Andorra":"AND","United Arab Emirates":"ARE","Afghanistan":"AFG","Antigua and Barbuda":"ATG","Anguilla":"AIA","Albania":"ALB","Armenia":"ARM","Netherlands Antilles":"ANT","Angola":"AGO","Antarctica":"ATA","Argentina":"ARG","American Samoa":"ASM","Austria":"AUT","Australia":"AUS","Aruba":"ABW","Aland Islands":"ALA","Azerbaijan":"AZE","Bosnia and Herzegovina":"BIH","Barbados":"BRB","Bangladesh":"BGD","Belgium":"BEL","Burkina Faso":"BFA","Bulgaria":"BGR","Bahrain":"BHR","Burundi":"BDI","Benin":"BEN","Saint Barthélemy":"BLM","Bermuda":"BMU","Brunei Darussalam":"BRN","Bolivia":"BOL","Bonaire, Sint Eustatius and Saba":"BES","Brazil":"BRA","Bahamas":"BHS","Bhutan":"BTN","Bouvet Island":"BVT","Botswana":"BWA","Belarus":"BLR","Belize":"BLZ","Cocos (Keeling) Islands":"CCK","Congo, The Democratic Republic Of The":"COD","Central African Republic":"CAF","Congo":"COG","Switzerland":"CHE","Côte D'Ivoire":"CIV","Cook Islands":"COK","Chile":"CHL","Cameroon":"CMR","Colombia":"COL","Costa Rica":"CRI","Cuba":"CUB","Cape Verde":"CPV","Curaçao":"CUW","Christmas Island":"CXR","Cyprus":"CYP","Czech Republic":"CZE","Germany":"DEU","Djibouti":"DJI","Denmark":"DNK","Dominica":"DMA","Dominican Republic":"DOM","Algeria":"DZA","Ecuador":"ECU","Estonia":"EST","Egypt":"EGY","Western Sahara":"ESH","Eritrea":"ERI","Spain":"ESP","Ethiopia":"ETH","Finland":"FIN","Fiji":"FJI","Falkland Islands (Malvinas)":"FLK","Micronesia, Federated States Of":"FSM","Faroe Islands":"FRO","France":"FRA","Gabon":"GAB","Grenada":"GRD","Georgia":"GEO","French Guiana":"GUF","Guernsey":"GGY","Ghana":"GHA","Gibraltar":"GIB","Greenland":"GRL","Gambia":"GMB","Guinea":"GIN","Guadeloupe":"GLP","Equatorial Guinea":"GNQ","Greece":"GRC","South Georgia and the South Sandwich Islands":"SGS","Guatemala":"GTM","Guam":"GUM","Guinea-Bissau":"GNB","Guyana":"GUY","Heard and McDonald Islands":"HMD","Honduras":"HND","Croatia":"HRV","Haiti":"HTI","Hungary":"HUN","Indonesia":"IDN","Ireland":"IRL","Israel":"ISR","Isle of Man":"IMN","British Indian Ocean Territory":"IOT","Iraq":"IRQ","Iran, Islamic Republic Of":"IRN","Iceland":"ISL","Italy":"ITA","Jersey":"JEY","Jamaica":"JAM","Jordan":"JOR","Japan":"JPN","Kenya":"KEN","Kyrgyzstan":"KGZ","Cambodia":"KHM","Kiribati":"KIR","Comoros":"COM","Saint Kitts And Nevis":"KNA","Korea, Democratic People's Republic Of":"PRK","Korea, Republic of":"KOR","Kuwait":"KWT","Cayman Islands":"CYM","Kazakhstan":"KAZ","Lao People's Democratic Republic":"LAO","Lebanon":"LBN","Saint Lucia":"LCA","Liechtenstein":"LIE","Sri Lanka":"LKA","Liberia":"LBR","Lesotho":"LSO","Lithuania":"LTU","Luxembourg":"LUX","Latvia":"LVA","Libya":"LBY","Morocco":"MAR","Monaco":"MCO","Moldova, Republic of":"MDA","Montenegro":"MNE","Saint Martin":"MAF","Madagascar":"MDG","Marshall Islands":"MHL","Macedonia, the Former Yugoslav Republic Of":"MKD","Mali":"MLI","Myanmar":"MMR","Mongolia":"MNG","Macao":"MAC","Northern Mariana Islands":"MNP","Martinique":"MTQ","Mauritania":"MRT","Montserrat":"MSR","Malta":"MLT","Mauritius":"MUS","Maldives":"MDV","Malawi":"MWI","Mexico":"MEX","Malaysia":"MYS","Mozambique":"MOZ","Namibia":"NAM","New Caledonia":"NCL","Niger":"NER","Norfolk Island":"NFK","Nigeria":"NGA","Nicaragua":"NIC","Netherlands":"NLD","Norway":"NOR","Nepal":"NPL","Nauru":"NRU","Niue":"NIU","New Zealand":"NZL","Oman":"OMN","Panama":"PAN","Peru":"PER","French Polynesia":"PYF","Papua New Guinea":"PNG","Philippines":"PHL","Pakistan":"PAK","Poland":"POL","Saint Pierre And Miquelon":"SPM","Pitcairn":"PCN","Puerto Rico":"PRI","Palestinian Territory, Occupied":"PSE","Portugal":"PRT","Palau":"PLW","Paraguay":"PRY","Qatar":"QAT","Réunion":"REU","Romania":"ROU","Serbia":"SRB","Russian Federation":"RUS","Rwanda":"RWA","Saudi Arabia":"SAU","Solomon Islands":"SLB","Seychelles":"SYC","Sudan":"SDN","Sweden":"SWE","Singapore":"SGP","Saint Helena":"SHN","Slovenia":"SVN","Svalbard And Jan Mayen":"SJM","Slovakia":"SVK","Sierra Leone":"SLE","San Marino":"SMR","Senegal":"SEN","Somalia":"SOM","Suriname":"SUR","South Sudan":"SSD","Sao Tome and Principe":"STP","El Salvador":"SLV","Sint Maarten":"SXM","Syrian Arab Republic":"SYR","Swaziland":"SWZ","Turks and Caicos Islands":"TCA","Chad":"TCD","French Southern Territories":"ATF","Togo":"TGO","Thailand":"THA","Tajikistan":"TJK","Tokelau":"TKL","Timor-Leste":"TLS","Turkmenistan":"TKM","Tunisia":"TUN","Tonga":"TON","Turkey":"TUR","Trinidad and Tobago":"TTO","Tuvalu":"TUV","Taiwan, Republic Of China":"TWN","Tanzania, United Republic of":"TZA","Ukraine":"UKR","Uganda":"UGA","United Kingdom":"GBR","United States Minor Outlying Islands":"UMI","Uruguay":"URY","Uzbekistan":"UZB","Holy See (Vatican City State)":"VAT","Saint Vincent And The Grenedines":"VCT","Venezuela, Bolivarian Republic of":"VEN","Virgin Islands, British":"VGB","Virgin Islands, U.S.":"VIR","Vietnam":"VNM","Vanuatu":"VUT","Wallis and Futuna":"WLF","Samoa":"WSM","Yemen":"YEM","Mayotte":"MYT","South Africa":"ZAF","Zambia":"ZMB","Zimbabwe":"ZWE"},"states":{"Alaska":"AK","Alabama":"AL","Arkansas":"AR","American Samoa":"AS","Arizona":"AZ","California":"CA","Colorado":"CO","Connecticut":"CT","District of Columbia":"DC","Delaware":"DE","Florida":"FL","Georgia":"GA","Guam":"GU","Hawaii":"HI","Iowa":"IA","Idaho":"ID","Illinois":"IL","Indiana":"IN","Kansas":"KS","Kentucky":"KY","Louisiana":"LA","Massachusetts":"MA","Maryland":"MD","Maine":"ME","Michigan":"MI","Minnesota":"MN","Missouri":"MO","Northern Mariana Islands":"MP","Mississippi":"MS","Montana":"MT","North Carolina":"NC","North Dakota":"ND","Nebraska":"NE","New Hampshire":"NH","New Jersey":"NJ","New Mexico":"NM","Nevada":"NV","New York":"NY","Ohio":"OH","Oklahoma":"OK","Oregon":"OR","Pennsylvania":"PA","Puerto Rico":"PR","Rhode Island":"RI","South Carolina":"SC","South Dakota":"SD","Tennessee":"TN","Texas":"TX","United States Minor Outlying Islands":"UM","Utah":"UT","Virginia":"VA","Virgin Islands":"VI","Vermont":"VT","Washington":"WA","Wisconsin":"WI","West Virginia":"WV","Wyoming":"WY","Armed Forces Americas (except Canada)":"AA","Armed Forces Africa, Canada, Europe, Middle East":"AE","Armed Forces Pacific":"AP"},"provinces":{"Alberta":"AB","British Columbia":"BC","Manitoba":"MB","New Brunswick":"NB","Newfoundland and Labrador":"NL","Nova Scotia":"NS","Northwest Territories":"NT","Nunavut":"NU","Ontario":"ON","Prince Edward Island":"PE","Quebec":"QC","Saskatchewan":"SK","Yukon Territory":"YT"},"territories":{"Australian Capital Territory":"ACT","New South Wales":"NSW","Northern Territory":"NT","Queensland":"QLD","South Australia":"SA","Tasmania":"TAS","Victoria":"VIC","Western Australia":"WA"},"carriers":{"USPS":"usps","FedEx":"fedex","Canada Post":"canada-post","UPS":"ups","UPS Mail Innovations":"ups-mi","DHL":"dhl","DHL Global Mail":"dhl-global-mail","OnTrac":"ontrac","China Post":"china-post","China EMS":"china-ems","Yanwen":"yanwen","India Post":"india-post","Asendia USA":"asendia-usa","Hong Kong Post":"hong-kong-post","DHL Hong Kong":"dhl-hk","Japan Post":"japan-post","Taiwan Post":"taiwan-post","Singapore Post":"singapore-post","DHL Global Mail Asia":"dhl-global-mail-asia","EMPS Express":"empsexpess","German Post DHL":"dhl-germany","Russian Post":"russian-post","Malaysia Post EMS / Poslaju":"malaysia-post","Thailand Thai Post":"thailand-post","Vietnam Post":"vnpost","Cambodia Post":"cambodia-post","Netherlands Post":"postnl","Turkey Post":"ptt-posta","Yun Express":"yunexpress","German Post":"deutsch-post","Irish Post":"an-post","Ukraine Post":"ukrposhta","Lasership":"lasership","Korea Post":"korea-post","DHL Global Forwarding":"dhl-global-forwarding","Other":"other"},"brands":{"Accessories":["7 For All Mankind","AX Paris","Adidas","Adrienne Vittadini","Aeropostale","Ann Taylor","Anne Klein","Anne Michelle","Apt. 9","Armani","Ash","B Makowsky","BCBG","Baby phat","Bally","Bally White","Banana Republic","Bebe","Betsey Johnson","Bindya","Bottega Veneta","Brahmin","Brandy Melville","Brighton","Burberry","Burgi","Calvin Klein","Carlos Falchi","Carrera","Cartier","Celine","Chanel","Chico's","Chloe","Christian Dior","Coach","Cole Haan","Converse","Courrèges","DKNY","Diesel","Dior","Dockers","Dolce & Gabbana","Donna Karan","Dooney & Bourke","Ecko","Ed Hardy","Elie Tahari","Elizabeth Arden","Elle","Ellen Tracy","Emanuel Ungaro","Emilio Pucci","Escada","Etienne Aigner","Etro","Etro Milano","Expressions NYC","Fantas-Eyes","Fendi","Ferrari","Fila","Fossil","Francesco Biasia","Franco Sarto","French Connection","Frye","Furla","Giorgio Armani","Gucci","Guess","Harley Davidson","Invicta","Isabella Fiore","J.Crew","Jessica Simpson","Jimmy Choo","Joan & David","Juicy Couture","Karl Lagerfeld","Kate Spade","Kathy Van Zeeland","Kay Unger","Kenneth Cole","Kenzo","Kipling","Lacoste","Lambertson Truex","Lancel","Lands' End","Larry Levine","LeSportsac","Liz Claiborne","London Fog","Longchamp","Louis Vuitton","Lucky Brand","Lululemon","Marc Jacobs","Mario Valentino","Matt & Nat","Michael Kors","Michael by Michael Kors","Miu Miu","Moschino","Nicole Miller","Nike","Nina Ricci","Nine West","NorthFace","Olivia + Joy","Oscar De La Renta","Patricia Nash","Paul Smith","Pinky & Dianne","Prada","RAY-BAN","Ralph Lauren","Rebecca Minkoff","Rena Lange","Roberto Cavalli","Rock & Republic","Rootote","Saks Fifth Avenue","Salvatore Ferragamo","Sam Edelman","Samantha Savasa","Sergio Rossi","Skagen","Sonia Rykiel","Sonoma","Steve Madden","Style & Co.","Susan Gail","Talbots","Ted Baker","Timberland","Tod's","Tommy Hilfiger","Tory Burch","Travelon","UGG","Valentino","Vans","Vera Bradley","Vera Wang","Versace","Versace Collection","Victoria's Secret","Vince Camuto"],"Beauty":["Adidas","Amazing Cosmetics","Amor","Amouage","Anastasia","Anne Klein","Aquolina","Aramis","Ariana Grande","Armani","Azzaro","Bahama","Bare Escentuals","Bebe","Ben Nye","Benefit","Beyonce","Billion Dollar Brow","Bobbi Brown","Boucheron","Britney Spears","Bumble and Bumble","Burberry","Bvlgari","CURVE","Cacharel","Calvin Klein","Cargo","Carolina Herrera","Cartier","Chanel","Chloe","Christian Audigier","Christian Dior","Clarisonic","Clinique","Coach","Coco Chanel","Coquillete","Creed","D&G","Davidoff","Diesel","Dior","Dolce & Gabbana","Donna Karan","Ed Hardy","Elizabeth Arden","Elizabeth Taylor","Escada","Essie","Estee Lauder","Ferrari","Fresh","Geir Ness","Giorgio Armani","Givenchy","Gucci","Guerlain","Guess","Gwen Stefani","Hampton Sun","Hourglass","Hugo Boss","Hydroxatone","Infinique","Isaac Mizrahi","Iso","Issey Miyake","Jean Paul","Jennifer Lopez","Jessica Simpson","Jesus Del Pozo","Jimmy Choo","John Varvatos","Joop","Juicy Couture","Justin Bieber","Kat Von D","Katy Perry","Kenneth Cole","Kim Kardashian","Korres","LORAC","Lacoste","Lady Gaga","Lalique","Laura Geller","Laura Mercier","LiLash","Lime Crime","Liz Claiborne","Lolita Lempicka","Loreal","Loris Azzaro","Lucky","MAC","Makeup Forever","Marc Jacobs","Mary Kay","Michael Jordan","Michael Kors","Michel Germain","NARS Cosmetics","NAUTICA","Narciso Rodriguez","Neiman Marcus","Obsessive Compulsive Cosmetics","Oscar de la Renta","Pacifica","Paco Rabanne","Penhaligon's Blenheim Bouquet","Perry Ellis","Philosophy","Pop Beauty","Ralph Lauren","Revlon","Rihanna","Roberto Cavalli","Saks Fifth Avenue","Sephora","Shiseido","Smashbox","Stella McCartney","Stila","StriVectin","Studio Gear","Tarte","Taylor Swift","The Balm","Thierry Mugler","TokyoMilk","Tommy Hilfiger","Too Faced","True Religion","Ulta","Urban Decay","Usher","Vera Wang","Versace","Victoria's Secret","Viktor & Rolf","Vince Camuto","Yves Saint Laurent","bareMinerals"],"Electronics":["Acer","Alcatel","Amazon","Apple","Asus","Barnes & Noble","Beats By Dre","Belkin","Bose","Canon","Chromo Inc","Dell","Dyson","Fujifilm","GE","Google","Griffin","HDE","HP","Harman Kardon ","Husky","Incipio","Insignia","JBL","Koramzi","LG","Lenovo","Logitech","Microsoft","Nextbook","Nikon","Nokia","NutriBullet","Olympia","Olympus","Panasonic ","Philips","Polaroid ","RCA","Samsung","SanDisk","Solo","Sony","Toshiba","Vizio ","iRulu"],"Home":["Bodum","Breville","Calphalon","CorningWare","Cuisinart","Delonghi","Dyson","Eureka","Hamilton Beach","KitchenAid","Krups","PUR","Proctor Silex","Pyrex","Simplehuman","Sodastream","T-fal","Waring Pro","Weber","West Bend","oxo"]},"materials":{"Jewelry":["Multi-Tone Gold","Palladium","Platinum","Platinum Plated","Rhodium","Rhodium Plated","Rose Gold","Rose Gold Filled","Rose Gold Plated","Silver Plated","Sterling Silver","Titanium","Titanium Plated","Tungsten","White Gold","White Gold Filled","White Gold Plated","Yellow Gold","Yellow Gold Filled","Yellow Gold Plated","Stainless Steel","Alloy Metal","Other"]},"gemstones":{"Gemstones":["Agate","Alexandrite","Amazonite","Amber","Amethyst","Ametrine","Ammolite","Andalusite","Apatite","Aquamarine","Aventurine","Azotic Topaz","Beryl","Bloodstone","Calcite","Carnelian","Cat's Eye","Chalcedony","Charoite","Chrysocolla","Chrysoprase","Citrine","Coral","Cubic Zirconia","Diamond","Emerald","Fire Opal","Fluorite","Fossil Coral","Garnet","Gaspeite","Goldstone","Goshenite","Hematite","Howlite","Imperial Topaz","Iolite","Jadeite","Jasper","Kunzite","Kyanite","Labradorite","Labradorite","Lapis Lazuli","Larimar","Lepidolite","Malachite","Moonstone","Morganite","Mystic Quartz","Mystic Topaz","Obsidian","Onyx","Opal","Opal","Opal Doublet","Pearl","Peridot","Pietersite","Prehnite","Quartz","Rainbow Moonstone","Rainbow Pyrite","Rhodochrosite","Rose Quartz","Rubellite Tourmaline","Ruby","Ruby-in-Fuchsite","Ruby-Zoisite","Rutile Quartz","Rutile Topaz","Sapphire","Seraphinite","Serpentine","Smoky Quartz","Snowflake Obsidian","Sodalite","Spinel","Star Diopside","Star Garnet","Star Lemon Quartz","Star Moonstone","Star Rose Quartz","Star Ruby","Star Sapphire","Star Sunstone","Sugilite","Sunstone","Tanzanite","Tiger's Eye","Topaz","Tourmaline","Turquoise","Variscite","Verdite","Zircon"]}}

data/tmp/stubs/metadata/conditions.json

@@ -0,0 +1,12 @@
+HTTP/1.1 200 OK
+X-Frame-Options: SAMEORIGIN
+X-XSS-Protection: 1; mode=block
+X-Content-Type-Options: nosniff
+Content-Type: application/json; charset=utf-8
+ETag: W/"9d4c524f00f493b9214bb3650be52a2f"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: 08e19f7c-e9cd-427c-9b3f-0f9c04aaae07
+X-Runtime: 0.097894
+Transfer-Encoding: chunked
+
+["New","New with Tags","New with Defects","Used","Used - Excellent","Used - Good","Used - Fair","Refurbished","Refurbished - Manufacturer","Refurbished - Seller"]

data/tmp/stubs/metadata/gemstones.json

@@ -0,0 +1,12 @@
+HTTP/1.1 200 OK
+X-Frame-Options: SAMEORIGIN
+X-XSS-Protection: 1; mode=block
+X-Content-Type-Options: nosniff
+Content-Type: application/json; charset=utf-8
+ETag: W/"9d4c524f00f493b9214bb3650be52a2f"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: 08e19f7c-e9cd-427c-9b3f-0f9c04aaae07
+X-Runtime: 0.097894
+Transfer-Encoding: chunked
+
+{"Gemstones":["Agate","Alexandrite","Amazonite","Amber","Amethyst","Ametrine","Ammolite","Andalusite","Apatite","Aquamarine","Aventurine","Azotic Topaz","Beryl","Bloodstone","Calcite","Carnelian","Cat's Eye","Chalcedony","Charoite","Chrysocolla","Chrysoprase","Citrine","Coral","Cubic Zirconia","Diamond","Emerald","Fire Opal","Fluorite","Fossil Coral","Garnet","Gaspeite","Goldstone","Goshenite","Hematite","Howlite","Imperial Topaz","Iolite","Jadeite","Jasper","Kunzite","Kyanite","Labradorite","Labradorite","Lapis Lazuli","Larimar","Lepidolite","Malachite","Moonstone","Morganite","Mystic Quartz","Mystic Topaz","Obsidian","Onyx","Opal","Opal","Opal Doublet","Pearl","Peridot","Pietersite","Prehnite","Quartz","Rainbow Moonstone","Rainbow Pyrite","Rhodochrosite","Rose Quartz","Rubellite Tourmaline","Ruby","Ruby-in-Fuchsite","Ruby-Zoisite","Rutile Quartz","Rutile Topaz","Sapphire","Seraphinite","Serpentine","Smoky Quartz","Snowflake Obsidian","Sodalite","Spinel","Star Diopside","Star Garnet","Star Lemon Quartz","Star Moonstone","Star Rose Quartz","Star Ruby","Star Sapphire","Star Sunstone","Sugilite","Sunstone","Tanzanite","Tiger's Eye","Topaz","Tourmaline","Turquoise","Variscite","Verdite","Zircon"]}

data/tophatter-merchant.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$LOAD_PATH.push File.expand_path('../lib', __FILE__)
+require 'tophatter_merchant/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'tophatter-merchant'
+  s.version     = TophatterMerchant::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.licenses    = ['MIT']
+  s.authors     = ['Chris Estreich']
+  s.email       = ['chris@tophatter.com']
+  s.homepage    = 'https://github.com/tophatter/merchant-api-ruby'
+  s.summary     = 'Manage your inventory and fulfill orders on Tophatter.'
+  s.description = 'The Tophatter merchant platform is an e-commerce platform. It allows merchants to manage inventory and fulfill orders on Tophatter.'
+
+  s.required_ruby_version = '~> 2.0'
+
+  s.add_dependency 'rest-client', '~> 1.6'
+  s.add_dependency 'activemodel', '~> 4.2'
+
+  s.post_install_message = 'Documentation is available at: https://tophatter.readme.io/'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: tophatter-merchant
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Chris Estreich
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-11-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+description: The Tophatter merchant platform is an e-commerce platform. It allows
+  merchants to manage inventory and fulfill orders on Tophatter.
+email:
+- chris@tophatter.com
+executables:
+- console
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.md
+- VERSION
+- bin/console
+- lib/tophatter_merchant.rb
+- lib/tophatter_merchant/account.rb
+- lib/tophatter_merchant/api_key.rb
+- lib/tophatter_merchant/exceptions.rb
+- lib/tophatter_merchant/image.rb
+- lib/tophatter_merchant/metadata.rb
+- lib/tophatter_merchant/order.rb
+- lib/tophatter_merchant/product.rb
+- lib/tophatter_merchant/resource.rb
+- lib/tophatter_merchant/variation.rb
+- lib/tophatter_merchant/version.rb
+- spec/spec_helper.rb
+- spec/tophatter_merchant/metadata_spec.rb
+- spec/tophatter_merchant/product_spec.rb
+- tmp/stubs/metadata.json
+- tmp/stubs/metadata/conditions.json
+- tmp/stubs/metadata/gemstones.json
+- tophatter-merchant.gemspec
+homepage: https://github.com/tophatter/merchant-api-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 'Documentation is available at: https://tophatter.readme.io/'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Manage your inventory and fulfill orders on Tophatter.
+test_files:
+- spec/spec_helper.rb
+- spec/tophatter_merchant/metadata_spec.rb
+- spec/tophatter_merchant/product_spec.rb