Skip to main content

Python decorators for asyncio

Project description


Python decorators for asyncio, including

  • throttle: Throttle a (coroutine) function that return an Awaitable


$ pip install aiodecorator


import time
import asyncio

from aiodecorator import (

now = time.time()

# -----------------------------------------------------
# The throttled function is only called twice a second
@throttle(2, 1)
async def throttled(index: int):
    diff = format(time.time - now, '.0f')
    print(index, f'{diff}s')
# -----------------------------------------------------

async def main():
    loop = asyncio.get_running_loop()
    tasks = [
        for index in range(5)

    await asyncio.wait(tasks)

# Output
# 0 0s
# 1 0s
# 2 1s
# 3 1s
# 4 2s


throttle(limit: int, interval: Union[float, int])

  • limit int Maximum number of calls within an interval.
  • interval Union[int, float] Timespan for limit in seconds.

Returns a decorator function



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiodecorator-1.0.2.tar.gz (3.2 kB view hashes)

Uploaded source

Built Distribution

aiodecorator-1.0.2-py3-none-any.whl (3.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page