netphase-acts_as_amazon_product 2.0.0

data/.gitignore

@@ -0,0 +1,3 @@
+pkg
+test.db
+config.yml

data/CHANGELOG

@@ -0,0 +1,33 @@
+= 1.4
+=== 11th October, 2008
+* Added load_from_amazon and load_from_amazon! methods to load up Amazon attributes into a local object directly (see the README for usage)
+* Added new tests for the above functionality
+* Changed the response group so that it is a passed-in option, with the default being 'Medium' rather than having it hardcoded.
+ 
+= 1.3
+=== 11th August, 2008
+* (Thanks to David Eisinger for changes in this release)
+* Test wasn't dropping magazines table, causing error when running tests multiple times
+* Added access_key and associate_tag to movie and magazine in tests; not setting them was causing tests to fail without ENV variables
+* Added a generator to create the amazon_products database migration
+* Changed the Hpricot search method: If multiple values, returns them as a comma-separated string; Returns nil if no value found
+* Got rid of the amazon_product#hdoc method, moved functionality in to #get
+* Added method_missing to amazon_product to search XML based on method name
+
+= 1.2
+=== 24th April, 2008
+* Accepts search_index parameter to work better with Magazines (patch from Parker Morse)
+* Changed scm to Git and moved repository to github.com
+
+= 1.1
+=== 3rd November, 2007
+* Use defaults for access_key and associate_tag from the environment: AMAZON_ACCESS_KEY_ID, AMAZON_ASSOCIATE_TAG
+* Added example.rb
+
+= 1.0
+=== 21st September, 2007
+
+* Initial release as a gem
+* Caches response from Amazon
+* Some basic tests.  Run "rake test"
+

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2007 netphase.com
+
+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 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

