Pass Pod coverage
[catagits/Catalyst-Runtime.git] / lib / Catalyst / ScriptRunner.pm
1 package Catalyst::ScriptRunner;
2 use Moose;
3 use FindBin;
4 use lib;
5 use File::Spec;
6 use namespace::autoclean;
7
8 sub run {
9     my ($self, $class, $scriptclass) = @_;
10     my $classtoload = "${class}::Script::$scriptclass";
11
12     lib->import(File::Spec->catdir($FindBin::Bin, '..', 'lib'));
13
14     # FIXME - Error handling / reporting
15     if ( eval { Class::MOP::load_class($classtoload) } ) {
16     }
17     else {
18         $classtoload = "Catalyst::Script::$scriptclass";
19         Class::MOP::load_class($classtoload);
20     }
21     $classtoload->new_with_options( application_name => $class )->run;
22 }
23
24 __PACKAGE__->meta->make_immutable;
25
26 =head1 NAME
27
28 Catalyst::ScriptRunner - The Catalyst Framework script runner
29
30 =head1 SYNOPSIS
31
32     # Will run MyApp::Script::Server if it exists, otherwise
33     # will run Catalyst::Script::Server.
34     Catalyst::ScriptRunner->run('MyApp', 'Server');
35
36 =head1 DESCRIPTION
37
38 This class is responsible for running scripts, either in the application specific namespace
39 (e.g. C<MyApp::Script::Server>), or the Catalyst namespace (e.g. C<Catalyst::Script::Server>)
40
41 =head1 METHODS
42
43 =head2 run ($application_class, $scriptclass)
44
45 Called with two parameters, the application classs (e.g. MyApp)
46 and the script class, (i.e. one of Server/FastCGI/CGI/Create/Test)
47
48 =head1 AUTHORS
49
50 Catalyst Contributors, see Catalyst.pm
51
52 =head1 COPYRIGHT
53
54 This library is free software. You can redistribute it and/or modify it under
55 the same terms as Perl itself.
56
57 =cut