sucker 1.2.0 → 1.3.0.pre

data/LICENSE

@@ -1,6 +1,6 @@
 (The MIT License)
  
-Copyright (c) 2010 Paper Cavalier
+Copyright (c) 2011 Paper Cavalier
  
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,59 +1,84 @@
 Sucker
 ======
 
-Sucker is a [cURL-](http://github.com/taf2/curb) and [Nokogiri-](http://github.com/rails/rails/blob/master/activesupport/lib/active_support/xml_mini/nokogiri.rb)driven Ruby wrapper to the [Amazon Product Advertising API](https://affiliate-program.amazon.co.uk/gp/advertising/api/detail/main.html).
+Sucker is a [Nokogiri-](http://github.com/rails/rails/blob/master/activesupport/lib/active_support/xml_mini/nokogiri.rb)based Ruby wrapper to the [Amazon Product Advertising API](https://affiliate-program.amazon.co.uk/gp/advertising/api/detail/main.html).
 
 It's fast and supports __the entire API__.
 
 ![Electrolux](https://github.com/papercavalier/sucker/raw/master/electrolux.jpg)
 
+
+1.3.0.pre
+---------
+This release has major changes under the hood.
+
+I replaced curb with Net::HTTP to make the library JRuby compatible and edited out some nonessential code. Check [here](http://rdoc.info/github/papercavalier/sucker/master/frames) to see what's left.
+
 Usage
 -----
 
-Where's your worker?
+Set up.
 
     worker = Sucker.new(
       :locale => :us,
-      :key    => "API KEY",
-      :secret => "API SECRET")
+      :key    => 'API KEY',
+      :secret => 'API SECRET')
 
-Build a query.
+Build a request.
 
     worker << {
-      "Operation"     => "ItemLookup",
-      "IdType"        => "ASIN",
-      "ItemId"        => some_asins,
-      "ResponseGroup" => "ItemAttributes" }
+      "Operation"     => 'ItemLookup',
+      "IdType"        => 'ASIN',
+      "ItemId"        => '0816614024',
+      "ResponseGroup" => 'ItemAttributes' }
 
 Get a response.
 
     response = worker.get
 
-Parse.
+Consume.
 
-    books = response.map("Item") do |item|
-      # parse
-    end
+    items = response.find('Item') if response.valid?
 
 Repeat ad infinitum.
 
-[Check the features](http://relishapp.com/papercavalier/sucker) for more detailed examples.
+[Check the features](http://relishapp.com/papercavalier/sucker).
+
+[Read the API.](https://affiliate-program.amazon.co.uk/gp/advertising/api/detail/main.html)
+
+
+Multiple local IPs
+------------------
 
-Read the source code and dive into the [Amazon API docs](https://affiliate-program.amazon.co.uk/gp/advertising/api/detail/main.html).
+Amazon limits calls to a venue to one per second per IP. If you have
+multiple interfaces set up and want to use all to query Amazon, just do:
+
+    worker.local_ip = '75.80.85.90'
+    worker.get # This request will route through the above IP
+
+More concise syntax
+-------------------
+
+If you are on Ruby 1.9, try:
+
+    worker << {
+      operation: 'ItemLookup',
+      id_type:   'ASIN',
+      item_id:   '0816614024' }
 
 Stubbing
 --------
 
-Use [VCR](http://github.com/myronmarston/vcr) to stub your requests.
+Use [VCR](http://github.com/myronmarston/vcr).
 
-[This is how my VCR setup looks like](http://github.com/papercavalier/sucker/blob/master/spec/support/vcr.rb).
+Check out [this](http://github.com/papercavalier/sucker/blob/master/spec/support/vcr.rb) and [this](https://github.com/papercavalier/sucker/blob/master/features/step_definitions/sucker_steps.rb).
 
 Compatibility
 -------------
 
-Specs pass against Ruby 1.8.7 and Ruby 1.9.2. Sucker has cURL under the hood, so no JRuby.
+Specs pass against Ruby 1.8.7, Ruby 1.9.2, JRuby 1.5.6, and Rubinius 1.2.1.
 
-Afterword
----------
+Morale of the story
+-------------------
 
 Don't overabstract a spaghetti API.

data/lib/sucker/parameters.rb

@@ -1,21 +1,25 @@
+# encoding: utf-8
+
 require 'active_support/inflector'
 
-module Sucker
-  class Parameters < Hash
+module Sucker #:nodoc:
+
+  class Parameters < Hash #:nodoc:
     API_VERSION = '2010-11-01'
     SERVICE     = 'AWSECommerceService'
 
-    def initialize #:nodoc
+    def initialize
       self.store 'Service',   SERVICE
       self.store 'Version',   API_VERSION
       self.store 'Timestamp', timestamp
     end
 
     def normalize
-      inject({}) do |h, kv|
-        k, v = kv
-        h[k.to_s.camelize] = v.is_a?(Array) ? v.join(',') : v.to_s
-        h
+      inject({}) do |hash, key_value|
+        key, value = key_value
+        value = value.is_a?(Array) ? value.join(',') : value.to_s
+        hash[key.to_s.camelize] = value
+        hash
       end
     end