tophatter-merchant 1.1.3 → 1.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 407bafdbab15d6579d4407f1bfdc9c490ce45438
-  data.tar.gz: c5ee4df73abd47d1f4e56e81d9de4e4c1cc64637
+  metadata.gz: 68355cabcacea8767d8d9fba36509a52d6f3964a
+  data.tar.gz: 86cd0ca79cad91737c43a68a8e462884dedaeca0
 SHA512:
-  metadata.gz: 858cf26f30a9aab45bdc1a915a70f8d8299003dbb02a224b78a40016add37cd3bd71098e8dd07bdbfb691f6a0865d932c528bcc0874ae2905a910c5d10c94e36
-  data.tar.gz: f087d451add8e0f3d00369eca9430e4101299e3b5bbbfc9de0c1b16e12c1f0921b3e7697fc0447b09ea79bb4ecd52ac24d9e84d29530426561ccb3eea7e5dd63
+  metadata.gz: 0de67c7d954e5e71335ea538057a1da48b026f1f8c3c1924995e2504d478625e720ec1304172bc93928607609859bb11949a15e78312efe83ddc0d1ddd98cbfd
+  data.tar.gz: a6d4a43abcf06a48a61dc62ff54977fff1e8d7d441cd653bfa7fdfeec514e786d5e7efbcbd77d77d4cbc2d98055f7824651a9810ba751611a2d3d71b7aed0141

data/.rubocop.yml

@@ -5,6 +5,8 @@ AllCops:
 
 Metrics/LineLength:
   Enabled: false
+Metrics/BlockLength:
+  Enabled: false
 Metrics/MethodLength:
   Enabled: false
 Metrics/ParameterLists:
@@ -30,3 +32,6 @@ Style/ElseAlignment:
 # http://www.rubydoc.info/github/bbatsov/rubocop/Rubocop/Cop/Style/IndentationWidth
 Style/IndentationWidth:
   Enabled: false
+# https://github.com/bbatsov/ruby-style-guide#underscores-in-numerics
+Style/NumericLiterals:
+  Enabled: false

data/Gemfile

@@ -5,5 +5,6 @@ group :development, :test do
   gem 'awesome_print'
   gem 'pry'
   gem 'rspec'
+  gem 'vcr'
   gem 'webmock'
 end

data/README.md

@@ -8,8 +8,8 @@ gem 'tophatter-merchant', require: 'tophatter_merchant'
 
 ### Console Testing (Development)
 ```bash
-echo http://tophatter.dev/merchant_api/v1 > .api_host
-echo a42880c4b7d0809300bed27c453f883d > .access_token
+echo http://tophatter.dev/merchant_api/v1 > .api_path
+echo 293da6763df7cb3b894a1831addcb52d > .access_token
 bin/console
 ```
 

data/VERSION

@@ -1 +1 @@
-1.1.3
+1.1.4

data/bin/console

@@ -22,5 +22,5 @@ end
 
 TophatterMerchant.logger.level = Logger::DEBUG
 
-Pry.config.color = false
+AwesomePrint.pry!
 Pry.start

data/lib/tophatter_merchant/metadata.rb

@@ -6,14 +6,24 @@ module TophatterMerchant
         get(url: "#{path}.json")
       end
 
+      # ap TophatterMerchant::Metadata.categories
+      def categories
+        get(url: "#{path}/categories.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")
+      # ap TophatterMerchant::Metadata.brands
+      def brands
+        get(url: "#{path}/brands.json")
+      end
+
+      # ap TophatterMerchant::Metadata.materials
+      def materials
+        get(url: "#{path}/materials.json")
       end
 
       # ap TophatterMerchant::Metadata.sizes
@@ -21,6 +31,11 @@ module TophatterMerchant
         get(url: "#{path}/sizes.json")
       end
 
+      # ap TophatterMerchant::Metadata.colors
+      def colors
+        get(url: "#{path}/colors.json")
+      end
+
       # ap TophatterMerchant::Metadata.countries
       def countries
         get(url: "#{path}/countries.json")
@@ -51,19 +66,6 @@ module TophatterMerchant
         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

data/lib/tophatter_merchant/order.rb

@@ -9,6 +9,10 @@ module TophatterMerchant
                   :disbursement_amount, :seller_fees_amount, :seller_fees,
                   :paid_at, :created_at
 
+    def id
+      created_at.present? ? identifier : nil
+    end
+
     class << self
       # ap TophatterMerchant::Order.schema
       def schema
@@ -34,10 +38,6 @@ module TophatterMerchant
         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: [])

data/lib/tophatter_merchant/product.rb

@@ -4,13 +4,17 @@ module TophatterMerchant
                   :category, :title, :description, # Basics
                   :condition, :brand, :material, # Facets
                   :available_quantity, :variations, # Variations
