fantas.debug

调试模块,可以启动一个独立的调试子进程。

重要

启动调试之后,必须使用 fantas.Window.mainloop_debug()fantas.MultiWindow.mainloop_debug() 来运行主循环,否则调试功能无法正常工作。

class fantas.debug.Debug

调试工具类,提供启动调试窗口、发送调试数据等功能。

process: Popen[str] | None = None

调试窗口子进程对象

queue: Queue[tuple] = <queue.Queue object>

调试子进程返回队列

debug_flag: DebugFlag = 0

当前调试选项标志

udp_socket: socket = <socket.socket fd=14, family=2, type=2, proto=0, laddr=('127.0.0.1', 50600)>

UDP 通信套接字

reading: bool = False

是否正在读取子进程输出

debug_port: int = 0

调试窗口子进程的接收端口号

static start_debug(flag: DebugFlag = <DebugFlag.ALL: 7>, windows_title: str = 'fantas 调试窗口') None

启动调试窗口子进程。

参数:
  • flag (DebugFlag) -- 调试选项标志,默认为 DebugFlag.ALL。

  • windows_title (str) -- 调试窗口标题,默认为 "fantas 调试窗口"。

static close_debug() None

关闭调试窗口子进程。

static set_sendto_port(port: int) None

设置调试窗口进程的接收端口号。

参数:

port (int) -- 目标端口号。

static send_debug_data(*data: object, prompt: str = 'Debug') None

发送调试数据到调试窗口子进程。

参数:
  • data (object) -- 要发送的调试数据对象。

  • prompt (str) -- 调试提示信息。

static read_debug_data() None

从调试窗口子进程读取输出信息并放入队列。

static start_read_thread() None

启动读取调试窗口子进程输出的后台线程。

static add_debug_flag(flag: DebugFlag) None

添加指定的调试选项标志。

参数:

flag (DebugFlag) -- 要添加的调试选项标志。

static delete_debug_flag(flag: DebugFlag) None

删除指定的调试选项标志。

参数:

flag (DebugFlag) -- 要删除的调试选项标志。

class fantas.debug.DebugFlag(*values)

调试选项标志枚举。

EVENTLOG = 1

事件日志

TIMERECORD = 2

时间记录

MOUSEMAGNIFY = 4

鼠标放大镜

ALL = 7

全部调试选项

NONE = 0

无调试选项