pymud 0.21.0a4__py3-none-any.whl → 0.21.0a5__py3-none-any.whl

{pymud-0.21.0a4.dist-info → pymud-0.21.0a5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymud
-Version: 0.21.0a4
+Version: 0.21.0a5
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@hotmail.com>
 Maintainer-email: "newstart@pkuxkx" <crapex@hotmail.com>
@@ -37,12 +37,15 @@ Dynamic: license-file
 ### 源代码地址: https://github.com/crapex/pymud
 ### 帮助文档地址： https://pymud.readthedocs.org
 ### PyPi项目地址： https://pypi.org/project/pymud
-### 使用交流QQ群：554672580
+### 由deepwiki自动生成的项目理解文档地址： https://deepwiki.com/crapex/pymud
+### PyMUD用户shanghua写的入门教程文档：https://www.pkuxkx.net/forum/forum.php?mod=viewthread&tid=49999&forumuid=12067
+### 交流QQ群：554672580
 
 
 ### 北大侠客行Mud (www.pkuxkx.net)，最好的中文Mud游戏！
 ### PyMUD是我为了更好的玩北大侠客行，特意自行开发的MUD客户端。PyMUD具有以下特点：
 + 原生Python开发，除prompt-toolkit及其依赖库（wcwidth, pygment, pyperclip)外，不需要其他第三方库支持
++ 原生Python的asyncio实现的通信协议处理，支持async/await语法在脚本中直接应用，脚本实现的同步异步两种模式由你自己选择
 + 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作）
 + 支持分屏显示，在数据快速滚动的时候，上半屏保持不动，以确保不错过信息
 + 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题（因为我没有走遍所有地方，不敢保证100%）
@@ -64,11 +67,36 @@ Dynamic: license-file
 ## 版本更新信息
 
 ### 0.21.0 开发中，最新更新2025-05-18
++ 功能新增: #load / #unload 现在支持当前会话对插件的临时启用和禁用，实现方式为调用插件里的PLUGIN_SESSION_CREATE和PLUGIN_SESSION_DESTROYE函数。群文件的moving.py插件写法可以支持。
++ 功能调整: 各会话变量保存的.mud文件，统一移到save子目录下。原来当前目录下的.mud文件，在对应会话重新加载时会自动移动，无需人工处理。
++ 功能新增: 调整了enableGroup处理，可以通过组名支持子组操作，也可以指定有效类型范围。例如下面代码：
+``` Python
+    class MyTestConfig(IConfig):
+        def __init__(self, session, *args, **kwargs):
+            self._objs = [
+                Trigger(session, "tri1", group = "group1"),
+                Trigger(session, "tri2", group = "group1.subgroup1"),
+                Trigger(session, "tri3", group = "group1.subgroup2"),
+                Alias(session, "alias1", group = "group1"),
+                Alias(session, "alias2", group = "group1.subgroup1"),
+                Timer(session, 5, group = "group1.subgroup1")
+            ]
+    
+            #以下调用可以同时禁用上述6个对象，因为 group1.subgroup1 和 group1.subgroup2 都属于 group1 的子组
+            session.enableGroup("group1", False)
+            #以下调用可以同时仅启用触发器tri1和别名alias1，因为通过subgroup参数限定了不传递到子组
+            session.enableGroup("group1", True, subgroup = False)
+            # 以下调用可以同时禁用对应发器和别名，但不禁用定时器，因为通过types参数指定了有效范围：
+            session.enableGroup("group1.subgroup1", False, types = [Trigger, Alias])
+
+```
++ 功能新增: 增加了多处异常追踪提示。在模块或插件的脚本中发生错误时，均会打印错误追踪信息，方便定位错误。
++ 功能新增: 新增 #echo 命令，类似于 #test 命令，但该命令只会模拟收到服务器数据，直接激发各匹配触发器，但不显示触发测试结果。
 + 功能新增: 增加了国际化(i18n)支持，原生开发语言为中文简体，目前使用AI翻译生成了英文。应用语言通过Settings中新增的language配置来控制，默认为"chs"，可以在pymud.cfg中覆盖该配置。其值目前可以为"chs"、"eng"。自行翻译的语言可以在pymud/lang目录下下新增语言文件，文件名为i18n_加语言代码，例如"i18n_chs.py"表示可以使用"chs"语言，其中使用Python字典方式定义了所有需动态显示的文本内容。
 + 功能新增: 新增了使用元类型及装饰器来管理Pymud对象，包括Alias, Trigger, Timer, GMCPTrigger四种可以使用对应的装饰器，@alias, @trigger, @timer, @gmcp来直接在标记函数上创建。可以参考本版本中的pkuxkx.py文件写法和注意事项。
 + 功能新增: 新增了两个装饰器，@exception和@async_exception，用于捕获异常并调用session.error进行显示。@exception用于捕获同步异常，@async_exception用于捕获异步异常。参考如下：
 ``` Python
-    from pymud import Command, Trigger, IConfig
+    from pymud import Command, Trigger, IConfig, exception, async_exception
 
     class MyCustomCommand(Command, IConfig):
         @exception
@@ -97,6 +125,7 @@ Dynamic: license-file
 ```
 + 问题修复: 修复了Alias和Command执行时的优先级判断。之前未进行优先级判断，因此遇到能同时匹配的多个时，不一定优先级高的被触发。现在对Alias和Command进行了优先级判断，优先级高的先触发。
 + 问题修复: 修复Alias中的keepEval参数和oneShot参数。keepEval参数支持多个匹配成功的别名同时生效，oneShot参数支持一个匹配成功的别名生效后，后续的匹配不再生效。
