evoid-redis

Redis cache engine for EVOID — Intent Handler system

Quick Start • Intent Handler • Config • API

Quick Start

pip install evoid-redis

Method 1: Intent Handler (Recommended)

from evoid_redis import register_handlers
from evoid.core.cache import cache_get, cache_set, cache_delete

# Register Redis as cache handler
register_handlers(url="redis://localhost:6379", prefix="myapp:")

# Use high-level API — goes through Intent pipeline
await cache_set("session:abc", {"user": "Alice"}, ttl=300)
data = await cache_get("session:abc")
await cache_delete("session:abc")

Method 2: Direct API

from evoid_redis import create_cache

cache = create_cache("redis://localhost:6379", prefix="myapp:")
await cache.set("key", {"data": "value"}, ttl=300)
data = await cache.get("key")

Intent Handler

evoid-redis registers these Intent handlers:

How it works

1. register_handlers() registers Intent handlers for cache operations
2. cache_get() / cache_set() create Intents and execute through pipeline
3. Pipeline routes to Redis handler
4. Handler connects to Redis and performs operation

Configuration

TOML

[engines]
cache = "redis"

[engines.options.redis]
url = "redis://localhost:6379"
prefix = "myapp:"

Python

from evoid.config import config

app = config(
    engines={
        "cache": "redis",
        "options": {
            "redis": {
                "url": "redis://prod:6379",
                "prefix": "production:",
            },
        },
    },
)

API

register_handlers(url, prefix)

Register Redis as Intent handlers.

create_cache(url, prefix) -> RedisCache

Factory function for direct API access.

Methods

Dependencies

• evoid>=0.4.0
• redis[hiredis]>=5.0.0

Links

• EVOID Runtime
• Documentation
• Plugin Collection

License

MIT