RAA - ruby-aws/0.3.0

Ruby/AWS is the sequel to Ruby/Amazon. See the README file in the archive for more information.

Ruby/AWS is a Ruby language library that allows the programmer to retrieve information from the popular Amazon Web site via Amazon Web Services. In addition to the original amazon.com site, the local sites amazon.co.uk, amazon.de, amazon.fr, amazon.ca and amazon.co.jp are also supported.

This library is the sequel to Ruby/Amazon. All too often, sequels fall short of expectations, but Ruby/AWS aims to be better than its predecessor. Arguably, that goal has been attained.

AWS v4 API is currently more or less supported in its entirety, with just a few gaps in the implementation of a couple of operations. Currently implemented operations are:

BrowseNodeLookup
CustomerContentLookup
CustomerContentSearch
Help
ItemLookup
ItemSearch
ListLookup
ListSearch
SellerListingLookup
SellerListingSearch
SellerLookup
SimilarityLookup
TagLookup
TransactionLookup

Multiple operations and batch requests are also supported, but not well tested. Beware of bugs.

Remote shopping cart functionality is now also implemented. This adds the following operations:

CartCreate
CartAdd
CartModify
CartClear


Changes in 0.3.0:

Remote shopping carts are now implemented. See the Amazon::AWS::ShoppingCart module and the Amazon::AWS::ShoppingCart::Cart class.

Basically, this adds Cart.new, Cart#cart_create, Cart#cart_add, Cart#cart_modify and Cart#cart_clear. There's also Cart#each for iterating over the items in a cart.

The version of the Amazon AWS API requested when performing operations is now 2008-04-07. This is the latest at the time of writing.

A new iterator method, AWSObject#each, yields each |property, value| of the AWSObject.

The AWSObject and AWSArray classes have received a few new helper methods that should make AWSObject and single element AWSArray objects behave more akin to strings when they are being compared with strings, matched against regexes, etc.

When searches are performed, greater efforts are now made to determine whether Amazon returned any errors. In particular, batch operations and MultipleOperations may return errors at different locations in the XML tree than normal operations.

A bug that materialised only when using an HTTP proxy has been fixed.


Changes in 0.2.0:

Many more types of operation are now supported. In fact, everything except shopping cart operations is now supported.

Symbols can now be used instead of Strings as parameters when instantiating operation and response group objects.

Image objects can now retrieve their images and optionally overlay them with percentage discount icons.

Compatibility fixes for Ruby 1.9.

Dozens of other fixes and minor improvements.


Changes in 0.1.0:

This version features a completely rewritten XML parser, which dynamically creates classes based on XML returned by AWS. This makes Ruby/AWS highly future-proof.

Multiple operations are now implemented.

Numerous fixes and small improvements have been made.

Large scale code clean-up has been performed.

Much more documentation has been added.