pymud 0.21.0a2__tar.gz → 0.21.0a3__tar.gz

{pymud-0.21.0a2 → pymud-0.21.0a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymud
-Version: 0.21.0a2
+Version: 0.21.0a3
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@hotmail.com>
 Maintainer-email: "newstart@pkuxkx" <crapex@hotmail.com>
@@ -66,6 +66,7 @@ Dynamic: license-file
 ### 0.21.0a2 (2025-05-17)
 + 功能新增: 增加了国际化(i18n)支持，支持中文简体和英文。目前完全支持的仅中文简体，英文只完成了界面翻译，运行时的#help帮助内容暂未翻译。
 + 功能新增: 新增了使用元类型及装饰器来管理Pymud对象，包括Alias, Trigger, Timer, GMCPTrigger四种可以使用对应的装饰器，@alias, @trigger, @timer, @gmcp来直接在标记函数上创建。可以参考本版本中的pkuxkx.py文件写法
++ 功能新增: 新增了两个装饰器，@exception和@async_exception，用于捕获异常并调用session.error进行显示。@exception用于捕获同步异常，@async_exception用于捕获异步异常。
 + 问题修复: 之前对Alias和Command未进行优先级判断，因此遇到能同时匹配的多个时，不一定优先级高的被触发。现在对Alias和Command进行了优先级判断，优先级高的先触发。
 + 问题修复: 之前的Alias中的keepEval参数和oneShot参数不起作用，已修复。keepEval参数支持多个匹配成功的别名同时生效，oneShot参数支持一个匹配成功的别名生效后，后续的匹配不再生效。
 + 问题修复: 修复a1版中@alias别名创建错误的问题(a1版问题，a2版中已修复)

{pymud-0.21.0a2 → pymud-0.21.0a3}/README.md

@@ -34,6 +34,7 @@
 ### 0.21.0a2 (2025-05-17)
 + 功能新增: 增加了国际化(i18n)支持，支持中文简体和英文。目前完全支持的仅中文简体，英文只完成了界面翻译，运行时的#help帮助内容暂未翻译。
 + 功能新增: 新增了使用元类型及装饰器来管理Pymud对象，包括Alias, Trigger, Timer, GMCPTrigger四种可以使用对应的装饰器，@alias, @trigger, @timer, @gmcp来直接在标记函数上创建。可以参考本版本中的pkuxkx.py文件写法
++ 功能新增: 新增了两个装饰器，@exception和@async_exception，用于捕获异常并调用session.error进行显示。@exception用于捕获同步异常，@async_exception用于捕获异步异常。
 + 问题修复: 之前对Alias和Command未进行优先级判断，因此遇到能同时匹配的多个时，不一定优先级高的被触发。现在对Alias和Command进行了优先级判断，优先级高的先触发。
 + 问题修复: 之前的Alias中的keepEval参数和oneShot参数不起作用，已修复。keepEval参数支持多个匹配成功的别名同时生效，oneShot参数支持一个匹配成功的别名生效后，后续的匹配不再生效。
 + 问题修复: 修复a1版中@alias别名创建错误的问题(a1版问题，a2版中已修复)

{pymud-0.21.0a2 → pymud-0.21.0a3}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 
 name = "pymud"  # Required
-version = "0.21.0a2"  # Required
+version = "0.21.0a3"  # Required
 description = "a MUD Client written in Python"  # Optional
 readme = "README.md" # Optional
 requires-python = ">=3.7"

{pymud-0.21.0a2 → pymud-0.21.0a3}/src/pymud/__init__.py

@@ -3,7 +3,7 @@ from .pymud import PyMudApp
 from .modules import IConfig, PymudDecorator, PymudMeta, alias, trigger, timer, gmcp
 from .objects import CodeBlock, Alias, SimpleAlias, Trigger, SimpleTrigger, Command, SimpleCommand, Timer, SimpleTimer, GMCPTrigger
 from .extras import DotDict
-from .session import Session
+from .session import Session, exception, async_exception
 from .logger import Logger
 from .main import main
 
@@ -12,5 +12,6 @@ __all__ = [
     "IConfig", "PyMudApp", "Settings", "CodeBlock", 
     "Alias", "SimpleAlias", "Trigger", "SimpleTrigger", 
     "Command", "SimpleCommand", "Timer", "SimpleTimer", 
-    "GMCPTrigger", "Session", "DotDict", "Logger", "main"
+    "GMCPTrigger", "Session", "DotDict", "Logger", "main",
+    "exception", "async_exception"
 ]

{pymud-0.21.0a2 → pymud-0.21.0a3}/src/pymud/modules.py

@@ -1,5 +1,5 @@
 
-import importlib, importlib.util
+import importlib, importlib.util, functools
 from abc import ABC, ABCMeta
 from typing import Any, Annotated, Optional, Union
 from .objects import BaseObject, Command, Trigger, Alias, Timer, GMCPTrigger
@@ -304,13 +304,13 @@ class IConfig(metaclass = PymudMeta):
                 for deco in decorators:
                     if isinstance(deco, PymudDecorator):
                         if deco.type == "alias":
-                            patterns = deco.kwargs.pop("patterns")
-                            ali = Alias(self.session, patterns, *deco.args, **deco.kwargs, onSuccess = func)
+                            #patterns = deco.kwargs.pop("patterns")
+                            ali = Alias(self.session, *deco.args, **deco.kwargs, onSuccess = func)
                             self.__inline_objects__[ali.id] = ali
                         
                         elif deco.type == "trigger":
-                            patterns = deco.kwargs.pop("patterns")
-                            tri = Trigger(self.session, patterns, *deco.args, **deco.kwargs, onSuccess = func)
+                            #patterns = deco.kwargs.pop("patterns")
+                            tri = Trigger(self.session, *deco.args, **deco.kwargs, onSuccess = func)
                             self.__inline_objects__[tri.id] = tri
 
                         elif deco.type == "timer":

{pymud-0.21.0a2 → pymud-0.21.0a3}/src/pymud/session.py

@@ -1,9 +1,7 @@
-import asyncio, logging, re, math, os, pickle, datetime, importlib, importlib.util, sysconfig, time, dataclasses
+import asyncio, logging, re, math, os, pickle, datetime, sysconfig, time, dataclasses, functools, traceback
 from collections.abc import Iterable
 from collections import OrderedDict
-import logging, queue
-from logging import FileHandler
-from logging.handlers import QueueHandler, QueueListener
+import logging
 from wcwidth import wcswidth, wcwidth
 from typing import Union, Optional, Annotated, Any
 from .logger import Logger
@@ -3361,3 +3359,34 @@ class Session:
                 else:
                     self.application.show_logSelectDialog()
 
+
+def exception(func):
+    """方法异常处理装饰器，捕获异常后通过会话的session.error打印相关信息"""
+    @functools.wraps(func)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return func(self, *args, **kwargs)
+        except Exception as e:
+            # 调用类的错误处理方法
+            session = getattr(self, "session", None)
+            if isinstance(session, Session):
+                session.error(f"函数执行中遇到异常, {e}, 类型为 {type(e)}")
+                session.error(f"异常追踪为： {traceback.format_exc()}")
+            else:
+                raise  # 当没有会话时，选择重新抛出异常
+    return wrapper
+
+def async_exception(func):
+    """异步方法异常处理装饰器，捕获异常后通过会话的session.error打印相关信息"""
+    @functools.wraps(func)
+    async def wrapper(self, *args, **kwargs):
+        try:
+            return await func(self, *args, **kwargs)
+        except Exception as e:
+            session = getattr(self, "session", None)
+            if isinstance(session, Session):
+                session.error(f"异步执行中遇到异常, {e}, 类型为 {type(e)}")
+                session.error(f"异常追踪为： {traceback.format_exc()}")
+            else:
+                raise  # 当没有会话时，选择重新抛出异常
+    return wrapper

{pymud-0.21.0a2 → pymud-0.21.0a3}/src/pymud/settings.py

@@ -3,6 +3,8 @@ PyMUD Settings 文件
 用于保存与App有关的各类配置、常量等
 """
 
+import importlib.metadata
+
 class Settings:
     "保存PyMUD配置的全局对象"
 
@@ -11,9 +13,9 @@ class Settings:
     "APP 名称, 默认PYMUD"
     __appdesc__   = "a MUD client written in Python"
     "APP 简要描述"
-    __version__   = "0.21.0a1"
+    __version__   = importlib.metadata.version("pymud")
     "APP 当前版本"
-    __release__   = "2025-05-15"
+    __release__   = "2025-05-17"
     "APP 当前版本发布日期"
     __author__    = "本牛(newstart)@北侠"
     "APP 作者"

{pymud-0.21.0a2 → pymud-0.21.0a3}/src/pymud.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymud
-Version: 0.21.0a2
+Version: 0.21.0a3
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@hotmail.com>
 Maintainer-email: "newstart@pkuxkx" <crapex@hotmail.com>
@@ -66,6 +66,7 @@ Dynamic: license-file
 ### 0.21.0a2 (2025-05-17)
 + 功能新增: 增加了国际化(i18n)支持，支持中文简体和英文。目前完全支持的仅中文简体，英文只完成了界面翻译，运行时的#help帮助内容暂未翻译。
 + 功能新增: 新增了使用元类型及装饰器来管理Pymud对象，包括Alias, Trigger, Timer, GMCPTrigger四种可以使用对应的装饰器，@alias, @trigger, @timer, @gmcp来直接在标记函数上创建。可以参考本版本中的pkuxkx.py文件写法
++ 功能新增: 新增了两个装饰器，@exception和@async_exception，用于捕获异常并调用session.error进行显示。@exception用于捕获同步异常，@async_exception用于捕获异步异常。
 + 问题修复: 之前对Alias和Command未进行优先级判断，因此遇到能同时匹配的多个时，不一定优先级高的被触发。现在对Alias和Command进行了优先级判断，优先级高的先触发。
 + 问题修复: 之前的Alias中的keepEval参数和oneShot参数不起作用，已修复。keepEval参数支持多个匹配成功的别名同时生效，oneShot参数支持一个匹配成功的别名生效后，后续的匹配不再生效。
 + 问题修复: 修复a1版中@alias别名创建错误的问题(a1版问题，a2版中已修复)