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

SYNOPSIS
    If you are new to Catmandu see Catmandu::Tutorial.

        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;

METHODS
  new(%opts)
    *   template: Required. Must contain path to the template.

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

    *   template_before: Optional. Prepend template.

    *   template_after: Optional. Append template.

    *   fix: Optional. Apply Catmandu fixes while exporting.

    Catmandu::Exporter::Template can be used to export data objects using
    Template Toolkit. The only required argument is 'template' which points
    to a file to render for each exported object. Set the 'template_before'
    and 'template_before' to add output at the start and end of the export.
    Optionally provide an 'xml' indicator to include a XML header.

  add($hashref)
    Add data $hashref to the exporter.

  commit
    Commit all changes and execute the template_after if given.

  count
    Gives the number of records added to the exporter.

AUTHOR
    Nicolas Steenlant, "<nicolas.steenlant at ugent.be>"

CONTRIBUTOR
    Vitali Peil, "<vitali.peil at uni-bielefeld.de>"

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

SEE ALSO
    Catmandu::Exporter, Template

