#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""屏板状态灯位映射（sb_led_map）主机侧纯逻辑单元测试运行器（纯标准库）。

做什么：用本机 MSVC 离线编译 test/host/sb_led_map/sb_led_map_test.c
    （#include 纳入生产源文件 App/algo/sb_led_map.c），验证位语义
    （每路状态只点亮对应位、可叠加不遮蔽）、恒零位（bit0 / ID 6~19）、
    心跳闪烁相位与 tick 回绕、NULL 输入契约。

为什么这套判据在真机上测不动：真机只能看到"哪盏灯亮了"（目视），看不到
    "掩码里多没多出一位保留位"——保留位被顺带点亮时屏板毫无反应，现场表现为
    "改了表没效果"；主机侧用"掩码 & ~定义集 == 0"一条就把映射表钉死。

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

退出码：0=PASS / 1=测试失败 / 2=环境错误。

设计依据：docs/子系统设计/屏板链路设计说明.md §6（状态灯映射表）。
创建日期：2026-10-29
"""
import os
import sys

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

from unit_test_harness import TestBuild, run_host_unit_test  # noqa: E402

BUILD = TestBuild(
    name="SB LED Map Tests",
    src=os.path.join(HERE, "sb_led_map_test.c"),
    include_dirs=[
        os.path.join(ROOT, "App", "algo"),
        HERE,
    ],
    summary_marker="=== SB LED Map Tests:",
)

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