ErisPulse 2.3.3.dev0__py3-none-any.whl → 2.3.4.dev2__py3-none-any.whl

ErisPulse/__init__.pyi

@@ -0,0 +1,22 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 主模块
+
+提供SDK核心功能模块加载和初始化功能
+
+{!--< tips >!--}
+1. 使用前请确保已正确安装所有依赖
+2. 调用await sdk.init()进行初始化
+3. 模块加载采用懒加载机制
+{!--< /tips >!--}
+"""
+
+import importlib.metadata
+from .Core import Event, lifecycle, logger, exceptions, storage, env, config, adapter, AdapterFather, BaseAdapter, SendDSL, module, router, adapter_server
+from .sdk import sdk
+from .loaders.module_loader import LazyModule

ErisPulse/__main__.py

@@ -3,7 +3,7 @@ ErisPulse SDK 命令行工具
 
 提供ErisPulse生态系统的包管理、模块控制和开发工具功能。
 """
-from .utils import CLI
+from .CLI import CLI
 
 def main():
     """

ErisPulse/__main__.pyi

@@ -0,0 +1,24 @@
+# type: ignore
+#
+# Auto-generated type stub for __main__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 命令行工具
+
+提供ErisPulse生态系统的包管理、模块控制和开发工具功能。
+"""
+
+from .CLI import CLI
+
+def main() -> ...:
+    """
+    CLI入口点
+    
+    {!--< tips >!--}
+    1. 创建CLI实例并运行
+    2. 处理全局异常
+    {!--< /tips >!--}
+    """
+    ...

ErisPulse/loaders/__init__.py

@@ -0,0 +1,22 @@
+"""
+ErisPulse 加载器模块
+
+提供适配器和模块的加载功能
+
+{!--< tips >!--}
+1. 此模块由 SDK 内部使用
+2. 一般不需要手动导入这些加载器
+{!--< /tips >!--}
+"""
+
+from .adapter_loader import AdapterLoader
+from .module_loader import ModuleLoader
+from .initializer import Initializer
+from .strategy import ModuleLoadStrategy
+
+__all__ = [
+    "AdapterLoader",
+    "ModuleLoader",
+    "Initializer",
+    "ModuleLoadStrategy",
+]

ErisPulse/loaders/__init__.pyi

