sucker 1.4.0 → 1.4.1

data/README.md

@@ -10,7 +10,7 @@ Sucker is fast and supports __the entire Amazon API__.
 Usage
 -----
 
-Read the [API](http://aws.amazon.com/archives/Product%20Advertising%20API). Jump to the __Operations__ section if in a hurry.
+Read the [API](http://aws.amazon.com/archives/Product%20Advertising%20API). Skip to the __Operations__ section if in a hurry.
 
 Set up.
 
@@ -58,28 +58,29 @@ To dig further into the response object:
       response.to_hash,
       response.xml
 
-Read further [here](http://rdoc.info/github/papercavalier/sucker/master/frames) and [here](http://relishapp.com/papercavalier/sucker).
+Browse the Sucker API [here](http://rdoc.info/github/papercavalier/sucker/master/frames). To see more advanced examples such as twenty-item batch requests and remote cart manipulation, read [here](http://relishapp.com/papercavalier/sucker).
 
-API Usage
----------
+Managing calls
+--------------
 
-I have a growing cottage industry of gems we use to manage our
-consumption of the Amazon API.
+We have a home-grown collection of gems that help us manage our
+calls to the Amazon API.
 
-* [Multiplex](http://github.com/papercavalier/multiplex) binds a request
-  to a specified local IP.
+* [Multiplex](http://github.com/papercavalier/multiplex) binds a
+  request to a specified local IP.
 * [Throttler](http://github.com/papercavalier/throttler) throttles
   requests to a venue to one per second per IP.
 
-
 A hypothetical setup:
 
     require 'multiplex'
     require 'throttler'
 
     ips.each do |ip|
+
       Thread.new do
         scope = "#{ip}-#{locale}"
+
         Throttler.throttle(scope) do
           Net::HTTP.bind ip do
             # Set up worker
@@ -87,12 +88,16 @@ A hypothetical setup:
             # Consume response
           end
         end
+
       end
+
     end
 
 We prefer to use [Resque](http://github.com/defunkt/resque) to manage
-multiple requests. Generally, four or five workers per venue per IP
-should provide optimum throughput.
+multiple requests.
+
+Generally, four or five workers per locale per IP proves enough to provide
+optimum throughput.
 
 Stubbing in Tests
 -----------------

data/lib/sucker.rb

@@ -6,12 +6,12 @@ require 'sucker/response'
 # Sucker is a Ruby wrapper to the Amazon Product Advertising API.
 module Sucker
 
-  # Initializes a request object
+  # Initializes a request object.
   #
   #   worker = Sucker.new(
   #     :locale => :us,
-  #     :key    => 'API KEY',
-  #     :secret => 'API SECRET')
+  #     :key    => api_key,
+  #     :secret => api_secret)
   #
   def self.new(args={})
     Request.new(args)

data/lib/sucker.rbc

@@ -9,7 +9,7 @@ x
 10
 __script__
 i
-55
+46
 5
 7
 0
@@ -28,39 +28,30 @@ i
 1
 1
 15
-5
-7
-3
-64
-47
-49
-1
-1
-15
 99
 7
-4
+3
 65
 49
-5
+4
 2
 13
 99
 12
 7
-6
+5
 12
 7
-7
+6
 12
 65
 12
 49
-8
+7
 4
 15
 49
-6
+5
 0
 15
 2
@@ -75,17 +66,14 @@ I
 0
 n
 p
-9
+8
 s
-17
-sucker/parameters
+14
+sucker/request
 x
 7
 require
 s
-14
-sucker/request
-s
 15
 sucker/response
 x
@@ -220,11 +208,11 @@ p
 I
 -1
 I
-13
+10
 I
 e
 I
-14
+11
 I
 2b
 x
@@ -243,7 +231,7 @@ p
 I
 2
 I
-13
+10
 I
 d
 x
@@ -255,25 +243,21 @@ x
 13
 attach_method
 p
-9
+7
 I
 0
 I
-3
+1
 I
 9
 I
-4
+2
 I
 12
 I
-5
-I
-1b
-I
-a
+7
 I
-37
+2e
 x
 44
 /Users/hakanensari/code/sucker/lib/sucker.rb

data/lib/sucker/hash.rb

@@ -1,7 +1,14 @@
 module Sucker
+
   class Hash < ::Hash
     class << self
 
+      # Builds a hash from a Nokogiri XML document.
+      #
+      # In earlier versions of Sucker, I was relying on the XML Mini
+      # Nokogiri module in Active Support. This method essentially
+      # accomplishes the same.
+      #
       # Based on https://gist.github.com/335286
       def from_xml(xml)
         case xml

data/lib/sucker/hash.rbc

@@ -0,0 +1,914 @@
+!RBIX
+0
+x
+M
+1
+n
+n
+x
+10
+__script__
+i
+28
+99
+7
+0
+65
+49
+1
+2
+13
+99
+12
+7
+2
+12
+7
+3
+12
+65
+12
+49
+4
+4
+15
+49
+2
+0
+15
+2
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+5
+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
+44
+43
+0
+65
+49
+1
+3
+13
+99
+12
+7
+2
+12
+7
+3
+12
+65
+12
+49
+4
+4
+15
+49
+2
+0
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+5
+x
+4
+Hash
+x
+10
+open_class
+x
+14
+__class_init__
+M
+1
+n
+n
+x
+4
+Hash
+i
+28
+5
+66
+5
+99
+12
+49
+0
+1
+13
+99
+12
+7
+1
+12
+7
+2
+12
+65
+12
+49
+3
+4
+15
+54
+50
+1
+0
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+4
+x
+16
+object_metaclass
+x
+18
+__metaclass_init__
+M
+1
+n
+n
+x
+18
+__metaclass_init__
+i
+16
+5
+66
+99
+7
+0
+7
+1
+65
+67
+49
+2
+0
+49
+3
+4
+11
+I
+5
+I
+0
+I
+0
+I
+0
+n
+p
+4
+x
+8
+from_xml
+M
+1
+n
+n
+x
+8
+from_xml
+i
+144
+20
+0
+13
+45
+0
+1
+43
+2
+43
+3
+12
+49
+4
+1
+9
+67
+15
+5
+13
+72
+5
+47
+9
+36
+47
+49
+6
+0
+13
+47
+49
+7
+0
+15
+8
+40
+47
+49
+5
+0
+20
+0
+49
+8
+0
+49
+9
+0
+5
+20
+0
+49
+8
+0
+47
+49
+10
+1
+13
+18
+3
+49
+11
+2
+15
+8
+143
+13
+45
+0
+12
+43
+2
+43
+13
+12
+49
+4
+1
+9
+134
+15
+5
+13
+72
+5
+47
+9
+101
+47
+49
+6
+0
+13
+47
+49
+7
+0
+15
+8
+105
+47
+49
+5
+0
+19
+1
+15
+20
+0
+49
+14
+0
+56
+15
+50
+16
+0
+15
+20
+0
+49
+17
+0
+56
+18
+50
+19
+0
+15
+20
+1
+8
+143
+15
+20
+0
+49
+20
+0
+49
+21
+0
+11
+I
+6
+I
+2
+I
+1
+I
+1
+n
+p
+22
+x
+8
+Nokogiri
+n
+x
+3
+XML
+x
+8
+Document
+x
+3
+===
+x
+3
+new
+x
+8
+allocate
+x
+10
+initialize
+x
+4
+root
+x
+4
+name
+x
+8
+from_xml
+x
+3
+[]=
+n
+x
+7
+Element
+x
+10
+attributes
+M
+1
+p
+2
+x
+9
+for_block
+t
+n
+x
+8
+from_xml
+i
+28
+58
+37
+19
+0
+15
+37
+19
+1
+15
+15
+21
+1
+1
+20
+0
+20
+1
+49
+0
+0
+13
+18
+3
+49
+1
+2
+15
+11
+I
+7
+I
+2
+I
+2
+I
+2
+n
+p
+2
+x
+5
+value
+x
+3
+[]=
+p
+5
+I
+0
+I
+14
+I
+a
+I
+15
+I
+1c
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+2
+x
+3
+key
+x
+9
+attribute
+x
+9
+each_pair
+x
+8
+children
+M
+1
+p
+2
+x
+9
+for_block
+t
+n
+x
+8
+from_xml
+i
+159
+57
+19
+0
+15
+5
+20
+0
+47
+49
+0
+1
+19
+1
+15
+20
+0
+49
+1
+0
+7
+2
+64
+83
+3
+9
+56
+21
+1
+1
+49
+4
+0
+9
+39
+20
+1
+31
+8
+54
+21
+1
+1
+7
+5
+64
+20
+1
+13
+18
+3
+49
+6
+2
+15
+8
+158
+21
+1
+1
+20
+0
+49
+1
+0
+49
+7
+1
+9
+141
+21
+1
+1
+20
+0
+49
+1
+0
+49
+7
+1
+45
+8
+9
+49
+10
+1
+9
+106
+21
+1
+1
+20
+0
+49
+1
+0
+49
+7
+1
+20
+1
+49
+11
+1
+8
+139
+21
+1
+1
+20
+0
+49
+1
+0
+21
+1
+1
+20
+0
+49
+1
+0
+49
+7
+1
+35
+1
+20
+1
+49
+11
+1
+13
+18
+3
+49
+6
+2
+15
+8
+158
+21
+1
+1
+20
+0
+49
+1
+0
+20
+1
+13
+18
+3
+49
+6
+2
+15
+11
+I
+7
+I
+2
+I
+1
+I
+1
+n
+p
+12
+x
+8
+from_xml
+x
+4
+name
+s
+4
+text
+x
+2
+==
+x
+6
+empty?
+s
+11
+__content__
+x
+3
+[]=
+x
+2
+[]
+x
+5
+Array
+n
+x
+5
+is_a?
+x
+2
+<<
+p
+23
+I
+0
+I
+18
+I
+4
+I
+19
+I
+e
+I
+1b
+I
+1a
+I
+1c
+I
+22
+I
+1d
+I
+27
+I
+1f
+I
+38
+I
+21
+I
+45
+I
+22
+I
+58
+I
+23
+I
+6a
+I
+25
+I
+8d
+I
+28
+I
+9f
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+2
+x
+5
+child
+x
+6
+result
+x
+4
+each
+x
+7
+content
+x
+4
+to_s
+p
+21
+I
+-1
+I
+d
+I
+0
+I
+e
+I
+2
+I
+f
+I
+11
+I
+10
+I
+43
+I
+11
+I
+52
+I
+12
+I
+6c
+I
+14
+I
+77
+I
+18
+I
+82
+I
+2c
+I
+87
+I
+2e
+I
+90
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+2
+x
+3
+xml
+x
+11
+result_hash
+x
+17
+method_visibility
+x
+15
+add_defn_method
+p
+3
+I
+2
+I
+d
+I
+10
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+2
+I
+4
+I
+1c
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+2
+I
+3
+I
+1f
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+0
+I
+1
+I
+1c
+x
+49
+/Users/hakanensari/code/sucker/lib/sucker/hash.rb
+p
+0