ErisPulse 2.3.4.dev2__py3-none-any.whl → 2.3.4.dev114514__py3-none-any.whl

ErisPulse/Core/Bases/manager.py

@@ -1,136 +0,0 @@
-"""
-ErisPulse 管理器基类
-
-提供适配器和模块管理器的统一接口定义
-
-{!--< tips >!--}
-适配器管理器和模块管理器都应继承此基类以保持接口一致性
-{!--< /tips >!--}
-"""
-
-from abc import ABC, abstractmethod
-from typing import Dict, List, Any, Type, Optional
-
-
-class ManagerBase(ABC):
-    """
-    管理器基类
-    
-    定义适配器和模块管理器的统一接口
-    
-    {!--< tips >!--}
-    统一方法：
-    - register(): 注册类
-    - unregister(): 取消注册
-    - get(): 获取实例
-    - exists(): 检查是否存在
-    - enable()/disable(): 启用/禁用
-    - is_enabled(): 检查是否启用
-    - list_*(): 列出相关项
-    {!--< /tips >!--}
-    """
-    
-    # ==================== 注册与取消注册 ====================
-    
-    @abstractmethod
-    def register(self, name: str, class_type: Type, info: Optional[Dict] = None) -> bool:
-        """
-        注册类
-        
-        :param name: 名称
-        :param class_type: 类类型
-        :param info: 额外信息
-        :return: 是否注册成功
-        """
-        ...
-    
-    @abstractmethod
-    def unregister(self, name: str) -> bool:
-        """
-        取消注册
-        
-        :param name: 名称
-        :return: 是否取消成功
-        """
-        ...
-    
-    # ==================== 实例获取 ====================
-    
-    @abstractmethod
-    def get(self, name: str) -> Any:
-        """
-        获取实例
-        
-        :param name: 名称
-        :return: 实例或 None
-        """
-        ...
-    
-    # ==================== 存在性检查 ====================
-    
-    @abstractmethod
-    def exists(self, name: str) -> bool:
-        """
-        检查是否存在（在配置中注册）
-        
-        :param name: 名称
-        :return: 是否存在
-        """
-        ...
-    
-    # ==================== 启用/禁用管理 ====================
-    
-    @abstractmethod
-    def is_enabled(self, name: str) -> bool:
-        """
-        检查是否启用
-        
-        :param name: 名称
-        :return: 是否启用
-        """
-        ...
-    
-    @abstractmethod
-    def enable(self, name: str) -> bool:
-        """
-        启用
-        
-        :param name: 名称
-        :return: 是否成功
-        """
-        ...
-    
-    @abstractmethod
-    def disable(self, name: str) -> bool:
-        """
-        禁用
-        
-        :param name: 名称
-        :return: 是否成功
-        """
-        ...
-    
-    # ==================== 列表方法 ====================
-    
-    @abstractmethod
-    def list_registered(self) -> List[str]:
-        """
-        列出所有已注册的项
-        
-        :return: 名称列表
-        """
-        ...
-    
-    @abstractmethod
-    def list_items(self) -> Dict[str, bool]:
-        """
-        列出所有项及其状态
-        
-        :return: {名称: 是否启用} 字典
-        """
-        ...
-
-
-__all__ = [
-    "ManagerBase"
-]

ErisPulse/Core/Bases/manager.pyi

@@ -1,108 +0,0 @@
-# type: ignore
-#
-# Auto-generated type stub for manager.py
-# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
-#
-
-"""
-ErisPulse 管理器基类
-
-提供适配器和模块管理器的统一接口定义
-
-{!--< tips >!--}
-适配器管理器和模块管理器都应继承此基类以保持接口一致性
-{!--< /tips >!--}
-"""
-
-from abc import ABC, abstractmethod
-from typing import Dict, List, Any, Type, Optional
-
-class ManagerBase(ABC):
-    """
-    管理器基类
-    
-    定义适配器和模块管理器的统一接口
-    
-    {!--< tips >!--}
-    统一方法：
-    - register(): 注册类
-    - unregister(): 取消注册
-    - get(): 获取实例
-    - exists(): 检查是否存在
-    - enable()/disable(): 启用/禁用
-    - is_enabled(): 检查是否启用
-    - list_*(): 列出相关项
-    {!--< /tips >!--}
-    """
-    def register(self: object, name: str, class_type: Type, info: Optional[Dict] = ...) -> bool:
-        """
-        注册类
-        
-        :param name: 名称
-        :param class_type: 类类型
-        :param info: 额外信息
-        :return: 是否注册成功
-        """
-        ...
-    def unregister(self: object, name: str) -> bool:
-        """
-        取消注册
-        
-        :param name: 名称
-        :return: 是否取消成功
-        """
-        ...
-    def get(self: object, name: str) -> Any:
-        """
-        获取实例
-        
-        :param name: 名称
-        :return: 实例或 None
-        """
-        ...
-    def exists(self: object, name: str) -> bool:
-        """
-        检查是否存在（在配置中注册）
-        
-        :param name: 名称
-        :return: 是否存在
-        """
-        ...
-    def is_enabled(self: object, name: str) -> bool:
-        """
-        检查是否启用
-        
-        :param name: 名称
-        :return: 是否启用
-        """
-        ...
-    def enable(self: object, name: str) -> bool:
-        """
-        启用
-        
-        :param name: 名称
-        :return: 是否成功
-        """
-        ...
-    def disable(self: object, name: str) -> bool:
-        """
-        禁用
-        
-        :param name: 名称
-        :return: 是否成功
-        """
-        ...
-    def list_registered(self: object) -> List[str]:
-        """
-        列出所有已注册的项
-        
-        :return: 名称列表
-        """
-        ...
-    def list_items(self: object) -> Dict[(str, bool)]:
-        """
-        列出所有项及其状态
-        
-        :return: {名称: 是否启用} 字典
-        """
-        ...

ErisPulse/loaders/__init__.py

@@ -1,22 +0,0 @@
-"""
-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

@@ -1,21 +0,0 @@
-# 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

@@ -1,187 +0,0 @@
-"""
-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

@@ -1,82 +0,0 @@
-# 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 >!--}
-        """
-        ...