ai-lib-python 0.8.2__py3-none-any.whl → 0.8.6__py3-none-any.whl

ai_lib_python/__init__.py

@@ -1,62 +1,62 @@
-"""AI-Protocol 官方 Python 运行时：提供统一的多厂商 AI 模型交互接口。
-
-ai-lib-python: Official Python Runtime for AI-Protocol.
-
-The canonical Pythonic implementation for unified AI model interaction.
-Core principle: All logic is operators, all configuration is protocol.
-"""
-from __future__ import annotations
-
-from ai_lib_python._features import (
-    HAS_AUDIO,
-    HAS_KEYRING,
-    HAS_TELEMETRY,
-    HAS_TOKENIZER,
-    HAS_VISION,
-    HAS_WATCHDOG,
-    require_extra,
-)
-from ai_lib_python.client import AiClient, AiClientBuilder, CallStats, ChatResponse
-from ai_lib_python.errors import AiLibError, ProtocolError, TransportError
-from ai_lib_python.types.events import StreamingEvent
-from ai_lib_python.types.message import (
-    ContentBlock,
-    Message,
-    MessageContent,
-    MessageRole,
-)
-from ai_lib_python.types.tool import ToolCall, ToolDefinition
-
-__version__ = "0.7.5"
-
-__all__ = [
-    # Client
-    "AiClient",
-    "AiClientBuilder",
-    # Feature flags
-    "HAS_AUDIO",
-    "HAS_KEYRING",
-    "HAS_TELEMETRY",
-    "HAS_TOKENIZER",
-    "HAS_VISION",
-    "HAS_WATCHDOG",
-    "require_extra",
-    # Errors
-    "AiLibError",
-    "CallStats",
-    "ChatResponse",
-    "ContentBlock",
-    # Types - Message
-    "Message",
-    "MessageContent",
-    "MessageRole",
-    "ProtocolError",
-    # Types - Events
-    "StreamingEvent",
-    "ToolCall",
-    # Types - Tool
-    "ToolDefinition",
-    "TransportError",
-    # Version
-    "__version__",
-]
+"""AI-Protocol 官方 Python 运行时：提供统一的多厂商 AI 模型交互接口。
+
+ai-lib-python: Official Python Runtime for AI-Protocol.
+
+The canonical Pythonic implementation for unified AI model interaction.
+Core principle: All logic is operators, all configuration is protocol.
+"""
+
+from __future__ import annotations
+
+from ai_lib_python._features import (
+    HAS_AUDIO,
+    HAS_KEYRING,
+    HAS_TELEMETRY,
+    HAS_TOKENIZER,
+    HAS_VISION,
+    HAS_WATCHDOG,
+    require_extra,
+)
+from ai_lib_python._version import __version__
+from ai_lib_python.client import AiClient, AiClientBuilder, CallStats, ChatResponse
+from ai_lib_python.errors import AiLibError, ProtocolError, TransportError
+from ai_lib_python.types.events import StreamingEvent
+from ai_lib_python.types.message import (
+    ContentBlock,
+    Message,
+    MessageContent,
+    MessageRole,
+)
+from ai_lib_python.types.tool import ToolCall, ToolDefinition
+
+__all__ = [
+    # Client
+    "AiClient",
+    "AiClientBuilder",
+    # Feature flags
+    "HAS_AUDIO",
+    "HAS_KEYRING",
+    "HAS_TELEMETRY",
+    "HAS_TOKENIZER",
+    "HAS_VISION",
+    "HAS_WATCHDOG",
+    "require_extra",
+    # Errors
+    "AiLibError",
+    "CallStats",
+    "ChatResponse",
+    "ContentBlock",
+    # Types - Message
+    "Message",
+    "MessageContent",
+    "MessageRole",
+    "ProtocolError",
+    # Types - Events
+    "StreamingEvent",
+    "ToolCall",
+    # Types - Tool
+    "ToolDefinition",
+    "TransportError",
+    # Version
+    "__version__",
+]

ai_lib_python/_features.py

