ErisPulse 1.2.3__py3-none-any.whl → 1.2.6__py3-none-any.whl

ErisPulse/__init__.py

@@ -38,6 +38,7 @@ sdk.logger.info("SDK已初始化")
 
 import os
 import sys
+from typing import Tuple, Dict, List, Any, Optional, Set, Union, Type, FrozenSet
 
 # 依赖类型
 import types
@@ -48,7 +49,7 @@ from .raiserr import raiserr
 from .logger import logger
 from .db import env
 from .mods import mods
-from .adapter import adapter, BaseAdapter, SendDSL
+from .adapter import adapter, AdapterFather, SendDSL
 
 # 这里不能删，确保windows下的shell能正确显示颜色
 os.system('')
@@ -58,12 +59,13 @@ sdk = types.SimpleNamespace()
 BaseModules = {
     "util"          : util,
     "logger"        : logger,
+    "raiserr"       : raiserr,
     "env"           : env,
     "mods"          : mods,
     "adapter"       : adapter,
-    "SendDSL"       : SendDSL,      # 链式发送基类 - 兼容原 sdk.SendDSL | 待弃用, 需要在 Adapter继承类中手动创建嵌套类并集成 super().SendDSL()
-    "AdapterFather" : BaseAdapter,
-    "BaseAdapter"   : BaseAdapter
+    "SendDSL"       : SendDSL,          # 链式发送基类 - 兼容原 sdk.SendDSL | 待弃用, 需要在 Adapter继承类中手动创建嵌套类并集成 super().SendDSL()
+    "AdapterFather" : AdapterFather,
+    "BaseAdapter"   : AdapterFather
 }
 
 BaseErrors = {
@@ -87,7 +89,7 @@ for error, doc in BaseErrors.items():
         raiserr.register(error, doc=doc)
     except Exception as e:
         raise e
-def init_progress():
+def init_progress() -> Tuple[bool, bool]:
     from pathlib import Path
     env_file = Path("env.py")
     main_file = Path("main.py")
@@ -149,7 +151,6 @@ if __name__ == "__main__":
         return False
 
 def _prepare_environment() -> bool:
-    # 检查环境
     logger.info("[Init] 准备初始化环境...")
     try:
         env_init, main_init = init_progress()
@@ -166,7 +167,8 @@ def _prepare_environment() -> bool:
     except Exception as e:
         logger.error(f"环境准备失败: {e}")
         return False
-def _scan_modules(module_path: str) -> tuple[dict, list, list]:
+def _scan_modules(module_path: str) -> Tuple[Dict, List, List]:
+
     # 扫描并验证模块
     module_objs = {}
     enabled_modules = []
@@ -219,7 +221,7 @@ def _validate_module(moduleObj, module_name: str) -> bool:
         return False
     return True
 
-def _check_dependencies(moduleObj, module_name: str, available_modules: list):
+def _check_dependencies(moduleObj, module_name: str, available_modules: list) -> None:
     # 检查模块依赖关系
     required_deps = moduleObj.moduleInfo.get("dependencies", {}).get("requires", [])
     if missing := [dep for dep in required_deps if dep not in available_modules]:
@@ -313,4 +315,4 @@ def init() -> bool:
         raiserr.InitError(f"sdk初始化失败: {e}", exit=True)
         return False
 
-sdk.init = init
+sdk.init = init

ErisPulse/__main__.py

@@ -203,7 +203,7 @@ class Shell_Printer:
             print(f"{cls.YELLOW}请输入 'y' 或 'n'{cls.RESET}")
 
     @classmethod
-    def ask(cls, msg, choices=None, default=None) -> str | None:
+    def ask(cls, msg, choices=None, default="") -> str:
         prompt = f"{cls.BOLD}{msg}{cls.RESET}"
         if choices:
             prompt += f" ({cls.CYAN}{'/'.join(choices)}{cls.RESET})"
@@ -909,11 +909,56 @@ def upgrade_all_modules(force=False):
             
     for i, update in enumerate(updates_available, 1):
         print(f"\n{Shell_Printer.BOLD}[{i}/{len(updates_available)}]{Shell_Printer.RESET} 更新模块 {Shell_Printer.BOLD}{update['name']}{Shell_Printer.RESET}")
+        
+        # 检查新版本的依赖
+        module_key = f"{update['name']}@{update['provider']}"
+        new_module_info = modules_data[module_key]
+        new_dependencies = new_module_info.get('dependencies', {}).get('requires', [])
+        
+        # 检查缺失的依赖
+        missing_deps = []
+        for dep in new_dependencies:
+            if dep not in all_modules or not all_modules[dep].get('status', True):
+                missing_deps.append(dep)
+                
+        if missing_deps:
+            shellprint.panel(
+                f"模块 {update['name']} 需要以下依赖:\n{Shell_Printer.YELLOW}{', '.join(missing_deps)}{Shell_Printer.RESET}",
+                "缺失依赖",
+                "warning"
+            )
+            if not shellprint.confirm("是否安装这些依赖？", default=True):
+                print(f"{Shell_Printer.BLUE}跳过模块 {update['name']} 的更新{Shell_Printer.RESET}")
+                continue
+                
+            for dep in missing_deps:
+                print(f"\n{Shell_Printer.BOLD}安装依赖: {dep}{Shell_Printer.RESET}")
+                install_module(dep)
+        
         module_url = update['url'] + update['path']
         script_dir = os.path.dirname(os.path.abspath(__file__))
         module_dir = os.path.join(script_dir, 'modules', update['name'])
         zip_path = os.path.join(script_dir, f"{update['name']}.zip")
         
+        # 检查新版本的pip依赖
+        new_pip_deps = new_module_info.get('dependencies', {}).get('pip', [])
+        current_pip_deps = all_modules[update['name']].get('info', {}).get('dependencies', {}).get('pip', [])
+        added_pip_deps = [dep for dep in new_pip_deps if dep not in current_pip_deps]
+        
+        if added_pip_deps:
+            shellprint.panel(
+                f"模块 {update['name']} 需要以下新的pip依赖:\n{Shell_Printer.YELLOW}{', '.join(added_pip_deps)}{Shell_Printer.RESET}",
+                "新增pip依赖",
+                "warning"
+            )
+            if not shellprint.confirm("是否安装这些pip依赖？", default=True):
+                print(f"{Shell_Printer.BLUE}跳过模块 {update['name']} 的更新{Shell_Printer.RESET}")
+                continue
+                
+            if not install_pip_dependencies(added_pip_deps):
+                print(f"{Shell_Printer.RED}无法安装模块 {update['name']} 的pip依赖，更新终止{Shell_Printer.RESET}")
+                continue
+
         if not extract_and_setup_module(
             module_name=update['name'],
             module_url=module_url,
@@ -922,7 +967,12 @@ def upgrade_all_modules(force=False):
         ):
             continue
             
+        # 更新模块信息，包括新的依赖
         all_modules[update['name']]['info']['version'] = update['remote_version']
+        all_modules[update['name']]['info']['dependencies'] = {
+            'requires': new_dependencies,
+            'pip': new_pip_deps
+        }
         mods.set_all_modules(all_modules)
         print(f"{Shell_Printer.GREEN}模块 {update['name']} 已更新至版本 {update['remote_version']}{Shell_Printer.RESET}")
         
@@ -1264,4 +1314,4 @@ def main():
         parser.print_help()
 
 if __name__ == "__main__":
-    main()
+    main()

ErisPulse/adapter.py

@@ -8,7 +8,7 @@
 ### 适配器基类 (BaseAdapter)
 适配器基类提供了与外部平台交互的标准接口。
 
-#### call_api(endpoint: str, **params) -> Any
+#### call_api(endpoint: str, **params: Any) -> Any
 调用平台API的抽象方法。
 - 参数:
   - endpoint: API端点
@@ -21,7 +21,7 @@
 - 示例:
 ```python
 class MyPlatformAdapter(BaseAdapter):
-    async def call_api(self, endpoint: str, **params):
+    async def call_api(self, endpoint: str, **params: Any) -> Any:
         if endpoint == "/send":
             return await self._send_message(params)
         elif endpoint == "/upload":
@@ -40,7 +40,7 @@ class MyPlatformAdapter(BaseAdapter):
 - 示例:
 ```python
 class MyPlatformAdapter(BaseAdapter):
-    async def start(self):
+    async def start(self) -> None:
         self.client = await self._create_client()
         self.ws = await self.client.create_websocket()
         self._start_heartbeat()
@@ -57,34 +57,34 @@ class MyPlatformAdapter(BaseAdapter):
 - 示例:
 ```python
 class MyPlatformAdapter(BaseAdapter):
-    async def shutdown(self):
+    async def shutdown(self) -> None:
         if self.ws:
             await self.ws.close()
         if self.client:
             await self.client.close()
 ```
 
-#### on(event_type: str = "*") -> Callable
+#### on(event_type: str = "*") -> Callable[[Callable[..., Any]], Callable[..., Any]]
 事件监听装饰器。
 - 参数:
   - event_type: 事件类型，默认"*"表示所有事件
 - 返回:
-  - Callable: 装饰器函数
+  - Callable[[Callable[..., Any]], Callable[..., Any]]: 装饰器函数
 - 示例:
 ```python
 adapter = MyPlatformAdapter()
 
 @adapter.on("message")
-async def handle_message(data):
+async def handle_message(data: Any) -> None:
     print(f"收到消息: {data}")
 
 @adapter.on("error")
-async def handle_error(error):
+async def handle_error(error: Exception) -> None:
     print(f"发生错误: {error}")
 
 # 处理所有事件
 @adapter.on()
-async def handle_all(event):
+async def handle_all(event: Any) -> None:
     print(f"事件: {event}")
 ```
 
@@ -98,7 +98,7 @@ async def handle_all(event):
 - 示例:
 ```python
 class MyPlatformAdapter(BaseAdapter):
-    async def _handle_websocket_message(self, message):
+    async def _handle_websocket_message(self, message: Any) -> None:
         # 处理消息并触发相应事件
         if message.type == "chat":
             await self.emit("message", {
@@ -108,23 +108,23 @@ class MyPlatformAdapter(BaseAdapter):
             })
 ```
 
-#### middleware(func: Callable) -> Callable
+#### middleware(func: Callable[..., Any]) -> Callable[..., Any]
 添加中间件处理器。
 - 参数:
   - func: 中间件函数
 - 返回:
-  - Callable: 中间件函数
+  - Callable[..., Any]: 中间件函数
 - 示例:
 ```python
 adapter = MyPlatformAdapter()
 
 @adapter.middleware
-async def log_middleware(data):
+async def log_middleware(data: Any) -> Any:
     print(f"处理数据: {data}")
     return data
 
 @adapter.middleware
-async def filter_middleware(data):
+async def filter_middleware(data: Any) -> Optional[Any]:
     if "spam" in data.get("content", ""):
         return None
     return data
@@ -133,7 +133,7 @@ async def filter_middleware(data):
 ### 消息发送DSL (SendDSL)
 提供链式调用风格的消息发送接口。
 
-#### To(target_type: str = None, target_id: str = None) -> 'SendDSL'
+#### To(target_type: Optional[str] = None, target_id: Optional[str] = None) -> 'SendDSL'
 设置消息目标。
 - 参数:
   - target_type: 目标类型（可选）
@@ -152,12 +152,12 @@ sdk.adapter.Platform.Send.To("group", "456").Text("Hello Group")
 sdk.adapter.Platform.Send.To("123").Text("Hello")
 ```
 
-#### Text(text: str) -> Task
+#### Text(text: str) -> asyncio.Task
 发送文本消息。
 - 参数:
   - text: 文本内容
 - 返回:
-  - Task: 异步任务
+  - asyncio.Task: 异步任务
 - 示例:
 ```python
 # 发送简单文本
@@ -192,7 +192,7 @@ for name, adapter in adapters.items():
     sdk.adapter.register(name, adapter)
 ```
 
-#### startup(platforms: List[str] = None) -> None
+#### startup(platforms: Optional[List[str]] = None) -> None
 启动指定的适配器。
 - 参数:
   - platforms: 要启动的平台列表，None表示所有平台
@@ -226,7 +226,10 @@ atexit.register(lambda: asyncio.run(sdk.adapter.shutdown()))
 
 import functools
 import asyncio
-from typing import Callable, Any, Dict, List, Type, Optional, Set
+from typing import (
+    Callable, Any, Dict, List, Type, Optional, Set, 
+    Union, Awaitable, TypeVar, Generic, Tuple, Coroutine, FrozenSet
+)
 from collections import defaultdict
 
 
@@ -457,6 +460,6 @@ class AdapterManager:
     def platforms(self) -> list:
         return list(self._adapters.keys())
 
-
+AdapterFather = BaseAdapter
 adapter = AdapterManager()
 SendDSL = SendDSLBase

ErisPulse/db.py

@@ -436,6 +436,7 @@ import threading
 from pathlib import Path
 from datetime import datetime
 from functools import lru_cache
+from typing import List, Dict, Optional, Any, Set, Tuple, Union, Type, FrozenSet
 from .raiserr import raiserr
 
 class EnvManager:
@@ -479,7 +480,7 @@ class EnvManager:
         self._last_snapshot_time = time.time()  # 初始化为当前时间
         self._snapshot_interval = 3600  # 默认每小时自动快照
 
-    def get(self, key, default=None):
+    def get(self, key, default=None) -> Any:
         try:
             with sqlite3.connect(self.db_path) as conn:
                 cursor = conn.cursor()
@@ -505,55 +506,65 @@ class EnvManager:
             cursor.execute("SELECT key FROM config")
             return [row[0] for row in cursor.fetchall()]
 
-    def set(self, key, value):
-        serialized_value = json.dumps(value) if isinstance(value, (dict, list)) else str(value)
-        with self.transaction():
-            conn = sqlite3.connect(self.db_path)
-            cursor = conn.cursor()
-            cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", (key, serialized_value))
-            conn.commit()
-            conn.close()
-        
-        self._check_auto_snapshot()
-        return True
+    def set(self, key, value) -> bool:
+        try:
+            serialized_value = json.dumps(value) if isinstance(value, (dict, list)) else str(value)
+            with self.transaction():
+                conn = sqlite3.connect(self.db_path)
+                cursor = conn.cursor()
+                cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", (key, serialized_value))
+                conn.commit()
+                conn.close()
+            
+            self._check_auto_snapshot()
+            return True
+        except Exception as e:
+            return False
 
     def set_multi(self, items):
-        with self.transaction():
-            conn = sqlite3.connect(self.db_path)
-            cursor = conn.cursor()
-            for key, value in items.items():
-                serialized_value = json.dumps(value) if isinstance(value, (dict, list)) else str(value)
-                cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", 
-                    (key, serialized_value))
-            conn.commit()
-            conn.close()
-        
-        self._check_auto_snapshot()
-        return True
-
-    def delete(self, key):
-        with self.transaction():
-            conn = sqlite3.connect(self.db_path)
-            cursor = conn.cursor()
-            cursor.execute("DELETE FROM config WHERE key = ?", (key,))
-            conn.commit()
-            conn.close()
-        
-        self._check_auto_snapshot()
-        return True
-
-    def delete_multi(self, keys):
-        with self.transaction():
-            conn = sqlite3.connect(self.db_path)
-            cursor = conn.cursor()
-            cursor.executemany("DELETE FROM config WHERE key = ?", [(k,) for k in keys])
-            conn.commit()
-            conn.close()
-        
-        self._check_auto_snapshot()
-        return True
+        try:
+            with self.transaction():
+                conn = sqlite3.connect(self.db_path)
+                cursor = conn.cursor()
+                for key, value in items.items():
+                    serialized_value = json.dumps(value) if isinstance(value, (dict, list)) else str(value)
+                    cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", 
+                        (key, serialized_value))
+                conn.commit()
+                conn.close()
+            
+            self._check_auto_snapshot()
+            return True
+        except Exception as e:
+            return False
 
