#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""FTP socket 适配层（lftpd_inet）主机侧纯逻辑单元测试运行器（纯标准库）。

做什么：
    用本机 MSVC 编译 test/host/lftpd_inet/lftpd_inet_test.c（以 #include 纳入生产源
    Drivers/BSP/NET/lftpd/lftpd_inet.c），离线验证监听/接受/读写适配：端口过 htons、
    accept 每轮喂狗让出、网络代次一变就撤 accept、监听门撤防立即放弃、read_line 的
    CRLF 截断与分片拼接与 200ms 分片 + 30s 总预算、错误码原样返回、短写续传。

为什么要主机侧单测（而不是只用台架）：
    代次撤 accept 与撤防放弃只在异常时刻成立（网络重建、客户端连上控制口却不开数据
    通道），台架极难复现而真机上是常见自愈路径；200ms 分片写错会饿死看门狗、30s 预算
    写错会让 ftpTask 永久卡在一条命令上；短写没续传就是"FTP 响应少半条"。这些都要
    按毫秒与字节数着测。

桩的边界：private/lftpd_inet.h 与 net_types.h 用真实头（struct net_sockaddr_in 的
    sin_port 注释就写着"网络字节序"，htons/ntohs 契约靠它钉住）；net_socket.h 是桩，
    函数原型与真实头逐字一致；FreeRTOS.h / task.h 给宿主 tick 与 vTaskDelay（带跑飞
    保险）。lftpd_task_wd_beat 是 __weak 空实现、主机侧替换不掉，故用同段代码里的
    "睡 100ms"次数当喂狗轮数的代理。

用法（仓库根目录）：
    python test/host/lftpd_inet/run_unit_test.py

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

设计依据：docs/子系统设计/网络配置说明.md §3.4、docs/测试说明/FTP_Test_Guide.md、
docs/测试说明/主机单测覆盖率口径.md §9
创建日期：2026-10-23
"""
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="LFTPD INET Tests",
    src=os.path.join(HERE, "lftpd_inet_test.c"),
    include_dirs=[
        os.path.join(HERE, "stub"),
        os.path.join(ROOT, "Drivers", "BSP", "NET", "lftpd"),
        os.path.join(ROOT, "Drivers", "BSP", "NET"),
        HERE,
    ],
    extra_flags=["/D_CRT_SECURE_NO_WARNINGS"],
    summary_marker="=== LFTPD INET Tests:",
)

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