ruby-paa 0.0.1

data/example/batch_operation

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+#
+# $Id: batch_operation,v 1.3 2010/02/20 16:49:11 ianmacd Exp $
+
+require 'amazon/aws/search'
+ 
+include Amazon::AWS
+include Amazon::AWS::Search
+ 
+rg = ResponseGroup.new( :Small )
+req = Request.new
+req.locale = 'uk'
+req.cache = false
+
+is = ItemSearch.new( 'Books', { 'Title' => 'ruby programming' } )
+is2 = ItemSearch.new( 'Music', { 'Title' => 'stranglers' } )
+#more_is = [ ItemSearch.new( 'Music', { 'Title' => 'stranglers' } ),
+#	    ItemSearch.new( 'DVD', { 'Director' => 'scorsese' } ) ]
+
+more_is = [ ItemSearch.new( 'Music', { 'Artist' => 'stranglers' } ) ]
+
+is.batch( more_is )
+is.response_group = rg
+
+batched_response = req.search( is )
+itemsearch = batched_response.item_search_response[0].items
+
+puts itemsearch

data/example/browse_node_lookup1

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+#
+# $Id: browse_node_lookup1,v 1.4 2010/02/20 16:49:11 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+# This is the node for Social Sciences.
+#
+START_NODE = '11232'
+
+def follow_node(id)
+
+  req ||= Request.new
+  req.locale = 'us'
+
+  bnl = BrowseNodeLookup.new( id, {} )
+  bnl.response_group ||= ResponseGroup.new( 'BrowseNodeInfo' )
+  resp = req.search( bnl )
+
+  #items = resp.browse_node_sets.browse_nodes
+  nodes = resp.browse_node_lookup_response[0].browse_nodes[0].browse_node
+
+  nodes.each do |bn|
+
+    if bn.children
+      puts '%s (%s) has the following children:' % [ bn.name, id ]
+
+      bn.children[0].browse_node.each do |child_node|
+        puts '  %s' % [ child_node.name ]
+      end
+      puts
+
+      bn.children[0].browse_node.each do |child_node|
+        follow_node( child_node.browse_node_id )
+      end
+
+    else
+      puts '%s (%s) has no children.' % [ bn.name, id ]
+    end
+  end
+end
+
+follow_node( START_NODE )

data/example/customer_content_lookup1

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+#
+# $Id: customer_content_lookup1,v 1.4 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+ccl = CustomerContentLookup.new( 'AJDWXANG1SYZP' )
+ccl.response_group = ResponseGroup.new( 'CustomerReviews' )
+
+req = Request.new
+req.locale = 'us'
+
+resp = req.search( ccl )
+
+review = resp.customer_content_lookup_response.customers.customer.customer_reviews.review[0]
+
+printf( "Customer's name is %s.\n", review.reviewer.name )
+printf( "Customer's location is %s.\n", review.reviewer.location )
+printf( "Review date is %s.\n", review.date )
+printf( "Review has received %s votes.\n", review.total_votes )
+printf( "Of these, %d deemed the review helpful.\n", review.helpful_votes )
+printf( "Product reviewed has ASIN '%s'.\n", review.asin )
+printf( "Review summary is: %s.\n", review.summary )
+printf( "Review content is:\n%s.\n", review.content )

data/example/customer_content_search1

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby -w
+#
+# $Id: customer_content_search1,v 1.2 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+ccs = CustomerContentSearch.new( 'ian@caliban.org' )
+ccs.response_group = ResponseGroup.new( 'CustomerInfo' )
+
+req = Request.new
+req.locale = 'us'
+
+resp = req.search( ccs )
+cust = resp.customer_content_search_response.customers.customer
+
+printf( "Customer's ID is %s.\n", cust.customer_id )
+printf( "Customer's nickname is %s.\n", cust.nickname )
+printf( "Customer's location is %s.\n", cust.location.user_defined_location )

data/example/example1