-    def get_multi(self, keys):
+    def delete(self, key) -> bool:
+        try:
+            with self.transaction():
+                conn = sqlite3.connect(self.db_path)
+                cursor = conn.cursor()
+                cursor.execute("DELETE FROM config WHERE key = ?", (key,))
+                conn.commit()
+                conn.close()
+            
+            self._check_auto_snapshot()
+            return True
+        except Exception as e:
+            return False
+    def delete_multi(self, keys) -> bool:
+        try:
+            with self.transaction():
+                conn = sqlite3.connect(self.db_path)
+                cursor = conn.cursor()
+                cursor.executemany("DELETE FROM config WHERE key = ?", [(k,) for k in keys])
+                conn.commit()
+                conn.close()
+            
+            self._check_auto_snapshot()
+            return True
+        except Exception as e:
+            return False
+    def get_multi(self, keys) -> dict:
         conn = sqlite3.connect(self.db_path)
         cursor = conn.cursor()
         placeholders = ','.join(['?'] * len(keys))
@@ -630,22 +641,29 @@ class EnvManager:
     def set_snapshot_interval(self, seconds):
         self._snapshot_interval = seconds
 
-    def clear(self):
-        conn = sqlite3.connect(self.db_path)
-        cursor = conn.cursor()
-        cursor.execute("DELETE FROM config")
-        conn.commit()
-        conn.close()
-
-    def load_env_file(self):
-        env_file = Path("env.py")
-        if env_file.exists():
-            spec = importlib.util.spec_from_file_location("env_module", env_file)
-            env_module = importlib.util.module_from_spec(spec)
-            spec.loader.exec_module(env_module)
-            for key, value in vars(env_module).items():
-                if not key.startswith("__") and isinstance(value, (dict, list, str, int, float, bool)):
-                    self.set(key, value)
+    def clear(self) -> bool:
+        try:
+            conn = sqlite3.connect(self.db_path)
+            cursor = conn.cursor()
+            cursor.execute("DELETE FROM config")
+            conn.commit()
+            conn.close()
+            return True
+        except Exception as e:
+            return False
+    def load_env_file(self) -> bool:
+        try:
+            env_file = Path("env.py")
+            if env_file.exists():
+                spec = importlib.util.spec_from_file_location("env_module", env_file)
+                env_module = importlib.util.module_from_spec(spec)
+                spec.loader.exec_module(env_module)
+                for key, value in vars(env_module).items():
+                    if not key.startswith("__") and isinstance(value, (dict, list, str, int, float, bool)):
+                        self.set(key, value)
+            return True
+        except Exception as e:
+            return False
     def __getattr__(self, key):
         try:
             return self.get(key)
