evoid-base 0.1.0__py3-none-any.whl

evoid_base/__init__.py

@@ -0,0 +1,12 @@
+"""EVOID Plugin Base — shared contracts and utilities for all plugins."""
+
+from .contracts import StorageEngine, CacheEngine, LoggerEngine
+from .utils import resolve_engine, inject_deps
+
+__all__ = [
+    "StorageEngine",
+    "CacheEngine",
+    "LoggerEngine",
+    "resolve_engine",
+    "inject_deps",
+]

evoid_base/contracts.py

@@ -0,0 +1,47 @@
+"""Shared contracts for EVOID plugins.
+
+All storage/cache/logger plugins implement these protocols.
+This ensures SmartStorage and other routing engines can work with any backend.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Protocol
+
+
+class StorageEngine(Protocol):
+    """Contract for storage backends (SQLite, PostgreSQL, ScyllaDB, etc.)."""
+
+    async def write(self, key: str, data: dict[str, Any], **kwargs) -> bool: ...
+
+    async def read(self, key: str, **kwargs) -> Any | None: ...
+
+    async def delete(self, key: str, **kwargs) -> bool: ...
+
+    async def health(self) -> bool: ...
+
+
+class CacheEngine(Protocol):
+    """Contract for cache backends (Redis, Memory, etc.)."""
+
+    async def get(self, key: str) -> Any | None: ...
+
+    async def set(self, key: str, value: Any, ttl: int | None = None) -> bool: ...
+
+    async def delete(self, key: str) -> bool: ...
+
+    async def exists(self, key: str) -> bool: ...
+
+    async def health(self) -> bool: ...
+
+
+class LoggerEngine(Protocol):
+    """Contract for logging backends (Loguru, stdlib, etc.)."""
+
+    def info(self, msg: str, **kwargs) -> None: ...
+
+    def warning(self, msg: str, **kwargs) -> None: ...
+
+    def error(self, msg: str, **kwargs) -> None: ...
+
+    def debug(self, msg: str, **kwargs) -> None: ...

evoid_base/utils.py

@@ -0,0 +1,37 @@
+"""Shared utilities for EVOID plugins."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from evoid.engines.plugin import resolve as _resolve
+
+
+def resolve_engine(name: str, engine_type: str = "engine") -> Any:
+    """Resolve an engine from the plugin registry.
+
+    Args:
+        name: Engine name (e.g., "sqlite", "redis", "postgresql")
+        engine_type: Plugin type (e.g., "engine", "storage", "cache")
+
+    Returns:
+        The engine factory or instance
+    """
+    return _resolve(name, engine_type)
+
+
+async def inject_deps(ctx, engines: dict[str, str]) -> None:
+    """Inject multiple engines into ctx.deps.
+
+    Args:
+        ctx: The Context object
+        engines: Mapping of dep_name -> engine_name (e.g., {"storage": "sqlite", "cache": "redis"})
+
+    Example:
+        await inject_deps(ctx, {"storage": "sqlite", "cache": "redis"})
+        # ctx.deps["storage"] = sqlite engine
+        # ctx.deps["cache"] = redis engine
+    """
+    for dep_name, engine_name in engines.items():
+        if dep_name not in ctx.deps:
+            ctx.deps[dep_name] = resolve_engine(engine_name)

evoid_base-0.1.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: evoid-base
+Version: 0.1.0
+Summary: Base contracts and utilities for EVOID plugins
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: evoid>=0.4.0

evoid_base-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+evoid_base/__init__.py,sha256=yWw00D7BRAXcUfVgCRQZ-4kaV5vcn1wzHiyI-cYq4u8,304
+evoid_base/contracts.py,sha256=gyOyKF8d7IuY9EvC_F3-hhm4v6bzSZlEVkplKuqs2Bs,1299
+evoid_base/utils.py,sha256=FOrlBd2riBurY9s8bp4vUp4G2I8MXSVRZvQePegsQtQ,1106
+evoid_base-0.1.0.dist-info/METADATA,sha256=-RfQieQJoxhrV03onRxefVF32kBZWHw7JYW817T6kgk,186
+evoid_base-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+evoid_base-0.1.0.dist-info/RECORD,,

evoid_base-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any