ErisPulse 2.1.4__tar.gz → 2.1.5__tar.gz

{erispulse-2.1.4 → erispulse-2.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.1.4
+Version: 2.1.5
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 License: MIT License

{erispulse-2.1.4 → erispulse-2.1.5}/docs/AIDocs/ErisPulse-AdapterDev.md

@@ -25,13 +25,12 @@
 | `mods`/`sdk.mods` | 模块管理器 |
 | `adapter`/`sdk.adapter` | 适配器管理/获取实例 |
 | `logger`/`sdk.logger` | 日志记录器 |
-| `raiserr`/`sdk.raiserr` | 错误管理器 |
 | `util`/`sdk.util` | 工具函数（缓存、重试等） |
 | `BaseAdapter`/`sdk.BaseAdapter` | 适配器基类 |
 
 ```python
 # 直接导入方式
-from ErisPulse.Core import env, mods, logger, raiserr, util, adapter, BaseAdapter
+from ErisPulse.Core import env, mods, logger, util, adapter, BaseAdapter
 
 # 通过SDK对象方式
 from ErisPulse import sdk
@@ -113,19 +112,7 @@ if module_config is None:
     env.setConfig("MyModule", {"MyKey": "MyValue"})  # 设置默认配置
 ```
 
-### 3. 错误管理(raiserr)
-```python
-# 注册自定义错误
-raiserr.register("MyCustomError", doc="自定义错误说明")
-
-# 获取错误信息
-error_info = raiserr.info("MyCustomError")
-
-# 抛出错误
-raiserr.MyCustomError("错误描述")
-```
-
-### 4. 工具函数(util)
+### 3. 工具函数(util)
 ```python
 # 自动重试
 @util.retry(max_attempts=3, delay=1)
@@ -575,7 +562,7 @@ class ErrorCode:
 - **合理使用事件循环**：确保异步函数正确地被 `await` 或调度为任务（`create_task`）。
 
 ### 2. 异常处理与日志记录
-- **统一异常处理机制**：结合 `raiserr` 注册自定义错误类型，提供清晰的错误信息。
+- **统一异常处理机制**：直接 `raise` 异常，上层会自动捕获并记录日志。
 - **详细的日志输出**：在关键路径上打印调试日志，便于问题排查。
 
 ### 3. 模块化与解耦设计
@@ -932,7 +919,7 @@ def generate_message_id(platform: str, raw_id: str) -> str:
 
 # 📦 `ErisPulse.__init__` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1263,13 +1250,13 @@ SDK初始化入口
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\__main__.md
 
 # 📦 `ErisPulse.__main__` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1458,13 +1445,13 @@ PyPI包管理器
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\adapter.md
 
 # 📦 `ErisPulse.Core.adapter` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1809,13 +1796,13 @@ OneBot12协议事件监听装饰器
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\env.md
 
 # 📦 `ErisPulse.Core.env` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -2101,13 +2088,13 @@ ErisPulse 环境配置模块
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\logger.md
 
 # 📦 `ErisPulse.Core.logger` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -2189,13 +2176,13 @@ ErisPulse 日志系统
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\mods.md
 
 # 📦 `ErisPulse.Core.mods` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -2378,13 +2365,13 @@ ErisPulse 模块管理器
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\raiserr.md
 
 # 📦 `ErisPulse.Core.raiserr` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -2392,13 +2379,13 @@ ErisPulse 模块管理器
 
 ErisPulse 错误管理系统
 
-提供错误类型注册、抛出和管理功能，集成全局异常处理。支持自定义错误类型、错误链追踪和全局异常捕获。
+提供全局异常捕获功能。不再推荐使用自定义错误注册功能。
 
 💡 **提示**：
 
-1. 使用register注册自定义错误类型
-2. 通过info获取错误信息
-3. 自动捕获未处理异常
+1. 请使用Python原生异常抛出方法
+2. 系统会自动捕获并格式化所有未处理异常
+3. 注册功能已标记为弃用，将在未来版本移除
 
 ---
 
@@ -2406,8 +2393,6 @@ ErisPulse 错误管理系统
 
 ### `global_exception_handler`
 
-⚠️ **内部方法**：
-
 全局异常处理器
 
 :param exc_type: 异常类型
@@ -2418,8 +2403,6 @@ ErisPulse 错误管理系统
 
 ### `async_exception_handler`
 
-⚠️ **内部方法**：
-
 异步异常处理器
 
 :param loop: 事件循环
@@ -2433,13 +2416,12 @@ ErisPulse 错误管理系统
 
 错误管理器
 
-提供错误类型注册和抛出功能
+⚠️ **已弃用**：请使用Python原生异常抛出方法 | 2025-07-18
 
 💡 **提示**：
 
-1. 通过register方法注册自定义错误类型
-2. 通过动态属性访问抛出错误
-3. 通过info方法获取错误信息
+1. 注册功能将在未来版本移除
+2. 请直接使用raise Exception("message")方式抛出异常
 
 
 #### 🧰 方法
@@ -2448,23 +2430,21 @@ ErisPulse 错误管理系统
 
 注册新的错误类型
 
+⚠️ **已弃用**：请使用Python原生异常抛出方法 | 2025-07-18
+
 :param name: 错误类型名称
 :param doc: 错误描述文档
 :param base: 基础异常类
 :return: 注册的错误类
 
-:example:
->>> # 注册简单错误
->>> raiserr.register("SimpleError", "简单的错误类型")
->>> # 注册自定义基类的错误
->>> raiserr.register("AdvancedError", "高级错误", CustomBaseError)
-
 ---
 
 ##### `__getattr__`
 
 动态获取错误抛出函数
 
+⚠️ **已弃用**：请使用Python原生异常抛出方法 | 2025-07-18
+
 :param name: 错误类型名称
 :return: 错误抛出函数
 
@@ -2476,25 +2456,21 @@ ErisPulse 错误管理系统
 
 获取错误信息
 
+⚠️ **已弃用**：此功能将在未来版本移除 | 2025-07-18
+
 :param name: 错误类型名称(可选)
 :return: 错误信息字典
 
-:example:
->>> # 获取特定错误信息
->>> error_info = raiserr.info("SimpleError")
->>> # 获取所有错误信息
->>> all_errors = raiserr.info()
-
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\server.md
 
 # 📦 `ErisPulse.Core.server` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -2615,13 +2591,13 @@ ErisPulse Adapter Server
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## ErisPulse\Core\util.md
 
 # 📦 `ErisPulse.Core.util` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -2715,6 +2691,6 @@ ErisPulse 工具函数集合
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 <!--- End of API文档 -->

{erispulse-2.1.4 → erispulse-2.1.5}/docs/AIDocs/ErisPulse-Core.md

@@ -117,13 +117,12 @@ epsdk run main.py --reload
 | `mods`/`sdk.mods` | 模块管理器 |
 | `adapter`/`sdk.adapter` | 适配器管理/获取实例 |
 | `logger`/`sdk.logger` | 日志记录器 |
-| `raiserr`/`sdk.raiserr` | 错误管理器 |
 | `util`/`sdk.util` | 工具函数（缓存、重试等） |
 | `BaseAdapter`/`sdk.BaseAdapter` | 适配器基类 |
 
 ```python
 # 直接导入方式
-from ErisPulse.Core import env, mods, logger, raiserr, util, adapter, BaseAdapter
+from ErisPulse.Core import env, mods, logger, util, adapter, BaseAdapter
 
 # 通过SDK对象方式
 from ErisPulse import sdk
@@ -205,19 +204,7 @@ if module_config is None:
     env.setConfig("MyModule", {"MyKey": "MyValue"})  # 设置默认配置
 ```
 
-### 3. 错误管理(raiserr)
-```python
-# 注册自定义错误
-raiserr.register("MyCustomError", doc="自定义错误说明")
-
-# 获取错误信息
-error_info = raiserr.info("MyCustomError")
-
-# 抛出错误
-raiserr.MyCustomError("错误描述")
-```
-
-### 4. 工具函数(util)
+### 3. 工具函数(util)
 ```python
 # 自动重试
 @util.retry(max_attempts=3, delay=1)
@@ -734,7 +721,7 @@ ErisPulse 项目：
 
 # 📦 `ErisPulse.Core.adapter` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1079,13 +1066,13 @@ OneBot12协议事件监听装饰器
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## env.md
 
 # 📦 `ErisPulse.Core.env` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1371,13 +1358,13 @@ ErisPulse 环境配置模块
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## logger.md
 
 # 📦 `ErisPulse.Core.logger` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1459,13 +1446,13 @@ ErisPulse 日志系统
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## mods.md
 
 # 📦 `ErisPulse.Core.mods` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1648,13 +1635,13 @@ ErisPulse 模块管理器
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## raiserr.md
 
 # 📦 `ErisPulse.Core.raiserr` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1662,13 +1649,13 @@ ErisPulse 模块管理器
 
 ErisPulse 错误管理系统
 
-提供错误类型注册、抛出和管理功能，集成全局异常处理。支持自定义错误类型、错误链追踪和全局异常捕获。
+提供全局异常捕获功能。不再推荐使用自定义错误注册功能。
 
 💡 **提示**：
 
-1. 使用register注册自定义错误类型
-2. 通过info获取错误信息
-3. 自动捕获未处理异常
+1. 请使用Python原生异常抛出方法
+2. 系统会自动捕获并格式化所有未处理异常
+3. 注册功能已标记为弃用，将在未来版本移除
 
 ---
 
@@ -1676,8 +1663,6 @@ ErisPulse 错误管理系统
 
 ### `global_exception_handler`
 
-⚠️ **内部方法**：
-
 全局异常处理器
 
 :param exc_type: 异常类型
@@ -1688,8 +1673,6 @@ ErisPulse 错误管理系统
 
 ### `async_exception_handler`
 
-⚠️ **内部方法**：
-
 异步异常处理器
 
 :param loop: 事件循环
@@ -1703,13 +1686,12 @@ ErisPulse 错误管理系统
 
 错误管理器
 
-提供错误类型注册和抛出功能
+⚠️ **已弃用**：请使用Python原生异常抛出方法 | 2025-07-18
 
 💡 **提示**：
 
-1. 通过register方法注册自定义错误类型
-2. 通过动态属性访问抛出错误
-3. 通过info方法获取错误信息
+1. 注册功能将在未来版本移除
+2. 请直接使用raise Exception("message")方式抛出异常
 
 
 #### 🧰 方法
@@ -1718,23 +1700,21 @@ ErisPulse 错误管理系统
 
 注册新的错误类型
 
+⚠️ **已弃用**：请使用Python原生异常抛出方法 | 2025-07-18
+
 :param name: 错误类型名称
 :param doc: 错误描述文档
 :param base: 基础异常类
 :return: 注册的错误类
 
-:example:
->>> # 注册简单错误
->>> raiserr.register("SimpleError", "简单的错误类型")
->>> # 注册自定义基类的错误
->>> raiserr.register("AdvancedError", "高级错误", CustomBaseError)
-
 ---
 
 ##### `__getattr__`
 
 动态获取错误抛出函数
 
+⚠️ **已弃用**：请使用Python原生异常抛出方法 | 2025-07-18
+
 :param name: 错误类型名称
 :return: 错误抛出函数
 
@@ -1746,25 +1726,21 @@ ErisPulse 错误管理系统
 
 获取错误信息
 
+⚠️ **已弃用**：此功能将在未来版本移除 | 2025-07-18
+
 :param name: 错误类型名称(可选)
 :return: 错误信息字典
 
-:example:
->>> # 获取特定错误信息
->>> error_info = raiserr.info("SimpleError")
->>> # 获取所有错误信息
->>> all_errors = raiserr.info()
-
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## server.md
 
 # 📦 `ErisPulse.Core.server` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1885,13 +1861,13 @@ ErisPulse Adapter Server
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 ## util.md
 
 # 📦 `ErisPulse.Core.util` 模块
 
-*自动生成于 2025-07-17 16:57:03*
+*自动生成于 2025-07-18 21:45:18*
 
 ---
 
@@ -1985,6 +1961,6 @@ ErisPulse 工具函数集合
 ---
 
 
-*文档最后更新于 2025-07-17 16:57:03*
+*文档最后更新于 2025-07-18 21:45:18*
 
 <!--- End of API文档 -->