Files
douyi_guaji_main/gui/components/mapping_table.py
T
CodexandClaude Opus 4.7 053ffa3469 refactor(gui): 拆出 mapping_table.py 5 个 UI 辅助子函数(659→482,-177 行)
mapping_table.create_mapping_tab 是单个 632 行的 tkinter 闭包巨型函数,
把其中相对独立的 5 个块抽到 mapping_table_helpers:
- open_entry_detail_window:弹出条目详情(原代码出现 2 次)
- compute_card_layout:根据画布宽度计算列数和卡片宽度
- set_card_bg:批量切换 widget + 子 widget 背景色
- make_card_event_handlers:单卡片的 click/dbl/enter/leave 处理器工厂
- render_card_labels:渲染单卡片内的 title + meta + body label

逻辑保持等价,只是提取闭包消除重复嵌套。新增 8 个单元测试覆盖
compute_card_layout / API 表面,1026 → 1034 用例全过。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 01:51:52 +08:00

483 lines
17 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import json
import os
import time
import tkinter as tk
from tkinter import ttk
from typing import Any, List
from datetime import datetime
try:
from . import mapping_utils
except Exception:
try:
import gui.components.mapping_utils as mapping_utils
except Exception:
mapping_utils = None
try:
from . import mapping_table_helpers as _mt_helpers
except Exception:
import gui.components.mapping_table_helpers as _mt_helpers
try:
from ttkbootstrap.scrolled import ScrolledText as TBSrolledText
ScrolledText = TBSrolledText
except Exception:
try:
from tkinter.scrolledtext import ScrolledText
except Exception:
ScrolledText = None
def create_mapping_tab(root: tk.Tk, notebook: ttk.Notebook, cfg: dict) -> ttk.Frame:
"""创建并返回映射表 Tab(文本样式,类似预约队列)"""
mapping_tab = ttk.Frame(notebook)
map_box = ttk.LabelFrame(mapping_tab, text="运行时映射表(文本样式)")
map_box.pack(fill=tk.BOTH, expand=True, padx=10, pady=(10, 10))
map_ctrl = ttk.Frame(map_box)
map_ctrl.pack(fill=tk.X, padx=10, pady=(8, 6))
map_auto_refresh_var = tk.BooleanVar(value=True)
ttk.Checkbutton(
map_ctrl, text="自动刷新(5s)", variable=map_auto_refresh_var
).pack(side=tk.LEFT)
refresh_btn = ttk.Button(map_ctrl, text="刷新映射表", width=12)
refresh_btn.pack(side=tk.LEFT, padx=(8, 6))
mapping_source_var = tk.StringVar(value="未加载")
ttk.Label(map_ctrl, textvariable=mapping_source_var).pack(side=tk.LEFT, padx=(8, 0))
show_title_raw_var = tk.BooleanVar(value=False)
show_title_raw_chk = ttk.Checkbutton(
map_ctrl, text="显示原始标题", variable=show_title_raw_var
)
show_title_raw_chk.pack(side=tk.LEFT, padx=(8, 6))
mapping_text_box = ttk.Frame(map_box)
mapping_text_box.pack(fill=tk.BOTH, expand=True, padx=10, pady=(6, 10))
# 使用 Canvas + Frame 的卡片式布局以获得更高档的样式和更好的可读性
canvas = tk.Canvas(mapping_text_box, borderwidth=0, highlightthickness=0)
vscroll = ttk.Scrollbar(mapping_text_box, orient="vertical", command=canvas.yview)
canvas.configure(yscrollcommand=vscroll.set)
vscroll.pack(side="right", fill="y")
canvas.pack(side="left", fill="both", expand=True)
inner_frame = ttk.Frame(canvas)
window_id = canvas.create_window((0, 0), window=inner_frame, anchor="nw")
def _on_inner_configure(event: object | None = None) -> None:
try:
canvas.configure(scrollregion=canvas.bbox("all"))
except Exception:
pass
def _on_canvas_configure(event: object | None = None) -> None:
try:
canvas.itemconfigure(window_id, width=event.width)
except Exception:
pass
inner_frame.bind("<Configure>", _on_inner_configure)
canvas.bind("<Configure>", _on_canvas_configure)
# 鼠标滚轮支持(进入时绑定,离开时解绑),兼容 Windows/macOS/Linux
def _on_mousewheel(event: object | None = None) -> None:
try:
# Windows / Mac / X11 事件差异处理
if hasattr(event, "delta") and event.delta:
# Windows 和 macOS 返回 delta(macOS 可能需要不同符号)
# 在 Windows 上,event.delta 为 120 的倍数/方向
delta = int(-1 * (event.delta / 120))
if delta == 0:
# fallback for small deltas
delta = -1 if event.delta < 0 else 1
canvas.yview_scroll(delta, "units")
else:
# X11 可能使用 Button-4/Button-5
if getattr(event, "num", None) == 4:
canvas.yview_scroll(-1, "units")
elif getattr(event, "num", None) == 5:
canvas.yview_scroll(1, "units")
except Exception:
pass
def _bind_mousewheel(_: object | None = None) -> None:
try:
# 绑定到 canvas 的所有滚轮事件,以保证在 card 上也能滚动
canvas.bind_all("<MouseWheel>", _on_mousewheel)
canvas.bind_all("<Button-4>", _on_mousewheel)
canvas.bind_all("<Button-5>", _on_mousewheel)
except Exception:
pass
def _unbind_mousewheel(_: object | None = None) -> None:
try:
canvas.unbind_all("<MouseWheel>")
canvas.unbind_all("<Button-4>")
canvas.unbind_all("<Button-5>")
except Exception:
pass
try:
canvas.bind("<Enter>", _bind_mousewheel)
canvas.bind("<Leave>", _unbind_mousewheel)
except Exception:
pass
# 字体与样式(调小以适配用户需求)
try:
import tkinter.font as tkfont
base_font = tkfont.Font(family="Consolas", size=10)
title_font = tkfont.Font(family="Consolas", size=12, weight="bold")
meta_font = tkfont.Font(family="Consolas", size=9, slant="italic")
body_font = tkfont.Font(family="Consolas", size=10)
except Exception:
base_font = title_font = meta_font = body_font = None
# 记录每个卡片的 widget 以便选中与复制
mapping_entries_widgets: List[tk.Widget] = []
# 视觉样式变量
normal_bg = "#ffffff"
hover_bg = "#f6fbff"
selected_bg = "#eaf2ff"
# 状态/搜索/复制 控件
mapping_status_var = tk.StringVar(value="")
ttk.Label(map_ctrl, textvariable=mapping_status_var, foreground="#666666").pack(
side=tk.LEFT, padx=(8, 6)
)
search_var = tk.StringVar(value="")
search_entry = ttk.Entry(map_ctrl, textvariable=search_var, width=26)
search_entry.pack(side=tk.LEFT, padx=(8, 6))
ttk.Button(
map_ctrl,
text="清除",
width=6,
command=lambda: (search_var.set(""), _load_mapping_to_view()),
).pack(side=tk.LEFT, padx=(0, 6))
copy_btn = ttk.Button(map_ctrl, text="复制条目", width=10)
copy_btn.pack(side=tk.LEFT, padx=(4, 6))
# 记录最后一次单击选中的条目索引
last_selected_entry = {"idx": None}
# 存储文本块以便双击查看详情
mapping_entries_text: List[str] = []
mapping_entries_start_lines: List[int] = []
def _load_mapping_to_view():
nonlocal mapping_entries_text, mapping_entries_start_lines
# entries_pool 存放解析得到的所有条目文本;mapping_entries_text 用于显示(会在渲染时按过滤更新)
entries_pool: List[str] = []
mapping_entries_text = []
mapping_entries_start_lines = []
all_lines: List[str] = []
# 读取预约队列与映射表(使用 mapping_utils 模块以实现模块化)
try:
base_dir = os.path.abspath(
os.path.join(os.path.dirname(__file__), "..", "..")
)
except Exception:
base_dir = os.getcwd()
# 尝试通过工具模块加载 reservations 信息
reservations_data = {}
try:
if mapping_utils:
reservations_data = mapping_utils.load_reservations(base_dir)
except Exception:
reservations_data = {}
possible_paths = [
os.path.join(base_dir, "douyin", "core", "state", "room_pos_map.json"),
os.path.join(base_dir, "douyin", "core", "state", "reservations.json"),
os.path.join(os.getcwd(), "douyin", "core", "state", "room_pos_map.json"),
]
found = False
for p in possible_paths:
try:
if os.path.exists(p):
with open(p, "r", encoding="utf-8") as f:
raw = f.read()
try:
parsed = json.loads(raw)
except Exception:
parsed = None
mapping_source_var.set(p)
if not parsed:
all_lines = ["(非JSON,查看原始文件)", raw]
entries_pool = []
else:
try:
if mapping_utils:
entries_pool = mapping_utils.parse_entries(
parsed, show_title_raw_var.get(), reservations_data
)
else:
# fallback to simple parsing: convert dict/list to strings
if isinstance(parsed, dict):
entries_pool = [
"\n".join([f"[{k}] {v}"])
for k, v in parsed.items()
]
else:
entries_pool = [str(parsed)]
# build all_lines for raw view
all_lines = []
for entry in entries_pool:
all_lines.extend(entry.split("\n"))
all_lines.append("")
except Exception:
entries_pool = []
all_lines = []
found = True
break
except Exception:
pass
# 保存当前可见位置(避免刷新后回到顶部)
try:
prev_top = None
try:
v = canvas.yview()
if isinstance(v, (tuple, list)) and len(v) >= 1:
prev_top = float(v[0])
except Exception:
prev_top = None
except Exception:
prev_top = None
# 清空旧卡片
try:
for w in inner_frame.winfo_children():
try:
w.destroy()
except Exception:
pass
mapping_entries_widgets.clear()
except Exception:
pass
# 渲染卡片式条目(每个字段单独一行)
mapping_entries_start_lines = []
mapping_entries_text = []
if found and entries_pool:
filter_key = (search_var.get() or "").strip().lower()
try:
canvas.update_idletasks()
wraplen = max(220, canvas.winfo_width() - 60)
except Exception:
wraplen = 800
# 计算列数以合理分配右边空白区域
try:
canvas.update_idletasks()
canvas_w = canvas.winfo_width() or 800
except Exception:
canvas_w = 800
columns, col_width = _mt_helpers.compute_card_layout(canvas_w)
h_gap = 12
# 配置列权重
try:
for ci in range(columns):
inner_frame.grid_columnconfigure(ci, weight=1, uniform="col")
except Exception:
pass
placed = 0
for idx, entry in enumerate(entries_pool):
if filter_key and filter_key not in entry.lower():
continue
# 存储用于复制/详情的纯文本
mapping_entries_text.append(entry)
lines = entry.split("\n")
# 卡片容器(更紧凑的间距与更清晰的边界)
try:
card = tk.Frame(
inner_frame,
bg=normal_bg,
bd=0,
highlightthickness=1,
highlightbackground="#e6e6e6",
relief="flat",
)
except Exception:
card = tk.Frame(inner_frame, bg=normal_bg)
# 计算网格位置
row = placed // columns
col = placed % columns
try:
card.grid(row=row, column=col, sticky="nwe", padx=6, pady=4)
except Exception:
try:
card.pack(fill="x", padx=6, pady=4, anchor="n")
except Exception:
pass
# 渲染标题 + meta + body 行
card_wraplen = max(160, col_width - 40)
_mt_helpers.render_card_labels(
card=card,
lines=lines,
title_font=title_font,
meta_font=meta_font,
body_font=body_font,
bg=normal_bg,
wraplength=card_wraplen,
show_title_raw=show_title_raw_var.get(),
)
# 分隔线
try:
ttk.Separator(card, orient="horizontal").pack(
fill="x", padx=8, pady=(6, 4)
)
except Exception:
pass
mapping_entries_widgets.append(card)
# 绑定点击/双击以及 hover 事件
on_click, on_dbl, on_enter, on_leave = _mt_helpers.make_card_event_handlers(
card_index=len(mapping_entries_widgets) - 1,
card=card,
cards=mapping_entries_widgets,
last_selected=last_selected_entry,
entries_text=mapping_entries_text,
root=root,
normal_bg=normal_bg,
hover_bg=hover_bg,
selected_bg=selected_bg,
scrolled_text_cls=ScrolledText,
)
try:
card.bind("<Button-1>", on_click)
card.bind("<Double-1>", on_dbl)
card.bind("<Enter>", on_enter)
card.bind("<Leave>", on_leave)
for child in card.winfo_children():
try:
child.bind("<Button-1>", on_click)
child.bind("<Double-1>", on_dbl)
child.bind("<Enter>", on_enter)
child.bind("<Leave>", on_leave)
except Exception:
pass
except Exception:
pass
placed += 1
else:
mapping_source_var.set("未找到 room_pos_map.json")
try:
tk.Label(
inner_frame, text="未找到映射表文件或无数据", fg="#666666"
).pack(padx=8, pady=8)
except Exception:
pass
# 恢复之前的滚动位置(若可用)
try:
canvas.update_idletasks()
except Exception:
pass
try:
if prev_top is not None:
canvas.yview_moveto(prev_top)
except Exception:
pass
# 刷新后清除选中索引
try:
last_selected_entry["idx"] = None
except Exception:
pass
# 绑定刷新按钮与自动刷新
refresh_btn.config(command=_load_mapping_to_view)
def _maybe_auto_refresh():
if map_auto_refresh_var.get():
try:
_load_mapping_to_view()
except Exception:
pass
root.after(5000, _maybe_auto_refresh)
# 启动自动刷新轮询
root.after(5000, _maybe_auto_refresh)
# 点击/双击的回退处理:如果用户在卡片外双击或点击,使用最后一次选中项展示详情
def _open_selected_entry_detail(event: object | None = None) -> None:
try:
idx = last_selected_entry.get("idx")
if idx is None:
if mapping_entries_text:
idx = 0
else:
return
try:
content = mapping_entries_text[idx]
except Exception:
content = ""
_mt_helpers.open_entry_detail_window(root, content, ScrolledText)
except Exception:
pass
try:
# 在 canvas 上双击会打开当前选中条目的详情(作为卡片双击的补偿)
canvas.bind("<Double-1>", _open_selected_entry_detail)
except Exception:
pass
# 复制选中条目到剪贴板
def _copy_selected_entry() -> None:
try:
idx = last_selected_entry.get("idx")
if idx is None or idx < 0 or idx >= len(mapping_entries_text):
if mapping_entries_text:
content = mapping_entries_text[0]
else:
content = ""
else:
content = mapping_entries_text[idx]
if content:
try:
root.clipboard_clear()
root.clipboard_append(content)
mapping_status_var.set("已复制到剪贴板")
root.after(1800, lambda: mapping_status_var.set(""))
except Exception:
pass
except Exception:
pass
try:
copy_btn.config(command=_copy_selected_entry)
except Exception:
pass
try:
search_entry.bind("<Return>", lambda e: _load_mapping_to_view())
except Exception:
pass
try:
show_title_raw_chk.config(command=_load_mapping_to_view)
_load_mapping_to_view()
except Exception:
pass
return mapping_tab