run.py

#!/usr/bin/env python3
"""Build web if needed, then start the HTTP server."""

from __future__ import annotations

import os
import subprocess
import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parent
DIST_INDEX = ROOT / "web" / "dist" / "index.html"


def main() -> int:
    npm = "npm.cmd" if sys.platform == "win32" else "npm"
    if not (ROOT / "server" / "node_modules").is_dir():
        subprocess.run([npm, "install"], cwd=ROOT / "server", check=True)
    if not DIST_INDEX.is_file():
        subprocess.run([sys.executable, str(ROOT / "build.py")], cwd=ROOT, check=True)
    env = {**os.environ}
    if "PORT" not in env:
        env["PORT"] = "3000"
    cmd = [npm, "start"]
    print(f"+ {' '.join(cmd)} (cwd={ROOT / 'server'})", flush=True)
    subprocess.run(cmd, cwd=ROOT / "server", env=env, check=True)
    return 0


if __name__ == "__main__":
    raise SystemExit(main())