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
=head1 NAME
module-starter - creates a skeleton module distribution
=head1 VERSION
version 1.77
=cut
use warnings;
use strict;
use Module::Starter::App;
our $VERSION = '1.77';
Module::Starter::App->run;
=head1 SYNOPSIS
module-starter [options]
Options:
--module=module Module name (required, repeatable)
--distro=name Distribution name (optional)
--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 (discouraged)
--author=name Author's name (taken from getpwuid if not provided)
--email=email Author's email (taken from EMAIL if not provided)
--ignores=type Ignore type files to include (repeatable)
--license=type License under which the module will be distributed
(default is artistic2)
--genlicense Generate LICENSE file according to specified license
--minperl=ver Minimum Perl version required (optional;
default is 5.006)
--fatalize Generate code that causes all warnings to be fatal with:
use warnings FATAL => 'all'
--verbose Print progress messages while working
--force Delete pre-existing files if needed
--help Show this message
Available Licenses:
perl, artistic, artistic2, mit, mozilla, mozilla2, bsd, freebsd, cc0,
gpl, lgpl, gpl3, lgpl3, agpl3, apache, qpl
You may also specify any L<Software::License> subclass or
L<CPAN Meta Spec license string|CPAN::Meta::Spec/license>.
Available Ignore Types:
cvs, git, hg, manifest, generic
(NOTE: If manifest is included, the MANIFEST file will be skipped
and only a MANIFEST.SKIP file will be included.)
Example:
module-starter --module=Foo::Bar,Foo::Bat \
--author="Andy Lester" --email=andy@petdance.com
=head1 DESCRIPTION
C<module-starter> is a command-line interface to L<Module::Starter>, which it
uses to perform all the work of creating distributions. An alternate backend
for C<module-starter> can be specified with the C<--class> option. Plugins to
the standard Module::Starter module can be specified with one or more
C<--plugin> options.
If no directory name is supplied, the distribution name will be used for the
directory. If no distribution name is supplied, the first listed module name
will be used as the distribution name.
Multiple --builder options may be supplied to produce the files for multiple
builders.
=head1 CONFIGURATION
module-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, module-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. Note that the
C<--ignores> command line parameter corresponds to the C<ignores_type>
configuration file entry. A sample configuration file might read:
author: Ricardo SIGNES
email: rjbs@cpan.org
ignores_type: git
plugins: Module::Starter::Simple Module::Starter::Plugin::XYZ
xyz_option: red green blue
This format may become more elaborate in the future, but a file of this type
should remain valid.
=cut
|
