rapa 0.5.7 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: daf9368b0cd3989155910e650b483b6355b3b978
-  data.tar.gz: 282726a68609c28e82d8ef83cddb0c6c9e96d1ed
+  metadata.gz: 1818b2a706381589ac6fc00d485ebe1bba04254a
+  data.tar.gz: ae107e261a4337568d482ae9498d9e16aa197906
 SHA512:
-  metadata.gz: 0e297e43370320522f9ad2294c57203f50949e0ea9a72e2eb946ef38908bb2aa5627e4eee9aa8494d98a4dd08964c399c8074534d49f0d40ef1fcbf3a6e04522
-  data.tar.gz: c789502c0e33767cd9cc4de8a12d2260fa111c2f23339d061385c2a2d1a9c3def98241f3569140e0ba66134f0cfa03995a3c8690a539798075a2326e37626322
+  metadata.gz: 6d8969b4008e6e1b4cd70fcd2beaba06cf9ffa84277ec5577297dde562d03ea7c8b05e980432772ac177b055980273205fc02cbbc59e1c9d39c856d9ec324379
+  data.tar.gz: 8c1ef3179e5b67eb957548717b678ca82bf35f0ccadc8110a4a1ddb467eb360f69b66e2ccd91a2d4b336b7b6a09940782a9d78cff06bce905cc4857ea3d5be2a

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## v0.6.0
+
+- Add `Rapa::Client#lookup_browse_node`
+
 ## v0.5.7
 
 - Add `Rapa::Resources::ItemResources#crators`

data/README.md

@@ -74,6 +74,24 @@ response = client.list_items(
 )
 ```
 
+### Rapa::Client#lookup_browse_node
+
+Available options:
+
+- `:browse_node_id`
+- `:domain`
+- `:response_groups`
+
+Returns a `Rapa::Responses::LookupBrowseNodeResponse`.
+
+```ruby
+response = client.lookup_browse_node(
+  browse_node_id: "...",
+  domain: "...",
+  response_groups: ["..."],
+)
+```
+
 ### Rapa::Client#search_items
 
 Available options:
@@ -98,6 +116,15 @@ response = client.search_items(
 )
 ```
 
+### Rapa::Responses::LookupBrowseNodeResponse
+
+Available methods:
+
+- `#error`
+- `#has_error?`
+- `#has_valid_request?`
+- `#response_group(group)`
+
 ### Rapa::Responses::SearchItemsResponse
 
 Available methods:
@@ -108,6 +135,17 @@ Available methods:
 - `#total_pages`
 - `#total_results`
 
+### Rapa::Resources::BrowseNodeResource
+
+Available methods:
+
+- `#asin`
+- `#author`
+- `#eook?`
+- `#product_group`
+- `#title`
+- `#url_details_page`
+
 ### Rapa::Resources::ItemResource
 
 Available methods:

data/lib/rapa.rb

@@ -10,12 +10,17 @@ require "rapa/price"
 require "rapa/quantity"
 require "rapa/queries/base_query"
 require "rapa/queries/list_items_query"
+require "rapa/queries/lookup_browse_node"
 require "rapa/queries/search_items_query"
 require "rapa/resources/base_resource"
+require "rapa/resources/browse_node_resource"
 require "rapa/resources/item_resource"
 require "rapa/responses/base_response"
-require "rapa/responses/list_items_response"
-require "rapa/responses/search_items_response"
+require "rapa/responses/multiple_resources_response"
+require "rapa/responses/multiple_resources_response/list_items_response"
+require "rapa/responses/multiple_resources_response/search_items_response"
+require "rapa/responses/single_resource_response"
+require "rapa/responses/single_resource_response/lookup_browse_node_response"
 require "rapa/signer"
 require "rapa/similar_product"
 require "rapa/url"

data/lib/rapa/client.rb

@@ -22,6 +22,24 @@ module Rapa
       end
     end
 
+    # @param browse_node_id [Integer]
+    # @param domain [String]
+    # @param response_groups [Array<String>, nil]
+    # @return [Rapa::Responses::LookupBrowseNodeResponse]
+    def lookup_browse_node(
+      browse_node_id:,
+      domain:,
+      response_groups: nil
+    )
+      send_request(
+        browse_node_id: browse_node_id,
+        domain: domain,
+        query_class: ::Rapa::Queries::LookupBrowseNode,
+        response_class: ::Rapa::Responses::LookupBrowseNodeResponse,
+        response_groups: response_groups
+      )
+    end
+
     # @param item_ids [Array<String>]
     # @param domain [String]
     # @param id_type [String, nil]

data/lib/rapa/queries/lookup_browse_node.rb

@@ -0,0 +1,19 @@
+module Rapa
+  module Queries
+    class LookupBrowseNode < BaseQuery
+      OPERATION = "BrowseNodeLookup"
+
+      property :BrowseNodeId
+
+      # @return [String]
+      def BrowseNodeId
+        options[:browse_node_id].to_s
+      end
+
+      # @note Override
+      def Operation
+        OPERATION
+      end
+    end
+  end
+end

data/lib/rapa/resources/browse_node_resource.rb

@@ -0,0 +1,35 @@
+module Rapa
+  module Resources
+    class BrowseNodeResource < BaseResource
+      # @return [String]
+      def asin
+        source["ASIN"]
+      end
+
+      # @return [String]
+      def author
+        source["Author"]
+      end
+
+      # @return [Boolean]
+      def ebook?
+        source["ProductGroup"] == "eBooks"
+      end
+
+      # @return [String]
+      def product_group
+        source["ProductGroup"]
+      end
+
+      # @return [String]
+      def title
+        source["Title"]
+      end
+
+      # @return [String]
+      def url_details_page
+        source["DetailPageURL"]
+      end
+    end
+  end
+end

