NAME

Plack::Middleware::Timeout

SYNOPSIS

    my $app = sub { ... };

    Plack::Middleeare::Timeout->wrap(
        $app,
        timeout  => sub { ... } || 60,
        # optional callback to set the custom response 
        response => sub {
            my ($response_obj,$execution_time) = @_;

            $response_obj->code(HTTP_REQUEST_TIMEOUT);
            $response_obj->body( encode_json({
                timeout => 1,
                other_info => {...},
            }));

            return $plack_response;
        }
    );

DESCRIPTION

Timeout any plack requests at an arbitrary time.

PARAMETERS

timeout

Determines how we're going to get the timeout value, either subref returning a value or any value accepted by subroutine defined in Time::HiRes::alarm, default 120 seconds.

response

Optional subroutine that receives two parameters, a Plack::Response object that we can further modify to fit our needs, if none is provided the middleware resolves to emitting a warning:

'Terminated request for uri '%s' due to timeout (%ds)'

AUTHOR

Tomasz Czepiel <tjmc@cpan.org>

LICENCE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.