@@ -0,0 +1,78 @@
+#!/usr/bin/ruby -w
+#
+# $Id: example1,v 1.6 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'amazon/aws'
+require 'amazon/aws/search'
+
+# We don't want to have to fully qualify identifiers.
+#
+include Amazon::AWS
+include Amazon::AWS::Search
+
+# If you don't have one of these, don't pass the second argument to
+# Request.new.
+#
+ASSOCIATES_ID = "webservices-20"
+
+# Your access key ID.
+#
+KEY_ID        = "0Y44V8FAFNM119C6PTR2"
+
+request  = Request.new( KEY_ID, ASSOCIATES_ID )
+
+# Create an item search object.
+#
+is = ItemSearch.new( 'Books', { 'Title' => 'ruby programming' } )
+
+# Create a response group object. Examples of response groups are 'Small',
+# 'Medium' and 'Large'. 'Large' returns all data about an item.
+#
+is.response_group = ResponseGroup.new( 'Large' )
+
+# Search for the items, passing the result into a block.
+#
+nr_items = 0
+page_nr = 0
+response = request.search( is, :ALL_PAGES ) do |page|
+  printf( "Page %d had unique request ID %s.\n",
+	  page_nr += 1,
+	  page.item_search_response[0].operation_request[0].request_id )
+  printf( "Page %d contained %d result(s).\n",
+	  page_nr,
+	  page.item_search_response[0].items[0].item.size )
+end
+
+# You don't have to access the items through a block.
+#
+nr_items = 0
+response.each do |page|
+  page.item_search_response[0].items.each do |item_set|
+      nr_items += item_set.item.size
+    end
+  end
+printf( "Search returned %d items.\n", nr_items )
+
+# The first item in the list.
+#
+items = response[0].item_search_response[0].items[0].item
+product1 = items[0]
+puts "\nProperties available for the first product returned:",
+  product1.properties.sort
+puts
+
+# There are three ways to retrieve the property of a product:
+#
+
+# Instance variable:
+#
+p product1.asin
+p product1.item_attributes[0].title
+
+# Feels more like a Hash:
+#
+p product1.item_attributes[0]['list_price'][0]['formatted_price']
+
+# A variation on the hash theme:
+#
+p product1.item_attributes[0][:author]

data/example/help1

@@ -0,0 +1,24 @@
+#!/usr/bin/ruby -w
+#
+# $Id: help1,v 1.2 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+h = Help.new( 'ResponseGroup', 'Large' )
+h.response_group = ResponseGroup.new( 'Help' )
+
+req = Request.new
+req.locale = 'uk'
+
+resp = req.search( h )
+help = resp.help_response[0].information.response_group_information
+
+printf( "The response group 'Large' was created on %s\n", help.creation_date )
+puts 'It can be used with the following operations:'
+puts help.valid_operations.operation.join( ', ' )
+puts
+puts "and causes the following elements to be returned:\n\n"
+puts help.elements.element

data/example/item_lookup1

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+#
+# $Id: item_lookup1,v 1.7 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'rubygems'
+require 'ruby-paa/aws'
+require 'ruby-paa/aws/search'
+require 'active_support/all'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+# Example of a batch operation.
+#
+# The MerchantId restriction is to ensure that we retrieve only items that
+# are for sale by Amazon. This is important when we later want to retrieve the
+# availability status.
+#
+il = ItemLookup.new( 'ASIN', { 'ItemId' => 'B001LJCCC8' } )
+
+#il2 = ItemLookup.new( 'ASIN', { 'ItemId' => 'B000051WBE',
+#				'MerchantId' => 'Amazon' } )
+#il.batch( il2 )
+
+# You can have multiple response groups.
+#
+il.response_group = ResponseGroup.new( 'Medium', 'Offers' )
+
+req = Request.new
+req.locale = 'us'
+
+resp = req.search( il )
+item_sets = resp.item_lookup_response[0].items
+
+item_sets.each do |item_set|
+  item_set.item.each do |item|
+    
+    puts item.to_json
+    puts
+    
+    #attribs = item.item_attributes[0]
+    #puts attribs.label
+    #if attribs.list_price
+    #  puts attribs.title, attribs.list_price[0].formatted_price
+    #end
+  
+    # Availability has become a cumbersome thing to retrieve in AWSv4.
+    #
+    #puts 'Availability: %s' %
+    #  [ item.offers[0].offer[0].offer_listing[0].availability ]
+
+    # puts
+  end
+end

