dpickett-ramazon_advertising 0.1.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,7 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+features/support/ramazon_advertising.yml
+features/support/root_nodes.yml

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Dan Pickett
+
+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.rdoc

@@ -0,0 +1,44 @@
+= ramazon_advertising
+
+Ruby + Amazon Advertising == Car RAmazon_Advertising - Say Car RAmazon_Advertising!
+
+Ruh roh' Rorge it's an object oriented approach to Amazon's overly complicated product api that has a new name every 2 weeks. 
+
+Complete with the ability to use nokogiri selectors for results
+
+Currently only supports product search and retrieval. Requests are signed properly. More soon!
+
+  Ramazon::Configuration.access_key = "Your Access Key"
+  Ramazon::Configuration.secret_key = "Your Secret Key"
+
+  @products = Ramazon::Product.find(:item_id => "B000NU2CY4", :response_group => "Medium")
+  @products[0].title
+  @products[0].asin
+  @products[0].upc
+  @products[0].large_image.url
+  @products[0].url
+
+  #you can also use a nokogiri search string to get elements that don't have built-in accessors
+  @products[0].get("ItemAttributes Actor").collect{|a| a.content}
+
+== What's under the hood?
+
+* HTTParty
+* HappyMapper
+* will_paginate 
+* nokogiri
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Dan Pickett. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,85 @@
+require 'rubygems'
+require 'rake'
+
+require 'lib/ramazon_advertising'
+load File.join(File.dirname(__FILE__), 'lib', 'tasks', 'ramazon.rake')
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "ramazon_advertising"
+    gem.summary = %Q{TODO: one-line summary of your gem}
+    gem.description = %Q{TODO: longer description of your gem}
+    gem.email = "dpickett@enlightsolutions.com"
+    gem.homepage = "http://github.com/dpickett/ramazon_advertising"
+    gem.authors = ["Dan Pickett"]
+    gem.add_dependency("jnunemaker-httparty", ">= 0.4.3")
+    gem.add_dependency("jnunemaker-happymapper", ">= 0.2.5")
+    gem.add_dependency("mislav-will_paginate", ">= 2.3.11")
+    gem.add_dependency("nokogiri", ">= 1.3.3")
+    gem.add_dependency("configatron", ">= 2.4.1")   
+    gem.add_dependency("rails", ">= 2.3.3")
+    gem.add_dependency("ruby-hmac", ">= 0.3.2")
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:cucumber)
+rescue LoadError
+  task :cucumber do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "ramazon_advertising #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require "YARD"
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  YARD::Rake::YardocTask.new do |t|
+  end
+rescue LoadError
+
+end
+
+

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/features/friendly_errors.feature

@@ -0,0 +1,15 @@
+@errors
+Feature: Friendly errors
+  As a user of ramazon_advertising
+  I want to get friendly error messages
+  So that I know I did something wrong
+
+  Background: 
+    Given I have a valid access key
+    And I have a valid secret key
+
+  Scenario: I don't specify a keyword for search
+    When I perform the product search
+    Then I should get an error
+    And the error should have a "code" of "AWS.MinimumParameterRequirement"
+    And the error should have a "message"

data/features/generate_root_browse_nodes.feature

@@ -0,0 +1,12 @@
+Feature: As a user of the Ramazon Advertising API
+  I want a list of browse nodes
+  So that I have starting points for browse node traversal
+
+  Scenario: Retrieving browse nodes
+    Given I want browse nodes to be stored in a temporary file
+    And the browse node temporary file doesn't exist
+    When I retrieve root nodes
+    Then I should get a temporary file for root nodes
+    And I should have a "Books" root node
+    And I should have a "Grocery" root node
+    And I should have a list of root nodes

data/features/retrieving_a_product.feature

@@ -0,0 +1,23 @@
+Feature: Retrieving a product
+  As a user of the Ramazon_advertising_api
+  I want to get specific information
+  In order to leverage the data provided by the api
+  
+  Background:
+    Given I have a valid access key
+    And I have a valid secret key
+
+    When I try to find the asin "B000NU2CY4"
+    Then I should get a product
+    And the product should have the "title" "Gladiator [Blu-ray]"
+    And the product should have a "manufacturer"
+    And the product should have a "product_group"
+    And the product should have a "sales_rank"
+    And the product should have a "large_image"
+    And the product should have a "list_price"
+    And the product should have a "upc"
+    And the product should have a "lowest_new_price"
+    And the product should have a "new_count"
+    And the product should have a "used_count"
+
+  

data/features/searching_for_products.feature

