X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FScriptRole.pm;h=1874ea7127476398cca240f92da77f429fa4bbd3;hb=a465926f0b6cac31da7552da23573994f19b0374;hp=ca7055d93e46159af24ac26375e2a1c09dca96f4;hpb=d3082facb5273f9970121638c0385ecfc0f7b090;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/ScriptRole.pm b/lib/Catalyst/ScriptRole.pm index ca7055d..1874ea7 100644 --- a/lib/Catalyst/ScriptRole.pm +++ b/lib/Catalyst/ScriptRole.pm @@ -2,52 +2,140 @@ package Catalyst::ScriptRole; use Moose::Role; use MooseX::Types::Moose qw/Str Bool/; use Pod::Usage; +use MooseX::Getopt; +use Catalyst::EngineLoader; +use MooseX::Types::LoadableClass qw/LoadableClass/; use namespace::autoclean; -requires 'run'; - -with 'MooseX::Getopt'; +with 'MooseX::Getopt' => { + -excludes => [qw/ + _getopt_spec_warnings + _getopt_spec_exception + _getopt_full_usage + /], +}; has application_name => ( - traits => ['NoGetopt'], - isa => Str, - is => 'ro', + traits => ['NoGetopt'], + isa => Str, + is => 'ro', required => 1, ); -has help => ( - traits => ['Getopt'], - cmd_aliases => 'h', - isa => Bool, +has loader_class => ( + isa => LoadableClass, is => 'ro', - documentation => q{Display this help and exit}, + coerce => 1, + default => 'Catalyst::EngineLoader', + documentation => 'The class to use to detect and load the PSGI engine', +); + +has _loader => ( + isa => 'Plack::Loader', + default => sub { + my $self = shift; + $self->loader_class->new(application_name => $self->application_name); + }, + handles => { + load_engine => 'load', + autoload_engine => 'auto', + }, + lazy => 1, ); -sub _display_help { +sub _getopt_spec_exception {} + +sub _getopt_spec_warnings { + shift; + warn @_; +} + +sub _getopt_full_usage { my $self = shift; pod2usage(); exit 0; } -before run => sub { - my $self = shift; - $self->_display_help if $self->help; -}; - sub run { my $self = shift; $self->_run_application; } sub _application_args { - () + my $self = shift; + return { + argv => $self->ARGV, + extra_argv => $self->extra_argv, + } +} + +sub _plack_loader_args { + my $self = shift; + my @app_args = $self->_application_args; + return (port => $app_args[0]); } +sub _plack_engine_name {} + sub _run_application { my $self = shift; my $app = $self->application_name; Class::MOP::load_class($app); - $app->run($self->_application_args); + my $server; + if (my $e = $self->_plack_engine_name ) { + $server = $self->load_engine($e, $self->_plack_loader_args); + } + else { + $server = $self->autoload_engine($self->_plack_loader_args); + } + $app->run($self->_application_args, $server); } 1; + +=head1 NAME + +Catalyst::ScriptRole - Common functionality for Catalyst scripts. + +=head1 SYNOPSIS + + package MyApp::Script::Foo; + use Moose; + use namespace::autoclean; + + with 'Catalyst::ScriptRole'; + + sub _application_args { ... } + +=head1 DESCRIPTION + +Role with the common functionality of Catalyst scripts. + +=head1 METHODS + +=head2 run + +The method invoked to run the application. + +=head1 ATTRIBUTES + +=head2 application_name + +The name of the application class, e.g. MyApp + +=head1 SEE ALSO + +L + +L + +=head1 AUTHORS + +Catalyst Contributors, see Catalyst.pm + +=head1 COPYRIGHT + +This library is free software, you can redistribute it and/or modify +it under the same terms as Perl itself. + +=cut