rasin 0.7.0

data/.document

@@ -0,0 +1,3 @@
+lib/**/*.rb
+README.rdoc
+CHANGELOG.rdoc

data/.gitignore

@@ -0,0 +1,6 @@
+html
+pkg
+*.gem
+.DS_Store
+.bundle
+.rvmrc

data/.travis.yml

@@ -0,0 +1,13 @@
+script: "bundle exec rake"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - rbx
+  - rbx-2.0
+  - ree
+  - ruby-head
+  - jruby
+branches:
+  only:
+    - develop

data/CHANGELOG.rdoc

@@ -0,0 +1,49 @@
+== 0.7.0
+
+* jruby compatible
+* loosen gem dependencies
+
+== 0.6.1
+
+* fix error when passing nil to config values
+
+== 0.6.0
+
+* change lookup method - pull request https://github.com/phoet/asin/pull/8
+
+== 0.5.1
+
+* fix for https://github.com/phoet/asin/issues/7
+
+== 0.5.0
+
+* move client to own file
+* use autoload
+* support for Hashie::Rash
+* new method browse_node
+
+== 0.4.0
+
+* add configuration option for item/cart class
+* add more functionality to item class
+
+== 0.4.0.beta1
+
+* added cart operations
+* added yml configuration
+
+== 0.3.0
+
+* add search_keywords method
+* open up search method to be more flexible
+
+== 0.2.0
+
+* rails initializer configuration
+* rpsec for tests
+
+== 0.1.0
+
+* add logger
+* use HTTPI as HTTP-adapter
+* use bundler for dependencies

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,54 @@
+PATH
+  remote: .
+  specs:
+    asin (0.7.0)
+      crack (~> 0.3)
+      hashie (~> 1.1)
+      httpi (~> 0.9)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.6)
+    crack (0.3.1)
+    diff-lcs (1.1.3)
+    fuubar (0.0.6)
+      rspec (~> 2.0)
+      rspec-instafail (~> 0.1.8)
+      ruby-progressbar (~> 0.0.10)
+    hashie (1.1.0)
+    httpclient (2.2.3)
+    httpi (0.9.5)
+      rack
+    rack (1.4.1)
+    rake (0.9.2.2)
+    rash (0.3.1)
+      hashie (~> 1.1.0)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-instafail (0.1.9)
+    rspec-mocks (2.7.0)
+    ruby-progressbar (0.0.10)
+    vcr (1.11.3)
+    webmock (1.7.7)
+      addressable (~> 2.2, > 2.2.5)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  asin!
+  fuubar (~> 0.0.5)
+  httpclient (~> 2.2.3)
+  rake (~> 0.9.2.2)
+  rash (~> 0.3.1)
+  rspec (~> 2.7.0)
+  vcr (~> 1.11.3)
+  webmock (~> 1.7.7)

data/README.rdoc

