pymud 0.20.0a4__tar.gz → 0.20.1__tar.gz

{pymud-0.20.0a4/src/pymud.egg-info → pymud-0.20.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: pymud
-Version: 0.20.0a4
+Version: 0.20.1
 Summary: a MUD Client written in Python
-Author-email: "newstart@pkuxkx" <crapex@crapex.cc>
-Maintainer-email: "newstart@pkuxkx" <crapex@crapex.cc>
+Author-email: "newstart@pkuxkx" <crapex@hotmail.com>
+Maintainer-email: "newstart@pkuxkx" <crapex@hotmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
                                Version 3, 29 June 2007
         
@@ -684,7 +684,7 @@ Project-URL: Bug Reports, https://github.com/crapex/pymud/issues
 Project-URL: Source, https://github.com/crapex/pymud/
 Project-URL: document, https://pymud.readthedocs.io/
 Keywords: MUD,multi-user dungeon,client
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Topic :: Games/Entertainment :: Multi-User Dungeons (MUD)
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
@@ -707,7 +707,7 @@ Requires-Dist: prompt-toolkit
 # PyMUD - Python原生MUD客户端
 ## 简介
 
-### 帮助文件见北侠WIKI：  https://www.pkuxkx.net/wiki/tools/pymud
+### 北侠WIKI：  https://www.pkuxkx.net/wiki/tools/pymud
 ### 源代码地址: https://github.com/crapex/pymud
 ### 帮助文档地址： https://pymud.readthedocs.org
 ### PyPi项目地址： https://pypi.org/project/pymud
@@ -729,9 +729,20 @@ Requires-Dist: prompt-toolkit
 + Python拥有极为丰富的第三方库，能支持的第三方库，就能在PyMud中支持
 + 我自己还在玩，所以本客户端会持续进行更新:)
 
+### 哪些人适合使用PyMUD
++ 比较熟悉Python语言，会使用Python写代码的 -> PyMUD是纯Python原生开发，不会有其他客户端对Python的支持能比得过PyMUD
++ 虽不太熟悉Python语言，但有想法想学习Python语言的 -> 正好使用PyMUD玩北侠写脚本的过程中学习Python语言
++ 觉得还有些功能现在所有客户端都没有的 -> 你有需求，我来增加，就是这么方便
++ 觉得也想自己整一个定制客户端玩玩的 -> PyMUD完全开源，且除ui框架外全部都是一行一行代码自己写的，可以直接参考PyMUD的设计
+
 ## 版本更新信息
 
-## 0.20.0 (2024-08-XX)
+### 0.20.1 (2024-11-16)
++ 功能调整: 会话中触发器匹配实现进行部分调整，减少循环次数以提高响应速度
++ 功能调整: #test / #show 触发器测试功能调整，现在会对使能的和未使能的触发器均进行匹配测试。其中，#show 命令仅测试，而 #test 命令会导致触发器真正响应。
++ 功能新增: pymud对象新增了一个持续运行的1s的周期定时任务。该任务中会刷新页面显示。可以使用 session.application.addTimerTickCallback 和 session.application.removeTimerTickCallback 来注册和解除定时器回调。
+
+## 0.20.0 (2024-08-25)
 + 功能调整: 将模块主入口函数从__main__.py中移动到main.py中，以使可以在当前目录下，可直接使用pymud，也可使用python -m pymud启动
 + 功能调整: 使用argsparser标准模块来配置命令行，可以使用 pymud -h 查看命令行具体参数及说明
 + 功能新增: 命令行参数增加指定启动目录的功能，参数为 -s, --startup_dir。即可以从任意目录通过指定脚本目录方式启动PyMUD了。
@@ -743,10 +754,12 @@ Requires-Dist: prompt-toolkit
 + 功能调整: 在没有session的时候，也可以执行#exit命令
 + 功能新增: #session 命令增加快捷创建会话功能，假如已有快捷菜单 世界->pkuxkx->newstart , 则可以通过 #session pkuxkx.newstart 直接创建该会话，效果等同于点击该菜单
 + 功能调整: 点击菜单创建会话时，若会话已存在，则将该会话切换为当前会话