@@ -0,0 +1,15 @@
+Feature: Search for products
+  As a user of the Ramazon_advertising api
+  I want to perform a search
+  In order to find products my customers will want to purchase
+
+  Background:
+    Given I have a valid access key
+    And I have a valid secret key
+
+    Given I am searching with the "search_index" of "DVD"
+    And I am searching with the "browse_node" of "130"
+    When I perform the product search
+    Then I should get a list of products
+    And the list of products should have more than 1 product
+    And each product should have the "product_group" "DVD"

data/features/step_definitions/auth_steps.rb

@@ -0,0 +1,8 @@
+Given /^I have a valid access key$/ do
+  configatron.ramazon.access_key.should_not be_nil
+end
+
+Given /^I have a valid secret key$/ do
+  configatron.ramazon.secret_key.should_not be_nil
+end
+

data/features/step_definitions/browse_node_steps.rb

@@ -0,0 +1,36 @@
+Given /^I want browse nodes to be stored in a temporary file$/ do
+  @browse_root_filename = File.join(File.dirname(__FILE__), '..', 'support', 'root_nodes.yml')
+end
+
+Given /^the browse node temporary file doesn't exist$/ do
+  FileUtils.rm_f @browse_root_filename
+end
+
+When /^I retrieve root nodes$/ do
+  if @browse_root_filename
+    Ramazon::BrowseNode.generate_root_nodes @browse_root_filename
+  else
+    Ramazon::BrowseNode.generate_root_nodes
+  end
+end
+
+Then /^I should get a temporary file for root nodes$/ do
+  FileTest.exists?(@browse_root_filename).should be_true
+end
+
+Then /^I should have a "([^\"]*)" root node$/ do |name|
+  get_root_nodes[name].should_not be_nil
+end
+
+Then /^I should have a list of root nodes$/ do
+  get_root_nodes.should_not be_empty
+end
+
+def get_root_nodes
+  if @browse_root_filename
+    nodes = Ramazon::BrowseNode.root_nodes(@browse_root_filename)
+  else
+    nodes = Ramazon::BrowseNode.root_nodes
+  end
+
+end

data/features/step_definitions/error_steps.rb

@@ -0,0 +1,14 @@
+Then /^I should get an error$/ do
+  @error.should_not be_nil
+end
+
+Then /^the error should have a "([^\"]*)" of "([^\"]*)"$/ do |attr, value|
+  @error.send(attr).should eql(value)
+end
+
+Then /^the error should have a "([^\"]*)"$/ do |attr|
+  @error.send(attr).should_not be_nil
+end
+
+
+

data/features/step_definitions/product_steps.rb

@@ -0,0 +1,48 @@
+When /^I try to find the asin "([^\"]*)"$/ do |asin|
+  @products = Ramazon::Product.find(:item_id => asin, :response_group => "Medium")
+  @product = @products[0]
+end
+
+Given /^I am searching with the "([^\"]*)" of "([^\"]*)"$/ do |attr, value|
+  @search_options ||= {}
+  @search_options[attr] = value
+end
+
+When /^I perform the product search$/ do
+  begin
+    @search_options ||= {}
+    @products = Ramazon::Product.find(@search_options)
+  rescue Ramazon::Error => e
+    @error = e
+  end
+end
+
+Then /^I should get a list of products$/ do
+  raise @error if @error
+  @products.should_not be_empty
+end
+
+Then /^the list of products should have more than (\d+) product$/ do |count|
+  @products.should have_at_least(count.to_i + 1).items
+end
+
+
+Then /^each product should have the "([^\"]*)" "([^\"]*)"$/ do |attr, value|
+  @products.each do |p|
+    p.send(attr).should eql(value)
+  end
+end
+
+Then /^I should get a product$/ do
+  raise @error if @error
+  @product.should_not be_nil
+end
+
+Then /^the product should have the "([^\"]*)" "([^\"]*)"$/ do |attr, value|
+  @product.send(attr).should eql(value)
+end
+
+Then /^the product should have a "([^\"]*)"$/ do |attr|
+  @product.send(attr).should_not be_nil
+end
+

data/features/support/env.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__) + '..', '..', 'lib'))
+require 'lib/ramazon_advertising'
+
+require 'spec/expectations'
+
+configatron.ramazon.configure_from_yaml(File.join(File.dirname(__FILE__), "ramazon_advertising.yml"))
+

data/features/support/ramazon_advertising.example.yml

@@ -0,0 +1,2 @@
+access_key: SOMETHING
+secret_key: SOMETHING SECRET

