ErisPulse 2.1.13rc2__py3-none-any.whl → 2.1.14__py3-none-any.whl

{erispulse-2.1.13rc2.dist-info → erispulse-2.1.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.1.13rc2
+Version: 2.1.14
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 License: MIT License
@@ -68,17 +68,26 @@ Description-Content-Type: text/markdown
 [![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
 [![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)
+## 文档站
 
+[![Docs-Main](https://img.shields.io/badge/docs-main_site-blue?style=flat-square)](https://www.erisdev.com/#docs)
+[![Docs-CF Pages](https://img.shields.io/badge/docs-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/#docs)
+[![Docs-GitHub](https://img.shields.io/badge/docs-github-blue?style=flat-square)](https://erispulse.github.io/#docs)
+[![Docs-Netlify](https://img.shields.io/badge/docs-netlify-blue?style=flat-square)](https://erispulse.netlify.app/#docs)
+
+## 模块市场
+
+[![Market-Main](https://img.shields.io/badge/market-erisdev-blue?style=flat-square)](https://www.erisdev.com/#market)
+[![Market-CF Pages](https://img.shields.io/badge/market-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/#market)
+[![Market-GitHub](https://img.shields.io/badge/market-github-blue?style=flat-square)](https://erispulse.github.io/#market)
+[![Market-Netlify](https://img.shields.io/badge/market-netlify-blue?style=flat-square)](https://erispulse.netlify.app/#market)
+
+---
 
 ## 核心特性
 
 | 特性 | 描述 |
-|------|------|
+|:-----|:-----|
 | **异步架构** | 完全基于 async/await 的异步设计 |
 | **模块化系统** | 灵活的插件和模块管理 |
 | **热重载** | 开发时自动重载，无需重启 |
@@ -100,6 +109,7 @@ irm https://get.erisdev.com/install.ps1 -OutFile install.ps1; powershell -Execut
 ```
 
 #### macOS/Linux:
+
 ```bash
 curl -sSL https://get.erisdev.com/install.sh | tee install.sh >/dev/null && chmod +x install.sh && ./install.sh
 ```
@@ -108,14 +118,14 @@ curl -sSL https://get.erisdev.com/install.sh | tee install.sh >/dev/null && chmo
 
 ## 测试与开发
 
-### 克隆项目并进入目录
+### 1. 克隆项目并进入目录
 
 ```bash
 git clone -b Develop/v2 https://github.com/ErisPulse/ErisPulse.git
 cd ErisPulse
 ```
 
-### 使用 `uv` 同步项目环境
+### 2. 使用 `uv` 同步项目环境
 
 ```bash
 uv sync
@@ -127,15 +137,15 @@ source .venv/bin/activate
 
 > `ErisPulse` 目前正在使用 `python3.13` 进行开发(所以您同步环境时会自动安装 `3.13`)，但也可以使用其他版本(版本不应低于 `3.10`)。
 
-### 安装依赖并开始
+### 3. 安装依赖并开始
 
 ```bash
 uv pip install -e .
 ```
 
-这将以“开发模式”安装 SDK，所有本地修改都会立即生效。
+这将以"开发模式"安装 SDK，所有本地修改都会立即生效。
 
-### 验证安装
+### 4. 验证安装
 
 运行以下命令确认 SDK 正常加载：
 
@@ -143,7 +153,7 @@ uv pip install -e .
 python -c "from ErisPulse import sdk; sdk.init()"
 ```
 
-### 运行测试
+### 5. 运行测试
 
 我们提供了一个交互式测试脚本，可以帮助您快速验证SDK功能：
 
@@ -158,14 +168,15 @@ uv run devs/test.py
 - 工具函数测试
 - 适配器功能测试
 
-### 开发模式 (热重载)
+### 6. 开发模式 (热重载)
+
 ```bash
 epsdk run your_script.py --reload
 ```
 
 ---
 
-## 🤝 贡献指南
+## 贡献指南
 
 我们欢迎各种形式的贡献，包括但不限于:
 
@@ -181,6 +192,10 @@ epsdk run your_script.py --reload
 4. **文档改进**  
    帮助完善文档和示例代码
 
+[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)
+
 ---
 
-[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)
+[![](https://starchart.cc/ErisPulse/ErisPulse.svg?variant=adaptive)](https://starchart.cc/ErisPulse/ErisPulse)
+
+

erispulse-2.1.14.dist-info/RECORD

@@ -0,0 +1,16 @@
+ErisPulse/__init__.py,sha256=PfRuqOSlKcneLN1KrqcW5wFsgnVmpzrDOWrYYweUBjM,26423
+ErisPulse/__main__.py,sha256=sWlvqyvt3LGrkp7WBSsOSbuPrujqgJvLzt5nA5Bdf4w,40790
+ErisPulse/Core/__init__.py,sha256=hX2yEt9VSD3JubiofoQdcY4v1lnQUU02dhuVADkMTVo,437
+ErisPulse/Core/adapter.py,sha256=oBJOp6SS8sm8NgIxQwetGsHu24wHNXz7ESQ5yKJSo7Q,18234
+ErisPulse/Core/config.py,sha256=2BRWINOqKtHSCP4KfhuiRpGwR96jWGKV7gjZSi_VQHE,2397
+ErisPulse/Core/env.py,sha256=U45f9WtriVyd3tW1N8to-ZvpzcF9gD8DJzNTC1jY2cM,17665
+ErisPulse/Core/erispulse_config.py,sha256=QDx401hNX9JcSHqCSVK33X6VTubl6HI1znAK3T_J0K0,3034
+ErisPulse/Core/exceptions.py,sha256=zuTREGczwGzbYT4Z6dACqHwgNRpiJeLFR8aCxFdOg7k,3667
+ErisPulse/Core/logger.py,sha256=8hdbF6x3JpsQbbeEjvbSej134q5oV0wafagpWq3Nbeg,11223
+ErisPulse/Core/mods.py,sha256=2yIq8t9Ca9CBPRiZU0yr8Lc0XGmmkB7LlH-5FWqXjw4,7023
+ErisPulse/Core/router.py,sha256=66hT8VC2dVNX-dANldoOPDcqQ94hidFkNnvKgAPemGQ,8491
+erispulse-2.1.14.dist-info/METADATA,sha256=_vPGvuW0ovuDT71VdSXESB73bvagY1rpskOrPaGY964,6888
+erispulse-2.1.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+erispulse-2.1.14.dist-info/entry_points.txt,sha256=Jss71M6nEha0TA-DyVZugPYdcL14s9QpiOeIlgWxzOc,182
+erispulse-2.1.14.dist-info/licenses/LICENSE,sha256=4jyqikiB0G0n06CEEMMTzTXjE4IShghSlB74skMSPQs,1464
+erispulse-2.1.14.dist-info/RECORD,,

ErisPulse/Core/raiserr.py

@@ -1,181 +0,0 @@
-"""
-ErisPulse 错误管理系统
-
-提供全局异常捕获功能。不再推荐使用自定义错误注册功能。
-
-{!--< tips >!--}
-1. 请使用Python原生异常抛出方法
-2. 系统会自动捕获并格式化所有未处理异常
-3. 注册功能已标记为弃用，将在未来版本移除
-{!--< /tips >!--}
-"""
-
-import sys
-import traceback
-import asyncio
-from typing import Dict, Any, Optional, Type, Callable, List, Set, Tuple, Union
-
-class Error:
-    """
-    错误管理器
-    
-    {!--< deprecated >!--} 请使用Python原生异常抛出方法 | 2025-07-18
-    
-    {!--< tips >!--}
-    1. 注册功能将在未来版本移除
-    2. 请直接使用raise Exception("message")方式抛出异常
-    {!--< /tips >!--}
-    """
-    
-    def __init__(self):
-        self._types = {}
-
-    def register(self, name: str, doc: str = "", base: Type[Exception] = Exception) -> Type[Exception]:
-        """
-        注册新的错误类型
-        
-        {!--< deprecated >!--} 请使用Python原生异常抛出方法 | 2025-07-18
-        
-        :param name: 错误类型名称
-        :param doc: 错误描述文档
-        :param base: 基础异常类
-        :return: 注册的错误类
-        """
-        if name not in self._types:
-            err_cls = type(name, (base,), {"__doc__": doc})
-            self._types[name] = err_cls
-        return self._types[name]
-
-    def __getattr__(self, name: str) -> Callable[..., None]:
-        """
-        动态获取错误抛出函数
-        
-        {!--< deprecated >!--} 请使用Python原生异常抛出方法 | 2025-07-18
-        
-        :param name: 错误类型名称
-        :return: 错误抛出函数
-        
-        :raises AttributeError: 当错误类型未注册时抛出
-        """
-        def raiser(msg: str, exit: bool = False) -> None:
-            """
-            错误抛出函数
-            
-            :param msg: 错误消息
-            :param exit: 是否退出程序
-            """
-            from .logger import logger
-            err_cls = self._types.get(name) or self.register(name)
-            exc = err_cls(msg)
-
-            red = '\033[91m'
-            reset = '\033[0m'
-
-            logger.error(f"{red}{name}: {msg} | {err_cls.__doc__}{reset}")
-            logger.error(f"{red}{ ''.join(traceback.format_stack()) }{reset}")
-
-            if exit:
-                raise exc
-        return raiser
-
-    def info(self, name: Optional[str] = None) -> Dict[str, Any]:
-        """
-        获取错误信息
-        
-        {!--< deprecated >!--} 此功能将在未来版本移除 | 2025-07-18
-        
-        :param name: 错误类型名称(可选)
-        :return: 错误信息字典
-        """
-        result = {}
-        for err_name, err_cls in self._types.items():
-            result[err_name] = {
-                "type": err_name,
-                "doc": getattr(err_cls, "__doc__", ""),
-                "class": err_cls,
-            }
-        if name is None:
-            return result
-        err_cls = self._types.get(name)
-        if not err_cls:
-            return {
-                "type": None,
-                "doc": None,
-                "class": None,
-            }
-        return {
-            "type": name,
-            "doc": getattr(err_cls, "__doc__", ""),
-            "class": err_cls,
-        }
-
-
-raiserr = Error()
-
-def global_exception_handler(exc_type: Type[Exception], exc_value: Exception, exc_traceback: Any) -> None:
-    """
-    全局异常处理器
-    
-    :param exc_type: 异常类型
-    :param exc_value: 异常值
-    :param exc_traceback: 追踪信息
-    """
-    RED = '\033[91m'
-    YELLOW = '\033[93m'
-    BLUE = '\033[94m'
-    RESET = '\033[0m'
-    
-    error_title = f"{RED}{exc_type.__name__}{RESET}: {YELLOW}{exc_value}{RESET}"
-    traceback_lines = traceback.format_exception(exc_type, exc_value, exc_traceback)
-    
-    colored_traceback = []
-    for line in traceback_lines:
-        if "File " in line and ", line " in line:
-            parts = line.split(', line ')
-            colored_line = f"{BLUE}{parts[0]}{RESET}, line {parts[1]}"
-            colored_traceback.append(colored_line)
-        else:
-            colored_traceback.append(f"{RED}{line}{RESET}")
-    
-    full_error = f"""
-{error_title}
-{RED}Traceback:{RESET}
-{colored_traceback}"""
-    
-    sys.stderr.write(full_error)
-
-def async_exception_handler(loop: asyncio.AbstractEventLoop, context: Dict[str, Any]) -> None:
-    """
-    异步异常处理器
-    
-    :param loop: 事件循环
-    :param context: 上下文字典
-    """
-    RED = '\033[91m'
-    YELLOW = '\033[93m'
-    BLUE = '\033[94m'
-    RESET = '\033[0m'
-    
-    exception = context.get('exception')
-    if exception:
-        tb = ''.join(traceback.format_exception(type(exception), exception, exception.__traceback__))
-        
-        colored_tb = []
-        for line in tb.split('\n'):
-            if "File " in line and ", line " in line:
-                parts = line.split(', line ')
-                colored_line = f"{BLUE}{parts[0]}{RESET}, line {parts[1]}"
-                colored_tb.append(colored_line)
-            else:
-                colored_tb.append(f"{RED}{line}{RESET}")
-        
-        error_msg = f"""{RED}{type(exception).__name__}{RESET}: {YELLOW}{exception}{RESET}
-{RED}Traceback:{RESET}
-{colored_tb}"""
-        sys.stderr.write(error_msg)
-    else:
-        msg = context.get('message', 'Unknown async error')
-        sys.stderr.write(f"{RED}Async Error{RESET}: {YELLOW}{msg}{RESET}")
-
-sys.excepthook = global_exception_handler
-asyncio.get_event_loop().set_exception_handler(async_exception_handler)

ErisPulse/Core/util.py

@@ -1,123 +0,0 @@
-"""
-ErisPulse 工具函数集合
-
-提供常用工具函数，包括拓扑排序、缓存装饰器、异步执行等实用功能。
-
-{!--< tips >!--}
-1. 使用@cache装饰器缓存函数结果
-2. 使用@run_in_executor在独立线程中运行同步函数
-3. 使用@retry实现自动重试机制
-{!--< /tips >!--}
-"""
-
-import time
-import asyncio
-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()
-
-class Util:
-    """
-    工具函数集合
-    
-    提供各种实用功能，简化开发流程
-    
-    {!--< tips >!--}
-    1. 拓扑排序用于解决依赖关系
-    2. 装饰器简化常见模式实现
-    3. 异步执行提升性能
-    {!--< /tips >!--}
-    """
-    def ExecAsync(self, async_func: Callable, *args: Any, **kwargs: Any) -> Any:
-        """
-        异步执行函数
-        
-        :param async_func: 异步函数
-        :param args: 位置参数
-        :param kwargs: 关键字参数
-        :return: 函数执行结果
-        
-        :example:
-        >>> result = util.ExecAsync(my_async_func, arg1, arg2)
-        """
-        loop = asyncio.get_event_loop()
-        return loop.run_in_executor(executor, lambda: asyncio.run(async_func(*args, **kwargs)))
-
-    def cache(self, func: Callable) -> Callable:
-        """
-        缓存装饰器
-        
-        :param func: 被装饰函数
-        :return: 装饰后的函数
-        
-        :example:
-        >>> @util.cache
-        >>> def expensive_operation(param):
-        >>>     return heavy_computation(param)
-        """
-        cache_dict = {}
-        @functools.wraps(func)
-        def wrapper(*args, **kwargs):
-            key = (args, tuple(sorted(kwargs.items())))
-            if key not in cache_dict:
-                cache_dict[key] = func(*args, **kwargs)
-            return cache_dict[key]
-        return wrapper
-
-    def run_in_executor(self, func: Callable) -> Callable:
-        """
-        在独立线程中执行同步函数的装饰器
-        
-        :param func: 被装饰的同步函数
-        :return: 可等待的协程函数
-        
-        :example:
-        >>> @util.run_in_executor
-        >>> def blocking_io():
-        >>>     # 执行阻塞IO操作
-        >>>     return result
-        """
-        @functools.wraps(func)
-        async def wrapper(*args, **kwargs):
-            loop = asyncio.get_event_loop()
-            try:
-                return await loop.run_in_executor(None, lambda: func(*args, **kwargs))
-            except Exception as e:
-                from . import logger
-                logger.error(f"线程内发生未处理异常:\n{''.join(traceback.format_exc())}")
-        return wrapper
-
-    def retry(self, max_attempts: int = 3, delay: int = 1) -> Callable:
-        """
-        自动重试装饰器
-        
-        :param max_attempts: 最大重试次数 (默认: 3)
-        :param delay: 重试间隔(秒) (默认: 1)
-        :return: 装饰器函数
-        
-        :example:
-        >>> @util.retry(max_attempts=5, delay=2)
-        >>> def unreliable_operation():
-        >>>     # 可能失败的操作
-        """
-        def decorator(func: Callable) -> Callable:
-            @functools.wraps(func)
-            def wrapper(*args, **kwargs):
-                attempts = 0
-                while attempts < max_attempts:
-                    try:
-                        return func(*args, **kwargs)
-                    except Exception as e:
-                        attempts += 1
-                        if attempts == max_attempts:
-                            raise
-                        time.sleep(delay)
-            return wrapper
-        return decorator
-
-
-util = Util()

erispulse-2.1.13rc2.dist-info/RECORD

@@ -1,16 +0,0 @@
-ErisPulse/__init__.py,sha256=T-N56UQyBmpvlqwH2wGi5ptPzaJpbgF5tKkJt0DlkaM,26099
-ErisPulse/__main__.py,sha256=gizHkbu70K8wFhYE_3sWUyiZpaL1imuwQHHQ93XVbrQ,35773
-ErisPulse/Core/__init__.py,sha256=tBYPahQ7-w7U6M69xy8DW0_ECa9ja-Q0y_SQqVswYBo,409
-ErisPulse/Core/adapter.py,sha256=ZK81dibJ471FowL0MRXkS113iBcMgj_VzpTw0PzhAEo,18102
-ErisPulse/Core/config.py,sha256=ZmwGdtHSOE7K5uOGzLYcyl3ZF3sAmeWAntqcdfDzhpM,5027
-ErisPulse/Core/env.py,sha256=HGkzsdbxh8c1GSDJhnGP9B09Sz2ZeNbRxWieaFmAcug,18870
-ErisPulse/Core/logger.py,sha256=cJzNXF-EmdWxwgiHg5Itmkwsva2Jhe9l9X4rXKiXHgc,8296
-ErisPulse/Core/mods.py,sha256=2yIq8t9Ca9CBPRiZU0yr8Lc0XGmmkB7LlH-5FWqXjw4,7023
-ErisPulse/Core/raiserr.py,sha256=vlyaaiOIYkyqm9dAqSW9E54JBzX-9roHDp5_r6I0yUU,5591
-ErisPulse/Core/server.py,sha256=FkDTeLuHD5IBnWVxvYU8pHb6yCt8GzyvC1bpOiJ7G7I,9217
-ErisPulse/Core/util.py,sha256=7rdMmn6sBFqYd4znxBCcJjuv2eyTExdeKyZopgds868,3796
-erispulse-2.1.13rc2.dist-info/METADATA,sha256=XTCluJfTY1p3SYwCkN7Ji2-K8VysXzAgqM10hBlYar4,6262
-erispulse-2.1.13rc2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-erispulse-2.1.13rc2.dist-info/entry_points.txt,sha256=Jss71M6nEha0TA-DyVZugPYdcL14s9QpiOeIlgWxzOc,182
-erispulse-2.1.13rc2.dist-info/licenses/LICENSE,sha256=4jyqikiB0G0n06CEEMMTzTXjE4IShghSlB74skMSPQs,1464
-erispulse-2.1.13rc2.dist-info/RECORD,,