++ 问题修复: 修复Command中的keepEval参数。以往同时匹配生效的Command会覆盖后续Command和Alias，当前会持续匹配。
 + 功能增强: 对几乎所有函数的参数进行了类型标注，增加了类型检查，提高了代码的可读性和可维护性，也便于自行编写脚本时的提示。
 + 功能增强: 为Session类型增加了commandHistory属性，用于查询发送到服务器的命令历史。保存的命令历史的数量由pymud.cfg中的client["history_records"]控制，默认为500。当该值为0时，不会保存命令历史。为-1时，会保存所有命令历史。
 + 功能调整: #help命令时，增加了上下两行分隔符显示，以便明显区分帮助输出和游戏输出。
@@ -105,7 +134,7 @@ Dynamic: license-file
 + 问题修复: 删除了extras.py中多余的MenuItem类型定义，该定义与prompt_toolkit中的MenuItem定义冲突。
 + 问题修复: 调整了众多代码中未检查对象是否为None即调用、使用的局部变量可能未经过初始化和赋值路径等的情况，保证程序运行的健壮性。
 + 问题修复: 修复了#test命令的帮助内容错误。实际#show命令不触发脚本，仅测试；而#test会触发脚本。
-+ 已知问题: 在进行类型标注是，发现了协议中处理MSDP协议的代码有问题，由于北大侠客行不适用MSDP传输数据，所以关闭了默认配置中的MSDP支持，此问题先遗留，后续再解决。之前某些MUD游戏报解码错误可能与MSDP协议有关。
++ 问题修复: 修复了协议处理中MSDP编码解码处理错误的问题；修复了协议处理中默认encoding不传递导致某些情况下报解码错误的问题。
 + 示例更新: 更新了包中自带的pkuxkx.py，增加了@alias, @trigger, @timer, @gmcp的示例以及状态窗口的示例。
 
 ### 0.20.4 (2025-03-30)

pymud-0.21.0a5.dist-info/RECORD

