NAME

CGI::Application::Structured::Tools::Starter - template based module starter for CGI::Application::Structured apps.

SYNOPSIS

    use Module::Starter qw(
        Module::Starter::Simple
        Module::Starter::Plugin::Template
        CGI::Application::Structured::Tools::Starter
    );

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


    

ABSTRACT

The prefered method for using this module is via the "cas-starter.pl" in scripts script.

VERSION

Version 0.015

DESCRIPTION

This is a plugin for Module::Starter that builds a skeleton CGI::Application::Structured module with all the extra files needed to package it for CPAN. It also generates - an CGI::Application::Structured controller base class for your modules - a customized CGI::Application::Dispatch subclass - a preconfigured development config file - a server.pl that runs out of the box - helper scripts to generate Controller modules subclasses - a helper script to generate DBIx::Class schema and result classes.

This module is inspired Module::Starter::Plugin::CGIApp by Jaldhar H. Vyas .

METHODS

new ( %args )

This method calls the new supermethod from Module::Starter::Plugin::Template and then initializes the template store and renderer. (See templates and renderer below.)

create_distro ( %args )

This method works as advertised in Module::Starter.

create_t( @modules )

This method creates a bunch of *.t files. @modules is a list of all modules in the distribution.

render( $template, \%options )

This method is subclassed from Module::Starter::Plugin::Template.

It is given an HTML::Template and options and returns the resulting document.

Data in the Module::Starter object which represents a reference to an array @foo is transformed into an array of hashes with one key called $foo_item in order to make it usable in an HTML::Template TMPL_LOOP. For example:

    $data = ['a'. 'b', 'c'];

would become:

    $data = [
        { data_item => 'a' },
        { data_item => 'b' },
        { data_item => 'c' },
    ];
    

so that in the template you could say:

    <tmpl_loop data>
        <tmpl_var data_item>
    </tmpl_loop>
    

renderer ()

This method is subclassed from Module::Starter::Plugin::Template but doesn't do anything as the actual template is created by render in this implementation.

templates ()

This method is subclassed from Module::Starter::Plugin::Template.

It reads in the template files and populates the object's templates attribute. The module template directory is found by checking the MODULE_TEMPLATE_DIR environment variable and then the config option template_dir.

create_MANIFEST_SKIP()

This method creates a MANIFEST.SKIP file in the distribution's directory so that unneeded files can be skipped from inclusion in the distribution.

create_perlcriticrc ()

This method creates a perlcriticrc in the distribution's test directory so that the behavior of perl-critic.t can be modified.

create_server_pl ()

This method creates server.pl in the distribution's root directory.

create_debug_sh ()

This method creates debug.sh in the distribution's root directory. Starts werver with environment set to display ::Plugin::DebugScreen on error

create_config_pl ()

This method creates config-test.pl in the distribution's root/config directory.

create_create_pl ()

This method creates create_controller.pl in the distribution's app/script directory.

create_tmpl ()

This method takes all the template files ending in .tmpl (representing HTML::Template's and installs them into a directory under the distro tree. For instance if the distro was called Foo-Bar, the templates would be installed in Foo-Bar/templates.

Note the files will just be copied over not rendered.

create_submodule ()

Implements a default "Home" subclass of the main module. This module will be auto configured as the default module in the Dispatch subclass.

create_submodule ()

Implements a default controller baseclass (main module).

create_dbic_pl ()

This method creates create_dbic_schema.pl in the distribution's root/script/ directory.

create_dispatch ()

Implements a CGI::Application::Dispatch subclass for this app in the lib directory under the main modules directory.

BUGS

Please report any bugs or feature requests to 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.

AUTHOR

Gordon Van Amburg, <vanamburg at cpan.org>

ACKNOWLEDGEMENT

This module borrows heavily, is verily grafted from, <Module::Starter::Plugin::CGIApp> by Jaldhar H. Vyas, <jaldhar at braincells.com>

COPYRIGHT

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

SEE ALSO

CGI::Application::Structured-starter, CGI::Application::Structured, CGI::Application, Module::Starter::Plugin::CGIApplication

cpanm CGI::Application::Structured::Tools

perl -MCPAN -e shell
install CGI::Application::Structured::Tools