@@ -660,7 +678,7 @@ class EnvManager:
             from .logger import logger
             logger.error(f"设置配置项 {key} 失败: {e}")
 
-    def snapshot(self, name=None):
+    def snapshot(self, name=None) -> str:
         if not name:
             name = datetime.now().strftime("%Y%m%d_%H%M%S")
         snapshot_path = os.path.join(self.SNAPSHOT_DIR, f"{name}.db")
@@ -687,7 +705,7 @@ class EnvManager:
             logger.error(f"创建快照失败: {e}")
             raise
 
-    def restore(self, snapshot_name):
+    def restore(self, snapshot_name) -> bool:
         snapshot_path = os.path.join(self.SNAPSHOT_DIR, f"{snapshot_name}.db") \
             if not snapshot_name.endswith('.db') else snapshot_name
             
@@ -716,7 +734,7 @@ class EnvManager:
             logger.error(f"恢复快照失败: {e}")
             return False
 
-    def list_snapshots(self):
+    def list_snapshots(self) -> list:
         snapshots = []
         for f in os.listdir(self.SNAPSHOT_DIR):
             if f.endswith('.db'):
@@ -729,7 +747,7 @@ class EnvManager:
                 ))
         return sorted(snapshots, key=lambda x: x[1], reverse=True)
 
