pyyarl 1.0.0

Description:

pyyarl 1.0.0

pyyarl
pyyarl (Yet Another Rate Limiter for Python) is a Python package for rate
limiting function calls.
A lot of Python rate limiting packages seem to exist, but many of them do not
have the desired behavior in many use cases. For example, many clear tasks only
when the period has elapsed, rather than using a sliding window, or they may
mark a task as done prior to running the function rather than after.
pyyarl uses a sliding window of completion times to enforce the rate limit, and
is simple to use. pyyarl currently supports single and multithreaded execution.
Table of Contents

Quickstart
Having multiple functions limited
together

Quickstart
For example, the default Google Docs read request quota might be 300 requests
per minute:
from pyyarl import rated_limited

@rate_limited(max_calls=300, period_s=60)
def make_read_request(file_id):
... # some request to the Google Docs API


for file_id in file_ids:
res = make_read_request(file_id)

Having multiple functions limited together
Sometimes, you want to limit multiple functions together such that their calls
count towards the same rate.
from pyyarl import RateLimiter

rate_limiter = RateLimiter(max_calls=300, period_s=60)

@rate_limiter
def make_read_request_one(file_id) -> bool:
... # some request to the Google Docs API


@rate_limiter
def make_read_request_two(file_id):
... # some other request to the Google Docs API


for file_id in file_ids:
if make_read_request_one(file_id):
make_read_request_two(file_id)