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

ErisPulse/Core/lifecycle.py

@@ -120,6 +120,15 @@ class LifecycleManager:
         :param event: 事件名称
         :param event_data: 事件数据字典
         """
+        # 验证事件类型
+        if event_type is None:
+            logger.error("事件类型不能为None")
+            return
+        
+        if not isinstance(event_type, str) or not event_type:
+            logger.error(f"事件类型必须是非空字符串，收到: {event_type}")
+            return
+        
         # 构建完整事件数据
         event_data = {
             "event": event_type,
@@ -164,4 +173,9 @@ class LifecycleManager:
             except Exception as e:
                 logger.error(f"生命周期事件处理器执行错误 {event}: {e}")
 
-lifecycle = LifecycleManager()
+lifecycle = LifecycleManager()
+
+__all__ = [
+    "LifecycleManager",
+    "lifecycle"
+]

ErisPulse/Core/lifecycle.pyi

@@ -0,0 +1,92 @@
+# type: ignore
+#
+# Auto-generated type stub for lifecycle.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 生命周期管理模块
+
+提供统一的生命周期事件管理和触发机制
+
+事件标准格式:
+{
+    "event": "事件名称",  # 必填
+    "timestamp": float,  # 必填，Unix时间戳
+    "data": dict,        # 可选，事件相关数据
+    "source": str,       # 必填，事件来源
+    "msg": str           # 可选，事件描述
+}
+"""
+
+import asyncio
+import time
+from typing import Callable, List, Dict, Any
+from .logger import logger
+
+class LifecycleManager:
+    """
+    生命周期管理器
+    
+    管理SDK的生命周期事件，提供事件注册和触发功能
+    支持点式结构事件监听，例如 module.init 可以被 module 监听到
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def _validate_event(self: object, event_data: Dict[(str, Any)]) -> bool:
+        """
+        验证事件数据格式
+        
+        :param event_data: 事件数据字典
+        :return: 是否有效
+        """
+        ...
+    def on(self: object, event: str) -> Callable:
+        """
+        注册生命周期事件处理器
+        
+        :param event: 事件名称，支持点式结构如 module.init
+        :return: 装饰器函数
+        
+        :raises ValueError: 当事件名无效时抛出
+        """
+        ...
+    def start_timer(self: object, timer_id: str) -> None:
+        """
+        开始计时
+        
+        :param timer_id: 计时器ID
+        """
+        ...
+    def get_duration(self: object, timer_id: str) -> float:
+        """
+        获取指定计时器的持续时间
+        
+        :param timer_id: 计时器ID
+        :return: 持续时间(秒)
+        """
+        ...
+    def stop_timer(self: object, timer_id: str) -> float:
+        """
+        停止计时并返回持续时间
+        
+        :param timer_id: 计时器ID
+        :return: 持续时间(秒)
+        """
+        ...
+    async def submit_event(self: object, event_type: str) -> None:
+        """
+        提交生命周期事件
+        
+        :param event: 事件名称
+        :param event_data: 事件数据字典
+        """
+        ...
+    async def _execute_handlers(self: object, event: str, event_data: Dict[(str, Any)]) -> None:
+        """
+        执行事件处理器
+        
+        :param event: 事件名称
+        :param event_data: 事件数据
+        """
+        ...

ErisPulse/Core/logger.py

@@ -91,11 +91,6 @@ class Logger:
         :param level: 日志级别(DEBUG/INFO/WARNING/ERROR/CRITICAL)
         :return: bool 设置是否成功
         """
-        from .module import module
-
-        if not module.is_enabled(module_name):
-            self._logger.warning(f"模块 {module_name} 未启用，无法设置日志等级。")
-            return False
         level = level.upper()
         if hasattr(logging, level):
             self._module_levels[module_name] = getattr(logging, level)
@@ -115,19 +110,21 @@ class Logger:
         if self._file_handler:
             self._logger.removeHandler(self._file_handler)
             self._file_handler.close()
+            self._file_handler = None
 
         if isinstance(path, str):
             path = [path]
 
         for p in path:
             try:
-                file_handler = logging.FileHandler(p, encoding="utf-8")
+                self._file_handler = logging.FileHandler(p, encoding="utf-8")
                 # 使用自定义格式化器去除rich markup标签