@@ -1,51 +1,52 @@
-"""运行时特性检测：检查可选依赖以确定可用的能力模块。
-
-Runtime feature detection for optional extras.
-
-Checks availability of optional dependencies to determine which
-capability modules can be used.
-"""
-from __future__ import annotations
-
-
-def _check_import(module_name: str) -> bool:
-    """Check if a module is importable."""
-    try:
-        __import__(module_name)
-        return True
-    except ImportError:
-        return False
-
-
-# Capability feature flags
-HAS_VISION: bool = _check_import("PIL")
-HAS_AUDIO: bool = _check_import("soundfile")
-HAS_TELEMETRY: bool = _check_import("opentelemetry")
-HAS_TOKENIZER: bool = _check_import("tiktoken")
-HAS_KEYRING: bool = _check_import("keyring")
-HAS_WATCHDOG: bool = _check_import("watchdog")
-
-
-# Map pip package names to import module names (when they differ)
-_PACKAGE_TO_MODULE: dict[str, str] = {
-    "pillow": "PIL",
-}
-
-
-def require_extra(extra_name: str, package_name: str) -> None:
-    """Raise ImportError with installation hint if extra is not available.
-
-    Args:
-        extra_name: Name of the pip extra (e.g., 'vision')
-        package_name: Name of the required package (e.g., 'pillow')
-
-    Raises:
-        ImportError: With installation instructions when package is not available.
-    """
-    module_name = _PACKAGE_TO_MODULE.get(package_name, package_name)
-    if _check_import(module_name):
-        return
-    raise ImportError(
-        f"The '{extra_name}' extra is required for this feature. "
-        f"Install it with: pip install ai-lib-python[{extra_name}]"
-    )
+"""运行时特性检测：检查可选依赖以确定可用的能力模块。
+
+Runtime feature detection for optional extras.
+
+Checks availability of optional dependencies to determine which
+capability modules can be used.
+"""
+
+from __future__ import annotations
+
+
+def _check_import(module_name: str) -> bool:
+    """Check if a module is importable."""
+    try:
+        __import__(module_name)
+        return True
+    except ImportError:
+        return False
+
+
+# Capability feature flags
+HAS_VISION: bool = _check_import("PIL")
+HAS_AUDIO: bool = _check_import("soundfile")
+HAS_TELEMETRY: bool = _check_import("opentelemetry")
+HAS_TOKENIZER: bool = _check_import("tiktoken")
+HAS_KEYRING: bool = _check_import("keyring")
+HAS_WATCHDOG: bool = _check_import("watchdog")
+
+
+# Map pip package names to import module names (when they differ)
+_PACKAGE_TO_MODULE: dict[str, str] = {
+    "pillow": "PIL",
+}
+
+
+def require_extra(extra_name: str, package_name: str) -> None:
+    """Raise ImportError with installation hint if extra is not available.
+
+    Args:
+        extra_name: Name of the pip extra (e.g., 'vision')
+        package_name: Name of the required package (e.g., 'pillow')
+
+    Raises:
+        ImportError: With installation instructions when package is not available.
+    """
+    module_name = _PACKAGE_TO_MODULE.get(package_name, package_name)
+    if _check_import(module_name):
+        return
+    raise ImportError(
+        f"The '{extra_name}' extra is required for this feature. "
+        f"Install it with: pip install ai-lib-python[{extra_name}]"
+    )

ai_lib_python/_version.py

@@ -0,0 +1,13 @@
+"""Package version — single source via installed distribution metadata."""
+
+from __future__ import annotations
+
+try:
+    from importlib.metadata import PackageNotFoundError, version
+
+    try:
+        __version__ = version("ai-lib-python")
+    except PackageNotFoundError:
+        __version__ = "0.8.6"
+except ImportError:  # pragma: no cover - Python < 3.8 guard
+    __version__ = "0.8.6"

ai_lib_python/batch/__init__.py

@@ -1,15 +1,15 @@
-"""
-Batch processing module for ai-lib-python.
-
-Provides request batching and batch execution utilities.
-"""
-
-from ai_lib_python.batch.collector import BatchCollector, BatchConfig
-from ai_lib_python.batch.executor import BatchExecutor, BatchResult
-
-__all__ = [
-    "BatchCollector",
-    "BatchConfig",
-    "BatchExecutor",
-    "BatchResult",
-]
+"""
+Batch processing module for ai-lib-python.
+
+Provides request batching and batch execution utilities.
+"""
+
+from ai_lib_python.batch.collector import BatchCollector, BatchConfig
+from ai_lib_python.batch.executor import BatchExecutor, BatchResult
+
+__all__ = [
+    "BatchCollector",
+    "BatchConfig",
+    "BatchExecutor",
+    "BatchResult",
+]