@@ -0,0 +1,135 @@
+= ActsAsAmazonProduct
+
+This "acts_as" module makes it extremely simple to add Amazon integration to an 
+existing model.  
+
+== Setup
+
+This code does not require changing any current database tables.  It only requires 
+adding one migration for a single new table used to cache responses from Amazon.
+Run the following to create the migration:
+
+  script/generate acts_as_amazon_product_migration
+
+== Using acts_as_amazon_product
+
+Add the "acts_as" line to your model.  Only :access_key is required.  The :asin and
+:name assignments override what attributes in your class should be used for a direct 
+lookup (item_lookup) or general search (item_search).  If no value is assigned to :asin 
+then a general search is made and the first item (sorted by salesrank) is assigned 
+(this functionality will likely change).
+
+There are two ways to use Acts as Amazon Product.  The first is to simply allow all of the Amazon data for your product
+to be stored in the AmazonProduct object:
+
+	require 'acts_as_amazon_product'
+
+	class Book < ActiveRecord::Base
+	  acts_as_amazon_product :asin => 'isbn', :name => 'title', 
+				:access_key => '0123456', :associate_tag => 'assoc-20'
+	end
+	
+Other interesting options for the acts_as_amazon call:
+
+:search_index => 'Books' (default value if not specified)
+:response_group => 'Medium' (default value if not specified) 
+:auto_load_fields => see below
+:ignore_fields => see below
+
+You can now access the Amazon data in your views like so:
+
+	@book = Book.new(:title => 'Getting Things Done')
+	@book.amazon.isbn
+	@book.amazon.title
+	@book.amazon.author
+	@book.amazon.small_image_url
+	
+	or
+	@book.amazon.get('itemattributes/foobar')
+	
+The second way to use Acts as Amazon Product is to load the Amazon data directly into an existing object in your 
+application. You can elect to have the Amazon data loaded into a new, unsaved object, or go one step further and allow
+Acts as Amazon Product to load the data and save the loaded object all in one shot.  The mapping between the 
+Amazon fields and your object are declared by passing a hash called auto_load_fields to the acts_as_amazon_product 
+call as shown below:
+ 
+ require 'acts_as_amazon_product'
+ 
+ class LocalBook < ActiveRecord::Base
+   acts_as_amazon_product(
+     :asin => 'isbn', :name => 'title', 
+     :access_key => '0123456', :associate_tag => 'assoc-20',
+     :auto_load_fields => {:title => 'title', :isbn => 'asin', :publisher_name => 'manufacturer', :author => 'author'}
+   ) 
+ end
+ 
+The keys in the auto_load_fields hash are the fields in your object, and the values are their Amazon equivalents. 
+In the true Rails convention over configuration spirit, we have included some of the most popular auto load fields as 
+defaults. If your object contains the following attributes, they will automatically be loaded with their Amazon 
+equivalents:
+
+:auto_load_fields => {:title => 'title', :isbn => 'asin', :publisher_name => 'manufacturer', 
+  :author => 'author', :binding => 'binding', :list_price => 'listprice/amount', :pages => 'numberofpages',
+  :description => 'content', :small_image_url => 'smallimage/url', :medium_image_url => 'mediumimage/url', 
+  :large_image_url => 'largeimage/url', :detail_url => 'detailpageurl'}
+  
+Don't worry if your object does not have some or most of these fields; Acts as Amazon Product is smart enough to check 
+to see if the method exists before attempting to load up the Amazon value.  
+
+Now, if by some coincidence you have some fields in your local object that have the same name as our auto_load 
+defaults, you can choose to specifically ignore those fields using, you guessed it, :ignore_fields.  :ignore_fields is 
+a simple array of fields in your object that you do NOT want to be replaced with the Amazon equivalent.  You would 
+specify them like this:
+
+  acts_as_amazon_product(
+    :asin => 'isbn', :name => 'title', 
+    :access_key => '0123456', :associate_tag => 'assoc-20',
+    :ignore_fields => [:small_image_url, :medium_image_url]
+  )
+
+In this instance, the object in question would load Amazon info for any of the default fields that the object has, 
+with the exception of the small_image_url and medium_image_url values.
+
+To load the Amazon values into your object for local storage, you may call the following methods:
+
+load_from_amazon(title_or_asin, by_title = false)
+load_from_amazon!(title_or_asin, by_title = false)
+
+The two methods do exactly the same thing, except the first simply returns a new, unsaved object with its Amazon-like 
+fields loaded with their appropriate Amazon values.  The second version (load_from_amazon!) goes one step further and 
+saves the object for good measure.
+
+You may pass either an isbn (asin) or a title in.  If you are passing a title, you need to specify that you are 
+passing a title by also passing true as the second parameter so we will perform an item_search rather than an 
+item_lookup. Note that passing a title is risky business, since currently the code will take the first result returned 
+and load that into your object. So unless your title is unique, I would recommend sticking with the isbn (asin) value.  
+Since that is the default, all you need to do would be something like this:
+
+@local_book = LocalBook.load_from_amazon('1590598415')
+
+If your object was similar to the LocalBook object in our example, for instance, you would not need to specify the 
+auto_load_fields in the acts_as call at all.  The title, isbn, publisher_name and author methods would automatically 
+be called once you call load_from_amazon, and their values populated appropriately.
+
+It is important to note that if you call load_from_amazon with an invalid asin, you will simply get back an empty 
+object.
+
+Now, calling load_from_amazon still allows you to take advantage of the other Acts as Amazon features, like the 
+dynamic loading of Amazon attributes on the fly by using the various amazon.foo methods as described above.
+
+== Unit tests
+
+There are tests you can run in the [gem]/test directory.  Just create a 
+test/config.yml from the example and run "Rake test" from the [gem] directory.
+
+= Credits
+acts_as_amazon_product was created by Scott Nedderman and Chris Beck from netphase.com
+
+We'd love to here how you like it.  Also, if you'd like us to help out with your next 
+project, let us know. 
+
+http://netphase.com
+
+
+
+

data/Rakefile

