NAME
   HTTP::Tiny::CustomRetry - Retry failed HTTP::Tiny requests

VERSION
   This document describes version 0.002 of HTTP::Tiny::CustomRetry (from
   Perl distribution HTTP-Tiny-CustomRetry), released on 2019-04-10.

SYNOPSIS
    use HTTP::Tiny::CustomRetry;

    my $res  = HTTP::Tiny::CustomRetry->new(
        retry_strategy => 'Exponential', # required, pick a strategy (which is name of submodule under Algorithm::Backoff::*)

        # the following attributes are available to customize the Exponential
        # strategy, which are attributes from Algorithm::Backoff::Exponential with
        # retry_ prefix.

        # retry_max_attempts     => ...,
        # retry_jitter_factor    => ...,
        # retry_initial_delay    => ...,
        # retry_max_delay        => ...,
        # retry_exponent_base    => ...,
        # retry_delay_on_success => ...,

    )->get("http://www.example.com/");

DESCRIPTION
   This class is a subclass of HTTP::Tiny that retry fail responses (a.k.a.
   responses with 5xx statuses; 4xx are considered the client's fault so we
   don't retry those).

   It's a more elaborate version of HTTP::Tiny::Retry which offers a simple
   retry strategy: using a constant delay between attempts.
   HTTP::Tiny::CustomRetry uses Algorithm::Retry to offer several
   retry/backoff strategies.

ENVIRONMENT
 HTTP_TINY_CUSTOMRETRY_STRATEGY
   String. Used to set default for the "retry_strategy" attribute.

   Other "retry_ATTRNAME" attributes can also be set via environment
   HTTP_TINY_CUSTOMRETRY_*ATTRNAME*, for example "retry_max_attempts" can
   be set via HTTP_TINY_CUSTOMRETRY_MAX_ATTEMPTS.

HOMEPAGE
   Please visit the project's homepage at
   <https://metacpan.org/release/HTTP-Tiny-CustomRetry>.

SOURCE
   Source repository is at
   <https://github.com/perlancar/perl-HTTP-Tiny-CustomRetry>.

BUGS
   Please report any bugs or feature requests on the bugtracker website
   <https://rt.cpan.org/Public/Dist/Display.html?Name=HTTP-Tiny-CustomRetry
   >

   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
   Algorithm::Retry and "Algorithm::Retry::*" strategy modules.

   HTTP::Tiny

   HTTP::Tiny::Retry and HTTP::Tiny::Patch::Retry, simpler retry strategy
   (constant delay).

   HTTP::Tiny::Patch::CustomRetry, patch version of this module.

AUTHOR
   perlancar <[email protected]>

COPYRIGHT AND LICENSE
   This software is copyright (c) 2019 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.