NAME

       Twitter::API::Trait::RateLimiting - Automatically sleep as needed to handle rate limiting

VERSION

       version 1.0006

SYNOPSIS

           use Twitter::API;

           my $client = Twitter::API->new_with_options(
               traits => [ qw/ApiMethods RateLimiting/ ],
               %other_options,
           );

           # Use $client as normal

DESCRIPTION

       Twitter's API implements rate limiting in a 15-minute window, and will serve up an HTTP 429 error if the
       rate limit is exceeded for a window.  Applying this trait will give Twitter::API the ability to
       automatically sleep as much as is needed and then retry a request instead of simply throwing an
       exception.

ATTRIBUTES

   rate_limit_sleep_code
       A coderef, called to implement sleeping.  It takes a single parameter - the number of seconds to sleep.
       The default implementation is:

           sub { sleep shift }

SEE ALSO

       <https://developer.twitter.com/en/docs/basics/rate-limiting>

AUTHOR

       Marc Mims <marc@questright.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2015-2021 by Marc Mims.

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

perl v5.32.1                                       2021-09-11             Twitter::API::Trait::RateLimiting(3pm)