-                  :starting_bid, :buy_now_price, :retail_price, :cost_basis, :success_fee_bid, :minimum_alerts_needed, # Pricing
-                  :shipping_origin, :shipping_price, :expedited_shipping_price, :days_to_fulfill, :days_to_deliver, :expedited_days_to_deliver, :weight, # Shipping
+                  :starting_bid, :buy_now_price, :retail_price, :cost_basis, # Pricing
+                  :shipping_origin, :days_to_fulfill, :weight, # Shipping
+                  :shipping_price, :days_to_deliver,
+                  :expedited_shipping_price, :expedited_days_to_deliver,
                   :buy_one_get_one_price, :accessory_price, :accessory_description, # Upsells
                   :primary_image, :extra_images, :all_images, # Images
-                  :slug, :ratings_average, :ratings_count, # Ratings
+                  :ratings_average, :ratings_count, # Ratings
                   :created_at, :updated_at, :disabled_at, :deleted_at, # Timestamps
-                  :blacklisted_at, :admin_hold_at, :slug, :internal_id # Other
+                  :success_fee_bid, :minimum_alerts_needed, # Undocumented
+                  :blacklisted_at, :admin_hold_at,
+                  :slug, :internal_id
 
     def id
       created_at.present? ? identifier : nil
@@ -47,21 +51,21 @@ module TophatterMerchant
         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 })
+      # 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.map { |hash| Product.new(hash) }
+          result = 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 })
+      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) }
@@ -86,11 +90,6 @@ module TophatterMerchant
         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 })
@@ -101,8 +100,10 @@ module TophatterMerchant
         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 })
+      # ap TophatterMerchant::Product.delete('FOOBAR').to_h
+      # NOT DOCUMENTED
+      def delete(id)
+        Product.new post(url: "#{path}/delete.json", params: { identifier: id })
       end
 
       protected

data/lib/tophatter_merchant/resource.rb

@@ -1,6 +1,11 @@
-require 'active_model'
-
 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
+
   class Resource
     include ActiveModel::Model
 
@@ -33,7 +38,6 @@ module TophatterMerchant
 
     class << self
       def attr_accessor(*vars)
-        # TophatterMerchant.logger.debug "#{name}: #{vars.inspect} (attr_accessor)"
         @attributes ||= {}
         vars.each { |var| @attributes[var.to_s] = true }
         super(*vars)

data/lib/tophatter_merchant/variation.rb

@@ -1,6 +1,8 @@
 module TophatterMerchant
   class Variation < Resource
-    attr_accessor :identifier, :size, :color, :quantity, :created_at
+    attr_accessor :product_identifier, :identifier,
+                  :size, :color, :quantity,
+                  :created_at, :disabled_at, :deleted_at
 
     def id
       created_at.present? ? identifier : nil

data/lib/tophatter_merchant/version.rb

@@ -1,3 +1,3 @@
 module TophatterMerchant
-  VERSION = '1.1.3'.freeze
+  VERSION = '1.1.4'.freeze
 end

data/lib/tophatter_merchant.rb

@@ -1,4 +1,5 @@
 require 'active_model'
+require 'json'
 
 module TophatterMerchant
   class << self
@@ -20,13 +21,9 @@ module TophatterMerchant
 end
 
 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'

data/spec/cassettes/TophatterMerchant_Metadata/_brands/returns_brands.yml

@@ -0,0 +1,161 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://tophatter.com/merchant_api/v1/metadata/brands.json
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Accept:
+      - "*/*; q=0.5, application/xml"
+      Accept-Encoding:
+      - gzip, deflate
+      Content-Length:
+      - '0'
+      Content-Type:
+      - application/x-www-form-urlencoded
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Sat, 25 Mar 2017 22:19:52 GMT
+      Etag:
+      - W/"802f97f94d2f051ca825fcf6c399acb5"
+      Server:
+      - nginx + Phusion Passenger
+      Status:
+      - 200 OK
+      Vary:
+      - Accept-Encoding
+      X-Content-Type-Options:
+      - nosniff
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Powered-By:
+      - Phusion Passenger Enterprise
+      X-Request-Id:
+      - d7977e10-155b-4e34-80f5-1c1a70b429c1
+      X-Request-Start:
+      - t=1490480392.698
+      X-Runtime:
+      - '0.013937'
+      X-Xss-Protection:
+      - 1; mode=block
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        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
+    http_version: 
+  recorded_at: Sat, 25 Mar 2017 22:19:52 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/TophatterMerchant_Metadata/_carriers/returns_carriers.yml

