coredis-utils 0.1.0

A collection of helpful utilities for coredis.

coredis-utils

A collection of helpful utilities for coredis.

Features

• Caching decorator with thundering herd protection and error caching
• Idempotency keys
• Fixed-window rate limiting

Installation

$ pip install coredis-utils

Getting started

First, create a CoredisUtils object wrapping a coredis.Redis instance:

from coredis import Redis
from coredis_utils import CoredisUtils

client = Redis(...)
utils = CoredisUtils(client)

Caching is implemented with a decorator:

@utils.cached(ttl=60)
async def my_task() -> int: ...

Idempotency uses a simple check:

if await utils.idempotent("my-key", ttl=60):
    ...  # code in this block can only run once

Rate limiting is similar:

for _ in range(15):
    print(await utils.limit("my-ip-addr", 10, 1))  # limit to 10/second

True
True
True
True
True
True
True
True
True
True
False
False
False
False
False