crogram-pythub 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
pythub/gui.py ADDED
@@ -0,0 +1,690 @@
1
+ """Pythub 可视化操作界面(tkinter,零第三方 UI 依赖)。
2
+
3
+ - 选择打包的 Python 脚本/项目、目标平台、架构、Python 版本
4
+ - 按平台列出可用文件类型(单文件/文件夹/平台专属格式)
5
+ - 执行打包(后台线程,界面不卡顿)并实时输出日志
6
+ - 打包成功弹窗提示产物路径
7
+ - 发布打包好的应用/发行包到 PyPI
8
+ """
9
+
10
+ from __future__ import annotations
11
+
12
+ import logging
13
+ import os
14
+ import queue
15
+ import sys
16
+ import threading
17
+ from pathlib import Path
18
+
19
+ try:
20
+ import tkinter as tk
21
+ from tkinter import filedialog, messagebox, ttk
22
+ _TK_OK = True
23
+ except ImportError as e:
24
+ tk = None # type: ignore[assignment]
25
+ _TK_OK = False
26
+ _TK_ERROR = str(e)
27
+
28
+ from pythub import DEFAULT_FORMAT, PLATFORM_FORMATS, SUPPORTED_ARCHS, SUPPORTED_PYTHON
29
+ from pythub.utils import PYTHUB_CACHE_DIR
30
+
31
+
32
+ class _QueueHandler(logging.Handler):
33
+ """logging -> 线程安全队列 -> GUI 日志区。"""
34
+
35
+ def __init__(self, q: "queue.Queue"):
36
+ super().__init__()
37
+ self.q = q
38
+
39
+ def emit(self, record):
40
+ try:
41
+ self.q.put((self.format(record) + "\n", record.levelname))
42
+ except Exception:
43
+ self.handleError(record)
44
+
45
+
46
+ class PythubGUI:
47
+ def __init__(self, root: "tk.Tk", log_queue: "queue.Queue"):
48
+ self.root = root
49
+ self.q = log_queue
50
+ self.busy = False
51
+ # 文件对话框默认目录:用户 home;选择后记住上次目录
52
+ self.last_dir = Path.home()
53
+
54
+ root.title("Pythub —— 开源的 Python 应用打包工具 (CROGRAM)")
55
+ root.geometry("880x680")
56
+
57
+ nb = ttk.Notebook(root)
58
+ self.nb = nb
59
+ nb.pack(fill="both", expand=True, padx=8, pady=(8, 4))
60
+ self.tab_build = ttk.Frame(nb)
61
+ self.tab_publish = ttk.Frame(nb)
62
+ self.tab_settings = ttk.Frame(nb)
63
+ self.tab_about = ttk.Frame(nb)
64
+ nb.add(self.tab_build, text=" 打包 ")
65
+ nb.add(self.tab_publish, text=" 发布 PyPI ")
66
+ nb.add(self.tab_settings, text=" 设置 ")
67
+ nb.add(self.tab_about, text=" 关于 ")
68
+ self._build_tab_build()
69
+ self._build_tab_publish()
70
+ self._build_tab_settings()
71
+ self._build_tab_about()
72
+
73
+ self.log = tk.Text(root, height=15, state="disabled",
74
+ bg="#141414", fg="#dcdcdc")
75
+ self.log.pack(fill="both", expand=True, padx=8, pady=(0, 8))
76
+ for tag, color in (("WARNING", "#c08000"), ("ERROR", "#e05555"), ("INFO", "#dcdcdc")):
77
+ self.log.tag_config(tag, foreground=color)
78
+ self.log.delete("1.0", "end") # 清掉默认空行,首条日志从第 1 行开始
79
+ nb.bind("<<NotebookTabChanged>>", self._on_tab_changed)
80
+ root.after(100, self._poll)
81
+
82
+ # ------------------------------------------------ 标签切换
83
+
84
+ def _on_tab_changed(self, _event=None):
85
+ """切到"关于"页时隐藏底部日志区,切回其他页时恢复(问题9)。"""
86
+ if self.nb.select() == str(self.tab_about):
87
+ self.log.pack_forget()
88
+ else:
89
+ self.log.pack(fill="both", expand=True, padx=8, pady=(0, 8))
90
+
91
+ # ------------------------------------------------ 日志
92
+
93
+ def _poll(self):
94
+ """主线程定时取出队列日志并显示(批量插入,保证界面流畅)。"""
95
+ lines = []
96
+ try:
97
+ for _ in range(200):
98
+ text, level = self.q.get_nowait()
99
+ tag = level if level in ("WARNING", "ERROR", "INFO") else "INFO"
100
+ lines.append((text, tag))
101
+ except queue.Empty:
102
+ pass
103
+ if lines:
104
+ self.log.configure(state="normal")
105
+ for text, tag in lines:
106
+ self.log.insert("end", text, tag)
107
+ # 限制日志区行数,避免文本框过大导致整块重排缓慢(问题10)
108
+ total = int(self.log.index("end-1c").split(".")[0])
109
+ if total > 5000:
110
+ self.log.delete("1.0", f"{total - 5000}.0")
111
+ self.log.configure(state="disabled")
112
+ self.log.see("end")
113
+ self.root.after(120, self._poll)
114
+
115
+ # ------------------------------------------------ 打包页
116
+
117
+ def _build_tab_build(self):
118
+ f = self.tab_build
119
+ frm = ttk.Frame(f)
120
+ frm.pack(fill="x", padx=8, pady=6)
121
+ frm.columnconfigure(1, weight=1)
122
+
123
+ ttk.Label(frm, text="项目目录:").grid(row=0, column=0, sticky="e", padx=4, pady=4)
124
+ self.var_project = tk.StringVar()
125
+ ttk.Entry(frm, textvariable=self.var_project).grid(row=0, column=1, sticky="we", padx=4)
126
+ ttk.Button(frm, text="浏览...", command=self._pick_project).grid(row=0, column=2, padx=4)
127
+
128
+ ttk.Label(frm, text="入口脚本:").grid(row=1, column=0, sticky="e", padx=4, pady=4)
129
+ self.var_entry = tk.StringVar(value="main.py")
130
+ ttk.Entry(frm, textvariable=self.var_entry).grid(row=1, column=1, sticky="we", padx=4)
131
+
132
+ ttk.Label(frm, text="应用名称:").grid(row=2, column=0, sticky="e", padx=4, pady=4)
133
+ self.var_name = tk.StringVar(value="app")
134
+ ttk.Entry(frm, textvariable=self.var_name).grid(row=2, column=1, sticky="we", padx=4)
135
+
136
+ opt = ttk.Frame(f)
137
+ opt.pack(fill="x", padx=8, pady=6)
138
+ ttk.Label(opt, text="目标平台:").grid(row=0, column=0, sticky="e", padx=4, pady=4)
139
+ self.var_platforms = {}
140
+ for i, p in enumerate(PLATFORM_FORMATS):
141
+ v = tk.BooleanVar(value=False)
142
+ ttk.Checkbutton(opt, text=p, variable=v, command=self._refresh_formats).grid(
143
+ row=0, column=1 + i, sticky="w", padx=6)
144
+ self.var_platforms[p] = v
145
+
146
+ ttk.Label(opt, text="架构:").grid(row=1, column=0, sticky="e", padx=4, pady=4)
147
+ try:
148
+ from pythub.exe_archive import native_host_arch as _host_arch
149
+ _default_arch = _host_arch() if _host_arch() in SUPPORTED_ARCHS else "x86_64"
150
+ except Exception: # noqa: BLE001
151
+ _default_arch = "x86_64"
152
+ self.var_arch = tk.StringVar(value=_default_arch)
153
+ ttk.Combobox(opt, textvariable=self.var_arch, values=list(SUPPORTED_ARCHS),
154
+ state="readonly", width=10).grid(row=1, column=1, sticky="w", padx=6)
155
+
156
+ ttk.Label(opt, text="Python 版本:").grid(row=1, column=2, sticky="e", padx=4)
157
+ self.var_py = tk.StringVar(value="3.12")
158
+ ttk.Combobox(opt, textvariable=self.var_py, values=list(SUPPORTED_PYTHON),
159
+ state="readonly", width=8).grid(row=1, column=3, sticky="w", padx=6)
160
+
161
+ ttk.Label(opt, text="输出类型:").grid(row=2, column=0, sticky="e", padx=4, pady=4)
162
+ self.var_fmt = tk.StringVar()
163
+ self.cmb_fmt = ttk.Combobox(opt, textvariable=self.var_fmt, state="readonly", width=18)
164
+ self.cmb_fmt.grid(row=2, column=1, sticky="w", padx=6)
165
+ self._refresh_formats()
166
+
167
+ ttk.Label(opt, text="引擎:").grid(row=2, column=2, sticky="e", padx=4)
168
+ self.var_engine = tk.StringVar(value="zipapp")
169
+ ttk.Combobox(opt, textvariable=self.var_engine, values=["zipapp", "pyinstaller"],
170
+ state="readonly", width=12).grid(row=2, column=3, sticky="w", padx=6)
171
+
172
+ ttk.Label(opt, text="额外依赖:").grid(row=3, column=0, sticky="e", padx=4)
173
+ self.var_reqs = tk.StringVar()
174
+ ttk.Entry(opt, textvariable=self.var_reqs, width=32).grid(
175
+ row=3, column=1, columnspan=3, sticky="w", padx=6)
176
+ ttk.Label(opt, text="(逗号分隔,留空自动分析)").grid(row=3, column=4, sticky="w")
177
+
178
+ self.var_windowed = tk.BooleanVar(value=False)
179
+ ttk.Checkbutton(
180
+ opt, text="窗口模式(GUI 应用隐藏控制台黑框)",
181
+ variable=self.var_windowed).grid(
182
+ row=4, column=1, columnspan=4, sticky="w", padx=6)
183
+ self.lbl_windowed_hint = ttk.Label(opt, text="", foreground="#777")
184
+ self.lbl_windowed_hint.grid(row=5, column=1, columnspan=4, sticky="w", padx=6)
185
+ self.cmb_fmt.bind("<<ComboboxSelected>>",
186
+ lambda _e: self._update_windowed_hint())
187
+ self._update_windowed_hint()
188
+
189
+ self.var_sign = tk.BooleanVar(value=False)
190
+ ttk.Checkbutton(
191
+ opt, text="Authenticode 签名(仅 .exe,未提供证书时自动生成自签证书)",
192
+ variable=self.var_sign).grid(
193
+ row=6, column=1, columnspan=4, sticky="w", padx=6)
194
+
195
+ self.var_status = tk.StringVar(value="就绪")
196
+ ttk.Label(f, textvariable=self.var_status, foreground="#367bf0").pack(padx=8, anchor="w")
197
+ self.btn_build = ttk.Button(f, text="开始打包", command=self._start_build)
198
+ self.btn_build.pack(padx=8, pady=6, anchor="w")
199
+
200
+ # ---- 打包产物展示区(常驻主界面:左文案 / 中路径输入框 / 右按钮)----
201
+ self.frm_result = ttk.LabelFrame(f, text="打包产物", padding=6)
202
+ self.frm_result.pack(fill="x", padx=8, pady=(0, 8))
203
+ self._result_rows: list = []
204
+ self._result_vars: list = [] # 保持 StringVar 引用,防止被 GC 后输入框清空
205
+ self._last_artifacts: list = []
206
+ self._last_output_dir: Path | None = None
207
+ self._show_result_hint()
208
+
209
+ def _clear_result_rows(self):
210
+ for w in self._result_rows:
211
+ w.destroy()
212
+ self._result_rows.clear()
213
+ self._result_vars.clear()
214
+
215
+ def _add_result_row(self, label_text: str, path, buttons: list) -> None:
216
+ """添加一行:左侧文案 + 中间只读输入框 + 最右侧按钮组。"""
217
+ row = ttk.Frame(self.frm_result)
218
+ row.pack(fill="x", pady=2)
219
+ ttk.Label(row, text=label_text, width=8, anchor="e").pack(
220
+ side="left", padx=(0, 4))
221
+ var = tk.StringVar(value=str(path))
222
+ self._result_vars.append(var) # 防止 StringVar 被 GC
223
+ ent = ttk.Entry(row, textvariable=var, state="readonly")
224
+ ent.pack(side="left", fill="x", expand=True, padx=(0, 6))
225
+ for text, cmd in buttons:
226
+ ttk.Button(row, text=text, width=12, command=cmd).pack(
227
+ side="left", padx=(0, 4))
228
+ self._result_rows.append(row)
229
+
230
+ def _copy_to_clipboard(self, path):
231
+ self.root.clipboard_clear()
232
+ self.root.clipboard_append(str(path))
233
+ self.var_status.set(f"已复制到剪贴板 ✓ {path}")
234
+
235
+ def _open_output_dir(self):
236
+ if not self._last_output_dir:
237
+ return
238
+ import subprocess
239
+ d = str(self._last_output_dir)
240
+ try:
241
+ if sys.platform == "darwin":
242
+ subprocess.Popen(["open", d])
243
+ elif sys.platform == "win32":
244
+ os.startfile(d) # noqa: S606
245
+ else:
246
+ subprocess.Popen(["xdg-open", d])
247
+ except Exception as e: # noqa: BLE001
248
+ messagebox.showerror("错误", f"无法打开目录: {e}")
249
+
250
+ def _show_result_hint(self):
251
+ self._clear_result_rows()
252
+ row = ttk.Frame(self.frm_result)
253
+ row.pack(fill="x", pady=2)
254
+ ttk.Label(row, text="(打包完成后,产物路径将显示在这里)", foreground="#999").pack(
255
+ side="left", padx=(0, 4))
256
+ self._result_rows.append(row)
257
+
258
+ def _show_artifacts(self, artifacts: list, output_dir):
259
+ self._last_artifacts = list(artifacts)
260
+ self._last_output_dir = Path(output_dir)
261
+ self._clear_result_rows()
262
+ # 输出目录行:右侧 [打开输出目录] [复制路径]
263
+ self._add_result_row(
264
+ "输出目录", self._last_output_dir,
265
+ [("打开输出目录", self._open_output_dir),
266
+ ("复制路径", lambda: self._copy_to_clipboard(self._last_output_dir))],
267
+ )
268
+ # 每个产物一行:右侧 [复制路径]
269
+ for i, a in enumerate(artifacts, 1):
270
+ self._add_result_row(
271
+ f"产物 {i}", a,
272
+ [("复制路径", lambda p=a: self._copy_to_clipboard(p))],
273
+ )
274
+
275
+ def _refresh_formats(self):
276
+ plats = [p for p, v in self.var_platforms.items() if v.get()]
277
+ fmts = []
278
+ for p in plats:
279
+ for fm in PLATFORM_FORMATS[p]:
280
+ if f"{p}:{fm}" not in fmts:
281
+ fmts.append(f"{p}:{fm}")
282
+ self.cmb_fmt["values"] = fmts
283
+ self.var_fmt.set(fmts[0] if fmts else "")
284
+ self._update_windowed_hint()
285
+
286
+ def _update_windowed_hint(self):
287
+ """窗口模式选项提示: 仅 exe/nexe 引导器消费 console 参数。"""
288
+ if not hasattr(self, "lbl_windowed_hint"):
289
+ return # 打包页控件尚未创建完成(_refresh_formats 首次调用)
290
+ fmt = self.var_fmt.get().split(":")[-1] if self.var_fmt.get() else ""
291
+ if fmt in ("exe", "nexe"):
292
+ self.lbl_windowed_hint.config(text="当前格式支持窗口模式")
293
+ else:
294
+ self.lbl_windowed_hint.config(text="当前格式不支持窗口模式,该选项将被忽略")
295
+
296
+ def _pick_project(self):
297
+ d = filedialog.askdirectory(title="选择项目目录", initialdir=str(self.last_dir))
298
+ if not d:
299
+ return
300
+ self.last_dir = Path(d)
301
+ self.var_project.set(d)
302
+ if (Path(d) / "pythub.toml").exists():
303
+ from pythub.config import app_config
304
+
305
+ cfg = app_config(Path(d))
306
+ self.var_name.set(cfg["name"])
307
+ self.var_entry.set(cfg["entry"])
308
+
309
+ def _start_build(self):
310
+ if self.busy:
311
+ messagebox.showinfo("提示", "打包正在进行中,请等待完成")
312
+ return
313
+ project = Path(self.var_project.get().strip())
314
+ if not project.is_dir():
315
+ messagebox.showerror("错误", "请选择有效的项目目录")
316
+ return
317
+ if not self.var_fmt.get():
318
+ messagebox.showerror("错误", "请选择目标平台与输出类型")
319
+ return
320
+ plat, fmt = self.var_fmt.get().split(":", 1)
321
+ reqs = [r.strip() for r in self.var_reqs.get().split(",") if r.strip()]
322
+
323
+ from pythub.builder import BuildSpec, build
324
+ from pythub.utils import get_logger
325
+
326
+ logger = get_logger()
327
+ spec = BuildSpec(
328
+ project_dir=project.resolve(),
329
+ name=self.var_name.get().strip() or "app",
330
+ entry=self.var_entry.get().strip() or "main.py",
331
+ requirements=reqs,
332
+ platform=plat,
333
+ arch=self.var_arch.get(),
334
+ python=self.var_py.get(),
335
+ fmt=fmt,
336
+ output=project.resolve() / "dist",
337
+ engine=self.var_engine.get(),
338
+ windowed=self.var_windowed.get(),
339
+ sign=self.var_sign.get(),
340
+ )
341
+
342
+ attach_queue_handler(self.q)
343
+ self.busy = True
344
+ self.var_status.set(f"正在打包 {spec.name} -> {plat}:{fmt} ...")
345
+ self.btn_build.configure(state="disabled")
346
+
347
+ def finish_ok(artifacts):
348
+ self.busy = False
349
+ self.var_status.set("打包完成 ✓")
350
+ self.btn_build.configure(state="normal")
351
+ self._show_artifacts(artifacts, spec.output)
352
+ messagebox.showinfo(
353
+ "打包成功",
354
+ "产物:\n" + "\n".join(str(a) for a in artifacts)
355
+ + "\n\n输出目录: " + str(spec.output),
356
+ )
357
+
358
+ def finish_err(err):
359
+ self.busy = False
360
+ self.var_status.set("打包失败 ✗")
361
+ self.btn_build.configure(state="normal")
362
+ messagebox.showerror("打包失败", str(err))
363
+
364
+ def work():
365
+ try:
366
+ artifacts = build(spec, logger)
367
+ self.root.after(0, lambda: finish_ok(artifacts))
368
+ except Exception as e: # noqa: BLE001
369
+ logger.error("打包失败: %s", e)
370
+ self.root.after(0, lambda err=e: finish_err(err))
371
+
372
+ threading.Thread(target=work, daemon=True).start()
373
+
374
+ # ------------------------------------------------ 发布页
375
+
376
+ def _build_tab_publish(self):
377
+ from pythub.utils import load_settings
378
+
379
+ f = self.tab_publish
380
+ frm = ttk.Frame(f)
381
+ frm.pack(fill="x", padx=8, pady=6)
382
+ frm.columnconfigure(1, weight=1)
383
+
384
+ # 需求 19: 启动时从 settings.json 恢复上次保存的发布配置
385
+ saved = load_settings().get("publish", {})
386
+
387
+ ttk.Label(frm, text="发行文件:").grid(row=0, column=0, sticky="e", padx=4, pady=4)
388
+ self.var_files = tk.StringVar(value=saved.get("files", ""))
389
+ ttk.Entry(frm, textvariable=self.var_files).grid(row=0, column=1, sticky="we", padx=4)
390
+ ttk.Button(frm, text="浏览...", command=self._pick_dist).grid(row=0, column=2, padx=4)
391
+
392
+ ttk.Label(frm, text="仓库:").grid(row=1, column=0, sticky="e", padx=4, pady=4)
393
+ self.var_repo = tk.StringVar(value=saved.get("repo", "pypi"))
394
+ ttk.Combobox(frm, textvariable=self.var_repo, values=["pypi", "testpypi"],
395
+ state="readonly", width=12).grid(row=1, column=1, sticky="w", padx=4)
396
+
397
+ ttk.Label(frm, text="API Token:").grid(row=2, column=0, sticky="e", padx=4, pady=4)
398
+ self.var_token = tk.StringVar(value=saved.get("token", ""))
399
+ ttk.Entry(frm, textvariable=self.var_token, show="*").grid(
400
+ row=2, column=1, sticky="we", padx=4)
401
+
402
+ row = ttk.Frame(f)
403
+ row.pack(padx=8, pady=6, anchor="w")
404
+ ttk.Button(row, text="保存配置", command=self._save_publish_cfg).pack(side="left")
405
+ ttk.Button(f, text="发布到 PyPI", command=self._start_publish).pack(padx=8, pady=6, anchor="w")
406
+ self.var_pub_status = tk.StringVar(value="就绪")
407
+ ttk.Label(f, textvariable=self.var_pub_status, foreground="#367bf0").pack(padx=8, anchor="w")
408
+ ttk.Label(f, text="提示: 先用 `pythub pypa build` 或打包页生成 .whl/.tar.gz,"
409
+ "再在此上传。Token 为 pypi- 开头的 API Token。",
410
+ foreground="#777").pack(padx=8, anchor="w")
411
+ ttk.Label(f, text="「保存配置」将发行文件/仓库/Token 存入本地"
412
+ " cache/pythub/settings.json(明文,注意机器安全),下次打开自动恢复。",
413
+ foreground="#777").pack(padx=8, anchor="w")
414
+
415
+ def _save_publish_cfg(self):
416
+ from pythub.utils import load_settings, save_settings
417
+
418
+ s = load_settings()
419
+ s["publish"] = {
420
+ "files": self.var_files.get().strip(),
421
+ "repo": self.var_repo.get(),
422
+ "token": self.var_token.get().strip(),
423
+ }
424
+ save_settings(s)
425
+ self.var_pub_status.set("配置已保存 ✓(下次打开自动恢复)")
426
+
427
+ def _pick_dist(self):
428
+ # macOS Aqua Tk 的 filetypes 遇到多点扩展名(如 *.tar.gz)会在
429
+ # setAllowedFileTypes 转 UTType 时崩溃(object cannot be nil),
430
+ # 故 darwin 下用单点 *.gz 匹配 .tar.gz;其余平台通配项用 *
431
+ if sys.platform == "darwin":
432
+ ftypes = [("发行包", ("*.whl", "*.zip", "*.gz"))]
433
+ else:
434
+ ftypes = [("发行包", ("*.whl", "*.tar.gz", "*.zip")), ("全部文件", "*")]
435
+ files = filedialog.askopenfilenames(
436
+ title="选择发行文件", initialdir=str(self.last_dir),
437
+ filetypes=ftypes)
438
+ if files:
439
+ self.last_dir = Path(files[0]).parent
440
+ self.var_files.set(", ".join(files))
441
+
442
+ def _start_publish(self):
443
+ if self.busy:
444
+ messagebox.showinfo("提示", "有任务正在进行中")
445
+ return
446
+ files = [Path(x.strip()) for x in self.var_files.get().split(",") if x.strip()]
447
+ files = [f for f in files if f.exists()]
448
+ if not files:
449
+ messagebox.showerror("错误", "请选择有效的发行文件 (.whl/.tar.gz)")
450
+ return
451
+ token = self.var_token.get().strip()
452
+ if not token:
453
+ messagebox.showerror("错误", "请输入 PyPI API Token")
454
+ return
455
+
456
+ from pythub.pypa import publish
457
+ from pythub.utils import get_logger
458
+
459
+ logger = get_logger()
460
+ attach_queue_handler(self.q)
461
+ self.busy = True
462
+ self.var_pub_status.set("正在上传...")
463
+ self.btn_pub.configure(state="disabled")
464
+
465
+ def finish_ok():
466
+ self.busy = False
467
+ self.var_pub_status.set("发布成功 ✓")
468
+ self.btn_pub.configure(state="normal")
469
+ messagebox.showinfo("发布成功", f"已上传 {len(files)} 个文件到 {self.var_repo.get()}")
470
+
471
+ def finish_err(err):
472
+ self.busy = False
473
+ self.var_pub_status.set("发布失败 ✗")
474
+ self.btn_pub.configure(state="normal")
475
+ messagebox.showerror("发布失败", str(err))
476
+
477
+ def work():
478
+ try:
479
+ publish(files, token, self.var_repo.get(), logger)
480
+ self.root.after(0, finish_ok)
481
+ except Exception as e: # noqa: BLE001
482
+ logger.error("发布失败: %s", e)
483
+ self.root.after(0, lambda err=e: finish_err(err))
484
+
485
+ threading.Thread(target=work, daemon=True).start()
486
+
487
+
488
+ # ------------------------------------------------ 设置页
489
+
490
+ def _build_tab_settings(self):
491
+ from pythub.utils import LOG_DIR, load_settings, set_file_logging
492
+
493
+ f = self.tab_settings
494
+ frm = ttk.Frame(f)
495
+ frm.pack(fill="x", padx=8, pady=8)
496
+
497
+ # 日志记录开关(需求 17/18):按持久化设置初始化
498
+ self.var_logfile = tk.BooleanVar(value=bool(load_settings().get("log_to_file")))
499
+ if self.var_logfile.get():
500
+ set_file_logging(True)
501
+ ttk.Checkbutton(
502
+ frm, text="启用日志记录(按天写入文件)",
503
+ variable=self.var_logfile, command=self._toggle_file_log,
504
+ ).pack(anchor="w", padx=4, pady=(6, 2))
505
+ ttk.Label(frm, text=f"日志目录: {LOG_DIR}", foreground="#777").pack(
506
+ anchor="w", padx=8)
507
+ ttk.Label(frm, text="开启后,打包/发布等操作日志会同步记录到日志目录下"
508
+ "(pythub-YYYYMMDD.log),重启后自动恢复。",
509
+ foreground="#777", wraplength=680, justify="left").pack(
510
+ anchor="w", padx=8, pady=(2, 10))
511
+
512
+ row = ttk.Frame(f)
513
+ row.pack(anchor="w", padx=8)
514
+ ttk.Button(row, text="打开日志目录",
515
+ command=lambda: self._open_dir(LOG_DIR)).pack(side="left")
516
+ ttk.Button(row, text="复制日志目录路径",
517
+ command=lambda: self._copy_to_clipboard(LOG_DIR)).pack(
518
+ side="left", padx=6)
519
+
520
+ # ---- 本地缓存管理(需求 14: 缓存大小上限) ----
521
+ frm2 = ttk.LabelFrame(f, text="本地缓存管理", padding=8)
522
+ frm2.pack(fill="x", padx=8, pady=8)
523
+ self.lbl_cache_stats = ttk.Label(frm2, text="", justify="left")
524
+ self.lbl_cache_stats.pack(anchor="w")
525
+ ttk.Label(frm2, text="构建缓存 = runtimes(嵌入式解释器)/ pyzlib(依赖 zip)/"
526
+ "bootloader(引导器编译缓存);运行时用户缓存(exe/、run/)"
527
+ "由引导器自动 LRU 管理,不在此列。",
528
+ foreground="#777", wraplength=680, justify="left").pack(
529
+ anchor="w", pady=(2, 6))
530
+ btnrow = ttk.Frame(frm2)
531
+ btnrow.pack(anchor="w")
532
+ ttk.Button(btnrow, text="刷新统计", command=self._refresh_cache_stats).pack(side="left")
533
+ ttk.Button(btnrow, text="打开缓存目录",
534
+ command=lambda: self._open_dir(PYTHUB_CACHE_DIR)).pack(side="left", padx=6)
535
+ ttk.Button(btnrow, text="按上限清理(LRU)", command=self._prune_cache).pack(
536
+ side="left", padx=6)
537
+ self._refresh_cache_stats()
538
+
539
+ @staticmethod
540
+ def _fmt_size(n: float) -> str:
541
+ for unit in ("B", "KB", "MB", "GB", "TB"):
542
+ if n < 1024:
543
+ return f"{int(n)} {unit}" if unit == "B" else f"{n:.1f} {unit}"
544
+ n /= 1024.0
545
+ return f"{n:.1f} PB"
546
+
547
+ def _refresh_cache_stats(self):
548
+ from pythub.utils import PYTHUB_CACHE_DIR, cache_stats
549
+
550
+ stats = cache_stats()
551
+ lines = [f"缓存目录: {PYTHUB_CACHE_DIR}"]
552
+ lines += [f" {sub}: {self._fmt_size(size)}" for sub, size in stats.items()]
553
+ lines.append(f" 合计: {self._fmt_size(sum(stats.values()))}")
554
+ self.lbl_cache_stats.config(text="\n".join(lines))
555
+
556
+ def _prune_cache(self):
557
+ from pythub.utils import prune_cache
558
+
559
+ if not messagebox.askyesno(
560
+ "确认清理",
561
+ "按 LRU 把构建缓存裁剪到默认上限(4GB)?\n"
562
+ "最久未使用的解释器/依赖缓存会被删除(下次打包自动重新下载)。\n"
563
+ "日志与设置不受影响。"):
564
+ return
565
+ pruned = prune_cache(None)
566
+ self._refresh_cache_stats()
567
+ if pruned:
568
+ messagebox.showinfo(
569
+ "清理完成",
570
+ f"已清理 {len(pruned)} 个缓存条目:\n"
571
+ + "\n".join(f" - {p.name}" for p in pruned[:10])
572
+ + ("\n ..." if len(pruned) > 10 else ""))
573
+ else:
574
+ messagebox.showinfo("清理完成", "缓存未超上限,无需清理。")
575
+
576
+ def _toggle_file_log(self):
577
+ from pythub.utils import set_file_logging
578
+
579
+ if self.var_logfile.get():
580
+ path = set_file_logging(True)
581
+ self.q.put((f"[INFO] 日志记录已开启: {path}\n", "INFO"))
582
+ else:
583
+ set_file_logging(False)
584
+ self.q.put(("[INFO] 日志记录已关闭\n", "INFO"))
585
+
586
+ def _open_dir(self, d):
587
+ import subprocess
588
+
589
+ d = str(d)
590
+ try:
591
+ if sys.platform == "darwin":
592
+ subprocess.Popen(["open", d])
593
+ elif os.name == "nt":
594
+ os.startfile(d) # noqa: S606
595
+ else:
596
+ subprocess.Popen(["xdg-open", d])
597
+ except Exception as e: # noqa: BLE001
598
+ messagebox.showerror("错误", f"无法打开目录: {e}")
599
+
600
+ # ------------------------------------------------ 关于页
601
+
602
+ def _build_tab_about(self):
603
+ import platform
604
+
605
+ from pythub import __author__, __url__, __version__
606
+
607
+ f = self.tab_about
608
+ wrap = ttk.Frame(f)
609
+ wrap.pack(expand=True, fill="both")
610
+
611
+ def row(label: str, value: str, link: bool = False):
612
+ fr = ttk.Frame(wrap)
613
+ fr.pack(fill="x", pady=3)
614
+ ttk.Label(fr, text=label, foreground="#777", width=10,
615
+ anchor="e").pack(side="left", padx=(0, 8))
616
+ if link:
617
+ lbl = ttk.Label(fr, text=value, foreground="#367bf0", cursor="hand2")
618
+ lbl.pack(side="left")
619
+ lbl.bind("<Button-1>", lambda e: self._open_url(value))
620
+ else:
621
+ ttk.Label(fr, text=value).pack(side="left")
622
+
623
+ ttk.Label(wrap, text="Pythub", font=("Helvetica", 40, "bold")).pack(pady=(40, 20))
624
+ ttk.Label(wrap, text="Pythub —— 开源的基于 Python 的 Python 应用打包工具",
625
+ font=("Helvetica", 12)).pack(pady=(0, 24))
626
+
627
+ row("版本", __version__)
628
+ row(
629
+ "介绍",
630
+ "一条命令,把应用打包成免装 Python、可直接运行的产物:"
631
+ "跨平台、多 Python 版本、多架构,并支持打包/发布 PyPI 包",
632
+ )
633
+ row("系统信息", f"{platform.system()} {platform.release()} {platform.machine()}")
634
+ row("运行环境", f"Python {platform.python_version()} | Tk {tk.TkVersion}")
635
+ row("官网", __url__, link=True)
636
+ row("开源协议", "MIT License")
637
+ row("版权所有", f"Copyright © {__author__}")
638
+ ttk.Label(wrap, text="开源组织 CROGRAM 出品", foreground="#999").pack(pady=18)
639
+
640
+ def _open_url(self, url: str):
641
+ import subprocess
642
+
643
+ try:
644
+ if sys.platform == "darwin":
645
+ subprocess.Popen(["open", url])
646
+ elif sys.platform == "win32":
647
+ os.startfile(url) # noqa: S606
648
+ else:
649
+ subprocess.Popen(["xdg-open", url])
650
+ except Exception as e: # noqa: BLE001
651
+ messagebox.showerror("错误", f"无法打开链接: {e}")
652
+
653
+
654
+ # ---------------------------------------------------------------- 全局日志桥接
655
+
656
+ def attach_queue_handler(log_queue: "queue.Queue") -> None:
657
+ """把 pythub 日志转发到指定队列(显式传入,避免全局状态混乱)。"""
658
+ logger = logging.getLogger("pythub")
659
+ for h in logger.handlers:
660
+ if isinstance(h, _QueueHandler):
661
+ h.q = log_queue # 复用,更新目标队列
662
+ return
663
+ handler = _QueueHandler(log_queue)
664
+ handler.setFormatter(logging.Formatter("[%(levelname).1s] %(message)s"))
665
+ handler.setLevel(logging.DEBUG)
666
+ logger.addHandler(handler)
667
+ # 关键修复: 显式设置级别,确保 INFO 日志不会被 root logger 的 WARNING 级别吞掉
668
+ if logger.level == logging.NOTSET or logger.level > logging.INFO:
669
+ logger.setLevel(logging.INFO)
670
+
671
+
672
+ def run() -> int:
673
+ if not _TK_OK:
674
+ print(
675
+ "错误: 当前 Python 未编译 Tk 支持,无法启动 GUI。\n"
676
+ f"详情: {_TK_ERROR}\n"
677
+ "建议: 安装 python.org 官方解释器或 `brew install python-tk`,"
678
+ "或改用命令行: pythub build ..."
679
+ )
680
+ return 1
681
+ root = tk.Tk()
682
+ log_queue: "queue.Queue" = queue.Queue()
683
+ attach_queue_handler(log_queue)
684
+ PythubGUI(root, log_queue)
685
+ root.mainloop()
686
+ return 0
687
+
688
+
689
+ if __name__ == "__main__":
690
+ raise SystemExit(run())