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-R
etry>
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 <
[email protected]>
COPYRIGHT AND LICENSE
This software is copyright (c) 2019, 2017, 2015, 2013 by
[email protected].
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
