synapsai-python 0.1.0__py3-none-any.whl

synapsai/logging.py

@@ -0,0 +1,70 @@
+# Copyright 2026 SynapsAI Technologies Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+LOGGER_NAME = "synapsai"
+logging.getLogger(LOGGER_NAME).addHandler(logging.NullHandler())
+
+
+def get_logger(name: Optional[str] = None) -> logging.Logger:
+    """
+    Return a logger within the synapsai namespace.
+
+    Example:
+        logger = get_logger(__name__)
+    """
+    if not name:
+        return logging.getLogger(LOGGER_NAME)
+
+    # Ensure everything stays under synapsai.*
+    if name.startswith(LOGGER_NAME):
+        return logging.getLogger(name)
+
+    return logging.getLogger(f"{LOGGER_NAME}.{name}")
+
+
+def enable_debug_logging(level: int = logging.DEBUG) -> None:
+    """
+    Convenience function for developers who want quick SDK logging.
+
+    This adds a simple StreamHandler to the synapsai logger only.
+    It does NOT modify global logging configuration.
+
+    Example:
+        import synapsai
+        from synapsai.logging import enable_debug_logging
+
+        enable_debug_logging()
+    """
+
+    logger = logging.getLogger(LOGGER_NAME)
+
+    # Avoid adding duplicate handlers
+    if any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
+        logger.setLevel(level)
+        return
+
+    handler = logging.StreamHandler()
+    formatter = logging.Formatter(
+        fmt="%(asctime)s | %(levelname)s | %(name)s | %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+    handler.setFormatter(formatter)
+
+    logger.addHandler(handler)
+    logger.setLevel(level)

synapsai/processing.py

@@ -0,0 +1,100 @@
+from PIL import Image
+import base64
+import os
+import io
+
+def process_image_input(image):
+    """Process image input (file path, bytes, base64, URL, or lists of those)"""
+
+    if image is None:
+        return None
+
+    # Handle batched inputs
+    if isinstance(image, list):
+        return [process_image_input(img) for img in image]
+
+    # Single input handling
+    if isinstance(image, str):
+        # URL
+        if image.startswith(("http://", "https://")):
+            return image
+
+        # File path
+        if os.path.isfile(image):
+            try:
+                with open(image, "rb") as f:
+                    image_bytes = f.read()
+            except FileNotFoundError:
+                raise ValueError("File not found")
+            return "data:image/jpeg;base64," + base64.b64encode(image_bytes).decode("utf-8")
+
+        # Assume base64
+        return image
+
+    if isinstance(image, bytes):
+        return "data:image/jpeg;base64," + base64.b64encode(image).decode("utf-8")
+
+    if isinstance(image, Image.Image):
+        buf = io.BytesIO()
+        fmt = image.format or "PNG"
+        image.save(buf, format=fmt)
+        mime = "image/png" if fmt == "PNG" else "image/jpeg"
+        return f"data:{mime};base64," + base64.b64encode(buf.getvalue()).decode()
+
+    raise ValueError(
+        "Image must be a file path, bytes, PIL.Image, URL, base64 string, or a list of these"
+    )
+
+def process_audio_input(file):
+    """Process audio file input"""
+    if file is None:
+        return None
+
+    # Handle batched inputs
+    if isinstance(file, list):
+        return [process_audio_input(f) for f in file]
+
+    if isinstance(file, str):
+        # Check if it's a file path
+        if os.path.isfile(file):
+            try:
+                with open(file, "rb") as f:
+                    audio_bytes = f.read()
+            except FileNotFoundError:
+                raise ValueError("File not found")
+            return "data:audio/wav;base64," + base64.b64encode(audio_bytes).decode("utf-8")
+        # Assume it's already base64 or URL
+        return file
+    elif isinstance(file, bytes):
+        return "data:audio/wav;base64," + base64.b64encode(file).decode("utf-8")
+    elif isinstance(file, io.IOBase):
+        return "data:audio/wav;base64," + base64.b64encode(file.read()).decode("utf-8")
+    else:
+        raise ValueError("File must be a file path, bytes, or base64 string")
+
+def process_video_input(file):
+    """Process video file input"""
+    if file is None:
+        return None
+
+    # Handle batched inputs
+    if isinstance(file, list):
+        return [process_video_input(f) for f in file]
+
+    if isinstance(file, str):
+        # Check if it's a file path
+        if os.path.isfile(file):
+            try:
+                with open(file, "rb") as f:
+                    video_bytes = f.read()
+            except FileNotFoundError:
+                raise ValueError("File not found")
+            return "data:video/mp4;base64," + base64.b64encode(video_bytes).decode("utf-8")
+        # Assume it's already base64 or URL
+        return file
+    elif isinstance(file, bytes):
+        return "data:video/mp4;base64," + base64.b64encode(file).decode("utf-8")
+    elif isinstance(file, io.IOBase):
+        return "data:video/mp4;base64," + base64.b64encode(file.read()).decode("utf-8")
+    else:
+        raise ValueError("File must be a file path, bytes, or base64 string")

synapsai/resources/__init__.py

@@ -0,0 +1,59 @@
+# Copyright 2026 SynapsAI Technologies Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Resource handlers for SynapsAI client library
+"""
+
+from .chat import ChatResource, AsyncChatResource
+from .images import ImagesResource, AsyncImagesResource
+from .videos import VideosResource, AsyncVideosResource
+from .embeddings import EmbeddingsResource, AsyncEmbeddingsResource
+from .audio import AudioResource, AsyncAudioResource, TranslationsResource, AsyncTranslationsResource
+from .completions import CompletionsResource, AsyncCompletionsResource
+from .classifications import ClassificationsResource, AsyncClassificationsResource
+from .question_answering import QuestionAnsweringResource, AsyncQuestionAnsweringResource
+from .models import ModelsResource, AsyncModelsResource
+from .feature_extraction import FeatureExtractionResource, AsyncFeatureExtractionResource
+from .fill_mask import FillMaskResource, AsyncFillMaskResource
+from .rerank import RerankResource, AsyncRerankResource
+
+__all__ = [
+    "ChatResource",
+    "AsyncChatResource",
+    "ImagesResource",
+    "AsyncImagesResource",
+    "VideosResource",
+    "AsyncVideosResource",
+    "EmbeddingsResource",
+    "AsyncEmbeddingsResource",
+    "AudioResource",
+    "AsyncAudioResource",
+    "TranslationsResource",
+    "AsyncTranslationsResource",
+    "CompletionsResource",
+    "AsyncCompletionsResource",
+    "ClassificationsResource",
+    "AsyncClassificationsResource",
+    "QuestionAnsweringResource",
+    "AsyncQuestionAnsweringResource",
+    "ModelsResource",
+    "AsyncModelsResource",
+    "FeatureExtractionResource",
+    "AsyncFeatureExtractionResource",
+    "FillMaskResource",
+    "AsyncFillMaskResource",
+    "RerankResource",
+    "AsyncRerankResource",
+]