evoid-scylla

ScyllaDB/Cassandra storage engine — Intent Handler system

Quick Start • Intent Handler • Config • API

Quick Start

uv add evoid-scylla

Method 1: Intent Handler (Recommended)

from evoid_scylla import register_handlers
from evoid.core.storage import storage_read, storage_write, storage_delete

# Register ScyllaDB as storage handler
register_handlers(
    contact_points=["127.0.0.1"],
    port=9042,
    keyspace="evoid",
)

# Use high-level API
await storage_write("user:1", {"name": "Alice"})
user = await storage_read("user:1")
await storage_delete("user:1")

Method 2: Direct API

from evoid_scylla import create_storage

storage = create_storage(contact_points=["127.0.0.1"], port=9042)
await storage.write("user:1", {"name": "Alice"})
user = await storage.read("user:1")

Intent Handler

evoid-scylla registers these Intent handlers:

Configuration

TOML

[engines]
storage = "scylla"

[engines.options.scylla]
contact_points = ["127.0.0.1"]
port = 9042
keyspace = "evoid"

API

register_handlers(contact_points, port, keyspace)

Register ScyllaDB as Intent handlers.

create_storage(contact_points, port, keyspace) -> ScyllaStorage

Factory function for direct API access.

DI Integration

When you call register_handlers(), ScyllaDB is auto-registered as storage.scylla in evoid-di:

from evoid_di import di

# After register_handlers(), set up fallback chain:
di.set_fallback("storage.scylla", ["storage.sqlite", "cache.redis"])

# Auto-fallback on failure:
storage = di.resolve_with_fallback("storage.scylla")

Dependencies

• evoid>=0.4.0
• cassandra-driver>=3.29.0

Links

• EVOID Runtime
• Documentation
• Plugin Collection

License

MIT