NAME
Module::Start - The Simple/Flexible Way to Create New Modules
SYNOPSIS
From the command line:
> # start a Catalyst plugin
> module-start Catalyst::Model::Funky catalyst
You don't appear to have module-start configured.
Would you like to do that now? [Yn] y
What is your full name? Jimmy James
What is your email address? jj@example.com
Can I configure module-start in /home/jj/.module-start? [Yn] y
Creating /home/jj/.module-start
Changing to directory /home/jj/.module-start
Creating ./config
Installing Default Flavor
Creating ./templates/basic
*Error* No flavor 'catalyst' found in /home/jj/.module-start/templates/
Please install or create a 'catalyst' flavor and try again
Exiting...
> cpan Module::Start::Flavor::Catalyst
... (cpan installs Module::Start::Flavor::Catalyst) ...
> module-start -install Module::Start::Flavor::Catalyst
Installing Flavor 'catalyst'
Changing to directory /home/jj/.module-start
Creating ./templates/catalyst
Module::Start::Flavor::Catalyst successfully installed
> module-start Catalyst::Model::Funky catalyst
Creating module distribution Catalyst-Model-Funky
Changing to directory Catalyst-Model-Funky
Using 'catalyst' flavor templates
Creating Makefile.PL
Creating Changes
Creating lib/Catalyst/Model/Funky.pm
Creating t/00_load.t
Creating README
Creating MANIFEST
Catalyst-Model-Funky successfully started
later...
> cd Catalyst-Model-Funky
> module-start Catalyst::Model::Funky::Boss catalyst
Using 'catalyst' flavor templates
Creating lib/Catalyst/Model/Funkier.pm
DESCRIPTION
If you are like me, when you think of a new idea, you want to get
started asap. If you are even more like me, your projects come in all
sorts of flavors. In other words, different types of projects need
different types of starting files. Within Perl, you have pure perl
modules, XS modules, Inline modules, Kwiki modules, Catalyst modules,
Jifty modules, Plagger modules, and on and on. You also might have JSAN
modules, Ruby modules, Python modules and PHP modules to write.
Module::Start creates a new module distribution (or any other imaginable
set of project files) in a simple straightforward way. All the
boilerplate files come from a set of templates.
CONFIGURATION
All the configuration info is either stored in ~/.module-start/config,
inferred from your environment, or prompted for.
"module-start" will automatically configure itself the first time you
run it. If you want to reconfigure it later, run:
module-start -setup
You are encouraged to edit the contents of the "module-start" base
directory. To change basic configure information, edit the "config"
file. To change or edit template flavors, edit the content of the
"template" directory. Each subdirectory defines a new flavor. You can
set the default flavor in the "config" file.
AUTHOR
Ingy döt Net <ingy@cpan.org>
COPYRIGHT
Copyright (c) 2006. Ingy döt Net. All rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See [http://www.perl.com/perl/misc/Artistic.html]
_____[ config
]_________________________________________________________________
author_full_name: [% author_full_name %] author_email_address: [%
author_email_address %]