NAME
LWP::UserAgent::Patch::Retry - Add retries
VERSION
This document describes version 0.050 of LWP::UserAgent::Patch::Retry (from Perl distribution LWP-UserAgent-Patch-Retry), released on 2019-09-20.
SYNOPSIS
use LWP::UserAgent::Patch::Retry -n => 2, -delay => 3;DESCRIPTION
This patch adds retries to LWP::UserAgent when response from request is not a success.
Can be used with WWW::Mechanize because that module uses LWP::UserAgent.
CONFIGURATION
-n => INT (default: 2)
Number of retries. Default is 2, which means it will retry twice (so the total number of requests is 3).
-delay => INT (default: 3)
Delay between retries, in seconds.
-criteria => CODE
Specify custom criteria of whether to retry. Will be passed ($self, $response) and should return 1 if retry should be performed. For example if you do not want to retry on 404 errors:
use LWP::UserAgent::Patch::Retry
-criteria => sub {
my ($self, $resp) = @_;
return 1 if !$resp->is_success && $resp->code != 404;
};FAQ
Why not subclass?
By patching, you do not need to replace all the client code which uses LWP::UserAgent (or WWW::Mechanize, and so on).
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/LWP-UserAgent-Patch-Retry.
SOURCE
Source repository is at https://github.com/perlancar/perl-LWP-UserAgent-Patch-Retry.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=LWP-UserAgent-Patch-Retry
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
LWP::UserAgent::Determined, LWP::UserAgent::ExponentialBackoff
Retry in general: Retry, Sub::Retry, Perinci::Sub::Property::retry
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2019, 2017, 2015, 2013 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.