-+ 问题修复: 修复原unload方法不能正确卸载的问题
-+ 功能新增: 主模块卸载现在既可以定义在__unload__方法中，也可以定义在unload方法中。可以根据自己喜好选择一个即可。
-+ 功能调整: 模块加载和重新加载前，会自动调用模块的__unload__方法或unload方法（若有）
++ 重大更新: 完全重写了模块的加载、卸载、重新加载方法，修复模块使用中的问题
++ 功能调整: 现在只要将一个类型继承 IConfig 接口，即被识别为配置类型。这种类型在模块加载时会自动创建其实例。当然，名称为Configuration的类型也同样被认为是配置类型，保持向前兼容性。唯一要求是，该类型的构造函数允许仅传递一个session对象。
++ 功能新增: 各类配置类型的卸载现在既可以定义在__unload__方法中，也可以定义在unload方法中。可以根据自己喜好选择一个即可。
++ 功能调整: 各配置类型加载和重新加载前，会自动调用模块的__unload__方法或unload方法（若有）
 + 功能新增: Command基类增加__unload__方法和unload方法，二者在从会话中移除该 Command 时均会自动调用。自定义的Command子类应覆盖这两种方法中的一种方法，并在其中增加清除类型自行创建的 Trigger, Alias 等会话对象。这样，模块卸载时只要移除命令本身，在命令中新建的其他关联对象将被一同移除。
++ 功能新增: 所有PyMUD基础对象类型及其子类型，包括 Alias, Trigger, Timer, Command, GMCPTrigger 及它们的子类型，在创建的时候会自动添加到会话中，无需再进行 addObject 等操作了
 + 问题修复: 修复部分正则表达式书写错误问题
 + 功能新增: Session类新增waitfor函数，用于执行一段代码后立即等待某个触发器的情况，简化原三行代码写法
 
@@ -766,11 +779,6 @@ Requires-Dist: prompt-toolkit
     - 使用示例:
 
     ```Python
-        # 所有对象均可以使用 addObject 直接添加到会话中，而不用管是什么具体类型
-        session.addObject(Timer(...))
-        session.addObject(Trigger(...))
-        session.addObject(Alias(...))
-
         # 所有对象均可以使用 delObject 直接从会话中移除，会自动根据对象类型推断，无需通过函数名区分
         session.delObject(self.tri1)
         session.delObject(self.ali1)
@@ -784,7 +792,6 @@ Requires-Dist: prompt-toolkit
             GMCPTrigger(session, xxx)
         ]
 
-        session.addObjects(objs)    # 可以直接将一个数组中所有对象添加到会话中，会自动判断各对象类别
         session.delObjects(objs)    # 可以直接从会话中移除一个数组中的所有对象，会自动判断对象类别
     ```
 
@@ -792,6 +799,10 @@ Requires-Dist: prompt-toolkit
 + 功能新增: Session的所有异步命令调用函数增加返回值，现在调用 session.exec_async, exec_command_async 等方法执行的内容若匹配为命令时，会返回最后最后一个 Command 对象的 execute 函数的返回值
     - 例如， result = await self.session.cmds.cmd_runto.execute('rt yz') 与 result = await self.session.exec_async('rt yz') 等价，返回值相同
     - 但     result = await self.session.exec_async('rt yz;dzt')，该返回的result 仅是 dzt 命令的 execute 的返回值。 rt yz 命令返回值被丢弃。
++ 功能新增: 增加临时变量概念，变量名以下划线开头的为临时变量，此类变量不会被保存到 .mud 文件中。
++ 功能新增: 为 BaseObject 基类的 self.session 增加了 Session 类型限定，现在自定义 Command 等时候，使用 self.session 时会有 IntelliSence 函数智能提示了，所有帮助说明已补全
++ 问题修复: 修复 #var 等命令中，若含有中文则等号位置不对齐的问题
++ 功能调整: 在 #tri 等命令中，当对象的 group 为空时，将不再显示 group 属性，减少无用信息
 
 ## 0.19.4 (2024-04-20)
 + 功能调整: info 现在 msg 恢复为可接受任何类型参数，不一定是 str

{pymud-0.20.0a4 → pymud-0.20.1}/README.md

@@ -1,7 +1,7 @@
 # PyMUD - Python原生MUD客户端
 ## 简介
 
