harness.py

Part of HexGL.

"""SceneRunner-driven smoke harness for HexGL.

Validates: track builds, ship moves around the loop, race manager ticks,
checkpoint detection, and lap completion firing.

Run with:
    uv run python examples/ports/hexgl/harness.py
"""

from __future__ import annotations

import sys
from pathlib import Path

_PORT_DIR = Path(__file__).parent
if str(_PORT_DIR) not in sys.path:
    sys.path.insert(0, str(_PORT_DIR))

from main import HexGLRoot  # noqa: E402

from simvx.core.testing import SceneRunner  # noqa: E402


def main() -> None:
    runner = SceneRunner()
    root = HexGLRoot()
    runner.load(root)

    # Tick a few frames so on_ready runs.
    runner.advance_frames(5)
    assert root.track is not None, "Track did not build"
    assert root.ship is not None, "Ship not added"
    assert root.race is not None, "Race manager not added"
    assert len(root.track.checkpoints) == 6
    assert len(root.track.boost_pads) == 3

    # Leave the title screen, skip the countdown and start with a high speed;
    # advance a long way and verify the ship's t parameter wraps and laps complete.
    root.begin_race()
    root.race.skip_countdown()
    root.ship.speed = 70.0
    runner.advance_frames(60 * 12)  # 12 seconds @ 60 fps

    # The ship should have advanced (track total_length is ~600 m, speed 70 → ~12s/lap).
    assert root.ship.t != 0.0, "Ship didn't move"
    assert root.race.elapsed > 0.0, "Race elapsed didn't increment"

    print("Harness: PASS")
    print(f"  ship.t={root.ship.t:.3f}  speed={root.ship.speed:.1f}  lap={root.race.lap}")
    print(f"  total_length={root.track.total_length:.1f}  laps_completed={len(root.race.lap_times)}")
    print(f"  shield={root.ship.shield:.2f}  destroyed={root.ship.destroyed}")


if __name__ == "__main__":
    main()