data/lib/ramazon/abstract_element.rb

@@ -0,0 +1,18 @@
+module Ramazon
+  module AbstractElement
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+      def abstract_element(name, type, options = {})
+        element(name, type, options.merge(:parser => :abstract_parse, :raw => true))
+      end
+
+      def abstract_parse(xml, options = {})
+        tag XML::Parser.string(xml).parse.root.name
+        parse(xml)
+      end
+    end
+  end
+end

data/lib/ramazon/browse_node.rb

@@ -0,0 +1,32 @@
+module Ramazon
+  class BrowseNode
+    include HTTParty
+
+    DEFAULT_ROOT_FILE = File.join(File.dirname(__FILE__), '..', 'root_nodes.yml')
+    def self.generate_root_nodes(file_name = DEFAULT_ROOT_FILE)
+      if Ramazon::Configuration.locale == :us
+        doc = Nokogiri::HTML(get('http://www.amazon.com').body)
+        root_nodes = {}
+        doc.search(".navSaMenu .navSaChildItem a").each do |element|
+          if element["href"] =~ /node=(\d+)\&/
+            root_nodes[element.content] = $1
+          end
+        end
+
+        unless root_nodes.empty?
+          FileUtils.rm_f(file_name)
+          File.open(file_name, 'w') do |f|
+            f.write(root_nodes.to_yaml)
+          end
+        end
+      else
+        #todo correlate ECS locales to actual amazon.* urls
+        raise "generating root nodes for locale's other than the US is not supported"
+      end
+    end
+
+    def self.root_nodes(file_name = DEFAULT_ROOT_FILE)
+      @root_nodes ||= File.open(file_name) { |yf| YAML::load(yf) }
+    end
+  end
+end

data/lib/ramazon/configuration.rb

@@ -0,0 +1,66 @@
+module Ramazon
+  # the class that persists configuration information for Amazon requests
+  class Configuration
+    class << self
+      LOCALES = [:ca, :de, :fr, :jp, :uk, :us]
+
+      # set the locale for future requests
+      # will raise an exception if the locale isn't in the Configuration::LOCALES collection
+      def locale=(locale)
+        if LOCALES.include?(locale)
+          configatron.ramazon.locale = locale
+        else
+          raise "unknown locale"
+        end
+      end
+
+      # get the current locale (defaults to the us)
+      def locale
+        configatron.ramazon.locale || :us
+      end
+
+      # get the current access key
+      def access_key
+        configatron.ramazon.access_key
+      end
+
+      # set the current access key
+      # @param key [String] access key you're using to access the advertising api
+      def access_key=(key)
+        configatron.ramazon.access_key = key
+      end
+
+      # get the current secret key that is used for request signing
+      def secret_key
+        configatron.ramazon.secret_key
+      end
+
+      # set the secret key so that requests can be appropriately signed
+      # @param key [String] secret key you're using to sign advertising requests
+      def secret_key=(key)
+        configatron.ramazon.secret_key = key
+      end
+
+      # get the correct host based on your locale
+      def base_uri
+        if locale == :us
+          "http://ecs.amazonaws.com"
+        else
+          "http://ecs.amazonaws.#{locale}"
+        end
+      end
+
+      # get the full path including locale specific host and /onca/xml path
+      def uri
+        "#{base_uri}#{path}"
+      end
+
+      # get the path where requests should be dispatched to
+      def path
+        "/onca/xml"
+      end
+
+      
+    end
+  end
+end

data/lib/ramazon/error.rb

@@ -0,0 +1,12 @@
+module Ramazon
+  class Error < StandardError
+    include HappyMapper
+    tag "Error"
+    element :code, String, :tag => "Code"
+    element :message, String, :tag => "Message"
+
+    def to_s
+      "#{self.code}: #{self.message}"
+    end
+  end
+end

data/lib/ramazon/image.rb

@@ -0,0 +1,18 @@
+module Ramazon
+  # An image object returned by Amazon's product data
+  # Available accessors include
+  # +url+::
+  #   The url of the image
+  # +height+::
+  #   The height of the image
+  # +width+::
+  #   The width of the image 
+  class Image
+    include HappyMapper
+    include Ramazon::AbstractElement
+    tag "Image"
+    element :url, String, :tag => "URL"
+    element :height, Integer, :tag => "Height"
+    element :width, Integer, :tag => "Width" 
+  end
+end

data/lib/ramazon/price.rb

