"""TIASshot の実機テストのランナー（PLAN_06．ユーザーが会話の中で実機テストを合図したときだけ実行する）.

実機のカメラ（Lumenera / ImagingSource）と光源（シリアルポート）を操作する．撮影の本番中に実行しないこと．
NUnit テスト・セルフテストは実行しない（それぞれ run_tests.py・run_selftest.py）．

手順:
  1. ランナーがビルドする構成（Debug|x64）の出力 bin/x64/Debug・obj/x64/Debug を削除する（--no-clean で省略）
  2. Debug|x64 をビルドする（HWTEST フラグ入り）
  3. TIASshot.exe が起動していないことを確かめる（起動中はカメラ・光源を使用中＝撮影の本番中の可能性があるため実行しない）
  4. TIASshot.exe --hwtest --camera <機種> を実行ファイルのフォルダで実行し，終了コードと結果ファイルで判定する
     （実際のフォームが表示される．保存先は %TEMP%\\TIASshot-hwtest\\work-* に差し替えられる）

--with-chart を付けると，チャート不要の検査（preview〜reconnect）の代わりにチャートが必要な検査
（calibrate・shot・close-saving・close-calibrating．校正を止めない．カメラの前に舌診チャートがはまっている前提）を行う．
チャート不要の検査と続けて実行する（connect・cleanup は両方で行う）．

出力: .verify/hwtest/run-<日時>/ に build.log・hwtest-result.txt・summary.json
終了コード: 0=全項目合格，1=不合格あり（ビルド失敗・検査の不合格・タイムアウト），
            2=前提条件を満たさない（ツール未導入・TIASshot 起動中・指定機種が見つからない・引数不正）

使い方（リポジトリルートで実行）:
  python scripts/verify/run_hwtest.py --camera lucam
  python scripts/verify/run_hwtest.py --camera iscam
  python scripts/verify/run_hwtest.py --camera iscam --with-chart   # チャートが必要な検査
  python scripts/verify/run_hwtest.py --camera iscam --no-clean   # Debug 出力を消さない（開発時の短縮用）
"""

from __future__ import annotations

import argparse
import datetime as dt
import json
import subprocess
import sys

from run_selftest import (BUILD_TIMEOUT_SEC, EXE, EXIT_FAIL, EXIT_OK, EXIT_PRECONDITION, REPO, SLN,
                          PreconditionError, clean_build_outputs, find_vs, run_logged)

# 実機テスト内部のウォッチドッグ（全体: チャート不要 10 分・--with-chart 20 分）より長くする．超えたらランナーがプロセスを打ち切る
HWTEST_TIMEOUT_SEC = 720
HWTEST_WITH_CHART_TIMEOUT_SEC = 1320

# 実機テスト（TIASshot.exe --hwtest）の終了コード
HW_PASS = 0
HW_FAIL = 1
HW_ERROR = 2
HW_TIMEOUT = 3


