amazonian 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+*.swp
+.*.swp

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    amazonian (0.0.1)
+      crack
+      hashie
+      httpclient
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    hashie (0.4.0)
+    httpclient (2.1.5.2)
+    rspec (2.1.0)
+      rspec-core (~> 2.1.0)
+      rspec-expectations (~> 2.1.0)
+      rspec-mocks (~> 2.1.0)
+    rspec-core (2.1.0)
+    rspec-expectations (2.1.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  amazonian!
+  crack
+  hashie
+  httpclient
+  rspec

data/README.rdoc

@@ -0,0 +1,36 @@
+== Status
+This project is in active development as of 2010-11.
+
+Currently it can be used as a rails plugin, and maybe as a gem (untested).
+
+== Installation
+
+Copy or symlink into your application's /lib folder.
+
+In your ApplicationController:
+
+  class ApplicationController < ActionController::Base
+    include Amazonian
+  end
+
+Then create an initializer in config/initializers:
+  require 'amazonian'
+  Amazonian.setup do |config|
+    config.secret = 'ZkD9VorhnJjoPxZp8S/bP0K3G4NBQPNQrfU4OOUn'
+    config.key    = 'AKIAJCTUFLKJWEVW6XVQ'
+    #config.debug  = true
+  end
+
+== Usage
+  Amazonian.asin "1430218150"
+  #=> #<Amazonian::Item>
+
+  #soon:
+  Amazonian.search "The art of Computer Programming"  #Title
+  Amazonian.search "978-0201853926"                   #ISBN-13
+  Amazonian.search "0201853922"                       #ISBN-10
+  Amazonian.search "<whateveryouwant>"                #Anything you might put in the search box on Amazon.com.
+
+== Info
+
+For more information on the REST calls, have a look at the whole Amazon E-Commerce-API[http://docs.amazonwebservices.com/AWSEcommerceService/4-0/].

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/amazonian.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "amazonian/version"
+
+Gem::Specification.new do |s|
+  s.name        = "amazonian"
+  s.version     = Amazonian::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Robert L. Carpenter"]
+  s.email       = ["robacarp@robacarp.com"]
+  s.homepage    = ""
+  s.summary     = %q{Easy to use ruby module for the Amazon Product Advertising API}
+  s.description = %q{Easy to use ruby module for the Amazon Product Advertising API}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+
+  s.add_dependency "hashie"
+  s.add_dependency "crack"
+  s.add_dependency "patron"
+  #s.add_dependency "httpclient"
+  #s.add_dependency "crack/xml"
+  #included in ruby?
+  #s.add_dependency "cgi"
+  #um
+  #s.add_dependency "Base64"
+  #s.add_dependency "logger"
+end

data/lib/amazonian.rb

@@ -0,0 +1,116 @@
+module Amazonian
+  @@host   = 'webservices.amazon.com'
+  @@path   = '/onca/xml'
+  @@digest = OpenSSL::Digest::Digest.new('sha256')
+  @@logger = Logger.new(STDERR)
+  @@patron = Patron::Session.new
+  @@last_response = nil
+  @@key    = ''
+  @@secret = ''
+  @@debug  = false
+
+  mattr_reader   :host,:path,:digest,:patron,:last_response
+  mattr_accessor :key,:secret,:debug
+
+  #Configure the patron session
+  @@patron.timeout = 10
+
+  # Configure the basic request parameters for Amazonian.
+  def self.setup
+    yield self if block_given?
+  end
+
+  # Performs an +ItemLookup+ REST call against the Amazon API.
+  #
+  # Expects an ASIN (Amazon Standard Identification Number) and returns an +Item+:
+  #
+  #   item = lookup '1430218150'
+  #   item.title
+  #   => "Learn Objective-C on the Mac (Learn Series)"
+  #
+  # ==== Options:
+  #
+  # Additional parameters for the API call like this:
+  #
+  #   lookup(asin, :ResponseGroup => :Medium)
+  #
+  def self.asin(asin, params={})
+    params = params.merge :Operation => :ItemLookup, :ItemId => asin
+    xml    = self.call params
+    Item.new xml
+  end
+
+  private
+
+  def self.call(params)
+    raise "you have to configure ASIN: 'configure :secret => 'your-secret', :key => 'your-key''" if @@key.nil? || @@secret.nil?
+
+    #get the signed query, and assemble the querystring
+    log :debug, "calling with params=#{params}"  if @@debug
+    signed = assemble_querystring params
+    url = "http://#{@@host}#{@@path}?#{signed}"
+
+    log :info, "performing rest call to url='#{url}'" if @@debug
+    @@last_response = @@patron.get url
+
+    # force utf-8 chars, works only on 1.9 string
+    log :debug, "got response='#{@@last_response}'" if @@debug
+
+    #parse the response and return it
+    Crack::XML.parse @@last_response.body
+  end
+
+  def self.assemble_querystring(params)
+    # Nice tutorial http://cloudcarpenters.com/blog/amazon_products_api_request_signing/
+    params[:Service] = :AWSECommerceService
+    params[:AWSAccessKeyId] = @@key
+
+    # UTC timestamp needed for signing
+    params[:Timestamp] = Time.now.utc.strftime '%Y-%m-%dT%H:%M:%SZ'
+
+    # CGI escape each param
+    # signing needs to order the query alphabetically
+    query = params.map{|key, value| "#{key}=#{CGI.escape(value.to_s)}" }.sort.join('&')
+
+    sign_query query
+  end
+
+  def self.sign_query(query)
+    # Sign the entire get-request (not just the querystring)
+    # possible gotcha if Patron starts using more/different headers.
+    request_to_sign = %Q{GET\n#{@@host}\n#{@@path}\n#{query}}
+
+    # Sign it.
+    hmac = OpenSSL::HMAC.digest(@@digest, @@secret, request_to_sign)
+
+    # Don't forget to remove the newline from base64
+    signature = CGI.escape(Base64.encode64(hmac).chomp)
+
+    "#{query}&Signature=#{signature}"
+  end
+
+  def self.log(severity, message)
+    @@logger.send severity, message if @@logger
+  end
+
+
+  # =Item
+  #
+  # The +Item+ class is a wrapper for the Amazon XML-REST-Response.
+  #
+  # A Hashie::Mash is used for the internal data representation and can be accessed over the +raw+ attribute.
+  #
+  class Item
+
+    attr_reader :raw
+
+    def initialize(hash)
+      @raw = Hashie::Mash.new(hash).ItemLookupResponse.Items.Item
+    end
+
+    def title
+      @raw.ItemAttributes.Title
+    end
+
+  end
+end

data/lib/amazonian/version.rb

@@ -0,0 +1,3 @@
+module Amazonian
+  VERSION = "0.0.1"
+end

data/spec/amazonian_spec.rb

@@ -0,0 +1,2 @@
+describe Amazonian do
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: amazonian
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Robert L. Carpenter
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-26 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: crack
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: patron
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id004
+description: Easy to use ruby module for the Amazon Product Advertising API
+email: 
+- robacarp@robacarp.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.rdoc
+- Rakefile
+- amazonian.gemspec
+- lib/amazonian.rb
+- lib/amazonian/version.rb
+- spec/amazonian_spec.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Easy to use ruby module for the Amazon Product Advertising API
+test_files: 
+- spec/amazonian_spec.rb