peddler 0.6.3 → 0.6.4

data/lib/mws/reports/requests/report_request_list.rb

@@ -0,0 +1,30 @@
+require 'peddler/request'
+require 'mws/reports/parsers/report_request_list'
+
+module MWS
+  module Reports
+    module Requests
+      class ReportRequestList < ::Peddler::Request
+        def get(options = {})
+          parameters(:get_report_request_list)
+            .update(options)
+            .timestamp!
+            .format_structured_lists!
+            .camelize_keys!
+
+          execute
+        end
+
+        def get_by_next_token(token = next_token)
+          return false unless token
+
+          parameters(:get_report_request_list_by_next_token)
+            .update(next_token: token)
+            .camelize_keys!
+
+          execute
+        end
+      end
+    end
+  end
+end

data/lib/mws/reports/requests/report_requests.rb

@@ -0,0 +1,20 @@
+require 'peddler/request'
+require 'mws/reports/parsers/report_requests'
+
+module MWS
+  module Reports
+    module Requests
+      class ReportRequests < ::Peddler::Request
+        def cancel(options = {})
+          parameters(:cancel_report_requests)
+            .update(options)
+            .timestamp!
+            .format_structured_lists!
+            .camelize_keys!
+
+          execute
+        end
+      end
+    end
+  end
+end

data/lib/mws/reports/requests/report_schedule_count.rb

@@ -0,0 +1,19 @@
+require 'peddler/request'
+require 'mws/reports/parsers/report_schedule_count'
+
+module MWS
+  module Reports
+    module Requests
+      class ReportScheduleCount < ::Peddler::Request
+        def get(*types)
+          parameters(:get_report_schedule_count)
+            .update(report_type_list: types)
+            .format_structured_lists!
+            .camelize_keys!
+
+          execute
+        end
+      end
+    end
+  end
+end

data/lib/mws/reports/requests/report_schedule_list.rb

@@ -0,0 +1,23 @@
+require 'peddler/request'
+require 'mws/reports/parsers/report_schedule_list'
+
+module MWS
+  module Reports
+    module Requests
+      class ReportScheduleList < ::Peddler::Request
+        def get(*types)
+          parameters(:get_report_schedule_list)
+            .update(report_type_list: types)
+            .format_structured_lists!
+            .camelize_keys!
+
+          execute
+        end
+
+        def get_by_next_token(token = next_token)
+          raise NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/mws/reports/requests/report_scheduler.rb

@@ -0,0 +1,29 @@
+require 'peddler/request'
+require 'mws/reports/parsers/report_scheduler'
+
+module MWS
+  module Reports
+    module Requests
+      class ReportScheduler < ::Peddler::Request
+        def manage(type, schedule, scheduled_at = nil)
+          options = {
+            report_type: type,
+            schedule: schedule
+          }
+          options.update(scheduled_date: scheduled_at) if scheduled_at
+
+          parameters(:get_report_count)
+            .update(options)
+            .timestamp!
+            .camelize_keys!
+
+          execute
+        end
+
+        def delete(type)
+          manage(type, '_NEVER_')
+        end
+      end
+    end
+  end
+end

data/lib/mws/sellers/client.rb

@@ -1,7 +1,53 @@
+require 'mws/sellers/requests/marketplace_participations'
+require 'mws/sellers/requests/service_status'
+require 'peddler/client'
+
 module MWS
   module Sellers
+    # The Sellers API lets sellers retrieve information about their seller
+    # account, such as the marketplaces they participate in.
     class Client < ::Peddler::Client
       path 'Sellers/2011-07-01'
+
+      # Public: List marketplaces that the seller submitting the request can
+      # sell in and her participations, which include seller-specific
+      # information in that marketplace.
+      #
+      # Examples
+      #
+      #   client.list_marketplace_participations
+      #
+      # Returns Marketplace Participations.
+      def_delegator :marketplace_participations, :list, :list_marketplace_participations
+
+      # Public: List the next page of marketplace participations using the
+      # NextToken parameter.
+      #
+      # Examples
+      #
+      #   client.list_marketplace_participations_by_next_token
+      #
+      # Returns Marketplace Participations.
+      def_delegator :marketplace_participations, :list_by_next_token, :list_marketplace_participations_by_next_token
+
+      # Public: Get the service status of the API.
+      #
+      # Examples
+      #
+      #   client.get_service_status
+      #
+      # Returns the Service Status.
+      def_delegator :service_status, :get, :get_service_status
+
+      private
+
+      def marketplace_participations
+        @marketplace_participations ||= Requests::MarketplaceParticipations.new(self)
+      end
+
+      def service_status
+        @service_status ||= Requests::ServiceStatus.new(self)
+      end
     end
   end
 end

