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

pymud/main.py

@@ -1,142 +0,0 @@
-import os, sys, json, platform, shutil, logging, argparse
-from pathlib import Path
-from .pymud import PyMudApp
-from .settings import Settings
-
-CFG_TEMPLATE = {
-    "client": {
-        "buffer_lines"      : 5000,                 # 保留缓冲行数
-
-        "interval"          : 10,                   # 在自动执行中，两次命令输入中的间隔时间（ms）
-        "auto_connect"      : True,                 # 创建会话后，是否自动连接
-        "auto_reconnect"    : False,                # 在会话异常断开之后，是否自动重连
-        "var_autosave"      : True,                 # 断开时自动保存会话变量
-        "var_autoload"      : True,                 # 初始化时自动加载会话变量
-
-        "echo_input"        : False,
-        "beautify"          : True,                 # 专门为解决控制台下PKUXKX字符画对不齐的问题
-
-        "status_display"    : 1,                    # 状态窗口显示情况设置，0-不显示，1-显示在下方，2-显示在右侧
-        "status_height"     : 4,                    # 下侧状态栏的高度
-        "status_width"      : 30,                   # 右侧状态栏的宽度
-
-    },
-    "sessions" : {
-        "pkuxkx" : {
-            "host" : "mud.pkuxkx.net",
-            "port" : "8081",
-            "encoding" : "utf8",
-            "autologin" : "{0};{1}",
-            "default_script": "examples",
-            "chars" : {
-                "display_title" : ["yourid", "yourpassword", ""],
-            }
-        }
-    },
-    "keys" : {
-        "f3"    : "#ig",
-        "f4"    : "#clear",
-        "f11"   : "#close",
-        "f12"   : "#exit",
-    }
-}
-
-def init_pymud_env(args):
-    print(f"欢迎使用PyMUD, 版本{Settings.__version__}. 使用PyMUD时, 建议建立一个新目录（任意位置），并将自己的脚本以及配置文件放到该目录下.")
-    print("即将开始为首次运行初始化环境...")
-    
-    dir = args.dir
-    if dir:
-        print(f"你已经指定了创建脚本的目录为 {args.dir}")
-        dir = Path(dir)
-    else:
-        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...')
-    else:
-        print(f'检测到脚本目录下不存在pymud.cfg文件，将使用默认内容创建该配置文件...')
-        with open('pymud.cfg', mode = 'x') as fp:
-            fp.writelines(json.dumps(CFG_TEMPLATE, indent = 4))
-
-    if not os.path.exists('examples.py'):
-        from pymud import pkuxkx
-        module_dir = pkuxkx.__file__
-        shutil.copyfile(module_dir, 'examples.py')
-        print(f'已将样例脚本拷贝至脚本目录，并加入默认配置文件')
-
-    print(f"后续可自行修改 {dir} 目录下的 pymud.cfg 文件以进行配置。")
-    if system == "windows":
-        print(f"后续运行PyMUD， 请在 {dir} 目录下键入命令： python -m pymud")
-    else:
-        print(f"后续运行PyMUD， 请在 {dir} 目录下键入命令： python3 -m pymud")
-
-    input('所有内容已初始化完毕, 请按回车进入PyMUD.')
-
-    startApp(args)
-
-def startApp(args):
-    startup_path = Path(args.startup_dir).resolve()
-    sys.path.append(f"{startup_path}")
-    os.chdir(startup_path)
-
-    if args.debug:
-        logging.basicConfig(level = logging.NOTSET,
-            format = '%(asctime)s %(name)-12s %(levelname)-8s %(message)s',
-            datefmt = '%m-%d %H:%M',
-            filename = args.logfile,
-            filemode = 'a' if args.filemode else 'w',
-            encoding = "utf-8"
-            )
-        
-    else:
-        logging.basicConfig(level = logging.NOTSET,
-            format = '%(asctime)s %(name)-12s: %(message)s',
-            datefmt = '%m-%d %H:%M',
-            handlers = [logging.NullHandler()],
-            )
-
-    cfg = startup_path.joinpath("pymud.cfg")
-    cfg_data = None
-    if os.path.exists(cfg):
-        with open(cfg, "r", encoding="utf8", errors="ignore") as fp:
-            cfg_data = json.load(fp)
-
-    app = PyMudApp(cfg_data)
-    app.run()
-
-def main():
-    parser = argparse.ArgumentParser(prog = "pymud", description = "PyMUD命令行参数帮助")
-    subparsers = parser.add_subparsers(help = 'init用于初始化运行环境')
-
-    par_init = subparsers.add_parser('init', description = '初始化pymud运行环境, 包括建立脚本目录, 创建默认配置文件, 创建样例脚本等.')
-    par_init.add_argument('-d', '--dir', dest = 'dir', metavar = 'dir', type = str, default = '', help = '指定构建脚本目录的名称, 不指定时会根据操作系统选择不同默认值')
-    par_init.set_defaults(func = init_pymud_env)
-
-    parser.add_argument('-d', '--debug', dest = 'debug', action = 'store_true', default = False, help = '指定以调试模式进入PyMUD。此时，系统log等级将设置为logging.NOTSET, 所有log数据均会被记录。默认不启用。')
-    parser.add_argument('-l', '--logfile', dest = 'logfile', metavar = 'logfile', default = 'pymud.log', help = '指定调试模式下记录文件名，不指定时，默认为当前目录下的pymud.log')
-    parser.add_argument('-a', '--appendmode', dest = 'filemode', action = 'store_true', default = True, help = '指定log文件的访问模式是否为append尾部添加模式，默认为True。当为False时，使用w模式，即每次运行清空之前记录')
-    parser.add_argument('-s', '--startup_dir', dest = 'startup_dir', metavar = 'startup_dir', default = '.', help = '指定启动目录，默认为当前目录。使用该参数可以在任何目录下，通过指定脚本目录来启动')
-
-    args=parser.parse_args()
-
-    if hasattr(args, 'func'):
-        args.func(args)
-    else:
-        startApp(args)
-
-if __name__ == "__main__":
-    main()

