fred-oss 0.47.0__tar.gz → 0.49.0__tar.gz

{fred_oss-0.47.0/src/main/fred_oss.egg-info → fred_oss-0.49.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-oss
-Version: 0.47.0
+Version: 0.49.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.47.0 → fred_oss-0.49.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.49.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.49.0/src/main/fred/utils/imout/_filesystem.py

@@ -0,0 +1,11 @@
+from fred.utils.imout.interface import ImageOutputInterface
+
+
+class OutputFilesystem(ImageOutputInterface):
+    """Filesystem output handler for images."""
+
+    def out(self, path: str) -> str:
+        from fred.utils.imops import save_image_to_path
+
+        save_image_to_path(image=self.image, path=path)
+        return path

fred_oss-0.49.0/src/main/fred/utils/imout/_string.py

@@ -0,0 +1,10 @@
+from fred.utils.imout.interface import ImageOutputInterface
+
+
+class OutputString(ImageOutputInterface):
+    """String output handler for images."""
+
+    def out(self) -> str:
+        from fred.utils.imops import image_to_b64
+
+        return image_to_b64(self.image)

fred_oss-0.49.0/src/main/fred/utils/imout/catalog.py

@@ -0,0 +1,18 @@
+import enum
+
+from PIL.Image import Image
+
+from fred.utils.imout.interface import ImageOutputInterface
+from fred.utils.imout._filesystem import OutputFilesystem
+from fred.utils.imout._string import OutputString
+
+
+class ImageOutputCatalog(enum.Enum):
+    B64 = OutputString
+    STRING = OutputString
+    FILESYSTEM = OutputFilesystem 
+
+    def __call__(self, image: Image, **kwargs) -> ImageOutputInterface:
+        if getattr(self.value, "auto", None):
+            return self.value.auto(image=image, **kwargs)
+        return self.value(image=image, **kwargs)

fred_oss-0.49.0/src/main/fred/utils/imout/interface.py

@@ -0,0 +1,37 @@
+from dataclasses import dataclass
+from typing import Any, Optional
+
+from PIL.Image import Image
+
+
+class ImageOutputBackendInterface:
+    metadata: dict = {}
+    client: Optional[Any] = None  # Placeholder for clients like MinIO, S3, etc.
+
+    @classmethod
+    def set_shared_client(cls, client: Any) -> None:
+        cls.client = client
+
+
+@dataclass(frozen=True, slots=True)
+class ImageOutputInterface(ImageOutputBackendInterface):
+    """Interface for image output handling."""
+    image: Image
+
+    @classmethod
+    def from_path(cls, path: str) -> "ImageOutputInterface":
+        from fred.utils.imops import get_image_from_path
+
+        image = get_image_from_path(path=path)
+        return cls(image=image)
+
+    def save(self, path: str, format: str = "PNG"):
+        """Save the image to a file."""
+        self.image.save(path, format=format)
+
+    def show(self):
+        """Display the image."""
+        self.image.show()
+
+    def out(self, **kwargs) -> str:
+        raise NotImplementedError("Subclasses must implement out method.")

fred_oss-0.49.0/src/main/fred/version

@@ -0,0 +1 @@
+0.49.0

{fred_oss-0.47.0 → fred_oss-0.49.0/src/main/fred_oss.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-oss
-Version: 0.47.0
+Version: 0.49.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.47.0 → fred_oss-0.49.0}/src/main/fred_oss.egg-info/SOURCES.txt

@@ -50,7 +50,13 @@ 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/utils/imout/__init__.py
+src/main/fred/utils/imout/_filesystem.py
+src/main/fred/utils/imout/_string.py
+src/main/fred/utils/imout/catalog.py
+src/main/fred/utils/imout/interface.py
 src/main/fred/worker/__init__.py
 src/main/fred/worker/interface.py
 src/main/fred/worker/settings.py

{fred_oss-0.47.0 → fred_oss-0.49.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.47.0/src/main/fred/version

@@ -1 +0,0 @@
-0.47.0