/usr/share/perl5/Dancer2/Template/Tiny.pm is in libdancer2-perl 0.152000+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | package Dancer2::Template::Tiny;
# ABSTRACT: Template::Tiny engine for Dancer2
$Dancer2::Template::Tiny::VERSION = '0.152000';
use Moo;
use Carp qw/croak/;
use Dancer2::Core::Types;
use Dancer2::Template::Implementation::ForkedTiny;
use Dancer2::FileUtils 'read_file_content';
with 'Dancer2::Core::Role::Template';
has '+engine' => (
isa => InstanceOf ['Dancer2::Template::Implementation::ForkedTiny']
);
sub _build_engine {
Dancer2::Template::Implementation::ForkedTiny->new( %{ $_[0]->config } );
}
sub render {
my ( $self, $template, $tokens ) = @_;
( ref $template || -f $template )
or croak "$template is not a regular file or reference";
my $template_data =
ref $template
? ${$template}
: read_file_content($template);
my $content;
$self->engine->process( \$template_data, $tokens, \$content, )
or die "Could not process template file '$template'";
return $content;
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Dancer2::Template::Tiny - Template::Tiny engine for Dancer2
=head1 VERSION
version 0.152000
=head1 SYNOPSIS
This template engine allows you to use L<Template::Tiny> in L<Dancer2>.
L<Template::Tiny> is an implementation of a subset of L<Template::Toolkit> (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 seamlessly move back to Template::Toolkit whenever you want.
However, Dancer2 uses a modified version of L<Template::Tiny>, which is L<Dancer2::Template::Implementation::ForkedTiny>. It adds 2 features :
=over
=item *
opening and closing tag are now configurable
=item *
CodeRefs are evaluated and their results is inserted in the result.
=back
You can read more on L<Dancer2::Template::Implementation::ForkedTiny>.
To use this engine, all you need to configure in your L<Dancer2>'s
C<config.yaml>:
template: "tiny"
Of course, you can also set this B<while> working using C<set>:
# code code code
set template => 'tiny';
Since L<Dancer2> has internal support for a wrapper-like option with the
C<layout> configuration option, you can have a L<Template::Toolkit>-like WRAPPER
even though L<Template::Tiny> doesn't really support it.
=head1 METHODS
=head2 render($template, \%tokens)
Renders the template. The first arg is a filename for the template file
or a reference to a string that contains the template. The second arg
is a hashref for the tokens that you wish to pass to
L<Template::Toolkit> for rendering.
=head1 SEE ALSO
L<Dancer2>, L<Dancer2::Core::Role::Template>, L<Template::Tiny>,
L<Dancer2::Template::Implementation::ForkedTiny>.
=head1 AUTHOR
Dancer Core Developers
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Alexis Sukrieh.
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
|