---
name: "Feersum::Runner"
section: "3pm"
platform: "linux"
package: "feersum"
version: "1.505-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Feersum::Runner"
---

# Feersum::Runner(3pm)

feersum script core

## 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).

  - keepalive

    Enable/disable http keepalive requests.

  - read\_timeout

    Set read/keepalive timeout in seconds.

  - max\_connection\_reqs

    Set max requests per connection in case of keepalive - 0(default) for unlimited.

  - 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.