pymud 0.21.2a2__tar.gz → 0.21.3__tar.gz

{pymud-0.21.2a2 → pymud-0.21.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymud
-Version: 0.21.2a2
+Version: 0.21.3
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@hotmail.com>
 Maintainer-email: "newstart@pkuxkx" <crapex@hotmail.com>
@@ -44,11 +44,11 @@ Dynamic: license-file
 
 ### 北大侠客行Mud (www.pkuxkx.net)，最好的中文Mud游戏！
 ### PyMUD是我为了更好的玩北大侠客行，特意自行开发的MUD客户端。PyMUD具有以下特点：
-+ 原生Python开发，除prompt-toolkit及其依赖库（wcwidth, pygment, pyperclip)外，不需要其他第三方库支持
++ 原生Python开发，除prompt-toolkit及其依赖库 wcwidth, pygment, pyperclip 外，不需要其他第三方库支持
 + 原生Python的asyncio实现的通信协议处理，支持async/await语法在脚本中直接应用，脚本实现的同步异步两种模式由你自己选择
-+ 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作）
++ 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作），极低资源需求，在单核1GB内存的Linux VPS上也可流畅运行
 + 支持分屏显示，在数据快速滚动的时候，上半屏保持不动，以确保不错过信息
-+ 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题（因为我没有走遍所有地方，不敢保证100%）
++ 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题
 + 真正的支持多session会话，支持命令或鼠标切换会话
 + 原生支持多种服务器端编码方式，不论是GBK、BIG5、还是UTF-8
 + 支持NWAS、MTTS协商，支持GMCP、MSDP、MSSP协议
@@ -66,10 +66,17 @@ Dynamic: license-file
 
 ## 版本更新信息
 
-### 0.22.0 (2025-05-31) 本版传错了，已无法使用。
+### 0.21.3 （2025-06-02）
+
++ 问题修复: 修复了当缓存行数超过规定值时，由于代码错误导致清屏的问题。
++ 功能增强: 增加清除任务时的异常保护，此时产生asyncio.CancelledError异常为正常现象，因此捕获后禁止异常处理。
++ 功能增强: 对reset进行了异常提示保护，此时产生异常（大部分为asyncio.CancelledError）为正常现象，因此捕获后禁止异常处理。
+
+### 0.21.2 (2025-06-01)
 
 + 问题修复: 修复了当自动重连启动时，即使会话关闭了，也会自动重连的问题。
-+ 实现调整: 重写了专用的SessionBuffer与SessionBufferControl，降低内存使用。
++ 实现调整: 重写了专用的会话缓冲、记录缓冲与PyMud缓冲显示控制器，在prompt_toolkit的原Buffer和BufferControl的基础仅提供了PYMUD所需的基础功能，以降低内存占用。
+  经测试，当前内存基本稳定，视会话数量和脚本情况差异，维持在几百兆左右（500M以下），且不会有大幅波动。重写后，低配置的VPS也可以稳定运行PyMUD。
 
 ### 0.21.0 (2025-05-20)
 

{pymud-0.21.2a2 → pymud-0.21.3}/README.md

@@ -12,11 +12,11 @@
 
 ### 北大侠客行Mud (www.pkuxkx.net)，最好的中文Mud游戏！
 ### PyMUD是我为了更好的玩北大侠客行，特意自行开发的MUD客户端。PyMUD具有以下特点：
-+ 原生Python开发，除prompt-toolkit及其依赖库（wcwidth, pygment, pyperclip)外，不需要其他第三方库支持
++ 原生Python开发，除prompt-toolkit及其依赖库 wcwidth, pygment, pyperclip 外，不需要其他第三方库支持
 + 原生Python的asyncio实现的通信协议处理，支持async/await语法在脚本中直接应用，脚本实现的同步异步两种模式由你自己选择
-+ 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作）
++ 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作），极低资源需求，在单核1GB内存的Linux VPS上也可流畅运行
 + 支持分屏显示，在数据快速滚动的时候，上半屏保持不动，以确保不错过信息
