测试：落地测试架构改进 T-1~T-5（套件开关门禁/汇总行校验/通用 harness/公共断言宏/多套件编排）
背景：L0.5 主机侧单测落地后复审测试架构，给出 6 条改进意见（P0~P3）， 登记进 docs/待处理内容.md「测试与验证基础设施」后逐条实施。 - T-1(P0) 测试套件开关门禁：新增 scripts/check_test_suite.py + pre-commit 钩子 test-suite-switch，默认要求产品构建（全部 TEST_SUITE_* 注释），跑套件回归用 --allow-test-build / ALLOW_TEST_BUILD=1 显式放行。顺带把 test_config.h 中长期 开启的 TEST_SUITE_CH395F 改回注释（仓库此前躺着的是测试固件）。 - T-2(P1) verify_log.py 增加 --require-suite-summary：要求 "=== <名称>: N/M PASSED (failed=0) ===" 且 N>0，堵住"套件没跑到汇总行/ 断言数为 0 仍判 PASS"的盲区；run_boot_test.py 同名参数透传。不传参向后兼容。 - T-3(P1) 抽取通用 harness test/host/common/unit_test_harness.py（工具链探测/ INCLUDE-LIB 拼接/wd4819/GBK 解码/退出码契约）；watchdog 运行器 170→55 行，只声明 TestBuild。 - T-4(P2) 新增 test/board/test_common.h 集中断言内核（TEST_CHECK_IMPL/TEST_REPORT_IMPL）， 4 套件各用一行宏绑定自身统计变量（保持 g_xxx_stats 独立、防跨套件串数）。 刻意不 include dbg_log.h——否则冻结 DBG_TAG 默认值触发 #47-D 重定义警告。 - T-5(P2) 新增 test/run_all_suites.py 多套件回归编排，try/finally 无条件还原套件开关。 验证：@build 产品构建 0 错 0 警；4 套件逐一构建均 0/0；看门狗单测 39/39 PASS； pre-commit 14 钩子全通过；编排脚本 dry-run/开关切换/异常还原均实测通过。
This commit is contained in:
@@ -1,170 +1,52 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""看门狗判定状态机的主机侧单元测试运行器（纯标准库）。
|
||||
"""看门狗判定状态机的主机侧单元测试运行器（L0.5，纯标准库）。
|
||||
|
||||
做什么：
|
||||
用本机 MSVC 编译 test/host/watchdog/watchdog_test.c（它以 #include 纳入
|
||||
**生产源文件** App/util/task_watchdog.c），在 PC 上离线跑完整判定状态机，
|
||||
失败即非 0 退出。零硬件、零烧录、毫秒级。
|
||||
|
||||
工具链探测 / INCLUDE-LIB 拼接 / 编译运行 / 退出码判定全部委托给通用 harness
|
||||
`test/host/common/unit_test_harness.py`（本文件只做声明，2026-10-01 T-3 抽取）。
|
||||
|
||||
为什么要主机侧单测（而不是只用板端套件）：
|
||||
task_watchdog.c 的判定逻辑（位图取走清零 / 掩码 / miss_streak 累计 / 节流）
|
||||
是纯逻辑，与硬件无关；板端套件只能"在真机上跑一遍"，无法穷举边界（节流窗口
|
||||
99/100ms、tick 回绕、连续 8 次缺席的第 8/9 次分界）。主机侧单测把这些一次性
|
||||
钉死，且不占 MCU 的 RAM（项目 RAM 已 95%）。
|
||||
|
||||
实现要点（为何不用 vcvars64.bat）：
|
||||
vcvars64.bat 内部调用 reg.exe 探测环境；本机策略禁止 reg.exe。故这里**直接
|
||||
拼 INCLUDE/LIB 环境变量**并绝对路径调用 cl.exe——只需 3 个已知目录
|
||||
（MSVC 版本 / Windows SDK include / SDK lib），无副作用、可重复。
|
||||
|
||||
用法（仓库根目录）：
|
||||
python test/host/watchdog/run_unit_test.py
|
||||
或统一用 .venv： & '.venv\\Scripts\\python.exe' test/host/watchdog/run_unit_test.py
|
||||
|
||||
退出码：0=PASS / 1=测试失败 / 2=环境错误（找不到编译器 / 编译失败）。
|
||||
退出码：0=PASS / 1=测试失败 / 2=环境错误（找不到编译器 / 编译失败 / 无汇总行）。
|
||||
|
||||
设计依据：docs/测试说明/看门狗单元测试说明.md
|
||||
设计依据：docs/测试说明/看门狗单元测试说明.md；docs/待处理内容.md T-3
|
||||
创建日期：2026-10-01
|
||||
"""
|
||||
import glob
|
||||
import os
|
||||
import subprocess
|
||||
import sys
|
||||
import tempfile
|
||||
|
||||
# ----------------------------- 路径 -----------------------------
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
||||
STUB = os.path.join(HERE, "stub")
|
||||
SRC = os.path.join(HERE, "watchdog_test.c")
|
||||
APP_UTIL = os.path.join(ROOT, "App", "util") # task_watchdog.c 所在目录
|
||||
# harness 位于 test/host/common/
|
||||
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
||||
|
||||
VS_ROOTS = [
|
||||
r"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools",
|
||||
r"C:\Program Files\Microsoft Visual Studio\2022\BuildTools",
|
||||
r"C:\Program Files\Microsoft Visual Studio\2022\Community",
|
||||
r"C:\Program Files\Microsoft Visual Studio\2022\Professional",
|
||||
]
|
||||
SDK_ROOTS = [r"C:\Program Files (x86)\Windows Kits\10"]
|
||||
|
||||
|
||||
def _first(pattern):
|
||||
hits = sorted(glob.glob(pattern))
|
||||
return hits[-1] if hits else None
|
||||
|
||||
|
||||
def _decode(b):
|
||||
"""把 subprocess 字节输出解码为字符串：本机 MSVC 输出为 GBK（代码页 936），
|
||||
测试程序自身输出为 UTF-8；按 UTF-8 优先、失败回退 GBK 处理。"""
|
||||
if isinstance(b, str):
|
||||
return b
|
||||
try:
|
||||
return b.decode("utf-8")
|
||||
except UnicodeDecodeError:
|
||||
return b.decode("gbk", errors="replace")
|
||||
|
||||
|
||||
def locate_toolchain():
|
||||
"""返回 (cl.exe, include_dirs, lib_dirs)；找不到返回 (None, [], [])。"""
|
||||
cl = None
|
||||
for vs in VS_ROOTS:
|
||||
c = _first(os.path.join(vs, r"VC\Tools\MSVC\*\bin\Hostx64\x64\cl.exe"))
|
||||
if c:
|
||||
cl = c
|
||||
break
|
||||
if not cl:
|
||||
return None, [], []
|
||||
|
||||
msvc_ver_dir = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(cl))))
|
||||
# cl.exe = <vs>\VC\Tools\MSVC\<ver>\bin\Hostx64\x64\cl.exe
|
||||
msvc_ver_dir = os.path.dirname(os.path.dirname(os.path.dirname(
|
||||
os.path.dirname(cl)))) # -> ...\MSVC\<ver>
|
||||
inc = [
|
||||
os.path.join(msvc_ver_dir, "include"),
|
||||
]
|
||||
lib = [
|
||||
os.path.join(msvc_ver_dir, "lib", "x64"),
|
||||
]
|
||||
|
||||
for sdk in SDK_ROOTS:
|
||||
sdk_inc = _first(os.path.join(sdk, r"Include\*"))
|
||||
sdk_lib = _first(os.path.join(sdk, r"Lib\*"))
|
||||
if sdk_inc:
|
||||
inc += [
|
||||
os.path.join(sdk_inc, "ucrt"),
|
||||
os.path.join(sdk_inc, "shared"),
|
||||
os.path.join(sdk_inc, "um"),
|
||||
]
|
||||
if sdk_lib:
|
||||
lib += [
|
||||
os.path.join(sdk_lib, "ucrt", "x64"),
|
||||
os.path.join(sdk_lib, "um", "x64"),
|
||||
]
|
||||
return cl, inc, lib
|
||||
|
||||
|
||||
def main():
|
||||
cl, inc, lib = locate_toolchain()
|
||||
if not cl:
|
||||
print("[ENV] 找不到 MSVC cl.exe（需要 VS2019/2022 的 C++ 工具链）",
|
||||
file=sys.stderr)
|
||||
return 2
|
||||
|
||||
tmp = tempfile.gettempdir()
|
||||
objdir = os.path.join(tmp, "wd_test_obj")
|
||||
os.makedirs(objdir, exist_ok=True)
|
||||
exe = os.path.join(tmp, "watchdog_unit_test.exe")
|
||||
|
||||
env = dict(os.environ)
|
||||
env["INCLUDE"] = os.pathsep.join(inc)
|
||||
env["LIB"] = os.pathsep.join(lib)
|
||||
env["PATH"] = os.path.dirname(cl) + os.pathsep + env.get("PATH", "")
|
||||
|
||||
cmd = [
|
||||
cl, "/nologo", "/W4", "/std:c11", "/utf-8",
|
||||
# C4819（"源代码包含不能在当前代码页中表示的字符"）是**纯编码诊断**：
|
||||
# 本文件确为 UTF-8（带 BOM，已核验），且已显式传 /utf-8，字节解码无误、
|
||||
# 编译产物正确。但在"只设 INCLUDE/LIB、不调 vcvars"的调用方式下，
|
||||
# MSVC 的代码页探测会退化为 `代码页(0)` → 恒定误报 10 条。
|
||||
# 该文件仅主机侧编译（ARMCC 从不编译 test/），故显式屏蔽，保持门禁输出干净。
|
||||
"/wd4819",
|
||||
"/I", STUB, # stub 头优先于真实头（覆盖 main.h/iwdg.h/dbg_log.h）
|
||||
"/I", APP_UTIL, # task_watchdog.c / task_watchdog.h
|
||||
"/I", HERE, # （保留）本目录
|
||||
SRC,
|
||||
"/Fe:" + exe,
|
||||
"/Fo:" + objdir + os.sep,
|
||||
]
|
||||
|
||||
print("=== 编译并运行看门狗单元测试 ===")
|
||||
cp = subprocess.run(cmd, env=env, capture_output=True)
|
||||
cout = _decode(cp.stdout)
|
||||
cerr = _decode(cp.stderr)
|
||||
if cout:
|
||||
sys.stdout.write(cout)
|
||||
if cerr:
|
||||
sys.stderr.write(cerr)
|
||||
if cp.returncode != 0:
|
||||
print("[ENV] 编译失败", file=sys.stderr)
|
||||
return 2
|
||||
|
||||
run = subprocess.run([exe], env=env, capture_output=True)
|
||||
out = _decode(run.stdout)
|
||||
sys.stdout.write(out)
|
||||
errout = _decode(run.stderr)
|
||||
if errout:
|
||||
sys.stderr.write(errout)
|
||||
|
||||
if "=== Task Watchdog Tests:" not in out:
|
||||
print("[ENV] 未产生测试汇总行", file=sys.stderr)
|
||||
return 2
|
||||
if run.returncode == 0:
|
||||
print("[OK] 单元测试全部通过")
|
||||
return 0
|
||||
print("[FAIL] 有测试用例未通过", file=sys.stderr)
|
||||
return 1
|
||||
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
||||
|
||||
# 测试单元内部 #include 生产源；stub 目录必须**先于** APP_UTIL，才能覆盖真实头
|
||||
# （main.h / iwdg.h / dbg_log.h 由桩提供，使 task_watchdog.c 可在 PC 上编译）。
|
||||
BUILD = TestBuild(
|
||||
name="Task Watchdog Tests",
|
||||
src=os.path.join(HERE, "watchdog_test.c"),
|
||||
include_dirs=[
|
||||
os.path.join(HERE, "stub"),
|
||||
os.path.join(ROOT, "App", "util"),
|
||||
HERE,
|
||||
],
|
||||
summary_marker="=== Task Watchdog Tests:",
|
||||
)
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
sys.exit(run_host_unit_test(BUILD))
|
||||
|
||||
Reference in New Issue
Block a user