openai-sdk-helpers 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

openai_sdk_helpers/logging_config.py

@@ -1,105 +1,34 @@
-"""Centralized logging configuration for openai-sdk-helpers.
-
-Provides a centralized factory for creating and configuring loggers
-with consistent formatting and handler management.
-"""
+"""Centralized logging configuration for openai-sdk-helpers."""
 
 import logging
-import threading
-from typing import Any
-
 
-class LoggerFactory:
-    """Centralized logger creation and configuration.
 
-    Manages logger initialization and configuration to ensure consistent
-    logging behavior across the entire SDK. Thread-safe.
+def log(
+    message: str,
+    level: int = logging.INFO,
+    *,
+    logger_name: str = "openai_sdk_helpers",
+) -> None:
+    """Log a message using Python's standard logging.
+
+    Parameters
+    ----------
+    message : str
+        The message to log.
+    level : int
+        Logging level (e.g., logging.DEBUG, logging.INFO).
+        Default is logging.INFO.
+    logger_name : str
+        Name of the logger. Default is "openai_sdk_helpers".
 
     Examples
     --------
-    Configure logging once at application startup:
-
-    >>> from openai_sdk_helpers.logging_config import LoggerFactory
-    >>> import logging
-    >>> LoggerFactory.configure(
-    ...     level=logging.DEBUG,
-    ...     handlers=[logging.StreamHandler()],
-    ... )
-
-    Get a logger instance in your module:
-
-    >>> logger = LoggerFactory.get_logger("openai_sdk_helpers.agent")
-    >>> logger.debug("Debug message")
+    >>> from openai_sdk_helpers.logging_config import log
+    >>> log("Operation completed")
+    >>> log("Debug info", level=logging.DEBUG)
     """
+    logger = logging.getLogger(logger_name)
+    logger.log(level, message)
 
-    _initialized = False
-    _log_level = logging.INFO
-    _handlers: list[logging.Handler] = []
-    _lock = threading.Lock()
-
-    @classmethod
-    def configure(
-        cls,
-        level: int = logging.INFO,
-        handlers: list[logging.Handler] | None = None,
-    ) -> None:
-        """Configure logging globally.
-
-        Parameters
-        ----------
-        level : int
-            Logging level (e.g., logging.DEBUG, logging.INFO).
-            Default is logging.INFO.
-        handlers : list[logging.Handler] | None
-            List of logging handlers. If None, a default
-            StreamHandler is created. Default is None.
-
-        Notes
-        -----
-        This method is thread-safe and can be called multiple times.
-        """
-        with cls._lock:
-            cls._log_level = level
-            if handlers:
-                cls._handlers = handlers
-            else:
-                handler = logging.StreamHandler()
-                handler.setLevel(level)
-                formatter = logging.Formatter(
-                    "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-                )
-                handler.setFormatter(formatter)
-                cls._handlers = [handler]
-            cls._initialized = True
-
-    @classmethod
-    def get_logger(cls, name: str) -> logging.Logger:
-        """Get configured logger instance.
-
-        Parameters
-        ----------
-        name : str
-            Logger name, typically __name__ of calling module.
-
-        Returns
-        -------
-        logging.Logger
-            Configured logger instance.
-        """
-        logger = logging.getLogger(name)
-
-        # Skip configuration if already configured
-        if logger.handlers:
-            return logger
-
-        with cls._lock:
-            if not cls._initialized:
-                cls.configure()
-
-            for handler in cls._handlers:
-                logger.addHandler(handler)
-
-            logger.setLevel(cls._log_level)
-            logger.propagate = False
 
-        return logger
+__all__ = ["log"]

openai_sdk_helpers/prompt/base.py

@@ -176,7 +176,7 @@ class PromptRenderer:
         ...     context={"key": "value"}
         ... )
         """
-        from openai_sdk_helpers.validation import validate_safe_path
+        from openai_sdk_helpers.utils.validation import validate_safe_path
 
         path = Path(template_path)
         if path.is_absolute():

openai_sdk_helpers/response/__init__.py

@@ -1,9 +1,9 @@
 """Response handling for OpenAI API interactions.
 
 This module provides comprehensive support for managing OpenAI API responses,
-including message handling, tool execution, vector store attachments, and
-structured output parsing. It serves as the foundation for building
-sophisticated AI agents with persistent conversation state.
+including message handling, tool execution, vector store attachments, file
+processing, and structured output parsing. It serves as the foundation for
+building sophisticated AI agents with persistent conversation state.
 
 Classes
 -------
@@ -28,12 +28,15 @@ run_streamed
     Execute a response workflow and return the asynchronous result.
 attach_vector_store
     Attach vector stores to a response's file_search tool.
+process_files
+    Process file attachments with automatic type detection.
 """
 
 from __future__ import annotations
 
 from .base import BaseResponse
 from .config import ResponseConfiguration, ResponseRegistry, get_default_registry
+from .files import process_files
 from .messages import ResponseMessage, ResponseMessages
 from .runner import run_async, run_streamed, run_sync
 from .tool_call import ResponseToolCall, parse_tool_arguments
@@ -52,4 +55,5 @@ __all__ = [
     "ResponseToolCall",
     "parse_tool_arguments",
     "attach_vector_store",
+    "process_files",
 ]