-+ 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题（因为我没有走遍所有地方，不敢保证100%）
++ 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题
 + 真正的支持多session会话，支持命令或鼠标切换会话
 + 原生支持多种服务器端编码方式，不论是GBK、BIG5、还是UTF-8
 + 支持NWAS、MTTS协商，支持GMCP、MSDP、MSSP协议
@@ -34,10 +34,17 @@
 
 ## 版本更新信息
 
-### 0.22.0 (2025-05-31) 本版传错了，已无法使用。
+### 0.21.3 （2025-06-02）
+
++ 问题修复: 修复了当缓存行数超过规定值时，由于代码错误导致清屏的问题。
++ 功能增强: 增加清除任务时的异常保护，此时产生asyncio.CancelledError异常为正常现象，因此捕获后禁止异常处理。
++ 功能增强: 对reset进行了异常提示保护，此时产生异常（大部分为asyncio.CancelledError）为正常现象，因此捕获后禁止异常处理。
+
+### 0.21.2 (2025-06-01)
 
 + 问题修复: 修复了当自动重连启动时，即使会话关闭了，也会自动重连的问题。
-+ 实现调整: 重写了专用的SessionBuffer与SessionBufferControl，降低内存使用。
++ 实现调整: 重写了专用的会话缓冲、记录缓冲与PyMud缓冲显示控制器，在prompt_toolkit的原Buffer和BufferControl的基础仅提供了PYMUD所需的基础功能，以降低内存占用。
+  经测试，当前内存基本稳定，视会话数量和脚本情况差异，维持在几百兆左右（500M以下），且不会有大幅波动。重写后，低配置的VPS也可以稳定运行PyMUD。
 
 ### 0.21.0 (2025-05-20)
 

{pymud-0.21.2a2 → pymud-0.21.3}/pyproject.toml

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

{pymud-0.21.2a2 → pymud-0.21.3}/src/pymud/extras.py

@@ -1,9 +1,10 @@
 # External Libraries
+from functools import lru_cache
 from unicodedata import east_asian_width
 from wcwidth import wcwidth
 from dataclasses import dataclass
-import time, re, logging
-
+import time, re, logging, linecache, os
+from typing import Optional, List, Dict
 from typing import Iterable, NamedTuple, Optional, Union, Tuple
 from prompt_toolkit import ANSI
 from prompt_toolkit.application import get_app
@@ -236,7 +237,7 @@ class VSplitWindow(Window):
             below = total - upper - 1
             
             #if isNotMargin:
-            if isinstance(self.content, SessionBufferControl):
+            if isinstance(self.content, PyMudBufferControl):
                 b = self.content.buffer
                 if not b:
                     return y
@@ -379,7 +380,7 @@ class VSplitWindow(Window):
         if info is None:
             return
 
-        if isinstance(self.content, SessionBufferControl):
+        if isinstance(self.content, PyMudBufferControl):
             b = self.content.buffer
             if not b:
                 return
@@ -396,7 +397,7 @@ class VSplitWindow(Window):
         if info is None:
             return
 
-        if isinstance(self.content, SessionBufferControl):
+        if isinstance(self.content, PyMudBufferControl):
             b = self.content.buffer
             if not b:
                 return
@@ -520,6 +521,7 @@ class EasternMenuContainer(MenuContainer):
 
         return Window(FormattedTextControl(get_text_fragments), style="class:menu")
 
+
 @dataclass
 class SessionSelectionState:
     start_row: int = -1
@@ -549,9 +551,53 @@ class SessionSelectionState:
             return self.end_row - self.start_row + 1
         else:
             return 0
-    
 