def is_tiasshot_running() -> bool:
    """TIASshot.exe が起動しているか（人間が撮影中ならカメラ・光源を使用中のため実機テストを行わない）."""
    proc = subprocess.run(["tasklist", "/FI", "IMAGENAME eq TIASshot.exe", "/FO", "CSV", "/NH"],
                          capture_output=True, check=False)
    out = proc.stdout.decode("cp932", errors="replace")
    return "tiasshot.exe" in out.lower()


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    parser.add_argument("--camera", required=True, choices=["lucam", "iscam"], help="検査するカメラの機種")
    parser.add_argument("--with-chart", action="store_true",
                        help="チャートが必要な検査（calibrate・shot・close-saving・close-calibrating．PLAN_06 フェーズ 2）を行う"
                             "（チャート不要の検査は行わない．舌診チャートをはめてから実行する）")
    parser.add_argument("--keep", action="store_true",
                        help="合格時も作業フォルダ（%%TEMP%%/TIASshot-hwtest/work-*）を残し，--with-chart では証拠の画像（evidence/*.png）も保存する（TIASshot.exe の --hwtest-keep）")
    parser.add_argument("--no-clean", action="store_true",
                        help="Debug 出力（bin/obj の x64/Debug）を削除しない（開発時の短縮用）")
    args = parser.parse_args()
    # エージェント（Git Bash 経由）が読めるよう，本ランナーの出力は UTF-8 に固定する
    if hasattr(sys.stdout, "reconfigure"):
        sys.stdout.reconfigure(encoding="utf-8")

    stamp = dt.datetime.now().strftime("%Y%m%d-%H%M%S")
    run_dir = REPO / ".verify" / "hwtest" / f"run-{stamp}"
    run_dir.mkdir(parents=True, exist_ok=True)
    summary: dict = {"run_dir": str(run_dir), "camera": args.camera, "with_chart": args.with_chart, "keep": args.keep,
                     "steps": [], "result": None}

    def step(name: str, ok: bool, detail: str) -> None:
        summary["steps"].append({"name": name, "ok": ok, "detail": detail})
        print(f"[{'OK' if ok else 'NG'}] {name}: {detail}", flush=True)

    exit_code = EXIT_OK
    try:
        vs = find_vs()
        msbuild = vs / "MSBuild" / "Current" / "Bin" / "MSBuild.exe"
        if not msbuild.exists():
            raise PreconditionError(f"MSBuild.exe が見つかりません: {msbuild}")

        if is_tiasshot_running():
            raise PreconditionError("TIASshot.exe が起動しています（撮影の本番中の可能性．カメラ・光源を使用中のため実機テストを行いません）")

        if not args.no_clean:
            clean_build_outputs()
            step("clean", True, "Debug 出力（bin/obj の x64/Debug）を削除")

        code = run_logged([str(msbuild), str(SLN), "/t:Build", "/p:Configuration=Debug", "/p:Platform=x64",
                           "/nologo", "/v:minimal"], run_dir / "build.log", BUILD_TIMEOUT_SEC)
        step("build", code == 0, f"Debug|x64 ビルド exit {code}（build.log）")
        if code != 0:
            exit_code = EXIT_FAIL
            raise RuntimeError("ビルド失敗")

        result_file = run_dir / "hwtest-result.txt"
        cmd = [str(EXE), "--hwtest", "--camera", args.camera, "--hwtest-out", str(result_file)]
        if args.keep:
            cmd.append("--hwtest-keep")
        if args.with_chart:
            cmd.append("--with-chart")
        summary["command"] = " ".join(cmd)
        timeout_sec = HWTEST_WITH_CHART_TIMEOUT_SEC if args.with_chart else HWTEST_TIMEOUT_SEC
        try:
            # デバイス状態ファイル（{DeviceName}.xml）は相対パスで読まれるため，通常起動と同じく実行ファイルのフォルダで実行する
            proc = subprocess.run(cmd, cwd=EXE.parent, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
                                  timeout=timeout_sec, check=False)
            code = proc.returncode
        except subprocess.TimeoutExpired:
            code = None
        text = result_file.read_text(encoding="utf-8-sig", errors="replace") if result_file.exists() else ""
        heads = [ln for ln in text.splitlines() if ln.startswith("[") or ln.startswith("RESULT:")]
        summary["hwtest_exit_code"] = code
        summary["hwtest_lines"] = heads
        if code is None:
            detail = f"{timeout_sec} 秒で終わらないためランナーが打ち切りました（hwtest-result.txt）"
        else:
            detail = f"exit {code}（hwtest-result.txt）"
        step("hwtest", code == HW_PASS, detail)
        for ln in heads:
            print(f"    {ln}", flush=True)
        if code == HW_ERROR:
            # 指定機種が見つからない・引数不正 → 実機テスト自体を行えない（検証不能）
            exit_code = EXIT_PRECONDITION
        elif code != HW_PASS:
            exit_code = EXIT_FAIL
    except PreconditionError as ex:
        step("precondition", False, str(ex))
        exit_code = EXIT_PRECONDITION
    except RuntimeError as ex:
        step("abort", False, str(ex))
        exit_code = EXIT_FAIL
    except subprocess.TimeoutExpired as ex:
        step("timeout", False, f"{ex.cmd} が {ex.timeout} 秒で終わりません")
        exit_code = EXIT_FAIL

    summary["result"] = {EXIT_OK: "PASS", EXIT_FAIL: "FAIL", EXIT_PRECONDITION: "PRECONDITION"}[exit_code]
    (run_dir / "summary.json").write_text(json.dumps(summary, ensure_ascii=False, indent=2), encoding="utf-8")
    print(f"RESULT: {summary['result']}  (出力: {run_dir})", flush=True)
    return exit_code


if __name__ == "__main__":
    sys.exit(main())