A portable client library for working with and managing Amazon S3 buckets and keys.
Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib/Amazon
t
CHANGES
MANIFEST
Makefile.PL
README

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.