data/lib/rapa/responses/base_response.rb

@@ -1,8 +1,6 @@
 module Rapa
   module Responses
     class BaseResponse
-      include ::Enumerable
-
       # @param faraday_response [Faraday::Response]
       def initialize(faraday_response)
         @faraday_response = faraday_response
@@ -13,23 +11,11 @@ module Rapa
         faraday_response.body
       end
 
-      # @note Implementation for Enumerable
-      def each(&block)
-        resources.each(&block)
-      end
-
       # @return [Faraday::Utils::Headers]
       def headers
         faraday_response.headers
       end
 
-      # @return [Array<Rapa::Resources::ItemResource>]
-      def resources
-        sources.map do |source|
-          resource_class.new(source)
-        end
-      end
-
       # @return [Integer]
       def status
         faraday_response.status

data/lib/rapa/responses/multiple_resources_response.rb

@@ -0,0 +1,19 @@
+module Rapa
+  module Responses
+    class MultipleResourcesResponse < BaseResponse
+      include ::Enumerable
+
+      # @note Implementation for Enumerable
+      def each(&block)
+        resources.each(&block)
+      end
+
+      # @return [Array<Rapa::Resources::ItemResource>]
+      def resources
+        sources.map do |source|
+          resource_class.new(source)
+        end
+      end
+    end
+  end
+end

data/lib/rapa/responses/{list_items_response.rb → multiple_resources_response/list_items_response.rb}

@@ -1,6 +1,6 @@
 module Rapa
   module Responses
-    class ListItemsResponse < BaseResponse
+    class ListItemsResponse < MultipleResourcesResponse
       # @return [Rapa::Error]
       def error
         if value = body.dig("ItemLookupErrorResponse", "Error")

data/lib/rapa/responses/{search_items_response.rb → multiple_resources_response/search_items_response.rb}

@@ -1,6 +1,6 @@
 module Rapa
   module Responses
-    class SearchItemsResponse < BaseResponse
+    class SearchItemsResponse < MultipleResourcesResponse
       # @return [Rapa::Error]
       def error
         if value = body.dig("ItemSearchResponse", "Items", "Request", "Errors", "Error")

data/lib/rapa/responses/single_resource_response.rb

@@ -0,0 +1,6 @@
+module Rapa
+  module Responses
+    class SingleResourceResponse < BaseResponse
+    end
+  end
+end

data/lib/rapa/responses/single_resource_response/lookup_browse_node_response.rb

@@ -0,0 +1,44 @@
+module Rapa
+  module Responses
+    class LookupBrowseNodeResponse < SingleResourceResponse
+      # @return [Rapa::Error, nil]
+      def error
+        if value = body.dig("BrowseNodeLookupErrorResponse", "Error")
+          ::Rapa::Error.new(value)
+        end
+      end
+
+      # @return [Boolean]
+      def has_error?
+        !error.nil?
+      end
+
+      # @return [Boolean]
+      def has_valid_request?
+        body.dig("BrowseNodeLookupResponse", "BrowseNodes", "Request", "IsValid") == "True"
+      end
+
+      # @return [Array<Rapa::Resources::BrowseNodeResource>, nil]
+      def response_group(group)
+        item = sources.find { |source| source["Type"] == group }
+        unless item.nil?
+          item["TopItem"].map do |source|
+            resource_class.new(source)
+          end
+        end
+      end
+
+      private
+
+      # @note Override
+      def resource_class
+        ::Rapa::Resources::BrowseNodeResource
+      end
+
+      # @note Override
+      def source_or_sources
+        body.dig("BrowseNodeLookupResponse", "BrowseNodes", "BrowseNode", "TopItemSet")
+      end
+    end
+  end
+end

data/lib/rapa/version.rb

@@ -1,3 +1,3 @@
 module Rapa
-  VERSION = "0.5.7"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rapa
 version: !ruby/object:Gem::Version
-  version: 0.5.7
+  version: 0.6.0
 platform: ruby
 authors:
 - Ryo Nakamura
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-20 00:00:00.000000000 Z
+date: 2017-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -163,12 +163,17 @@ files:
 - lib/rapa/quantity.rb
 - lib/rapa/queries/base_query.rb
 - lib/rapa/queries/list_items_query.rb
+- lib/rapa/queries/lookup_browse_node.rb
 - lib/rapa/queries/search_items_query.rb
 - lib/rapa/resources/base_resource.rb
+- lib/rapa/resources/browse_node_resource.rb
 - lib/rapa/resources/item_resource.rb
 - lib/rapa/responses/base_response.rb
-- lib/rapa/responses/list_items_response.rb
-- lib/rapa/responses/search_items_response.rb
+- lib/rapa/responses/multiple_resources_response.rb
+- lib/rapa/responses/multiple_resources_response/list_items_response.rb
+- lib/rapa/responses/multiple_resources_response/search_items_response.rb
+- lib/rapa/responses/single_resource_response.rb
+- lib/rapa/responses/single_resource_response/lookup_browse_node_response.rb
 - lib/rapa/signer.rb
 - lib/rapa/similar_product.rb
 - lib/rapa/url.rb