/ 
Tie-Amazon-S3-0.02
River stage zero No dependents
/ Tie::Amazon::S3

NAME

Tie::Amazon::S3 - tie Amazon S3 buckets to Perl hashes

VERSION

Version 0.02

SYNOPSIS

use Tie::Amazon::S3;

tie my %bucket, 'Tie::Amazon::S3', 'my-amazon-aws-id',
    'my-amazon-aws-secret', 'my-amazon-s3-bucket';

# use it as you would any Perl hash
$bucket{testfile} = 'this is a testfile';
print $bucket{testfile};
...

METHODS

TIEHASH

Constructor for tying a Net::Amazon::S3 object to a Perl hash.

STORE

Store some scalar into an S3 bucket (Perl hash) key.

FETCH

Fetch an S3 bucket key.

EXISTS

Check if a given key exists in the bucket.

DELETE

Delete a key from the bucket.

CLEAR

Clear the bucket of keys.

SCALAR

Get the count of keys in the bucket.

FIRSTKEY

Get the first key iterator.

NEXTKEY

Get the next key iterator.

s3_croak

Croak to the module user if S3 errs.

AUTHOR

Zak B. Elep, <zakame at cpan.org>

BUGS

The tests cover a few bases, but being not version 1.00 yet, there's going to be some bugs.

Please report any bugs or feature requests to

C<bug-tie-amazon-s3 at rt.cpan.org>,

or through the web interface at

L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Tie-Amazon-S3>.

I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Tie::Amazon::S3

You can also look for information at:

ACKNOWLEDGEMENTS

Leon Brocard, Brad Fitzpatrick, and the AWS programmers for their work.

COPYRIGHT & LICENSE

Copyright 2007 Zak B. Elep.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Except as contained in this notice, the name(s) of the above copyright holders shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.