-class SessionBuffer:
+
+class BufferBase:
+    def __init__(self, name, newline = "\n", max_buffered_lines = 10000) -> None:
+        self.name = name
+        self.newline = newline
+        self.max_buffered_lines = max_buffered_lines
+        self.start_lineno = -1
+        self.selection = SessionSelectionState(-1, -1, -1, -1)
+
+    def clear(self):
+        pass
+
+    @property
+    def lineCount(self) -> int:
+        return 0
+
+    def getLine(self, lineno: int) -> str:
+        return ""
+
+    # 获取指定某行到某行的内容。当start未设置时，从首行开始。当end未设置时，到最后一行结束。
+    # 注意判断首位顺序逻辑，以及给定参数是否越界
+    def selection_range_at_line(self, lineno: int) -> Optional[Tuple[int, int]]:
+        if self.selection.is_valid():
+            if self.selection.rows > 1:
+                if lineno == self.selection.start_row:
+                    return (self.selection.start_col, len(self.getLine(lineno)) - 1)
+                elif lineno == self.selection.end_row:
+                    return (0, self.selection.end_col)
+                elif lineno > self.selection.start_row and lineno < self.selection.end_row:
+                    return (0, len(self.getLine(lineno)) - 1)
+
+            elif self.selection.rows == 1:
+                if lineno == self.selection.start_row:
+                    return (self.selection.start_col, self.selection.end_col)
+
+        return None
+
+    def exit_selection(self):
+        self.selection = SessionSelectionState(-1, -1, -1, -1)
+
+    def nosplit(self):
+        self.start_lineno = -1
+        get_app().invalidate()
+
+
+class SessionBuffer(BufferBase):
     def __init__(
         self, 
         name, 
@@ -559,13 +605,10 @@ class SessionBuffer:
         max_buffered_lines = 10000,
         ) -> None:
 