@@ -0,0 +1,166 @@
+== Infos
+
+Status: http://stillmaintained.com/phoet/asin.png
+Build: http://travis-ci.org/phoet/asin.png
+
+ASIN is a simple, extensible wrapper for parts of the REST-API of Amazon Product Advertising API (aka Associates Web Service aka Amazon E-Commerce Service).
+
+For more information on the REST calls, have a look at the whole Amazon E-Commerce-API[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html].
+
+Have a look at the RDOC[http://rdoc.info/projects/phoet/asin] for this project, if you like browsing some docs.
+
+The gem runs smoothly with Rails 3 and is tested against multiple rubies. See +.travis.yml+ for details.
+
+== Installation
+
+  gem install asin
+  gem install httpclient # optional, see HTTPI
+  gem install rash # optional, see Response Configuration
+
+or in your Gemfile:
+
+  gem 'asin'
+  gem 'httpclient' # optional, see HTTPI
+  gem 'rash' # optional, see Response Configuration
+
+== Configuration
+
+Rails style initializer (config/initializers/asin.rb):
+
+  ASIN::Configuration.configure do |config|
+    config.secret = 'your-secret'
+    config.key    = 'your-key'
+  end
+
+YAML style configuration:
+
+  ASIN::Configuration.configure :yaml => 'config/asin.yml'
+
+Inline style configuration:
+
+  ASIN::Configuration.configure :secret => 'your-secret', :key => 'your-key'
+  # or
+  client.configure :secret => 'your-secret', :key => 'your-key'
+
+Have a look at ASIN::Configuration class for all the details.
+
+===API Changes
+
+With the latest version of the Product Advertising API you need to include your associate_tag[https://affiliate-program.amazon.com/gp/advertising/api/detail/api-changes.html].
+
+  ASIN::Configuration.configure do |config|
+    config.secret        = 'your-secret'
+    config.key           = 'your-key'
+    config.associate_tag = 'your-tag'
+  end
+
+== Usage
+
+ASIN is designed as a module, so you can include it into any object you like:
+
+  # require and include
+  require 'asin'
+  include ASIN::Client
+  
+  # lookup an ASIN
+  lookup '1430218150'
+
+But you can also use the +instance+ method to get a proxy-object:
+
+  # just require
+  require 'asin'
+  
+  # create an ASIN client
+  client = ASIN::Client.instance
+  
+  # lookup an item with the amazon standard identification number (asin)
+  items = client.lookup '1430218150'
+  
+  # have a look at the title of the item
+  items.first.title
+  => Learn Objective-C on the Mac (Learn Series)
+  
+  # search for any kind of stuff on amazon with keywords
+  items = search_keywords 'Learn', 'Objective-C'
+  items.first.title
+  => "Learn Objective-C on the Mac (Learn Series)"
+  
+  # search for any kind of stuff on amazon with custom parameters
+  search :Keywords => 'Learn Objective-C', :SearchIndex => :Books
+  items.first.title
+  => "Learn Objective-C on the Mac (Learn Series)"
+  
+  # access the internal data representation (Hashie::Mash)
+  item.raw.ItemAttributes.ListPrice.FormattedPrice
+  => $39.99
+
+There is an additional set of methods to support AWS cart operations:
+
+  client = ASIN::Client.instance
+  
+  # create a cart with an item
+  cart = client.create_cart({:asin => '1430218150', :quantity => 1})
+  cart.items
+  => [<#Hashie::Mash ASIN="1430218150" CartItemId="U3G241HVLLB8N6" ... >]
+  
+  # get an already existing cart from a CartId and HMAC
+  cart = client.get_cart('176-9182855-2326919', 'KgeVCA0YJTbuN/7Ibakrk/KnHWA=')
+  cart.empty?
+  => false
+  
+  # clear everything from the cart
+  cart = client.clear_cart(cart)
+  cart.empty?
+  => true
+  
+  # add items to the cart
+  cart = client.add_items(cart, {:asin => '1430216263', :quantity => 2})
+  cart.empty?
+  => false
+  
+  # update items in the cart
+  cart = client.update_items(cart, {:cart_item_id => cart.items.first.CartItemId, :action => :SaveForLater}, {:cart_item_id => cart.items.first.CartItemId, :quantity => 7})
+  cart.saved_items
+  => [<#Hashie::Mash ASIN="1430218150" CartItemId="U3G241HVLLB8N6" ... >]
+
+It's also possible to access browse nodes:
+
+  client = ASIN::Client.instance
+  
+  # create a cart with an item
+  node = client.browse_node('163357', :ResponseGroup => :TopSellers)
+  node.node_id
+  => '163357'
+  node.name
+  => 'Comedy'
+
+== Response Configuration
+
+ASIN is customizable in the way it returns Responses from Amazon. 
+By default it will return +SimpleItem+, +SimpleCart+ or +SimpleNode+ instances,
+but you can override this behavior for using your custom Classes:
+
+  client.configure :item_type => YourItemClass
+  client.configure :cart_type => YourCartClass
+  client.configure :node_type => YourNodeClass
+
+You can also use built-in +:raw+, +:mash+ or +:rash+ types.
+Since +rash+ is an additional library, you need to add it to your gemfile if you want to use it:
+
+  gem 'rash'
+
+== HTTPI
+
+ASIN uses HTTPI[https://github.com/rubiii/httpi] as a HTTP-Client adapter.
+See the HTTPI documentation for how to configure different clients or the logger.
+As a default HTTPI uses _httpclient_ so you should add that dependency to your project:
+
+  gem 'httpclient'
+
+
+== License
+
+"THE BEER-WARE LICENSE" (Revision 42):
+ps@nofail.de[mailto:ps@nofail.de] wrote this file. As long as you retain this notice you
+can do whatever you want with this stuff. If we meet some day, and you think
+this stuff is worth it, you can buy me a beer in return Peter Schröder

data/asin.gemspec

@@ -0,0 +1,36 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "asin/version"
+
+Gem::Specification.new do |s|
+  s.name        = "rasin"
+  s.version     = ASIN::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Peter Schröder']
+  s.email       = ['phoetmail@googlemail.com']
+  s.homepage    = 'http://github.com/phoet/asin'
+  s.summary     = 'Simple interface to AWS Lookup, Search and Cart operations.'
+  s.description = 'Amazon Simple INterface.'
+
+  s.rubyforge_project = "asin"
+
+  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_dependency('crack',  '~> 0.3')
+  s.add_dependency('hashie', '~> 1.1')
+  s.add_dependency('httpi',  '~> 0.9')
+
+  s.add_runtime_dependency('jruby-openssl') if RUBY_PLATFORM == 'java'
+
+  s.add_development_dependency('httpclient', '~> 2.2.3')
+  s.add_development_dependency('rash',       '~> 0.3.1')
+
+  s.add_development_dependency('rake',       '~> 0.9.2.2')
+  s.add_development_dependency('vcr',        '~> 1.11.3')
+  s.add_development_dependency('webmock',    '~> 1.7.7')
+  s.add_development_dependency('rspec',      '~> 2.7.0')
+  s.add_development_dependency('fuubar',     '~> 0.0.5')
+end

data/lib/asin.rb

@@ -0,0 +1,8 @@
+module ASIN
+  autoload :Client,         'asin/client'
+  autoload :SimpleItem,     'asin/simple_item'
+  autoload :SimpleCart,     'asin/simple_cart'
+  autoload :SimpleNode,     'asin/simple_node'
+  autoload :Version,        'asin/version'
+  autoload :Configuration,  'asin/configuration'
+end

data/lib/asin/client.rb

@@ -0,0 +1,398 @@
+# -*- coding: utf-8 -*-
+require 'httpi'
+require 'crack/xml'
+require 'cgi'
+require 'base64'
+
+# ASIN (Amazon Simple INterface) is a gem for easy access of the Amazon E-Commerce-API.
+# It is simple to configure and use. Since it's very small and flexible, it is easy to extend it to your needs.
+#
+# Author::    Peter Schröder  (mailto:phoetmail@googlemail.com)
+#
+# == Usage
+#
+# The ASIN module is designed as a mixin.
+#
+#   require 'asin'
+#   include ASIN::Client
+#
+# In order to use the Amazon API properly, you need to be a registered user (http://aws.amazon.com).
+#
+# The registration process will give you a +secret-key+ and an +access-key+ (AWSAccessKeyId).
+#
+# Both are needed to use ASIN (see Configuration for more details):
+#
+#   configure :secret => 'your-secret', :key => 'your-key'
+#
+# == Search
+#
+# After configuring your environment you can call the +lookup+ method to retrieve an +SimpleItem+ via the
+# Amazon Standard Identification Number (ASIN):
+#
+#   item = lookup '1430218150'
+#   item.first.title
+#   => "Learn Objective-C on the Mac (Learn Series)"
+#
+# OR search with fulltext/ASIN/ISBN
+#
+#   items = search 'Learn Objective-C'
+#   items.first.title
+#   => "Learn Objective-C on the Mac (Learn Series)"
+#
+# The +SimpleItem+ uses a Hashie::Mash as its internal data representation and you can get fetched data from it:
+#
+#   item.raw.ItemAttributes.ListPrice.FormattedPrice
+#   => "$39.99"
+#
+# == Further Configuration
+#
+# If you need more controll over the request that is sent to the
+# Amazon API (http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html),
+# you can override some defaults or add additional query-parameters to the REST calls:
+#
+#   configure :host => 'webservices.amazon.de'
+#   lookup(asin, :ResponseGroup => :Medium)
+#
+# == Cart
+#
+# ASIN helps with AWS cart-operations.
+# It currently supports the CartCreate, CartGet, CartAdd, CartModify and CartClear operations:
+#
+#   cart = create_cart({:asin => '1430218150', :quantity => 1})
+#   cart.valid?
+#   cart.items
+#   => true
+#   => [<#Hashie::Mash ASIN="1430218150" CartItemId="U3G241HVLLB8N6" ... >]
+#
+#   cart = get_cart('176-9182855-2326919', 'KgeVCA0YJTbuN/7Ibakrk/KnHWA=')
+#   cart.empty?
+#   => false
+#
+#   cart = clear_cart(cart)
+#   cart.empty?
+#   => true
+#
+#   cart = add_items(cart, {:asin => '1430216263', :quantity => 2})
+#   cart.empty?
+#   => false
+#
+#   cart = update_items(cart, {:cart_item_id => cart.items.first.CartItemId, :action => :SaveForLater}, {:cart_item_id => cart.items.first.CartItemId, :quantity => 7})
+#   cart.valid?
+#   cart.saved_items
+#   => true
+#   => [<#Hashie::Mash ASIN="1430218150" CartItemId="U3G241HVLLB8N6" ... >]
+#
+# == Nodes
+#
+# In order to browse Amazon nodes, you can use +browse_node+ method:
+#
+#   node = browse_node('163357')
+#   node.node_id
+#   => '163357'
+#   node.name
+#   => 'Comedy'
+#   node.children
+#   node.ancestors
+#
+# you can configure the +:ResponseGroup+ option to your needs:
+#
+#   node = browse_node('163357', :ResponseGroup => :TopSellers)
+#
+module ASIN
+  module Client
+
+    DIGEST  = OpenSSL::Digest::Digest.new('sha256')
+    PATH    = '/onca/xml'
+
+    # Convenience method to create an ASIN client.
+    #
+    # An instance is not necessary though, you can simply include the ASIN module otherwise.
+    #
+    def self.instance
+      ins = Object.new
+      ins.extend ASIN::Client
+      ins
+    end
+
+    # Configures the basic request parameters for ASIN.
+    #
+    # Expects at least +secret+ and +key+ for the API call:
+    #
+    #   configure :secret => 'your-secret', :key => 'your-key'
+    #
+    # See ASIN::Configuration for more infos.
+    #
+    def configure(options={})
+      Configuration.configure(options)
+    end
+
+    # Performs an +ItemLookup+ REST call against the Amazon API.
+    #
+    # Expects an arbitrary number of ASIN (Amazon Standard Identification Number) and returns an array of +SimpleItem+:
+    #
+    #   item = lookup '1430218150'
+    #   item.title
+    #   => "Learn Objective-C on the Mac (Learn Series)"
+    #   items = lookup ['1430218150', '0439023521']
+    #   items[0].title
+    #   => "Learn Objective-C on the Mac (Learn Series)"
+    #   items[1].title
+    #   => "The Hunger Games"
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   lookup(asin, :ResponseGroup => :Medium)
+    #
+    # Or with multiple parameters:
+    #
+    #   lookup(asin, :ResponseGroup => [:Small, :AlternateVersions])
+    #
+    def lookup(*asins)
+      params = asins.last.is_a?(Hash) ? asins.pop : {:ResponseGroup => :Medium}
+      response = call(params.merge(:Operation => :ItemLookup, :ItemId => asins.join(',')))
+      [arrayfy(response['ItemLookupResponse']['Items']['Item']).map {|item| handle_item(item)},response]
+    end
+
+    # Performs an +ItemSearch+ REST call against the Amazon API.
+    #
+    # Expects a search-string which can be an arbitrary array of strings (ASINs f.e.) and returns a list of +SimpleItem+s:
+    #
+    #   items = search_keywords 'Learn', 'Objective-C'
+    #   items.first.title
+    #   => "Learn Objective-C on the Mac (Learn Series)"
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   search_keywords('nirvana', 'never mind', :SearchIndex => :Music)
+    #
+    # Have a look at the different search index values on the Amazon-Documentation[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html]
+    #
+    def search_keywords(*keywords)
+      params = keywords.last.is_a?(Hash) ? keywords.pop : {:SearchIndex => :Books, :ResponseGroup => :Medium}
+      response = call(params.merge(:Operation => :ItemSearch, :Keywords => keywords.join(' ')))
+      
+      [arrayfy(response['ItemSearchResponse']['Items']['Item']).map {|item| handle_item(item)},response]
+    end
+
+    # Performs an +ItemSearch+ REST call against the Amazon API.
+    #
+    # Expects a Hash of search params where and returns a list of +SimpleItem+s:
+    #
+    #   items = search :SearchIndex => :Music
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   search(:Keywords => 'nirvana', :SearchIndex => :Music)
+    #
+    # Have a look at the different search index values on the Amazon-Documentation[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html]
+    #
+    def search(params={:SearchIndex => :Books, :ResponseGroup => :Medium})
+      response = call(params.merge(:Operation => :ItemSearch))
+      [arrayfy(response['ItemSearchResponse']['Items']['Item']).map {|item| handle_item(item)},response]
+    end
+
+    # Performs an +BrowseNodeLookup+ REST call against the Amazon API.
+    #
+    # Expects a Hash of search params where and returns a +SimpleNode+:
+    #
+    #   node = browse_node '163357'
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   browse_node('163357', :ResponseGroup => :TopSellers)
+    #
+    # Have a look at the different browse node values on the Amazon-Documentation[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html]
+    #
+    def browse_node(node_id, params={:ResponseGroup => :BrowseNodeInfo})
+      response = call(params.merge(:Operation => :BrowseNodeLookup, :BrowseNodeId => node_id))
+      [handle_type(response['BrowseNodeLookupResponse']['BrowseNodes']['BrowseNode'], Configuration.node_type),response]
+    end
+
+    # Performs an +CartCreate+ REST call against the Amazon API.
+    #
+    # Expects one ore more item-hashes and returns a +SimpleCart+:
+    #
+    #   cart = create_cart({:asin => '1430218150', :quantity => 1})
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   create_cart({:asin => '1430218150', :quantity => 1}, {:asin => '1430216263', :quantity => 1, :action => :SaveForLater})
+    #
+    # Have a look at the different cart item operation values on the Amazon-Documentation[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html]
+    #
+    def create_cart(*items)
+      cart(:CartCreate, create_item_params(items))
+    end
+
+    # Performs an +CartGet+ REST call against the Amazon API.
+    #
+    # Expects the CartId and the HMAC to identify the returning +SimpleCart+:
+    #
+    #   cart = get_cart('176-9182855-2326919', 'KgeVCA0YJTbuN/7Ibakrk/KnHWA=')
+    #
+    def get_cart(cart_id, hmac)
+      cart(:CartGet, {:CartId => cart_id, :HMAC => hmac})
+    end
+
+    # Performs an +CartAdd+ REST call against the Amazon API.
+    #
+    # Expects a +SimpleCart+ created with +create_cart+ and one ore more Item-Hashes and returns an updated +SimpleCart+:
+    #
+    #   cart = add_items(cart, {:asin => '1430216263', :quantity => 2})
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   add_items(cart, {:asin => '1430218150', :quantity => 1}, {:asin => '1430216263', :quantity => 1, :action => :SaveForLater})
+    #
+    # Have a look at the different cart item operation values on the Amazon-Documentation[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html]
+    #
+    def add_items(cart, *items)
+      cart(:CartAdd, create_item_params(items).merge({:CartId => cart.cart_id, :HMAC => cart.hmac}))
+    end
+
+    # Performs an +CartModify+ REST call against the Amazon API.
+    #
+    # Expects a +SimpleCart+ created with +create_cart+ and one ore more Item-Hashes to modify and returns an updated +SimpleCart+:
+    #
+    #   cart = update_items(cart, {:cart_item_id => cart.items.first.CartItemId, :quantity => 7})
+    #
+    # ==== Options:
+    #
+    # Additional parameters for the API call like this:
+    #
+    #   update_items(cart, {:cart_item_id => cart.items.first.CartItemId, :action => :SaveForLater}, {:cart_item_id => cart.items.first.CartItemId, :quantity => 7})
+    #
+    # Have a look at the different cart item operation values on the Amazon-Documentation[http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html]
+    #
+    def update_items(cart, *items)
+      cart(:CartModify, create_item_params(items).merge({:CartId => cart.cart_id, :HMAC => cart.hmac}))
+    end
+
+    # Performs an +CartClear+ REST call against the Amazon API.
+    #
+    # Expects a +SimpleCart+ created with +create_cart+ and returns an empty +SimpleCart+:
+    #
+    #   cart = clear_cart(cart)
+    #
+    def clear_cart(cart)
+      cart(:CartClear, {:CartId => cart.cart_id, :HMAC => cart.hmac})
+    end
+
+    private()
+    
+    def arrayfy(item)
+      return [] unless item
+      item.is_a?(Array) ? item : [item]
+    end
+
+    def handle_item(item)
+      handle_type(item, Configuration.item_type)
+    end
+
+    def handle_type(data, type)
+      if type.is_a?(Class)
+        type.new(data)
+      elsif type == :mash
+        require 'hashie'
+        Hashie::Mash.new(data)
+      elsif type == :rash
+        require 'rash'
+        Hashie::Rash.new(data)
+      else
+        data
+      end
+    end
+
+    def create_item_params(items)
+      keyword_mappings = {
+        :asin               => 'ASIN',
+        :quantity           => 'Quantity',
+        :cart_item_id       => 'CartItemId',
+        :offer_listing_id   => 'OfferListingId',
+        :action             => 'Action'
+      }
+      params = {}
+      items.each_with_index do |item, i|
+        item.each do |key, value|
+          next unless keyword = keyword_mappings[key]
+          params["Item.#{i}.#{keyword}"] = value.to_s
+        end
+      end
+      params
+    end
+
+    def cart(operation, params={})
+      response = call(params.merge(:Operation => operation))
+      cart = response["#{operation}Response"]['Cart']
+      handle_type(cart, Configuration.cart_type)
+    end
+
+    def call(params)
+      Configuration.validate_credentials!
+ params[:ResponseGroup] = params[:ResponseGroup].collect{|g| g.to_s.strip}.join(',') if !params[:ResponseGroup].nil? && params[:ResponseGroup].is_a?(Array)
+      log(:debug, "calling with params=#{params}")
+      signed = create_signed_query_string(params)
+
+      url = "http://#{Configuration.host}#{PATH}?#{signed}"
+      log(:info, "performing rest call to url='#{url}'")
+
+      response = HTTPI.get(url)
+      if response.code == 200
+        # force utf-8 chars, works only on 1.9 string
+        resp = response.body
+        resp = resp.force_encoding('UTF-8') if resp.respond_to? :force_encoding
+        log(:debug, "got response='#{resp}'")
+        Crack::XML.parse(resp)
+      else
+        log(:error, "got response='#{response.body}'")
+        raise "request failed with response-code='#{response.code}'"
+      end
+    end
+
+    def create_signed_query_string(params)
+      # nice tutorial http://cloudcarpenters.com/blog/amazon_products_api_request_signing/
+      params[:Service] = :AWSECommerceService
+      params[:AWSAccessKeyId] = Configuration.key
+
+      params[:Version] = Configuration.version unless Configuration.blank? :version
+      params[:AssociateTag] = Configuration.associate_tag unless Configuration.blank? :associate_tag
+
+      # utc timestamp needed for signing
+      params[:Timestamp] = Time.now.utc.strftime('%Y-%m-%dT%H:%M:%SZ')
+
+      
+      query = create_query(params)
+
+      # yeah, you really need to sign the get-request not the query
+      request_to_sign = "GET\n#{Configuration.host}\n#{PATH}\n#{query}"
+      hmac = OpenSSL::HMAC.digest(DIGEST, Configuration.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 create_query(params)
+      params.map do |key, value|
+        value = value.collect{|v| v.to_s.strip}.join(',') if value.is_a?(Array)
+        "#{key}=#{CGI.escape(value.to_s)}"
+      end.sort.join('&').gsub('+','%20') # signing needs to order the query alphabetically
+    end
+
+    def log(severity, message)
+      Configuration.logger.send severity, message if Configuration.logger
+    end
+  end
+end