X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FScript%2FServer.pm;h=d65a2314125319afe14398ed177b5d8e0f44a7c2;hb=880d1f8b5a10f28ce1142898058a26b6506f1cfe;hp=a1399c545262f8e4a98ff6d4043db8786f5950c4;hpb=4e45780e0eb1ea96cc9402e16429de10fe6b5209;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Script/Server.pm b/lib/Catalyst/Script/Server.pm index a1399c5..d65a231 100644 --- a/lib/Catalyst/Script/Server.pm +++ b/lib/Catalyst/Script/Server.pm @@ -2,237 +2,221 @@ 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::Restarter; -use MooseX::Types::Moose qw/Str Bool Int/; +use MooseX::Types::Moose qw/ArrayRef Str Bool Int RegexpRef/; use namespace::autoclean; -with 'MooseX::Getopt'; +with 'Catalyst::ScriptRole'; + +__PACKAGE__->meta->get_attribute('help')->cmd_aliases('?'); has debug => ( traits => [qw(Getopt)], cmd_aliases => 'd', - isa => 'Bool', + isa => Bool, is => 'ro', - documentation => qq{ force debug mode } - + documentation => q{Force debug mode}, ); -has help => ( +has host => ( traits => [qw(Getopt)], cmd_aliases => 'h', - isa => 'Bool', + isa => Str, is => 'ro', - documentation => qq{ display this help and exits }, -); - -has host => ( - isa => 'Str', - is => 'ro', - default => "localhost", - documentation => qq{ specify a host for the server to run on } + default => 'localhost', + documentation => 'Specify an IP on this host for the server to bind to', ); has fork => ( traits => [qw(Getopt)], cmd_aliases => 'f', - isa => 'Bool', + isa => Bool, is => 'ro', - documentation => qq{ fork the server } + 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', + cmd_aliases => 'p', + isa => Int, is => 'ro', - default => "3000", - documentation => qq{ specify a different listening port } + default => 3000, + documentation => 'Specify a different listening port (to the default port 3000)', ); has pidfile => ( traits => [qw(Getopt)], cmd_aliases => 'pid', - isa => 'Str', + isa => Str, is => 'ro', - documentation => qq{ specify a pidfile } + documentation => 'Specify a pidfile', ); has keepalive => ( traits => [qw(Getopt)], cmd_aliases => 'k', - isa => 'Bool', + isa => Bool, is => 'ro', - documentation => qq{ server keepalive }, - + default => 0, + documentation => 'Support keepalive', ); has background => ( traits => [qw(Getopt)], cmd_aliases => 'bg', - isa => 'Bool', - is => 'ro', - documentation => qq{ run in the background } -); - - -has _app => ( - reader => 'app', - init_arg => 'app', - traits => [qw(NoGetopt)], - isa => 'Str', + isa => Bool, is => 'ro', + default => 0, + documentation => 'Run in the background', ); has restart => ( traits => [qw(Getopt)], cmd_aliases => 'r', - isa => 'Bool', + isa => Bool, is => 'ro', - documentation => qq{ use Catalyst::Restarter to detect code changes } + default => 0, + documentation => 'use Catalyst::Restarter to detect code changes and restart the application', ); has restart_directory => ( traits => [qw(Getopt)], cmd_aliases => 'rdir', - isa => 'ArrayRef[Str]', + isa => ArrayRef[Str], is => 'ro', + documentation => 'Restarter directory to watch', predicate => '_has_restart_directory', - documentation => qq{ restarter directory to watch } ); has restart_delay => ( traits => [qw(Getopt)], - cmd_aliases => 'rdel', - isa => 'Int', + cmd_aliases => 'rd', + isa => Int, is => 'ro', + documentation => 'Set a restart delay', predicate => '_has_restart_delay', - documentation => qq{ set a restart delay } ); -has restart_regex => ( - traits => [qw(Getopt)], - cmd_aliases => 'rxp', - isa => 'Str', - is => 'ro', - predicate => '_has_restart_regex', - documentation => qq{ restart regex } -); +{ + use Moose::Util::TypeConstraints; + + my $tc = subtype as RegexpRef; + coerce $tc, from Str, via { qr/$_/ }; + + MooseX::Getopt::OptionTypeMap->add_option_type_to_map($tc => '=s'); + + has restart_regex => ( + traits => [qw(Getopt)], + cmd_aliases => 'rr', + isa => $tc, + coerce => 1, + is => 'ro', + documentation => 'Restart regex', + predicate => '_has_restart_regex', + ); +} has follow_symlinks => ( traits => [qw(Getopt)], cmd_aliases => 'sym', - isa => 'Bool', + isa => Bool, is => 'ro', + default => 0, + documentation => 'Follow symbolic links', predicate => '_has_follow_symlinks', - documentation => qq{ follow symbolic links } - ); -sub usage { - my ($self) = shift; +sub _restarter_args { + my $self = shift; - return pod2usage(); + 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 => $self->restart_regex) : ()), + ); + return %args; } - sub run { - my ($self) = shift; + my $self = shift; - $self->usage if $self->help; - - if ( $self->debug ) { - $ENV{CATALYST_DEBUG} = 1; - } - - # 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}; + 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 %args; - $args{follow_symlinks} = $self->follow_symlinks - if $self->_has_follow_symlinks; - $args{directories} = $self->restart_directory - if $self->_has_restart_directory; - $args{sleep_interval} = $self->restart_delay - if $self->_has_restart_delay; - $args{filter} = qr/$self->restart_regex/ - if $self->_has_restart_regex; - + my $restarter = $subclass->new( - %args, - start_sub => sub { $self->_run }, - argv => \$self->ARGV, + $self->_restarter_args() ); $restarter->run_and_watch; } else { - $self->_run; + $self->_run_application; } } -sub _run { +sub _application_args { my ($self) = shift; - - my $app = $self->app; - Class::MOP::load_class($app); - - $app->run( - $self->listen, $self->host, + return ( + $self->port, + $self->host, { - 'fork' => $self->fork, - keepalive => $self->keepalive, - background => $self->background, - pidfile => $self->pidfile, - keepalive => $self->keepalive, - follow_symlinks => $self->follow_symlinks, - } + map { $_ => $self->$_ } qw/ + fork + keepalive + background + pidfile + keepalive + follow_symlinks + /, + }, ); } - -no Moose; __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) - -h --help display this help and exits - --host host (defaults to all) + --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 @@ -256,7 +240,7 @@ __PACKAGE__->meta->make_immutable; =head1 DESCRIPTION -Run a Catalyst Testserver for this application. +Run a Catalyst test server for this application. =head1 AUTHORS