-    def delete_snapshot(self, snapshot_name):
+    def delete_snapshot(self, snapshot_name) -> bool:
         snapshot_path = os.path.join(self.SNAPSHOT_DIR, f"{snapshot_name}.db") \
             if not snapshot_name.endswith('.db') else snapshot_name
             

ErisPulse/logger.py

@@ -10,7 +10,7 @@
 以debug为例：
 > 此外，还有其他级别的日志记录函数，如info, warning, error, critical等，用法相同。
 
-debug(msg: str, *args, **kwargs) -> None
+debug(msg: str, *args: Any, **kwargs: Any) -> None
 
 记录调试级别的日志信息。
 - 参数:
@@ -70,7 +70,7 @@ for module, level in config.get("logging", {}).items():
 ```
 
 ### 日志存储和输出
-#### set_output_file(path: str | list) -> None
+#### set_output_file(path: Union[str, List[str]]) -> None
 设置日志输出文件。
 - 参数:
   - path: 日志文件路径，可以是单个字符串或路径列表
@@ -92,7 +92,7 @@ log_file = f"logs/app_{datetime.now().strftime('%Y%m%d')}.log"
 sdk.logger.set_output_file(log_file)
 ```
 
-#### save_logs(path: str | list) -> None
+#### save_logs(path: Union[str, List[str]]) -> None
 保存内存中的日志到文件。
 - 参数:
   - path: 保存路径，可以是单个字符串或路径列表
