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,
[email protected]. All rights reserved.
