fred-oss 0.14.0__tar.gz → 0.15.0__tar.gz

{fred_oss-0.14.0/src/main/fred_oss.egg-info → fred_oss-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-oss
-Version: 0.14.0
+Version: 0.15.0
 Summary: FREDOSS
 Home-page: https://fred.fahera.mx
 Author: Fahera Research, Education, and Development

fred_oss-0.15.0/src/main/fred/dao/__init__.py

@@ -0,0 +1,11 @@
+from fred.maturity import Maturity, MaturityLevel
+
+
+module_maturity = Maturity(
+    level=MaturityLevel.ALPHA,
+    reference=__name__,
+    message=(
+        "Fred-DAO implementation is in early development "
+        "and therefore currently with incomplete and unstable features."
+    )
+)

fred_oss-0.15.0/src/main/fred/dao/service/_redis.py

@@ -0,0 +1,25 @@
+from redis import Redis, ConnectionPool
+
+from fred.dao.service.utils import get_redis_configs_from_payload
+from fred.dao.service.interface import ServiceConnectionPoolInterface, ServiceInterface
+
+
+class RedisConnectionPool(ServiceConnectionPoolInterface[ConnectionPool]):
+
+    @classmethod
+    def _create_pool(cls, **kwargs) -> ConnectionPool:
+        configs = get_redis_configs_from_payload(payload=kwargs, keep=False)
+        return ConnectionPool(**configs)
+
+
+class RedisService(ServiceInterface[Redis]):
+    instance: Redis
+
+    @classmethod
+    def _create_instance(cls, **kwargs) -> Redis:
+        return Redis(connection_pool=RedisConnectionPool.get_or_create_pool(**kwargs))
+
+    @classmethod
+    def auto(cls, **kwargs) -> "RedisService":
+        cls.instance = Redis(connection_pool=RedisConnectionPool.get_or_create_pool(**kwargs))
+        return cls(**kwargs)

fred_oss-0.15.0/src/main/fred/dao/service/catalog.py

@@ -0,0 +1,22 @@
+import enum
+from functools import lru_cache
+
+from fred.dao.service.interface import ServiceInterface
+from fred.dao.service._redis import RedisService
+
+
+class ServiceCatalog(enum.Enum):
+    REDIS = RedisService
+
+    @classmethod
+    def from_classname(cls, classname: str) -> "ServiceCatalog":
+        for item in cls:
+            if item.value.__name__ == classname:
+                return item
+        raise ValueError(f"No service found for classname: {classname}")
+
+    def service_cls(self) -> type[ServiceInterface]:
+        return self.value
+
+    def auto(self, **kwargs) -> ServiceInterface:
+        return self.value.auto(**kwargs)

fred_oss-0.15.0/src/main/fred/dao/service/interface.py

@@ -0,0 +1,54 @@
+import uuid
+import json
+from functools import lru_cache
+from typing import Generic, TypeVar
+
+T = TypeVar("T")
+
+
+class ServiceConnectionPoolInterface(Generic[T]):
+    pool_registry: dict[str, T] = {}
+
+    @classmethod
+    def get_pool_id(cls, **kwargs) -> str:
+        return str(uuid.uuid5(uuid.NAMESPACE_OID, json.dumps(kwargs, sort_keys=True)))
+
+    @classmethod
+    def _create_pool(cls, **kwargs) -> T:
+        raise NotImplementedError("This method should be implemented by subclasses.")
+
+    @classmethod
+    @lru_cache
+    def get_or_create_pool(cls, **kwargs) -> T:
+        pool_id = cls.get_pool_id(**kwargs)
+        pool = cls.pool_registry.get(pool_id)
+        if not pool:
+            pool = cls.pool_registry[pool_id] = cls._create_pool(**kwargs)
+        return pool
+
+
+class ServiceInterface(Generic[T]):
+    instance: T
+
+    def __init__(self, **kwargs):
+        self.config = kwargs
+
+    @classmethod
+    def _create_instance(cls, **kwargs) -> T:
+        raise NotImplementedError("This method should be implemented by subclasses.")
+    
+    @classmethod
+    def auto(cls, **kwargs) -> "ServiceInterface":
+        raise NotImplementedError("This method should be implemented by subclasses.")
+
+    @property
+    def client(self) -> T:  
+        if not getattr(self, "instance", None):
+            self.instance = self._create_instance(**getattr(self, "config", {}))
+        return self.instance
+    
+    def close(self):
+        # Close the instance if it has a close method.
+        # This method can be overridden by subclasses if needed.
+        if self.instance and hasattr(self.instance, "close") and callable(self.instance.close):
+            self.instance.close()

fred_oss-0.15.0/src/main/fred/dao/service/utils.py

@@ -0,0 +1,37 @@
+from fred.settings import get_environ_variable
+
+
+def get_redis_configs_from_payload(
+        payload: dict,
+        keep: bool = False,
+    ) -> dict:
+    """Extract Redis configuration from the given payload dictionary.
+    This function looks for common Redis configuration keys in the payload
+    dictionary. If a key is not found, it falls back to environment variables.
+    Args:
+        payload (dict): The dictionary from which to extract Redis configuration.
+        keep (bool): If True, the original keys are retained in the payload. If False, they are removed.
+    Returns:
+        dict: A dictionary containing Redis configuration parameters.
+    """
+    host = port = password = db = None
+    for host_key in ["host", "redis_host"]:
+        if (host := payload.get(host_key) if keep else payload.pop(host_key, None)):
+            break
+    for port_key in ["port", "redis_port"]:
+        if (port := payload.get(port_key) if keep else payload.pop(port_key, None)):
+            break
+    for password_key in ["password", "redis_password"]:
+        if (password := payload.get(password_key) if keep else payload.pop(password_key, None)):
+            break
+    for db_key in ["db", "redis_db"]:
+        if (db := payload.get(db_key) if keep else payload.pop(db_key, None)):
+            break
+    return {
+        "host": host or get_environ_variable(name="REDIS_HOST", default="localhost"),
+        "port": int(port or get_environ_variable(name="REDIS_PORT", default=6379)),
+        "password": password or get_environ_variable(name="REDIS_PASSWORD", default=None),
+        "db": int(db or get_environ_variable(name="REDIS_DB", default=0)),
+        "decode_responses": True,
+        **(payload.get("redis_configs", {}) if keep else payload.pop("redis_configs", {})),
+    }

fred_oss-0.15.0/src/main/fred/version

@@ -0,0 +1 @@
+0.15.0

{fred_oss-0.14.0 → fred_oss-0.15.0/src/main/fred_oss.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-oss
-Version: 0.14.0
+Version: 0.15.0
 Summary: FREDOSS
 Home-page: https://fred.fahera.mx
 Author: Fahera Research, Education, and Development

{fred_oss-0.14.0 → fred_oss-0.15.0}/src/main/fred_oss.egg-info/SOURCES.txt

@@ -11,6 +11,12 @@ src/main/fred/cli/__init__.py
 src/main/fred/cli/__main__.py
 src/main/fred/cli/interface.py
 src/main/fred/cli/main.py
+src/main/fred/dao/__init__.py
+src/main/fred/dao/service/__init__.py
+src/main/fred/dao/service/_redis.py
+src/main/fred/dao/service/catalog.py
+src/main/fred/dao/service/interface.py
+src/main/fred/dao/service/utils.py
 src/main/fred/integrations/databricks/__init__.py
 src/main/fred/integrations/databricks/cli_ext.py
 src/main/fred/integrations/databricks/runtime.py

fred_oss-0.14.0/src/main/fred/version

@@ -1 +0,0 @@
-0.14.0