README

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.