NAME

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

VERSION

Version 1.470

    $Id: Template.pm 54 2007-02-06 22:04:46Z andy $

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 apropriate 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
item cvsignore_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

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

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