@@ -0,0 +1,18 @@
+module Ramazon
+  # A price object returned by Amazon's product data
+  # Available accessors include
+  # +amount+::
+  #   The unformatted ammount of the price
+  # +currency_code+::
+  #   The currency of the offer
+  # +formatted_price+::
+  #   The formatted price of the offer
+  class Price
+    include HappyMapper
+    include Ramazon::AbstractElement
+
+    element :amount, String, :tag => "Amount"
+    element :currency_code, String, :tag => "CurrencyCode"
+    element :formatted_price, String, :tag => "FormattedPrice"
+  end
+end

data/lib/ramazon/product.rb

@@ -0,0 +1,144 @@
+module Ramazon
+  # Find and get product details with this class
+  # Currently supports the following accessors 
+  # (all other elements can be accessed via nokogiri selectors and the get method)
+  # +asin+::
+  #   Amazon Identifier
+  # +upc+::
+  #   UPC ID
+  # +title+::
+  #   Title of the product
+  # +product_group+::
+  #   The category/product_group of the product
+  # +manufacturer+::
+  #   The manufacturer of the product
+  # +brand+::
+  #   The brand of the product
+  # +url+::
+  #   The Amazon URL of the product
+  # +small_image+::
+  #   The small image that Amazon provides (NOTE: Returns Ramazon::Image object)
+  # +medium_image+::
+  #   The medium image that Amazon provides (NOTE: Returns Ramazon::Image object)
+  # +large_image+::
+  #   The large image that Amazon provides (NOTE: Returns Ramazon::Image object)
+  # +list_price+::
+  #   The list price of the item (NOTE: Returns Ramazon::Price object)
+  # +lowest_new_price+::
+  #   The lowest new price from the offer summary (NOTE: Returns Ramazon::Price object)
+  # +sales_rank+::
+  #   The sales rank of the product
+  # +new_count+::
+  #   The quantity of new item offers
+  # +used_count+::
+  #   The quantity of used item offers
+  # +collectible_count+::
+  #   The quantity of collectible item offers
+  # +refurbished_count+::
+  #   The quantity of refurbished item offers
+  # +release_date+::
+  #   The release date of the product
+  # +original_release_date+::
+  #   The original release date of the product
+  # @example find an individual item
+  # @products = Ramazon::Product.find(:item_id => "B000NU2CY4", :response_group => "Medium")
+  # @products[0].title
+  # @products[0].asin
+  # @products[0].upc
+  # @products[0].large_image.url
+  # @products[0].url
+  #
+
+  class Product
+    include HappyMapper
+    include Ramazon::AbstractElement
+    tag 'Item'
+
+    element :asin, String, :tag => 'ASIN'
+    element :upc, String, :tag => 'ItemAttributes/UPC'
+    element :title, String, :tag => 'Title', :deep => true
+    element :product_group, String, :tag => 'ItemAttributes/ProductGroup'
+    element :manufacturer, String, :tag => 'ItemAttributes/Manufacturer'
+    element :brand, String, :tag => 'ItemAttributes/Brand'
+    element :url, String, :tag => 'DetailPageURL'
+    abstract_element :small_image, Ramazon::Image, :tag => "SmallImage"
+    abstract_element :large_image, Ramazon::Image, :tag => "LargeImage"
+    abstract_element :medium_image, Ramazon::Image, :tag => "MediumImage"
+    abstract_element :tiny_image, Ramazon::Image, :tag => "TinyImage"
+    abstract_element :thumb_image, Ramazon::Image, :tag => "ThumbImage"
+    abstract_element :list_price, Ramazon::Price, :tag => "ItemAttributes/ListPrice"
+    abstract_element :lowest_new_price, Ramazon::Price, :tag => "OfferSummary/LowestNewPrice"
+
+    element :sales_rank, Integer, :tag => "SalesRank"
+
+    element :new_count, Integer, :tag => "OfferSummary/TotalNew"
+    element :used_count, Integer, :tag => "OfferSummary/TotalUsed"
+    element :collectible_count, Integer, :tag => "OfferSummary/TotalCollectible"
+    element :refurbished_count, Integer, :tag => "OfferSummary/TotalRefurbished"
+
+    element :release_date, Date, :tag => 'ItemAttributes/ReleaseDate'
+    element :original_release_date, Date, :tag => 'ItemAttributes/OriginalReleaseDate'
+
+
+    # Creates the worker that performs the delta indexing
+    # @param options Amazon request options (you can use an underscore convention) 
+    # (ie. passing the :response_group option will be converted to "ResponseGroup")
+    # <tt>:item_id</tt> - the ASIN or UPC you're looking for
+    # @return [Array] array of Ramazon::Product objects
+    def self.find(*args)
+      options = args.extract_options!
+      if options[:item_id]
+        item_lookup(options[:item_id], options)
+      else
+        options[:operation] ||= "ItemSearch"
+        options[:search_index] ||= "Blended"
+        options[:item_page] ||= 1
+        res = Ramazon::Request.new(options).submit
+        Ramazon::ProductCollection.create_from_results(options[:item_page] || 1, 10, res)
+      end
+    end
+
+    # Performs an item lookup
+    # @param item_id the ASIN or UPC you're looking for
+    # @options additional Amazon request options (i.e. :response_group)
+    def self.item_lookup(item_id, options = {})
+      req = Ramazon::Request.new({:item_id => item_id, 
+        :operation => "ItemLookup"}.merge(options))
+      res = req.submit
+
+      Ramazon::ProductCollection.create_from_results(1,1,res)
+    end
+
+    # assembles the available images for the object
+    # @return [Hash] hash of symbolized image_name => Ramazon::Image pairs
+    def images
+      if !@images
+        @images = {}
+        @images[:thumb] = self.thumb_image if self.thumb_image
+        @images[:tiny_image] = self.tiny_image if self.tiny_image
+        @images[:small] = self.small_image if self.small_image   
+        @images[:medium] = self.medium_image if self.medium_image
+        @images[:large] = self.large_image if self.large_image
+      end
+    end
+
+    attr_accessor :xml_doc
+    def self.parse(xml, options = {})
+      node = XML::Parser.string(xml.to_s).parse.root
+      node.find("//Item").collect do |n|
+        p = super(n.to_s)
+        p.xml_doc = Nokogiri::XML.parse(n.to_s)
+        p
+      end
+    end
+
+    # perform a nokogiri search on the product's XML
+    # @param args Passes directly to a Nokogiri::Xml.parse(xml).search method
+    # @example find the actor
+    #   @product = Ramazon::Product.find(:item_id => "B000NU2CY4", :response_group => "Medium")[0]
+    #   @product.get("ItemAttributes Actor").collect{|a| a.content}
+    def get(*args)
+      result = @xml_doc.search(args)
+    end
+  end
+end

