Amazon::S3 is a portable client library for working with and managing Amazon S3 buckets and keys. INSTALLATION To install this module type the following: perl Makefile.PL make make test make install TESTING Testing S3 is a tricky thing. Amazon wants to charge you a bit of money each time you use their service. And yes, testing counts as using. Because of this, the application's test suite skips anything approaching a real test unless you set these three environment variables: AMAZON_S3_EXPENSIVE_TESTS Doesn't matter what you set it to. Just has to be set AWS_ACCESS_KEY_ID Your AWS access key AWS_ACCESS_KEY_SECRET Your AWS sekkr1t passkey. Be forewarned that setting this environment variable on a shared system might leak that information to another user. Be careful. DEPENDENCIES This module requires these other modules and libraries: Class::Accessor::Fast Digest::MD5::File # for testing Digest::HMAC_SHA1 HTTP::Date LWP::UserAgent MIME::Base64 Test::More # for testing XML::Simple URI::Escape COPYRIGHT AND LICENCE This module was initially based on Net::Amazon::S3 0.41, by Leon Brocard. Net::Amazon::S3 was based on example code from Amazon with this notice: # This software code is made available "AS IS" without warranties of any # kind. You may copy, display, modify and redistribute the software # code either by itself or as incorporated into your code; provided that # you do not remove any proprietary notices. Your use of this software # code is at your own risk and you waive any claim against Amazon # Digital Services, Inc. or its affiliates with respect to your use of # this software code. (c) 2006 Amazon Digital Services, Inc. or its # affiliates. The software is released under the Artistic License. The terms of the Artistic License are described at http://www.perl.com/language/misc/Artistic.html. Except where otherwise noted, Amazon::S3 is Copyright 2008, Timothy Appnel, tima@cpan.org. All rights reserved.