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.