data/lib/ramazon/product_collection.rb

@@ -0,0 +1,27 @@
+module Ramazon
+  class ProductCollection < WillPaginate::Collection
+    include HappyMapper
+ 
+    def self.create_from_results(page, per_page, body)
+      results = Items.parse(body, {})[0]
+      col = create(page, 10, results.total_results || 0) do |pager|
+        pager.replace(results.products)
+      end
+      
+      col
+    end
+    
+  end
+
+  class Items
+    include HappyMapper
+    tag 'Items' 
+
+    element :total_results, Integer, :tag => 'TotalResults'
+    element :total_pages, Integer, :tag => 'TotalPages'
+    has_many :products, 
+      Ramazon::Product,
+      :tag => "Item",
+      :raw => true
+  end
+end

data/lib/ramazon/rails_additions.rb

@@ -0,0 +1,99 @@
+#this code courtesy of Pat Allan and Rails Core
+module Ramazon
+  module HashExcept
+    # Returns a new hash without the given keys.
+    def except(*keys)
+      rejected = Set.new(respond_to?(:convert_key) ? keys.map { |key| convert_key(key) } : keys)
+      reject { |key,| rejected.include?(key) }
+    end
+
+    # Replaces the hash without only the given keys.
+    def except!(*keys)
+      replace(except(*keys))
+    end
+  end
+end
+
+Hash.send(
+  :include, Ramazon::HashExcept
+) unless Hash.instance_methods.include?("except")
+
+module Ramazon
+  module ArrayExtractOptions
+    def extract_options!
+      last.is_a?(::Hash) ? pop : {}
+    end
+  end
+end
+
+Array.send(
+  :include, Ramazon::ArrayExtractOptions
+) unless Array.instance_methods.include?("extract_options!")
+
+module Ramazon
+  module ClassAttributeMethods
+    def cattr_reader(*syms)
+      syms.flatten.each do |sym|
+        next if sym.is_a?(Hash)
+        class_eval(<<-EOS, __FILE__, __LINE__)
+          unless defined? @@#{sym}
+            @@#{sym} = nil
+          end
+
+          def self.#{sym}
+            @@#{sym}
+          end
+
+          def #{sym}
+            @@#{sym}
+          end
+        EOS
+      end
+    end
+
+    def cattr_writer(*syms)
+      options = syms.extract_options!
+      syms.flatten.each do |sym|
+        class_eval(<<-EOS, __FILE__, __LINE__)
+          unless defined? @@#{sym}
+            @@#{sym} = nil
+          end
+
+          def self.#{sym}=(obj)
+            @@#{sym} = obj
+          end
+
+          #{"
+          def #{sym}=(obj)
+            @@#{sym} = obj
+          end
+          " unless options[:instance_writer] == false }
+        EOS
+      end
+    end
+
+    def cattr_accessor(*syms)
+      cattr_reader(*syms)
+      cattr_writer(*syms)
+    end
+  end
+end
+
+Class.extend(
+  Ramazon::ClassAttributeMethods
+) unless Class.respond_to?(:cattr_reader)
+
+module Ramazon
+  module MetaClass
+    def metaclass
+      class << self
+        self
+      end
+    end
+  end
+end
+
+unless Object.new.respond_to?(:metaclass)
+  Object.send(:include, Ramazon::MetaClass)
+end
+

