package Catalyst::Helper;
use strict;
+use warnings;
use base 'Class::Accessor::Fast';
use Config;
use File::Spec;
use File::Path;
-use IO::File;
use FindBin;
+use IO::File;
+use POSIX 'strftime';
use Template;
+use Catalyst::Devel;
use Catalyst::Utils;
use Catalyst::Exception;
=head1 SYNOPSIS
-See L<Catalyst::Manual::Intro>
-
-=head1 DESCRIPTION
-
-Bootstrap a Catalyst application. Autogenerates scripts
-
-=head2 METHODS
-
-=head3 get_file
-
-Slurp file from DATA.
+ catalyst.pl <myappname>
=cut
return 0;
}
-=head3 mk_app
-
-Create the main application skeleton.
-
-=cut
-
sub mk_app {
my ( $self, $name ) = @_;
warn "Error: Invalid application name.\n";
return 0;
}
- $self->{name} = $name;
- $self->{dir} = $name;
- $self->{dir} =~ s/\:\:/-/g;
- $self->{script} = File::Spec->catdir( $self->{dir}, 'script' );
- $self->{appprefix} = Catalyst::Utils::appprefix($name);
- $self->{startperl} = "#!$Config{perlpath} -w";
- $self->{scriptgen} = $Catalyst::CATALYST_SCRIPT_GEN || 4;
- $self->{author} = $self->{author} = $ENV{'AUTHOR'}
+ $self->{name } = $name;
+ $self->{dir } = $name;
+ $self->{dir } =~ s/\:\:/-/g;
+ $self->{script } = File::Spec->catdir( $self->{dir}, 'script' );
+ $self->{appprefix } = Catalyst::Utils::appprefix($name);
+ $self->{appenv } = Catalyst::Utils::class2env($name);
+ $self->{startperl } = "#!$Config{perlpath} -w";
+ $self->{scriptgen } = $Catalyst::Devel::CATALYST_SCRIPT_GEN || 4;
+ $self->{catalyst_version} = $Catalyst::VERSION;
+ $self->{author } = $self->{author} = $ENV{'AUTHOR'}
|| eval { @{ [ getpwuid($<) ] }[6] }
|| 'Catalyst developer';
return $self->{dir};
}
-=head3 mk_component
-
-This method is called by create.pl to make new components
-for your application.
-
-=cut
-
sub mk_component {
my $self = shift;
my $app = shift;
my $name = shift || "Missing name for model/view/controller";
my $helper = shift;
my @args = @_;
- return 0 if $name =~ /[^\w\:]/;
+ return 0 if $name =~ /[^\w\:]/;
$type = lc $type;
$self->{long_type} = ucfirst $type;
$type = 'M' if $type =~ /model/i;
return 1;
}
-=head3 mk_dir
-
-Surprisingly, this function makes a directory.
-
-=cut
-
sub mk_dir {
my ( $self, $dir ) = @_;
if ( -d $dir ) {
Catalyst::Exception->throw( message => qq/Couldn't create "$dir", "$!"/ );
}
-=head3 mk_file
-
-writes content to a file.
-
-=cut
-
sub mk_file {
my ( $self, $file, $content ) = @_;
if ( -e $file ) {
Catalyst::Exception->throw( message => qq/Couldn't create "$file", "$!"/ );
}
-=head3 next_test
-
-=cut
-
sub next_test {
my ( $self, $tname ) = @_;
if ($tname) { $tname = "$tname.t" }
return File::Spec->catfile( $dir, "$type\_$tname" );
}
-=head3 render_file
-
-Render and create a file from a template in DATA using
-Template Toolkit.
-
-=cut
-
sub render_file {
my ( $self, $file, $path, $vars ) = @_;
$vars ||= {};
sub _mk_changes {
my $self = shift;
my $dir = $self->{dir};
- my $time = localtime time;
+ my $time = strftime('%Y-%m-%d %H:%M:%S', localtime time);
$self->render_file( 'changes', "$dir\/Changes", { time => $time } );
}
}
}
+=head1 DESCRIPTION
+
+This module is used by B<catalyst.pl> to create a set of scripts for a
+new catalyst application. The scripts each contain documentation and
+will output help on how to use them if called incorrectly or in some
+cases, with no arguments.
+
+It also provides some useful methods for a Helper module to call when
+creating a component. See L</METHODS>.
+
+=head1 SCRIPTS
+
+=head2 _create.pl
+
+Used to create new components for a catalyst application at the
+development stage.
+
+=head2 _server.pl
+
+The catalyst test server, starts an HTTPD which outputs debugging to
+the terminal.
+
+=head2 _test.pl
+
+A script for running tests from the command-line.
+
+=head2 _cgi.pl
+
+Run your application as a CGI.
+
+=head2 _fastcgi.pl
+
+Run the application as a fastcgi app. Either by hand, or call this
+from FastCgiServer in your http server config.
+
=head1 HELPERS
+The L</_create.pl> script creates application components using Helper
+modules. The Catalyst team provides a good number of Helper modules
+for you to use. You can also add your own.
+
Helpers are classes that provide two methods.
* mk_compclass - creates the Component class
* mk_comptest - creates the Component test
-So when you call C<bin/create view MyView TT>, create would try to execute
-Catalyst::Helper::View::TT->mk_compclass and
+So when you call C<scripts/myapp_create.pl view MyView TT>, create
+will try to execute Catalyst::Helper::View::TT->mk_compclass and
Catalyst::Helper::View::TT->mk_comptest.
See L<Catalyst::Helper::View::TT> and L<Catalyst::Helper::Model::DBIC> for
Catalyst::Helper::View::
Catalyst::Helper::Controller::
+=head2 mk_compclass
+
+This method in your Helper module is called with C<$helper>
+which is a L<Catalyst::Helper> object, and whichever other arguments
+the user added to the command-line. You can use the $helper to call methods
+described below.
+
+If the Helper module does not contain a C<mk_compclass> method, it
+will fall back to calling L</render_file>, with an argument of
+C<compclass>.
+
+=head2 mk_comptest
+
+This method in your Helper module is called with C<$helper>
+which is a L<Catalyst::Helper> object, and whichever other arguments
+the user added to the command-line. You can use the $helper to call methods
+described below.
+
+If the Helper module does not contain a C<mk_compclass> method, it
+will fall back to calling L</render_file>, with an argument of
+C<comptest>.
+
+=head2 mk_stuff
+
+This method is called if the user does not supply any of the usual
+component types C<view>, C<controller>, C<model>. It is passed the
+C<$helper> object (an instance of L<Catalyst::Helper>), and any other
+arguments the user typed.
+
+There is no fallback for this method.
+
+=head1 METHODS
+
+These are the methods that the Helper classes can call on the
+<$helper> object passed to them.
+
+=head2 render_file
+
+Render and create a file from a template in DATA using
+Template Toolkit.
+
+=head2 get_file
+
+Fetch file contents from the DATA section. This is used internally by
+L</render_file>.
+
+=head2 mk_app
+
+Create the main application skeleton. This is called by L<catalyst.pl>.
+
+=head2 mk_component
+
+This method is called by L<create.pl> to make new components
+for your application.
+
+=head3 mk_dir
+
+Surprisingly, this function makes a directory.
+
+=head2 mk_file
+
+Writes content to a file. Called by L</render_file>.
+
+=head2 next_test
+
+Calculates the name of the next numbered test file and returns it.
+
=head1 NOTE
The helpers will read author name from /etc/passwd by default.
This library is free software, you can redistribute it and/or modify
it under the same terms as Perl itself.
+=begin pod_to_ignore
+
=cut
1;
use strict;
use warnings;
-#
+use Catalyst::Runtime '5.70';
+
# Set flags and add plugins for the application
#
# -Debug: activates the debug mode for very useful log messages
# application's home directory
# Static::Simple: will serve static files from the application's root
# directory
-#
-use Catalyst qw/-Debug ConfigLoader Static::Simple/;
+
+use parent qw/Catalyst/;
our $VERSION = '0.01';
+# Configure the application.
#
-# Configure the application
-#
+# Note that settings in [% appprefix %].yml (or other external
+# configuration file that you set up manually) take precedence
+# over this when using ConfigLoader. Thus configuration
+# details given here can function as a default configuration,
+# with a external configuration file acting as an override for
+# local deployment.
+
__PACKAGE__->config( name => '[% name %]' );
-#
# Start the application
-#
-__PACKAGE__->setup;
+__PACKAGE__->setup(qw/-Debug ConfigLoader Static::Simple/);
-#
-# IMPORTANT: Please look into [% rootname %] for more
-#
=head1 NAME
=head1 DESCRIPTION
-Catalyst based application.
+[enter your description here]
=head1 SEE ALSO
use strict;
use warnings;
-use base 'Catalyst::Controller';
+use parent 'Catalyst::Controller';
#
# Sets the actions in this controller to be registered with no prefix
=head1 NAME
-[% rootname %] - Root Controller for this Catalyst based application
-
-=head1 SYNOPSIS
-
-See L<[% name %]>.
+[% rootname %] - Root Controller for [% name %]
=head1 DESCRIPTION
-Root Controller for this Catalyst based application.
+[enter your description here]
=head1 METHODS
=cut
-=head2 default
+=head2 index
=cut
-#
-# Output a friendly welcome message
-#
-sub default : Private {
+sub index : Path Args(0) {
my ( $self, $c ) = @_;
# Hello World
$c->response->body( $c->welcome_message );
}
-#
-# Uncomment and modify this end action after adding a View component
-#
-#=head2 end
-#
-#=cut
-#
-#sub end : Private {
-# my ( $self, $c ) = @_;
-#
-# # Forward to View unless response body is already defined
-# $c->forward( $c->view('') ) unless $c->response->body;
-#}
+sub default : Path {
+ my ( $self, $c ) = @_;
+ $c->response->body( 'Page not found' );
+ $c->response->status(404);
+
+}
+
+=head2 end
+
+Attempt to render a view, if needed.
+
+=cut
+
+sub end : ActionClass('RenderView') {}
=head1 AUTHOR
name '[% dir %]';
all_from '[% path %]';
-requires Catalyst => '5.64';
-
+requires 'Catalyst::Runtime' => '[% catalyst_version %]';
+requires 'Catalyst::Plugin::ConfigLoader';
+requires 'Catalyst::Plugin::Static::Simple';
+requires 'Catalyst::Action::RenderView';
+requires 'parent';
+requires 'YAML'; # This should reflect the config file format you've chosen
+ # See Catalyst::Plugin::ConfigLoader for supported formats
catalyst;
install_script glob('script/*.pl');
BEGIN { $ENV{CATALYST_ENGINE} ||= 'CGI' }
use strict;
+use warnings;
use FindBin;
use lib "$FindBin::Bin/../lib";
use [% name %];
=head1 DESCRIPTION
-Run a Catalyst application as cgi.
+Run a Catalyst application as a cgi script.
=head1 AUTHOR
=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.
BEGIN { $ENV{CATALYST_ENGINE} ||= 'FastCGI' }
use strict;
+use warnings;
use Getopt::Long;
use Pod::Usage;
use FindBin;
use [% name %];
my $help = 0;
-my ( $listen, $nproc, $pidfile, $manager, $detach );
+my ( $listen, $nproc, $pidfile, $manager, $detach, $keep_stderr );
GetOptions(
'help|?' => \$help,
'pidfile|p=s' => \$pidfile,
'manager|M=s' => \$manager,
'daemon|d' => \$detach,
+ 'keeperr|e' => \$keep_stderr,
);
pod2usage(1) if $help;
pidfile => $pidfile,
manager => $manager,
detach => $detach,
+ keep_stderr => $keep_stderr,
}
);
-M -manager specify alternate process manager
(FCGI::ProcManager sub-class)
or empty string to disable
+ -e -keeperr send error messages to STDOUT, not
+ to the webserver
=head1 DESCRIPTION
=head1 AUTHOR
Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
=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.
BEGIN {
$ENV{CATALYST_ENGINE} ||= 'HTTP';
$ENV{CATALYST_SCRIPT_GEN} = [% scriptgen %];
+ require Catalyst::Engine::HTTP;
}
use strict;
+use warnings;
use Getopt::Long;
use Pod::Usage;
use FindBin;
my $fork = 0;
my $help = 0;
my $host = undef;
-my $port = 3000;
+my $port = $ENV{[% appenv %]_PORT} || $ENV{CATALYST_PORT} || 3000;
my $keepalive = 0;
-my $restart = 0;
+my $restart = $ENV{[% appenv %]_RELOAD} || $ENV{CATALYST_RELOAD} || 0;
my $restart_delay = 1;
-my $restart_regex = '\.yml$|\.yaml$|\.pm$';
+my $restart_regex = '(?:/|^)(?!\.#).+(?:\.yml$|\.yaml$|\.pm)$';
my $restart_directory = undef;
+my $follow_symlinks = 0;
my @argv = @ARGV;
'restart|r' => \$restart,
'restartdelay|rd=s' => \$restart_delay,
'restartregex|rr=s' => \$restart_regex,
- 'restartdirectory=s' => \$restart_directory,
+ 'restartdirectory=s@' => \$restart_directory,
+ 'followsymlinks' => \$follow_symlinks,
);
pod2usage(1) if $help;
-if ( $restart ) {
+if ( $restart && $ENV{CATALYST_ENGINE} eq 'HTTP' ) {
$ENV{CATALYST_ENGINE} = 'HTTP::Restarter';
}
if ( $debug ) {
restart_delay => $restart_delay,
restart_regex => qr/$restart_regex/,
restart_directory => $restart_directory,
+ follow_symlinks => $follow_symlinks,
} );
1;
-host host (defaults to all)
-p -port port (defaults to 3000)
-k -keepalive enable keep-alive connections
- -r -restart restart when files got modified
+ -r -restart restart when files get modified
(defaults to false)
-rd -restartdelay delay between file checks
-rr -restartregex regex match files that trigger
a restart when modified
(defaults to '\.yml$|\.yaml$|\.pm$')
-restartdirectory the directory to search for
- modified files
- (defaults to '../')
-
+ modified files, can be set mulitple times
+ (defaults to '[SCRIPT_DIR]/..')
+ -follow_symlinks follow symlinks in search directories
+ (defaults to false. this is a no-op on Win32)
See also:
perldoc Catalyst::Manual
perldoc Catalyst::Manual::Intro
=head1 AUTHOR
Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
=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.
[% startperl %]
use strict;
+use warnings;
use Getopt::Long;
use Pod::Usage;
use FindBin;
=head1 AUTHOR
Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
=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.
[% startperl %]
use strict;
+use warnings;
use Getopt::Long;
use Pod::Usage;
use Catalyst::Helper;
Examples:
[% appprefix %]_create.pl controller My::Controller
+ [% appprefix %]_create.pl controller My::Controller BindLex
[% appprefix %]_create.pl -mechanize 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 DBIC::SchemaLoader dbi:SQLite:/tmp/my.db
- [% appprefix %]_create.pl model AnotherDB DBIC::SchemaLoader dbi:Pg:dbname=foo root 4321
+ [% appprefix %]_create.pl model SomeDB DBIC::Schema MyApp::Schema create=dynamic\
+ dbi:SQLite:/tmp/my.db
+ [% appprefix %]_create.pl model AnotherDB DBIC::Schema MyApp::Schema create=static\
+ dbi:Pg:dbname=foo root 4321
See also:
perldoc Catalyst::Manual
=head1 AUTHOR
Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
=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.
use strict;
use warnings;
-use base 'Catalyst::[% long_type %]';
+use parent 'Catalyst::[% long_type %]';
=head1 NAME
[% class %] - Catalyst [% long_type %]
-=head1 SYNOPSIS
-
-See L<[% app %]>
-
=head1 DESCRIPTION
Catalyst [% long_type %].
=cut
-#
-# Uncomment and modify this or add new actions to fit your needs
-#
-#=head2 default
-#
-#=cut
-#
-#sub default : Private {
-# my ( $self, $c ) = @_;
-#
-# # Hello World
-# $c->response->body('[% class %] is on Catalyst!');
-#}
+
+=head2 index
+
+=cut
+
+sub index : Private {
+ my ( $self, $c ) = @_;
+
+ $c->response->body('Matched [% class %] in [%name%].');
+}
[% END %]
=head1 AUTHOR