-                file_handler.setFormatter(logging.Formatter("[%(name)s] %(message)s"))
-                self._logger.addHandler(file_handler)
+                self._file_handler.setFormatter(logging.Formatter("[%(name)s] %(message)s"))
+                self._logger.addHandler(self._file_handler)
                 return True
             except Exception as e:
                 self._logger.error(f"无法设置日志文件 {p}: {e}")
+                self._file_handler = None
                 return False
 
         self._logger.warning("出现极端错误，无法设置日志文件。")
@@ -140,9 +137,11 @@ class Logger:
         :param path: 日志文件路径 Str/List
         :return: bool 设置是否成功
         """
-        if self._logs is None:
+        # 检查是否有日志记录
+        if not self._logs or all(len(logs) == 0 for logs in self._logs.values()):
             self._logger.warning("没有log记录可供保存。")
             return False
+        
         if isinstance(path, str):
             path = [path]
 
@@ -162,16 +161,18 @@ class Logger:
         self._logger.warning("出现极端错误，无法保存日志。")
         return False
 
-    def get_logs(self, module_name: str = "Unknown") -> dict:
+    def get_logs(self, module_name: str = None) -> dict:
         """
         获取日志内容
 
-        :param module_name (可选): 模块名称
+        :param module_name (可选): 模块名称，None表示获取所有日志
         :return: dict 日志内容
         """
-        if module_name:
-            return {module_name: self._logs.get(module_name, [])}
-        return {k: v.copy() for k, v in self._logs.items()}
+        if module_name is None:
+            # 返回所有日志
+            return {k: v.copy() for k, v in self._logs.items()}
+        # 返回指定模块的日志
+        return {module_name: self._logs.get(module_name, [])}
 
     def _save_in_memory(self, ModuleName, msg):
         if ModuleName not in self._logs:
@@ -226,13 +227,18 @@ class Logger:
         except Exception:
             return "Unknown"
 
-    def get_child(self, child_name: str = "UnknownChild"):
+    def get_child(self, child_name: str = "UnknownChild", *, relative: bool = True):
         """
         获取子日志记录器
 
         :param child_name: 子模块名称(可选)