data/lib/ramazon/request.rb

@@ -0,0 +1,82 @@
+module Ramazon
+  #the object used to prepare and submit requests to amazon
+  class Request
+    include HTTParty
+    attr_accessor :options
+
+    def initialize(options = {})
+      self.options = options.merge(default_options)
+    end
+
+    def submit
+      @response = self.class.get(signed_url)
+      if valid?
+        @response.body
+      else
+        raise self.errors[0], "The following response errors were returned: #{self.errors.collect{|e| e.to_s}}" 
+      end
+    end
+
+    # Error checking for responses (will return true if errors are present)
+    # @returns [boolean] whether the response yielded errors
+    def valid?
+      @response && errors.empty?
+    end
+
+    #errors returned from amazon
+    def errors
+      @errors ||= Ramazon::Error.parse(@response.body) || []
+    end
+
+    #use this if any type of caching is desired (TBD)
+    def unsigned_path
+      qs = ""
+
+      sorted_params.each do |key, value|
+        qs << "&#{key}=#{URI.encode(value.to_s)}"
+      end
+
+      qs.size > 0 ? qs[1..qs.size] : qs
+    end
+
+    def signed_url
+      self.options[:timestamp] = Time.now.utc.strftime("%Y-%m-%dT%H:%M:%S")
+      encoded_param_strings = []
+      sorted_params.each do |p|
+        encoded_param_strings << "#{p[0]}=#{CGI::escape(p[1].to_s)}"
+      end
+      string_to_sign = 
+"GET
+#{Ramazon::Configuration.base_uri.gsub("http://", "")}
+#{Ramazon::Configuration.path}
+#{encoded_param_strings.join("&")}"
+
+      signature = Ramazon::Signatory.sign(string_to_sign)
+      encoded_param_strings << "Signature=" + signature
+      
+      "#{Ramazon::Configuration.uri}?#{encoded_param_strings.join("&")}"
+    end
+
+    def sorted_params
+      params.sort {|a, b| a <=> b}
+    end
+
+    def params
+      formatted_params = {}
+      self.options.each do |key, value|
+        formatted_params[key.to_s.classify] = value.is_a?(Array) ? value.join(",") : value
+      end
+
+      formatted_params
+    end
+
+    private
+    def default_options
+      {
+        :service => "AWSECommerceService",
+        :version => "2009-07-01",
+        :AWSAccessKeyId => Ramazon::Configuration.access_key
+      }
+    end
+  end
+end

data/lib/ramazon/signatory.rb

@@ -0,0 +1,10 @@
+module Ramazon
+  class Signatory
+    def self.sign(string_to_sign)
+      sha1 = HMAC::SHA256.digest(Ramazon::Configuration.secret_key, string_to_sign)
+
+      #Base64 encoding adds a linefeed to the end of the string so chop the last character!
+      CGI.escape(Base64.encode64(sha1).chomp)
+    end
+  end
+end

data/lib/ramazon_advertising.rb

@@ -0,0 +1,34 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require "rubygems"
+
+require "fileutils"
+require "base64"
+require "hmac-sha2"
+require "digest/sha1"
+require "digest/sha2"
+require "cgi"
+
+require "will_paginate"
+require "httparty"
+require "happymapper"
+require "nokogiri"
+require "configatron"
+require "active_support/inflector"
+
+require "ramazon/rails_additions"
+
+require "ramazon/abstract_element"
+
+require "ramazon/signatory"
+require "ramazon/configuration"
+require "ramazon/error"
+require "ramazon/request"
+
+require "ramazon/image"
+require "ramazon/price"
+require "ramazon/product"
+require "ramazon/product_collection"
+require "ramazon/browse_node"
+
+configatron.ramazon.locale = :us