@@ -0,0 +1,81 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://tophatter.com/merchant_api/v1/metadata/carriers.json
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Accept:
+      - "*/*; q=0.5, application/xml"
+      Accept-Encoding:
+      - gzip, deflate
+      Content-Length:
+      - '0'
+      Content-Type:
+      - application/x-www-form-urlencoded
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Sat, 25 Mar 2017 22:19:56 GMT
+      Etag:
+      - W/"df1934e98e60bb6c3169b8b7cb76b2df"
+      Server:
+      - nginx + Phusion Passenger
+      Status:
+      - 200 OK
+      Vary:
+      - Accept-Encoding
+      X-Content-Type-Options:
+      - nosniff
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Powered-By:
+      - Phusion Passenger Enterprise
+      X-Request-Id:
+      - a40e6f97-3022-4992-8125-4d31ca008ab5
+      X-Request-Start:
+      - t=1490480396.593
+      X-Runtime:
+      - '0.031435'
+      X-Xss-Protection:
+      - 1; mode=block
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        H4sIAAAAAAAAA2xUQW7bMBD8iqCzmQJFTr05iZK4iVMjtoumt7W0thhLpEBK
+        cdSij+kT+oYi/+ouRdJq3YuwO7Mkl7Mjfk/Xy8Uy/ZB2trHpJL3GInuldIsF
+        vlJ+CQoKSBbatoTmLhMNZ5N0PSx06yhO5iCrZKaUfoFWamUHUtSS+Kvbe0qL
+        shriBC91XaPJcUDFrtIbqERNW1DFJ7UykBOlVcsB9VFKBUk25xNzjgXWNuKh
+        PUf47p5AHVAR2g/BJJ2pQsZayUmonVp03Ho5Td4lXhEYQNFZGJfcjak9MeeL
+        LwSdNyzXrVa75I4//piSYrHnjz+KLx+r/OVL3uYjNKDCsmdOwpIVyMORal0W
+        uKVUO2i0wUDbAISKC6x2sqsDvxn1ceNEH+Y2tRJOZyGA4UmazWm+2Wtj0PJY
+        sW4s+myS3qCpfX9JnLPYObRnnvbDnbStzC35Iz+jit0Io5LHztJB8Y5mSMMV
+        5lBBb/3s2AQ0JAoreO6ouPZslKukxkEVCQdRNQ+Gos8SWwVRlRfl8UuoN3pk
+        k9znYd0DtiUa3smGEmZUJaRq0SjnfGAPrzqzxz4Wta3bgsV86tRIy75T/5WS
+        ZcSutXkZzp4ZacvAHdVZ7w1IFQ3Q7Q0RpTvpnoxqbCkbwqsYT9I78ke84p4T
+        cWqLa20OYAoZbep9sT3idPjFLLnXYbjTztL/WjkndRspKn0cceTiDQIQzn7U
+        vXcjW4CT8B486QKr5ErXyLuxaAxEYvaX9J49Gcjy7PpspLvdiqPuxJ3sYreb
+        9/z0rB5WbCDFLWbri3/fmVsaGdqDNlXB/7vLCK77gaDXhD3aD8TwYnjmxv8h
+        YZUokGdGzuxeNNkL3n62wK1WHhINWEbIptoYpJoCk8w28PsXK06BVCIfKOG6
+        uFpk/DgVjXvMlwdpo20tJ0dbH5KvCO638bzCg/g2QEPVjz8AAAD//wMAmQDZ
+        PywGAAA=
+    http_version: 
+  recorded_at: Sat, 25 Mar 2017 22:19:55 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/TophatterMerchant_Metadata/_categories/returns_categories.yml

@@ -0,0 +1,97 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://tophatter.com/merchant_api/v1/metadata/categories.json
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Accept:
+      - "*/*; q=0.5, application/xml"
+      Accept-Encoding:
+      - gzip, deflate
+      Content-Length:
+      - '0'
+      Content-Type:
+      - application/x-www-form-urlencoded
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Sat, 25 Mar 2017 22:19:51 GMT
+      Etag:
+      - W/"1fc46ae442e0793ca4f38061b1ba908a"
+      Server:
+      - nginx + Phusion Passenger
+      Status:
+      - 200 OK
+      Vary:
+      - Accept-Encoding
+      X-Content-Type-Options:
+      - nosniff
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Powered-By:
+      - Phusion Passenger Enterprise
+      X-Request-Id:
+      - 0c66d582-5e55-4f14-b839-1f9cad59c673
+      X-Request-Start:
+      - t=1490480391.785
+      X-Runtime:
+      - '0.013347'
+      X-Xss-Protection:
+      - 1; mode=block
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        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
+        AEjeaFaTGQAA
+    http_version: 
+  recorded_at: Sat, 25 Mar 2017 22:19:51 GMT
+recorded_with: VCR 3.0.3