+        :param relative: 是否相对于调用者模块（默认True），False表示使用完整名称
         :return: LoggerChild 子日志记录器实例
         """
+        if child_name and not relative:
+            # 使用完整的指定名称，不添加前缀
+            return LoggerChild(self, child_name)
+        
         caller_module = self._get_caller()
         if child_name:
             full_module_name = f"{caller_module}.{child_name}"

ErisPulse/Core/logger.pyi

@@ -0,0 +1,169 @@
+# type: ignore
+#
+# Auto-generated type stub for logger.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 日志系统
+
+提供模块化日志记录功能，支持多级日志、模块过滤和内存存储。
+
+{!--< tips >!--}
+1. 支持按模块设置不同日志级别
+2. 日志可存储在内存中供后续分析
+3. 自动识别调用模块名称
+{!--< /tips >!--}
+"""
+
+import logging
+import inspect
+import datetime
+from rich.logging import RichHandler
+from rich.console import Console
+
+class Logger:
+    """
+    日志管理器
+    
+    提供模块化日志记录和存储功能
+    
+    {!--< tips >!--}
+    1. 使用set_module_level设置模块日志级别
+    2. 使用get_logs获取历史日志
+    3. 支持标准日志级别(DEBUG, INFO等)
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def set_memory_limit(self: object, limit: int) -> bool:
+        """
+        设置日志内存存储上限
+        
+        :param limit: 日志存储上限
+        :return: bool 设置是否成功
+        """
+        ...
+    def set_level(self: object, level: str) -> bool:
+        """
+        设置全局日志级别
+        
+        :param level: 日志级别(DEBUG/INFO/WARNING/ERROR/CRITICAL)
+        :return: bool 设置是否成功
+        """
+        ...
+    def set_module_level(self: object, module_name: str, level: str) -> bool:
+        """
+        设置指定模块日志级别
+        
+        :param module_name: 模块名称
+        :param level: 日志级别(DEBUG/INFO/WARNING/ERROR/CRITICAL)
+        :return: bool 设置是否成功
+        """
+        ...
+    def set_output_file(self: object, path: ...) -> bool:
+        """
+        设置日志输出
+        
+        :param path: 日志文件路径 Str/List
+        :return: bool 设置是否成功
+        """
+        ...
+    def save_logs(self: object, path: ...) -> bool:
+        """
+        保存所有在内存中记录的日志
+        
+        :param path: 日志文件路径 Str/List
+        :return: bool 设置是否成功
+        """
+        ...
+    def get_logs(self: object, module_name: str = ...) -> dict:
+        """
+        获取日志内容
+        
+        :param module_name (可选): 模块名称，None表示获取所有日志
+        :return: dict 日志内容
+        """
+        ...
+    def _save_in_memory(self: object, ModuleName: ..., msg: ...) -> ...:
+        ...
+    def _setup_config(self: object) -> ...:
+        ...
+    def _get_effective_level(self: object, module_name: ...) -> ...:
+        ...
+    def _get_caller(self: object) -> ...:
+        ...
+    def get_child(self: object, child_name: str = ...) -> ...:
+        """
+        获取子日志记录器
+        
+        :param child_name: 子模块名称(可选)
+        :param relative: 是否相对于调用者模块（默认True），False表示使用完整名称
+        :return: LoggerChild 子日志记录器实例
+        """
+        ...
+    def debug(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def info(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def warning(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def error(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def critical(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        """
+        记录 CRITICAL 级别日志
+        这是最高级别的日志，表示严重的系统错误
+        注意：此方法不会触发程序崩溃，仅记录日志
+        
+        {!--< tips >!--}
+        1. 这是最高级别的日志，表示严重系统错误
+        2. 不会触发程序崩溃，如需终止程序请显式调用 sys.exit()
+        3. 会在日志文件中添加 CRITICAL 标记便于后续分析
+        {!--< /tips >!--}
+        """
+        ...
+
+class LoggerChild:
+    """
+    子日志记录器
+    
+    用于创建具有特定名称的子日志记录器，仅改变模块名称，其他功能全部委托给父日志记录器
+    """
+    def __init__(self: None, parent_logger: Logger, name: str) -> ...:
+        """
+        初始化子日志记录器
+        
+        :param parent_logger: 父日志记录器实例
+        :param name: 子日志记录器名称
+        """
+        ...
+    def debug(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def info(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def warning(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def error(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def critical(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        """
+        记录 CRITICAL 级别日志
+        这是最高级别的日志，表示严重的系统错误
+        注意：此方法不会触发程序崩溃，仅记录日志
+        
+        {!--< tips >!--}
+        1. 这是最高级别的日志，表示严重系统错误
+        2. 不会触发程序崩溃，如需终止程序请显式调用 sys.exit()
+        3. 会在日志文件中添加 CRITICAL 标记便于后续分析
+        {!--< /tips >!--}
+        """
+        ...
+    def get_child(self: object, child_name: str) -> ...:
+        """
+        获取子日志记录器的子记录器
+        
+        :param child_name: 子模块名称
+        :return: LoggerChild 子日志记录器实例
+        """
+        ...

ErisPulse/Core/module.py

@@ -5,13 +5,15 @@ ErisPulse 模块系统
 """
 
 import asyncio
+import warnings
 from typing import Any, Dict, List, Type, Optional
 from .logger import logger
 from .config import config
 from .Bases import BaseModule
 from .lifecycle import lifecycle
+from .Bases.manager import ManagerBase
 
-class ModuleManager:
+class ModuleManager(ManagerBase):
     """
     模块管理器
     
@@ -48,9 +50,16 @@ class ModuleManager:
         >>> module.register("MyModule", MyModuleClass)
         """
         # 严格验证模块类，确保继承自BaseModule
+        # 先检查是否为类对象
+        if not isinstance(module_class, type):
+            error_msg = f"模块 {module_name} 的参数必须是类，而不是 {type(module_class).__name__}"
+            logger.error(error_msg)
+            raise TypeError(error_msg)
+            
         if not issubclass(module_class, BaseModule):
             warn_msg = f"模块 {module_name} 的类 {module_class.__name__} 没有继承自BaseModule，但我们仍会继续尝试加载这个模块，但请注意这可能引发其他问题"
             logger.warning(warn_msg)