data/lib/mws/sellers/parsers/marketplace.rb

@@ -0,0 +1,33 @@
+require 'peddler/parsers/model'
+
+module MWS
+  module Sellers
+    module Parsers
+      class Marketplace < ::Peddler::Parsers::Model
+        value(:id) do
+          text_at_xpath('MarketplaceId')
+        end
+
+        value(:name) do
+          text_at_xpath('Name')
+        end
+
+        value(:default_country_code) do
+          text_at_xpath('DefaultCountryCode')
+        end
+
+        value(:default_currency_code) do
+          text_at_xpath('DefaultCurrencyCode')
+        end
+
+        value(:default_language_code) do
+          text_at_xpath('DefaultLanguageCode')
+        end
+
+        value(:domain_name) do
+          text_at_xpath('DomainName')
+        end
+      end
+    end
+  end
+end

data/lib/mws/sellers/parsers/marketplace_participations.rb

@@ -0,0 +1,32 @@
+require 'peddler/parsers/model'
+require 'mws/sellers/parsers/marketplace'
+require 'mws/sellers/parsers/participation'
+require 'peddler/parsers/tokenable'
+
+module MWS
+  module Sellers
+    module Parsers
+      class MarketplaceParticipations < ::Peddler::Parsers::Model
+        include ::Peddler::Parsers::Tokenable
+
+        value(:marketplaces) do
+          marketplace_nodes.map { |node| Marketplace.new(node) }
+        end
+
+        value(:participations) do
+          participation_nodes.map { |node| Participation.new(node) }
+        end
+
+        private
+
+        def participation_nodes
+          xpath('ListParticipations/Participation')
+        end
+
+        def marketplace_nodes
+          xpath('ListMarketplaces/Marketplace')
+        end
+      end
+    end
+  end
+end

data/lib/mws/sellers/parsers/participation.rb

@@ -0,0 +1,21 @@
+require 'peddler/parsers/model'
+
+module MWS
+  module Sellers
+    module Parsers
+      class Participation < ::Peddler::Parsers::Model
+        value(:marketplace_id) do
+          text_at_xpath('MarketplaceId')
+        end
+
+        value(:seller_id) do
+          text_at_xpath('SellerId')
+        end
+
+        value(:has_seller_suspended_listings?) do
+          boolean_at_xpath('HasSellerSuspendedListings')
+        end
+      end
+    end
+  end
+end

data/lib/mws/sellers/parsers/service_status.rb

@@ -0,0 +1,36 @@
+require 'mws/sellers/parsers/service_status_message'
+require 'peddler/parsers/model'
+
+module MWS
+  module Sellers
+    module Parsers
+      class ServiceStatus < ::Peddler::Parsers::Model
+        value :status do
+          text_at_xpath('Status')
+        end
+
+        value :timestamp do
+          time_at_xpath('Timestamp')
+        end
+
+        value :message_id do
+          text_at_xpath('MessageId')
+        end
+
+        value :messages do
+          xpath('Messages/Message').map { |node| ServiceStatusMessage.new(node) }
+        end
+
+        def ok?
+          status == 'GREEN'
+        end
+
+        def inspect
+          status
+        end
+
+        alias :to_s :inspect
+      end
+    end
+  end
+end

data/lib/mws/sellers/parsers/service_status_message.rb

@@ -0,0 +1,17 @@
+require 'peddler/parsers/model'
+
+module MWS
+  module Sellers
+    module Parsers
+      class ServiceStatusMessage < ::Peddler::Parsers::Model
+        value :locale do
+          text_at_xpath('Locale')
+        end
+
+        value :text do
+          text_at_xpath('Text')
+        end
+      end
+    end
+  end
+end

data/lib/mws/sellers/requests/marketplace_participations.rb

@@ -0,0 +1,27 @@
+require 'peddler/request'
+require 'mws/sellers/parsers/marketplace_participations'
+
+module MWS
+  module Sellers
+    module Requests
+      class MarketplaceParticipations < ::Peddler::Request
+        def list
+          parameters(:list_marketplace_participations)
+            .camelize_keys!
+
+          execute
+        end
+
+        def list_by_next_token(token = next_token)
+          return false unless token
+
+          parameters(:list_marketplace_participations_by_next_token)
+            .update(next_token: token)
+            .camelize_keys!
+
+          execute
+        end
+      end
+    end
+  end
+end

data/lib/mws/sellers/requests/service_status.rb

