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

ErisPulse/loaders/module_loader.pyi

@@ -0,0 +1,179 @@
+# type: ignore
+#
+# Auto-generated type stub for module_loader.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 模块加载器
+
+专门用于从 PyPI 包加载和初始化普通模块
+
+{!--< tips >!--}
+1. 模块必须通过 entry-points 机制注册到 erispulse.module 组
+2. 模块类名应与 entry-point 名称一致
+3. 模块支持懒加载机制
+{!--< /tips >!--}
+"""
+
+import sys
+import asyncio
+import inspect
+import importlib.metadata
+from typing import Dict, List, Any, Tuple, Type, TYPE_CHECKING
+from .base_loader import BaseLoader
+from ..Core.logger import logger
+from ..Core.lifecycle import lifecycle
+
+class ModuleLoader(BaseLoader):
+    """
+    模块加载器
+    
+    负责从 PyPI entry-points 加载模块，支持懒加载
+    
+    {!--< tips >!--}
+    使用方式：
+    >>> loader = ModuleLoader()
+    >>> module_objs, enabled, disabled = await loader.load(module_manager)
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化模块加载器
+        """
+        ...
+    def _get_entry_point_group(self: object) -> str:
+        """
+        获取 entry-point 组名
+        
+        :return: "erispulse.module"
+        """
+        ...
+    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, modules: List[str], module_objs: Dict[(str, Any)], manager_instance: Any) -> bool:
+        """
+        将模块类注册到管理器
+        
+        :param modules: 模块名称列表
+        :param module_objs: 模块对象字典
+        :param manager_instance: 模块管理器实例
+        :return: 模块注册是否成功
+        
+        {!--< tips >!--}
+        此方法由初始化协调器调用，仅注册模块类，不进行实例化
+        {!--< /tips >!--}
+        """
+        ...
+    async def initialize_modules(self: object, modules: List[str], module_objs: Dict[(str, Any)], manager_instance: Any, sdk_instance: Any) -> bool:
+        """
+        初始化模块（创建实例并挂载到 SDK）
+        
+        :param modules: 模块名称列表
+        :param module_objs: 模块对象字典
+        :param manager_instance: 模块管理器实例
+        :param sdk_instance: SDK 实例
+        :return: 模块初始化是否成功
+        
+        {!--< tips >!--}
+        此方法处理模块的实际初始化和挂载
+        {!--< /tips >!--}
+        
+        并行注册所有模块类（已在 register_to_manager 中完成）
+        这里处理模块的实例化和挂载
+        """
+        ...
+
+class LazyModule:
+    """
+    懒加载模块包装器
+    
+    当模块第一次被访问时才进行实例化
+    
+    {!--< tips >!--}
+    1. 模块的实际实例化会在第一次属性访问时进行
+    2. 依赖模块会在被使用时自动初始化
+    3. 对于继承自 BaseModule 的模块，会自动调用生命周期方法
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, module_name: str, module_class: Type, sdk_ref: Any, module_info: Dict[(str, Any)], manager_instance: Any) -> None:
+        """
+        初始化懒加载包装器
+        
+        :param module_name: str 模块名称
+        :param module_class: Type 模块类
+        :param sdk_ref: Any SDK 引用
+        :param module_info: Dict[str, Any] 模块信息字典
+        :param manager_instance: 模块管理器实例
+        """
+        ...
+    def __getattr__(self: object, name: str) -> Any:
+        """
+        属性访问时触发初始化
+        
+        :param name: str 属性名
+        :return: Any 属性值
+        """
+        ...
+    def __setattr__(self: object, name: str, value: Any) -> None:
+        """
+        属性设置
+        
+        :param name: str 属性名
+        :param value: Any 属性值
+        """
+        ...
+    def __delattr__(self: object, name: str) -> None:
+        """
+        属性删除
+        
+        :param name: str 属性名
+        """
+        ...
+    def __getattribute__(self: object, name: str) -> Any:
+        """
+        属性访问，初始化后直接委托给实际实例
+        
+        :param name: str 属性名
+        :return: Any 属性值
+        """
+        ...
+    def __dir__(self: object) -> List[str]:
+        """
+        返回模块属性列表
+        
+        :return: List[str] 属性列表
+        """
+        ...
+    def __repr__(self: object) -> str:
+        """
+        返回模块表示字符串
+        
+        :return: str 表示字符串
+        """
+        ...
+    def __call__(self: object, *args: ..., **kwargs: ...) -> ...:
+        """
+        代理函数调用
+        
+        :param args: 位置参数
+        :param kwargs: 关键字参数
+        :return: 调用结果
+        """
+        ...

ErisPulse/loaders/strategy.py

