use FindBin;
use Template;
use Catalyst;
+use Catalyst::Exception;
my %cache;
$cache{$class} = eval "package $class; <DATA>";
}
my $data = $cache{$class};
- my @files = split /^__(.+)__\n/m, $data;
+ my @files = split /^__(.+)__\r?\n/m, $data;
shift @files;
while (@files) {
my ( $name, $content ) = splice @files, 0, 2;
$self->{appprefix} = lc $self->{dir};
$self->{appprefix} =~ s/-/_/g;
$self->{startperl} = $Config{startperl};
- $self->{scriptgen} = $Catalyst::CATALYST_SCRIPT_GEN;
+ $self->{scriptgen} = $Catalyst::CATALYST_SCRIPT_GEN || 4;
$self->{author} = $self->{author} = $ENV{'AUTHOR'}
- || eval { @{ [ getpwuid($<) ] }[6] } || 'A clever guy';
+ || eval { @{ [ getpwuid($<) ] }[6] }
+ || 'Catalyst developer';
$self->_mk_dirs;
$self->_mk_appclass;
$self->_mk_build;
$self->_mk_changes;
$self->_mk_apptest;
$self->_mk_cgi;
- $self->_mk_fcgi;
+ $self->_mk_fastcgi;
$self->_mk_server;
$self->_mk_test;
$self->_mk_create;
my $app = shift;
$self->{app} = $app;
$self->{author} = $self->{author} = $ENV{'AUTHOR'}
- || eval { @{ [ getpwuid($<) ] }[6] } || 'A clever guy';
+ || eval { @{ [ getpwuid($<) ] }[6] }
+ || 'A clever guy';
$self->{base} = File::Spec->catdir( $FindBin::Bin, '..' );
- unless ( $_[0] =~ /^model|m|view|v|controller|c\$/i ) {
+ unless ( $_[0] =~ /^(?:model|m|view|v|controller|c)$/i ) {
my $helper = shift;
my @args = @_;
my $class = "Catalyst::Helper::$helper";
eval "require $class";
- die qq/Couldn't load helper "$class", "$@"/ if $@;
+
+ if ($@) {
+ Catalyst::Exception->throw(
+ message => qq/Couldn't load helper "$class", "$@"/ );
+ }
+
if ( $class->can('mk_stuff') ) {
return 1 unless $class->mk_stuff( $self, @args );
}
else {
my $type = shift;
my $name = shift || "Missing name for model/view/controller";
- my $helper = shift ;
+ my $helper = shift;
my @args = @_;
return 0 if $name =~ /[^\w\:]/;
$type = 'M' if $type =~ /model|m/i;
my @path = split /\:\:/, $name;
$file = pop @path;
$path = File::Spec->catdir( $path, @path );
- mkpath $path;
+ mkpath [$path];
}
$file = File::Spec->catfile( $path, "$file.pm" );
$self->{file} = $file;
$comp = 'Controller' if $type eq 'C';
my $class = "Catalyst::Helper::$comp\::$helper";
eval "require $class";
- die qq/Couldn't load helper "$class", "$@"/ if $@;
+
+ if ($@) {
+ Catalyst::Exception->throw(
+ message => qq/Couldn't load helper "$class", "$@"/ );
+ }
+
if ( $class->can('mk_compclass') ) {
return 1 unless $class->mk_compclass( $self, @args );
}
print qq/ exists "$dir"\n/;
return 0;
}
- if ( mkpath $dir) {
+ if ( mkpath [$dir] ) {
print qq/created "$dir"\n/;
return 1;
}
- die qq/Couldn't create "$dir", "$!"/;
+
+ Catalyst::Exception->throw( message => qq/Couldn't create "$dir", "$!"/ );
}
=head3 mk_file
my ( $self, $file, $content ) = @_;
if ( -e $file ) {
print qq/ exists "$file"\n/;
- return 0;
+ return 0 unless $self->{'.newfiles'};
+ if ( my $f = IO::File->new("< $file") ) {
+ my $oldcontent = join( '', (<$f>) );
+ return 0 if $content eq $oldcontent;
+ }
+ $file .= '.new';
}
if ( my $f = IO::File->new("> $file") ) {
print $f $content;
print qq/created "$file"\n/;
return 1;
}
- die qq/Couldn't create "$file", "$!"/;
+
+ Catalyst::Exception->throw( message => qq/Couldn't create "$file", "$!"/ );
}
=head3 next_test
else {
my $name = $self->{name};
my $prefix = $name;
- $prefix =~ s/::/_/g;
- $prefix = lc $prefix;
+ $prefix =~ s/::/-/g;
+ $prefix = $prefix;
$tname = $prefix . '.t';
$self->{prefix} = $prefix;
+ $prefix = lc $prefix;
+ $prefix =~ s/-/\//g;
+ $self->{uri} = $prefix;
}
my $dir = $self->{test_dir};
- my $type = lc $self->{type};
+ my $type = $self->{type};
return File::Spec->catfile( $dir, $type, $tname );
}
my $template = $self->get_file( ( caller(0) )[0], $file );
return 0 unless $template;
my $output;
- $t->process( \$template, { %{$self}, %$vars }, \$output );
+ $t->process( \$template, { %{$self}, %$vars }, \$output )
+ || Catalyst::Exception->throw(
+ message => qq/Couldn't process "$file", / . $t->error() );
$self->mk_file( $path, $output );
}
$self->mk_dir( $self->{root} );
$self->{t} = File::Spec->catdir( $self->{dir}, 't' );
$self->mk_dir( $self->{t} );
- $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' ) );
+ $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' ) );
$self->{class} = File::Spec->catdir( split( /\:\:/, $self->{name} ) );
$self->{mod} = File::Spec->catdir( $self->{lib}, $self->{class} );
$self->mk_dir( $self->{mod} );
}
sub _mk_cgi {
- my $self = shift;
- my $script = $self->{script};
+ my $self = shift;
+ my $script = $self->{script};
my $appprefix = $self->{appprefix};
$self->render_file( 'cgi', "$script\/$appprefix\_cgi.pl" );
chmod 0700, "$script/$appprefix\_cgi.pl";
}
-sub _mk_fcgi {
- my $self = shift;
- my $script = $self->{script};
+sub _mk_fastcgi {
+ my $self = shift;
+ my $script = $self->{script};
my $appprefix = $self->{appprefix};
- $self->render_file( 'fcgi', "$script\/$appprefix\_fcgi.pl" );
- chmod 0700, "$script/$appprefix\_fcgi.pl";
+ $self->render_file( 'fastcgi', "$script\/$appprefix\_fastcgi.pl" );
+ chmod 0700, "$script/$appprefix\_fastcgi.pl";
}
sub _mk_server {
- my $self = shift;
- my $script = $self->{script};
+ my $self = shift;
+ my $script = $self->{script};
my $appprefix = $self->{appprefix};
$self->render_file( 'server', "$script\/$appprefix\_server.pl" );
chmod 0700, "$script/$appprefix\_server.pl";
}
sub _mk_test {
- my $self = shift;
- my $script = $self->{script};
+ my $self = shift;
+ my $script = $self->{script};
my $appprefix = $self->{appprefix};
$self->render_file( 'test', "$script/$appprefix\_test.pl" );
chmod 0700, "$script/$appprefix\_test.pl";
}
sub _mk_create {
- my $self = shift;
- my $script = $self->{script};
+ my $self = shift;
+ my $script = $self->{script};
my $appprefix = $self->{appprefix};
$self->render_file( 'create', "$script\/$appprefix\_create.pl" );
chmod 0700, "$script/$appprefix\_create.pl";
=head1 LICENSE
-This library is free software . You can redistribute it and/or modify
+This library is free software . You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
[% name %]->setup;
-sub default : Private {
- my ( $self, $c ) = @_;
- $c->res->output('Congratulations, [% name %] is on Catalyst!');
-}
-
=head1 NAME
-[% name %] - A very nice application
+[% name %] - Catalyst based application
=head1 SYNOPSIS
- Very simple to use
+ script/[% appprefix %]_server.pl
=head1 DESCRIPTION
-Very nice application.
+Catalyst based application.
+
+=head1 METHODS
+
+=over 4
+
+=item default
+
+=cut
+
+sub default : Private {
+ my ( $self, $c ) = @_;
+
+ # Hello World
+ $c->response->output('Congratulations, [% name %] is on Catalyst!');
+}
+
+#=item end
+#
+#=cut
+#
+#sub end : Private {
+# my ( $self, $c ) = @_;
+#
+# # Forward to View unless response body is already defined
+# $c->forward('MyApp::V::') unless $c->response->body;
+#}
+
+=back
=head1 AUTHOR
-[%author%]
+[% author %]
=head1 LICENSE
-This library is free software . You can redistribute it and/or modify
+This library is free software . You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
1;
-
__makefile__
unless ( eval "use Module::Build::Compat 0.02; 1" ) {
print "This module requires Module::Build to install itself.\n";
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;
test_files => [ glob('t/*.t'), glob('t/*/*.t') ]
);
$build->create_build_script;
-
__readme__
-Run script/[% apprefix %]_server.pl to test the application.
-
+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__
use Test::More tests => 2;
use_ok( Catalyst::Test, '[% name %]' );
ok( request('/')->is_success );
-
__podtest__
use Test::More;
plan skip_all => 'set TEST_POD to enable this test' unless $ENV{TEST_POD};
all_pod_files_ok();
-
__podcoveragetest__
use Test::More;
plan skip_all => 'set TEST_POD to enable this test' unless $ENV{TEST_POD};
all_pod_coverage_ok();
-
__cgi__
[% startperl %] -w
-BEGIN { $ENV{CATALYST_ENGINE} = 'CGI' }
+
+BEGIN { $ENV{CATALYST_ENGINE} ||= 'CGI' }
use strict;
use FindBin;
=head1 NAME
-cgi - Catalyst CGI
+[% appprefix %]_cgi.pl - Catalyst CGI
=head1 SYNOPSIS
Copyright 2004 Sebastian Riedel. All rights reserved.
-This library is free software. You can redistribute it and/or modify
+This library is free software. You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
-
-__fcgi__
+__fastcgi__
[% startperl %] -w
-BEGIN { $ENV{CATALYST_ENGINE} = 'FCGI' }
+BEGIN { $ENV{CATALYST_ENGINE} ||= 'FastCGI' }
use strict;
use FindBin;
=head1 NAME
-fcgi - Catalyst FCGI
+[% appprefix %]_fastcgi.pl - Catalyst FastCGI
=head1 SYNOPSIS
=head1 DESCRIPTION
-Run a Catalyst application as fcgi.
+Run a Catalyst application as fastcgi.
=head1 AUTHOR
Copyright 2004 Sebastian Riedel. All rights reserved.
-This library is free software. You can redistribute it and/or modify
+This library is free software. You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
-
__server__
[% startperl %] -w
BEGIN {
- $ENV{CATALYST_ENGINE} = 'HTTP';
+ $ENV{CATALYST_ENGINE} ||= 'HTTP';
$ENV{CATALYST_SCRIPT_GEN} = [% scriptgen %];
}
use lib "$FindBin::Bin/../lib";
use [% name %];
+my $fork = 0;
my $help = 0;
+my $host = undef;
my $port = 3000;
-GetOptions( 'help|?' => \$help, 'port=s' => \$port );
+GetOptions(
+ 'fork' => \$fork,
+ 'help|?' => \$help,
+ 'host=s' => \$host,
+ 'port=s' => \$port
+);
pod2usage(1) if $help;
-[% name %]->run($port);
+[% name %]->run( $port, $host, $fork );
1;
=head1 NAME
-server - Catalyst Testserver
+[% appprefix %]_server.pl - Catalyst Testserver
=head1 SYNOPSIS
-server.pl [options]
+[% appprefix %]_server.pl [options]
Options:
+ -f -fork handle each request in a new process
-? -help display this help and exits
+ -host host (defaults to all)
-p -port port (defaults to 3000)
See also:
Copyright 2004 Sebastian Riedel. All rights reserved.
-This library is free software. You can redistribute it and/or modify
+This library is free software. You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
-
__test__
[% startperl %] -w
-BEGIN { $ENV{CATALYST_ENGINE} = 'Test' }
+BEGIN { $ENV{CATALYST_ENGINE} ||= 'Test' }
use strict;
use Getopt::Long;
=head1 NAME
-test - Catalyst Test
+[% appprefix %]_test.pl - Catalyst Test
=head1 SYNOPSIS
-test.pl [options] uri
+[% appprefix %]_test.pl [options] uri
Options:
-help display this help and exits
Examples:
- test.pl http://localhost/some_action
- test.pl /some_action
+ [% appprefix %]_test.pl http://localhost/some_action
+ [% appprefix %]_test.pl /some_action
See also:
perldoc Catalyst::Manual
=head1 DESCRIPTION
-Run a Catalyst action from the comand line.
+Run a Catalyst action from the command line.
=head1 AUTHOR
Copyright 2004 Sebastian Riedel. All rights reserved.
-This library is free software. You can redistribute it and/or modify
+This library is free software. You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
-
__create__
[% startperl %] -w
use Catalyst::Helper;
my $help = 0;
+my $nonew = 0;
-GetOptions( 'help|?' => \$help );
+GetOptions( 'help|?' => \$help,
+ 'nonew' => \$nonew );
pod2usage(1) if ( $help || !$ARGV[0] );
-my $helper = Catalyst::Helper->new;
+my $helper = Catalyst::Helper->new({'.newfiles' => !$nonew});
pod2usage(1) unless $helper->mk_component( '[% name %]', @ARGV );
1;
=head1 NAME
-create - Create a new Catalyst Component
+[% appprefix %]_create.pl - Create a new Catalyst Component
=head1 SYNOPSIS
-create.pl [options] model|view|controller name [helper] [options]
+[% appprefix %]_create.pl [options] model|view|controller name [helper] [options]
Options:
-help display this help and exits
+ -nonew don't create a .new file where a file to be created exists
Examples:
- create.pl controller My::Controller
- create.pl view My::View
- create.pl view MyView TT
- create.pl view TT TT
- create.pl model My::Model
- create.pl model SomeDB CDBI dbi:SQLite:/tmp/my.db
- create.pl model AnotherDB CDBI dbi:Pg:dbname=foo root 4321
- create.pl Ajax
+ [% appprefix %]_create.pl controller My::Controller
+ [% appprefix %]_create.pl view My::View
+ [% appprefix %]_create.pl view MyView TT
+ [% appprefix %]_create.pl view TT TT
+ [% appprefix %]_create.pl model My::Model
+ [% appprefix %]_create.pl model SomeDB CDBI dbi:SQLite:/tmp/my.db
+ [% appprefix %]_create.pl model AnotherDB CDBI dbi:Pg:dbname=foo root 4321
See also:
perldoc Catalyst::Manual
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<sri\@oook.de>
Copyright 2004 Sebastian Riedel. All rights reserved.
-This library is free software. You can redistribute it and/or modify
+This library is free software. You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
-
__compclass__
package [% class %];
use strict;
use base 'Catalyst::Base';
-[% IF type == 'C' %]
-sub default : Private {
- my ( $self, $c ) = @_;
- $c->res->output('Congratulations, [% class %] is on Catalyst!');
-}
-
-[% END %]
=head1 NAME
-[% class %] - A Component
+[% class %] - Catalyst component
=head1 SYNOPSIS
- Very simple to use
+See L<[% app %]>
=head1 DESCRIPTION
-Very nice component.
+Catalyst component.
+[% IF type == 'C' %]
+=head1 METHODS
+
+=over 4
+
+=item default
+
+=cut
+
+sub default : Private {
+ my ( $self, $c ) = @_;
+
+ # Hello World
+ $c->response->output('Congratulations, [% class %] is on Catalyst!');
+}
+
+=back
+[% END %]
=head1 AUTHOR
[%author%]
=head1 LICENSE
-This library is free software . You can redistribute it and/or modify
+This library is free software . You can redistribute it and/or modify
it under the same terms as perl itself.
=cut
1;
-
__comptest__
[% IF type == 'C' %]
use Test::More tests => 3;
use_ok( Catalyst::Test, '[% app %]' );
use_ok('[% class %]');
-ok( request('[% prefix %]')->is_success );
+ok( request('[% uri %]')->is_success );
[% ELSE %]
use Test::More tests => 1;
use_ok('[% class %]');