Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rustyconover/amazon-dynamodb

A client for Amazon DynamoDB
https://github.com/rustyconover/amazon-dynamodb

Last synced: 9 days ago
JSON representation

A client for Amazon DynamoDB

Awesome Lists containing this project

README

        

=pod

=encoding UTF-8

=head1 NAME

Amazon::DynamoDB - API support for Amazon DynamoDB

=head1 VERSION

version 0.34

=head1 SYNOPSIS

my $ddb = Amazon::DynamoDB->new(
implementation => 'Amazon::DynamoDB::LWP',
version => '20120810',

access_key => 'access_key',
secret_key => 'secret_key',
# or you specify to use an IAM role
use_iam_role => 1,

host => 'dynamodb.us-east-1.amazonaws.com',
scope => 'us-east-1/dynamodb/aws4_request',
ssl => 1,
debug => 1);

$ddb->batch_get_item(
sub {
my $tbl = shift;
my $data = shift;
print "Batch get: $tbl had " . join(',', %$data) . "\n";
},
RequestItems => {
$table_name => {
Keys => [
{
name => 'some test name here',
}
],
AttributesToGet => [qw(name age)],
}
})->get;

=head1 DESCRIPTION

Provides a L-based API for Amazon's DynamoDB REST API.
See L for available methods.

Current implementations for issuing the HTTP requests:

=over 4

=item * L - use L
for applications based on L (this gives nonblocking behaviour)

=item * L - use L (will
block, timeouts are unlikely to work)

=item * L - use L,
should be suitable for integration into a L application. (not well tested)

=back

=head1 NAME

Amazon::DynamoDB - support for the AWS DynamoDB API

=head1 METHODS

=head1 SEE ALSO

=over 4

=item * L - supports the older (2011) API with v2 signing, so it doesn't work with L.

=item * L - alternative approach using wrappers around AWS commandline tools

=item * L - this module was based off of this initial code.

=back

=head1 IMPLEMENTATION PHILOSOPHY

This module attempts to stick as close to Amazon's API as possible
while making some inconvenient limits easy to work with.

Parameters are named the same, return values are as described.
Documentation for each method is commonly found at:

L

For examples see the test cases, most functionality is well exercised
via tests.

=head1 AUTHORS

=over 4

=item *

Rusty Conover

=item *

Tom Molesworth

=back

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Tom Molesworth, copyright (c) 2014 Lucky Dinosaur LLC. L.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=cut