fred-oss 0.19.0__tar.gz → 0.20.0__tar.gz

{fred_oss-0.19.0/src/main/fred_oss.egg-info → fred_oss-0.20.0}/PKG-INFO

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

fred_oss-0.20.0/src/main/fred/monad/__init__.py

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

fred_oss-0.20.0/src/main/fred/monad/_either.py

@@ -0,0 +1,93 @@
+from dataclasses import dataclass
+from functools import wraps
+from typing import (
+    Callable,
+    Generic,
+    Generator,
+    TypeVar,
+)
+
+from fred.settings import logger_manager
+from fred.monad.interface import MonadInterface
+
+logger = logger_manager.get_logger(__name__)
+
+A = TypeVar("A")
+B = TypeVar("B")
+
+
+@dataclass(frozen=True, slots=True)
+class EitherWrapper(Generic[A]):
+    function: Callable[..., A]
+
+    def __call__(self, *args, **kwargs) -> A:
+        return self.function(*args, **kwargs)
+
+    def either(self, *args, **kwargs)-> 'Either[A]':
+        try:
+            return Right[A].from_value(val=self.function(*args, **kwargs))
+        except Exception as e:
+            return Left(exception=e)
+
+
+class Either(MonadInterface[A]):
+
+    @classmethod
+    def comprehension(cls, generator: Generator):
+        try:
+            return Either.from_value(val=next(generator))
+        except Exception as e:
+            return Left(exception=e)
+
+    @classmethod
+    def decorator(cls, function: Callable):
+        return wraps(function, updated=())(EitherWrapper(function=function))
+
+    @classmethod
+    def from_value(cls, val: A) -> 'Either[A]':
+        if isinstance(val, Exception):
+            return Left(exception=val)
+        return Right(value=val)
+
+    def resolve(self) -> A:
+        match self:
+            case Right(value=value):
+                return value
+            case Left(exception=exception):
+                raise exception
+            case _:
+                raise TypeError("Unknown Either type")
+            
+    def __iter__(self) -> Generator[A, None, None]:
+        match self:
+            case Right(value=value):
+                yield from [value]
+            case Left(exception=exception):
+                logger.warning(f"Attempted to iterate over Left: {exception}")
+                yield from []
+            case _:
+                raise TypeError("Unknown Either type")
+
+
+@dataclass(frozen=True, slots=True)
+class Right(Either[A]):
+    value: A
+
+    def flat_map(self, function: Callable[[A], Either[B]]) -> Either[B]:
+        try:
+            return function(self.value)
+        except Exception as e:
+            logger.exception(f"Error in flat_map: {e}")
+            # Consider that a right that fails is a left
+            return Left(exception=e)
+
+
+@dataclass(frozen=True, slots=True)
+class Left(Either[A]):
+    exception: Exception
+
+    def flat_map(self, function: Callable[[A], Either[B]]) -> Either[B]:
+        return Left(exception=self.exception)  # Propagate exception
+    
+    def map(self, function: Callable[[A], B]) -> Either[B]:
+        return Left(exception=self.exception)  # Propagate exception

fred_oss-0.20.0/src/main/fred/monad/catalog.py

@@ -0,0 +1,11 @@
+import enum
+
+from fred.monad._either import Either, Left, Right
+
+
+class MonadCatalog(enum.Enum):
+    """Enum representing the different types of Monads."""
+    EITHER = type("Either", (Either,), {"Left": Left, "Right": Right})
+
+    def __call__(self, *args, **kwargs):
+        return self.value.from_value(*args, **kwargs)

fred_oss-0.20.0/src/main/fred/monad/interface.py

@@ -0,0 +1,22 @@
+from typing import (
+    Callable,
+    Generic,
+    TypeVar,
+)
+
+A = TypeVar("A")
+B = TypeVar("B")
+
+
+class MonadInterface(Generic[A]):
+    
+    @classmethod
+    def from_value(cls, val: A) -> 'MonadInterface[A]':
+        raise NotImplementedError
+    
+    def flat_map(self, function: Callable[[A], 'MonadInterface[B]']) -> 'MonadInterface[B]':
+        raise NotImplementedError
+
+    def map(self, function: Callable[[A], B]) -> 'MonadInterface[B]':
+        # Map can be implemented using flat_map to avoid code duplication and ensure consistency
+        return self.flat_map(function=lambda value: type(self).from_value(function(value)))

fred_oss-0.20.0/src/main/fred/version

@@ -0,0 +1 @@
+0.20.0

{fred_oss-0.19.0 → fred_oss-0.20.0/src/main/fred_oss.egg-info}/PKG-INFO

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

{fred_oss-0.19.0 → fred_oss-0.20.0}/src/main/fred_oss.egg-info/SOURCES.txt

@@ -34,6 +34,10 @@ src/main/fred/integrations/databricks/wrappers/dbutils.py
 src/main/fred/integrations/runpod/__init__.py
 src/main/fred/integrations/runpod/cli_ext.py
 src/main/fred/integrations/runpod/helper.py
+src/main/fred/monad/__init__.py
+src/main/fred/monad/_either.py
+src/main/fred/monad/catalog.py
+src/main/fred/monad/interface.py
 src/main/fred/utils/__init__.py
 src/main/fred/utils/dateops.py
 src/main/fred/utils/runtime.py

fred_oss-0.19.0/src/main/fred/version

@@ -1 +0,0 @@
-0.19.0