data/example/item_lookup2

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby -w
+#
+# $Id: item_lookup2,v 1.5 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'amazon/aws'
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+# Example of a batch operation.
+#
+# The MerchantId restriction is to ensure that we retrieve only items that
+# are for sale by Amazon. This is important when we later want to retrieve the
+# availability status.
+#
+il = ItemLookup.new( 'ASIN', { 'ItemId' => 'B000065RSW',
+			       'MerchantId' => 'Amazon' } )
+il2 = ItemLookup.new( 'ASIN', { 'ItemId' => 'B000A1INIU',
+				'MerchantId' => 'Amazon' } )
+il.batch( il2 )
+
+# You can have multiple response groups.
+#
+il.response_group = ResponseGroup.new( 'Medium', 'Offers', 'Reviews' )
+
+req = Request.new
+req.locale = 'us'
+
+resp = req.search( il )
+item_sets = resp.item_lookup_response[0].items
+
+item_sets.each do |item_set|
+  item_set.item.each do |item|
+    attribs = item.item_attributes[0]
+    puts attribs.label
+    if attribs.list_price
+      puts attribs.title, attribs.list_price[0].formatted_price
+    end
+  
+    # Availability has become a cumbersome thing to retrieve in AWSv4.
+    #
+    puts 'Availability: %s' %
+      [ item.offers[0].offer[0].offer_listing[0].availability ]
+    puts 'Average rating: %s' % [ item.customer_reviews[0].average_rating ]
+    puts 'Reviewed by %s customers.' %
+      [ item.customer_reviews[0].total_reviews ]
+  
+    puts 'Customers said:'
+    item.customer_reviews[0].review.each do |review|
+      puts '  %s (%s votes)' % [ review.summary, review.total_votes ]
+    end
+  
+    puts
+  end
+end

data/example/item_search1

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+#
+# $Id: item_search1,v 1.5 2010/02/20 16:49:12 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+is = ItemSearch.new( 'Books', { 'Title' => 'Ruby' } )
+is.response_group = ResponseGroup.new( 'Large' )
+
+req = Request.new
+req.locale = 'uk'
+
+resp = req.search( is )
+
+items = resp.item_search_response[0].items[0].item
+
+# Available properties for first item:
+#
+puts items[0].properties
+
+items.each do |item|
+  attribs = item.item_attributes[0]
+  puts attribs.label
+  if attribs.list_price
+    puts attribs.title, attribs.list_price[0].formatted_price, ''
+  end
+end

data/example/item_search2

@@ -0,0 +1,37 @@
+#!/usr/bin/ruby -w
+#
+# $Id: item_search2,v 1.5 2010/02/20 16:49:13 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+# We can use symbols instead of string.
+#
+is = ItemSearch.new( :Music, { :Artist => 'Stranglers' } )
+is.response_group = ResponseGroup.new( :Medium )
+
+req = Request.new
+req.locale = 'uk'
+
+resp = req.search( is, :ALL_PAGES )
+
+# Use of :ALL_PAGES means an array of responses is returned, one per page.
+#
+items = resp.collect { |r| r.item_search_response[0].items[0].item }.flatten
+
+printf( "Search returned %d items.\n", items.size )
+
+items.each do |item|
+  attribs = item.item_attributes[0]
+  puts '%s %s' % [ attribs.title, ( attribs.format ?
+				      "(#{attribs.format})" : '' ) ]
+  puts '%s (%s)' % [ attribs.manufacturer, attribs.binding ]
+  puts 'Release date: %s' % [ attribs.release_date ]
+  puts attribs.list_price[0].formatted_price if attribs.list_price
+  if item.editorial_reviews
+    puts item.editorial_reviews[0].editorial_review[0].content
+  end
+  puts
+end

data/example/item_search3

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+#
+# $Id: item_search3,v 1.4 2010/02/20 16:49:13 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+is = ItemSearch.new( 'Baby', { 'Keywords' => 'pants',
+		               'MinimumPrice' => '2500',
+			       'MaximumPrice' => '4999' } )
+is.response_group = ResponseGroup.new( 'Small' )
+
+req = Request.new
+req.locale = 'us'
+
+resp = req.search( is )
+items = resp.item_search_response[0].items[0].item
+
+printf( "Search returned %d items.\n", items.size )
+
+items.each { |item| puts item, '' }

data/example/list_lookup1

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+#
+# $Id: list_lookup1,v 1.2 2010/02/20 16:49:13 ianmacd Exp $
+
+require 'amazon/aws/search'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+ll = ListLookup.new( '3P722DU4KUPCP', 'Listmania' )
+ll.response_group = ResponseGroup.new( 'ListInfo', 'Small' )
+
+req = Request.new
+req.locale = 'us'
+
+resp = req.search( ll )
+list = resp.list_lookup_response[0].lists[0].list
+
+puts 'List Title: %s' % [ list.list_name ]
+puts 'List created: %s' % [ list.date_created ]
+puts 'List ID: %s' % [ list.list_id ]
+puts 'URL: %s' % [ list.list_url ]
+puts '%s items on list.' % [ list.total_items ]
+puts
+
+list.list_item.each_with_index do |it, idx|
+  att = it.item.item_attributes
+  printf( "%d. %s (%s)\n", idx + 1, att.title, att.product_group )
+end