-        self.name = name
-        self.lines = []
-        self.newline = newline
-        self.isnewline = True
-        self.max_buffered_lines = max_buffered_lines
-        self.selection = SessionSelectionState(-1, -1, -1, -1)
-        self.start_lineno = -1
+        super().__init__(name, newline, max_buffered_lines)
+
+        self._lines : List[str] = []
+        self._isnewline = True
 
     def append(self, line: str):
         """
@@ -578,25 +621,25 @@ class SessionBuffer:
             line = line.rstrip(self.newline)
             newline_after_append = True
         if not self.newline in line:
-            if self.isnewline:
-                self.lines.append(line)
+            if self._isnewline:
+                self._lines.append(line)
             else:
-                self.lines[-1] += line
+                self._lines[-1] += line
 
         else:
             lines = line.split(self.newline)
-            if self.isnewline:
-                self.lines.extend(lines)
+            if self._isnewline:
+                self._lines.extend(lines)
             else:
-                self.lines[-1] += lines[0]
-                self.lines.extend(lines[1:])
+                self._lines[-1] += lines[0]
+                self._lines.extend(lines[1:])
 
-        self.isnewline = newline_after_append
+        self._isnewline = newline_after_append
 
         ## limit buffered lines
-        if len(self.lines) > self.max_buffered_lines:
-            diff = self.max_buffered_lines - len(self.lines)
-            del self.lines[:diff]
+        if len(self._lines) > self.max_buffered_lines:
+            diff = len(self._lines) - self.max_buffered_lines
+            del self._lines[:diff]
             ## adjust selection
             if self.selection.start_row >= 0:
                 self.selection.start_row -= diff
@@ -605,68 +648,60 @@ class SessionBuffer:
         get_app().invalidate()
 
     def clear(self):
-        self.lines.clear()
+        self._lines.clear()
         self.selection = SessionSelectionState(-1, -1, -1, -1)
 
         get_app().invalidate()
 
-    def loadfile(self, filename, encoding = 'utf-8', errors = 'ignore'):
-        with open(filename, 'r', encoding = encoding, errors = errors) as fp:
-            lines = fp.readlines()
-            self.clear()
-            self.lines.extend(lines)
-
-            get_app().invalidate()
-
     @property
     def lineCount(self):
-        return len(self.lines)
+        return len(self._lines)
         
-    def getLine(self, lineno):
-        if lineno < 0 or lineno >= len(self.lines):
+    def getLine(self, lineno: int):
+        if lineno < 0 or lineno >= len(self._lines):
             return ""
-        return self.lines[lineno]
+        return self._lines[lineno]
 
-    # 获取指定某行到某行的内容。当start未设置时，从首行开始。当end未设置时，到最后一行结束。
-    # 注意判断首位顺序逻辑，以及给定参数是否越界
-    def getLines(self, start = None, end = None):
-        if start is None:
-            start = 0
-        if end is None:
-            end = len(self.lines) - 1
-        if start < 0:
-            start = 0
-        if end >= len(self.lines):
-            end = len(self.lines) - 1
-        if start > end:
-            return []
-        return self.lines[start:end+1]
-
-    def selection_range_at_line(self, lineno):
-        if self.selection.is_valid():
-            if self.selection.rows > 1:
-                if lineno == self.selection.start_row:
-                    return (self.selection.start_col, len(self.lines[lineno]) - 1)
-                elif lineno == self.selection.end_row:
-                    return (0, self.selection.end_col)
-                elif lineno > self.selection.start_row and lineno < self.selection.end_row:
-                    return (0, len(self.lines[lineno]) - 1)
 
-            elif self.selection.rows == 1:
-                if lineno == self.selection.start_row:
-                    return (self.selection.start_col, self.selection.end_col)
+class LogFileBuffer(BufferBase):
+    def __init__(
+        self,
+        name,
+        filepath: Optional[str] = None,
+        ) -> None:
 
-        return None
+        super().__init__(name)
+        self._lines : Dict[int, str] = {}
+        self.loadfile(filepath)
+        
+    def loadfile(self, filepath: Optional[str] = None):
+        if filepath and os.path.exists(filepath):
+            self.filepath = filepath
+        else:
+            self.filepath = None
 
-    def exit_selection(self):
-        self.selection = SessionSelectionState(-1, -1, -1, -1)
+    def clear(self):
+        self.filepath = None
 
-    def nosplit(self):
-        self.start_lineno = -1
-        get_app().invalidate()
+    @property
+    def lineCount(self):
+        if not self.filepath or not os.path.exists(self.filepath):
+            return 0
+
+        with open(self.filepath, 'r', encoding = 'utf-8', errors = 'ignore') as fp:
+            return sum(1 for _ in fp)
+
+    def getLine(self, lineno: int):
+        if not self.filepath or not os.path.exists(self.filepath):
+            return ""
 
-class SessionBufferControl(UIControl):
-    def __init__(self, buffer: Optional[SessionBuffer]) -> None:
+        return linecache.getline(self.filepath, lineno).rstrip(self.newline)
+
+    def __del__(self):
+        self._lines.clear()
+
+class PyMudBufferControl(UIControl):
+    def __init__(self, buffer: Optional[BufferBase]) -> None:
         self.buffer = buffer
 
         # 为MUD显示进行校正的处理，包括对齐校正，换行颜色校正等
@@ -685,7 +720,7 @@ class SessionBufferControl(UIControl):
         # Default reset. (Doesn't have to be implemented.)
         pass
 
-    def preferred_width(self, max_available_width: int) -> int | None:
+    def preferred_width(self, max_available_width: int) -> Optional[int]:
         return None
 
     def is_focusable(self) -> bool:
@@ -746,10 +781,14 @@ class SessionBufferControl(UIControl):
         def get_line(i: int) -> StyleAndTextTuples:
             line = buffer.getLine(i)
             # 颜色校正
+            SEARCH_LINES = 10
             thislinecolors = len(self.AVAI_COLOR_REGX.findall(line))
             if thislinecolors == 0:
                 lineno = i - 1
-                while lineno >= 0:
+                search = 0
+                while lineno >= 0 and search < SEARCH_LINES:
+                    search += 1
+
                     lastline = buffer.getLine(lineno)
                     allcolors = self.ALL_COLOR_REGX.findall(lastline)
                     
@@ -885,6 +924,9 @@ class SessionBufferControl(UIControl):
                 else:
                     # Don't handle scroll events here.
                     return NotImplemented
+            else:
+                # Don't handle scroll events here.
+                return NotImplemented
 
         # Not focused, but focusing on click events.
         else:

{pymud-0.21.2a2 → pymud-0.21.3}/src/pymud/objects.py

@@ -793,12 +793,14 @@ class Command(MatchObject):
         """
         复位命令，并取消和清除所有本对象管理的任务。
         """
+        try:
+            super().reset()
 
-        super().reset()
-
-        for task in list(self._tasks):
-            if isinstance(task, asyncio.Task) and (not task.done()):
-                self.remove_task(task)
+            for task in list(self._tasks):
+                if isinstance(task, asyncio.Task) and (not task.done()):
+                    self.remove_task(task)
+        except:
+            pass
 
     async def execute(self, cmd, *args, **kwargs) -> Any:
         """

