Skip to content

README.md

Latest commit

 

History

History
50 lines (39 loc) · 2.08 KB

README.md

File metadata and controls

50 lines (39 loc) · 2.08 KB
Raw

scripts/cli — Interactive CLI launcher

Interactive arrow-key wrapper around the headless scripts/run_simulation_cli.py. Walks the user through race / driver / laps / provider selection, auto-resolves the driver's team from data/processed/laps_featured_2025.parquet, and shells out to the headless runner with the right argv. Pure UX layer — no simulation logic lives here.

How to run

python scripts/f1_cli.py

Modes

  • Single Driver — full per-lap simulation for one driver in one race.
  • Head-to-Head — full simulation for Driver 1; Driver 2 is tracked as a rival in the same run via the --rival flag passed to run_simulation_cli.py (no second subprocess).

Module layout

  • theme.py — F1 brand palette (F1_RED, F1_AMBER, F1_GREEN, F1_WHITE, F1_GRAY), shared Rich console singleton, and the ASCII welcome banner.
  • pickers.py — _arrow_pick primitive (Windows msvcrt + POSIX termios branches), all interactive prompts (pick_mode, pick_race, pick_driver, pick_rival_code, pick_laps, pick_provider, ask_again), plus discover_races(repo_root, year) and the _load_driver_team_map(repo_root) parquet lookup.
  • runner.py — build_sim_cmd(...) builds the argv for run_simulation_cli.py, run_subprocess(cmd) executes it with PYTHONIOENCODING=utf-8 + PYTHONUTF8=1, and run_single / run_h2h are the two wizard flows.
  • ../f1_cli.py — top-level entry point. Loops pick_mode → run_single / run_h2h until the user picks Quit.

Adding a new picker

  1. Write the prompt helper in pickers.py (use _arrow_pick for menus, or Prompt.ask for free-text).
  2. Wire the call into runner.py:run_single and/or run_h2h, and forward the value into build_sim_cmd as a new kwarg + corresponding cmd.extend.

Windows note

The package enables VT-100 processing on Windows via ctypes SetConsoleMode(GetStdHandle(-11), 7) so ANSI escape codes (cursor moves, colors, the red ❯ cursor) render correctly in cmd.exe and Windows Terminal. The call is a no-op on non-Windows platforms.