simple-redis-cache 1.0.0

A library that simplifies working with Redis in Python

simple-redis-cache

Простой инструмент для кэширования асинхронных и синхронных функций в Redis.

Особенности

• Автоматическая генерация ключей — ключи создаются на основе имени функции и аргументов
• Инвалидация по префиксу — очищайте кэш группами
• Кастомный JSON-энкодер — поддерживает datetime, Decimal, UUID, Pydantic-модели
• Устойчивость к ошибкам — ошибки Redis не ломают приложение
• Гибкая настройка — можно передать свой логгер
• sync/async поддержка — можно использовать как для синхронных, так и для асинхронных функций
• 100% покрытие - полная уверенность в коде
• 100% docstrings - полная документация функций

Установка

pip install simple-redis-cache

Использование:

from simple_redis_cache.sync import Cache  # Синхронный

from simple_redis_cache.asyncio import Cache  # Асинхронный

Пример

from redis.asyncio import Redis
from simple_redis_cache import Cache

redis = Redis()
cache = Cache(redis)

@cache.cache(ttl=60, prefix="user")
async def get_user(user_id: int):
    return {"id": user_id, "name": "Alice"}

# Первый вызов — вычисляется, второй — из кэша
r1 = await get_user(1)
r2 = await get_user(1)

# Одинаковый результат
print(r1 == r2)

Инвалидация

await cache.invalidate_cache(prefix="user")

Лицензия

MIT

Автор

hotpotato89