@@ -0,0 +1,85 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rubygems'
+require 'fileutils'
+include FileUtils
+
+NAME = "acts_as_amazon_product"
+# REV = File.read(".svn/entries")[/committed-rev="(\d+)"/, 1] rescue nil
+# VERS = ENV['VERSION'] || ("1.1" + (REV ? ".#{REV}" : ""))
+VERS = ENV['VERSION'] || "1.4"
+CLEAN.include ['**/.*.sw?', '*.gem', '.config', 'test/test.log']
+
+desc 'Default: run unit tests.'
+task :default => [:package]
+task :package => [:clean]
+
+desc 'Generate documentation for the acts_as_amazon_product plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ActsAsAmazonProduct'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# Gem::manage_gems
+# require 'rake/gempackagetask'
+# spec = Gem::Specification.new do |s|
+#     s.platform  =   Gem::Platform::RUBY
+#     s.name      =   NAME
+#     s.version   =   VERS
+#     s.author    =   "Scott Nedderman"
+#     s.email     =   "scott@netphase.com"
+#     s.homepage  =   "http://netphase.com"
+#     s.summary   =   "A package for simplifying use of the Amazon/ECS API"
+#     s.files     =   FileList['lib/*.rb', 'test/*'].to_a.reject {|f| f.match /config\.yml/ }
+#     s.require_path  =   "lib"
+#     # s.autorequire   =   "acts_as_amazon_product"
+#     s.test_files = Dir.glob('tests/*.rb')
+#     s.has_rdoc  =   true
+#     s.extra_rdoc_files  =   ["README"]
+#     s.add_dependency("amazon-ecs", ">=0.5.1")
+# end
+# Rake::GemPackageTask.new(spec) do |pkg|
+#     pkg.need_tar = true
+# end
+# task :default => "pkg/#{spec.name}-#{spec.version}.gem" do
+#     puts "generated latest version"
+# end
+# 
+# task :install do
+#   sh %{rake package}
+#   sh %{sudo gem install pkg/#{NAME}-#{VERS}}
+# end
+# 
+# task :uninstall => [:clean] do
+#   sh %{sudo gem uninstall #{NAME}}
+# end
+
+desc 'Test the acts_as_amazon_product plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "acts_as_amazon_product"
+    gemspec.summary = "A package for simplifying use of the Amazon/ECS API"
+    gemspec.email = "scott@netphase.com"
+    gemspec.homepage = "http://github.com/netphase/aaap"
+    gemspec.authors = ["Scott Nedderman","Chris Beck"]
+    gemspec.add_dependency("amazon-ecs", ">=0.5.1")
+    gemspec.files.exclude 'test/config.yml'
+    
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+

data/VERSION

@@ -0,0 +1 @@
+2.0.0

data/acts_as_amazon_product.gemspec

