Skip to main content

A simple asyncio-based rate limiter for Python3 using Redis.

Project description

py-redis-ratelimit version downloads

A simple asynchronous rate limiter based on redis.

Requirements

Installation

pip install py-redis-ratelimit

Examples

Basic example:

from redis.asyncio import Redis
import ratelimit, asyncio

redis = Redis(decode_responses=True)
limiter = ratelimit.RateLimit(
    redis, prefix="api_rate_limit", rate=10, period=60, retry_after=20
)
print(ratelimit.RateLimit.__doc__)  # print RateLimit class docstring


async def do_something():
    await limiter.acquire(
        identifier="do_something_function"
    )  # a unique identifier for the function. This let's RateLimit know what service/resource you are trying to access.
    ...


async def main():
    for x in range(40):
        try:
            print("Calling do_something() for the {}th time".format(x + 1))
            await do_something()
        except ratelimit.FloodWait as e:
            print("Exception:", e.to_dict())
            break


if __name__ == "__main__":
    asyncio.run(main())

Contributing

Pull requests are always welcome!!

License

MIT License

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

Py-redis-ratelimit-0.1.4.tar.gz (4.3 kB view details)

Uploaded Source

File details

Details for the file Py-redis-ratelimit-0.1.4.tar.gz.

File metadata

  • Download URL: Py-redis-ratelimit-0.1.4.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.0

File hashes

Hashes for Py-redis-ratelimit-0.1.4.tar.gz
Algorithm Hash digest
SHA256 b2be224f0842aeec12f2884f28ea643a3492868734ddbee9f3f457848d412be7
MD5 92100d24147d22729b583d06bffad1c8
BLAKE2b-256 a3231351cb5bf0f1c0298fb49ffc524de8f9aec19d079b26fa42e62a9778521a

See more details on using hashes here.

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