Quickstart

What you’ll learn

• Install oridecon-cache with uv
• Wire the cache with CacheModule or CacheProvider
• Get, set, and delete cache entries with TTL

Install

uv add oridecon-cache

Tip

For Redis backend support, add the optional dependency:

uv add oridecon-cache[redis]

For Memcached: uv add oridecon-cache[memcached]. For semantic caching with FAISS: uv add oridecon-cache[semantic].

Minimal Setup — CacheModule

import asyncio
from oridecon import Application
from oridecon.cache import CacheModule

async def main():
    async with Application.boot(
        name="my-app",
        modules=[CacheModule.configure()],
    ) as app:
        from oridecon.cache import CacheService

        cache = await app.container.resolve(CacheService)
        await cache.set("greeting", "Hello, Oridecon!")
        value = await cache.get("greeting")
        print(value)  # "Hello, Oridecon!"

asyncio.run(main())

Using CacheProvider Directly

from oridecon import Application
from oridecon.cache import CacheProvider


def create_app() -> Application:
    app = Application(name="my-app")
    app.add_provider(CacheProvider())
    return app

Testing with CacheModule.stub()

from oridecon.cache import CacheModule

# In-memory backend with no external connections
test_module = CacheModule.stub()

Next Steps

• Guide — caching concepts and workflows
• How-Tos — Redis, Memcached, stampede protection recipes
• Configuration — all configuration keys