data/lib/root_nodes.yml

@@ -0,0 +1,64 @@
+--- 
+Apparel (Kids & Baby): "1040662"
+Baby: "165796011"
+Gourmet Food: "3370831"
+Home Appliances: "361395011"
+Camera & Photo: "502394"
+All Sports & Outdoors: "3375251"
+Health & Personal Care: "3760901"
+Cell Phones & Service: "301185"
+Home Audio & Theater: "667846011"
+Power & Hand Tools: "328182011"
+Golf: "3410851"
+Team Sports: "706809011"
+Action Sports: "706812011"
+Vacuums & Storage: "510080"
+Office Products & Supplies: "1064954"
+Magazines: "1263069011"
+Industrial & Scientific: "16310091"
+Jewelry: "3367581"
+Pet Supplies: "12923371"
+Home Improvement: "228013"
+Bedding & Bath: "1057792"
+TV & Video: "1266092011"
+Computers & Accessories: "541966"
+Books: "4"
+Motorcycle & ATV: "346333011"
+Outdoor Power Equipment: "551242"
+Outdoor Recreation: "706814011"
+Natural & Organic: "51537011"
+"Furniture & D\xC3\xA9cor": "1057794"
+Newspapers: "1263068011"
+MP3 & Media Players: "172630"
+Accessories: "1268192011"
+MP3 Downloads: "163856011"
+Kindle Books: "1286228011"
+Toys & Games: "165793011"
+Beauty: "3760911"
+Grocery: "16310101"
+Blogs: "401358011"
+Video Games: "471306"
+Cycling: "3403201"
+Watches: "377110011"
+Movies: "163414"
+Sewing, Craft & Hobby: "12890711"
+Software: "229548"
+Kindle Store: "133141011"
+Game Downloads: "979455011"
+Video On Demand: "16261631"
+Movies & TV: "130"
+Textbooks: "465600"
+Shoes: "672123011"
+Apparel & Accessories: "1036592"
+Kitchen & Dining: "284507"
+Amazon Shorts: "13993911"
+Blu-ray: "193640011"
+Car Electronics & GPS: "1077068"
+PC Games: "229575"
+Computer Components: "193870011"
+Music: "173425"
+Automotive: "15684181"
+Fan Gear: "3386071"
+Exercise & Fitness: "3407731"
+Patio, Lawn & Garden: "286168"
+Musical Instruments: "11091801"

data/lib/tasks/ramazon.rake

@@ -0,0 +1,9 @@
+namespace :ramazon do 
+  desc "Generate the yml file used for looking up root browse nodes"
+  task :generate_node_yml do
+    puts "Generating root nodes"
+    Ramazon::BrowseNode.generate_root_nodes
+    puts "Done"
+  end
+end
+

data/ramazon_advertising.gemspec