@@ -0,0 +1,129 @@
+"""
+ErisPulse 模块加载策略
+
+提供统一的模块加载策略配置类
+
+{!--< tips >!--}
+1. 所有属性统一处理，没有预定义字段
+2. 支持通过构造函数传入任意参数
+3. 支持字典方式创建
+{!--< /tips >!--}
+"""
+
+from typing import Any, Dict, Union
+
+
+class ModuleLoadStrategy:
+    """
+    模块加载策略配置
+    
+    所有属性统一处理，通过魔术方法实现动态访问
+    没有预定义属性，完全由用户传入的内容决定
+    
+    {!--< tips >!--}
+    使用方式：
+    >>> strategy = ModuleLoadStrategy(
+    ...     lazy_load=False,
+    ...     priority=100,
+    ...     custom_option=123
+    ... )
+
+    eager_load 也是一个合法的属性，但不建议使用，其的han'y
+    >>> strategy.lazy_load
+    False
+    >>> strategy.priority
+    100
+    >>> strategy.custom_option
+    123
+    
+    从字典创建：
+    >>> config = {"lazy_load": False, "priority": 100}
+    >>> strategy = ModuleLoadStrategy.from_dict(config)
+    {!--< /tips >!--}
+    """
+    
+    def __init__(self, **kwargs):
+        """
+        初始化策略，所有参数统一存储
+        
+        :param kwargs: 策略配置项，任意键值对
+        
+        {!--< tips >!--}
+        常用配置项：
+        - lazy_load: bool, 是否懒加载（默认 True）
+        - priority: int, 加载优先级（默认 0，数值越大优先级越高）
+        {!--< /tips >!--}
+        """
+        object.__setattr__(self, '_data', kwargs)
+    
+    def __getattr__(self, name: str) -> Any:
+        """
+        获取属性值
+        
+        :param name: 属性名
+        :return: 属性值，如果不存在则返回 None
+        
+        {!--< internal-use >!--}
+        内部方法，用于动态属性访问
+        {!--< /internal-use >!--}
+        """
+        if name.startswith('_'):
+            raise AttributeError(f"'{type(self).__name__}' has no attribute '{name}'")
+        data = object.__getattribute__(self, '_data')
+        if name not in data:
+            return None
+        return data[name]
+    
+    def __setattr__(self, name: str, value: Any) -> Any:
+        """
+        设置属性值
+        
+        :param name: 属性名
+        :param value: 属性值
+        
+        {!--< internal-use >!--}
+        内部方法，用于动态属性设置
+        {!--< /internal-use >!--}
+        """
+        if name.startswith('_'):
+            object.__setattr__(self, name, value)
+        else:
+            self._data[name] = value
+    
+    def __contains__(self, name: str) -> bool:
+        """
+        检查属性是否存在
+        
+        :param name: 属性名
+        :return: 是否存在该属性
+        """
+        return name in self._data
+    
+    def __repr__(self) -> str:
+        """
+        返回策略的字符串表示
+        
+        :return: 字符串表示
+        """
+        return f"ModuleLoadStrategy({self._data})"
+    
+    @classmethod
+    def from_dict(cls, config: Dict[str, Any]) -> 'ModuleLoadStrategy':
+        """
+        从字典创建策略实例
+        
+        :param config: 配置字典
+        :return: 策略实例
+        
+        {!--< tips >!--}
+        示例：
+        >>> config = {"lazy_load": False, "priority": 100}
+        >>> strategy = ModuleLoadStrategy.from_dict(config)
+        {!--< /tips >!--}
+        """
+        return cls(**config)
+
+
+__all__ = [
+    "ModuleLoadStrategy"
+]

ErisPulse/loaders/strategy.pyi

@@ -0,0 +1,90 @@
+# type: ignore
+#
+# Auto-generated type stub for strategy.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 模块加载策略
+
+提供统一的模块加载策略配置类
+
+{!--< tips >!--}
+1. 所有属性统一处理，没有预定义字段
+2. 支持通过构造函数传入任意参数
+3. 支持字典方式创建
+{!--< /tips >!--}
+"""
+
+from typing import Any, Dict, Union
+
+class ModuleLoadStrategy:
+    """
+    模块加载策略配置
+    
+    所有属性统一处理，通过魔术方法实现动态访问
+    没有预定义属性，完全由用户传入的内容决定
+    
+    {!--< tips >!--}
+    使用方式：
+    >>> strategy = ModuleLoadStrategy(
+    ...     lazy_load=False,
+    ...     priority=100,
+    ...     custom_option=123
+    ... )
+    
+    eager_load 也是一个合法的属性，但不建议使用，其的han'y
+    >>> strategy.lazy_load
+    False
+    >>> strategy.priority
+    100
+    >>> strategy.custom_option
+    123
+    
+    从字典创建：
+    >>> config = {"lazy_load": False, "priority": 100}
+    >>> strategy = ModuleLoadStrategy.from_dict(config)
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, **kwargs: ...) -> ...:
+        """
+        初始化策略，所有参数统一存储
+        
+        :param kwargs: 策略配置项，任意键值对
+        
+        {!--< tips >!--}
+        常用配置项：
+        - lazy_load: bool, 是否懒加载（默认 True）
+        - priority: int, 加载优先级（默认 0，数值越大优先级越高）
+        {!--< /tips >!--}
+        """
+        ...
+    def __contains__(self: object, name: str) -> bool:
+        """
+        检查属性是否存在
+        
+        :param name: 属性名
+        :return: 是否存在该属性
+        """
+        ...
+    def __repr__(self: object) -> str:
+        """
+        返回策略的字符串表示
+        
+        :return: 字符串表示
+        """
+        ...
+    def from_dict(cls: object, config: Dict[(str, Any)]) -> ModuleLoadStrategy:
+        """
+        从字典创建策略实例
+        
+        :param config: 配置字典
+        :return: 策略实例
+        
+        {!--< tips >!--}
+        示例：
+        >>> config = {"lazy_load": False, "priority": 100}
+        >>> strategy = ModuleLoadStrategy.from_dict(config)
+        {!--< /tips >!--}
+        """
+        ...