Module-Starter-Plugin-CGIApp by jaldhar

This is a plugin for Module::Starter that builds you a skeleton CGI::Application module with all the extra files needed to package it for CPAN. You can customize the output using HTML::Template.

Install

If you have the Module::Signature module installed, you can verify the integrity of this distribution by typing:

    cpansign -v

Module::Signature requires GnuPG which you can get from: http://www.gnupg.org/download/ A binary version for Windows is available from that page.

Then to install this module, run the following commands:

    perl Build.pl
    ./Build
    ./Build test
    ./Build install

On Windows you don't need to type the preliminary ./

Alternatively, you can do:

    perl Makefile.PL
    make
    make test
    make install

If you are using ActiveState perl on Windows and you don't have a make utility, you can download nmake from: http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe (Replace make with nmake in the instructions above if you are using it.)

If you are using Strawberry perl on Windows, it comes with a make utility called dmake. (Replace make with dmake in the instructions above if you are using it.)

NOTE: At the moment, some of the tests will fail on Windows if the path to the directory you unpacked the distribution in has spaces in it. Either skip the tests or move to another directory.

Dependencies

This module requires these other modules:

• Perl 5.008
• HTML-Template
• Module-Starter

At build time you will need the above modules plus the following if you want to run all the tests:

• File::Copy::Recursive
• File::DirCompare
• Test::More
• Test::MockTime
• Time::Piece 1.12

The signature can be tested by installing the following module:

• Module::Signature

and setting the environment variable TEST_SIGNATURE to 1.

Further tests are enabled by setting the environment variable RELEASE_TESTING to 1 and installing the following modules:

• Perl::Critic 1.098
• Perl::MinimumVersion 1.20
• Pod::Coverage 0.18
• Pod::Simple 3.07
• Test::CPAN::Meta 0.12
• Test::DistManifest 1.003
• Test::HasVersion 0.012
• Test::Kwalitee
• Test::MinimumVersion 0.008
• Test::Perl::Critic 1.01
• Test::Pod 1.26
• Test::Pod::Coverage 1.08

They are all available on CPAN (http://www.cpan.org)

Support and Documentation

After installing, you can find documentation for this module with the perldoc command.

    perldoc Module::Starter::Plugin::CGIApp

You can also look for information at:

• Search CPAN
• CPAN Request Tracker
• AnnoCPAN, annotated CPAN documentation
• CPAN Ratings

Copyright and License

Copyright (C) 2010, Consolidated Braincells Inc. All Rights Reserved.

This distribution is free software; you can redistribute it and/or modify it under the terms of either:

a) the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version, or

b) the Artistic License version 2.0.

The full text of the license can be found in the LICENSE file included with this distribution.

Contact

Jaldhar H. Vyas <jaldhar@braincells.com>

Download

Download this project from CPAN

You can also download this project from GitHub in either zip or tar formats.

Or you can clone the project with Git by running:

$ git clone git://github.com/jaldhar/Module-Starter-Plugin-CGIApp