@@ -0,0 +1,21 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 加载器模块
+
+提供适配器和模块的加载功能
+
+{!--< tips >!--}
+1. 此模块由 SDK 内部使用
+2. 一般不需要手动导入这些加载器
+{!--< /tips >!--}
+"""
+
+from .adapter_loader import AdapterLoader
+from .module_loader import ModuleLoader
+from .initializer import Initializer
+from .strategy import ModuleLoadStrategy

ErisPulse/loaders/adapter_loader.py

@@ -0,0 +1,187 @@
+"""
+ErisPulse 适配器加载器
+
+专门用于从 PyPI 包加载和初始化适配器
+
+{!--< tips >!--}
+1. 适配器必须通过 entry-points 机制注册到 erispulse.adapter 组
+2. 适配器类必须继承 BaseAdapter
+3. 适配器不适用懒加载
+{!--< /tips >!--}
+"""
+
+import sys
+import asyncio
+import importlib.metadata
+from typing import Dict, List, Any, Tuple
+from .base_loader import BaseLoader
+from ..Core.logger import logger
+from ..Core.lifecycle import lifecycle
+
+class AdapterLoader(BaseLoader):
+    """
+    适配器加载器
+    
+    负责从 PyPI entry-points 加载适配器
+    
+    {!--< tips >!--}
+    使用方式：
+    >>> loader = AdapterLoader()
+    >>> adapter_objs, enabled, disabled = await loader.load(adapter_manager)
+    {!--< /tips >!--}
+    """
+    
+    def __init__(self):
+        """初始化适配器加载器"""
+        super().__init__("ErisPulse.adapters")
+    
+    def _get_entry_point_group(self) -> str:
+        """
+        获取 entry-point 组名
+        
+        :return: "erispulse.adapter"
+        """
+        return "erispulse.adapter"
+    
+    async def _process_entry_point(
+        self,
+        entry_point: Any,
+        objs: Dict[str, Any],
+        enabled_list: List[str],
+        disabled_list: List[str],
+        manager_instance: Any
+    ) -> Tuple[Dict[str, Any], List[str], List[str]]:
+        """
+        处理单个适配器 entry-point
+        
+        :param entry_point: entry-point 对象
+        :param objs: 适配器对象字典
+        :param enabled_list: 启用的适配器列表
+        :param disabled_list: 停用的适配器列表
+        :param manager_instance: 适配器管理器实例
+        
+        :return: 
+            Dict[str, Any]: 更新后的适配器对象字典
+            List[str]: 更新后的启用适配器列表 
+            List[str]: 更新后的禁用适配器列表
+            
+        :raises ImportError: 当适配器加载失败时抛出
+        """
+        meta_name = entry_point.name
+        
+        # 检查适配器是否已经注册，如果未注册则进行注册（默认启用）
+        if not manager_instance.exists(meta_name):
+            manager_instance._config_register(meta_name, True)
+            logger.info(f"发现新适配器 {meta_name}，默认已启用")
+        
+        # 获取适配器当前状态
+        adapter_status = manager_instance.is_enabled(meta_name)
+        logger.debug(f"适配器 {meta_name} 状态: {adapter_status}")
+        
+        if not adapter_status:
+            disabled_list.append(meta_name)
+            logger.debug(f"适配器 {meta_name} 已禁用，跳过...")
+            return objs, enabled_list, disabled_list
+        
+        try:
+            loaded_class = entry_point.load()
+            adapter_obj = sys.modules[loaded_class.__module__]
+            dist = importlib.metadata.distribution(entry_point.dist.name)
+            
+            adapter_info = {
+                "meta": {
+                    "name": meta_name,
+                    "version": getattr(adapter_obj, "__version__", dist.version if dist else "1.0.0"),
+                    "description": getattr(adapter_obj, "__description__", ""),
+                    "author": getattr(adapter_obj, "__author__", ""),
+                    "license": getattr(adapter_obj, "__license__", ""),
+                    "package": entry_point.dist.name
+                },
+                "adapter_class": loaded_class
+            }
+            
+            if not hasattr(adapter_obj, 'adapterInfo'):
+                setattr(adapter_obj, 'adapterInfo', {})
+                
+            adapter_obj.adapterInfo[meta_name] = adapter_info
+                
+            objs[meta_name] = adapter_obj
+            enabled_list.append(meta_name)
+            logger.debug(f"从 PyPI 包发现适配器: {meta_name}")
+            
+        except Exception as e:
+            logger.warning(f"从 entry-point 加载适配器 {meta_name} 失败: {e}")
+            raise ImportError(f"无法加载适配器 {meta_name}: {e}")
+            
+        return objs, enabled_list, disabled_list
+    
+    async def register_to_manager(
+        self,
+        adapters: List[str],
+        adapter_objs: Dict[str, Any],
+        manager_instance: Any
+    ) -> bool:
+        """
+        将适配器注册到管理器
+        
+        :param adapters: 适配器名称列表
+        :param adapter_objs: 适配器对象字典
+        :param manager_instance: 适配器管理器实例
+        :return: 适配器注册是否成功
+        
+        {!--< tips >!--}
+        此方法由初始化协调器调用
+        {!--< /tips >!--}
+        """
+        # 并行注册所有适配器
+        register_tasks = []
+        
+        for adapter_name in adapters:
+            adapter_obj = adapter_objs[adapter_name]
+            
+            async def register_single_adapter(name: str, obj: Any) -> bool:
+                """注册单个适配器"""
+                try:
+                    success = True
+                    if hasattr(obj, "adapterInfo") and isinstance(obj.adapterInfo, dict):
+                        for platform, adapter_info in obj.adapterInfo.items():
+                            # 使用管理器的方法检查是否已存在
+                            if platform in manager_instance._adapters:
+                                continue
+                                
+                            adapter_class = adapter_info["adapter_class"]
+                            
+                            # 调用管理器的 register 方法
+                            manager_instance.register(platform, adapter_class, adapter_info)
+                            logger.info(f"注册适配器: {platform} ({adapter_class.__name__})")
+                            
+                            # 提交适配器加载完成事件
+                            await lifecycle.submit_event(
+                                "adapter.load",
+                                msg=f"适配器 {platform} 加载完成",
+                                data={
+                                    "platform": platform,
+                                    "success": True
+                                }
+                            )
+                    return success
+                except Exception as e:
+                    logger.error(f"适配器 {name} 注册失败: {e}")
+                    # 提交适配器加载失败事件
+                    await lifecycle.submit_event(
+                        "adapter.load",
+                        msg=f"适配器 {name} 加载失败: {e}",
+                        data={
+                            "platform": name,
+                            "success": False
+                        }
+                    )
+                    return False
+            
+            register_tasks.append(register_single_adapter(adapter_name, adapter_obj))
+        
+        # 等待所有注册任务完成
+        register_results = await asyncio.gather(*register_tasks, return_exceptions=True)
+        
+        # 检查是否有注册失败的情况
+        return not any(isinstance(result, Exception) or result is False for result in register_results)

ErisPulse/loaders/adapter_loader.pyi

@@ -0,0 +1,82 @@
+# type: ignore
+#
+# Auto-generated type stub for adapter_loader.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 适配器加载器
+
+专门用于从 PyPI 包加载和初始化适配器
+
+{!--< tips >!--}
+1. 适配器必须通过 entry-points 机制注册到 erispulse.adapter 组
+2. 适配器类必须继承 BaseAdapter
+3. 适配器不适用懒加载
+{!--< /tips >!--}
+"""
+
+import sys
+import asyncio
+import importlib.metadata
+from typing import Dict, List, Any, Tuple
+from .base_loader import BaseLoader
+from ..Core.logger import logger
+from ..Core.lifecycle import lifecycle
+
+class AdapterLoader(BaseLoader):
+    """
+    适配器加载器
+    
+    负责从 PyPI entry-points 加载适配器
+    
+    {!--< tips >!--}
+    使用方式：
+    >>> loader = AdapterLoader()
+    >>> adapter_objs, enabled, disabled = await loader.load(adapter_manager)
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化适配器加载器
+        """
+        ...
+    def _get_entry_point_group(self: object) -> str:
+        """
+        获取 entry-point 组名
+        
+        :return: "erispulse.adapter"
+        """
+        ...
+    async def _process_entry_point(self: object, entry_point: Any, objs: Dict[(str, Any)], enabled_list: List[str], disabled_list: List[str], manager_instance: Any) -> Tuple[(Dict[(str, Any)], List[str], List[str])]:
+        """
+        处理单个适配器 entry-point
+        
+        :param entry_point: entry-point 对象
+        :param objs: 适配器对象字典
+        :param enabled_list: 启用的适配器列表
+        :param disabled_list: 停用的适配器列表
+        :param manager_instance: 适配器管理器实例
+        
+        :return: 
+            Dict[str, Any]: 更新后的适配器对象字典
+            List[str]: 更新后的启用适配器列表 
+            List[str]: 更新后的禁用适配器列表
+            
+        :raises ImportError: 当适配器加载失败时抛出
+        """
+        ...
+    async def register_to_manager(self: object, adapters: List[str], adapter_objs: Dict[(str, Any)], manager_instance: Any) -> bool:
+        """
+        将适配器注册到管理器
+        
+        :param adapters: 适配器名称列表
+        :param adapter_objs: 适配器对象字典
+        :param manager_instance: 适配器管理器实例
+        :return: 适配器注册是否成功
+        
+        {!--< tips >!--}
+        此方法由初始化协调器调用
+        {!--< /tips >!--}
+        """
+        ...

