Rate limit decorator
Project description
This packages introduces a function decorator preventing a functions from being called more often than allowed. This should prevent API providers from banning your applications by conforming to their rate limits.
It's similar to ratelimit with the following differences:
- also handles async functions
- accepts multiple limits (burst mode)
- allows applying rate limit to many functions
- allows assigning a cost
- sleep_and_retry utility is a function and accepts a limit of retries (1 by default)
Thanks to anyio it works under asyncio and trio event loops.
Usage
from datetime import timedelta
from ratelimit_anyio import *
limiter = RateLimiter((
RateLimit(timedelta(seconds=10), 10),
RateLimit(timedelta(minutes=10), 100),
))
@limiter(cost=1)
async def function():
# Simulate a remote call
import asyncio
await asyncio.sleep(3)
This function can be called up to 100 times within 10 minutes, and 10 times within any 10 seconds (burst mode). You can also declare functions cost (1 by default) which is useful when applying to more than one function, and they use the quota by different values
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ratelimit_anyio-0.2.0.tar.gz
(6.7 kB
view hashes)
Built Distribution
Close
Hashes for ratelimit_anyio-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7370e950c90db6c184e54c9fa83007757f5c9da47774bdf0e244aceb6d5d9fb0 |
|
MD5 | 6eda1d83726140385a184fd1c1900e8f |
|
BLAKE2b-256 | fb9d58b90d128b980c1e81d175e5e3d69e56cd0a8440367c6a23eb74ccd7c0d5 |