@@ -0,0 +1,92 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ramazon_advertising}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dan Pickett"]
+  s.date = %q{2009-09-08}
+  s.description = %q{TODO: longer description of your gem}
+  s.email = %q{dpickett@enlightsolutions.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "features/friendly_errors.feature",
+     "features/generate_root_browse_nodes.feature",
+     "features/retrieving_a_product.feature",
+     "features/searching_for_products.feature",
+     "features/step_definitions/auth_steps.rb",
+     "features/step_definitions/browse_node_steps.rb",
+     "features/step_definitions/error_steps.rb",
+     "features/step_definitions/product_steps.rb",
+     "features/step_definitions/ramazon_advertising_steps.rb",
+     "features/support/env.rb",
+     "features/support/ramazon_advertising.example.yml",
+     "lib/ramazon/abstract_element.rb",
+     "lib/ramazon/browse_node.rb",
+     "lib/ramazon/configuration.rb",
+     "lib/ramazon/error.rb",
+     "lib/ramazon/image.rb",
+     "lib/ramazon/price.rb",
+     "lib/ramazon/product.rb",
+     "lib/ramazon/product_collection.rb",
+     "lib/ramazon/rails_additions.rb",
+     "lib/ramazon/request.rb",
+     "lib/ramazon/signatory.rb",
+     "lib/ramazon_advertising.rb",
+     "lib/root_nodes.yml",
+     "lib/tasks/ramazon.rake",
+     "ramazon_advertising.gemspec",
+     "spec/ramazon/configuration_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/dpickett/ramazon_advertising}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{TODO: one-line summary of your gem}
+  s.test_files = [
+    "spec/ramazon/configuration_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<jnunemaker-httparty>, [">= 0.4.3"])
+      s.add_runtime_dependency(%q<jnunemaker-happymapper>, [">= 0.2.5"])
+      s.add_runtime_dependency(%q<mislav-will_paginate>, [">= 2.3.11"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.3.3"])
+      s.add_runtime_dependency(%q<configatron>, [">= 2.4.1"])
+      s.add_runtime_dependency(%q<rails>, [">= 2.3.3"])
+      s.add_runtime_dependency(%q<ruby-hmac>, [">= 0.3.2"])
+    else
+      s.add_dependency(%q<jnunemaker-httparty>, [">= 0.4.3"])
+      s.add_dependency(%q<jnunemaker-happymapper>, [">= 0.2.5"])
+      s.add_dependency(%q<mislav-will_paginate>, [">= 2.3.11"])
+      s.add_dependency(%q<nokogiri>, [">= 1.3.3"])
+      s.add_dependency(%q<configatron>, [">= 2.4.1"])
+      s.add_dependency(%q<rails>, [">= 2.3.3"])
+      s.add_dependency(%q<ruby-hmac>, [">= 0.3.2"])
+    end
+  else
+    s.add_dependency(%q<jnunemaker-httparty>, [">= 0.4.3"])
+    s.add_dependency(%q<jnunemaker-happymapper>, [">= 0.2.5"])
+    s.add_dependency(%q<mislav-will_paginate>, [">= 2.3.11"])
+    s.add_dependency(%q<nokogiri>, [">= 1.3.3"])
+    s.add_dependency(%q<configatron>, [">= 2.4.1"])
+    s.add_dependency(%q<rails>, [">= 2.3.3"])
+    s.add_dependency(%q<ruby-hmac>, [">= 0.3.2"])
+  end
+end

data/spec/ramazon/configuration_spec.rb

@@ -0,0 +1,21 @@
+require "spec_helper"
+
+describe Ramazon::Configuration do
+  it "should default to the us" do
+    Ramazon::Configuration.locale.should eql(:us)
+  end
+
+  it "should raise an exception if a set a locale that doesn't exist" do
+    lambda {Ramazon::Configuration.locale = :ffsf}.should raise_error
+  end
+
+  it "should derive a url of the locale" do
+    Ramazon::Configuration.locale = :de
+    Ramazon::Configuration.base_uri.should =~ /#{Ramazon::Configuration.locale.to_s}/
+  end
+
+  it "should use .com for a us address" do
+    Ramazon::Configuration.locale = :us
+    Ramazon::Configuration.base_uri.should =~ /\.com/
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'ramazon_advertising'
+require 'spec'
+require 'spec/autorun'
+
+
+Spec::Runner.configure do |config|
+  
+end
+

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification 
+name: dpickett-ramazon_advertising
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Dan Pickett
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-08 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: jnunemaker-httparty
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: jnunemaker-happymapper
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.5
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mislav-will_paginate
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.11
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: configatron
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.4.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-hmac
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.2
+    version: 
+description: "TODO: longer description of your gem"
+email: dpickett@enlightsolutions.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- features/friendly_errors.feature
+- features/generate_root_browse_nodes.feature
+- features/retrieving_a_product.feature
+- features/searching_for_products.feature
+- features/step_definitions/auth_steps.rb
+- features/step_definitions/browse_node_steps.rb
+- features/step_definitions/error_steps.rb
+- features/step_definitions/product_steps.rb
+- features/step_definitions/ramazon_advertising_steps.rb
+- features/support/env.rb
+- features/support/ramazon_advertising.example.yml
+- lib/ramazon/abstract_element.rb
+- lib/ramazon/browse_node.rb
+- lib/ramazon/configuration.rb
+- lib/ramazon/error.rb
+- lib/ramazon/image.rb
+- lib/ramazon/price.rb
+- lib/ramazon/product.rb
+- lib/ramazon/product_collection.rb
+- lib/ramazon/rails_additions.rb
+- lib/ramazon/request.rb
+- lib/ramazon/signatory.rb
+- lib/ramazon_advertising.rb
+- lib/root_nodes.yml
+- lib/tasks/ramazon.rake
+- ramazon_advertising.gemspec
+- spec/ramazon/configuration_spec.rb
+- spec/spec_helper.rb
+has_rdoc: false
+homepage: http://github.com/dpickett/ramazon_advertising
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 3
+summary: "TODO: one-line summary of your gem"
+test_files: 
+- spec/ramazon/configuration_spec.rb
+- spec/spec_helper.rb