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

ErisPulse/Core/Bases/module.pyi

@@ -10,18 +10,61 @@ ErisPulse 模块基础模块
 提供模块基类定义和标准接口
 """
 
+from typing import Union, Dict, Any
+from ...loaders.strategy import ModuleLoadStrategy
+
 class BaseModule:
     """
     模块基类
     
     提供模块加载和卸载的标准接口
     """
+    def get_load_strategy() -> Union[(ModuleLoadStrategy, Dict[(str, Any)])]:
+        """
+        获取模块加载策略
+        
+        支持返回 ModuleLoadStrategy 对象或字典
+        所有属性统一处理，没有任何预定义字段
+        
+        :return: 加载策略对象或字典
+        
+        {!--< tips >!--}
+        常用配置项：
+        - lazy_load: bool, 是否懒加载（默认 True）
+        - priority: int, 加载优先级（默认 0，数值越大优先级越高）
+        
+        使用方式：
+        >>> class MyModule(BaseModule):
+        ...     @staticmethod
+        ...     def get_load_strategy() -> ModuleLoadStrategy:
+        ...         return ModuleLoadStrategy(
+        ...             lazy_load=False,
+        ...             priority=100
+        ...         )
+        
+        或使用字典：
+        >>> class MyModule(BaseModule):
+        ...     @staticmethod
+        ...     def get_load_strategy() -> dict:
+        ...         return {
+        ...             "lazy_load": False,
+        ...             "priority": 100
+        ...         }
+        {!--< /tips >!--}
+        """
+        ...
     def should_eager_load() -> bool:
         """
         模块是否应该在启动时加载
         默认为False(即懒加载)
         
+        兼容方法，实际调用 get_load_strategy()
+        
         :return: 是否应该在启动时加载
+        
+        {!--< tips >!--}
+        旧版方法，建议使用 get_load_strategy() 替代
+        {!--< /tips >!--}
         """
         ...
     async def on_load(self: object, event: dict) -> bool:

ErisPulse/Core/Event/command.py

@@ -94,7 +94,7 @@ class CommandHandler:
                     "main_name": main_name
                 }
                 
-                # 注册别名映射
+                # 注册别名映射（name列表中的额外名称）
                 if cmd_name != main_name:
                     self.aliases[cmd_name] = main_name
                 
@@ -102,6 +102,11 @@ class CommandHandler:
                 if permission and cmd_name not in self.permissions:
                     self.permissions[cmd_name] = permission
             
+            # 注册aliases参数中的别名
+            for alias in alias_list:
+                if alias not in self.aliases:
+                    self.aliases[alias] = main_name
+            
             # 添加到命令组
             if group:
                 if group not in self.groups:

ErisPulse/Core/_self_config.py

@@ -21,7 +21,7 @@ DEFAULT_ERISPULSE_CONFIG = {
         "memory_limit": 1000
     },
     "storage":  {
-        "max_snapshot": 20
+        "use_global_db": False,
     },
     "modules": {},
     "adapters": {},

ErisPulse/Core/adapter.py

@@ -14,8 +14,9 @@ from .logger import logger
 from .Bases.adapter import BaseAdapter
 from .config import config
 from .lifecycle import lifecycle
+from .Bases.manager import ManagerBase
 
-class AdapterManager:
+class AdapterManager(ManagerBase):
     """
     适配器管理器
 
@@ -269,6 +270,9 @@ class AdapterManager:
         from .router import router
         await router.stop()
 
