pymud 0.20.0a1__py3-none-any.whl → 0.20.0a2__py3-none-any.whl

pymud/__main__.py

@@ -1,4 +1,5 @@
-import sys, os, json, platform, shutil, logging, argparse
+import os, json, platform, shutil, logging, argparse
+from pathlib import Path
 from .pymud import main
 from .settings import Settings
 
@@ -43,34 +44,26 @@ CFG_TEMPLATE = {
 def init_pymud_env(args):
     print(f"欢迎使用PyMUD, 版本{Settings.__version__}. 使用PyMUD时, 建议建立一个新目录（任意位置），并将自己的脚本以及配置文件放到该目录下.")
     print("即将开始为首次运行初始化环境...")
-    system = platform.system().lower()
-
+    
     dir = args.dir
     if dir:
-        print(f"你已经指定了创建脚本的目录为 {args.dir}, 将不再检测操作系统")
-
+        print(f"你已经指定了创建脚本的目录为 {args.dir}")
+        dir = Path(dir)
     else:
-        if system == "windows":
-            dir = input("检测到当前系统为Windows, 请指定游戏脚本的目录（若目录不存在会自动创建），直接回车表示使用默认值[d:\pkuxkx]:")
-            if not dir: dir = "d:\\pkuxkx"
-
-        elif system == "linux":
-            dir = input("检测到当前系统为Linux, 请指定游戏脚本的目录（若目录不存在会自动创建），直接回车表示使用默认值[~/pkuxkx]:")
-            if not dir: dir = "~/pkuxkx"
-
-        elif system == "darwin":
-            dir = input("检测到当前系统为MacOS, 请指定游戏脚本的目录（若目录不存在会自动创建），直接回车表示使用默认值[~/pkuxkx]:")
-            if not dir: dir = "~/pkuxkx"
-
-        else:
-            print(f"当前系统不是Windows、Linux或MacOS, 无法通过init来进行配置, 请手动配置. 默认配置即将推出")
-
-
-    if not os.path.exists(dir):
-        print(f'检测到给定目录 {dir} 不存在，正在创建目录...', end = "")
-        os.mkdir(dir)
-        os.chdir(dir)
-        print(f'完成!')
+        dir = Path.home().joinpath('pkuxkx')
+
+        system = platform.system().lower()
+        dir_enter = input(f"检测到当前系统为 {system}, 请指定游戏脚本的目录（若目录不存在会自动创建），直接回车表示使用默认值 [{dir}]:")
+        if dir_enter:
+            dir = Path(dir_enter)
+                      
+    if dir.exists() and dir.is_dir():
+        print(f'检测到给定目录 {dir} 已存在，切换至此目录...')
+    else:
+        print(f'检测到给定目录 {dir} 不存在，正在创建并切换至目录...')
+        dir.mkdir()
+    
+    os.chdir(dir)
 
     if os.path.exists('pymud.cfg'):
         print(f'检测到脚本目录下已存在pymud.cfg文件，将直接使用此文件进入PyMUD...')

pymud/pymud.py

@@ -663,6 +663,7 @@ class PyMudApp:
                         plugin.onSessionDestroy(self.current_session)
 
                 name = self.current_session.name
+                self.current_session.closeLoggers()
                 self.current_session.clean()
                 self.current_session = None
                 self.consoleView.buffer = SessionBuffer()

pymud/session.py

@@ -116,9 +116,6 @@ class Session:
         self._events["connected"]    = None
         self._events["disconnected"] = None
 
-        self._loggers = dict()
-        self.log = self.getLogger(name)
-
         self._auto_script = kwargs.get("scripts", None)
 
         self._cmds_handler = dict()                         # 支持的命令的处理函数字典
@@ -144,6 +141,9 @@ class Session:
 
         self.initialize()
 
+        self._loggers = dict()
+        self.log = self.getLogger(name)
+
         self.host = host
         self.port = port
         self.encoding = encoding or self.encoding
@@ -176,6 +176,10 @@ class Session:
         if Settings.client["auto_connect"]:
             self.open()
 
+    def __del__(self):
+        self.clean()
+        self.closeLoggers()
+
     def initialize(self):
         "初始化Session有关对象。 **无需脚本调用。**"
         self._line_buffer = bytearray()
@@ -376,6 +380,15 @@ class Session:
 
         return logger
 
+    def closeLoggers(self):
+        "移除本会话所有相关Logger"
+        for name in self._loggers.keys():
+            if isinstance(self._loggers[name], Logger):
+                self._loggers[name].enabled = False
+            
+            if name in self.application.loggers.keys():
+                self.application.loggers.pop(name)
+
     @property
     def modules(self) -> OrderedDict:
         """
@@ -758,6 +771,27 @@ class Session:
             cmd = line + self.newline
             self.write(cmd.encode(self.encoding, Settings.server["encoding_errors"]))
     
+    async def waitfor(self, line: str, awaitable, wait_time = 0.05) -> None:
+        """
+        调用writline向服务器中写入一行后，等待到可等待对象再返回。
+        
+        :param line: 使用writeline写入的行
+        :param awaitable: 等待的可等待对象
+        :param wait_time: 写入行前等待的延时，单位为s。默认0.05
+
+        由于异步的消息循环机制，如果在写入命令之后再创建可等待对象，则有可能服务器响应在可等待对象的创建之前
+        此时使用await就无法等待到可等待对象的响应，会导致任务出错。
+        一种解决方式是先创建可等待对象，然后写入命令，然后再等待可等待对象，但这种情况下需要写入三行代码，书写麻烦
+        因此该函数是用于简化此类使用时的写法。
+
+        示例:
+            await session.waitfor('a_cmd', self.create_task(a_tri.triggered()))
+            done, pending = await session.waitfor('a_cmd', asyncio.wait([self.create_task(a_tri.triggered()), self.create_task(b_tri.triggered())], return_when = 'FIRST_COMPLETED'))
+        """
+        await asyncio.sleep(wait_time)
+        self.writeline(line)
+        return await awaitable
+
     def exec(self, cmd: str, name = None, *args, **kwargs):
         """
         在名称为name的会话中使用exec_command执行MUD命令。当不指定name时，在当前会话中执行。

pymud/settings.py

@@ -11,9 +11,9 @@ class Settings:
     "APP 名称, 默认PYMUD"
     __appdesc__   = "a MUD client written in Python"
     "APP 简要描述"
-    __version__   = "0.20.0"
+    __version__   = "0.20.0a2"
     "APP 当前版本"
-    __release__   = "2024-08-14"
+    __release__   = "2024-08-19"
     "APP 当前版本发布日期"
     __author__    = "本牛(newstart)@北侠"
     "APP 作者"

{pymud-0.20.0a1.dist-info → pymud-0.20.0a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pymud
-Version: 0.20.0a1
+Version: 0.20.0a2
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@crapex.cc>
 Maintainer-email: "newstart@pkuxkx" <crapex@crapex.cc>
@@ -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 :: 5 - Production/Stable
+Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Topic :: Games/Entertainment :: Multi-User Dungeons (MUD)
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
@@ -971,8 +971,14 @@ Requires-Dist: prompt-toolkit
 + 功能调整: 变量替代时，会自动实现类型转化，当被替代变量值为非 str 类型时不会再报错
 + 问题修复: 修复之前从后向前选择时，无法复制的问题
 
-### 0.19.5 (2024-08-XX)
+### 0.20.0a1 (2024-08-14)
++ 功能调整: 使用argsparser标准模块来配置命令行，可以使用 python -m pymud -h 查看命令行具体参数及说明
 + 功能调整: 恢复在__init__.py中增加PyMudApp的导出，可以恢复使用from pymud import PyMudApp了
 + 功能调整: 在没有session的时候，也可以执行#exit命令
 + 功能调整: 模块加载和重新加载前，会自动调用模块的unload方法（若有）
-+ 功能新增: 增加log功能（待设计）
++ 功能新增: 增加log功能，详见 #log 命令介绍、类参考中的 Logger 类，以及 Session 类的 handle_log 方法
+
+### 0.20.0a2 (2024-08-19)
++ 问题修复: 关闭会话时未关闭相关记录器，导致后续会话无法启动
++ 问题修复: MacOS下 python -m pymud init 创建目录报错的问题。同时，将所有系统上的默认目录均使用 ~/pkuxkx （影响windows）
++ 功能新增: Session类新增waitfor函数，用于执行一段代码后立即等待某个触发器的情况，简化原三行代码写法

pymud-0.20.0a2.dist-info/RECORD

@@ -0,0 +1,17 @@
+pymud/__init__.py,sha256=Ep6JrWv2wwlLV5nI7F6BOA7Ei6yVgnxvhIRwFGPr2Oc,501
+pymud/__main__.py,sha256=vE5mi5WFyiUPGLfq-1sMrEpHoD2Vxiy5XXenmoXFA1c,6230
+pymud/dialogs.py,sha256=D0ZtCeoBchF5eYzXumkOi3p-maCQZu4v9-wJgxQ790o,6500
+pymud/extras.py,sha256=QwWwLavVtuXfg0Qb0f_040va1_kej27P-ZB_19HB6Qk,42422
+pymud/logger.py,sha256=39I_rFBU5MEiOTJyU7GAy9cY_MpYHKiXNgBhpokQrTA,5358
+pymud/objects.py,sha256=0aUc-PZfVSdYPEAamY0eO6k3P9wJcw6PNxfSE8eZZeE,38072
+pymud/pkuxkx.py,sha256=vWXHU6GF0HQ0eWb3LmxFVRP0cKnigffCX7Z-LJvwVtw,11496
+pymud/protocol.py,sha256=QfDXjlg2OcJXmVoXf_3mAemnYotRXDUlEZNQjhkfXdA,49106
+pymud/pymud.py,sha256=yAd6nz_ltM3B0fDwMGvaa-tpMlZycZEGJ5E4rZb9Nx4,48235
+pymud/session.py,sha256=Q1ylk9-5tZGI4maMfDRqzq8Ca6vzG4SivzjxfrpUk84,122932
+pymud/settings.py,sha256=3FDAgW97SEQfWb9HR6n2U-rQYKxclQXnfaRuo2o0ly0,7147
+pymud-0.20.0a2.dist-info/LICENSE.txt,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+pymud-0.20.0a2.dist-info/METADATA,sha256=eFQxv8YNREut-zvVzsCf7uAfM3DAxFOi_vvX4uQITCA,68829
+pymud-0.20.0a2.dist-info/WHEEL,sha256=HiCZjzuy6Dw0hdX5R3LCFPDmFS4BWl8H-8W39XfmgX4,91
+pymud-0.20.0a2.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
+pymud-0.20.0a2.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
+pymud-0.20.0a2.dist-info/RECORD,,

pymud-0.20.0a1.dist-info/RECORD

@@ -1,17 +0,0 @@
-pymud/__init__.py,sha256=Ep6JrWv2wwlLV5nI7F6BOA7Ei6yVgnxvhIRwFGPr2Oc,501
-pymud/__main__.py,sha256=ybi8pA0BXCZJ_GWgndllT7f1FBBE2tGNCByN0zkaSu0,6748
-pymud/dialogs.py,sha256=D0ZtCeoBchF5eYzXumkOi3p-maCQZu4v9-wJgxQ790o,6500
-pymud/extras.py,sha256=QwWwLavVtuXfg0Qb0f_040va1_kej27P-ZB_19HB6Qk,42422
-pymud/logger.py,sha256=39I_rFBU5MEiOTJyU7GAy9cY_MpYHKiXNgBhpokQrTA,5358
-pymud/objects.py,sha256=0aUc-PZfVSdYPEAamY0eO6k3P9wJcw6PNxfSE8eZZeE,38072
-pymud/pkuxkx.py,sha256=vWXHU6GF0HQ0eWb3LmxFVRP0cKnigffCX7Z-LJvwVtw,11496
-pymud/protocol.py,sha256=QfDXjlg2OcJXmVoXf_3mAemnYotRXDUlEZNQjhkfXdA,49106
-pymud/pymud.py,sha256=2dbgnzlG9476esOfyp9sv-lRSTpMuRaCXnqrOofOu24,48182
-pymud/session.py,sha256=uAWt0-AZWpDvVfCjzoxWDpuOwCQ8s1DN_DZ-rVAC5xs,121232
-pymud/settings.py,sha256=XkyFWTskPGZljuWCaC8cU18ie8-FkecEtb0h3OfcfjU,7145
-pymud-0.20.0a1.dist-info/LICENSE.txt,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-pymud-0.20.0a1.dist-info/METADATA,sha256=N57G7pGHXWfYKJ2YwJjWFMSYxvfkvwIpmsTKTR1hjro,68201
-pymud-0.20.0a1.dist-info/WHEEL,sha256=HiCZjzuy6Dw0hdX5R3LCFPDmFS4BWl8H-8W39XfmgX4,91
-pymud-0.20.0a1.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
-pymud-0.20.0a1.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
-pymud-0.20.0a1.dist-info/RECORD,,