sucker 1.3.0.pre.2 → 1.3.0.pre.3

data/README.md

@@ -1,18 +1,19 @@
 Sucker
 ======
 
-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).
+Sucker is a Nokogiri-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__.
+It's minimalist and fast. It supports __the entire API__.
 
 ![Electrolux](https://github.com/papercavalier/sucker/raw/master/electrolux.jpg)
 
+Trim fat
+--------
+1.3.0.pre has major changes under the hood.
 
-1.3.0.pre
----------
-This release has major changes under the hood.
+Active Support and Curb are no more.
 
-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.
+I edited out some nonessential methods. Check [here](http://rdoc.info/github/papercavalier/sucker/master/frames) to see what's left.
 
 Usage
 -----
@@ -32,13 +33,13 @@ Build a request.
       "ItemId"        => '0816614024',
       "ResponseGroup" => 'ItemAttributes' }
 
-Get a response.
+Literally, get a response.
 
     response = worker.get
 
-Consume.
+Time for some business logic.
 
-    items = response.find('Item') if response.valid?
+    items = response['Item'] if response.valid?
 
 Repeat ad infinitum.
 
@@ -47,27 +48,37 @@ Repeat ad infinitum.
 [Read the API.](https://affiliate-program.amazon.co.uk/gp/advertising/api/detail/main.html)
 
 
-Multiple local IPs
-------------------
+Monkey-patch that Net::HTTP
+---------------------------
+
+Amazon limits calls to a venue to one per second per IP address.
+
+If your server has multiple local interfaces, do the following:
 
-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:
+    your_ips.each do |ip|
+      Thread.new do
+        worker.local_ip = ip
+        worker.get
+      end
+    end
 
-    worker.local_ip = '75.80.85.90'
-    worker.get # This request will route through the above IP
+Throttle calls
+----------------
+
+Use [Throttler](https://github.com/papercavalier/throttler) to throttle calls to one per second per IP address. Let me know if you figure out a more elegant solution.
 
 More concise syntax
 -------------------
 
-If you are on Ruby 1.9, try:
+If you are on Ruby 1.9, do:
 
     worker << {
       operation: 'ItemLookup',
       id_type:   'ASIN',
       item_id:   '0816614024' }
 
-Stubbing
---------
+Stub
+----
 
 Use [VCR](http://github.com/myronmarston/vcr).
 
@@ -78,7 +89,9 @@ Compatibility
 
 Specs pass against Ruby 1.8.7, Ruby 1.9.2, JRuby 1.5.6, and Rubinius 1.2.1.
 
-Morale of the story
+Morale(s) of the story
 -------------------
 
 Don't overabstract a spaghetti API.
+
+Fancy a DSL? Write your own on top of this.

data/lib/sucker.rb

@@ -1,6 +1,5 @@
 # encoding: utf-8
 
-require 'sucker/parameters'
 require 'sucker/request'
 require 'sucker/response'
 

data/lib/sucker.rbc

@@ -0,0 +1,281 @@
+!RBIX
+0
+x
+M
+1
+n
+n
+x
+10
+__script__
+i
+55
+5
+7
+0
+64
+47
+49
+1
+1
+15
+5
+7
+2
+64
+47
+49
+1
+1
+15
+5
+7
+3
+64
+47
+49
+1
+1
+15
+99
+7
+4
+65
+49
+5
+2
+13
+99
+12
+7
+6
+12
+7
+7
+12
+65
+12
+49
+8
+4
+15
+49
+6
+0
+15
+2
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+9
+s
+17
+sucker/parameters
+x
+7
+require
+s
+14
+sucker/request
+s
+15
+sucker/response
+x
+6
+Sucker
+x
+11
+open_module
+x
+15
+__module_init__
+M
+1
+n
+n
+x
+6
+Sucker
+i
+13
+5
+66
+99
+7
+0
+7
+1
+65
+5
+49
+2
+4
+11
+I
+5
+I
+0
+I
+0
+I
+0
+n
+p
+3
+x
+3
+new
+M
+1
+n
+n
+x
+3
+new
+i
+43
+23
+0
+10
+14
+44
+43
+0
+78
+49
+1
+1
+19
+0
+15
+45
+2
+3
+13
+71
+4
+47
+9
+37
+47
+49
+5
+0
+13
+20
+0
+47
+49
+6
+1
+15
+8
+42
+20
+0
+49
+4
+1
+11
+I
+4
+I
+1
+I
+0
+I
+1
+n
+p
+7
+x
+4
+Hash
+x
+16
+new_from_literal
+x
+7
+Request
+n
+x
+3
+new
+x
+8
+allocate
+x
+10
+initialize
+p
+5
+I
+-1
+I
+13
+I
+e
+I
+14
+I
+2b
+x
+44
+/Users/hakanensari/code/sucker/lib/sucker.rb
+p
+1
+x
+4
+args
+x
+13
+attach_method
+p
+3
+I
+2
+I
+13
+I
+d
+x
+44
+/Users/hakanensari/code/sucker/lib/sucker.rb
+p
+0
+x
+13
+attach_method
+p
+9
+I
+0
+I
+3
+I
+9
+I
+4
+I
+12
+I
+5
+I
+1b
+I
+a
+I
+37
+x
+44
+/Users/hakanensari/code/sucker/lib/sucker.rb
+p
+0

data/lib/sucker/parameters.rb

@@ -1,10 +1,5 @@
-# encoding: utf-8
-
-require 'active_support/inflector'
-
-module Sucker #:nodoc:
-
-  class Parameters < Hash #:nodoc:
+module Sucker
+  class Parameters < Hash
     API_VERSION = '2010-11-01'
     SERVICE     = 'AWSECommerceService'
 
@@ -14,11 +9,12 @@ module Sucker #:nodoc:
       self.store 'Timestamp', timestamp
     end
 
+    # Ensures all keys and values are strings and camelizes former.
     def normalize
       inject({}) do |hash, kv|
         k, v = kv
         v = v.is_a?(Array) ? v.join(',') : v.to_s
-        hash[k.to_s.camelize] = v
+        hash[k.to_s.split('_').map {|w| w[0, 1] = w[0, 1].upcase; w }.join] = v
         hash
       end
     end

data/lib/sucker/parameters.rbc

@@ -0,0 +1,723 @@
+!RBIX
+0
+x
+M
+1
+n
+n
+x
+10
+__script__
+i
+37
+5
+7
+0
+64
+47
+49
+1
+1
+15
+99
+7
+2
+65
+49
+3
+2
+13
+99
+12
+7
+4
+12
+7
+5
+12
+65
+12
+49
+6
+4
+15
+49
+4
+0
+15
+2
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+7
+s
+24
+active_support/inflector
+x
+7
+require
+x
+6
+Sucker
+x
+11
+open_module
+x
+15
+__module_init__
+M
+1
+n
+n
+x
+6
+Sucker
+i
+31
+5
+66
+99
+7
+0
+45
+1
+2
+65
+49
+3
+3
+13
+99
+12
+7
+4
+12
+7
+5
+12
+65
+12
+49
+6
+4
+15
+49
+4
+0
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+7
+x
+10
+Parameters
+x
+4
+Hash
+n
+x
+10
+open_class
+x
+14
+__class_init__
+M
+1
+n
+n
+x
+10
+Parameters
+i
+68
+5
+66
+65
+7
+0
+7
+1
+64
+49
+2
+2
+15
+65
+7
+3
+7
+4
+64
+49
+2
+2
+15
+99
+7
+5
+7
+6
+65
+67
+49
+7
+0
+49
+8
+4
+15
+99
+7
+9
+7
+10
+65
+67
+49
+7
+0
+49
+8
+4
+15
+5
+48
+11
+15
+99
+7
+12
+7
+13
+65
+67
+49
+7
+0
+49
+8
+4
+11
+I
+5
+I
+0
+I
+0
+I
+0
+n
+p
+14
+x
+11
+API_VERSION
+s
+10
+2010-11-01
+x
+9
+const_set
+x
+7
+SERVICE
+s
+19
+AWSECommerceService
+x
+10
+initialize
+M
+1
+n
+n
+x
+10
+initialize
+i
+33
+5
+7
+0
+64
+45
+1
+2
+49
+3
+2
+15
+5
+7
+4
+64
+45
+5
+6
+49
+3
+2
+15
+5
+7
+7
+64
+5
+48
+8
+49
+3
+2
+11
+I
+3
+I
+0
+I
+0
+I
+0
+n
+p
+9
+s
+7
+Service
+x
+7
+SERVICE
+n
+x
+5
+store
+s
+7
+Version
+x
+11
+API_VERSION
+n
+s
+9
+Timestamp
+x
+9
+timestamp
+p
+9
+I
+-1
+I
+b
+I
+0
+I
+c
+I
+b
+I
+d
+I
+16
+I
+e
+I
+21
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+0
+x
+17
+method_visibility
+x
+15
+add_defn_method
+x
+9
+normalize
+M
+1
+n
+n
+x
+9
+normalize
+i
+15
+5
+44
+43
+0
+78
+49
+1
+1
+56
+2
+47
+50
+3
+1
+11
+I
+3
+I
+0
+I
+0
+I
+0
+n
+p
+4
+x
+4
+Hash
+x
+16
+new_from_literal
+M
+1
+p
+2
+x
+9
+for_block
+t
+n
+x
+9
+normalize
+i
+75
+58
+37
+19
+0
+15
+37
+19
+1
+15
+15
+20
+1
+97
+37
+19
+2
+15
+37
+19
+3
+15
+15
+2
+15
+20
+3
+45
+0
+1
+49
+2
+1
+9
+44
+20
+3
+7
+3
+64
+49
+4
+1
+8
+49
+20
+3
+49
+5
+0
+19
+3
+15
+20
+0
+20
+2
+49
+5
+0
+49
+6
+0
+20
+3
+13
+18
+3
+49
+7
+2
+15
+15
+20
+0
+11
+I
+9
+I
+4
+I
+2
+I
+2
+n
+p
+8
+x
+5
+Array
+n
+x
+5
+is_a?
+s
+1
+,
+x
+4
+join
+x
+4
+to_s
+x
+8
+camelize
+x
+3
+[]=
+p
+11
+I
+0
+I
+12
+I
+a
+I
+13
+I
+18
+I
+14
+I
+34
+I
+15
+I
+48
+I
+16
+I
+4b
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+4
+x
+4
+hash
+x
+2
+kv
+x
+1
+k
+x
+1
+v
+x
+6
+inject
+p
+5
+I
+-1
+I
+11
+I
+0
+I
+12
+I
+f
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+0
+x
+7
+private
+x
+9
+timestamp
+M
+1
+n
+n
+x
+9
+timestamp
+i
+16
+45
+0
+1
+49
+2
+0
+49
+3
+0
+7
+4
+64
+49
+5
+1
+11
+I
+2
+I
+0
+I
+0
+I
+0
+n
+p
+6
+x
+4
+Time
+n
+x
+3
+now
+x
+3
+utc
+s
+18
+%Y-%m-%dT%H:%M:%SZ
+x
+8
+strftime
+p
+5
+I
+-1
+I
+1c
+I
+0
+I
+1d
+I
+10
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+0
+p
+13
+I
+2
+I
+8
+I
+c
+I
+9
+I
+16
+I
+b
+I
+24
+I
+11
+I
+32
+I
+1a
+I
+36
+I
+1c
+I
+44
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+2
+I
+7
+I
+1f
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+0
+x
+13
+attach_method
+p
+5
+I
+0
+I
+3
+I
+9
+I
+5
+I
+25
+x
+55
+/Users/hakanensari/code/sucker/lib/sucker/parameters.rb
+p
+0