a2z 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in a2z.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Matt Huggins
+
+MIT License
+
+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,270 @@
+# A2z
+
+A2z provides a simple Ruby DSL to retrieve product information from the
+[Amazon Product Advertising API](https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'a2z'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install a2z
+
+## Usage
+
+The basis of the A2z gem is the `A2z::Client`.  A client can be used to search
+for items or lookup a specific item available on [Amazon](http://www.amazon.com).
+Instantiating a client requires an API `key`, `secret`, and `tag`.  To obtain
+these, you'll need to [create an Amazon Product Advertising API account](https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html).
+
+Once you have these, create the client as follows:
+
+    client = A2z::Client.new(key: 'YOUR_KEY', secret: 'YOUR_SECRET', tag: 'YOUR_TAG')
+
+By default, a client will search within Amazon US (i.e.: amazon.com).  This can
+be customized by passing a `country` option when initializing your client.
+Valid country options are `:ca`, `:cn`, `:de`, `:es`, `:fr`, `:it`, `:jp`,
+`:uk`, and `:us`.  For example:
+
+    client = A2z::Client.new(country: :us, ...)
+
+Alternative, the country can be changed after the client has been initialized.
+
+    client.country = :us
+
+Within a Rails application, you'll probably want to keep your key, secret, and
+tag information out of source control.  One way to do this is to store this
+information in a YAML file such as `config/amazon.yml`.  For example:
+
+    key:    YOUR_KEY
+    secret: YOUR_SECRET
+    tag:    YOUR_TAG
+
+This file can then be used in the following manner:
+
+    config = YAML.load_file(Rails.root.join('config', 'amazon.yml'))
+    client = A2z::Client.new(config)
+
+### Item Search
+
+Once you have instantiated an `A2z::Client` instance, searching for products
+can be done through the `item_search` method.
+
+    response = client.item_search do
+                 category 'Music'
+                 keywords 'Dave Matthews Band'
+               end
+
+The return value is an `A2z::Responses::ItemSearch` object.  The example above
+would make the following calls possible.
+
+    response.valid?
+    => true
+    
+    response.total_results
+    => 435
+    
+    response.total_pages
+    => 44
+    
+    response.items.size
+    => 10
+    
+    response.items.first
+    # => #<A2z::Responses::Item ...>
+    
+    response.more_search_results_url
+    => "http://www.amazon.com/gp/redirect.html?camp=2025&creative=386001&location=..."
+    
+    response.operation_request
+    => #<A2z::Responses::OperationRequest ...>
+
+For more information on interacting with `A2z::Responses::Item` and
+`A2z::Responses::OperationRequest` objects, refer to their respective sections
+below.
+
+The following code is likely not a real-world example of how you would use
+the client to perform a search; it is only intended to demonstrate the full
+collection of methods provided when performing an item search.
+
+    client.item_search do
+      category 'Books'
+      keywords 'Harry Potter'
+      actor 'Adam Sandler'
+      artist 'Muse'
+      audience_rating 'PG-13'
+      author 'J.K. Rowling'
+      brand 'Timex'
+      browse_node 17
+      composer 'Wolfgang Amadeus Mozart'
+      condition 'Refurbished'
+      conductor 'Leopold Stokowski'
+      director 'Judd Apatow'
+      include_reviews_summary true
+      item_page 1
+      manufacturer 'Sony'
+      merchant_id 'SOME_MERCHANT_ID'
+      maximum_price 49.99
+      minimum_price 10.50
+      min_percentage_off 20
+      music_label 'Universal'
+      orchestra 'Antonio Vivaldi'
+      power 'subject:history and (spain or mexico) and not military and language:spanish'
+      publisher 'EMI'
+      sort 'inverse-pricerank'
+      title 'Harry Potter and the Chamber of Secrets'
+      truncate_reviews_at 0
+      variation_page 2
+      response_group('RelatedItems') do
+        related_item_page 2
+        relationship_type 'Episode'
+      end
+    end
+
+Required arguments and argument values vary depending upon how you use the API.
+For a full list of arguments and when they are required vs. optional, refer to
+Amazon's [ItemSearch documentation](http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/ItemSearch.html).
+
+### Item Lookup
+
+Once you have instantiated an `A2z::Client` instance, looking up a product can
+be done through the `item_lookup` method.
+
+    response = client.item_lookup do
+                 id '059035342X'
+               end
+
+The return value is an `A2z::Responses::ItemLookup` object.  The example above
+would make the following calls possible.
+
+    response.valid?
+    => true
+    
+    response.item
+    # => #<A2z::Responses::Item ...>
+    
+    response.operation_request
+    => #<A2z::Responses::OperationRequest ...>
+
+For more information on interacting with `A2z::Responses::Item` and
+`A2z::Responses::OperationRequest` objects, refer to their respective sections
+below.
+
+The following code is likely not a real-world example of how you would use
+the client to perform a lookup; it is only intended to demonstrate the full
+collection of methods provided when performing an item lookup.
+
+    client.item_lookup do
+      category 'Books'
+      id '059035342X'
+      id_type 'ASIN'
+      merchant_id 'SOME_MERCHANT_ID'
+      truncate_reviews_at 0
+      variation_page 2
+      response_group('RelatedItems') do
+        related_item_page 2
+        relationship_type 'Episode'
+      end
+    end
+
+Required arguments and argument values vary depending upon how you use the API.
+For a full list of arguments and when they are required vs. optional, refer to
+Amazon's [ItemLookup documentation](http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/ItemLookup.html).
+
+### Items
+
+Item lookup and item search response objects generally include one or more
+`A2z::Responses::Item` objects accessible via the `#item` and `#items`
+instance methods, respectively.
+
+For example:
+
+    response = client.item_search { ... }
+    => #<A2z::Responses::ItemSearch ...>
+    
+    item = response.items.first
+    => #<A2z::Responses::Item ...>
+    
+    item.asin
+    => "B008FERRFO"
+    
+    item.title
+    => "Away From The World (Deluxe Version)"
+    
+    item.artist
+    => "Dave Matthews Band"
+    
+    item.detail_page_url
+    => ""http://www.amazon.com/Away-From-World-Deluxe-Version/dp/B008FERRFO..."
+    
+    item.manufacturer
+    => "RCA"
+    
+    item.product_group
+    => "Music"
+
+Note that some attributes like `artist` and `manufacturer` are only set
+depending upon the type of item.  There is currently no way to determine which
+attributes have been set on an item object instance.  This issue will be
+addressed in the next gem release.
+
+### Operation Requests
+
+Item lookup and item search response objects include an
+`A2z::Responses::OperationRequest` accessible via the `#operation_request`
+instance method.
+
+For example:
+
+    response = client.item_lookup { ... }
+    => #<A2z::Responses::ItemLookup ...>
+    
+    response.operation_request.request_id
+    => "fc5d5321-a347-4e65-9483-9655e8d9cf16"
+    
+    response.operation_request.request_processing_time
+    => 0.087729
+    
+    response.operation_request.headers.class
+    => Hash
+    
+    response.operation_request.headers['UserAgent']
+    => "Jeff/0.4.3 (Language=Ruby; localhost)"
+    
+    response.operation_request.arguments.class
+    => Hash
+    
+    response.operation_request.arguments['Operation']
+    => "ItemSearch"
+
+## Contributing
+
+This gem is new, and as such is lacking a full feature-set for interacting with
+the Product Advertising API.  For example, many of the available
+[operations](http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/CHAP_OperationListAlphabetical.html)
+have not yet been implemented.
+
+Additionally, not much testing has been done yet, so there are many
+combinations of arguments that may result in errors or exceptions being
+thrown by the gem.
+
+As such, any and all external help is encouraged and much appreciated!
+
+To contribute:
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+A2z is released under the [MIT License](http://www.opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+
+Dir.glob('tasks/**/*.rake').each(&method(:import))
+
+task default: :spec

data/a2z.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/a2z/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.author        = 'Matt Huggins'
+  gem.email         = 'matt.huggins@gmail.com'
+  gem.description   = 'Ruby DSL for Amazon Product Advertising API'
+  gem.summary       = 'Ruby DSL for Amazon Product Advertising API'
+  gem.homepage      = 'https://github.com/mhuggins/a2z'
+  
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = 'a2z'
+  gem.require_path  = 'lib'
+  gem.version       = A2z::VERSION
+  
+  gem.add_dependency 'crack'
+  gem.add_dependency 'jeff'
+  
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec'
+end

data/lib/a2z.rb

@@ -0,0 +1,6 @@
+require 'a2z/blank_slate'
+require 'a2z/client'
+require 'a2z/helpers'
+require 'a2z/requests'
+require 'a2z/responses'
+require 'a2z/version'

data/lib/a2z/blank_slate.rb

@@ -0,0 +1,110 @@
+#!/usr/bin/env ruby
+#--
+# Copyright 2004, 2006 by Jim Weirich (jim@weirichhouse.org).
+# All rights reserved.
+
+# Permission is granted for use, copying, modification, distribution,
+# and distribution of modified versions of this work as long as the
+# above copyright notice is included.
+#++
+
+######################################################################
+# BlankSlate provides an abstract base class with no predefined
+# methods (except for <tt>\_\_send__</tt> and <tt>\_\_id__</tt>).
+# BlankSlate is useful as a base class when writing classes that
+# depend upon <tt>method_missing</tt> (e.g. dynamic proxies).
+#
+class BlankSlate
+  class << self
+    
+    # Hide the method named +name+ in the BlankSlate class.  Don't
+    # hide +instance_eval+ or any method beginning with "__".
+    def hide(name)
+      methods = instance_methods.map(&:to_sym)
+      if methods.include?(name.to_sym) and
+        name !~ /^(__|instance_eval|object_id)/
+        @hidden_methods ||= {}
+        @hidden_methods[name.to_sym] = instance_method(name)
+        undef_method name
+      end
+    end
+    
+    def find_hidden_method(name)
+      @hidden_methods ||= {}
+      @hidden_methods[name] || superclass.find_hidden_method(name)
+    end
+    
+    # Redefine a previously hidden method so that it may be called on a blank
+    # slate object.
+    def reveal(name)
+      hidden_method = find_hidden_method(name)
+      fail "Don't know how to reveal method '#{name}'" unless hidden_method
+      define_method(name, hidden_method)
+    end
+  end
+  
+  instance_methods.each { |m| hide(m) }
+end
+
+######################################################################
+# Since Ruby is very dynamic, methods added to the ancestors of
+# BlankSlate <em>after BlankSlate is defined</em> will show up in the
+# list of available BlankSlate methods.  We handle this by defining a
+# hook in the Object and Kernel classes that will hide any method
+# defined after BlankSlate has been loaded.
+#
+module Kernel
+  class << self
+    alias_method :blank_slate_method_added, :method_added
+    
+    # Detect method additions to Kernel and remove them in the
+    # BlankSlate class.
+    def method_added(name)
+      result = blank_slate_method_added(name)
+      return result if self != Kernel
+      BlankSlate.hide(name)
+      result
+    end
+  end
+end
+
+######################################################################
+# Same as above, except in Object.
+#
+class Object
+  class << self
+    alias_method :blank_slate_method_added, :method_added
+    
+    # Detect method additions to Object and remove them in the
+    # BlankSlate class.
+    def method_added(name)
+      result = blank_slate_method_added(name)
+      return result if self != Object
+      BlankSlate.hide(name)
+      result
+    end
+    
+    def find_hidden_method(name)
+      nil
+    end
+  end
+end
+
+######################################################################
+# Also, modules included into Object need to be scanned and have their
+# instance methods removed from blank slate.  In theory, modules
+# included into Kernel would have to be removed as well, but a
+# "feature" of Ruby prevents late includes into modules from being
+# exposed in the first place.
+#
+class Module
+  alias blankslate_original_append_features append_features
+  def append_features(mod)
+    result = blankslate_original_append_features(mod)
+    return result if mod != Object
+    instance_methods.each do |name|
+      BlankSlate.hide(name)
+    end
+    result
+  end
+end

data/lib/a2z/client.rb

@@ -0,0 +1,65 @@
+require 'jeff'
+require 'crack/xml'
+
+module A2z
+  class Client
+    ErrorResponse = Class.new(ArgumentError)
+    
+    include Jeff
+    
+    attr_reader :country, :tag
+    
+    HOSTS = {
+        ca: 'ecs.amazonaws.ca',
+        cn: 'webservices.amazon.cn',
+        de: 'ecs.amazonaws.de',
+        es: 'webservices.amazon.es',
+        fr: 'ecs.amazonaws.fr',
+        it: 'webservices.amazon.it',
+        jp: 'ecs.amazonaws.jp',
+        uk: 'ecs.amazonaws.co.uk',
+        us: 'ecs.amazonaws.com',
+    }.freeze
+    
+    params 'AssociateTag' => -> { tag },
+           'Service'      => 'AWSECommerceService',
+           'Version'      => '2011-08-01'
+    
+    def initialize(opts = {})
+      self.country  = opts.fetch(:country, :us)
+      self.key      = opts[:key]
+      self.secret   = opts[:secret]
+      self.tag      = opts[:tag]
+    end
+    
+    def country=(code)
+      raise ArgumentError.new("Country code must be one of #{HOSTS.keys.join(', ')}.") if code.nil? || HOSTS[code.to_sym].nil?
+      @country = code.to_sym
+      @endpoint = "http://#{HOSTS[@country]}/onca/xml"
+    end
+    
+    def item_search(&block)
+      response = request(Requests::ItemSearch.new(&block))
+      Responses::ItemSearch.from_response(response)
+    end
+    
+    def item_lookup(&block)
+      response = request(Requests::ItemLookup.new(&block))
+      Responses::ItemLookup.from_response(response)
+    end
+    
+    private
+    
+    def tag=(tag)
+      @tag = tag
+    end
+    
+    def request(req)
+      response = get(query: req.params)
+      response = Crack::XML.parse(response.body)
+      
+      # strip the root xml node
+      response.values.first
+    end
+  end
+end

data/lib/a2z/helpers.rb

@@ -0,0 +1,18 @@
+module A2z
+  module Helpers
+    def self.included(base)
+      base.extend(self)
+    end
+    
+    protected
+    
+    def underscore(camel_cased_word)
+      camel_cased_word.dup.tap do |word|
+        word.gsub!(/([A-Z\d]+)([A-Z][a-z])/, '\1_\2')
+        word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+        word.tr!('-', '_')
+        word.downcase!
+      end
+    end
+  end
+end

data/lib/a2z/requests.rb

@@ -0,0 +1,3 @@
+require 'a2z/requests/item_lookup'
+require 'a2z/requests/item_search'
+require 'a2z/requests/response_group'

data/lib/a2z/requests/item_lookup.rb

@@ -0,0 +1,42 @@
+module A2z
+  module Requests
+    class ItemLookup < BlankSlate
+      include Helpers
+      
+      attr_reader :params
+      
+      def initialize(&block)
+        @params = { 'Operation' => 'ItemLookup' }
+        instance_eval(&block) if block_given?
+      end
+      
+      %w(Condition IdType MerchantId TruncateReviewsAt VariationPage).each do |param|
+        method = underscore(param)
+        
+        class_eval <<-END, __FILE__, __LINE__
+          def #{method}(value)
+            @params['#{param}'] = value
+          end
+        END
+      end
+      
+      def id(value)
+        value = value.join(',') if value.kind_of?(Array)
+        @params['ItemId'] = value
+      end
+      
+      def category(value)
+        @params['SearchIndex'] = value
+      end
+      
+      def response_group(value, &block)
+        response_group = ResponseGroup.new(value, &block)
+        @params.merge!(response_group.params)
+      end
+      
+      def include_reviews_summary(value)
+        @params['IncludeReviewsSummary'] = value ? 'True' : 'False'
+      end
+    end
+  end
+end

data/lib/a2z/requests/item_search.rb

@@ -0,0 +1,45 @@
+module A2z
+  module Requests
+    class ItemSearch < BlankSlate
+      include Helpers
+      
+      attr_reader :params
+      
+      def initialize(&block)
+        @params = { 'Operation' => 'ItemSearch' }
+        instance_eval(&block) if block_given?
+      end
+      
+      %w(Actor Artist AudienceRating Author Brand BrowseNode Composer Conductor
+         Condition Director ItemPage Manufacturer MaximumPrice MerchantId
+         MinimumPrice MinPercentageOff MusicLabel Orchestra Power Publisher
+         Sort Title TruncateReviewsAt VariationPage).each do |param|
+        method = underscore(param)
+        
+        class_eval <<-END, __FILE__, __LINE__
+          def #{method}(value)
+            @params['#{param}'] = value
+          end
+        END
+      end
+      
+      def keywords(value)
+        value = value.join(' ') if value.kind_of?(Array)
+        @params['Keywords'] = value
+      end
+      
+      def category(value)
+        @params['SearchIndex'] = value
+      end
+      
+      def response_group(value, &block)
+        response_group = ResponseGroup.new(value, &block)
+        @params.merge!(response_group.params)
+      end
+      
+      def include_reviews_summary(value)
+        @params['IncludeReviewsSummary'] = value ? 'True' : 'False'
+      end
+    end
+  end
+end

data/lib/a2z/requests/response_group.rb

@@ -0,0 +1,20 @@
+module A2z
+  module Requests
+    class ResponseGroup < BlankSlate
+      attr_reader :params
+      
+      def initialize(value, &block)
+        @params = { 'ResponseGroup' => value }
+        instance_eval(&block) if block_given?
+      end
+      
+      def related_item_page(value)
+        @params['RelatedItemPage'] = value
+      end
+      
+      def relationship_type(value)
+        @params['RelationshipType'] = value
+      end
+    end
+  end
+end

data/lib/a2z/responses.rb

@@ -0,0 +1,5 @@
+require 'a2z/responses/item'
+require 'a2z/responses/item_link'
+require 'a2z/responses/item_lookup'
+require 'a2z/responses/item_search'
+require 'a2z/responses/operation_request'

data/lib/a2z/responses/item.rb

@@ -0,0 +1,35 @@
+module A2z
+  module Responses
+    class Item
+      include Helpers
+      
+      attr_accessor :asin, :detail_page_url, :links
+      
+      def initialize
+        @links = []
+      end
+      
+      def []=(key, value)
+        instance_variable_set("@#{key}".to_sym, value)
+        self.class.class_eval { attr_reader key.to_sym }
+      end
+      
+      def self.from_response(data)
+        new.tap do |item|
+          item.asin = data['ASIN']
+          item.detail_page_url = data['DetailPageURL']
+          
+          if data['ItemLinks']
+            item.links = data['ItemLinks']['ItemLink'].collect { |link| ItemLink.from_response(link) }
+          end
+          
+          if data['ItemAttributes']
+            data['ItemAttributes'].each { |key, value| item[underscore(key)] = value }
+          end
+          
+          item.freeze
+        end
+      end
+    end
+  end
+end

data/lib/a2z/responses/item_link.rb

@@ -0,0 +1,15 @@
+module A2z
+  module Responses
+    class ItemLink
+      attr_accessor :description, :url
+      
+      def self.from_response(data)
+        new.tap do |item_link|
+          item_link.description = data['Description']
+          item_link.url = data['URL']
+          item_link.freeze
+        end
+      end
+    end
+  end
+end

data/lib/a2z/responses/item_lookup.rb

@@ -0,0 +1,30 @@
+module A2z
+  module Responses
+    class ItemLookup
+      attr_accessor :operation_request, :item, :valid
+      
+      def initialize
+        @valid = true
+      end
+      
+      def valid?
+        @valid
+      end
+      
+      def valid=(value)
+        @valid = !!value
+      end
+      
+      # TODO capture item_search_response['Items']['Request']['Errors'] into an attr_accessor value
+      # TODO consider capturing item_search_response['Items']['Request'] into an attr_accessor value
+      def self.from_response(data)
+        new.tap do |item_lookup|
+          item_lookup.operation_request = OperationRequest.from_response(data['OperationRequest']) if data['OperationRequest']
+          item_lookup.item              = Item.from_response(data['Items']['Item']) if data['Items'] && data['Items']['Item']
+          item_lookup.valid             = data['Items']['Request']['IsValid'] == 'True' rescue false
+          item_lookup.freeze
+        end
+      end
+    end
+  end
+end

data/lib/a2z/responses/item_search.rb

@@ -0,0 +1,44 @@
+module A2z
+  module Responses
+    class ItemSearch
+      attr_accessor :operation_request, :items, :total_results, :total_pages, :more_search_results_url, :valid
+      
+      def initialize
+        @items = []
+        @total_results = 0
+        @total_pages = 0
+        @valid = true
+      end
+      
+      def valid?
+        @valid
+      end
+      
+      def valid=(value)
+        @valid = !!value
+      end
+      
+      # TODO capture item_search_response['Items']['Request']['Errors'] into an attr_accessor value
+      # TODO consider capturing item_search_response['Items']['Request'] into an attr_accessor value
+      def self.from_response(data)
+        new.tap do |item_search|
+          item_search.operation_request       = OperationRequest.from_response(data['OperationRequest']) if data['OperationRequest']
+          item_search.items                   = items_from_response(data)
+          item_search.total_results           = data['Items']['TotalResults'].to_i rescue 0
+          item_search.total_pages             = data['Items']['TotalPages'].to_i rescue 0
+          item_search.more_search_results_url = data['Items']['MoreSearchResultsUrl'] rescue nil
+          item_search.valid                   = data['Items']['Request']['IsValid'] == 'True' rescue false
+          item_search.freeze
+        end
+      end
+      
+      private
+      
+      def self.items_from_response(data)
+        items = data['Items']['Item'] rescue []
+        items = [items].compact unless items.kind_of?(Array)
+        items.collect { |item| Item.from_response(item) }
+      end
+    end
+  end
+end

data/lib/a2z/responses/operation_request.rb

@@ -0,0 +1,35 @@
+module A2z
+  module Responses
+    class OperationRequest
+      attr_accessor :request_id, :request_processing_time, :headers, :arguments
+      
+      def initialize
+        @headers = []
+        @arguments = []
+      end
+      
+      def self.from_response(data)
+        new.tap do |operation_request|
+          operation_request.request_id = data['RequestId']
+          operation_request.request_processing_time = data['RequestProcessingTime'].to_f
+          
+          if data['HTTPHeaders']
+            headers = data['HTTPHeaders']['Header']
+            headers = [headers] unless headers.kind_of?(Array)
+            headers = headers.collect { |h| [ h['Name'], h['Value'] ] }
+            operation_request.headers = Hash[headers]
+          end
+          
+          if data['Arguments']
+            arguments = data['Arguments']['Argument']
+            arguments = [arguments] unless arguments.kind_of?(Array)
+            arguments = arguments.collect { |a| [ a['Name'], a['Value'] ] }
+            operation_request.arguments = Hash[arguments]
+          end
+          
+          operation_request.freeze
+        end
+      end
+    end
+  end
+end

data/lib/a2z/version.rb

@@ -0,0 +1,3 @@
+module A2z
+  VERSION = '0.0.1'
+end

data/spec/a2z/client_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe A2z::Client do
+  describe '#initialize' do
+    subject do
+      A2z::Client
+    end
+    
+    context 'when country is not specified' do
+      specify { expect { subject.new }.to_not raise_error }
+    end
+    
+    context 'when country is valid' do
+      specify { expect { subject.new(country: :us) }.to_not raise_error }
+    end
+    
+    context 'when country is invalid' do
+      specify { expect { subject.new(country: :fake) }.to raise_error }
+    end
+  end
+  
+  describe '#country=' do
+    it 'should succeed'
+  end
+  
+  describe '#country' do
+    it 'should succeed'
+  end
+  
+  describe '#tag' do
+    it 'should succeed'
+  end
+  
+  describe '#item_search' do
+    subject do
+      A2z::Client.new
+    end
+    
+    it 'should succeed'
+  end
+  
+  describe '#item_lookup' do
+    subject do
+      A2z::Client.new
+    end
+    
+    it 'should succeed'
+  end
+end

data/spec/a2z/requests/item_lookup_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe A2z::Requests::ItemLookup do
+  subject do
+    A2z::Requests::ItemLookup.new(&block)
+  end
+  
+  let(:block) { Proc.new { } }
+  
+  describe '#params' do
+    it 'should return a hash'
+  end
+end

data/spec/a2z/requests/item_search_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe A2z::Requests::ItemSearch do
+  subject do
+    A2z::Requests::ItemSearch.new(&block)
+  end
+  
+  let(:block) { Proc.new { } }
+  
+  describe '#params' do
+    it 'should return a hash'
+  end
+end

data/spec/a2z/requests/response_group_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe A2z::Requests::ResponseGroup do
+  subject do
+    A2z::Requests::ResponseGroup.new(value, &block)
+  end
+  
+  let(:value) { nil }
+  let(:block) { Proc.new { } }
+  
+  describe '#params' do
+    it 'should return a hash'
+  end
+end

data/spec/a2z/responses/item_link_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe A2z::Responses::ItemLink do
+  subject do
+    A2z::Responses::ItemLink.from_response(item_hash)
+  end
+  
+  let(:item_hash) { Hash.new }
+  
+  describe '.from_response' do
+    it 'should return an item link object'
+  end
+end

data/spec/a2z/responses/item_lookup_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe A2z::Responses::ItemLookup do
+  subject do
+    A2z::Responses::ItemLookup.from_response(item_hash)
+  end
+  
+  let(:item_hash) { Hash.new }
+  
+  describe '.from_response' do
+    it 'should return an item lookup object'
+  end
+end

data/spec/a2z/responses/item_search_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe A2z::Responses::ItemSearch do
+  subject do
+    A2z::Responses::ItemSearch.from_response(item_hash)
+  end
+  
+  let(:item_hash) { Hash.new }
+  
+  describe '.from_response' do
+    it 'should return an item search object'
+  end
+end

data/spec/a2z/responses/item_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe A2z::Responses::Item do
+  subject do
+    A2z::Responses::Item.from_response(item_hash)
+  end
+  
+  let(:item_hash) { Hash.new }
+  
+  describe '.from_response' do
+    it 'should return an item object'
+  end
+  
+  describe '#asin' do
+    it 'should return string'
+  end
+  
+  describe '#detail_page_url' do
+    it 'should return string'
+  end
+  
+  describe '#links' do
+    it 'should return array of item links'
+  end
+end

data/spec/a2z/version_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe A2z do
+  subject { A2z }
+  
+  specify { subject::VERSION.should == '0.0.1' }
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'a2z'

data/tasks/debug.rake

@@ -0,0 +1,4 @@
+desc 'Open an irb session preloaded with this library'
+task :console do
+  sh 'irb -rubygems -I lib -r a2z.rb'
+end

data/tasks/rspec.rake

@@ -0,0 +1,3 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification 
+name: a2z
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matt Huggins
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-12-27 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: crack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: jeff
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: Ruby DSL for Amazon Product Advertising API
+email: matt.huggins@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- a2z.gemspec
+- lib/a2z.rb
+- lib/a2z/blank_slate.rb
+- lib/a2z/client.rb
+- lib/a2z/helpers.rb
+- lib/a2z/requests.rb
+- lib/a2z/requests/item_lookup.rb
+- lib/a2z/requests/item_search.rb
+- lib/a2z/requests/response_group.rb
+- lib/a2z/responses.rb
+- lib/a2z/responses/item.rb
+- lib/a2z/responses/item_link.rb
+- lib/a2z/responses/item_lookup.rb
+- lib/a2z/responses/item_search.rb
+- lib/a2z/responses/operation_request.rb
+- lib/a2z/version.rb
+- spec/a2z/client_spec.rb
+- spec/a2z/requests/item_lookup_spec.rb
+- spec/a2z/requests/item_search_spec.rb
+- spec/a2z/requests/response_group_spec.rb
+- spec/a2z/responses/item_link_spec.rb
+- spec/a2z/responses/item_lookup_spec.rb
+- spec/a2z/responses/item_search_spec.rb
+- spec/a2z/responses/item_spec.rb
+- spec/a2z/version_spec.rb
+- spec/spec_helper.rb
+- tasks/debug.rake
+- tasks/rspec.rake
+has_rdoc: true
+homepage: https://github.com/mhuggins/a2z
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby DSL for Amazon Product Advertising API
+test_files: 
+- spec/a2z/client_spec.rb
+- spec/a2z/requests/item_lookup_spec.rb
+- spec/a2z/requests/item_search_spec.rb
+- spec/a2z/requests/response_group_spec.rb
+- spec/a2z/responses/item_link_spec.rb
+- spec/a2z/responses/item_lookup_spec.rb
+- spec/a2z/responses/item_search_spec.rb
+- spec/a2z/responses/item_spec.rb
+- spec/a2z/version_spec.rb
+- spec/spec_helper.rb