pymud/modules.py

@@ -1,188 +0,0 @@
-
-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)

pymud-0.20.0.dist-info/RECORD

@@ -1,19 +0,0 @@
-pymud/__init__.py,sha256=AP4Edhx90gMKrNfD1O_KVciA3SOnyX5Qt9fZY_JhsTY,574
-pymud/__main__.py,sha256=hFzZjadLlcOuoLM7D8wFiFVO8mqF7vMuo9y-9xfIhRc,64
-pymud/dialogs.py,sha256=p-LidObSuDyOeMif5CsqhF5qq3rizZ1lmThWHrxDyRg,6726
-pymud/extras.py,sha256=NGCCEevCUTD9HfZGv7SDB3GDst-51_xzGQdiDQj-lUA,39777
-pymud/logger.py,sha256=gtGm8y9RY_CpRpJ0udgKknRxyjsEPrrRyWecUDgBgZM,5662
-pymud/main.py,sha256=b_Ui_cN4W8IfhYNyc1duwr3Bp7pYYZQusKTSafCWZIA,6534
-pymud/modules.py,sha256=XoqTeYfZCgqDsV3SYxeehzsbkTzs0swelAUIxyWuL9g,7423
-pymud/objects.py,sha256=HAgH8zfBGJR_BJDmna4-daA3JQGA2jg_7Y_rIZYL2-k,39197
-pymud/pkuxkx.py,sha256=jRQRUs2xtw7GzYHtLYZXOASnqMumKh0iCoOeKZs8NnU,11467
-pymud/protocol.py,sha256=QfDXjlg2OcJXmVoXf_3mAemnYotRXDUlEZNQjhkfXdA,49106
-pymud/pymud.py,sha256=2N1fTTaMljPc2Y4FYOtVnVZSgVpH3g75wofo1JhKw1E,50452
-pymud/session.py,sha256=6mCbzoZEehH9TFV5utQwbWin1Qa4nFcBjdrMY9zL7DU,131305
-pymud/settings.py,sha256=XqTiHZRr6otc30PfiC4PIbAT-Y6uKMR_D0Tflqz6nNU,7145
-pymud-0.20.0.dist-info/LICENSE.txt,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-pymud-0.20.0.dist-info/METADATA,sha256=5I7qQ2wwFo4FQ2bkcacHcHLFGTFXrHwzX-aLEdpVhBk,73733
-pymud-0.20.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
-pymud-0.20.0.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
-pymud-0.20.0.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
-pymud-0.20.0.dist-info/RECORD,,