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     warn("load $classtoload or Catalyst::Script::$scriptclass");
  15
  16     # FIXME - Error handling / reporting
  17     unless ( eval { Class::MOP::load_class($classtoload) } ) {
  18         warn("Could not load $classtoload - falling back to Catalyst::Script::$scriptclass : $@\n")
  19             if $@ !~ /Can't locate/;
  20         $classtoload = "Catalyst::Script::$scriptclass";
  21         Class::MOP::load_class($classtoload);
  22     }
  23     $classtoload->new_with_options( application_name => $class )->run;
  24 }
  25
  26 __PACKAGE__->meta->make_immutable;
  27
  28 =head1 NAME
  29
  30 Catalyst::ScriptRunner - The Catalyst Framework script runner
  31
  32 =head1 SYNOPSIS
  33
  34     # Will run MyApp::Script::Server if it exists, otherwise
  35     # will run Catalyst::Script::Server.
  36     Catalyst::ScriptRunner->run('MyApp', 'Server');
  37
  38 =head1 DESCRIPTION
  39
  40 This class is responsible for running scripts, either in the application specific namespace
  41 (e.g. C<MyApp::Script::Server>), or the Catalyst namespace (e.g. C<Catalyst::Script::Server>)
  42
  43 =head1 METHODS
  44
  45 =head2 run ($application_class, $scriptclass)
  46
  47 Called with two parameters, the application classs (e.g. MyApp)
  48 and the script class, (i.e. one of Server/FastCGI/CGI/Create/Test)
  49
  50 =head1 AUTHORS
  51
  52 Catalyst Contributors, see Catalyst.pm
  53
  54 =head1 COPYRIGHT
  55
  56 This library is free software. You can redistribute it and/or modify it under
  57 the same terms as Perl itself.
  58
  59 =cut