NAME

Template::Swig - Perl interface to Django-inspired Swig templating engine.

SYNOPSIS

  my $swig = Template::Swig->new;

  # Compile and render an inline template:
  $swig->compile('message', 'Welcome, {{name}}');
  my $output = $swig->render('message', { name => 'Arthur' });

  # Compile and render a file:
  $swig->compileFromFile('path/to/file.html');
  my $output = $swig->render('path/to/file.html', { some_param => 'foo' });

DESCRIPTION

Template::Swig uses JavaScript::V8 and Paul Armstrong's Swig templating engine to provide fast Django-inspired templating in a Perl context. Templates are compiled to JavaScript functions and stored in memory, then executed each time they're rendered.

Swig's feature list includes multiple inheritance, formatter and helper functions, macros, auto-escaping, and custom tags. See the Swig Documentation for more.

METHODS

new( template_dir => $path, extends_callback => sub { } )

Initialize a swig instance, given the following parameters

template_dir

Optional path where templates live

extends_callback

Optional callback to be run when Swig encounters an extends tag; receives filename and its encoding as parameters

compile($template_name, $swig_source)

Compile a template given, given a template name and swig template source as a string.

compileFromFile($f)

Will compile a file from the filesystem. $f may be either a scalar filename, or a reference to a hash with at least one key, filename.

compile($string)

Will compile data supplied in the scalar $string.

render($template_name, $data)

Render a template, given a name and a reference to a hash of data to interpolate.

TEMPLATE EXAMPLES

Iterate through a list:

  {% for image in images %}
      <img src="{{ image.src }}" width="{{ image.width }}" height="{{ image.height }}">
  {% else %}
      <div class="message">No images to show</div>
  {% endfor %}

Custom helpers / filters:

  {{ created|date('r') }}

Inheritance:

In main.html:

  {% block 'greeting' %}
      Hi, there.
  {% endblock %}
  

In custom.html:

  {% extends 'main.html' %}
  
  {% block 'greeting' %}
      Welcome, {{ name }}
  {% endblock %}

SEE ALSO

Dotiac::DTL, Text::Caml, Template::Toolkit

COPYRIGHT AND LICENSE

Copyright (c) 2012, David Chester

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

cpanm Template::Swig

perl -MCPAN -e shell
install Template::Swig