pico-data-redis 0.1.0

Redis integration for the Pico ecosystem: shared client, distributed cache backend for pico-caching.

pico-data-redis

Redis for the pico ecosystem: a shared injectable client, and a distributed backend that makes @cacheable (pico-caching) work across processes. Installing it is opting in.

Installation

pip install pico-data-redis

Quick start

redis:
  url: redis://cache.internal:6379/0

Inject the shared client anywhere:

from redis import Redis
from pico_ioc import component

@component
class Sessions:
    def __init__(self, redis: Redis):
        self._redis = redis

With pico-caching installed, @cacheable methods automatically use Redis instead of process memory — no code changes, the interceptor prefers any non-in-memory backend:

from pico_caching import cacheable

@component
class Reports:
    @cacheable(ttl_seconds=300)
    def heavy_query(self, day: str) -> dict: ...

Notes:

• Cached values are pickled — treat the Redis instance as trusted, private infrastructure.
• The backend fails open: an unreachable Redis degrades to cache misses, never to errors.
• Keys are namespaced under redis.cache_prefix (default pico:cache:); clear() only touches that namespace.
• The client's pool closes on container shutdown.

Documentation

Full documentation: https://dperezcabrera.github.io/pico-data-redis/

License

MIT