X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=script%2Fcatalyst.pl;h=e2574ad2962ec19924a0d17cb6fc16df4be45663;hp=ff1a904537ee8da2ab866fc2d1762cb70e764cba;hb=feaaa3d438b9b71a9d577dfefbfc2fc1262e9f16;hpb=4e90e3c19d5c4411edb78516b07088da22a0d178 diff --git a/script/catalyst.pl b/script/catalyst.pl index ff1a904..e2574ad 100755 --- a/script/catalyst.pl +++ b/script/catalyst.pl @@ -3,30 +3,48 @@ use strict; use Getopt::Long; use Pod::Usage; +BEGIN { +eval " use Catalyst::Devel 1.0; "; + +if ($@) { + die < \$help, 'force|nonew' => \$force, 'makefile' => \$makefile, 'scripts' => \$scripts, - 'short' => \$short ); pod2usage(1) if ( $help || !$ARGV[0] ); -my $helper = Catalyst::Helper->new( { - '.newfiles' => !$force, - 'makefile' => $makefile, - 'scripts' => $scripts, - 'short' => $short, -} ); +my $helper = Catalyst::Helper->new( + { + '.newfiles' => !$force, + 'makefile' => $makefile, + 'scripts' => $scripts, + name => $ARGV[0], + } +); +# Pass $ARGV[0] for compatibility with old ::Devel pod2usage(1) unless $helper->mk_app( $ARGV[0] ); 1; @@ -40,14 +58,18 @@ catalyst - Bootstrap a Catalyst application catalyst.pl [options] application-name +'catalyst.pl' creates a skeleton for a new application, and allows you to +upgrade the skeleton of your old application. + Options: -force don't create a .new file where a file to be created exists - -help display this help and exits - -makefile update Makefile.PL only - -scripts update helper scripts only - -short use short types, like C instead of Controller... + -help display this help and exit + -makefile only update Makefile.PL + -scripts only update helper scripts + + application-name must be a valid Perl module name and can include "::", + which will be converted to '-' in the project name. - application-name must be a valid Perl module name and can include "::" Examples: catalyst.pl My::App @@ -76,18 +98,14 @@ contain the following items: a skeleton README file, which you are encouraged to expand on -=item Build.PL - -a C build script - =item Changes a changes file with an initial entry for the creation of the application =item Makefile.PL -an old-style MakeMaker script. Catalyst uses the C system so -this script actually generates a Makeifle that invokes the Build script. +Makefile.PL uses the C system for packaging and distribution +of the application. =item lib @@ -105,27 +123,26 @@ a directory containing helper scripts: =over 4 -=item C +=item C helper script to generate new component modules -=item C +=item C runs the generated application within a Catalyst test server, which can be used for testing without resorting to a full-blown web server configuration. -=item C +=item C runs the generated application as a CGI script -=item C +=item C runs the generated application as a FastCGI script +=item C -=item C - -runs an action of the generated application from the comand line. +runs an action of the generated application from the command line. =back @@ -135,11 +152,9 @@ test directory =back - The application module generated by the C script is functional, although it reacts to all requests by outputting a friendly welcome screen. - =head1 NOTE Neither C nor the generated helper script will overwrite existing @@ -152,22 +167,16 @@ Catalyst or its plugins generate different code, or to see how you may have changed the generated code (although you do of course have all your code in a version control system anyway, don't you ...). - - =head1 SEE ALSO L, L -=head1 AUTHOR - -Sebastian Riedel, C, -Andrew Ford, C +=head1 AUTHORS +Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT -Copyright 2004-2005 Sebastian Riedel. All rights reserved. - This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.