ErisPulse 1.1.15__tar.gz → 1.2.0__tar.gz

{erispulse-1.1.15 → erispulse-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 1.1.15
+Version: 1.2.0
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 License: MIT License
@@ -31,61 +31,68 @@ 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.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.9
+Requires-Python: >=3.10
 Requires-Dist: aiohttp
+Requires-Dist: importlib>=1.0.4
 Requires-Dist: watchdog
 Description-Content-Type: text/markdown
 
-![](./.github/assets/erispulse_logo.png)
-**ErisPulse** 是基于 [Framer](https://github.com/FramerOrg/Framer) 构建的异步机器人开发框架。
+# ErisPulse - 异步机器人开发框架
+
+![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/)
 
-> 文档站:
-
+> 文档站: 
 [![Docs-Main](https://img.shields.io/badge/docs-main_site-blue?style=flat-square)](https://www.erisdev.com/docs.html)
 [![Docs-CF Pages](https://img.shields.io/badge/docs-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/docs.html)
 [![Docs-GitHub](https://img.shields.io/badge/docs-github-blue?style=flat-square)](https://erispulse.github.io/docs.html)
 [![Docs-Netlify](https://img.shields.io/badge/docs-netlify-blue?style=flat-square)](https://erispulse.netlify.app/docs.htm)
 
-- [GitHub 社区讨论](https://github.com/ErisPulse/ErisPulse/discussions)
 
-### 框架选型指南
-| 需求          | 推荐框架       | 理由                          |
-|-------------------|----------------|-----------------------------|
-| 轻量化/底层模块化 | [Framer](https://github.com/FramerOrg/Framer) | 高度解耦的模块化设计          |
-| 全功能机器人开发  | ErisPulse      | 开箱即用的完整解决方案        |
+## 核心特性
 
-## ✨ 核心特性
-- ⚡ 完全异步架构设计（async/await）
-- 🧩 模块化插件系统
-- 🔁 支持python热重载
-- 🛑 统一的错误管理
-- 🛠️ 灵活的配置管理
+| 特性 | 描述 |
+|------|------|
+| **异步架构** | 完全基于 async/await 的异步设计 |
+| **模块化系统** | 灵活的插件和模块管理 |
+| **热重载** | 开发时自动重载，无需重启 |
+| **错误管理** | 统一的错误处理和报告系统 |
+| **配置管理** | 灵活的配置存储和访问 |
 
-## 📦 安装
+---
 
-```bash
-pip install ErisPulse --upgrade
-```
+## 快速开始
+
+### 框架选型指南
+
+| 需求 | 推荐框架 | 理由 |
+|------|---------|------|
+| 轻量化/底层模块化 | [Framer](https://github.com/FramerOrg/Framer) | 高度解耦的模块化设计 |
+| 全功能机器人开发 | ErisPulse | 开箱即用的完整解决方案 |
 
 ---
 
-## 开发者快速入门
+## 安装指南
+
+我们全面采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链，提供更快速可靠的安装体验。
+
+> ℹ️ **uv** 是由 Astral 开发的新一代 Python 包管理工具，比传统 pip 快 10-100 倍，并具有更好的依赖解析能力。
 
-ErisPulse SDK 支持使用 [`uv`](https://github.com/astral-sh/uv) 进行完整的开发环境管理。你可以**无需手动安装 Python**，直接通过 `uv` 下载 Python、创建虚拟环境并开始开发。
+### 1. 安装 uv
 
-### 安装 `uv`
+#### 通用方法 (pip):
+```bash
+pip install uv
+```
 
-#### macOS / Linux:
+#### macOS/Linux:
 ```bash
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
@@ -95,11 +102,24 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-验证是否安装成功：
+验证安装:
 ```bash
 uv --version
 ```
 
+### 2. 安装 ErisPulse
+
+```bash
+uv python install 3.12          # 安装 Python 3.12
+uv venv                         # 创建虚拟环境
+source .venv/bin/activate       # 激活环境 (Windows: .venv\Scripts\activate)
+uv pip install ErisPulse --upgrade  # 安装框架
+```
+
+---
+
+## 测试与开发
+
 ### 克隆项目并进入目录
 
 ```bash
@@ -107,18 +127,19 @@ git clone https://github.com/ErisPulse/ErisPulse.git
 cd ErisPulse
 ```
 
-### 使用 `uv` 自动下载 Python 并创建虚拟环境
+### 使用 `uv` 同步项目环境
 
 ```bash
-uv python install 3.12          # 自动下载并安装 Python 3.12
-uv venv                         # 创建默认 .venv 虚拟环境
-source .venv/bin/activate    
+uv sync
+
+# 启动虚拟环境
+source .venv/bin/activate   
 # Windows: .venv\Scripts\activate
 ```
 
-> ✅ 如果你切换分支或需要不同 Python 版本，只需替换 `3.12` 为其他版本即可。
+> `ErisPulse` 目前正在使用 `python3.13` 进行开发(所以您同步环境时会自动安装 `3.13`)，但也可以使用其他版本(版本不应低于 `3.10`)。
 
-### 安装依赖并开始开发
+### 安装依赖并开始
 
 ```bash
 uv pip install -e .
@@ -142,24 +163,36 @@ python -c "from ErisPulse import sdk; sdk.init()"
 uv run devs/test.py
 ```
 
-测试脚本提供以下功能：
-- 日志功能测试
-- 环境配置测试  
+测试功能包括:
+- 日志系统测试
+- 环境配置测试
 - 错误管理测试
 - 工具函数测试
 - 适配器功能测试
-- 版本信息查看
-
-### 开始开发
-
-你可以通过 CLI 工具进行模块调试、热重载开发等操作：
 
+### 开发模式 (热重载)
 ```bash
 epsdk run your_script.py --reload
 ```
 
 ---
 
-## 🤝 贡献
+## 🤝 贡献指南
+
+我们欢迎各种形式的贡献，包括但不限于:
+
+1. **报告问题**  
+   在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交bug报告
+
+2. **功能请求**  
+   通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
+
+3. **代码贡献**  
+   提交 Pull Request 前请阅读我们的 [开发指南](docs/DEVELOPMENT.md)
+
+4. **文档改进**  
+   帮助完善文档和示例代码
+
+---
 
-欢迎任何形式的贡献！无论是报告 bug、提出新功能请求，还是直接提交代码，都非常感谢。
+[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)

erispulse-1.2.0/README.md

@@ -0,0 +1,155 @@
+# ErisPulse - 异步机器人开发框架
+
+![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/)
+
+> 文档站: 
+[![Docs-Main](https://img.shields.io/badge/docs-main_site-blue?style=flat-square)](https://www.erisdev.com/docs.html)
+[![Docs-CF Pages](https://img.shields.io/badge/docs-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/docs.html)
+[![Docs-GitHub](https://img.shields.io/badge/docs-github-blue?style=flat-square)](https://erispulse.github.io/docs.html)
+[![Docs-Netlify](https://img.shields.io/badge/docs-netlify-blue?style=flat-square)](https://erispulse.netlify.app/docs.htm)
+
+
+## 核心特性
+
+| 特性 | 描述 |
+|------|------|
+| **异步架构** | 完全基于 async/await 的异步设计 |
+| **模块化系统** | 灵活的插件和模块管理 |
+| **热重载** | 开发时自动重载，无需重启 |
+| **错误管理** | 统一的错误处理和报告系统 |
+| **配置管理** | 灵活的配置存储和访问 |
+
+---
+
+## 快速开始
+
+### 框架选型指南
+
+| 需求 | 推荐框架 | 理由 |
+|------|---------|------|
+| 轻量化/底层模块化 | [Framer](https://github.com/FramerOrg/Framer) | 高度解耦的模块化设计 |
+| 全功能机器人开发 | ErisPulse | 开箱即用的完整解决方案 |
+
+---
+
+## 安装指南
+
+我们全面采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链，提供更快速可靠的安装体验。
+
+> ℹ️ **uv** 是由 Astral 开发的新一代 Python 包管理工具，比传统 pip 快 10-100 倍，并具有更好的依赖解析能力。
+
+### 1. 安装 uv
+
+#### 通用方法 (pip):
+```bash
+pip install uv
+```
+
+#### macOS/Linux:
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+#### Windows (PowerShell):
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+验证安装:
+```bash
+uv --version
+```
+
+### 2. 安装 ErisPulse
+
+```bash
+uv python install 3.12          # 安装 Python 3.12
+uv venv                         # 创建虚拟环境
+source .venv/bin/activate       # 激活环境 (Windows: .venv\Scripts\activate)
+uv pip install ErisPulse --upgrade  # 安装框架
+```
+
+---
+
+## 测试与开发
+
+### 克隆项目并进入目录
+
+```bash
+git clone https://github.com/ErisPulse/ErisPulse.git
+cd ErisPulse
+```
+
+### 使用 `uv` 同步项目环境
+
+```bash
+uv sync
+
+# 启动虚拟环境
+source .venv/bin/activate   
+# Windows: .venv\Scripts\activate
+```
+
+> `ErisPulse` 目前正在使用 `python3.13` 进行开发(所以您同步环境时会自动安装 `3.13`)，但也可以使用其他版本(版本不应低于 `3.10`)。
+
+### 安装依赖并开始
+
+```bash
+uv pip install -e .
+```
+
+这将以“开发模式”安装 SDK，所有本地修改都会立即生效。
+
+### 验证安装
+
+运行以下命令确认 SDK 正常加载：
+
+```bash
+python -c "from ErisPulse import sdk; sdk.init()"
+```
+
+### 运行测试
+
+我们提供了一个交互式测试脚本，可以帮助您快速验证SDK功能：
+
+```bash
+uv run devs/test.py
+```
+
+测试功能包括:
+- 日志系统测试
+- 环境配置测试
+- 错误管理测试
+- 工具函数测试
+- 适配器功能测试
+
+### 开发模式 (热重载)
+```bash
+epsdk run your_script.py --reload
+```
+
+---
+
+## 🤝 贡献指南
+
+我们欢迎各种形式的贡献，包括但不限于:
+
+1. **报告问题**  
+   在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交bug报告
+
+2. **功能请求**  
+   通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
+
+3. **代码贡献**  
+   提交 Pull Request 前请阅读我们的 [开发指南](docs/DEVELOPMENT.md)
+
+4. **文档改进**  
+   帮助完善文档和示例代码
+
+---
+
+[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)

{erispulse-1.1.15 → erispulse-1.2.0}/devs/test_adapter.py

@@ -93,9 +93,6 @@ async def yunhu_test(startup: bool):
         if TEST_VIDEO_PATH.exists():
             with open(TEST_VIDEO_PATH, "rb") as f:
                 await yunhu.Send.To("user", YUNHU_USER_ID).Video(f.read())
-        if TEST_DOCUMENT_PATH.exists():
-            with open(TEST_DOCUMENT_PATH, "rb") as f:
-                await yunhu.Send.To("user", YUNHU_USER_ID).Document(f.read())
         if YUNHU_GROUP_ID:
             await yunhu.Send.To("group", YUNHU_GROUP_ID).Text("【启动通知】SDK已启动 - 云湖群聊文本消息")
             if TEST_IMAGE_PATH.exists():
@@ -104,9 +101,6 @@ async def yunhu_test(startup: bool):
             if TEST_VIDEO_PATH.exists():
                 with open(TEST_VIDEO_PATH, "rb") as f:
                     await yunhu.Send.To("group", YUNHU_GROUP_ID).Video(f.read())
-            if TEST_DOCUMENT_PATH.exists():
-                with open(TEST_DOCUMENT_PATH, "rb") as f:
-                    await yunhu.Send.To("group", YUNHU_GROUP_ID).Document(f.read())
     else:
         await yunhu.Send.To("user", YUNHU_USER_ID).Text("【关闭通知】SDK已关闭")
         if YUNHU_GROUP_ID:
@@ -115,7 +109,9 @@ async def yunhu_test(startup: bool):
 async def main():
     sdk.init()
     try:
+        sdk.logger.set_output_file("test.log")
         await sdk.adapter.startup()
+        await asyncio.sleep(1)
         await telegram_test(True)
         await qq_test(True)
         await yunhu_test(True)
@@ -127,7 +123,8 @@ async def main():
         await qq_test(False)
         await yunhu_test(False)
     except Exception as e:
-        sdk.logger.error(f"测试过程中发生错误: {e}")
+        sdk.logger.error(f"测试过程中发生错误: {str(e)}")
+        raise  # 重新抛出异常以便调试
 
 if __name__ == "__main__":
     asyncio.run(main())