+            warnings.warn(warn_msg, UserWarning)
             # error_msg = f"模块 {module_name} 的类 {module_class.__name__} 必须继承自BaseModule"
             # logger.error(error_msg)
             # raise TypeError(error_msg)
@@ -63,7 +72,9 @@ class ModuleManager:
             
         # 检查模块名是否已存在
         if module_name in self._module_classes:
-            logger.warning(f"模块 {module_name} 已存在，将覆盖原模块类")
+            warn_msg = f"模块 {module_name} 已存在，将覆盖原模块类"
+            logger.warning(warn_msg)
+            warnings.warn(warn_msg, UserWarning)
             
         self._module_classes[module_name] = module_class
         if module_info:
@@ -189,14 +200,15 @@ class ModuleManager:
         :param module_name: 模块名称
         :return: 是否卸载成功
         """
+        # 模块未加载，返回 True（表示没有需要卸载的模块，这不是错误）
         if module_name not in self._loaded_modules:
             logger.warning(f"模块 {module_name} 未加载")
-            return False
+            return True
             
         try:
             # 调用模块的on_unload卸载方法
-            instance = self._modules[module_name]
-            if hasattr(instance, 'on_unload'):
+            instance = self._modules.get(module_name)
+            if instance and hasattr(instance, 'on_unload'):
                 try:
                     if asyncio.iscoroutinefunction(instance.on_unload):
                         await instance.on_unload({"module_name": module_name})
@@ -204,9 +216,9 @@ class ModuleManager:
                         instance.on_unload({"module_name": module_name})
                 except Exception as e:
                     logger.error(f"模块 {module_name} on_unload 方法执行失败: {e}")
-                    
+            
             # 清理缓存
-            del self._modules[module_name]
+            del self._modules[module_name]            
             self._loaded_modules.discard(module_name)
             
             logger.info(f"模块 {module_name} 卸载成功")
@@ -334,13 +346,49 @@ class ModuleManager:
         self._loaded_modules.discard(module_name)
         return True
     
+    def unregister(self, module_name: str) -> bool:
+        """
+        取消注册模块
+        
+        :param module_name: 模块名称
+        :return: 是否取消成功
+        
+        {!--< internal-use >!--}
+        注意：此方法仅取消注册，不卸载已加载的模块
+        {!--< /internal-use >!--}
+        """
+        if module_name not in self._module_classes:
+            logger.warning(f"模块 {module_name} 未注册")
+            return False
+        
+        # 移除模块类
+        self._module_classes.pop(module_name)
+        
+        # 移除模块信息
+        if module_name in self._module_info:
+            self._module_info.pop(module_name)
+        
+        logger.info(f"模块 {module_name} 已取消注册")
+        return True
+    
+    def list_items(self) -> Dict[str, bool]:
+        """
+        列出所有模块状态
+        
+        :return: {模块名: 是否启用} 字典
+        """
+        return config.getConfig("ErisPulse.modules.status", {})
+    
+    # 兼容性方法 - 保持向后兼容
     def list_modules(self) -> Dict[str, bool]:
         """
         列出所有模块状态
         