+        # 清空已启动实例集合
+        self._started_instances.clear()
+
         # 提交适配器关闭完成事件
         await lifecycle.submit_event(
             "adapter.stopped",
@@ -301,9 +305,8 @@ class AdapterManager:
         :param platform: 平台名称
         :return: [bool] 平台是否存在
         """
-        # 检查平台是否在配置中注册
-        adapter_statuses = config.getConfig("ErisPulse.adapters.status", {})
-        return platform in adapter_statuses
+        # 检查平台是否已注册（在 _adapters 中）
+        return platform in self._adapters
 
     def is_enabled(self, platform: str) -> bool:
         """
@@ -332,10 +335,11 @@ class AdapterManager:
         :param platform: 平台名称
         :return: [bool] 操作是否成功
         """
-        if not self.exists(platform):
+        # 启用平台时自动在配置中注册
+        if platform not in self._adapters:
             logger.error(f"平台 {platform} 不存在")
             return False
-
+        
         config.setConfig(f"ErisPulse.adapters.status.{platform}", True)
         logger.info(f"平台 {platform} 已启用")
         return True
@@ -347,21 +351,77 @@ class AdapterManager:
         :param platform: 平台名称
         :return: [bool] 操作是否成功
         """
-        if not self.exists(platform):
+        # 禁用平台时自动在配置中注册
+        if platform not in self._adapters:
             logger.error(f"平台 {platform} 不存在")
             return False
-
+        
         config.setConfig(f"ErisPulse.adapters.status.{platform}", False)
         logger.info(f"平台 {platform} 已禁用")
         return True
 
+    def unregister(self, platform: str) -> bool:
+        """
+        取消注册适配器
+        
+        :param platform: 平台名称
+        :return: 是否取消成功
+        
+        {!--< internal-use >!--}
+        注意：此方法仅取消注册，不关闭已启动的适配器
+        {!--< /internal-use >!--}
+        """
+        if platform not in self._adapters:
+            logger.warning(f"平台 {platform} 未注册")
+            return False
+        
+        # 移除适配器实例
+        adapter = self._adapters.pop(platform)
+        
+        # 移除平台属性
+        if len(platform) <= 10:
+            from itertools import product
+            combinations = [''.join(c) for c in product(*[(ch.lower(), ch.upper()) for ch in platform])]
+            for name in set(combinations):
+                if hasattr(self, name):
+                    delattr(self, name)
+        else:
+            if hasattr(self, platform.lower()):
+                delattr(self, platform.lower())
+            if hasattr(self, platform.upper()):
+                delattr(self, platform.upper())
+            if hasattr(self, platform.capitalize()):
+                delattr(self, platform.capitalize())
+        
+        logger.info(f"平台 {platform} 已取消注册")
+        return True
+    
+    def list_registered(self) -> List[str]:
+        """
+        列出所有已注册的平台
+        
+        :return: 平台名称列表
+        """
+        return list(self._adapters.keys())
+    
+    def list_items(self) -> Dict[str, bool]:
+        """
+        列出所有平台适配器状态
+        
+        :return: {平台名: 是否启用} 字典
+        """
+        return config.getConfig("ErisPulse.adapters.status", {})
+    
+    # 兼容性方法 - 保持向后兼容
     def list_adapters(self) -> Dict[str, bool]:
         """
         列出所有平台适配器状态
-
+        
+        {!--< deprecated >!--} 请使用 list_items() 代替
+        
         :return: [Dict[str, bool]] 平台适配器状态字典
         """
-        return config.getConfig("ErisPulse.adapters.status", {})
+        return self.list_items()
 
     # ==================== 事件处理与消息发送 ====================
 

ErisPulse/Core/adapter.pyi

@@ -18,8 +18,9 @@ from .logger import logger
 from .Bases.adapter import BaseAdapter
 from .config import config
 from .lifecycle import lifecycle
+from .Bases.manager import ManagerBase
 
-class AdapterManager:
+class AdapterManager(ManagerBase):
     """
     适配器管理器
     
@@ -118,10 +119,26 @@ class AdapterManager:
         :return: [bool] 操作是否成功
         """
         ...
+    def list_registered(self: object) -> List[str]:
+        """
+        列出所有已注册的平台
+        
+        :return: 平台名称列表
+        """
+        ...
+    def list_items(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有平台适配器状态
+        
+        :return: {平台名: 是否启用} 字典
+        """
+        ...
     def list_adapters(self: object) -> Dict[(str, bool)]:
         """
         列出所有平台适配器状态
         
+        {!--< deprecated >!--} 请使用 list_items() 代替
+        
         :return: [Dict[str, bool]] 平台适配器状态字典
         """
         ...

ErisPulse/Core/exceptions.py

@@ -108,6 +108,8 @@ def setup_async_loop(loop: asyncio.AbstractEventLoop = None) -> None:   # type:
 
 sys.excepthook = global_exception_handler
 try:
-    asyncio.get_event_loop().set_exception_handler(async_exception_handler)
+    loop = asyncio.get_running_loop()
+    loop.set_exception_handler(async_exception_handler)
 except RuntimeError:
-    pass
+    # 没有运行中的事件循环，这是正常的，在运行时再设置
+    pass

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,

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

@@ -81,7 +81,7 @@ class Logger:
         """
         获取日志内容
         
-        :param module_name (可选): 模块名称
+        :param module_name (可选): 模块名称，None表示获取所有日志
         :return: dict 日志内容
         """
         ...
@@ -98,6 +98,7 @@ class Logger:
         获取子日志记录器
         
         :param child_name: 子模块名称(可选)
+        :param relative: 是否相对于调用者模块（默认True），False表示使用完整名称
         :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

@@ -11,13 +11,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):
     """
     模块管理器
     
@@ -152,10 +154,19 @@ class ModuleManager:
         :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]] 模块状态字典
         """
         ...

ErisPulse/Core/router.py

@@ -235,13 +235,20 @@ class RouterManager:
         try:
             full_path = f"/{module_name}{path}"
 
-            # 使用类型忽略注释
-            if full_path in self.app.websocket_routes:          # type: ignore  || 原因：实际上，FastAPI的API提供了websocket_routes属性
-                self.app.remove_api_websocket_route(full_path)  # type: ignore  || 原因：实际上，FastAPI的API提供了remove_api_websocket_route方法
+            # 检查 WebSocket 路由是否存在于我们的内部记录中
+            if full_path in self._websocket_routes.get(module_name, {}):
                 display_url = self._format_display_url(f"{self.base_url}{full_path}")
                 logger.info(f"注销WebSocket: {display_url}")
                 del self._websocket_routes[module_name][full_path]
+                
+                # 从 FastAPI 路由列表中移除对应的 WebSocket 路由
+                # FastAPI 的 WebSocket 路由有 websocket_endpoint 属性
+                self.app.router.routes = [
+                    route for route in self.app.router.routes
+                    if not (hasattr(route, 'path') and route.path == full_path)
+                ]
                 return True
+            
             display_url = self._format_display_url(f"{self.base_url}{full_path}")
             logger.error(f"注销WebSocket失败: 路径 {display_url} 不存在")
             return False
@@ -339,8 +346,9 @@ class RouterManager:
         if "0.0.0.0" in url:
             display_url = url.replace("0.0.0.0", "127.0.0.1")
             return f"{url} (可访问: {display_url})"
-        elif "::" in url:
-            display_url = url.replace("::", "localhost")
+        elif "[::]" in url:
+            # IPv6 回环地址需要替换括号
+            display_url = url.replace("[::]", "localhost")
             return f"{url} (可访问: {display_url})"
         return url