@@ -0,0 +1,15 @@
+require 'peddler/request'
+require 'mws/sellers/parsers/service_status'
+
+module MWS
+  module Sellers
+    module Requests
+      class ServiceStatus < ::Peddler::Request
+        def get
+          parameters(:get_service_status)
+          execute
+        end
+      end
+    end
+  end
+end

data/lib/peddler/parsers/base.rb

@@ -1,8 +1,8 @@
 module Peddler
   module Parsers
     class Base
-      def self.handle?(type)
-        raise NotImplementedError
+      def self.xml?
+        false
       end
 
       attr :document

data/lib/peddler/parsers/counter.rb

@@ -0,0 +1,13 @@
+require 'peddler/parsers/model'
+
+module Peddler
+  module Parsers
+    class Counter < Model
+      value :count do
+        integer_at_xpath('Count')
+      end
+
+      alias :to_i :count
+    end
+  end
+end

data/lib/peddler/parsers/model.rb

@@ -10,6 +10,10 @@ module Peddler
     class Model < XML
       include Structure
 
+      def boolean_at_xpath(path)
+        !!text_at_xpath(path).match(/true|yes/i)
+      end
+
       def float_at_xpath(path)
         str = text_at_xpath(path)
         str.to_f if str
@@ -29,11 +33,6 @@ module Peddler
         Money.new(amount, currency_code)
       end
 
-      def text_at_xpath(path)
-        node = at_xpath(path)
-        node.text if node
-      end
-
       def time_at_xpath(path)
         str = text_at_xpath(path)
         Time.parse(CGI.unescape(str)) if str

data/lib/peddler/parsers/text.rb

@@ -3,11 +3,6 @@ require 'peddler/parsers/base'
 module Peddler
   module Parsers
     class Text < Base
-      def self.handle?(type)
-        type == :txt
-      end
-
-      alias :to_s :document
     end
   end
 end

data/lib/peddler/parsers/tokenable.rb

@@ -0,0 +1,13 @@
+module Peddler
+  module Parsers
+    module Tokenable
+      def next_token
+        text_at_xpath('NextToken')
+      end
+
+      def has_next_token?
+        !!next_token
+      end
+    end
+  end
+end

data/lib/peddler/parsers/xml.rb

@@ -3,21 +3,26 @@ require 'peddler/parsers/base'
 module Peddler
   module Parsers
     class XML < Base
-      def self.handle?(type)
-        type == :xml
+      def self.xml?
+        true
+      end
+
+      def text_at_xpath(path)
+        node = at_xpath(path)
+        node.text if node
       end
 
       def at_xpath(path)
-        document.at_xpath(with_namespace(path))
+        document.at_xpath(add_namespace(path))
       end
 
       def xpath(path)
-        document.xpath(with_namespace(path))
+        document.xpath(add_namespace(path))
       end
 
       private
 
-      def with_namespace(path)
+      def add_namespace(path)
         path.split('/').map { |attr| "xmlns:#{attr}" }.join('/')
       end
     end

data/lib/peddler/request/parameters.rb

@@ -23,7 +23,8 @@ module Peddler
 
         each do |key, value|
           if StructuredList.handle?(key)
-            lists.update(StructuredList.new(key).build(delete(key)))
+            list = StructuredList.new(key).build(delete(key))
+            lists.update(list)
           end
         end
 

data/lib/peddler/request/structured_list.rb

@@ -13,6 +13,11 @@ module Peddler
         payment_method: %w(PaymentMethod),
         tfm_shipment_status: %w(TFMShipmentStatus Status),
         amazon_order_id: %w(AmazonOrderId Id),
+        # Reports
+        report_id_list: %w(ReportIdList Id),
+        report_request_id_list: %w(ReportRequestIdList Id),
+        report_type_list: %w(ReportTypeList Type),
+        report_processing_status_list: %w(ReportProcessingStatusList Status),
       }
 
       attr :keys

data/lib/peddler/request.rb

@@ -1,18 +1,11 @@
-require 'forwardable'
-
 require 'peddler/request/parameters'
-require 'peddler/response_wrapper'
+require 'peddler/response'
 
 module Peddler
   class Request
-    extend Forwardable
-
-    def_delegator :last_response, :next_token
-    def_delegator :last_response, :xml_payload, :last_xml_payload
-
     attr :client, :headers
 
-    attr_accessor :body, :last_response
+    attr_accessor :body, :last_parsed_response
 
     def initialize(client)
       @client = client
@@ -25,8 +18,12 @@ module Peddler
     end
 
     def execute