{pymud-0.21.2a2 → pymud-0.21.3}/src/pymud/pymud.py

@@ -37,7 +37,7 @@ from prompt_toolkit.auto_suggest import AutoSuggestFromHistory
 from wcwidth import wcwidth, wcswidth
 
 from .objects import CodeBlock
-from .extras import SessionBuffer, SessionBufferControl, EasternMenuContainer, VSplitWindow, DotDict, MenuItem
+from .extras import BufferBase, LogFileBuffer, SessionBuffer, PyMudBufferControl, EasternMenuContainer, VSplitWindow, DotDict, MenuItem
 from .modules import Plugin
 from .session import Session
 from .settings import Settings
@@ -164,7 +164,7 @@ class PyMudApp:
         self.logFileShown = ''          # 记录页显示的记录文件名
         #self.logSessionBuffer = SessionBuffer()
         #self.logSessionBuffer.name = "LOGBUFFER"
-        self.logSessionBuffer = SessionBuffer("LOGBUFFER", max_buffered_lines = -1)
+        self.logSessionBuffer = LogFileBuffer("LOGBUFFER")
 
         self.load_plugins()
 
@@ -218,7 +218,7 @@ class PyMudApp:
             show_cursor=False
         )
 
-        self.consoleView = SessionBufferControl(
+        self.consoleView = PyMudBufferControl(
             buffer = None,
             )
         
@@ -398,7 +398,7 @@ class PyMudApp:
         else:
             b = None
             
-        if isinstance(b, SessionBuffer):
+        if isinstance(b, BufferBase):
             if lines < 0:
                 if b.start_lineno < 0:
                     self.console._scroll_up()
@@ -659,7 +659,7 @@ class PyMudApp:
             if os.path.exists(filename):
                 lock = threading.RLock()
                 lock.acquire()
-                self.logSessionBuffer.loadfile(filename, encoding = 'utf-8', errors = 'ignore')
+                self.logSessionBuffer.loadfile(filename)
                 lock.release()
 
             #self.logSessionBuffer.cursor_position = len(self.logSessionBuffer.text)
@@ -751,7 +751,7 @@ class PyMudApp:
 
         elif self.showLog:
             b = self.logSessionBuffer
-            b.exit_selection()
+            #b.exit_selection()
             #b.cursor_position = len(b.text)
             #b.start_lineno = -1
             b.nosplit()

{pymud-0.21.2a2 → pymud-0.21.3}/src/pymud/session.py

@@ -571,16 +571,6 @@ class Session:
             self._line_count += 1
             self.log.log(self.newline_cli)
 
-    def clear_half(self):
-        """
-        清除半数缓冲。 **脚本中无需调用。**
-
-        半数的数量由 Settings.client['buffer_lines'] 确定，默认为5000行。
-        """
-        # if (Settings.client["buffer_lines"] > 0) and (self._line_count >= 2 * Settings.client["buffer_lines"]) and self.buffer.document.is_cursor_at_the_end:
-        #     self._line_count = self.buffer.clear_half()
-        pass
-
     def feed_data(self, data) -> None:
         """
         由协议对象调用，将收到的远程数据加入会话缓冲。永远只会传递1个字节的数据，以bytes形式。 **脚本中无需调用。**
@@ -695,7 +685,6 @@ class Session:
 
         # 将数据写入缓存添加到此处
         if len(self.display_line) > 0:
-            self.clear_half()
             self.writetobuffer(self.display_line)
 
     def set_exception(self, exc: Exception):
@@ -747,8 +736,14 @@ class Session:
         :param task: 由本会话管理的一个 asyncio.Task 对象
         :param msg: 本意是用来反馈 task.cancel() 时的消息，但为了保持兼容低版本Python环境，该参数并未使用。
         """
-        result = task.cancel()
-        self._tasks.discard(task)
+
+        result = True
+        try:
+            result = task.cancel()
+            self._tasks.discard(task)
+            
+        except asyncio.CancelledError:
+            pass
 
         return result
 

{pymud-0.21.2a2 → pymud-0.21.3}/src/pymud.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymud
-Version: 0.21.2a2
+Version: 0.21.3
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@hotmail.com>
 Maintainer-email: "newstart@pkuxkx" <crapex@hotmail.com>
@@ -44,11 +44,11 @@ Dynamic: license-file
 
 ### 北大侠客行Mud (www.pkuxkx.net)，最好的中文Mud游戏！
 ### PyMUD是我为了更好的玩北大侠客行，特意自行开发的MUD客户端。PyMUD具有以下特点：
-+ 原生Python开发，除prompt-toolkit及其依赖库（wcwidth, pygment, pyperclip)外，不需要其他第三方库支持
++ 原生Python开发，除prompt-toolkit及其依赖库 wcwidth, pygment, pyperclip 外，不需要其他第三方库支持
 + 原生Python的asyncio实现的通信协议处理，支持async/await语法在脚本中直接应用，脚本实现的同步异步两种模式由你自己选择
