nexaai 1.0.16rc11__cp310-cp310-macosx_14_0_universal2.whl → 1.0.16rc12__cp310-cp310-macosx_14_0_universal2.whl

nexaai/__init__.py

@@ -21,6 +21,9 @@ except ImportError:
 # Import common configuration classes first (no external dependencies)
 from .common import ModelConfig, GenerationConfig, ChatMessage, SamplerConfig, PluginID
 
+# Import logging functionality
+from .log import set_logger, get_error_message
+
 # Create alias for PluginID to be accessible as plugin_id
 plugin_id = PluginID
 
@@ -45,6 +48,10 @@ __all__ = [
     "EmbeddingConfig",
     "PluginID",
     "plugin_id",
+    
+    # Logging functionality
+    "set_logger",
+    "get_error_message",
 
     "LLM",
     "Embedder",

nexaai/_version.py

@@ -1,4 +1,4 @@
 # This file is generated by CMake from _version.py.in
 # Do not modify this file manually - it will be overwritten
 
-__version__ = "1.0.16-rc11" 
+__version__ = "1.0.16-rc12" 

nexaai/log.py

@@ -0,0 +1,92 @@
+"""
+Logging configuration for NexaAI bridge.
+
+This module provides a minimal API to configure bridge-wide logging
+to route into Python's logging system.
+"""
+
+import logging
+import threading
+from enum import IntEnum
+from typing import Optional
+
+from nexaai.binds import common_bind
+from nexaai.runtime import is_initialized
+
+
+class LogLevel(IntEnum):
+    """Log levels matching ml_LogLevel from ml.h"""
+    TRACE = 0
+    DEBUG = 1
+    INFO = 2
+    WARN = 3
+    ERROR = 4
+
+
+# Module-level state
+_config_lock = threading.Lock()
+_current_logger: Optional[logging.Logger] = None
+
+
+def set_logger(logger: Optional[logging.Logger] = None, *, strict: bool = True) -> None:
+    """
+    Set the process-wide bridge logger.
+    
+    Args:
+        logger: Python logger to receive bridge logs. If None, uses "nexaai.ml" logger.
+        strict: If True, raises if called after runtime initialization.
+                If False, attempts to set anyway (best-effort).
+    
+    Raises:
+        RuntimeError: If strict=True and runtime is already initialized.
+    """
+    global _current_logger
+    
+    with _config_lock:
+        # Check initialization state if strict mode
+        if strict and is_initialized():
+            raise RuntimeError(
+                "Cannot configure logging after runtime initialization. "
+                "Call set_logger() before creating any models, or use strict=False for best-effort."
+            )
+        
+        # Use default logger if none provided
+        if logger is None:
+            logger = logging.getLogger("nexaai.ml")
+        
+        _current_logger = logger
+        
+        # Set the C callback
+        common_bind.ml_set_log(_log_callback)
+
+
+def _log_callback(level: int, message: str) -> None:
+    """Internal callback that forwards bridge logs to Python logger."""
+    if _current_logger is None:
+        return
+    
+    # Map bridge log levels to Python logging levels
+    if level == LogLevel.TRACE or level == LogLevel.DEBUG:
+        _current_logger.debug(message)
+    elif level == LogLevel.INFO:
+        _current_logger.info(message)
+    elif level == LogLevel.WARN:
+        _current_logger.warning(message)
+    elif level == LogLevel.ERROR:
+        _current_logger.error(message)
+    else:
+        # Fallback for unknown levels
+        _current_logger.info(f"[Level {level}] {message}")
+
+
+def get_error_message(error_code: int) -> str:
+    """
+    Get error message string for error code.
+    
+    Args:
+        error_code: ML error code (typically negative)
+        
+    Returns:
+        Human-readable error message
+    """
+    return common_bind.ml_get_error_message(error_code)

nexaai/runtime.py

@@ -28,6 +28,10 @@ def _shutdown_runtime() -> None:
 # Public helper so advanced users can reclaim memory on demand
 shutdown = _shutdown_runtime
 
+def is_initialized() -> bool:
+    """Check if the runtime has been initialized."""
+    return _runtime_alive
+
 # ----------------------------------------------------------------------
 # Single public class
 # ----------------------------------------------------------------------

{nexaai-1.0.16rc11.dist-info → nexaai-1.0.16rc12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexaai
-Version: 1.0.16rc11
+Version: 1.0.16rc12
 Summary: Python bindings for NexaSDK C-lib backend
 Author-email: "Nexa AI, Inc." <dev@nexa.ai>
 Project-URL: Homepage, https://github.com/NexaAI/nexasdk-bridge

{nexaai-1.0.16rc11.dist-info → nexaai-1.0.16rc12.dist-info}/RECORD

@@ -1,6 +1,6 @@
-nexaai/__init__.py,sha256=jXdC4vv6DBK1fVewYTYSUhOOYfvf_Mk81UIeMGGIKUg,2029
-nexaai/_stub.cpython-310-darwin.so,sha256=6-Cum2FTCp9SJUfkSFZji8GUnxR_835-V6_VYrU3lmw,66768
-nexaai/_version.py,sha256=f7rjwo4Z-jPnRW2BO8DA1Z8FCkrghe6e-uQJVLsIGLE,144
+nexaai/__init__.py,sha256=L8oB7GFZZMGnUpCg0PecDbI_ycKuQak-ZEJ4Y12_QIw,2184
+nexaai/_stub.cpython-310-darwin.so,sha256=bzuFvUH92pOTqDVeEN9Y9ULBe5iQhE5RUgzD_MRDrtE,66768
+nexaai/_version.py,sha256=VcEloSyZAF14s_ZLUSzu8vLdcbhwdSK1deBNqQktuqA,144
 nexaai/asr.py,sha256=NljMXDErwPNMOPaRkJZMEDka9Nk8xyur7L8i924TStY,2054
 nexaai/base.py,sha256=N8PRgDFA-XPku2vWnQIofQ7ipz3pPlO6f8YZGnuhquE,982
 nexaai/common.py,sha256=yBnIbqYaQYnfrl7IczOBh6MDibYZVxwaRJEglYcKgGs,3422
@@ -8,18 +8,19 @@ nexaai/cv.py,sha256=RHCDo8gvBH8BkGZx7qVyp-OKxqi7E1GG9XzyaXehCNA,3273
 nexaai/embedder.py,sha256=Cw0tSHkPgd-RI62afCqQAcTHMnQhaI2CvfTMO-1JKOg,2452
 nexaai/image_gen.py,sha256=0C_5Tjj4BYmxLbmMmvwajp-yy2mmEEOKwBFnDQNPzx4,4356
 nexaai/llm.py,sha256=S1o_k2VQoF5w2wO25f142OO1R75TP89Ii69VZv8pIGo,3567
+nexaai/log.py,sha256=Kwo2CIfWN6iP4M4F5EUIV8KIO5hAsvz6HZAaOwJ27Og,2628
 nexaai/rerank.py,sha256=vWaBucoQ1wz-2iYnZqyFIcEjm-4Xcs1KDbFN5X8zzDQ,1872
-nexaai/runtime.py,sha256=mxxHYsb5iBUAm2K_u-XJWr_U-spJ9S4eApc8kf9myjw,1957
+nexaai/runtime.py,sha256=JvllhlNPgYGLbgGyX2yNvmGzT0lZ5XbvTvEo8sZG_Ho,2067
 nexaai/tts.py,sha256=ZnBpWUxIfHhh7KfEjddtH7hHOTa91zg7ogGLakMIALo,2167
 nexaai/vlm.py,sha256=OCxwML-Z5uVGp3fjzJVtbCxfTLpgxkhQ8Wo6MVysoiw,4733
 nexaai/asr_impl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nexaai/asr_impl/mlx_asr_impl.py,sha256=eosd8-TIWAOwV0HltmoFrLwzXHcU4jyxtncvuZE9pgA,3257
 nexaai/asr_impl/pybind_asr_impl.py,sha256=pE9Hb_hMi5yAc4MF83bLVOb8zDtreCkB3_u7XED9YpA,1516
 nexaai/binds/__init__.py,sha256=eYuay_8DDXeOUWz2_R9HFSabohxs6hvZn391t2L0Po0,104
-nexaai/binds/common_bind.cpython-310-darwin.so,sha256=hVxY76tn7hN6uHDIgM7LWNvgoudHgNZVoaygM9X1RWE,217232
+nexaai/binds/common_bind.cpython-310-darwin.so,sha256=ya8gz7NnUtHlniGnRyExdwWfdHimEHiJ7Dry4I7_y44,235264
 nexaai/binds/embedder_bind.cpython-310-darwin.so,sha256=tPa0c0Dv_GiW66fgmAGWGCHXRGNApznqoQS0eQx9GFM,202064
-nexaai/binds/libnexa_bridge.dylib,sha256=Tr5qwX_FgsEBf8xbqtvA1wEj6eChdQLBuzQOChMWydk,251144
-nexaai/binds/llm_bind.cpython-310-darwin.so,sha256=6vRO5eOsL6s-hCKdz6onIjBKR_wcpCIsXHtUJY9vJBI,182704
+nexaai/binds/libnexa_bridge.dylib,sha256=y0cv3WWCPmKVyZFSj81BM6-yhzUOfkZWvezu_kfztQc,251192
+nexaai/binds/llm_bind.cpython-310-darwin.so,sha256=TAWfa1Hzq00TjtC1xVsiAeLp6hv2LrL5afDz4omUghc,182784
 nexaai/binds/vlm_bind.cpython-310-darwin.so,sha256=nd6eG_m2EiPthzkSZ97hlXWUOZQir4cQfFJZ4p6eR2U,182704
 nexaai/binds/nexa_llama_cpp/libggml-base.dylib,sha256=JM4oOkie1su0ES5hMdtILeQHlRukRzH1vTleTupUXhg,650736
 nexaai/binds/nexa_llama_cpp/libggml-cpu.so,sha256=qiYxbTe4Nt7n36zJVvq3zovgSZEmrN2is6gzTern7UI,677728
@@ -27,7 +28,7 @@ nexaai/binds/nexa_llama_cpp/libggml-metal.so,sha256=zfaX7rIBYQazH2lf-vza007BMhPT
 nexaai/binds/nexa_llama_cpp/libggml.dylib,sha256=aOTj_6RrAMkfDO0ZI28_3nfcC-l4Y3dRCiS3C0d0_eI,58592
 nexaai/binds/nexa_llama_cpp/libllama.dylib,sha256=RkBd5usb8RvEIOamvxCW3UvMauI5bC66G_n6hw83NpY,1786128
 nexaai/binds/nexa_llama_cpp/libmtmd.dylib,sha256=o6mQqefzQNF0CS4j6odwJKj0gkXm15hIxwlNt88FOn4,605248
-nexaai/binds/nexa_llama_cpp/libnexa_plugin.dylib,sha256=4rTxwHGSVUfGnvA6laPpLztMMFooy-inG2798HXqKPY,1862104
+nexaai/binds/nexa_llama_cpp/libnexa_plugin.dylib,sha256=f-ctmVHSL5x1LKLr0StYM5WscvUW_5olJ7al3ciVmmQ,1863000
 nexaai/binds/nexa_mlx/libnexa_plugin.dylib,sha256=s4oelR1kkFrk0MKL23I0m9Uei4yPf48rzdNvknpjodg,623192
 nexaai/binds/nexa_mlx/py-lib/ml.py,sha256=DKXVOAfh8cg7KTKljh7jpcPwfQFNigc6uv_ZXF6lse8,23977
 nexaai/binds/nexa_mlx/py-lib/profiling.py,sha256=Dc-mybFwBdCIKFWL7CbSHjkOJGAoYHG7r_e_XPhzwBU,9361
@@ -540,7 +541,7 @@ nexaai/utils/quantization_utils.py,sha256=4gvp6UQfSO9G1FYBwnFtQspTzH9sDbi1PBXw2t
 nexaai/vlm_impl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nexaai/vlm_impl/mlx_vlm_impl.py,sha256=pLtWm_ckz8a0U-AtAOMVseFDO4OVPvHyYO2KlfBaGYk,10833
 nexaai/vlm_impl/pybind_vlm_impl.py,sha256=FAbhpRJzHgI78r0mUvKybO97R1szvNhH0aTn_I52oT4,8597
-nexaai-1.0.16rc11.dist-info/METADATA,sha256=ZBygPzSF5yfMU8SgBMTS8HmrlM4Rx_vAwQsoX8rZIks,1202
-nexaai-1.0.16rc11.dist-info/WHEEL,sha256=T2p57lol9__xkoU6aJTyN1Pm43ZpRU3q6km7mIbrAMs,114
-nexaai-1.0.16rc11.dist-info/top_level.txt,sha256=LRE2YERlrZk2vfuygnSzsEeqSknnZbz3Z1MHyNmBU4w,7
-nexaai-1.0.16rc11.dist-info/RECORD,,
+nexaai-1.0.16rc12.dist-info/METADATA,sha256=a6Oh67bHm9t2m1j9yPHyou4gx0YOJjag7YLhJYyjRxc,1202
+nexaai-1.0.16rc12.dist-info/WHEEL,sha256=T2p57lol9__xkoU6aJTyN1Pm43ZpRU3q6km7mIbrAMs,114
+nexaai-1.0.16rc12.dist-info/top_level.txt,sha256=LRE2YERlrZk2vfuygnSzsEeqSknnZbz3Z1MHyNmBU4w,7
+nexaai-1.0.16rc12.dist-info/RECORD,,