-      fetch
-      parse
+      res = fetch
+      parse(res)
+    end
+
+    def next_token
+      last_parsed_response.next_token if last_parsed_response
     end
 
     def has_next_token?
@@ -40,15 +37,16 @@ module Peddler
     end
 
     def fetch
-      opts = { query: parameters, headers: headers }
+      opts = { query: parameters, headers: headers, idempotent: true, expects: 200 }
       opts.update(body: body) if body
       res = client.post(opts)
 
-      @last_response = ResponseWrapper.new(res)
+      Response.new(res)
     end
 
-    def parse
-      parser.new(parser.handle?(:xml) ? last_xml_payload : last_response.body)
+    def parse(response)
+      document = parser.xml? ? response.result_node : response.body
+      @last_parsed_response = parser.new(document)
     end
   end
 end

data/lib/peddler/{response_wrapper.rb → response.rb}

@@ -2,31 +2,26 @@ require 'forwardable'
 require 'nokogiri'
 
 module Peddler
-  class ResponseWrapper
+  class Response
     extend Forwardable
 
-    def_delegator :response, :body
+    attr :http_response
 
-    attr :response
+    def_delegator :http_response, :body
 
-    def initialize(response)
-      @response = response
+    def initialize(http_response)
+      @http_response = http_response
     end
 
     def document
       Nokogiri::XML(body)
     end
 
-    def xml_payload
+    def result_node
       root = document.root
       path = root.name.sub('Response', 'Result')
 
       root.xpath("xmlns:#{path}")
     end
-
-    def next_token
-      node = xml_payload.at_xpath('xmlns:NextToken')
-      node.text if node
-    end
   end
 end

data/lib/peddler/version.rb

@@ -1,3 +1,3 @@
 module Peddler
-  VERSION = '0.6.3'
+  VERSION = '0.6.4'
 end

data/test/fixtures/mws.yml

@@ -1,3 +1,7 @@
+- country: US
+  aws_access_key_id: AKIAJ767ZET2BZR4UDDQ
+  aws_secret_access_key: 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
+  seller_id: A2H6NH4SQYFZ4M
 - country: GB
   aws_access_key_id: AKIAJJDQ2MJTMPXKJE4A
   aws_secret_access_key: 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

data/test/fixtures/reports/report.xml

@@ -0,0 +1,8 @@
+order-id order-item-id purchase-date payments-date buyer-email buyer-name buyer-phone-number sku product-name quantity-purchased currency item-price item-tax shipping-price shipping-tax ship-service-level recipient-name ship-address-1 ship-address-2 ship-address-3 ship-city ship-state ship-postal-code ship-country ship-phone-number delivery-start-date delivery-end-date delivery-time-zone delivery-Instructions
+103-26010-55904394929210114 2011-02-09T02:46:57-08:00
+2011-02-09T02:46:57-08:00 0g9lx423zn5@marketplace.amazon.com 
+Joe Customer 404-555-1212 JW-RT1-HLD9 The Structure of Aikido: 
+Volume 1: Kenjutsu and Taijutsu Sword and Open-Hand Movement 
+Relationships (Structure of Aikido, Vol 1) 1 USD 19.49 0.00 3.99 
+0.00 Standard Joe Customer 123 Main Street LAWRENCE CA 90044-2463 
+US 404-555-1212

data/test/fixtures/reports/report_acknowledgements.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0"?>
+<UpdateReportAcknowledgementsResponse
+  xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
+  <UpdateReportAcknowledgementsResult>
+    <Count>1</Count>
+    <ReportInfo>
+      <ReportId>841997483</ReportId>
+      <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
+      <ReportRequestId>2234038326</ReportRequestId>
+      <AvailableDate>2009-01-06T03:48:36+00:00</AvailableDate>
+      <Acknowledged>true</Acknowledged>
+      <AcknowledgedDate>2009-02-20T02:10:41+00:00</AcknowledgedDate>
+    </ReportInfo>
+  </UpdateReportAcknowledgementsResult>
+  <ResponseMetadata>
+    <RequestId>42a578a7-ed92-486b-ac67-5de7464fcdfa</RequestId>
+  </ResponseMetadata>
+</UpdateReportAcknowledgementsResponse>

data/test/fixtures/reports/report_count.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0"?>
+<GetReportCountResponse xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
+  <GetReportCountResult>
+    <Count>166</Count>
+  </GetReportCountResult>
+  <ResponseMetadata>
+    <RequestId>a497aadb-5ea1-49bf-aa14-dabe914465e3</RequestId>
+  </ResponseMetadata>
+</GetReportCountResponse>