-### 帮助文件见北侠WIKI：  https://www.pkuxkx.net/wiki/tools/pymud
+### 北侠WIKI：  https://www.pkuxkx.net/wiki/tools/pymud
 ### 源代码地址: https://github.com/crapex/pymud
 ### 帮助文档地址： https://pymud.readthedocs.org
 ### PyPi项目地址： https://pypi.org/project/pymud
@@ -23,9 +23,20 @@
 + Python拥有极为丰富的第三方库，能支持的第三方库，就能在PyMud中支持
 + 我自己还在玩，所以本客户端会持续进行更新:)
 
+### 哪些人适合使用PyMUD
++ 比较熟悉Python语言，会使用Python写代码的 -> PyMUD是纯Python原生开发，不会有其他客户端对Python的支持能比得过PyMUD
++ 虽不太熟悉Python语言，但有想法想学习Python语言的 -> 正好使用PyMUD玩北侠写脚本的过程中学习Python语言
++ 觉得还有些功能现在所有客户端都没有的 -> 你有需求，我来增加，就是这么方便
++ 觉得也想自己整一个定制客户端玩玩的 -> PyMUD完全开源，且除ui框架外全部都是一行一行代码自己写的，可以直接参考PyMUD的设计
+
 ## 版本更新信息
 
-## 0.20.0 (2024-08-XX)
+### 0.20.1 (2024-11-16)
++ 功能调整: 会话中触发器匹配实现进行部分调整，减少循环次数以提高响应速度
++ 功能调整: #test / #show 触发器测试功能调整，现在会对使能的和未使能的触发器均进行匹配测试。其中，#show 命令仅测试，而 #test 命令会导致触发器真正响应。
++ 功能新增: pymud对象新增了一个持续运行的1s的周期定时任务。该任务中会刷新页面显示。可以使用 session.application.addTimerTickCallback 和 session.application.removeTimerTickCallback 来注册和解除定时器回调。
+
+## 0.20.0 (2024-08-25)
 + 功能调整: 将模块主入口函数从__main__.py中移动到main.py中，以使可以在当前目录下，可直接使用pymud，也可使用python -m pymud启动
 + 功能调整: 使用argsparser标准模块来配置命令行，可以使用 pymud -h 查看命令行具体参数及说明
 + 功能新增: 命令行参数增加指定启动目录的功能，参数为 -s, --startup_dir。即可以从任意目录通过指定脚本目录方式启动PyMUD了。
@@ -37,10 +48,12 @@
 + 功能调整: 在没有session的时候，也可以执行#exit命令
 + 功能新增: #session 命令增加快捷创建会话功能，假如已有快捷菜单 世界->pkuxkx->newstart , 则可以通过 #session pkuxkx.newstart 直接创建该会话，效果等同于点击该菜单
 + 功能调整: 点击菜单创建会话时，若会话已存在，则将该会话切换为当前会话
-+ 问题修复: 修复原unload方法不能正确卸载的问题
-+ 功能新增: 主模块卸载现在既可以定义在__unload__方法中，也可以定义在unload方法中。可以根据自己喜好选择一个即可。
-+ 功能调整: 模块加载和重新加载前，会自动调用模块的__unload__方法或unload方法（若有）
++ 重大更新: 完全重写了模块的加载、卸载、重新加载方法，修复模块使用中的问题
++ 功能调整: 现在只要将一个类型继承 IConfig 接口，即被识别为配置类型。这种类型在模块加载时会自动创建其实例。当然，名称为Configuration的类型也同样被认为是配置类型，保持向前兼容性。唯一要求是，该类型的构造函数允许仅传递一个session对象。
++ 功能新增: 各类配置类型的卸载现在既可以定义在__unload__方法中，也可以定义在unload方法中。可以根据自己喜好选择一个即可。
++ 功能调整: 各配置类型加载和重新加载前，会自动调用模块的__unload__方法或unload方法（若有）
 + 功能新增: Command基类增加__unload__方法和unload方法，二者在从会话中移除该 Command 时均会自动调用。自定义的Command子类应覆盖这两种方法中的一种方法，并在其中增加清除类型自行创建的 Trigger, Alias 等会话对象。这样，模块卸载时只要移除命令本身，在命令中新建的其他关联对象将被一同移除。
