fred-oss 0.25.0__tar.gz → 0.26.0__tar.gz

{fred_oss-0.25.0/src/main/fred_oss.egg-info → fred_oss-0.26.0}/PKG-INFO

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

{fred_oss-0.25.0 → fred_oss-0.26.0}/src/main/fred/future/impl.py

@@ -6,6 +6,7 @@ from typing import (
 )
 
 from fred.settings import logger_manager
+from fred.future.settings import FRD_FUTURE_DEFAULT_EXPIRATION
 from fred.future.callback.interface import CallbackInterface
 from fred.monad.interface import MonadInterface
 from fred.monad.catalog import EitherMonad
@@ -217,3 +218,44 @@ class Future(MonadInterface[A]):
         Returns: Future[B]: A new Future containing the transformed result.
         """
         return self.flat_map(function=lambda value: type(self).from_value(function(value)))
+
+    @classmethod
+    def pullsync(
+            cls,
+            future_id: str,
+            delay: float = 0.001,
+            delay_incr: float = 0.001,
+            delay_max: float = 30,
+            timeout: float = FRD_FUTURE_DEFAULT_EXPIRATION,
+            on_complete: Optional[CallbackInterface] = None,
+            **kwargs
+        ) -> 'Future[A]':
+        """Pulls an existing future from the backend storage by its ID.
+        This method allows for retrieving and interacting with a future
+        that was previously created and stored in the backend.
+
+        Args:
+            future_id (str): The unique identifier of the future to be pulled.
+            delay (float): Initial delay between checks for the future's completion.
+            delay_incr (float): Incremental increase in delay after each check.
+            delay_max (float): Maximum delay between checks.
+            timeout (float): Maximum time to wait for the future to complete.
+            on_complete (Optional[CallbackInterface]): An optional callback to be executed
+                                                      when the future completes.
+            **kwargs: Additional keyword arguments to be passed to the Future constructor.
+        Returns:
+            Future[A]: A Future instance representing the pulled future.
+        """
+        from fred.future.utils import pull_future_result
+
+        return cls(
+            function=lambda: pull_future_result(
+                future_id=future_id,
+                delay=delay,
+                delay_incr=delay_incr,
+                delay_max=delay_max,
+                timeout=timeout,
+            ),
+            on_complete=on_complete,
+            **kwargs
+        )

fred_oss-0.26.0/src/main/fred/future/utils.py

@@ -0,0 +1,39 @@
+import time
+from typing import TypeVar, Optional
+
+from fred.future.settings import FRD_FUTURE_DEFAULT_EXPIRATION
+
+A = TypeVar("A")
+
+
+def pull_future_result(
+        future_id: str,
+        delay: float = 0.001,
+        delay_incr: float = 0.001,
+        delay_max: float = 30,
+        timeout: float = FRD_FUTURE_DEFAULT_EXPIRATION,
+    ) -> A:
+    from fred.future.impl import FutureResult, FutureUndefinedInProgress, FutureUndefinedPending
+
+    if timeout <= 0:
+        raise ValueError(f"Pull operation for future_id '{future_id}' has timed out.")
+
+    match FutureResult.from_backend(future_id=future_id):
+        case None:
+            raise ValueError(f"No future found with ID '{future_id}'")
+        case FutureResult(value=value):
+            return value.resolve()
+        case FutureUndefinedPending() | FutureUndefinedInProgress():
+            # If the future is not yet defined, wait for it to complete
+            time.sleep(delay)
+            # Increase the delay for the next check to avoid busy waiting (exponential backoff) capped at delay_max
+            return pull_future_result(
+                future_id=future_id,
+                delay=(delay + delay_incr) if delay < delay_max else delay_max,
+                delay_incr=delay,
+                delay_max=delay_max,
+                # TODO: Consider using a more precise timeout mechanism based on elapsed time
+                timeout=timeout - delay,
+            )
+        case _:
+            raise ValueError(f"Unknown future state for ID '{future_id}'")

fred_oss-0.26.0/src/main/fred/version

@@ -0,0 +1 @@
+0.26.0

{fred_oss-0.25.0 → fred_oss-0.26.0/src/main/fred_oss.egg-info}/PKG-INFO

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

{fred_oss-0.25.0 → fred_oss-0.26.0}/src/main/fred_oss.egg-info/SOURCES.txt

@@ -27,6 +27,7 @@ src/main/fred/future/__init__.py
 src/main/fred/future/impl.py
 src/main/fred/future/result.py
 src/main/fred/future/settings.py
+src/main/fred/future/utils.py
 src/main/fred/future/callback/__init__.py
 src/main/fred/future/callback/_function.py
 src/main/fred/future/callback/catalog.py

fred_oss-0.25.0/src/main/fred/version

@@ -1 +0,0 @@
-0.25.0