@@ -0,0 +1,57 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{acts_as_amazon_product}
+  s.version = "2.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Scott Nedderman", "Chris Beck"]
+  s.date = %q{2009-06-18}
+  s.email = %q{scott@netphase.com}
+  s.extra_rdoc_files = [
+    "README"
+  ]
+  s.files = [
+    ".gitignore",
+     "CHANGELOG",
+     "COPYING",
+     "README",
+     "Rakefile",
+     "VERSION",
+     "acts_as_amazon_product.gemspec",
+     "generators/acts_as_amazon_product_migration/acts_as_amazon_product_migration_generator.rb",
+     "generators/acts_as_amazon_product_migration/templates/migration.rb",
+     "init.rb",
+     "install.rb",
+     "lib/acts_as_amazon_product.rb",
+     "lib/amazon_product.rb",
+     "tasks/acts_as_amazon_product_tasks.rake",
+     "test/acts_as_amazon_product_test.rb",
+     "test/config-example.yml",
+     "test/example.rb",
+     "uninstall.rb"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/netphase/aaap}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{A package for simplifying use of the Amazon/ECS API}
+  s.test_files = [
+    "test/acts_as_amazon_product_test.rb",
+     "test/example.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<amazon-ecs>, [">= 0.5.1"])
+    else
+      s.add_dependency(%q<amazon-ecs>, [">= 0.5.1"])
+    end
+  else
+    s.add_dependency(%q<amazon-ecs>, [">= 0.5.1"])
+  end
+end

data/generators/acts_as_amazon_product_migration/acts_as_amazon_product_migration_generator.rb

@@ -0,0 +1,11 @@
+class ActsAsAmazonProductMigrationGenerator < Rails::Generator::Base 
+  def manifest 
+    record do |m| 
+      m.migration_template 'migration.rb', 'db/migrate'
+    end 
+  end
+  
+  def file_name
+    "acts_as_amazon_product_migration"
+  end
+end

data/generators/acts_as_amazon_product_migration/templates/migration.rb

@@ -0,0 +1,16 @@
+class ActsAsAmazonProductMigration < ActiveRecord::Migration
+  def self.up
+    create_table :amazon_products do |t|
+  	  t.string  :asin
+  	  t.text    :xml
+  	  t.integer :amazonable_id, :default => 0, :null => false
+  	  t.string  :amazonable_type, :limit => 15, :default => "", :null => false
+  	  
+  	  t.timestamps
+  	end
+  end
+  
+  def self.down
+    drop_table :amazon_products
+  end
+end

data/init.rb

@@ -0,0 +1,3 @@
+# Include hook code here
+require 'acts_as_amazon_product'
+ActiveRecord::Base.send(:include, Netphase::Acts::Amazonable)

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/acts_as_amazon_product.rb

@@ -0,0 +1,123 @@
+require 'rubygems'
+require 'active_record'
+require 'amazon/ecs'
+require 'amazon_product'
+
+module Netphase
+  module Acts #:nodoc:
+    module Amazonable #:nodoc:
+
+      def self.included(base)
+        base.extend ClassMethods  
+      end
+
+      module ClassMethods
+        def acts_as_amazon_product(options = {})
+          defaults = {
+            :asin => 'asin',
+            :name => 'name',
+            :access_key => ENV['AMAZON_ACCESS_KEY_ID'],
+            :associate_tag => ENV['AMAZON_ASSOCIATE_TAG'],
+            :search_index => 'Books',
+            :response_group => 'Medium',
+            :auto_load_fields => {:title => 'title', :isbn => 'asin', :publisher_name => 'manufacturer', 
+              :author => 'author', :binding => 'binding', :list_price => 'listprice/amount', :pages => 'numberofpages',
+              :description => 'content', :small_image_url => 'smallimage/url', :medium_image_url => 'mediumimage/url', 
+              :large_image_url => 'largeimage/url', :detail_url => 'detailpageurl'},
+            :ignore_fields => [],
+            :auto_delete_amazon => true
+          }
+          options = defaults.merge options
+
+          Amazon::Ecs.options = {:aWS_access_key_id => options[:access_key], 
+            :associate_tag => options[:associate_tag], :response_group => options[:response_group]}
+
+          write_inheritable_attribute(:amazon_asin, options[:asin])    
+          write_inheritable_attribute(:amazon_name, options[:name])
+          write_inheritable_attribute(:amazon_search_index, options[:search_index])    
+          write_inheritable_attribute(:amazon_associate_key, options[:associate_key])
+          write_inheritable_attribute(:auto_load_fields, options[:auto_load_fields])
+          write_inheritable_attribute(:ignore_fields, options[:ignore_fields])
+          write_inheritable_attribute(:auto_delete_amazon, options[:auto_delete_amazon])
+          class_inheritable_reader :amazon_asin, :amazon_name, :amazon_search_index, :amazon_associate_key
+          class_inheritable_reader :auto_load_fields, :ignore_fields, :auto_delete_amazon
+          
+          has_one :amazon_product, :as => :amazonable   #, :dependent => :delete
+          extend Netphase::Acts::Amazonable::SingletonMethods
+          include Netphase::Acts::Amazonable::InstanceMethods
+        end
+
+      end
+      
+      # This module contains class methods
+      module SingletonMethods
+        def load_from_amazon(title_or_asin, by_title = false)
+          begin
+            unless by_title
+              res = Amazon::Ecs.item_lookup(title_or_asin)
+            else
+              res = Amazon::Ecs.item_search(title_or_asin, :search_index => self.amazon_search_index)
+            end
+            create_instance_from_amazon(res.items[0])
+          rescue
+            return self.new
+          end
+        end
+        
+        def load_from_amazon!(title_or_asin, by_title = false)
+          result = self.load_from_amazon(title_or_asin, by_title)
+          if result
+            result.save
+            return result
+          end
+        end
+
+        private
+        def create_instance_from_amazon(item)
+          newbie = self.new
+          self.auto_load_fields.each do |key, value|
+            if newbie.respond_to?(key.to_s) && !self.ignore_fields.include?(key)
+              newbie.send key.to_s + '=', item.get(value)
+            end
+          end
+          return newbie
+        end
+        
+      end
+      
+      # This module contains instance methods
+      module InstanceMethods
+        def amazon
+          if self.amazon_product.nil?
+            asin = self.send(self.amazon_asin) rescue nil
+            name = self.send(self.amazon_name) rescue nil
+            options = { :response_group => 'Medium' }  
+            if !asin.blank?
+              unless self.amazon_asin == 'asin'
+                options[:id_type] = self.amazon_asin.upcase
+                options[:search_index] = self.amazon_search_index
+              end
+              res = Amazon::Ecs.item_lookup(self.send(self.amazon_asin), options)
+              self.create_amazon_product(:xml => res.doc.to_html, :asin => res.doc.at('asin') && res.doc.at('asin').inner_html)
+            elsif !name.blank?
+              res = Amazon::Ecs.item_search(self.send(self.amazon_name), options.merge(:search_index => self.amazon_search_index))
+              res = res.doc.at('items/item')
+              asin = res.at('itemattributes/isbn') || res.at('asin') unless res.nil?
+              self.create_amazon_product(:xml => res && res.to_html, :asin => asin && asin.inner_html)
+            else
+              logger.error "No known attributes to search by"
+            end            
+          end
+          self.amazon_product if self.amazon_product.valid?
+        end
+        
+        def after_save
+          if self.auto_delete_amazon && !self.amazon_product.nil?
+            self.amazon_product.destroy
+            self.reload
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amazon_product.rb

@@ -0,0 +1,70 @@
+require 'hpricot'
+
+class AmazonProduct < ActiveRecord::Base
+  validates_presence_of :asin
+
+  def get(key, separator = ', ')
+    @doc ||= Hpricot.XML(xml)
+    values = (@doc/key).collect {|e| e.inner_html }
+    values *= separator unless separator.nil?
+    values unless values.blank?
+  end
+
+  def isbn
+    get("itemattributes/isbn")
+  end
+
+  def title
+    get("itemattributes/title")
+  end
+
+  def author
+    get("itemattributes/author")
+  end
+
+  def binding
+    get("itemattributes/binding")
+  end
+
+  def price
+    get("itemattributes/listprice/amount")
+  end
+
+  def pages
+    get("itemattributes/numberofpages")
+  end
+
+  def small_image_url
+    get("smallimage/url")
+  end
+
+  def medium_image_url
+    get("mediumimage/url")
+  end
+
+  def large_image_url
+    get("largeimage/url")
+  end
+
+  def detail_url
+    get("detailpageurl")
+  end
+
+  def method_missing(symbol, *args)
+    begin
+      super(symbol, *args)
+    rescue NoMethodError
+      get(symbol, *args)
+    end
+  end
+  
+  def respond_to?(method_id, include_private = false)
+    unless self.xml.blank? 
+     doc = Hpricot.XML(xml) 
+     return (method_id.to_s.index(/[\W]/) || doc.at(method_id.to_s).nil?) ? super : true
+    else         
+      super
+    end
+  end
+  
+end

data/tasks/acts_as_amazon_product_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :acts_as_amazon_product do
+#   # Task goes here
+# end

data/test/acts_as_amazon_product_test.rb

@@ -0,0 +1,226 @@
+require 'test/unit'
+require 'yaml'
+
+require File.expand_path(File.dirname(__FILE__) + "/../lib/acts_as_amazon_product")
+
+require File.expand_path(File.dirname(__FILE__) + "/../init")
+
+config = open(File.dirname(__FILE__) + "/../test/config.yml") { |f| YAML.load(f.read)}
+ActiveRecord::Base.establish_connection(config["database"])
+
+#Amazon::Ecs.options = {:aWS_access_key_id => config['amazon']['access_key']}
+@@access_key = config['amazon']['access_key']
+@@associate_tag = config['amazon']['associate_tag']
+
+ActiveRecord::Base.connection.drop_table :amazon_products rescue nil
+ActiveRecord::Base.connection.drop_table :books rescue nil
+ActiveRecord::Base.connection.drop_table :ean_books rescue nil
+ActiveRecord::Base.connection.drop_table :movies rescue nil
+ActiveRecord::Base.connection.drop_table :magazines rescue nil
+ActiveRecord::Base.connection.drop_table :local_books rescue nil
+
+ActiveRecord::Base.connection.create_table :books do |t|
+  t.column :type, :string
+  t.column :title, :string
+  t.column :author, :string
+  t.column :isbn, :string
+  t.column :ean, :string
+end
+
+ActiveRecord::Base.connection.create_table :movies do |t|
+  t.column :name, :string
+  t.column :asin, :string
+end
+
+ActiveRecord::Base.connection.create_table :magazines do |t|
+  t.column :name, :string
+  t.column :asin, :string
+end
+
+ActiveRecord::Base.connection.create_table :local_books do |t|
+  t.column :title, :string
+  t.column :author, :string
+  t.column :isbn, :string 
+  t.column :publisher_name, :string 
+  t.column :small_image_url, :string
+  t.column :medium_image_url, :string
+end
+
+ActiveRecord::Base.connection.create_table :amazon_products do |t|  # , :id => false
+  t.column :asin, :string
+  t.column :xml, :text
+  t.column :created_at, :datetime, :null => false
+  t.column :amazonable_id, :integer, :default => 0, :null => false
+  t.column :amazonable_type, :string, :limit => 15, :default => "", :null => false
+end
+
+class Book < ActiveRecord::Base
+  acts_as_amazon_product(
+    :asin => 'isbn', :name => 'title', 
+    :access_key => @@access_key, :associate_tag => @@associate_tag)
+end
+
+class EANBook < Book
+  acts_as_amazon_product(
+    :asin => 'ean', :name => 'title',
+    :access_key => @@access_key, :associate_tag => @@associate_tag)
+end
+
+class Movie < ActiveRecord::Base
+  acts_as_amazon_product :access_key => @@access_key, :associate_tag => @@associate_tag
+end
+
+class Magazine < ActiveRecord::Base
+  acts_as_amazon_product :search_index => 'Magazines', :access_key => @@access_key,
+    :associate_tag => @@associate_tag
+end
+
+class LocalBook < ActiveRecord::Base
+  acts_as_amazon_product(
+    :asin => 'isbn', :name => 'title', 
+    :access_key => @@access_key, :associate_tag => @@associate_tag, :ignore_fields => [:small_image_url, :medium_image_url]
+  ) 
+end
+
+AmazonProduct.delete_all
+
+class ActAsAmazonProductTest < Test::Unit::TestCase
+    
+  def setup
+    Book.delete_all        
+    @book_gtd = Book.create(:title => 'Getting Things Done', :author => 'Dude', :isbn => '0142000280')
+    @book_ror = Book.create(:title => 'Rails Recipes')
+    @book_perl = Book.create(:title => 'Perl')
+    @book_eg = EANBook.create(:ean => '9780765342294')
+    @movie_dh = Movie.create(:name=>'Live Free or Die Hard', :asin=>'B000VNMMRA')
+    @mag_lci = Magazine.create(:name => 'La Cucina Italiana')
+    LocalBook.delete_all
+    @local_rails = LocalBook.load_from_amazon('1590598415')
+    @local_roots = LocalBook.load_from_amazon!('Roots', true)
+  end
+  
+  def test_isbn
+    assert_not_nil(@book_gtd.amazon)
+    assert_equal("0142000280", @book_gtd.amazon.isbn)
+  end
+  
+  def test_title
+    assert_not_nil(@book_gtd.amazon)
+    assert_equal("Getting Things Done: The Art of Stress-Free Productivity", @book_gtd.amazon.title)
+  end
+  
+  def test_magazine
+    assert_not_nil(@mag_lci.amazon)
+    assert_equal("B00009XFML", @mag_lci.amazon.asin)
+  end
+  
+  def test_lookup_by_nonstandard_id
+    assert_not_nil(@book_eg.amazon)
+    assert_equal("Ender's Game", @book_eg.amazon.title)
+  end
+
+  def test_invalid_isbn
+    b = Book.create(:isbn => '12345')
+    assert_nil(b.amazon)
+  end
+
+  def test_invalid_title
+    b = Book.create(:title => "AQAQAQAQ")
+    assert_nil(b.amazon)
+  end
+
+  def test_small_image
+    assert_not_nil(@book_gtd.amazon)
+    assert_match(/4104N6ME70L\._SL75_\.jpg/, @book_gtd.amazon.small_image_url)
+  end
+  
+  def test_author
+    assert_not_nil(@book_gtd.amazon)
+    assert_equal("David Allen", @book_gtd.amazon.author)
+  end
+  
+  def test_binding
+    assert_not_nil(@book_gtd.amazon)
+    assert_equal("Paperback", @book_gtd.amazon.binding)
+  end
+  
+  def test_find_with_multiple
+    assert_equal("Advanced Rails Recipes", @book_ror.amazon.title)
+    assert_equal("Mike Clark", @book_ror.amazon.author)
+  end
+  
+  def test_returns_nil_if_attribute_not_found
+    assert_equal(nil, @book_ror.amazon.get('contributor'))
+  end
+  
+  def test_update
+    assert_not_nil(@book_perl.amazon)
+    isbn = @book_perl.amazon.isbn
+    @book_perl.title = "Websters"
+    @book_perl.amazon.destroy
+    @book_perl.save
+    assert_not_equal(isbn, @book_perl.reload.amazon.isbn)
+  end
+  
+  def test_product_with_all_defaults
+    assert_not_nil(@movie_dh.amazon)
+    assert_equal 'Bruce Willis, Justin Long, Timothy Olyphant, Maggie Q, Cliff Curtis',
+      @movie_dh.amazon.get('itemattributes/actor')
+  end
+  
+  def test_accepts_a_custom_separator
+    assert_equal 'Bruce Willis | Justin Long | Timothy Olyphant | Maggie Q | Cliff Curtis',
+      @movie_dh.amazon.get('itemattributes/actor', ' | ')      
+  end
+  
+  def test_returns_array_if_separator_is_nil
+    assert_equal ["Bruce Willis", "Justin Long", "Timothy Olyphant", "Maggie Q", "Cliff Curtis"],
+      @movie_dh.amazon.get('itemattributes/actor', nil)      
+  end
+
+  def test_method_missing
+    assert_equal 'Bruce Willis, Justin Long, Timothy Olyphant, Maggie Q, Cliff Curtis', @movie_dh.amazon.actor
+  end
+
+  def test_method_missing_with_separator
+    assert_equal 'Bruce Willis | Justin Long | Timothy Olyphant | Maggie Q | Cliff Curtis', @movie_dh.amazon.actor(' | ')
+  end
+  
+  def test_load_local_book
+    assert_not_nil(@local_rails.title)
+    assert_not_nil(@local_rails.isbn)
+    assert_not_nil(@local_rails.publisher_name)
+    assert_not_nil(@local_rails.author)
+    assert_not_nil(@local_roots.title)
+    assert_not_nil(@local_roots.isbn)
+    assert_not_nil(@local_roots.publisher_name)
+    assert_not_nil(@local_roots.author)
+    assert_equal "Practical Rails Social Networking Sites (Expert's Voice)", @local_rails.title
+    assert_equal '0882667033', @local_roots.isbn
+  end
+  
+  def test_new_versus_saved_load 
+    assert_equal @local_rails.new_record?, true
+    assert_equal @local_roots.new_record?, false
+  end
+  
+  def test_lack_of_initial_amazon_product_for_local
+    @local_woody = LocalBook.load_from_amazon!('0736412662')
+    assert_nil AmazonProduct.find_by_amazonable_id(@local_woody.id)
+  end
+  
+  def test_ignore_fields
+    assert_nil @local_rails.small_image_url
+    assert_nil @local_rails.medium_image_url
+    assert_nil @local_roots.small_image_url
+    assert_nil @local_roots.medium_image_url
+  end
+  
+  def test_locals_load_amazon_attributes_if_needed
+    assert_not_nil @local_rails.amazon.binding
+    assert_not_nil @local_roots.amazon.binding
+    assert_equal @local_rails.amazon.binding, 'Paperback'
+    assert_equal @local_roots.amazon.binding, 'Paperback'
+  end
+  
+end

data/test/config-example.yml

@@ -0,0 +1,7 @@
+database:
+  adapter: sqlite3
+  dbfile: test/test.db
+ 
+amazon:
+  access_key: 1AAAABBBBCCCCDDDDEE2
+  associate_tag: assoc-20

data/test/example.rb

@@ -0,0 +1,28 @@
+$: << 'lib'
+
+require 'acts_as_amazon_product'
+
+ActiveRecord::Base.establish_connection({:adapter => 'sqlite3', :database => 'test.db'})
+ActiveRecord::Base.connection.create_table :books, :force => true do |t|
+  t.column :name, :string
+  t.column :asin, :string
+end
+
+
+class Book < ActiveRecord::Base
+  acts_as_amazon_product
+end
+
+
+book = Book.create(:name => 'Rails Recipes')
+
+puts <<EOS
+   Title:   #{book.amazon.title}
+   Author:  #{book.amazon.author}
+   Price:   #{book.amazon.price}
+   Image:   #{book.amazon.small_image_url}
+   Details: #{book.amazon.detail_url}
+EOS
+
+
+

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: netphase-acts_as_amazon_product
+version: !ruby/object:Gem::Version 
+  version: 2.0.0
+platform: ruby
+authors: 
+- Scott Nedderman
+- Chris Beck
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-18 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: amazon-ecs
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.1
+    version: 
+description: 
+email: scott@netphase.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- .gitignore
+- CHANGELOG
+- COPYING
+- README
+- Rakefile
+- VERSION
+- acts_as_amazon_product.gemspec
+- generators/acts_as_amazon_product_migration/acts_as_amazon_product_migration_generator.rb
+- generators/acts_as_amazon_product_migration/templates/migration.rb
+- init.rb
+- install.rb
+- lib/acts_as_amazon_product.rb
+- lib/amazon_product.rb
+- tasks/acts_as_amazon_product_tasks.rake
+- test/acts_as_amazon_product_test.rb
+- test/config-example.yml
+- test/example.rb
+- uninstall.rb
+has_rdoc: true
+homepage: http://github.com/netphase/aaap
+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: 2
+summary: A package for simplifying use of the Amazon/ECS API
+test_files: 
+- test/acts_as_amazon_product_test.rb
+- test/example.rb