ErisPulse/loaders/base_loader.py

@@ -0,0 +1,162 @@
+"""
+ErisPulse 基础加载器
+
+定义加载器的抽象基类，提供通用的加载器接口和结构
+
+{!--< tips >!--}
+1. 所有具体加载器应继承自 BaseLoader
+2. 子类需实现 _process_entry_point 方法
+3. 支持启用/禁用配置管理
+{!--< /tips >!--}
+"""
+
+import importlib.metadata
+from abc import ABC, abstractmethod
+from typing import Dict, List, Any, Type, Tuple
+from ..Core.logger import logger
+from ..Core.config import config
+
+class BaseLoader(ABC):
+    """
+    基础加载器抽象类
+    
+    提供通用的加载器接口和配置管理功能
+    
+    {!--< tips >!--}
+    子类需要实现：
+    - _get_entry_point_group: 返回 entry-point 组名
+    - _process_entry_point: 处理单个 entry-point
+    - _should_eager_load: 判断是否立即加载
+    {!--< /tips >!--}
+    
+    {!--< internal-use >!--}
+    此类仅供内部使用，不应直接实例化
+    {!--< /internal-use >!--}
+    """
+    
+    def __init__(self, config_prefix: str):
+        """
+        初始化基础加载器
+        
+        :param config_prefix: 配置前缀（如 "ErisPulse.adapters" 或 "ErisPulse.modules"）
+        """
+        self._config_prefix = config_prefix
+    
+    @abstractmethod
+    def _get_entry_point_group(self) -> str:
+        """
+        获取 entry-point 组名
+        
+        :return: entry-point 组名
+        
+        {!--< internal-use >!--}
+        子类必须实现此方法
+        {!--< /internal-use >!--}
+        """
+        pass
+    
+    @abstractmethod
+    async def _process_entry_point(
+        self,
+        entry_point: Any,
+        objs: Dict[str, Any],
+        enabled_list: List[str],
+        disabled_list: List[str],
+        manager_instance: Any
+    ) -> Tuple[Dict[str, Any], List[str], List[str]]:
+        """
+        处理单个 entry-point
+        
+        :param entry_point: entry-point 对象
+        :param objs: 对象字典
+        :param enabled_list: 启用列表
+        :param disabled_list: 禁用列表
+        :param manager_instance: 管理器实例（用于调用 exists/is_enabled 等方法）
+        :return: (更新后的对象字典, 更新后的启用列表, 更新后的禁用列表)
+        
+        {!--< internal-use >!--}
+        子类必须实现此方法
+        {!--< /internal-use >!--}
+        """
+        pass
+    
+    async def load(self, manager_instance: Any) -> Tuple[Dict[str, Any], List[str], List[str]]:
+        """
+        从 entry-points 加载对象
+        
+        :param manager_instance: 管理器实例
+        :return: 
+            Dict[str, Any]: 对象字典
+            List[str]: 启用列表
+            List[str]: 禁用列表
+            
+        :raises ImportError: 当加载失败时抛出
+        """
+        objs: Dict[str, Any] = {}
+        enabled_list: List[str] = []
+        disabled_list: List[str] = []
+        
+        group_name = self._get_entry_point_group()
+        logger.info(f"正在加载 {group_name} entry-points...")
+        
+        try:
+            # 加载 entry-points
+            entry_points = importlib.metadata.entry_points()
+            if hasattr(entry_points, 'select'):
+                entries = entry_points.select(group=group_name)
+            else:
+                entries = entry_points.get(group_name, [])  # type: ignore[attr-defined]
+            
+            # 处理每个 entry-point
+            for entry_point in entries:
+                objs, enabled_list, disabled_list = await self._process_entry_point(
+                    entry_point, objs, enabled_list, disabled_list, manager_instance
+                )
+            
+            logger.info(f"{group_name} 加载完成")
+            
+        except Exception as e:
+            logger.error(f"加载 {group_name} entry-points 失败: {e}")
+            raise ImportError(f"无法加载 {group_name}: {e}")
+        
+        return objs, enabled_list, disabled_list
+    
+    def _register_config(self, name: str, enabled: bool = False) -> bool:
+        """
+        注册配置项
+        
+        :param name: 名称
+        :param enabled: 是否启用
+        :return: 操作是否成功
+        
+        {!--< internal-use >!--}
+        内部方法，用于注册新的配置项
+        {!--< /internal-use >!--}
+        """
+        config_key = f"{self._config_prefix}.status.{name}"
+        config.setConfig(config_key, enabled)
+        status = "启用" if enabled else "禁用"
+        logger.info(f"{self._config_prefix} {name} 已注册并{status}")
+        return True
+    
+    def _get_config_status(self, name: str) -> bool:
+        """
+        获取配置状态
+        
+        :param name: 名称
+        :return: 是否启用
+        
+        {!--< internal-use >!--}
+        内部方法，用于获取配置状态
+        {!--< /internal-use >!--}
+        """
+        config_key = f"{self._config_prefix}.status.{name}"
+        status = config.getConfig(config_key)
+        
+        if status is None:
+            return False
+        
+        if isinstance(status, str):
+            return status.lower() not in ('false', '0', 'no', 'off')
+        
+        return bool(status)

ErisPulse/loaders/base_loader.pyi

@@ -0,0 +1,23 @@
+# type: ignore
+#
+# Auto-generated type stub for base_loader.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 基础加载器
+
+定义加载器的抽象基类，提供通用的加载器接口和结构
+
+{!--< tips >!--}
+1. 所有具体加载器应继承自 BaseLoader
+2. 子类需实现 _process_entry_point 方法
+3. 支持启用/禁用配置管理
+{!--< /tips >!--}
+"""
+
+import importlib.metadata
+from abc import ABC, abstractmethod
+from typing import Dict, List, Any, Type, Tuple
+from ..Core.logger import logger
+from ..Core.config import config