#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""SNTP 客户端（time_sntp）的主机侧纯逻辑单元测试运行器（纯标准库）。

做什么：
    用本机 MSVC 编译 test/host/sntp/sntp_test.c（它以 #include 纳入**生产源
    文件** App/sync/time_sntp.c + Drivers/BSP/NETCFG/sntp_cfg.c + vendor
    Lib/coreSNTP/core_sntp_serializer.c），在 PC 上离线跑：
      RFC 4330 §10 节奏（初始 1~5min 随机散布 / 失败超时翻倍封顶 60s / 成功按
      poll_min 重排）、§5.3 防欺骗（应答源 IP:port / originate 含随机低位精确
      匹配 / mode / LI=3 / stratum>15 / KoD DENY·RSTR·RATE·他码）、§5.5 步进
      策略（±2s 死区只记录、冷启动直采 T3、钟面 = 本地 UTC+8 恒加 28800、
      值域守卫）、[sntp] 配置注册与 poll 钳位、网络代次/停用收口与 socket 生命周期。
    失败即非 0 退出。零硬件、零烧录、毫秒级。

    工具链探测 / 编译运行 / 退出码判定全部委托通用 harness
    `test/host/common/unit_test_harness.py`（本文件只做声明）。

为什么要主机侧单测（而不是只用真机）：
    SNTP 的失败路径（伪造应答、KoD、超时风暴、tick 回绕）在真机上不可复现或
    要等小时级；且本模块直接拨 RTC（sys_clock→SD2506 写回），拨错一次就是
    事故——判据必须逐包断言。真机只做正向链路回归（PC W32Time 对端）。

用法（仓库根目录）：
    & '.venv\\Scripts\\python.exe' test/host/sntp/run_unit_test.py

退出码：0=PASS / 1=测试失败 / 2=环境错误（找不到编译器 / 编译失败 / 无汇总行）。

设计依据：#57 调研（docs 见 sntp-调研报告.md）+ App/sync/time_sntp.c 文件头；
创建日期：2026-11-04
"""
import os
import sys

HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
# harness 位于 test/host/common/
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))

from unit_test_harness import TestBuild, run_host_unit_test  # noqa: E402

# 顺序敏感：stub 目录必须**先于**生产目录，才能覆盖 FreeRTOS.h / task.h /
# cmsis_os2.h / net_types.h / net_socket.h / sys_clock.h / sys_events.h /
# sys_log.h / dbg_log.h（真实头会拖入整套 FreeRTOS / HAL / CH395F）。
# cfg_file.h 用**真实头**（App/cfg，纯 stdint/stddef——注册描述符契约原汁）；
# sntp_cfg.h / time_sntp.h 用真实头（接口契约原汁）。
BUILD = TestBuild(
    name="SNTP Client Tests",
    src=os.path.join(HERE, "sntp_test.c"),
    include_dirs=[
        os.path.join(HERE, "stub"),
        os.path.join(ROOT, "App", "sync"),
        os.path.join(ROOT, "App", "cfg"),
        os.path.join(ROOT, "Drivers", "BSP", "NETCFG"),
        os.path.join(ROOT, "Lib", "coreSNTP"),
        os.path.join(ROOT, "Lib", "coreSNTP", "include"),
        HERE,
    ],
    summary_marker="=== SNTP Client Tests:",
)

if __name__ == "__main__":
    sys.exit(run_host_unit_test(BUILD))