acts_as_amazon_product 1.0

data/README

@@ -0,0 +1,51 @@
+= 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:
+
+	ActiveRecord::Base.connection.create_table :amazon_products do |t|
+	  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
+
+== 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_looup) 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).
+
+	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
+
+You can now access the Amazon data in your views like so (see):
+
+	@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')
+
+== 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 credited 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/lib/acts_as_amazon_product.rb

@@ -0,0 +1,90 @@
+# ActsAsAmazonProduct
+
+require 'rubygems'
+require 'active_support'
+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'
+          }
+          options = defaults.merge options
+
+          Amazon::Ecs.options = {:aWS_access_key_id => options[:access_key], :associate_tag => options[:associate_tag] }
+
+          write_inheritable_attribute(:amazon_asin, options[:asin])    
+          write_inheritable_attribute(:amazon_name, options[:name])    
+          write_inheritable_attribute(:amazon_associate_key, options[:associate_key])
+          class_inheritable_reader :amazon_asin, :amazon_name, :amazon_associate_key
+          
+          has_one :amazon_product, :as => :amazonable   #, :dependent => :delete
+          include Netphase::Acts::Amazonable::InstanceMethods
+          extend Netphase::Acts::Amazonable::SingletonMethods
+        end
+                
+      end
+      
+      # This module contains class methods
+      module SingletonMethods
+        
+      end
+      
+      # This module contains instance methods
+      module InstanceMethods
+        
+        def amazon
+          if self.amazon_product.nil?
+            asin = (self.respond_to?('amazon_asin')) ? self.send(self.amazon_asin) : nil
+            name = (self.respond_to?('amazon_name')) ? self.send(self.amazon_name) : nil
+            
+            if !asin.nil? && asin.length > 0
+              #puts "Looking up #{asin}"
+              res = Amazon::Ecs.item_lookup(self.send(self.amazon_asin), :response_group => 'Medium')
+              
+              self.amazon_product =
+                AmazonProduct.new(:xml => res.doc.to_html, :asin => res.doc.at('itemattributes/isbn').inner_html)
+              self.amazon_product.save
+            elsif !name.nil? && name.length > 0
+              #puts "Searching for #{name}"
+              res = Amazon::Ecs.item_search(self.send(self.amazon_name), :response_group => 'Medium') #, :sort => 'salesrank'
+              res = res.doc.at('items/item')
+              self.amazon_product =
+                AmazonProduct.new(:xml => res.to_html, :asin => res.at('itemattributes/isbn').inner_html)
+              self.amazon_product.save
+            else
+              logger.error "No known attributes to search by"
+            end            
+          end
+          self.amazon_product
+        end
+
+        def after_save
+          unless self.amazon_product.nil?
+            self.amazon_product.destroy
+            self.reload
+          end
+        end
+                
+      end
+      
+    end
+  end
+end
+
+ActiveRecord::Base.class_eval do
+  include Netphase::Acts::Amazonable
+end
+

data/lib/amazon_product.rb

@@ -0,0 +1,54 @@
+require 'hpricot'
+
+class AmazonProduct < ActiveRecord::Base
+#  belongs_to :amazonable, :polymorphic => true
+
+  def hdoc(key)
+    @doc ||= Hpricot.XML(xml)
+    @doc.at(key).inner_html
+  end
+
+  def get(key)
+    hdoc(key)
+  end
+
+  def isbn
+    hdoc("itemattributes/isbn")
+  end
+
+  def title
+    hdoc("itemattributes/title")
+  end
+
+  def author
+    hdoc("itemattributes/author")
+  end
+
+  def binding
+    hdoc("itemattributes/binding")
+  end
+
+  def price
+    hdoc("itemattributes/listprice/amount")
+  end
+
+  def pages
+    hdoc("itemattributes/numberofpages")
+  end
+
+  def small_image_url
+    hdoc("smallimage/url")
+  end
+
+  def medium_image_url
+    hdoc("mediumimage/url")
+  end
+
+  def large_image_url
+    hdoc("largeimage/url")
+  end
+
+  def detail_url
+    hdoc("detailpageurl")
+  end
+end

data/test/acts_as_amazon_product_test.rb

@@ -0,0 +1,85 @@
+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.create_table :books do |t|
+    t.column :title, :string
+    t.column :author, :string
+    t.column :isbn, :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
+
+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')
+    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_small_image
+      assert_not_nil(@book_gtd.amazon)
+      assert_match(/01PBN79FHEL\.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("Rails Recipes (Pragmatic Programmers)", @book_ror.amazon.title)
+      assert_equal("Chad Fowler", @book_ror.amazon.author)
+    end
+    
+    def test_update
+      assert_not_nil(@book_perl.amazon)
+      isbn = @book_perl.amazon.isbn
+      @book_perl.title = "Websters"
+      @book_perl.save
+      assert_not_equal(isbn, @book_perl.amazon.isbn)
+    end
+      
+end    

data/test/config-example.yml

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

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: acts_as_amazon_product
+version: !ruby/object:Gem::Version 
+  version: "1.0"
+date: 2007-09-25 00:00:00 -04:00
+summary: A package for simplifying use of the Amazon/ECS API
+require_paths: 
+- lib
+email: scott@netphase.com
+homepage: 
+rubyforge_project: 
+description: 
+autorequire: acts_as_amazon_product
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Scott Nedderman
+files: 
+- lib/acts_as_amazon_product.rb
+- lib/amazon_product.rb
+- test/acts_as_amazon_product_test.rb
+- test/config-example.yml
+- README
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: amazon-ecs
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.1
+    version: