Provided by: libmodule-starter-perl_1.620+dfsg-1_all bug

NAME

       Module::Starter::Plugin::Template - module starter with templates

VERSION

       Version 1.62

SYNOPSIS

        use Module::Starter qw(
          Module::Starter::Simple
          Module::Starter::Plugin::Template
        );

        Module::Starter->create_distro(%args);

DESCRIPTION

       This plugin is designed to be added to a Module::Starter::Simple-compatible
       Module::Starter class.  It adds stub methods for template retrieval and rendering, and it
       replaces all of Simple's _guts methods with methods that will retrieve and render the
       appropriate templates.

CLASS METHODS

   "new(%args)"
       This plugin calls the "new" supermethod and then initializes the template store and
       renderer.  (See "templates" and "renderer" below.)

OBJECT METHODS

   "templates()"
       This method is used to initialize the template store on the Module::Starter object.  It
       returns a hash of templates; each key is a filename and each value is the body of the
       template.  The filename Module.pm is used for the module template.

   "renderer()"
       This method is used to initialize the template renderer.  Its result is stored in the
       object's "renderer" entry.  The implementation will determine its use.

   "render($template, \%options)"
       The "render" method will render the template passed to it, using the data in the
       Module::Starter object and in the hash of passed parameters.

   _guts methods
       All of the "FILE_guts" methods from Module::Starter::Simple are subclassed to look
       something like this:

           sub file_guts {
               my $self = shift;
               my %options;
               @options{qw(first second third)} = @_;

               my $template = $self->{templates}{filename};
               $self->render($template, \%options);
           }

       These methods will need to be rewritten when (as is likely) Module::Starter::Simple's
       _guts methods are refactored into a registry.

       module_guts
       Makefile_PL_guts
       MI_Makefile_PL_guts
       Build_PL_guts
       Changes_guts
       README_guts
       t_guts
       MANIFEST_guts
       ignores_guts

AUTHOR

       Ricardo SIGNES, "<rjbs at cpan.org>"

Bugs

       Please report any bugs or feature requests to "bug-module-starter at rt.cpan.org", or
       through the web interface at <http://rt.cpan.org>.  I will be notified, and then you'll
       automatically be notified of progress on your bug as I make changes.

COPYRIGHT

       Copyright 2005-2007 Ricardo SIGNES, All Rights Reserved.

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