++ 功能新增: 所有PyMUD基础对象类型及其子类型，包括 Alias, Trigger, Timer, Command, GMCPTrigger 及它们的子类型，在创建的时候会自动添加到会话中，无需再进行 addObject 等操作了
 + 问题修复: 修复部分正则表达式书写错误问题
 + 功能新增: Session类新增waitfor函数，用于执行一段代码后立即等待某个触发器的情况，简化原三行代码写法
 
@@ -60,11 +73,6 @@
     - 使用示例:
 
     ```Python
-        # 所有对象均可以使用 addObject 直接添加到会话中，而不用管是什么具体类型
-        session.addObject(Timer(...))
-        session.addObject(Trigger(...))
-        session.addObject(Alias(...))
-
         # 所有对象均可以使用 delObject 直接从会话中移除，会自动根据对象类型推断，无需通过函数名区分
         session.delObject(self.tri1)
         session.delObject(self.ali1)
@@ -78,7 +86,6 @@
             GMCPTrigger(session, xxx)
         ]
 
-        session.addObjects(objs)    # 可以直接将一个数组中所有对象添加到会话中，会自动判断各对象类别
         session.delObjects(objs)    # 可以直接从会话中移除一个数组中的所有对象，会自动判断对象类别
     ```
 
@@ -86,6 +93,10 @@
 + 功能新增: Session的所有异步命令调用函数增加返回值，现在调用 session.exec_async, exec_command_async 等方法执行的内容若匹配为命令时，会返回最后最后一个 Command 对象的 execute 函数的返回值
     - 例如， result = await self.session.cmds.cmd_runto.execute('rt yz') 与 result = await self.session.exec_async('rt yz') 等价，返回值相同
     - 但     result = await self.session.exec_async('rt yz;dzt')，该返回的result 仅是 dzt 命令的 execute 的返回值。 rt yz 命令返回值被丢弃。
++ 功能新增: 增加临时变量概念，变量名以下划线开头的为临时变量，此类变量不会被保存到 .mud 文件中。
++ 功能新增: 为 BaseObject 基类的 self.session 增加了 Session 类型限定，现在自定义 Command 等时候，使用 self.session 时会有 IntelliSence 函数智能提示了，所有帮助说明已补全
++ 问题修复: 修复 #var 等命令中，若含有中文则等号位置不对齐的问题
++ 功能调整: 在 #tri 等命令中，当对象的 group 为空时，将不再显示 group 属性，减少无用信息
 
 ## 0.19.4 (2024-04-20)
 + 功能调整: info 现在 msg 恢复为可接受任何类型参数，不一定是 str

{pymud-0.20.0a4 → pymud-0.20.1}/pyproject.toml

@@ -1,17 +1,17 @@
 [project]
 
 name = "pymud"  # Required
