ramazon_advertising 0.3.2

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,46 @@
+= 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}
+
+More documentation at http://rdoc.info/projects/dpickett/ramazon_advertising
+
+== 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,84 @@
+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{Amazon Advertising Wrapper - Use nokogiri to target the elements you want}
+    gem.description = %Q{ 	 Amazon Advertising Wrapper - Use nokogiri to target the elements you want. An object oriented approach}
+    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("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.3.2

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,13 @@
+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 root 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/getting_offer_details.feature

@@ -0,0 +1,30 @@
+Feature: Retrieving offer details
+  As a user of the Ramazon_advertising api
+  I want to get offer details
+  In order to get pricing information about a given product
+
+  Background:
+    Given I have a valid access key
+    And I have a valid secret key
+
+  Scenario: Getting offers on a DVD
+    Given I am searching with the "item_id" of "B000NTPDSW"
+    And I am searching with the "condition" of "Used"
+    And I am searching with the "response_group" of "Medium,OfferListings"
+    And I am searching with the "merchant_id" of "All"
+    When I perform the product search
+    Then I should get a product
+    And the product should have "offers"
+    And each of the product's "offers" should have a "price"
+    And each of the product's "offers" should have a "condition"
+    And each of the product's "offers" should have a "sub_condition"
+    And the product should have "used_offers"
+    And each of the product's "used_offers" should have a "condition" of "Used"
+
+  Scenario: Getting offers by subcondition hash
+    Given I am searching with the "item_id" of "B000NTPDSW"
+    And I am searching with the "response_group" of "Medium,OfferListings"
+    When I perform the product search
+    Then I should get a product
+    And the product should have "offers_by_condition"
+    And the product should have "lowest_offers"

data/features/getting_search_bins.feature

@@ -0,0 +1,22 @@
+Feature: As a user of the Ramazon Advertising wrapper
+  I want to get search bins
+  So I can efficiently narrow down results
+
+  Scenario: Getting DVD search bins
+    Given I am searching with the "search_index" of "DVD"
+    And I am searching with the "response_group" of "Medium,SearchBins"
+    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 the list of products should have "search_bin_sets"
+    And each "search_bin_set" in the list of products should have "search_bins"
+
+  Scenario: Getting Genre search bins
+    Given I am searching with the "search_index" of "DVD"
+    And I am searching with the "response_group" of "Medium,SearchBins"
+    And I am searching with the "browse_node" of "405391011"
+    When I perform the product search
+    Then I should get a list of products
+    And the list of products should have "search_bin_sets"
+    And each "search_bin_set" in the list of products should have "search_bins"

data/features/retrieve_browse_node_information.feature

@@ -0,0 +1,16 @@
+Feature: As a user of the ramazon advertising api
+  I want to get browse node information
+  So I can retrieve Amazon product data more effectively
+
+  Scenario: Fetch "Other Video Games" Node
+    Given I want browse node information for the node "294940"
+    When I retrieve the browse node
+    Then the browse node should have a name
+    And the browse node should have "children"
+    And the browse node should have a "child_hash"
+
+  Scenario: Fetch "DVD" Node
+    Given I want browse node information for the node "130"
+    When I retrieve the browse node
+    Then the browse node should have a name
+    And the browse node should have "children"

data/features/retrieving_a_product.feature

@@ -0,0 +1,32 @@
+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
+
+  Scenario: Finding a DVD
+    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"
+  
+  Scenario: Finding a Video Game with a deep category tree
+    When I try to find the asin "B001COQW14"
+    Then I should get a product
+    And the product should have a category tree for "Categories"
+
+  Scenario: Finding a Movie with a Genre tree
+    When I try to find the asin "B002CMLIJ6"
+    Then I should get a product
+    And the product should have a category tree for "Genres"

data/features/searching_for_products.feature

@@ -0,0 +1,47 @@
+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
+
+  Scenario: Finding dvds
+    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"
+
+  Scenario: Finding video games
+    Given I am searching with the "search_index" of "VideoGames"
+    And I am searching with the "response_group" of "Medium,BrowseNodes"
+    And I am searching with the "browse_node" of "294940"
+    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
+
+  Scenario: Finding multiple browse nodes
+    Given I am searching with the "search_index" of "VideoGames"
+    And I am searching with the "response_group" of "Medium"
+    And I am searching with the "browse_node" of "11075221"
+    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" "Video Games"
+
+  Scenario: Finding All Offers optimization
+    Given I am searching with the "search_index" of "VideoGames"
+    And I am searching with the "response_group" of "Medium,OfferListings"
+    And I am searching with the "merchant_id" of "All"
+    And I am searching with the "condition" of "All"
+    And I am searching with the "offer_page" of "1"
+    And I am searching with the "browse_node" of "11075221"
+    When I perform the product search
+    Then I should get a list of products
+    And each product should have "offer_pages"
+    And each product should have "has_first_page_of_full_offers"
+
+

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,55 @@
+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
+
+Given /^I want browse node information for the node "([^\"]*)"$/ do |node_id|
+  @node_id = node_id
+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
+
+When /^I retrieve the browse node$/ do
+  @node = Ramazon::BrowseNode.find(@node_id)
+end
+
+Then /^the browse node should have a name$/ do
+  @node.name.should_not be_nil
+end
+
+Then /^the browse node should have (a\s)?"(.*)"$/ do |a, attr|
+  @node.send(attr).should_not be_nil
+  if @node.send(attr).respond_to?(:empty?)
+    @node.send(attr).should_not be_empty
+  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_collection_steps.rb

@@ -0,0 +1,20 @@
+Then /^the list of products should have "([^\"]*)"$/ do |attr|
+  @products.send(attr).should_not be_nil
+  if @products.respond_to?(:empty?)
+    @products.should_not be_empty
+  end
+end
+
+Then /^each "([^\"]*)" in the list of products should have "([^\"]*)"$/ do |collection, attr|
+  collection = collection.pluralize
+  @products.send(collection).should_not be_nil
+  @products.send(collection).should_not be_empty
+
+  @products.send(collection).each do |i|
+    i.send(attr).should_not be_nil
+    if i.send(attr).respond_to?(:empty?)
+      i.send(attr).should_not be_empty
+    end
+  end
+end
+