The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

JALDHAR / Module-Starter-Plugin-CGIApp-0.44 / script / titanium-starter 

            

              
1
—
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
—
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

              
#!/usr/bin/perl -w
=head1 NAME
titanium-starter - creates a skeleton Titanium project
=cut
use warnings;
use strict;
our $VERSION = '0.30';
use Module::Starter qw(
  Module::Starter::Plugin::CGIApp
);
# Provide a sane default
use File::ShareDir qw( dist_dir );
use File::Spec;
if ( !$ENV{MODULE_TEMPLATE_DIR} ) {
    $ENV{MODULE_TEMPLATE_DIR}
      =    ## no critic 'Variables/RequireLocalizedPunctuationVars'
      File::Spec->catdir( dist_dir('Module-Starter-Plugin-CGIApp'),
        'titanium' );
}
use Module::Starter::App;
Module::Starter::App->run;
=head1 SYNOPSIS
 titanium-starter --module=MyApp --author="Jaldhar H. Vyas" --email=jaldhar@braincells.com
Result:
    MyApp
    MyApp/Changes
    MyApp/lib
    MyApp/lib/MyApp.pm
    MyApp/LICENSE
    MyApp/Makefile.PL
    MyApp/MANIFEST.SKIP
    MyApp/MANIFEST
    MyApp/README
    MyApp/server.pl
    MyApp/share/templates
    MyApp/share/templates/runmode1.html
    MyApp/t
    MyApp/t/00-signature.t
    MyApp/t/01-load.t
    MyApp/t/boilerplate.t
    MyApp/t/test-app.t
    MyApp/t/www
    MyApp/t/www/PUT.STATIC.CONTENT.HERE
    MyApp/xt
    MyApp/xt/perlcriticrc
    MyApp/xt/perl-critic.t
    MyApp/xt/pod-coverage.t
    MyApp/xt/pod.t
Options:
    --module=module  Module name 
    --dir=dirname    Directory name to create new module in (optional)
    --builder=module Build with 'ExtUtils::MakeMaker' or 'Module::Build'
    --eumm           Same as --builder=ExtUtils::MakeMaker
    --mb             Same as --builder=Module::Build
    --mi             Same as --builder=Module::Install
    --author=name    Author's name (required)
    --email=email    Author's email (required)
    --license=type   License under which the module will be distributed
                     (default is the same license as perl)
    --verbose        Print progress messages while working
    --force          Delete pre-existing files if needed
    --help           Show this message
=head1 DESCRIPTION
Set up the skeleton of a L<Titanium|Titanium>-based project, including a module,
some templates and some automated tests. 
By default the skeleton files will come within a shared directory
where L<Module::Starter::Plugin::CGIApp|Module::Starter::Plugin::CGIApp> is stored.
See L<File::ShareDir|File::ShareDir> for more information on how this works.
=head1 CONFIGURATION
titanium-starter will look for a configuration file before reading its command
line parameters.  The default location is C<$HOME/.module-starter/config> but
if the MODULE_STARTER_DIR environment variable is set, titanium-starter will look
for C<config> in that directory.
The configuration file is just a list of names and values, separated by colons.
Values that take lists are just space separated.  A sample configuration file
might read:
 author: Jaldhar H. Vyas
 email: jaldhar@braincells.com
 template_dir: ~/.module-starter/cgiapp/templates
 colors: red green blue
This format may become more elaborate in the future, but a file of this type
should remain valid.
=cut