fred-oss 0.46.0__tar.gz → 0.48.0__tar.gz

{fred_oss-0.46.0/src/main/fred_oss.egg-info → fred_oss-0.48.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-oss
-Version: 0.46.0
+Version: 0.48.0
 Summary: FREDOSS
 Home-page: https://fred.fahera.mx
 Author: Fahera Research, Education, and Development
@@ -14,6 +14,7 @@ Requires-Dist: redis==6.4.0
 Requires-Dist: requests==2.32.5
 Requires-Dist: fastapi==0.116.2
 Requires-Dist: uvicorn[standard]==0.35.0
+Requires-Dist: pillow==11.3.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: description

{fred_oss-0.46.0 → fred_oss-0.48.0}/requirements.txt

@@ -7,4 +7,6 @@ redis==6.4.0
 requests==2.32.5
 fastapi==0.116.2
 uvicorn[standard]==0.35.0
+# Fred Utils
+pillow==11.3.0
 # Databricks Runtime: 16.4 LTS (Python 3.12.3)

fred_oss-0.48.0/src/main/fred/utils/imops.py

@@ -0,0 +1,73 @@
+import io
+import base64
+from typing import Optional
+
+from PIL.Image import Image
+
+from fred.settings import logger_manager
+
+logger = logger_manager.get_logger(__name__)
+
+
+def save_image_to_path(image: Image, path: str) -> None:
+    """
+    Save a PIL Image to the specified file path.
+
+    Args:
+        image (Image): The PIL Image to save.
+        path (str): The file path where the image will be saved.
+    """
+    image.save(path)
+
+
+def image_to_b64(image: Image, format: Optional[str] = None) -> str:
+    """
+    Convert a PIL Image to a base64-encoded string.
+    Args:
+        image (Image): The PIL Image to convert.
+        format (Optional[str]): The format to use for encoding (e.g., "PNG", "JPEG"). Defaults to "PNG" if None.
+    Returns:
+        str: The base64-encoded image string.
+    """
+    # Convert the image to a base64 string
+    buffer = io.BytesIO()
+    image.save(buffer, format=format or "PNG")
+    return base64.b64encode(buffer.getvalue()).decode("utf-8")
+
+
+def get_image_from_b64(image_b64: str) -> Image:
+    """Load an image from a base64-encoded string.
+    Args:
+        image_b64 (str): The base64-encoded image string.
+    Returns:
+        Image: The loaded PIL Image.
+    """
+    import PIL.Image
+    # Decode the base64 string to bytes
+    image_data = base64.b64decode(image_b64)
+    # Open the image using PIL
+    return PIL.Image.open(io.BytesIO(image_data))
+
+
+def get_image_from_path(path: str) -> Image:
+    """
+    Load an image from the specified file path.
+    Args:
+        path (str): The file path to load the image from.
+    Returns:
+        Image: The loaded PIL Image.
+    """
+    import PIL.Image
+    # Open the image using PIL
+    return PIL.Image.open(path)
+
+
+def display_image_from_b64(image_b64: str) -> None:
+    """
+    Display a base64-encoded image.
+
+    Args:
+        image_b64 (str): The base64-encoded image string.
+    """
+    image = get_image_from_b64(image_b64=image_b64)
+    image.show()

fred_oss-0.48.0/src/main/fred/version

@@ -0,0 +1 @@
+0.48.0

{fred_oss-0.46.0 → fred_oss-0.48.0}/src/main/fred/worker/runner/rest/routers/_runner.py

@@ -1,5 +1,7 @@
 from dataclasses import dataclass
+from typing import Optional
 
+from fred.future import Future
 from fred.settings import logger_manager
 from fred.utils.dateops import datetime_utcnow
 from fred.worker.runner.rest.routers.interface import RouterInterface
@@ -86,6 +88,21 @@ class RunnerRouterMethods:
             "dispatched_at": datetime_utcnow().isoformat(),
         }
 
+    def runner_output(self, request_id: str, nonblocking: bool = False, timeout: Optional[float] = None) -> dict:
+
+        output_requested_at = datetime_utcnow().isoformat()
+        # Subscribe to the future result using the request_id
+        future = Future.subscribe(future_id=request_id)
+        if nonblocking:
+            # TODO: Implement non-blocking fetch logic... let's ensure it's worth the effort.
+            raise NotImplementedError("Non-blocking fetch not implemented yet...")
+        return {
+            "request_id": request_id,
+            "output_requested_at": output_requested_at,
+            "output_delivered_at": datetime_utcnow().isoformat(),
+            "output": future.wait_and_resolve(timeout=timeout),
+        }
+
 
 @dataclass(frozen=True, slots=False)
 class RunnerRouter(RouterInterface.with_backend(), RunnerRouterMethods):
@@ -123,3 +140,11 @@ class RunnerRouter(RouterInterface.with_backend(), RunnerRouterMethods):
             summary="Execute a task by dispatching a request to the specified queue.",
             response_description="Details about the dispatched request.",
         )
+        self.router.add_api_route(
+            "/output/{request_id}",
+            self.runner_output,
+            methods=["GET"],
+            tags=["Runner"],
+            summary="Fetch the output of a previously dispatched request.",
+            response_description="The output of the request.",
+        )

{fred_oss-0.46.0 → fred_oss-0.48.0/src/main/fred_oss.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-oss
-Version: 0.46.0
+Version: 0.48.0
 Summary: FREDOSS
 Home-page: https://fred.fahera.mx
 Author: Fahera Research, Education, and Development
@@ -14,6 +14,7 @@ Requires-Dist: redis==6.4.0
 Requires-Dist: requests==2.32.5
 Requires-Dist: fastapi==0.116.2
 Requires-Dist: uvicorn[standard]==0.35.0
+Requires-Dist: pillow==11.3.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: description

{fred_oss-0.46.0 → fred_oss-0.48.0}/src/main/fred_oss.egg-info/SOURCES.txt

@@ -50,6 +50,7 @@ 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/imops.py
 src/main/fred/utils/runtime.py
 src/main/fred/worker/__init__.py
 src/main/fred/worker/interface.py

{fred_oss-0.46.0 → fred_oss-0.48.0}/src/main/fred_oss.egg-info/requires.txt

@@ -4,3 +4,4 @@ redis==6.4.0
 requests==2.32.5
 fastapi==0.116.2
 uvicorn[standard]==0.35.0
+pillow==11.3.0

fred_oss-0.46.0/src/main/fred/version

@@ -1 +0,0 @@
-0.46.0