asin 0.0.7 → 0.0.8

data/README.rdoc

@@ -35,7 +35,3 @@ The gem is tested against 1.9.1 (to be compatible with Heroku Bamboo Stack) and
   # access the internal data representation (Hashie::Mash)
   item.raw.ItemAttributes.ListPrice.FormattedPrice
   => $39.99
-
-== TODO
-
- * Logging

data/lib/asin.rb

@@ -3,6 +3,7 @@ require 'httpclient'
 require 'crack/xml'
 require 'cgi'
 require 'base64'
+require 'logger'
 
 # 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.
@@ -76,12 +77,14 @@ module ASIN
   # [secret] the API secret key
   # [key] the API access key
   # [host] the host, which defaults to 'webservices.amazon.com'
+  # [logger] a different logger than logging to STDERR
   # 
   def configure(options={})
     @options = {
       :host => 'webservices.amazon.com', 
       :path => '/onca/xml', 
       :digest => OpenSSL::Digest::Digest.new('sha256'),
+      :logger => Logger.new(STDERR),
       :key => '', 
       :secret => '',
     } if @options.nil?
@@ -110,18 +113,23 @@ module ASIN
 
   def call(params)
     raise "you have to configure ASIN: 'configure :secret => 'your-secret', :key => 'your-key''" if @options.nil?
+    log(:debug, "calling with params=#{params}")
     signed = create_signed_query_string(params)
-    resp = HTTPClient.new.get_content("http://#{@options[:host]}#{@options[:path]}?#{signed}")
-    if(resp.respond_to? :force_encoding)
-      resp = resp.force_encoding('UTF-8') # force utf-8 chars, works only on 1.9 string
-    end
+    url = "http://#{@options[:host]}#{@options[:path]}?#{signed}"
+    log(:info, "performing rest call to url='#{url}'")
+    resp = HTTPClient.new.get_content(url)
+    # force utf-8 chars, works only on 1.9 string
+    resp = resp.force_encoding('UTF-8') if resp.respond_to? :force_encoding
+    log(:debug, "got response='#{resp}'")
     Crack::XML.parse(resp)
   end
 
-  def create_signed_query_string(params) # http://cloudcarpenters.com/blog/amazon_products_api_request_signing/
+  def create_signed_query_string(params)
+    # nice tutorial http://cloudcarpenters.com/blog/amazon_products_api_request_signing/
     params[:Service] = :AWSECommerceService
     params[:AWSAccessKeyId] = @options[:key]
-    params[:Timestamp] = Time.now.utc.strftime('%Y-%m-%dT%H:%M:%SZ') # utc timestamp needed for signing
+    # utc timestamp needed for signing
+    params[:Timestamp] = Time.now.utc.strftime('%Y-%m-%dT%H:%M:%SZ') 
     
     query = params.map{|key, value| "#{key}=#{CGI.escape(value.to_s)}" }.sort.join('&')
     
@@ -131,5 +139,9 @@ module ASIN
     signature = CGI.escape(Base64.encode64(hmac).chomp)
     "#{query}&Signature=#{signature}"
   end
+  
+  def log(severity, message)
+    @options[:logger].send severity, message if @options[:logger]
+  end
 
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: asin
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 15
   prerelease: false
   segments: 
   - 0
   - 0
-  - 7
-  version: 0.0.7
+  - 8
+  version: 0.0.8
 platform: ruby
 authors: 
 - "Peter Schr\xC3\xB6der"
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-22 00:00:00 +02:00
+date: 2010-08-06 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency