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

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.