NAME

Template::Provider::Amazon::S3 - Enable template toolkit to use Amazon's S3 service as a provier of templates.

VERSION

version 0.002

SYNOPSIS

use Template;
use Template::Provider::Amazon::S3;

# Specify the provider in the config for Template::Toolkit. 
# Note since the AWS ACCESS KEY, SECRET, and bucket name 
# is not provided here, it will get it from the following 
# Envrionmental variables:
#  AWS_ACCESS_KEY_ID
#  AWS_SECRET_ACCESS_KEY
#  AWS_TEMPLATE_BUCKET
my $tt_config = {
    LOAD_TEMPLATES => [
      Template::Provider::Amazon::S3->new()
    ]
};

my $tt = Template->new($tt_config);
$tt->process('file_on_s3',$vars) || die $tt->error;

METHODS

client

This method will return the S3 client.

bucket

This method will return the bucket that was configure in the begining.

object

returns the object for a given key. 
This method take a key parameter.

  $obj = $self->object( key => 'some_path' );

INHERITED METHODS

These methods are inherited from Template::Provider and function in the same way.

fetch()

store()

load()

include_path()

paths()

DESTROY()

CLASS Methods

$obj = $class->new( %parameters )

constructs a new instance.

Accepts all the arguments as the base class L<Template::Provider>, with the following additions:

key

This is the Amazon Access key, if this is not provided we will try
and load this from the AWS_ACCESS_KEY_ID environment variable.

secrete

This is the Amazon Secret Key, if this is not provided we will try
and load this from the AWS_ACCESS_KEY_SECRET environment variable.

bucketname

This is the bucket that will contain all the templates. If this it
not provided we will try and get it from the AWS_TEMPLATE_BUCKET 
envrionement variable. 

Note do not use the RELATIVE or the ABSOLUTE parameters, I don't know what will happen if they are used. This is a TODO, as well as make better use of the INCLUDE_PATH.

SEE ALSO

Net::Amazon::S3::Client

Net::Amazon::S3::Client::Bucket

Net::Amazon::S3::Client::Object

AUTHOR

Gautam Dey <gdey@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Gautam Dey <gdey@cpan.org>.

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