@@ -118,6 +118,7 @@ atexit.register(lambda: sdk.logger.save_logs("final_logs.txt"))
 import logging
 import inspect
 import datetime
+from typing import List, Dict, Any, Optional, Union, Type, Set, Tuple, FrozenSet
 
 class Logger:
     def __init__(self):
@@ -131,10 +132,16 @@ class Logger:
             console_handler.setFormatter(logging.Formatter("%(message)s"))
             self._logger.addHandler(console_handler)
 
-    def set_level(self, level: str):
-        level = level.upper()
-        if hasattr(logging, level):
-            self._logger.setLevel(getattr(logging, level))
+    def set_level(self, level: str) -> bool:
+        try:
+            level = level.upper()
+            if hasattr(logging, level):
+                self._logger.setLevel(getattr(logging, level))
+                return True
+            return False
+        except Exception as e:
+            self._logger.error(f"无效的日志等级: {level}")
+            return False
 
     def set_module_level(self, module_name: str, level: str) -> bool:
         from .db import env
@@ -150,7 +157,7 @@ class Logger:
             self._logger.error(f"无效的日志等级: {level}")
             return False
 
-    def set_output_file(self, path: str | list):
+    def set_output_file(self, path) -> bool:
         if self._file_handler:
             self._logger.removeHandler(self._file_handler)
             self._file_handler.close()