+        {!--< deprecated >!--} 请使用 list_items() 代替
+        
         :return: [Dict[str, bool]] 模块状态字典
         """
-        return config.getConfig("ErisPulse.modules.status", {})
+        return self.list_items()
     
     # ==================== 工具方法 ====================
     
@@ -370,4 +418,4 @@ module = ModuleManager()
 
 __all__ = [
     "module"
-]
+]

ErisPulse/Core/module.pyi

@@ -0,0 +1,189 @@
+# type: ignore
+#
+# Auto-generated type stub for module.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 模块系统
+
+提供标准化的模块注册、加载和管理功能，与适配器系统保持一致的设计模式
+"""
+
+import asyncio
+import warnings
+from typing import Any, Dict, List, Type, Optional
+from .logger import logger
+from .config import config
+from .Bases import BaseModule
+from .lifecycle import lifecycle
+from .Bases.manager import ManagerBase
+
+class ModuleManager(ManagerBase):
+    """
+    模块管理器
+    
+    提供标准化的模块注册、加载和管理功能，模仿适配器管理器的模式
+    
+    {!--< tips >!--}
+    1. 使用register方法注册模块类
+    2. 使用load/unload方法加载/卸载模块
+    3. 通过get方法获取模块实例
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def register(self: object, module_name: str, module_class: Type, module_info: Optional[Dict] = ...) -> bool:
+        """
+        注册模块类
+        
+        :param module_name: 模块名称
+        :param module_class: 模块类
+        :param module_info: 模块信息
+        :return: 是否注册成功
+        
+        :raises TypeError: 当模块类无效时抛出
+            
+        :example:
+        >>> module.register("MyModule", MyModuleClass)
+        """
+        ...
+    async def load(self: object, module_name: str) -> bool:
+        """
+        加载指定模块（标准化加载逻辑）
+        
+        :param module_name: 模块名称
+        :return: 是否加载成功
+            
+        :example:
+        >>> await module.load("MyModule")
+        """
+        ...
+    async def unload(self: object, module_name: str = ...) -> bool:
+        """
+        卸载指定模块或所有模块
+        
+        :param module_name: 模块名称，如果为None则卸载所有模块
+        :return: 是否卸载成功
+            
+        :example:
+        >>> await module.unload("MyModule")
+        >>> await module.unload()  # 卸载所有模块
+        """
+        ...
+    def get(self: object, module_name: str) -> Any:
+        """
+        获取模块实例
+        
+        :param module_name: 模块名称
+        :return: 模块实例或None
+            
+        :example:
+        >>> my_module = module.get("MyModule")
+        """
+        ...
+    def exists(self: object, module_name: str) -> bool:
+        """
+        检查模块是否存在（在配置中注册）
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否存在
+        """
+        ...
+    def is_loaded(self: object, module_name: str) -> bool:
+        """
+        检查模块是否已加载
+        
+        :param module_name: 模块名称
+        :return: 模块是否已加载
+            
+        :example:
+        >>> if module.is_loaded("MyModule"): ...
+        """
+        ...
+    def list_registered(self: object) -> List[str]:
+        """
+        列出所有已注册的模块
+        
+        :return: 模块名称列表
+            
+        :example:
+        >>> registered = module.list_registered()
+        """
+        ...
+    def list_loaded(self: object) -> List[str]:
+        """
+        列出所有已加载的模块
+        
+        :return: 模块名称列表
+            
+        :example:
+        >>> loaded = module.list_loaded()
+        """
+        ...
+    def _config_register(self: object, module_name: str, enabled: bool = ...) -> bool:
+        """
+        注册新模块信息
+        
+        :param module_name: [str] 模块名称
+        :param enabled: [bool] 是否启用模块
+        :return: [bool] 操作是否成功
+        """
+        ...
+    def is_enabled(self: object, module_name: str) -> bool:
+        """
+        检查模块是否启用
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否启用
+        """
+        ...
+    def enable(self: object, module_name: str) -> bool:
+        """
+        启用模块
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 操作是否成功
+        """
+        ...
+    def disable(self: object, module_name: str) -> bool:
+        """
+        禁用模块
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 操作是否成功
+        """
+        ...
+    def list_items(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有模块状态
+        
+        :return: {模块名: 是否启用} 字典
+        """
+        ...
+    def list_modules(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有模块状态
+        
+        {!--< deprecated >!--} 请使用 list_items() 代替
+        
+        :return: [Dict[str, bool]] 模块状态字典
+        """
+        ...
+    def __getattr__(self: object, module_name: str) -> Any:
+        """
+        通过属性访问获取模块实例
+        
+        :param module_name: [str] 模块名称
+        :return: [Any] 模块实例
+        :raises AttributeError: 当模块不存在或未启用时
+        """
+        ...
+    def __contains__(self: object, module_name: str) -> bool:
+        """
+        检查模块是否存在且处于启用状态
+        
+        :param module_name: [str] 模块名称
+        :return: [bool] 模块是否存在且启用
+        """
+        ...