X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FScript%2FServer.pm;h=caa148ac93228bdd6bc8903c77fc64f356a44714;hb=34be7d45d60869f19ba27d64dc1bbf0df4c6ccba;hp=a830978b022f0778697d7f6be256e9f2bf21572f;hpb=b6aaf1425b4cbfb286ca02817ea111fa3f6b9bc5;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Script/Server.pm b/lib/Catalyst/Script/Server.pm index a830978..caa148a 100644 --- a/lib/Catalyst/Script/Server.pm +++ b/lib/Catalyst/Script/Server.pm @@ -2,135 +2,227 @@ package Catalyst::Script::Server; BEGIN { $ENV{CATALYST_ENGINE} ||= 'HTTP'; - $ENV{CATALYST_SCRIPT_GEN} = 31; require Catalyst::Engine::HTTP; } -use FindBin qw/$Bin/; -use lib "$Bin/../lib"; -use Pod::Usage; use Moose; -use Catalyst::Engine::HTTP; -use namespace::clean -except => [ qw(meta) ]; +use MooseX::Types::Moose qw/ArrayRef Str Bool Int/; +use namespace::autoclean; -with 'MooseX::Getopt'; +with 'Catalyst::ScriptRole'; -has help => ( +__PACKAGE__->meta->get_attribute('help')->cmd_aliases('?'); + +has debug => ( traits => [qw(Getopt)], - cmd_aliases => 'h', - isa => 'Bool', - is => 'ro', - required => 0, - default => 0, + cmd_aliases => 'd', + isa => Bool, + is => 'ro', + documentation => q{Force debug mode}, ); -has host => ( - isa => 'Str', - is => 'ro', - required => 0, - default => "localhost" +has host => ( + traits => [qw(Getopt)], + cmd_aliases => 'h', + isa => Str, + is => 'ro', + default => 'localhost', + documentation => 'Specify an IP on this host for the server to bind to', ); -has fork => ( +has fork => ( traits => [qw(Getopt)], cmd_aliases => 'f', - isa => 'Bool', - is => 'ro', - required => 0 + isa => Bool, + is => 'ro', + default => 0, + documentation => 'Fork the server to be able to serve multiple requests at once', ); -has listen => ( +has port => ( traits => [qw(Getopt)], - cmd_aliases => 'l', - isa => 'Int', - is => 'ro', - required => 0, - default => "3000" + cmd_aliases => 'p', + isa => Int, + is => 'ro', + default => 3000, + documentation => 'Specify a different listening port (to the default port 3000)', ); -has pidfile => ( +has pidfile => ( traits => [qw(Getopt)], cmd_aliases => 'pid', - isa => 'Str', - is => 'ro', - required => 0 + isa => Str, + is => 'ro', + documentation => 'Specify a pidfile', ); -has keepalive => ( +has keepalive => ( traits => [qw(Getopt)], cmd_aliases => 'k', - isa => 'Bool', - is => 'ro', - required => 0, - default => 0 + isa => Bool, + is => 'ro', + default => 0, + documentation => 'Support keepalive', ); -has background => ( isa => 'Bool', is => 'ro', required => 0 ); -has app => ( isa => 'Str', is => 'ro', required => 1 ); # THIS IS FUCKING RETARDED HALP PLZ -has restart => ( isa => 'Bool', is => 'ro', required => 0 ); -has restart_delay => ( isa => 'Int', is => 'ro', required => 0 ); -has restart_regex => ( isa => 'Str', is => 'ro', required => 0 ); -has follow_symlinks => ( isa => 'Bool', is => 'ro', required => 0 ); +has background => ( + traits => [qw(Getopt)], + cmd_aliases => 'bg', + isa => Bool, + is => 'ro', + default => 0, + documentation => 'Run in the background', +); -my @argv = @ARGV; +has restart => ( + traits => [qw(Getopt)], + cmd_aliases => 'r', + isa => Bool, + is => 'ro', + default => 0, + documentation => 'use Catalyst::Restarter to detect code changes and restart the application', +); -sub run { +has restart_directory => ( + traits => [qw(Getopt)], + cmd_aliases => 'rdir', + isa => ArrayRef[Str], + is => 'ro', + documentation => 'Restarter directory to watch', + predicate => '_has_restart_directory', +); + +has restart_delay => ( + traits => [qw(Getopt)], + cmd_aliases => 'rd', + isa => Int, + is => 'ro', + documentation => 'Set a restart delay', + predicate => '_has_restart_delay', +); + +has restart_regex => ( + traits => [qw(Getopt)], + cmd_aliases => 'rr', + isa => Str, + is => 'ro', + documentation => 'Restart regex', + predicate => '_has_restart_regex', +); + +has follow_symlinks => ( + traits => [qw(Getopt)], + cmd_aliases => 'sym', + isa => Bool, + is => 'ro', + default => 0, + documentation => 'Follow symbolic links', + predicate => '_has_follow_symlinks', +); + +sub _restarter_args { my $self = shift; - - pod2usage() if $self->help; - my $app = $self->app; - Class::MOP::load_class($app); - $app->run( - $self->listen, $self->host, - { - 'fork' => $self->fork, - keepalive => $self->keepalive, - background => $self->background, - pidfile => $self->pidfile, - keepalive => $self->keepalive, - restart => $self->restart, - restart_delay => $self->restart_delay, - restart_regex => qr/$self->restart_regex/, -# FIXME restart_directory => $self->restart_directory, - follow_symlinks => $self->follow_symlinks, - } + + my %args = ( + argv => $self->ARGV, + start_sub => sub { $self->_run_application }, + ($self->_has_follow_symlinks ? (follow_symlinks => $self->follow_symlinks) : ()), + ($self->_has_restart_delay ? (sleep_interval => $self->restart_delay) : ()), + ($self->_has_restart_directory ? (directories => $self->restart_directory) : ()), + ($self->_has_restart_regex ? (filter => qr/${\$self->restart_regex}/) : ()), ); + return %args; +} + +sub run { + my $self = shift; + + local $ENV{CATALYST_DEBUG} = 1 + if $self->debug; + + if ( $self->restart ) { + die "Cannot run in the background and also watch for changed files.\n" + if $self->background; + + # If we load this here, then in the case of a restarter, it does not + # need to be reloaded for each restart. + require Catalyst; + + # If this isn't done, then the Catalyst::Devel tests for the restarter + # fail. + $| = 1 if $ENV{HARNESS_ACTIVE}; + + require Catalyst::Restarter; + + my $subclass = Catalyst::Restarter->pick_subclass; + + + my $restarter = $subclass->new( + $self->_restarter_args() + ); + + $restarter->run_and_watch; + } + else { + $self->_run_application; + } + + } +sub _application_args { + my ($self) = shift; + return ( + $self->port, + $self->host, + { + map { $_ => $self->$_ } qw/ + fork + keepalive + background + pidfile + keepalive + follow_symlinks + /, + }, + ); +} + +__PACKAGE__->meta->make_immutable; 1; =head1 NAME -[% appprefix %]_server.pl - Catalyst Testserver +Catalyst::Script::Server - Catalyst test server =head1 SYNOPSIS -[% appprefix %]_server.pl [options] + myapp_server.pl [options] Options: - -d -debug force debug mode - -f -fork handle each request in a new process - (defaults to false) - -? -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 get modified + -d --debug force debug mode + -f --fork handle each request in a new process (defaults to false) - -rd -restartdelay delay between file checks + --help display this help and exits + -h --host host (defaults to all) + -p --port port (defaults to 3000) + -k --keepalive enable keep-alive connections + -r --restart restart when files get modified + (defaults to false) + --rd --restartdelay delay between file checks (ignored if you have Linux::Inotify2 installed) - -rr -restartregex regex match files that trigger + --rr --restartregex regex match files that trigger a restart when modified (defaults to '\.yml$|\.yaml$|\.conf|\.pm$') - -restartdirectory the directory to search for + --rdir --restartdirectory the directory to search for modified files, can be set mulitple times (defaults to '[SCRIPT_DIR]/..') - -follow_symlinks follow symlinks in search directories + --sym --follow_symlinks follow symlinks in search directories (defaults to false. this is a no-op on Win32) - -background run the process in the background - -pidfile specify filename for pid file + --bg --background run the process in the background + --pid --pidfile specify filename for pid file See also: perldoc Catalyst::Manual @@ -138,7 +230,7 @@ sub run { =head1 DESCRIPTION -Run a Catalyst Testserver for this application. +Run a Catalyst test server for this application. =head1 AUTHORS