@@ -164,17 +171,17 @@ class Logger:
                 file_handler.setFormatter(logging.Formatter("%(message)s"))
                 self._logger.addHandler(file_handler)
                 self._logger.info(f"日志输出已设置到文件: {p}")
+                return True
             except Exception as e:
                 self._logger.error(f"无法设置日志文件 {p}: {e}")
-                raise e
-
-    def save_logs(self, path: str | list):
+                return False
+    def save_logs(self, path) -> bool:
         if self._logs == None:
             self._logger.warning("没有log记录可供保存。")
-            return
+            return False
         if isinstance(path, str):
             path = [path]
-
+        
         for p in path:
             try:
                 with open(p, "w", encoding="utf-8") as file:
@@ -183,10 +190,16 @@ class Logger:
                         for log in logs:
                             file.write(f"  {log}\n")
                     self._logger.info(f"日志已被保存到：{p}。")
+                    return True
             except Exception as e:
                 self._logger.error(f"无法保存日志到 {p}: {e}。")
-                raise e
+                return False
 
+    def get_logs(self, module_name: str = None) -> dict:
+        if module_name:
+            return {module_name: self._logs.get(module_name, [])}
+        return {k: v.copy() for k, v in self._logs.items()}
+    
     def _save_in_memory(self, ModuleName, msg):
         if ModuleName not in self._logs:
             self._logs[ModuleName] = []

ErisPulse/mods.py

@@ -81,7 +81,7 @@ module_info["info"]["meta"]["version"] = "1.1.0"
 sdk.mods.set_module("MyModule", module_info)
 ```
 
-#### get_module(module_name: str) -> dict | None
+#### get_module(module_name: str) -> dict
 获取模块信息。
 - 参数:
   - module_name: 模块名称
@@ -253,7 +253,7 @@ sdk.env.set(custom_status_key, is_active)
 """
 
 import json
-from typing import Dict, Optional
+from typing import Dict, Optional, Any, List, Set, Tuple, Union, Type, FrozenSet
 
 class ModuleManager:
     DEFAULT_MODULE_PREFIX = "erispulse.module.data:"

ErisPulse/raiserr.py

@@ -25,12 +25,12 @@ class CustomBase(Exception):
 sdk.raiserr.register("AdvancedError", "高级错误", CustomBase)
 ```
 
