aioburst 0.1.1

A library to limit async calls using a waterwheel approach to ensure calls maximize the rate limit.

aioburst

A library to limit async calls using a waterwheel approach to ensure calls maximize the rate limit. The library is extremely light, using only core python packages.

Usage

Install the package using pip:

pip install aioburst

Import the limiter:

from aioburst import limiter

The package is purely functional, so there is no class to instantiate. limiter is used as a context manager:

async with limiter(semaphore, period):
    ...

semaphore is an instance of asyncio.Semaphore instantiated with a value equal to the number of simultanous calls that are allowed. Pass the semaphore instance to limiter. period is the period over which the number of calls are evaluated in seconds. For example, if you want to make 4 calls/second, you would pass in semaphore=Semaphore(4) and period=1.