-version = "0.20.0a4"  # Required
+version = "0.20.1"  # Required
 description = "a MUD Client written in Python"  # Optional
 readme = "README.md" # Optional
 requires-python = ">=3.7"
 license = {file = "LICENSE.txt"}
 keywords = ["MUD", "multi-user dungeon", "client"]  # Optional
 authors = [
-  {name = "newstart@pkuxkx", email = "crapex@crapex.cc" } # Optional
+  {name = "newstart@pkuxkx", email = "crapex@hotmail.com" } # Optional
 ]
 maintainers = [
-  {name = "newstart@pkuxkx", email = "crapex@crapex.cc" } # Optional
+  {name = "newstart@pkuxkx", email = "crapex@hotmail.com" } # Optional
 ]
 
 classifiers = [  # Optional
@@ -19,8 +19,8 @@ classifiers = [  # Optional
   #   3 - Alpha
   #   4 - Beta
   #   5 - Production/Stable
-  # "Development Status :: 5 - Production/Stable",
-  "Development Status :: 3 - Alpha",
+  "Development Status :: 5 - Production/Stable",
+  # "Development Status :: 3 - Alpha",
   "Intended Audience :: End Users/Desktop",
   "Topic :: Games/Entertainment :: Multi-User Dungeons (MUD)",
   "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",

{pymud-0.20.0a4 → pymud-0.20.1}/src/pymud/__init__.py

@@ -1,5 +1,6 @@
 from .settings import Settings
 from .pymud import PyMudApp
+from .modules import IConfig
 from .objects import CodeBlock, Alias, SimpleAlias, Trigger, SimpleTrigger, Command, SimpleCommand, Timer, SimpleTimer, GMCPTrigger
 from .extras import DotDict
 from .session import Session
@@ -7,5 +8,5 @@ from .logger import Logger
 from .main import main
 
 __all__ = [
-    "PyMudApp", "Settings", "CodeBlock", "Alias", "SimpleAlias", "Trigger", "SimpleTrigger", "Command", "SimpleCommand", "Timer", "SimpleTimer", "GMCPTrigger", "Session", "PyMudApp", "DotDict", "Logger", "main"
+    "IConfig", "PyMudApp", "Settings", "CodeBlock", "Alias", "SimpleAlias", "Trigger", "SimpleTrigger", "Command", "SimpleCommand", "Timer", "SimpleTimer", "GMCPTrigger", "Session", "PyMudApp", "DotDict", "Logger", "main"
 ]

{pymud-0.20.0a4 → pymud-0.20.1}/src/pymud/dialogs.py

@@ -1,7 +1,7 @@
 import asyncio, webbrowser
 
 from prompt_toolkit.layout import AnyContainer, ConditionalContainer, Float, VSplit, HSplit, Window, WindowAlign, ScrollablePane, ScrollOffsets
-from prompt_toolkit.widgets import Button, Dialog, Label, MenuContainer, MenuItem, TextArea, SystemToolbar, Frame, RadioList
+from prompt_toolkit.widgets import Button, Dialog, Label, MenuContainer, MenuItem, TextArea, SystemToolbar, Frame, RadioList 
 from prompt_toolkit.layout.dimension import Dimension, D
 from prompt_toolkit import ANSI, HTML
 from prompt_toolkit.mouse_events import MouseEvent, MouseEventType
@@ -133,12 +133,14 @@ class LogSelectionDialog(BasicDialog):
     def __init__(self, text, values, modal=True):
         self._header_text = text
         self._selection_values = values
-        self._radio_list = RadioList(values = self._selection_values)
+        self._itemsCount = len(values)
+        if len(values) > 0:
+            self._radio_list = RadioList(values = self._selection_values)
+        else:
+            self._radio_list = Label('无记录'.center(13))
         super().__init__('选择查看的记录', modal)
 
     def create_body(self) -> AnyContainer:
-        
-
         body=HSplit([
             Label(text = self._header_text, dont_extend_height=True), 
             self._radio_list
@@ -151,6 +153,9 @@ class LogSelectionDialog(BasicDialog):
         return [ok_button, cancel_button]
     
     def btn_ok_clicked(self):
-        result = self._radio_list.current_value
-        self.set_done(result)
+        if self._itemsCount:
+            result = self._radio_list.current_value
+            self.set_done(result)
+        else:
+            self.set_done(False)
     

{pymud-0.20.0a4 → pymud-0.20.1}/src/pymud/extras.py

@@ -1,8 +1,7 @@
 # External Libraries
 from unicodedata import east_asian_width
 from wcwidth import wcwidth
-from typing import Any
-import time, datetime
+import time, re, logging
 
 from typing import Iterable
 from prompt_toolkit import ANSI
@@ -65,6 +64,10 @@ class MudFormatProcessor(Processor):
         self.FULL_BLOCKS = set("▂▃▅▆▇▄█")
         self.SINGLE_LINES = set("┌└├┬┼┴╭╰─")
         self.DOUBLE_LINES = set("╔╚╠╦╪╩═")
+        self.START_COLOR_REGX  = re.compile(r"^\[[\d;]+m")
+        self.COLOR_REGX   = re.compile(r"\[[\d;]+m")
+        self._color_start = ""
+        self._color_correction = False
 
     def width_correction(self, line: str) -> str:
         new_str = []
@@ -88,11 +91,36 @@ class MudFormatProcessor(Processor):
     def tab_correction(self, line: str):
         return line.replace("\t", " " * Settings.client["tabstop"])
 
+    def color_correction(self, line: str):
+        # 注：发现processer处理并非自上而下逐行处理的，因此不能使用这种颜色校正方式。
+        if self._color_correction:
+            other = self.COLOR_REGX.findall(line)
+
+            line = f"{self._color_start}{line}"
+            logging.debug(f"已校正增加颜色标志 {self._color_start}: {line}")
+
+            if other:
+                self._color_correction = False
+                self._color_start = ""
+                logging.debug(f"颜色校正结束: {line}")
+        else:
+            color = self.START_COLOR_REGX.findall(line)
+            if color:
+                other = self.COLOR_REGX.findall(line)
+                if len(other) == 1:
+                    self._color_correction = True
+                    self._color_start = color[0]
+                    logging.debug(f"获取到一个颜色开头 {color[0]}: {line}")
+
+        return line
+
     def line_correction(self, line: str):
         # 处理\r符号（^M）
         line = self.return_correction(line)
         # 处理Tab(\r)符号（^I）
         line = self.tab_correction(line)
+        # 处理颜色跨行问题。发现processer处理并非自上而下逐行处理的，因此不能使用这种颜色校正方式。
+        # line = self.color_correction(line)
         # 美化（解决中文英文在Console中不对齐的问题）
         if Settings.client["beautify"]:
             line = self.width_correction(line)
@@ -430,9 +458,9 @@ class SessionBufferControl(BufferControl):
 
                     if double_click:
                         start = buffer.document.translate_row_col_to_index(position.y, 0)
-                        end = buffer.document.translate_row_col_to_index(position.y, 10000000)
+                        end = buffer.document.translate_row_col_to_index(position.y + 1, 0) - 1
                         buffer.cursor_position = start
-                        buffer.start_selection(selection_type=SelectionType.CHARACTERS)
+                        buffer.start_selection(selection_type=SelectionType.LINES)
                         buffer.cursor_position = end
 
                 else:
@@ -1008,76 +1036,5 @@ class DotDict(dict):
     def __setstate__(self, state):
         self.update(state)
 
-import importlib
-import importlib.util
-
-class Plugin:
-    """
-    插件管理类。对加载的插件文件进行管理。该类型由PyMudApp进行管理，无需人工创建。
-
-    有关插件的详细信息，请参见 `插件 <plugins.html>`_
-
-    :param name: 插件的文件名, 如'myplugin.py'
-    :param location: 插件所在的目录。自动加载的插件包括PyMUD包目录下的plugins目录以及当前目录下的plugins目录
-
-    """
-    def __init__(self, name, location):
-        self._plugin_file = name
-        self._plugin_loc  = location
-
-        self.reload()
-
-    def reload(self):
-        "加载/重新加载插件对象"
-        #del self.modspec, self.mod
-        self.modspec = importlib.util.spec_from_file_location(self._plugin_file[:-3], self._plugin_loc)
-        self.mod     = importlib.util.module_from_spec(self.modspec)
-        self.modspec.loader.exec_module(self.mod)
-
-        self._app_init = self.mod.__dict__["PLUGIN_PYMUD_START"]
-        self._session_create = self.mod.__dict__["PLUGIN_SESSION_CREATE"]
-        self._session_destroy = self.mod.__dict__["PLUGIN_SESSION_DESTROY"]
-        
-    @property
-    def name(self):
-        "插件名称，由插件文件中的 PLUGIN_NAME 常量定义"
-        return self.mod.__dict__["PLUGIN_NAME"]
-    
-    @property
-    def desc(self):
-        "插件描述，由插件文件中的 PLUGIN_DESC 常量定义"
-        return self.mod.__dict__["PLUGIN_DESC"]
-    
-    @property
-    def help(self):
-        "插件帮助，由插件文件中的文档字符串定义"
-        return self.mod.__doc__
-    
-    def onAppInit(self, app):
-        """
-        PyMUD应用启动时对插件执行的操作，由插件文件中的 PLUGIN_PYMUD_START 函数定义
-
-        :param app: 启动的 PyMudApp 对象实例
-        """
-        self._app_init(app)
-
-    def onSessionCreate(self, session):
-        """
-        新会话创建时对插件执行的操作，由插件文件中的 PLUGIN_SESSION_CREATE 函数定义
-
-        :param session: 新创建的会话对象实例
-        """
-        self._session_create(session)
-
-    def onSessionDestroy(self, session):
-        """
-        会话关闭时（注意不是断开）对插件执行的操作，由插件文件中的 PLUGIN_SESSION_DESTROY 函数定义
-
-        :param session: 所关闭的会话对象实例
-        """
-        self._session_destroy(session)
 
-    def __getattr__(self, __name: str) -> Any:
-        if hasattr(self.mod, __name):
-            return self.mod.__getattribute__(__name)
         

{pymud-0.20.0a4 → pymud-0.20.1}/src/pymud/logger.py

@@ -1,9 +1,10 @@
-import os, re, datetime, threading
+import os, re, datetime, threading, pathlib
 from queue import SimpleQueue, Empty
+from pathlib import Path
 
 class Logger:
     """
-    PyMUD 的记录器类型，可用于会话中向文件记录数据
+    PyMUD 的记录器类型，可用于会话中向文件记录数据。记录文件保存在当前目录下的 log 子目录中
     
     :param name: 记录器名称，各记录器名称应保持唯一。记录器名称会作为记录文件名称的主要参数
     :param mode: 记录模式。可选模式包括 a, w, n 三种。
@@ -56,7 +57,12 @@ class Logger:
                     now = datetime.datetime.now().strftime("%Y_%m_%d_%H_%M_%S")
                     filename = f"{self.name}.{now}.log"
 
-                filename = os.path.abspath(filename)
+                logdir = Path.cwd().joinpath('log')
+                if not logdir.exists() or not logdir.is_dir():
+                    logdir.mkdir()
+
+                filename = logdir.joinpath(filename)
+                #filename = os.path.abspath(filename)
                 self._stream = open(filename, mode = mode, encoding = self._encoding, errors = self._errors)
                 self._thread = t = threading.Thread(target=self._monitor)
                 t.daemon = True

pymud-0.20.1/src/pymud/modules.py

@@ -0,0 +1,188 @@
+
+import importlib, importlib.util
+from abc import ABC, ABCMeta
+from typing import Any
+from .objects import BaseObject, Command
+
+class ModuleInfo:
+    """
+    模块管理类。对加载的模块文件进行管理。该类型由Session类进行管理，无需人工创建和干预。
+
+    有关模块的分类和使用的详细信息，请参见 `脚本 <scripts.html>`_
+
+    :param module_name: 模块的名称, 应与 import xxx 语法中的 xxx 保持一致
+    :param session: 加载/创建本模块的会话
+
+    """
+    def __init__(self, module_name: str, session):
+        self.session = session
+        self._name = module_name 
+        self._ismainmodule = False
+        self.load()
+       
+    def _load(self, reload = False):
+        result = True
+        if reload:
+            self._module = importlib.reload(self._module)
+        else:
+            self._module = importlib.import_module(self.name)
+        self._config = {}
+        for attr_name in dir(self._module):
+            attr = getattr(self._module, attr_name)
+            if isinstance(attr, type) and attr.__module__ == self._module.__name__:
+                if (attr_name == "Configuration") or issubclass(attr, IConfig):
+                    try:
+                        self._config[f"{self.name}.{attr_name}"] = attr(self.session, reload = reload)
+                        self.session.info(f"配置对象 {self.name}.{attr_name} {'重新' if reload else ''}创建成功.")
+                    except Exception as e:
+                        result = False
+                        self.session.error(f"配置对象 {self.name}.{attr_name} 创建失败. 错误信息为: {e}")
+        self._ismainmodule = (self._config != {})
+        return result
+    
+    def _unload(self):
+        for key, config in self._config.items():
+            if isinstance(config, Command):
+                # Command 对象在从会话中移除时，自动调用其 unload 系列方法，因此不能产生递归
+                self.session.delObject(config)
+            
+            else:
+
+                if hasattr(config, "__unload__"):
+                    unload = getattr(config, "__unload__", None)
+                    if callable(unload): unload()
+                    
+                if hasattr(config, "unload"):
+                    unload = getattr(config, "unload", None)
+                    if callable(unload): unload()
+
+                if isinstance(config, BaseObject):
+                    self.session.delObject(config)
+
+            del config
+        self._config.clear()
+
+    def load(self):
+        "加载模块内容"
+        if self._load():
+            self.session.info(f"{'主' if self.ismainmodule else '从'}配置模块 {self.name} 加载完成.")
+        else:
+            self.session.error(f"{'主' if self.ismainmodule else '从'}配置模块 {self.name} 加载失败.")
+
+    def unload(self):
+        "卸载模块内容"
+        self._unload()
+        self._loaded = False
+        self.session.info(f"{'主' if self.ismainmodule else '从'}配置模块 {self.name} 卸载完成.")
+
+    def reload(self):
+        "模块文件更新后调用，重新加载已加载的模块内容"
+        self._unload()
+        self._load(reload = True)
+        self.session.info(f"{'主' if self.ismainmodule else '从'}配置模块 {self.name} 重新加载完成.")
+
+    @property
+    def name(self):
+        "只读属性，模块名称"
+        return self._name
+
+    @property
+    def module(self):
+        "只读属性，模块文件的 ModuleType 对象"
+        return self._module
+    
+    @property
+    def config(self):
+        "只读字典属性，根据模块文件 ModuleType 对象创建的其中名为 Configuration 的类型或继承自 IConfig 的子类型实例（若有）"
+        return self._config
+    
+    @property
+    def ismainmodule(self):
+        "只读属性，区分是否主模块（即包含具体config的模块）"
+        return self._ismainmodule
+
+class IConfig(metaclass = ABCMeta):
+    """
+    用于提示PyMUD应用是否自动创建该配置类型的基础类（模拟接口）。
+    
+    继承 IConfig 类型让应用自动管理该类型，唯一需要的是，构造函数中，仅存在一个必须指定的参数 Session。
+
+    在应用自动创建 IConfig 实例时，除 session 参数外，还会传递一个 reload 参数 （bool类型），表示是首次加载还是重新加载特性。
+    可以从kwargs 中获取该参数，并针对性的设计相应代码。例如，重新加载相关联的其他模块等。
+    """
+    def __init__(self, session, *args, **kwargs):
+        self.session = session
+
+    def __unload__(self):
+        if self.session:
+            self.session.delObject(self)
+
+class Plugin:
+    """
+    插件管理类。对加载的插件文件进行管理。该类型由PyMudApp进行管理，无需人工创建。
+
+    有关插件的详细信息，请参见 `插件 <plugins.html>`_
+
+    :param name: 插件的文件名, 如'myplugin.py'
+    :param location: 插件所在的目录。自动加载的插件包括PyMUD包目录下的plugins目录以及当前目录下的plugins目录
+
+    """
+    def __init__(self, name, location):
+        self._plugin_file = name
+        self._plugin_loc  = location
+
+        self.reload()
+
+    def reload(self):
+        "加载/重新加载插件对象"
+        #del self.modspec, self.mod
+        self.modspec = importlib.util.spec_from_file_location(self._plugin_file[:-3], self._plugin_loc)
+        self.mod     = importlib.util.module_from_spec(self.modspec)
+        self.modspec.loader.exec_module(self.mod)
+
+        self._app_init = self.mod.__dict__["PLUGIN_PYMUD_START"]
+        self._session_create = self.mod.__dict__["PLUGIN_SESSION_CREATE"]
+        self._session_destroy = self.mod.__dict__["PLUGIN_SESSION_DESTROY"]
+        
+    @property
+    def name(self):
+        "插件名称，由插件文件中的 PLUGIN_NAME 常量定义"
+        return self.mod.__dict__["PLUGIN_NAME"]
+    
+    @property
+    def desc(self):
+        "插件描述，由插件文件中的 PLUGIN_DESC 常量定义"
+        return self.mod.__dict__["PLUGIN_DESC"]
+    
+    @property
+    def help(self):
+        "插件帮助，由插件文件中的文档字符串定义"
+        return self.mod.__doc__
+    
+    def onAppInit(self, app):
+        """
+        PyMUD应用启动时对插件执行的操作，由插件文件中的 PLUGIN_PYMUD_START 函数定义
+
+        :param app: 启动的 PyMudApp 对象实例
+        """
+        self._app_init(app)
+
+    def onSessionCreate(self, session):
+        """
+        新会话创建时对插件执行的操作，由插件文件中的 PLUGIN_SESSION_CREATE 函数定义
+
+        :param session: 新创建的会话对象实例
+        """
+        self._session_create(session)
+
+    def onSessionDestroy(self, session):
+        """
+        会话关闭时（注意不是断开）对插件执行的操作，由插件文件中的 PLUGIN_SESSION_DESTROY 函数定义
+
+        :param session: 所关闭的会话对象实例
+        """
+        self._session_destroy(session)
+
+    def __getattr__(self, __name: str) -> Any:
+        if hasattr(self.mod, __name):
+            return self.mod.__getattribute__(__name)