NAME

       Catmandu::Exporter::Template - a TT2 Template exporter in Catmandu style

SYNOPSIS

           # From the command line
           echo '{"colors":["red","green","blue"]}' |
               catmandu convert JSON to Template --template `pwd`/xml.tt

           where xml.tt like:

           <colors>
           [% FOREACH c IN colors %]
              <color>[% c %]</color>
           [% END %]
           </colors>

           # From perl
           use Catmandu::Exporter::Template;

           my $exporter = Catmandu::Exporter::Template->new(
                       fix => 'myfix.txt'
                       xml => 1,
                       template_before => '<path>/header.xml' ,
                       template => '<path>/record.xml' ,
                       template_after => '<path>/footer.xml' ,
                  );

           $exporter->add_many($arrayref);
           $exporter->add_many($iterator);
           $exporter->add_many(sub { });

           $exporter->add($hashref);

           $exporter->commit; # trigger the template_after

           printf "exported %d objects\n" , $exporter->count;

DESCRIPTION

       This Catmandu::Exporter can be used to export records using Template Toolkit. If you are
       new to Catmandu see Catmandu::Tutorial.

CONFIGURATION

       template
           Required. Must contain path to the template.

       xml Optional. Value: 0 or 1. Prepends xml header to the template.

       template_before
           Optional. Prepend output to the export.

       template_after
           Optional. Append output to the export.

       fix Optional. Apply Catmandu fixes while exporting.

       [Template Toolkit configuration options]
           You can also pass all Template Toolkit configuration options.

SEE ALSO

       Catmandu::Exporter, Template