DKChan
5f9d8e7b77
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例） - 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为 现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行） - 纯注释改动零行为变更，按用户令免测试免冒烟
73 lines
3.0 KiB
GDScript
73 lines
3.0 KiB
GDScript
# tests/unit/test_kit.gd — 单元测试协议样板单点
|
|
# 覆盖：各套件 _check/_problems 样板（计数器 + PASS/FAIL 行 + 汇总退出）+
|
|
# 致命类用例 BAD 表目录夹具。
|
|
# 用法（--script 模式无 autoload/全局标识符——禁 class_name 裸引用，使用方 preload）：
|
|
# const Kit := preload("res://tests/unit/test_kit.gd")
|
|
# Kit.check("断言描述", cond) # 计数 + 即时 PASS/FAIL 行
|
|
# Kit.check_quiet(cond, "描述") # 计数 + 失败收集（finish 时统一汇总——原 _problems 风格，原参序）
|
|
# quit(Kit.finish("suite_name")) # 汇总输出 + 返回退出码（0 全绿 / 1 有败）
|
|
# 计数器为 static（套件 = 独立 Godot 子进程恰一份生命周期，见 run_all.gd 执行形态）；
|
|
# 单进程跑多套件须先 Kit.reset()。
|
|
extends RefCounted
|
|
|
|
static var checks: int = 0
|
|
static var failures: int = 0
|
|
static var problems: Array = []
|
|
|
|
|
|
# 主通道：计数 + 即时 PASS/FAIL 行（config_db/rng_service/damage_math/system_contracts/
|
|
# damage_controller/ui_font_asset/terrain_tile_sets 等套件原 _check 同款输出，描述在前）
|
|
static func check(desc: String, ok: bool) -> void:
|
|
checks += 1
|
|
if ok:
|
|
print(" [PASS] " + desc)
|
|
else:
|
|
failures += 1
|
|
push_error(" [FAIL] " + desc)
|
|
|
|
|
|
# 静默收集通道：失败只记入 problems（即时零刷屏），finish 统一汇总。
|
|
# 参序沿原函数式套件 treasure_items/breakpoint_resume 的 check(cond, msg)——条件在前，与主通道相反。
|
|
static func check_quiet(ok: bool, desc: String) -> void:
|
|
checks += 1
|
|
if not ok:
|
|
failures += 1
|
|
problems.append(desc)
|
|
|
|
|
|
# 汇总退出：返回退出码（调用方 `quit(Kit.finish(...))`）。pass_line = 成功尾行覆盖
|
|
#（保留原套件 PASS 摘要文案；缺省 = "all green (N checks)" 计数口径）。
|
|
# 失败路径：push_error 计数汇总 + problems 逐条 FAIL 行（print + push_error 双通道——原两风格并档）。
|
|
static func finish(suite: String, pass_line: String = "") -> int:
|
|
if failures > 0:
|
|
push_error("[%s] %d/%d 项失败" % [suite, failures, checks])
|
|
for p in problems:
|
|
print("[%s] FAIL — %s" % [suite, p])
|
|
push_error("[%s] FAIL — %s" % [suite, p])
|
|
return 1
|
|
print("[%s] %s" % [suite, pass_line if pass_line != "" else "all green (%d checks)" % checks])
|
|
return 0
|
|
|
|
|
|
# BAD 表夹具共享（原 reward_dangling_treasure/treasure_target_violation 各自复制的 _copy_tables）：
|
|
# 整目录拷贝 src_dir → bad_dir（目录已建）。BAD_DIR 常量仍由各用例自持（名字互异——独立进程并行不互踩）。
|
|
static func copy_tables(src_dir: String, bad_dir: String) -> bool:
|
|
DirAccess.make_dir_recursive_absolute(bad_dir)
|
|
var dir := DirAccess.open(src_dir)
|
|
if dir == null:
|
|
return false
|
|
dir.list_dir_begin()
|
|
var f := dir.get_next()
|
|
while f != "":
|
|
if not dir.current_is_dir():
|
|
if dir.copy(src_dir + "/" + f, bad_dir + "/" + f) != OK:
|
|
return false
|
|
f = dir.get_next()
|
|
return true
|
|
|
|
|
|
static func reset() -> void:
|
|
checks = 0
|
|
failures = 0
|
|
problems = []
|