NAME

       Feersum::Runner - feersum script core

SYNOPSIS

           use Feersum::Runner;
           my $runner = Feersum::Runner->new(
               listen => 'localhost:5000',
               pre_fork => 0,
               quiet => 1,
               app_file => 'app.feersum',
           );
           $runner->run($feersum_app);

DESCRIPTION

       Much like Plack::Runner, but with far fewer options.

METHODS

       "Feersum::Runner->new(%params)"
           Returns a Feersum::Runner singleton.  Params are only applied for the first
           invocation.

           listen  Listen on this TCP socket ("host:port" format).

           pre_fork
                   Fork this many worker processes.

                   The fork is run immediately at startup and after the app is loaded (i.e. in
                   the "run()" method).

           quiet   Don't be so noisy. (default: on)

           app_file
                   Load this filename as a native feersum app.

       "$runner->run($feersum_app)"
           Run Feersum with the specified app code reference.  Note that this is not a PSGI app,
           but a native Feersum app.

       "$runner->assign_request_handler($subref)"
           For sub-classes to override, assigns an app handler. (e.g.  Plack::Handler::Feersum).
           By default, this assigns a Feersum-native (and not PSGI) handler.

       "$runner->quit()"
           Initiate a graceful shutdown.  A signal handler for SIGQUIT will call this method.

AUTHOR

       Jeremy Stashewsky, "stash@cpan.org"

COPYRIGHT AND LICENSE

       Copyright (C) 2010 by Jeremy Stashewsky & Socialtext Inc.

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of
       Perl 5 you may have available.