t/Provider/script/testapp_server.pl

   1 #!/usr/bin/env perl
   2
   3 BEGIN {
   4     $ENV{CATALYST_ENGINE} ||= 'HTTP';
   5     $ENV{CATALYST_SCRIPT_GEN} = 39;
   6     require Catalyst::Engine::HTTP;
   7 }
   8
   9 use strict;
  10 use warnings;
  11 use Getopt::Long;
  12 use Pod::Usage;
  13 use FindBin;
  14 use lib "$FindBin::Bin/../lib";
  15
  16 my $debug             = 0;
  17 my $fork              = 0;
  18 my $help              = 0;
  19 my $host              = undef;
  20 my $port              = $ENV{TESTAPP_PORT} || $ENV{CATALYST_PORT} || 3000;
  21 my $keepalive         = 0;
  22 my $restart           = $ENV{TESTAPP_RELOAD} || $ENV{CATALYST_RELOAD} || 0;
  23 my $background        = 0;
  24 my $pidfile           = undef;
  25
  26 my $check_interval;
  27 my $file_regex;
  28 my $watch_directory;
  29 my $follow_symlinks;
  30
  31 my @argv = @ARGV;
  32
  33 GetOptions(
  34     'debug|d'             => \$debug,
  35     'fork|f'              => \$fork,
  36     'help|?'              => \$help,
  37     'host=s'              => \$host,
  38     'port|p=s'            => \$port,
  39     'keepalive|k'         => \$keepalive,
  40     'restart|r'           => \$restart,
  41     'restartdelay|rd=s'   => \$check_interval,
  42     'restartregex|rr=s'   => \$file_regex,
  43     'restartdirectory=s@' => \$watch_directory,
  44     'followsymlinks'      => \$follow_symlinks,
  45     'background'          => \$background,
  46     'pidfile=s'           => \$pidfile,
  47 );
  48
  49 pod2usage(1) if $help;
  50
  51 if ( $debug ) {
  52     $ENV{CATALYST_DEBUG} = 1;
  53 }
  54
  55 # If we load this here, then in the case of a restarter, it does not
  56 # need to be reloaded for each restart.
  57 require Catalyst;
  58
  59 # If this isn't done, then the Catalyst::Devel tests for the restarter
  60 # fail.
  61 $| = 1 if $ENV{HARNESS_ACTIVE};
  62
  63 my $runner = sub {
  64     # This is require instead of use so that the above environment
  65     # variables can be set at runtime.
  66     require TestApp;
  67
  68     TestApp->run(
  69         $port, $host,
  70         {
  71             argv       => \@argv,
  72             'fork'     => $fork,
  73             keepalive  => $keepalive,
  74             background => $background,
  75             pidfile    => $pidfile,
  76         }
  77     );
  78 };
  79
  80 if ( $restart ) {
  81     die "Cannot run in the background and also watch for changed files.\n"
  82         if $background;
  83
  84     require Catalyst::Restarter;
  85
  86     my $subclass = Catalyst::Restarter->pick_subclass;
  87
  88     my %args;
  89     $args{follow_symlinks} = 1
  90         if $follow_symlinks;
  91     $args{directories} = $watch_directory
  92         if defined $watch_directory;
  93     $args{sleep_interval} = $check_interval
  94         if defined $check_interval;
  95     $args{filter} = qr/$file_regex/
  96         if defined $file_regex;
  97
  98     my $restarter = $subclass->new(
  99         %args,
 100         start_sub => $runner,
 101         argv      => \@argv,
 102     );
 103
 104     $restarter->run_and_watch;
 105 }
 106 else {
 107     $runner->();
 108 }
 109
 110 1;
 111
 112 =head1 NAME
 113
 114 testapp_server.pl - Catalyst Testserver
 115
 116 =head1 SYNOPSIS
 117
 118 testapp_server.pl [options]
 119
 120  Options:
 121    -d -debug          force debug mode
 122    -f -fork           handle each request in a new process
 123                       (defaults to false)
 124    -? -help           display this help and exits
 125       -host           host (defaults to all)
 126    -p -port           port (defaults to 3000)
 127    -k -keepalive      enable keep-alive connections
 128    -r -restart        restart when files get modified
 129                       (defaults to false)
 130    -rd -restartdelay  delay between file checks
 131                       (ignored if you have Linux::Inotify2 installed)
 132    -rr -restartregex  regex match files that trigger
 133                       a restart when modified
 134                       (defaults to '\.yml$|\.yaml$|\.conf|\.pm$')
 135    -restartdirectory  the directory to search for
 136                       modified files, can be set mulitple times
 137                       (defaults to '[SCRIPT_DIR]/..')
 138    -follow_symlinks   follow symlinks in search directories
 139                       (defaults to false. this is a no-op on Win32)
 140    -background        run the process in the background
 141    -pidfile           specify filename for pid file
 142
 143  See also:
 144    perldoc Catalyst::Manual
 145    perldoc Catalyst::Manual::Intro
 146
 147 =head1 DESCRIPTION
 148
 149 Run a Catalyst Testserver for this application.
 150
 151 =head1 AUTHORS
 152
 153 Catalyst Contributors, see Catalyst.pm
 154
 155 =head1 COPYRIGHT
 156
 157 This library is free software. You can redistribute it and/or modify
 158 it under the same terms as Perl itself.
 159
 160 =cut