1CGIAPP-STARTER(1)     User Contributed Perl Documentation    CGIAPP-STARTER(1)
2
3
4

NAME

6       cgiapp-starter - creates a skeleton CGI::Application project
7

SYNOPSIS

9        cgiapp-starter --module=MyApp --author="Andy Lester" --email=andy@petdance.com
10
11       Result:
12
13           MyApp
14           MyApp/lib
15           MyApp/lib/MyApp.pm
16           MyApp/lib/MyApp/templates/runmode1.html
17           MyApp/t
18           MyApp/t/00-signature.t
19           MyApp/t/01-load.t
20           MyApp/t/boilerplate.t
21           MyApp/t/perlcriticrc
22           MyApp/t/perl-critic.t
23           MyApp/t/pod-coverage.t
24           MyApp/t/pod.t
25           MyApp/t/test-app.t
26           MyApp/t/www
27           MyApp/t/PUT.STATIC.CONTENT.HERE
28           MyApp/Makefile.PL
29           MyApp/Changes
30           MyApp/README
31           MyApp/MANIFEST.SKIP
32           MyApp/MANIFEST
33           MyApp/server.pl
34
35       Options:
36
37           --module=module  Module name
38           --dir=dirname    Directory name to create new module in (optional)
39
40           --builder=module Build with 'ExtUtils::MakeMaker' or 'Module::Build'
41           --eumm           Same as --builder=ExtUtils::MakeMaker
42           --mb             Same as --builder=Module::Build
43           --mi             Same as --builder=Module::Install
44
45           --author=name    Author's name (required)
46           --email=email    Author's email (required)
47           --license=type   License under which the module will be distributed
48                            (default is the same license as perl)
49
50           --verbose        Print progress messages while working
51           --force          Delete pre-existing files if needed
52
53           --help           Show this message
54

DESCRIPTION

56       Set up the skeleton of a CGI::Application-based project, including a
57       module, some templates and some automated tests.
58
59       By default the skeleton files will come within the "templates/"
60       directory where Module::Starter::Plugin::CGIApp is stored.
61
62       Multiple --builder options may be supplied to produce the files for
63       multiple builders.
64

CONFIGURATION

66       You may set new defaults in a config file:
67
68        author: Mark Stosberg
69        email: mark@summersault.com
70        template_dir: ~/.module-starter/cgiapp/templates
71
72       cgiapp-starter will look for a configuration file before reading its
73       command line parameters.  The default location is
74       "$HOME/.module-starter/config" but if the MODULE_STARTER_DIR
75       environment variable is set, cgiapp-starter will look for "config" in
76       that directory.
77
78       The configuration file is just a list of names and values, separated by
79       colons.  Values that take lists are just space separated.  A sample
80       configuration file might read:
81
82        author: Ricardo SIGNES
83        email:  rjbs@cpan.org
84        plugins: Module::Starter::Simple Module::Starter::Plugin::XYZ
85        xyz_option: red green blue
86
87       This format may become more elaborate in the future, but a file of this
88       type should remain valid.
89
90
91
92perl v5.12.1                      2010-07-26                 CGIAPP-STARTER(1)