-+ 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作）
++ 基于控制台的全屏UI界面设计，支持鼠标操作（Android上支持触摸屏操作），极低资源需求，在单核1GB内存的Linux VPS上也可流畅运行
 + 支持分屏显示，在数据快速滚动的时候，上半屏保持不动，以确保不错过信息
-+ 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题（因为我没有走遍所有地方，不敢保证100%）
++ 解决了99%情况下，北大侠客行中文对不齐，也就是看不清字符画的问题
 + 真正的支持多session会话，支持命令或鼠标切换会话
 + 原生支持多种服务器端编码方式，不论是GBK、BIG5、还是UTF-8
 + 支持NWAS、MTTS协商，支持GMCP、MSDP、MSSP协议
@@ -66,10 +66,17 @@ Dynamic: license-file
 
 ## 版本更新信息
 
-### 0.22.0 (2025-05-31) 本版传错了，已无法使用。
+### 0.21.3 （2025-06-02）
+
++ 问题修复: 修复了当缓存行数超过规定值时，由于代码错误导致清屏的问题。
++ 功能增强: 增加清除任务时的异常保护，此时产生asyncio.CancelledError异常为正常现象，因此捕获后禁止异常处理。
++ 功能增强: 对reset进行了异常提示保护，此时产生异常（大部分为asyncio.CancelledError）为正常现象，因此捕获后禁止异常处理。
+
+### 0.21.2 (2025-06-01)
 
 + 问题修复: 修复了当自动重连启动时，即使会话关闭了，也会自动重连的问题。
-+ 实现调整: 重写了专用的SessionBuffer与SessionBufferControl，降低内存使用。
++ 实现调整: 重写了专用的会话缓冲、记录缓冲与PyMud缓冲显示控制器，在prompt_toolkit的原Buffer和BufferControl的基础仅提供了PYMUD所需的基础功能，以降低内存占用。
+  经测试，当前内存基本稳定，视会话数量和脚本情况差异，维持在几百兆左右（500M以下），且不会有大幅波动。重写后，低配置的VPS也可以稳定运行PyMUD。
 
 ### 0.21.0 (2025-05-20)