File Coverage

blib/lib/Dancer/Template/Tiny.pm

Criterion	Covered	Total	%
statement	23	23	100.0
branch	3	6	50.0
condition	1	3	33.3
subroutine	7	7	100.0
pod	1	1	100.0
total	35	40	87.5

use strict;
use warnings;
package Dancer::Template::Tiny;
BEGIN {
  $Dancer::Template::Tiny::VERSION = '0.03';
}
# ABSTRACT: Template::Tiny backend to Dancer

use Template::Tiny;
use Dancer::FileUtils 'read_file_content';

use base 'Dancer::Template::Abstract';

my $_template = Template::Tiny->new;

sub render($$$) {
    my ( $self, $template, $tokens ) = @_;

    ( ref $template || -f $template )
        or die "$template is not a regular file or reference";

    my $template_data = ref $template    ?
                            ${$template} :
                            read_file_content($template);

    my $content;

    $_template->process(
        \$template_data,
        $tokens,
        \$content,
    ) or die "Could not process template file '$template'";

    return $content;
}

1;



=pod

=head1 NAME

Dancer::Template::Tiny - Template::Tiny backend to Dancer

=head1 VERSION

version 0.03

=head1 SYNOPSIS

This template engine allows you to use L in L.

L is an implementation of a subset of L (the
major parts) which takes much less memory and is faster. If you're only using
the main functions of Template::Toolkit, you could use Template::Tiny. You can
also seemlessly move back to Template::Toolkit whenver you want.

You can read more on L.

To use this engine, all you need to configure in your L's
C:

    template: "tiny"

Of course, you can also set this B working using C:

    # code code code
    set template => 'tiny';

Since L has internal support for a wrapper-like option with the
C configuration option, you have a WRAPPER like with
L even though L doesn't really support it. :)

=head1 SUBROUTINES/METHODS

=head2 render

Renders the template. Accepts a string to a file or a reference to a string of
the template.

=head1 AUTHOR

Sawyer X, C<<  >>

=head1 BUGS

Please report any bugs or feature requests to
C, or through the web interface at
L.
I will be notified, and then you'll automatically be notified of progress on
your bug as I make changes.

=head1 SUPPORT

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

    perldoc Dancer::Template::Tiny

You can also look for information at:

=over 4

=item * RT: CPAN's request tracker

L

=item * AnnoCPAN: Annotated CPAN documentation

L

=item * CPAN Ratings

L

=item * Search CPAN

L

=back

=head1 ACKNOWLEDGEMENTS

L

=head1 LICENSE AND COPYRIGHT

Copyright 2010 Sawyer X.

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

=head1 AUTHOR

  Sawyer X

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Sawyer X.

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


__END__