X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FHelper.pm;h=878dc76a80f47c28a4faaae2b0fb6caddc405146;hp=1bf824ce199e6ea9c7fa17b952084512eabe4f0b;hb=4e90e3c19d5c4411edb78516b07088da22a0d178;hpb=e57eb11dc33f2b07a4c1965fe74c439f91033366 diff --git a/lib/Catalyst/Helper.pm b/lib/Catalyst/Helper.pm index 1bf824c..878dc76 100644 --- a/lib/Catalyst/Helper.pm +++ b/lib/Catalyst/Helper.pm @@ -60,7 +60,10 @@ sub mk_app { # Needs to be here for PAR require Catalyst; - return 0 if $name =~ /[^\w\:]/; + if ( $name =~ /[^\w\:]/ ) { + warn "Error: Invalid application name.\n"; + return 0; + } $self->{name} = $name; $self->{dir} = $name; $self->{dir} =~ s/\:\:/-/g; @@ -71,24 +74,30 @@ sub mk_app { $self->{author} = $self->{author} = $ENV{'AUTHOR'} || eval { @{ [ getpwuid($<) ] }[6] } || 'Catalyst developer'; - - unless ( $self->{scripts} ) { + + my $gen_scripts = ( $self->{makefile} ) ? 0 : 1; + my $gen_makefile = ( $self->{scripts} ) ? 0 : 1; + my $gen_app = ( $self->{scripts} || $self->{makefile} ) ? 0 : 1; + + if ( $gen_app ) { $self->_mk_dirs; $self->_mk_appclass; - $self->_mk_build; - $self->_mk_makefile; $self->_mk_readme; $self->_mk_changes; $self->_mk_apptest; $self->_mk_images; $self->_mk_favicon; - $self->_mk_package; } - $self->_mk_cgi; - $self->_mk_fastcgi; - $self->_mk_server; - $self->_mk_test; - $self->_mk_create; + if ( $gen_makefile ) { + $self->_mk_makefile; + } + if ( $gen_scripts ) { + $self->_mk_cgi; + $self->_mk_fastcgi; + $self->_mk_server; + $self->_mk_test; + $self->_mk_create; + } return 1; } @@ -133,13 +142,15 @@ sub mk_component { $type = 'M' if $type =~ /model/i; $type = 'V' if $type =~ /view/i; $type = 'C' if $type =~ /controller/i; - $type = $self->{long_type} unless $self->{short}; - $self->{type} = $type; - $self->{name} = $name; - $self->{class} = "$app\::$type\::$name"; + my $appdir = File::Spec->catdir( split /\:\:/, $app ); + my $test_path = + File::Spec->catdir( $FindBin::Bin, '..', 'lib', $appdir, 'C' ); + $type = $self->{long_type} unless -d $test_path; + $self->{type} = $type; + $self->{name} = $name; + $self->{class} = "$app\::$type\::$name"; # Class - my $appdir = File::Spec->catdir( split /\:\:/, $app ); my $path = File::Spec->catdir( $FindBin::Bin, '..', 'lib', $appdir, $type ); my $file = $name; @@ -217,7 +228,9 @@ sub mk_file { my ( $self, $file, $content ) = @_; if ( -e $file ) { print qq/ exists "$file"\n/; - return 0 unless ( $self->{'.newfiles'} || $self->{scripts} ); + return 0 unless ( $self->{'.newfiles'} + || $self->{scripts} + || $self->{makefile} ); if ( $self->{'.newfiles'} ) { if ( my $f = IO::File->new("< $file") ) { my $oldcontent = join( '', (<$f>) ); @@ -255,10 +268,9 @@ sub next_test { $self->{uri} = $prefix; } my $dir = $self->{test_dir}; - my $type = $self->{type}; - $dir = File::Spec->catdir( $dir, $type ); + my $type = lc $self->{type}; $self->mk_dir($dir); - return File::Spec->catfile( $dir, $tname ); + return File::Spec->catfile( $dir, "$type\_$tname" ); } =head3 render_file @@ -296,17 +308,6 @@ sub _mk_dirs { $self->{t} = File::Spec->catdir( $self->{dir}, 't' ); $self->mk_dir( $self->{t} ); - if ( $self->{short} ) { - $self->mk_dir( File::Spec->catdir( $self->{t}, 'M' ) ); - $self->mk_dir( File::Spec->catdir( $self->{t}, 'V' ) ); - $self->mk_dir( File::Spec->catdir( $self->{t}, 'C' ) ); - } - else { - $self->mk_dir( File::Spec->catdir( $self->{t}, 'Model' ) ); - $self->mk_dir( File::Spec->catdir( $self->{t}, 'View' ) ); - $self->mk_dir( File::Spec->catdir( $self->{t}, 'Controller' ) ); - } - $self->{class} = File::Spec->catdir( split( /\:\:/, $self->{name} ) ); $self->{mod} = File::Spec->catdir( $self->{lib}, $self->{class} ); $self->mk_dir( $self->{mod} ); @@ -336,15 +337,11 @@ sub _mk_appclass { $self->render_file( 'appclass', "$mod.pm" ); } -sub _mk_build { - my $self = shift; - my $dir = $self->{dir}; - $self->render_file( 'build', "$dir\/Build.PL" ); -} - sub _mk_makefile { my $self = shift; - my $dir = $self->{dir}; + $self->{path} = File::Spec->catfile( 'lib', split( '::', $self->{name} ) ); + $self->{path} .= '.pm'; + my $dir = $self->{dir}; $self->render_file( 'makefile', "$dir\/Makefile.PL" ); } @@ -444,14 +441,6 @@ sub _mk_favicon { } -sub _mk_package { - my $self = shift; - my $script = $self->{script}; - my $appprefix = $self->{appprefix}; - $self->render_file( 'package', "$script\/$appprefix\_package.pl" ); - chmod 0700, "$script/$appprefix\_package.pl"; -} - =head1 HELPERS Helpers are classes that provide two methods. @@ -536,9 +525,7 @@ Catalyst based application. =head1 METHODS -=over 4 - -=item default +=head2 default =cut @@ -555,7 +542,7 @@ sub default : Private { # # Uncomment and modify this end action after adding a View component # -#=item end +#=head2 end # #=cut # @@ -563,11 +550,9 @@ sub default : Private { # my ( $self, $c ) = @_; # # # Forward to View unless response body is already defined -# $c->forward('View::') unless $c->response->body; +# $c->forward( $c->view('') ) unless $c->response->body; #} -=back - =head1 AUTHOR [% author %] @@ -581,52 +566,26 @@ it under the same terms as Perl itself. 1; __makefile__ - unless ( eval "use Module::Build::Compat 0.02; 1" ) { - print "This module requires Module::Build to install itself.\n"; +use inc::Module::Install; - require ExtUtils::MakeMaker; - my $yn = - ExtUtils::MakeMaker::prompt( ' Install Module::Build now from CPAN?', 'y' ); +name('[% dir %]'); +abstract('Catalyst Application'); +author('[% author %]'); +version_from('[% path %]'); +license('perl'); - unless ( $yn =~ /^y/i ) { - die " *** Cannot install without Module::Build. Exiting ...\n"; - } - - require Cwd; - require File::Spec; - require CPAN; +requires( Catalyst => '5.57' ); - # Save this 'cause CPAN will chdir all over the place. - my $cwd = Cwd::cwd(); - my $makefile = File::Spec->rel2abs($0); +install_script( glob('script/*.pl') ); - CPAN::Shell->install('Module::Build::Compat') - or die " *** Cannot install without Module::Build. Exiting ...\n"; +catalyst_files(); - chdir $cwd or die "Cannot chdir() back to $cwd: $!"; - } - eval "use Module::Build::Compat 0.02; 1" or die $@; - use lib '_build/lib'; - Module::Build::Compat->run_build_pl( args => \@ARGV ); - require Module::Build; - Module::Build::Compat->write_makefile( build_class => 'Module::Build' ); -__build__ -use strict; -use Catalyst::Build; - -my $build = Catalyst::Build->new( - license => 'perl', - module_name => '[% name %]', - requires => { Catalyst => '5.49' }, - create_makefile_pl => 'passthrough', - script_files => [ glob('script/*') ], - test_files => [ glob('t/*.t'), glob('t/*/*.t') ] -); -$build->create_build_script; +&WriteAll; __readme__ Run script/[% appprefix %]_server.pl to test the application. __changes__ This file documents the revision history for Perl extension [% name %]. + 0.01 [% time %] - initial revision, generated by Catalyst __apptest__ @@ -651,7 +610,7 @@ plan skip_all => 'set TEST_POD to enable this test' unless $ENV{TEST_POD}; all_pod_coverage_ok(); __cgi__ -[% startperl %] -w +[% startperl %] BEGIN { $ENV{CATALYST_ENGINE} ||= 'CGI' } @@ -689,7 +648,7 @@ it under the same terms as Perl itself. =cut __fastcgi__ -[% startperl %] -w +[% startperl %] BEGIN { $ENV{CATALYST_ENGINE} ||= 'FastCGI' } @@ -701,13 +660,15 @@ use lib "$FindBin::Bin/../lib"; use [% name %]; my $help = 0; -my ( $listen, $nproc, $pidfile ); +my ( $listen, $nproc, $pidfile, $manager, $detach ); GetOptions( 'help|?' => \$help, 'listen|l=s' => \$listen, 'nproc|n=i' => \$nproc, 'pidfile|p=s' => \$pidfile, + 'manager|M=s' => \$manager, + 'daemon|d' => \$detach, ); pod2usage(1) if $help; @@ -716,6 +677,8 @@ pod2usage(1) if $help; $listen, { nproc => $nproc, pidfile => $pidfile, + manager => $manager, + detach => $detach, } ); @@ -740,6 +703,10 @@ pod2usage(1) if $help; requires -listen) -p -pidfile specify filename for pid file (requires -listen) + -d -daemon daemonize (requires -listen) + -M -manager specify alternate process manager + (FCGI::ProcessManager sub-class) + or empty string to disable =head1 DESCRIPTION @@ -758,7 +725,7 @@ it under the same terms as Perl itself. =cut __server__ -[% startperl %] -w +[% startperl %] BEGIN { $ENV{CATALYST_ENGINE} ||= 'HTTP'; @@ -776,6 +743,7 @@ my $fork = 0; my $help = 0; my $host = undef; my $port = 3000; +my $keepalive = 0; my $restart = 0; my $restart_delay = 1; my $restart_regex = '\.yml$|\.yaml$|\.pm$'; @@ -788,6 +756,7 @@ GetOptions( 'help|?' => \$help, 'host=s' => \$host, 'port=s' => \$port, + 'keepalive|k' => \$keepalive, 'restart|r' => \$restart, 'restartdelay|rd=s' => \$restart_delay, 'restartregex|rr=s' => \$restart_regex @@ -805,9 +774,10 @@ if ( $debug ) { require [% name %]; [% name %]->run( $port, $host, { - argv => \@argv, - 'fork' => $fork, - restart => $restart, + argv => \@argv, + 'fork' => $fork, + keepalive => $keepalive, + restart => $restart, restart_delay => $restart_delay, restart_regex => qr/$restart_regex/ } ); @@ -829,6 +799,7 @@ require [% name %]; -? -help display this help and exits -host host (defaults to all) -p -port port (defaults to 3000) + -k -keepalive enable keep-alive connections -r -restart restart when files got modified (defaults to false) -rd -restartdelay delay between file checks @@ -857,7 +828,7 @@ it under the same terms as Perl itself. =cut __test__ -[% startperl %] -w +[% startperl %] use strict; use Getopt::Long; @@ -912,27 +883,24 @@ it under the same terms as Perl itself. =cut __create__ -[% startperl %] -w +[% startperl %] use strict; use Getopt::Long; use Pod::Usage; use Catalyst::Helper; -my $help = 0; -my $nonew = 0; -my $short = 0; +my $force = 0; +my $help = 0; GetOptions( - 'help|?' => \$help, - 'nonew' => \$nonew, - 'short' => \$short + 'nonew|force' => \$force, + 'help|?' => \$help ); pod2usage(1) if ( $help || !$ARGV[0] ); -my $helper = - Catalyst::Helper->new( { '.newfiles' => !$nonew, short => $short } ); +my $helper = Catalyst::Helper->new( { '.newfiles' => !$force } ); pod2usage(1) unless $helper->mk_component( '[% name %]', @ARGV ); @@ -947,9 +915,8 @@ pod2usage(1) unless $helper->mk_component( '[% name %]', @ARGV ); [% appprefix %]_create.pl [options] model|view|controller name [helper] [options] Options: + -force don't create a .new file where a file to be created exists -help display this help and exits - -nonew don't create a .new file where a file to be created exists - -short use short types, like C instead of Controller... Examples: [% appprefix %]_create.pl controller My::Controller @@ -970,77 +937,7 @@ Create a new Catalyst Component. Existing component files are not overwritten. If any of the component files to be created already exist the file will be written with a '.new' suffix. -This behavior can be suppressed with the C<-nonew> option. - -=head1 AUTHOR - -Sebastian Riedel, C - -=head1 COPYRIGHT - -Copyright 2004 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. - -=cut -__package__ -[% startperl %] -w - -use strict; -use Getopt::Long; -use Pod::Usage; -use Catalyst::PAR; - -my $core = 0; -my $engine = 'CGI'; -my $help = 0; -my $par = '[% appprefix %].par'; - -GetOptions( - 'core' => \$core, - 'engine=s' => \$engine, - 'help|?' => \$help, - 'par=s' => \$par -); - -pod2usage(1) if $help; - -Catalyst::PAR->new->package( { - core => $core, - engine => $engine, - par => $par, - class => '[% name %]' -} ); - -1; - -=head1 NAME - -[% appprefix %]_package.pl - Package a Catalyst application - -=head1 SYNOPSIS - -[% appprefix %]_package.pl - - Options: - -core also include modules bundled with Perl (defaults to false) - -engine engine to use for dependency detection (defaults to CGI) - -help display this help and exits - -par name for the par archive (defaults to [% appprefix %].par) - - Examples: - [% appprefix %]_package.pl [% appprefix %].par FastCGI - [% appprefix %]_package.pl foo_linux_i386_apache2.par Apache2 - - See also: - perldoc Catalyst::Manual - perldoc Catalyst::Manual::Intro - perldoc pp - -=head1 DESCRIPTION - -Package a Catalyst application with L. +This behavior can be suppressed with the C<-force> option. =head1 AUTHOR @@ -1075,12 +972,12 @@ Catalyst [% long_type %]. [% IF long_type == 'Controller' %] =head1 METHODS -=over 4 +=cut # # Uncomment and modify this or add new actions to fit your needs # -#=item default +#=head2 default # #=cut # @@ -1091,8 +988,6 @@ Catalyst [% long_type %]. # $c->response->body('[% class %] is on Catalyst!'); #} -=back - [% END %] =head1 AUTHOR