sucker 0.1.0 → 0.1.1

data/README.textile

@@ -1,19 +1,45 @@
 h1. Sucker
 
-Sucker is a thin Ruby wrapper to the Amazon Product Advertising API. It's built on Curb, which is great for querying Amazon on multiple network ports.
+Sucker is a thin Ruby wrapper to the Amazon Product Advertising API. It's built on Curb and Crack.
 
-    @sucker = Sucker.new(
-      :locale => "us",
-      :key    => "key",
-      :secret => "secret")
+I wrote this because ruby_aaws feels somewhat bloated and we are too lazy to conjure a straightforward way to run the latter through multiple network interfaces.
 
-    @sucker.curl { |curl| curl.interface = "eth2" }
+h2. Examples
 
-    @sucker.parameters.merge!({
-        "Operation"   => "ItemLookup",
-        "IdType"      => "ASIN",
-        "ItemId"      => "0816614024" })
-    @sucker.fetch
-    p @sucker.to_h # Now, do something with that hash!
+Woo a worker.
 
-!http://upload.wikimedia.org/wikipedia/commons/a/af/Vacuum_cleaner.jpg!
+bc. @worker = Sucker.new(
+  :locale => "us",
+  :key    => "API KEY",
+  :secret => "API SECRET")
+
+Fiddle with curl.
+
+bc. @worker.curl { |c| c.interface = "eth1" }
+
+Set up a request.
+
+bc. @worker << {
+  "Operation" => "ItemLookup",
+  "IdType"    => "ASIN",
+  "ItemId"    => ["0816614024", "0143105825"] }
+
+Hit the Amazon API.
+
+bc. @worker.fetch
+
+Do something with the response.
+
+bc. pp @worker.to_h
+
+Hit the Amazon API again.
+
+bc. @worker << {
+  "ItemId"  => ["0393329259", "0393317757"] }
+@worker.fetch
+
+Check the integration tests in the spec folder for some more examples.
+
+h2. Tangential Endnote
+
+!http://upload.wikimedia.org/wikipedia/en/7/71/Vacuum_cleaner_1910.JPG!

data/lib/sucker/request.rb

@@ -29,6 +29,11 @@ module Sucker
       args.each { |k, v| send("#{k}=", v) }
     end
 
+    # A helper method that merges a hash into the parameters
+    def <<(hash)
+      self.parameters.merge!(hash)
+    end
+
     # A reusable, configurable cURL object
     def curl
       @curl ||= Curl::Easy.new
@@ -99,7 +104,6 @@ module Sucker
         :query  => sign_query)
     end
 
-    # Timestamps the parameters
     def timestamp_parameters
       self.parameters["Timestamp"] = Time.now.utc.strftime('%Y-%m-%dT%H:%M:%SZ')
     end

data/spec/integration/item_lookup_spec.rb

@@ -10,15 +10,14 @@ module Sucker
 
       # @sucker.curl { |curl| curl.verbose = true }
 
-      @sucker.parameters.merge!({
-          "Operation"   => "ItemLookup",
-          "IdType"      => "ASIN"})
+      @sucker << {
+        "Operation"   => "ItemLookup",
+        "IdType"      => "ASIN" }
     end
 
     context "single item" do
       before do
-        @sucker.parameters.merge!({
-          "ItemId"      => "0816614024" })
+        @sucker << { "ItemId" => "0816614024" }
         @sucker.fetch
         @item = @sucker.to_h["ItemLookupResponse"]["Items"]["Item"]
       end
@@ -38,8 +37,7 @@ module Sucker
 
     context "multiple items" do
       before do
-        @sucker.parameters.merge!({
-          "ItemId"      => ["0816614024", "0143105825"] })
+        @sucker << { "ItemId" => ["0816614024", "0143105825"] }
         @sucker.fetch
         @items = @sucker.to_h["ItemLookupResponse"]["Items"]["Item"]
       end

data/spec/integration/seller_listing_search_spec.rb

@@ -10,9 +10,9 @@ module Sucker
 
       # @sucker.curl { |curl| curl.verbose = true }
 
-      @sucker.parameters.merge!({
-          "Operation"   => "SellerListingSearch",
-          "SellerId"    => "A31N271NVIORU3"})
+      @sucker << {
+        "Operation"   => "SellerListingSearch",
+        "SellerId"    => "A31N271NVIORU3" }
       @sucker.fetch
       @listings = @sucker.to_h["SellerListingSearchResponse"]["SellerListings"]
     end

data/spec/spec_helper.rb

@@ -1,6 +1,5 @@
 require "rubygems"
-require "bundler"
-Bundler.require(:default)
+require "bundler/setup"
 
 require File.expand_path("../../lib/sucker", __FILE__)
 

data/spec/unit/sucker/request_spec.rb

@@ -16,6 +16,13 @@ module Sucker
         end
       end
 
+      context "#<<" do
+        it "merges a hash into the paramters" do
+          @sucker << { "foo" => "bar" }
+          @sucker.parameters["foo"].should eql "bar"
+        end
+      end
+
       context "#curl" do
         it "returns a cURL object" do
           @sucker.curl.should be_an_instance_of Curl::Easy

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: sucker
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 1
-  - 0
-  version: 0.1.0
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Hakan Ensari
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-21 00:00:00 +01:00
+date: 2010-07-22 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency