Accept an array of ASINs in lookup method.

cassettes/lookup_1430218150-0439023521_multiple.yml

@@ -0,0 +1,26 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://webservices.amazon.com:80/onca/xml?AWSAccessKeyId=AKIAJFA5X7RTOKFNPVZQ&ItemId=1430218150,0439023521&Operation=ItemLookup&ResponseGroup=Medium&Service=AWSECommerceService&Signature=ePjFYsif9+GmD1bIfBQRff+qLRQJTUc9/c4Vqdfl2aY=&Timestamp=2011-08-15T08:25:26Z&Version=2010-11-01
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      date: 
+      - Mon, 15 Aug 2011 08:25:28 GMT
+      server: 
+      - Server
+      content-type: 
+      - text/xml;charset=UTF-8
+      vary: 
+      - Accept-Encoding,User-Agent
+      nncoection: 
+      - close
+      transfer-encoding: 
+      - chunked
+    body: "<?xml version=\"1.0\" ?><ItemLookupResponse xmlns=\"http://webservices.amazon.com/AWSECommerceService/2010-11-01\"><OperationRequest><RequestId>39985dce-ac7a-43f6-9907-353162df68c6</RequestId><Arguments><Argument Name=\"Operation\" Value=\"ItemLookup\"></Argument><Argument Name=\"Service\" Value=\"AWSECommerceService\"></Argument><Argument Name=\"Signature\" Value=\"ePjFYsif9+GmD1bIfBQRff+qLRQJTUc9/c4Vqdfl2aY=\"></Argument><Argument Name=\"Version\" Value=\"2010-11-01\"></Argument><Argument Name=\"ItemId\" Value=\"1430218150,0439023521\"></Argument><Argument Name=\"AWSAccessKeyId\" Value=\"AKIAJFA5X7RTOKFNPVZQ\"></Argument><Argument Name=\"Timestamp\" Value=\"2011-08-15T08:25:26Z\"></Argument><Argument Name=\"ResponseGroup\" Value=\"Medium\"></Argument></Arguments><RequestProcessingTime>0.0169660000000000</RequestProcessingTime></OperationRequest><Items><Request><IsValid>True</IsValid><ItemLookupRequest><Condition>New</Condition><DeliveryMethod>Ship</DeliveryMethod><IdType>ASIN</IdType><MerchantId>Amazon</MerchantId><OfferPage>1</OfferPage><ItemId>1430218150</ItemId><ItemId>0439023521</ItemId><ResponseGroup>Medium</ResponseGroup><ReviewPage>1</ReviewPage><ReviewSort>-SubmissionDate</ReviewSort><VariationPage>All</VariationPage></ItemLookupRequest></Request><Item><ASIN>1430218150</ASIN><DetailPageURL>http://www.amazon.com/Learn-Objective-C-Mac-Mark-Dalrymple/dp/1430218150%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3D1430218150</DetailPageURL><ItemLinks><ItemLink><Description>Technical Details</Description><URL>http://www.amazon.com/Learn-Objective-C-Mac-Mark-Dalrymple/dp/tech-data/1430218150%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink><ItemLink><Description>Add To Baby Registry</Description><URL>http://www.amazon.com/gp/registry/baby/add-item.html%3Fasin.0%3D1430218150%26SubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink><ItemLink><Description>Add To Wedding Registry</Description><URL>http://www.amazon.com/gp/registry/wedding/add-item.html%3Fasin.0%3D1430218150%26SubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink><ItemLink><Description>Add To Wishlist</Description><URL>http://www.amazon.com/gp/registry/wishlist/add-item.html%3Fasin.0%3D1430218150%26SubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink><ItemLink><Description>Tell A Friend</Description><URL>http://www.amazon.com/gp/pdp/taf/1430218150%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink><ItemLink><Description>All Customer Reviews</Description><URL>http://www.amazon.com/review/product/1430218150%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink><ItemLink><Description>All Offers</Description><URL>http://www.amazon.com/gp/offer-listing/1430218150%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D1430218150</URL></ItemLink></ItemLinks><SalesRank>67778</SalesRank><SmallImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL75_.jpg</URL><Height Units=\"pixels\">75</Height><Width Units=\"pixels\">57</Width></SmallImage><MediumImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL160_.jpg</URL><Height Units=\"pixels\">160</Height><Width Units=\"pixels\">121</Width></MediumImage><LargeImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL.jpg</URL><Height Units=\"pixels\">500</Height><Width Units=\"pixels\">379</Width></LargeImage><ImageSets><ImageSet Category=\"primary\"><SwatchImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL30_.jpg</URL><Height Units=\"pixels\">30</Height><Width Units=\"pixels\">23</Width></SwatchImage><SmallImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL75_.jpg</URL><Height Units=\"pixels\">75</Height><Width Units=\"pixels\">57</Width></SmallImage><ThumbnailImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL75_.jpg</URL><Height Units=\"pixels\">75</Height><Width Units=\"pixels\">57</Width></ThumbnailImage><TinyImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL110_.jpg</URL><Height Units=\"pixels\">110</Height><Width Units=\"pixels\">83</Width></TinyImage><MediumImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL._SL160_.jpg</URL><Height Units=\"pixels\">160</Height><Width Units=\"pixels\">121</Width></MediumImage><LargeImage><URL>http://ecx.images-amazon.com/images/I/41kq5bDvnUL.jpg</URL><Height Units=\"pixels\">500</Height><Width Units=\"pixels\">379</Width></LargeImage></ImageSet></ImageSets><ItemAttributes><Author>Mark Dalrymple</Author><Author>Scott Knaster</Author><Binding>Paperback</Binding><Brand>Apress</Brand><CatalogNumberList><CatalogNumberListElement>9781430218159</CatalogNumberListElement></CatalogNumberList><DeweyDecimalNumber>005.117</DeweyDecimalNumber><EAN>9781430218159</EAN><EANList><EANListElement>9781430218159</EANListElement></EANList><Edition>1st ed. 2009. Corr. 3rd printing</Edition><Feature>Apress Learn ObjectiveC on the Mac</Feature><Feature>Take your coding skills to the next level with this extensive guide to ObjectiveC, the native programming language for developing sophisticated software applications for Mac OS X.</Feature><ISBN>1430218150</ISBN><IsEligibleForTradeIn>1</IsEligibleForTradeIn><ItemDimensions><Height Units=\"hundredths-inches\">90</Height><Length Units=\"hundredths-inches\">925</Length><Weight Units=\"hundredths-pounds\">122</Weight><Width Units=\"hundredths-inches\">697</Width></ItemDimensions><Label>Apress</Label><Languages><Language><Name>English</Name><Type>Unknown</Type></Language><Language><Name>English</Name><Type>Original Language</Type></Language><Language><Name>English</Name><Type>Published</Type></Language></Languages><ListPrice><Amount>3999</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$39.99</FormattedPrice></ListPrice><Manufacturer>Apress</Manufacturer><MPN>978-1-4302-1815-9</MPN><NumberOfItems>1</NumberOfItems><NumberOfPages>360</NumberOfPages><PackageDimensions><Height Units=\"hundredths-inches\">102</Height><Length Units=\"hundredths-inches\">921</Length><Weight Units=\"hundredths-pounds\">123</Weight><Width Units=\"hundredths-inches\">701</Width></PackageDimensions><PartNumber>978-1-4302-1815-9</PartNumber><ProductGroup>Book</ProductGroup><ProductTypeName>ABIS_BOOK</ProductTypeName><PublicationDate>2008-12-25</PublicationDate><Publisher>Apress</Publisher><SKU>mon0000005185</SKU><Studio>Apress</Studio><Title>Learn Objective-C on the Mac (Learn Series)</Title><TradeInValue><Amount>68</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$0.68</FormattedPrice></TradeInValue></ItemAttributes><OfferSummary><LowestNewPrice><Amount>1498</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$14.98</FormattedPrice></LowestNewPrice><LowestUsedPrice><Amount>1123</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$11.23</FormattedPrice></LowestUsedPrice><TotalNew>50</TotalNew><TotalUsed>34</TotalUsed><TotalCollectible>0</TotalCollectible><TotalRefurbished>0</TotalRefurbished></OfferSummary><EditorialReviews><EditorialReview><Source>Product Description</Source><Content>&lt;P&gt;Learn Objective-C on the Macintosh is a classic programming primer for Mac OS X developers. And it\xE2\x80\x99s hard to believe, but this will be the only guide to Objective-C specifically aimed at new developers!&lt;/P&gt;</Content><IsLinkSuppressed>0</IsLinkSuppressed></EditorialReview></EditorialReviews></Item><Item><ASIN>0439023521</ASIN><DetailPageURL>http://www.amazon.com/Hunger-Games-Suzanne-Collins/dp/0439023521%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3D0439023521</DetailPageURL><ItemLinks><ItemLink><Description>Technical Details</Description><URL>http://www.amazon.com/Hunger-Games-Suzanne-Collins/dp/tech-data/0439023521%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink><ItemLink><Description>Add To Baby Registry</Description><URL>http://www.amazon.com/gp/registry/baby/add-item.html%3Fasin.0%3D0439023521%26SubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink><ItemLink><Description>Add To Wedding Registry</Description><URL>http://www.amazon.com/gp/registry/wedding/add-item.html%3Fasin.0%3D0439023521%26SubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink><ItemLink><Description>Add To Wishlist</Description><URL>http://www.amazon.com/gp/registry/wishlist/add-item.html%3Fasin.0%3D0439023521%26SubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink><ItemLink><Description>Tell A Friend</Description><URL>http://www.amazon.com/gp/pdp/taf/0439023521%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink><ItemLink><Description>All Customer Reviews</Description><URL>http://www.amazon.com/review/product/0439023521%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink><ItemLink><Description>All Offers</Description><URL>http://www.amazon.com/gp/offer-listing/0439023521%3FSubscriptionId%3DAKIAJFA5X7RTOKFNPVZQ%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3D0439023521</URL></ItemLink></ItemLinks><SalesRank>4</SalesRank><SmallImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL75_.jpg</URL><Height Units=\"pixels\">75</Height><Width Units=\"pixels\">49</Width></SmallImage><MediumImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL160_.jpg</URL><Height Units=\"pixels\">160</Height><Width Units=\"pixels\">104</Width></MediumImage><LargeImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL.jpg</URL><Height Units=\"pixels\">420</Height><Width Units=\"pixels\">274</Width></LargeImage><ImageSets><ImageSet Category=\"primary\"><SwatchImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL30_.jpg</URL><Height Units=\"pixels\">30</Height><Width Units=\"pixels\">20</Width></SwatchImage><SmallImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL75_.jpg</URL><Height Units=\"pixels\">75</Height><Width Units=\"pixels\">49</Width></SmallImage><ThumbnailImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL75_.jpg</URL><Height Units=\"pixels\">75</Height><Width Units=\"pixels\">49</Width></ThumbnailImage><TinyImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL110_.jpg</URL><Height Units=\"pixels\">110</Height><Width Units=\"pixels\">72</Width></TinyImage><MediumImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL._SL160_.jpg</URL><Height Units=\"pixels\">160</Height><Width Units=\"pixels\">104</Width></MediumImage><LargeImage><URL>http://ecx.images-amazon.com/images/I/41CGy%2BCBDaL.jpg</URL><Height Units=\"pixels\">420</Height><Width Units=\"pixels\">274</Width></LargeImage></ImageSet></ImageSets><ItemAttributes><Author>Suzanne Collins</Author><Binding>Paperback</Binding><EAN>9780439023528</EAN><EANList><EANListElement>9780439023528</EANListElement></EANList><Edition>Reprint</Edition><ISBN>0439023521</ISBN><ItemDimensions><Height Units=\"hundredths-inches\">75</Height><Length Units=\"hundredths-inches\">800</Length><Weight Units=\"hundredths-pounds\">70</Weight><Width Units=\"hundredths-inches\">525</Width></ItemDimensions><Label>Scholastic Press</Label><Languages><Language><Name>English</Name><Type>Unknown</Type></Language><Language><Name>English</Name><Type>Original Language</Type></Language><Language><Name>English</Name><Type>Published</Type></Language></Languages><ListPrice><Amount>899</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$8.99</FormattedPrice></ListPrice><Manufacturer>Scholastic Press</Manufacturer><NumberOfItems>1</NumberOfItems><NumberOfPages>384</NumberOfPages><PackageDimensions><Height Units=\"hundredths-inches\">90</Height><Length Units=\"hundredths-inches\">800</Length><Weight Units=\"hundredths-pounds\">70</Weight><Width Units=\"hundredths-inches\">520</Width></PackageDimensions><ProductGroup>Book</ProductGroup><ProductTypeName>ABIS_BOOK</ProductTypeName><PublicationDate>2010-07-03</PublicationDate><Publisher>Scholastic Press</Publisher><ReadingLevel>Young Adult</ReadingLevel><SKU>20110610129137</SKU><Studio>Scholastic Press</Studio><Title>The Hunger Games</Title></ItemAttributes><OfferSummary><LowestNewPrice><Amount>392</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$3.92</FormattedPrice></LowestNewPrice><LowestUsedPrice><Amount>295</Amount><CurrencyCode>USD</CurrencyCode><FormattedPrice>$2.95</FormattedPrice></LowestUsedPrice><TotalNew>152</TotalNew><TotalUsed>102</TotalUsed><TotalCollectible>0</TotalCollectible><TotalRefurbished>0</TotalRefurbished></OfferSummary><EditorialReviews><EditorialReview><Source>Product Description</Source><Content>&lt;p&gt;In the ruins of a place once known as North America lies the nation of Panem, a shining Capitol surrounded by twelve outlying districts.  Long ago the districts waged war on the Capitol and were defeated. As part of the surrender terms, each district agreed to send one boy and one girl to appear in an annual televised event called, \"The Hunger Games,\" a fight to the death on live TV. Sixteen-year-old Katniss Everdeen, who lives alone with her mother and younger sister, regards it as a death sentence when she is forced to represent her district in the Games. The terrain, rules, and level of audience participation may change but one thing is constant: kill or be killed.&lt;/p&gt;   &lt;/div&gt;</Content><IsLinkSuppressed>0</IsLinkSuppressed></EditorialReview></EditorialReviews></Item></Items></ItemLookupResponse>"
+    http_version: "1.1"

lib/asin/client.rb

@@ -128,11 +128,16 @@ def configure(options={})
 
     # Performs an +ItemLookup+ REST call against the Amazon API.
     #
-    # Expects an ASIN (Amazon Standard Identification Number) and returns an +SimpleItem+:
+    # Expects an ASIN (Amazon Standard Identification Number) or an array of ASINs and returns a +SimpleItem+:
     #
     #   item = lookup '1430218150'
     #   item.title
     #   => "Learn Objective-C on the Mac (Learn Series)"
+    #   items = lookup ['1430218150', '0439023521']
+    #   items[0].title
+    #   => "Learn Objective-C on the Mac (Learn Series)"
+    #   items[1].title
+    #   => "The Hunger Games"
     #
     # ==== Options:
     #
@@ -141,8 +146,19 @@ def configure(options={})
     #   lookup(asin, :ResponseGroup => :Medium)
     #
     def lookup(asin, params={:ResponseGroup => :Medium})
+      if asin.is_a?(Array)
+        asin = asin.dup.join(',')
+      end
+
       response = call(params.merge(:Operation => :ItemLookup, :ItemId => asin))
-      handle_item(response['ItemLookupResponse']['Items']['Item'])
+
+      if response['ItemLookupResponse']['Items']['Item'].is_a?(Array)
+        response['ItemLookupResponse']['Items']['Item'].map do |i|
+          handle_item(i)
+        end
+      else
+        handle_item(response['ItemLookupResponse']['Items']['Item'])
+      end
     end
 
     # Performs an +ItemSearch+ REST call against the Amazon API.

spec/search_spec.rb

@@ -81,6 +81,15 @@ module ASIN
         end
       end
 
+      it "should lookup multiple books" do
+        VCR.use_cassette("lookup_#{MULTIPLE_ASINS.join('-')}_multiple", :match_requests_on => [:host, :path]) do
+          items = @helper.lookup(MULTIPLE_ASINS)
+
+          items[0].title.should =~ /Learn Objective/
+          items[1].title.should =~ /Hunger Games/
+        end
+      end
+
       it "should return a custom item class" do
         VCR.use_cassette("lookup_#{ANY_ASIN}_item_class", :match_requests_on => [:host, :path]) do
           module TEST

spec/spec_helper.rb

@@ -15,6 +15,7 @@
 ANY_ASIN            = '1430218150'
 ANY_OTHER_ASIN      = '1430216263'
 ANY_BROWSE_NODE_ID  = '599826'
+MULTIPLE_ASINS      = %w(1430218150 0439023521)
 
 RSpec.configure do |config|
   config.mock_with :rspec