pico-caching 0.1.0

Declarative caching for the Pico ecosystem: @cacheable AOP with pluggable backends.

📦 pico-caching

Declarative method caching for the Pico ecosystem: @cacheable over pico-ioc method interception, pluggable backends, auto-discovered by pico-boot. Zero-config.

Install

pip install pico-caching

Use

from pico_ioc import component
from pico_caching import cacheable

@component
class UserRepo:
    @cacheable(ttl_seconds=60)
    async def find(self, user_id: int): ...

    @cacheable(key=lambda q: f"search:{q}")
    def search(self, q: str): ...

Sync and async (the awaited result is cached, never the coroutine). Default backend: thread-safe in-memory LRU with per-entry TTL (cache.max_entries, cache.default_ttl_seconds). Bring your own backend by implementing the CacheBackend protocol as a @component — it replaces the built-in automatically.

# application.yaml (optional)
cache:
  default_ttl_seconds: 300
  max_entries: 1024

Skipped for now: @cache_evict and a Redis backend — planned once real usage asks for them.

Documentation

Full docs at dperezcabrera.github.io/pico-caching.

License

MIT