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/

Built for AI-assisted development

pico-data-redis is part of an ecosystem designed for humans and coding agents building software together. Every package ships AGENTS.md working conventions, an llms.txt machine-readable docs index and documented behaviour pinned by regression tests; pico-testing gives agents a verification loop for their own changes, and releases are gated by the whole ecosystem booting together against real infrastructure. The full story: Built for AI-assisted development.

Install the agent skills for Claude Code or OpenAI Codex:

curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash

The pico-conventions skill teaches the assistant this module's API surface and invariants; /add-component and /add-tests scaffold components and tests that use it.

License

MIT