@@ -0,0 +1,23 @@
+pymud/__init__.py,sha256=oeHz0NM7_DwChCY8f_vQ_fBq0e_HoTd0cahCFwaavWE,806
+pymud/__main__.py,sha256=lIOBiJmi8X-EWXVIx_OoxSgUZ0FYKlZI8hXVnLUYTJQ,61
+pymud/decorators.py,sha256=XaxcZqHw4s44lC2EAgB5kZmbNvJnHGmpZnoW75tUeNY,9844
+pymud/dialogs.py,sha256=4kHycr47UgKQUHGX-KMZvERuWViPjT4hNrGhbe4j-NU,7056
+pymud/extras.py,sha256=p52ZyHlldAkv_DruTNQdOzG1wcfQeBhYlOzCg2humDA,34614
+pymud/i18n.py,sha256=qLgvrmYhVfkTHKpbBR-LfYMOrGgi0skHrelbsj7ItbE,3034
+pymud/logger.py,sha256=WCsfXVkgl63qdq1RQEDJBnM7U0S6u8TeORFSMhcoydI,5840
+pymud/main.py,sha256=zaSjNhpbX3FMulKg-UNFrdiIJO8sOmmrUQrkPOalB-4,10224
+pymud/modules.py,sha256=DoCregng5iAj_Hq_yUvRPreRTv2Ehb6sV6_4jfdbsik,11912
+pymud/objects.py,sha256=ZOxNjlPD_d4jk5DMBcXgYcvkt9d8xZih0IQtQlA3f1Y,38668
+pymud/pkuxkx.py,sha256=qDVry-Vd6MNui0NKWZFT52IpmP1sKS5Dz74EDY4tVGQ,14740
+pymud/protocol.py,sha256=KNKJYj9HFRoUy-jigNfhiQdDOM_kRSJE17QFpBarQTg,48335
+pymud/pymud.py,sha256=mq27pOu2NThF8d5i2tBL2iK0w6b2Vzx03FPh0wu0qiI,53299
+pymud/session.py,sha256=DjYGuf-Q6PWrmIxsOyNXHf22-yvCLLqgtVFvek5D_Bo,143282
+pymud/settings.py,sha256=aZ2ZY-sSO_U-Mzn0TlxDsn7fXRku5YHWhjJuv3p4L40,7697
+pymud/lang/i18n_chs.py,sha256=atHT26tGvmrpyzkkp7PwFN7b2EDGefjghfn9P7kF-UA,16539
+pymud/lang/i18n_eng.py,sha256=G0h0b-G3gqk2cjJ7IsRkkkJ6WAk1IGh4o5FgJ2MHPAc,45246
+pymud-0.21.0a5.dist-info/licenses/LICENSE.txt,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+pymud-0.21.0a5.dist-info/METADATA,sha256=EzcT-IeDq_oo2sa9G9h8Z855ZH4ZlNw3k-i1S9420cc,41728
+pymud-0.21.0a5.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+pymud-0.21.0a5.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
+pymud-0.21.0a5.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
+pymud-0.21.0a5.dist-info/RECORD,,

pymud-0.21.0a4.dist-info/RECORD

@@ -1,22 +0,0 @@
-pymud/__init__.py,sha256=Z6xB4l8BKL5EQv6-JI-Y7YBD5toY8GzB__OdMnmYM5A,758
-pymud/__main__.py,sha256=lIOBiJmi8X-EWXVIx_OoxSgUZ0FYKlZI8hXVnLUYTJQ,61
-pymud/dialogs.py,sha256=4kHycr47UgKQUHGX-KMZvERuWViPjT4hNrGhbe4j-NU,7056
-pymud/extras.py,sha256=_hiu9eSWCZ6HLripPAPsDofTdix78uEMAOTY0X2SiSU,34614
-pymud/i18n.py,sha256=qLgvrmYhVfkTHKpbBR-LfYMOrGgi0skHrelbsj7ItbE,3034
-pymud/logger.py,sha256=WCsfXVkgl63qdq1RQEDJBnM7U0S6u8TeORFSMhcoydI,5840
-pymud/main.py,sha256=rqMWjx4Q_VKrZT6cWkY8LRgimlzRF_x6vePbqYI_QtU,9782
-pymud/modules.py,sha256=LVO_XfUFOilLCDM0llnAyoNfq2WSNL29ZXVlHWpZx1U,18068
-pymud/objects.py,sha256=KLR3L7uSwH76ut_RDDkMP7mIcztMe60sb-OdHcvt7rA,38159
-pymud/pkuxkx.py,sha256=qDVry-Vd6MNui0NKWZFT52IpmP1sKS5Dz74EDY4tVGQ,14740
-pymud/protocol.py,sha256=mBlSmSyrQjxZ0kCoqLJNUa6RV7vmDWGOQNR5PaHK98c,48221
-pymud/pymud.py,sha256=IPmIzDwapNz0NK1ZSLPba-z8km_HofxevHGjj2C5Jl8,53275
-pymud/session.py,sha256=71KB7Xcppiw-L-YDsgRe4zpq4tWzRC1H4pClS2mN5z0,140363
-pymud/settings.py,sha256=tld644TrXEO6NpBV9p1hMlYoke0Sjz9RFfP5bkXe2oQ,7729
-pymud/lang/i18n_chs.py,sha256=zOEgzXDXDx568uWmxW4yWreWYWnMZogEu2en2j9lLtU,16208
-pymud/lang/i18n_eng.py,sha256=fILWVMA71uL0akkjiR4r_B1x0wHP3EMycM7IP0zdPtY,44513
-pymud-0.21.0a4.dist-info/licenses/LICENSE.txt,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-pymud-0.21.0a4.dist-info/METADATA,sha256=6xN8madP5E3BkuH39GgWWY1OTeSbmSWHBWb9gBDwTbA,39258
-pymud-0.21.0a4.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-pymud-0.21.0a4.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
-pymud-0.21.0a4.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
-pymud-0.21.0a4.dist-info/RECORD,,