-#### info(name: str = None) -> dict | None
+#### info(name: str = None) -> Dict[str, Any] | None
 获取错误类型信息。
 - 参数:
   - name: 错误类型名称，如果为None则返回所有错误类型信息
 - 返回:
-  - dict: 包含错误类型信息的字典，包括类型名、文档和类引用
+  - Dict[str, Any]: 包含错误类型信息的字典，包括类型名、文档和类引用
   - None: 如果指定的错误类型不存在
 - 示例:
 ```python
@@ -71,12 +71,13 @@ except Exception as e:
 import sys
 import traceback
 import asyncio
+from typing import Dict, Any, Optional, Type, List, Set, Tuple, Union
 
 class Error:
     def __init__(self):
         self._types = {}
 
-    def register(self, name, doc="", base=Exception):
+    def register(self, name, doc="", base=Exception) -> Type:
         if name not in self._types:
             err_cls = type(name, (base,), {"__doc__": doc})
             self._types[name] = err_cls
@@ -98,7 +99,7 @@ class Error:
                 raise exc
         return raiser
 
-    def info(self, name: str = None):
+    def info(self, name: str = None) -> Dict[str, Any] | None:
         result = {}
         for err_name, err_cls in self._types.items():
             result[err_name] = {

ErisPulse/util.py

@@ -5,8 +5,8 @@
 
 ## API 文档
 ### 拓扑排序：
-    - topological_sort(elements, dependencies, error): 拓扑排序依赖关系
-    - show_topology(): 可视化模块依赖关系
+    - topological_sort(elements: List[str], dependencies: Dict[str, List[str]], error: Type[Exception]) -> List[str]: 拓扑排序依赖关系
+    - show_topology() -> str: 可视化模块依赖关系
 
 ### 装饰器：
     - @cache: 缓存函数结果
@@ -14,7 +14,7 @@
     - @retry(max_attempts=3, delay=1): 失败自动重试
 
 ### 异步执行：
-    - ExecAsync(async_func, *args, **kwargs): 异步执行函数
+    - ExecAsync(async_func: Callable, *args: Any, **kwargs: Any) -> Any: 异步执行函数
 
 ### 示例用法：
 
@@ -48,10 +48,11 @@ import functools
 import traceback
 from concurrent.futures import ThreadPoolExecutor
 from collections import defaultdict, deque
+from typing import List, Dict, Type, Callable, Any, Optional, Set
 
 executor = ThreadPoolExecutor()
 
-def topological_sort(elements, dependencies, error):
+def topological_sort(elements, dependencies, error) -> List[str]:
     graph = defaultdict(list)
     in_degree = {element: 0 for element in elements}
     for element, deps in dependencies.items():
@@ -72,7 +73,7 @@ def topological_sort(elements, dependencies, error):
         sdk.logger.error(f"依赖导入错误: {elements} vs  {sorted_list} | 发生了循环依赖")
     return sorted_list
 
-def show_topology():
+def show_topology() -> str:
     from . import sdk
     dep_data = sdk.env.get('module_dependencies')
     if not dep_data:
@@ -98,7 +99,7 @@ def show_topology():
     
     return "\n".join(result)
 
-def ExecAsync(async_func, *args, **kwargs):
+def ExecAsync(async_func, *args, **kwargs) -> Any:
     loop = asyncio.get_event_loop()
     return loop.run_in_executor(executor, lambda: asyncio.run(async_func(*args, **kwargs)))
 

{erispulse-1.2.3.dist-info → erispulse-1.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 1.2.3
+Version: 1.2.6
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 License: MIT License
@@ -38,11 +38,13 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
+Requires-Python: >=3.8
 Requires-Dist: aiohttp
 Requires-Dist: importlib>=1.0.4
 Requires-Dist: pip
@@ -54,7 +56,6 @@ Description-Content-Type: text/markdown
 ![ErisPulse Logo](.github/assets/erispulse_logo.png)
 
 [![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
-[![License](https://img.shields.io/github/license/ErisPulse/ErisPulse?style=flat-square)](https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE)
 [![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
 
 > 文档站: 
@@ -203,4 +204,4 @@ epsdk run your_script.py --reload
 
 ---
 
-[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)
+[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)

erispulse-1.2.6.dist-info/RECORD

@@ -0,0 +1,13 @@
+ErisPulse/__init__.py,sha256=2hEVWxKaDfFGAe3ekpUFx5tIub2riwDtSscsfpA0T2w,11108
+ErisPulse/__main__.py,sha256=MQ_npNFErw5m8My092apQ4gyZAL-7VPLL9Wc7HTq4f4,56451
+ErisPulse/adapter.py,sha256=sho8HMYVSa3syovU2mDxV2Wsw99yD5_sFz6UER89Tes,14367
+ErisPulse/db.py,sha256=mSLLxjqOxSwvMbBSYCpH9TvCvdfccWrKJx6GtkhAl8U,23881
+ErisPulse/logger.py,sha256=ftXp4bfk0S5cnkK4wmF5WqhvuzpUL4MXsuJa-ZTBoMs,8760
+ErisPulse/mods.py,sha256=2OgueJPetQ5N1uDr5DiFvDZ4zF1HSuZ4OsL8IFDqro8,9976
+ErisPulse/raiserr.py,sha256=6txXLfHmC9hb-HI1mbSMxaz1H0T4dfXGSrENRZ06AVg,4081
+ErisPulse/util.py,sha256=eXtmW39bCjbV8lxOmOro4b4gyBhKo-db_EeffJ9BDf0,4525
+erispulse-1.2.6.dist-info/METADATA,sha256=mc8HWywQBC_Safrt-F97Ggboxv_3Nd2hKM7vbe_R_0g,6728
+erispulse-1.2.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+erispulse-1.2.6.dist-info/entry_points.txt,sha256=y8ppdsQhk-azC7_ikQgRr4rITSZ4VC4crVKtzHh4TBY,146
+erispulse-1.2.6.dist-info/licenses/LICENSE,sha256=qAe8UGD2uYa8mUPqffBkdIS_4Q5d66FlhYuo3eC_Dq8,1396
+erispulse-1.2.6.dist-info/RECORD,,

erispulse-1.2.3.dist-info/RECORD

@@ -1,13 +0,0 @@
-ErisPulse/__init__.py,sha256=fFHqjboYUJGRiqjQlowqaBMj5E6qdfpbVWUzA06IMCY,10976
-ErisPulse/__main__.py,sha256=lFhd9Dn93G6z4ZjZJMEZDIBndy9J3msjdbzijDFrQfY,54056
-ErisPulse/adapter.py,sha256=rrBdPSHvOzzN0VJCD8lThygM9I-_iQIeZ5iMgqCJ34w,13977
-ErisPulse/db.py,sha256=LSIw6MpNtZ-P3deARLj8Umo06EBrwyuzhF4Nj1Lkbyc,23043
-ErisPulse/logger.py,sha256=UfQBF9fLx4WKe_se_lB5jNvaeTDtpv5PKT9x49QMmyw,8152
-ErisPulse/mods.py,sha256=1vEFiuL61Ouu7cocyysev5k2lGqcJ_hJGZqXNNbhJqg,9936
-ErisPulse/raiserr.py,sha256=QeKffL8Gm4Vl1DDMFQiKluiKCx0mxgN2Jj98WP4tUHo,3958
-ErisPulse/util.py,sha256=tmmZA4Ef5ElB01KZg2fTZLrkZOJbORjnkAd8sXj7xqw,4335
-erispulse-1.2.3.dist-info/METADATA,sha256=0aAnbImoFDRDumggAbPyHfoY4uPPNOl4fG2W1BBZ6vQ,6776
-erispulse-1.2.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-erispulse-1.2.3.dist-info/entry_points.txt,sha256=y8ppdsQhk-azC7_ikQgRr4rITSZ4VC4crVKtzHh4TBY,146
-erispulse-1.2.3.dist-info/licenses/LICENSE,sha256=qAe8UGD2uYa8mUPqffBkdIS_4Q5d66FlhYuo3eC_Dq8,1396
-erispulse-1.2.3.dist-info/RECORD,,