Quickstart

What you’ll learn

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

Install

uv add lexigram-cache

Tip

For Redis backend support, add the optional dependency:

uv add lexigram-cache[redis]

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

Minimal Setup — CacheModule

import asyncio
from lexigram import Application
from lexigram.cache import CacheModule

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

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

asyncio.run(main())

Using CacheProvider Directly

from lexigram import Application
from lexigram.cache import CacheProvider


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

Testing with CacheModule.stub()

from lexigram.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