Auto-bootstrap GAP9 venv + board config in runners

Add `testUtils/gap9Bootstrap.py` exporting `bootstrap_gap9_env()`,
which replaces the manual `source .gap9-venv/bin/activate`,
`source configs/gap9_evk_audio.sh`, and `export GVSOC_INSTALL_DIR`
dance documented in `README_GAP9.md`. The helper:

- runs `bash -c 'source gap9_evk_audio.sh && env -0'` to capture the
  board config's exports and merges them into a fresh env;
- sets `VIRTUAL_ENV` and prepends the venv's `bin/` to `PATH` so
  subprocesses (gapy, etc.) also pick up the venv;
- `os.execve`s under the venv's python (skipped if `sys.executable`
  is already the venv interpreter);
- is idempotent via a `DEEPLOY_GAP9_BOOTSTRAPPED` recursion guard;
- is a no-op outside the GAP9 container, when the SDK paths don't
  exist.

`GAP_SDK_HOME` overrides the default `/app/install/gap9-sdk`.

Wire `bootstrap_gap9_env()` into both `deeployRunner_gap9.py` and
`deeployRunner_tiled_gap9.py` before the rest of the imports run.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Xeratec

DeeployTest/deeployRunner_gap9.py

@@ -5,7 +5,11 @@
 
 import sys
 
-from testUtils.deeployRunner import main
+from testUtils.gap9Bootstrap import bootstrap_gap9_env
+
+bootstrap_gap9_env()
+
+from testUtils.deeployRunner import main  # noqa: E402
 
 if __name__ == "__main__":
 

DeeployTest/deeployRunner_tiled_gap9.py

@@ -5,7 +5,11 @@
 
 import sys
 
-from testUtils.deeployRunner import main
+from testUtils.gap9Bootstrap import bootstrap_gap9_env
+
+bootstrap_gap9_env()
+
+from testUtils.deeployRunner import main  # noqa: E402
 
 if __name__ == "__main__":
 

DeeployTest/testUtils/gap9Bootstrap.py

@@ -0,0 +1,64 @@
+# SPDX-FileCopyrightText: 2025 ETH Zurich and University of Bologna
+#
+# SPDX-License-Identifier: Apache-2.0
+
+import os
+import shlex
+import subprocess
+import sys
+from pathlib import Path
+
+__all__ = ["bootstrap_gap9_env"]
+
+_BOOTSTRAP_FLAG = "DEEPLOY_GAP9_BOOTSTRAPPED"
+_DEFAULT_SDK_HOME = "/app/install/gap9-sdk"
+
+
+def bootstrap_gap9_env() -> None:
+    """Re-exec under the GAP9 venv with `gap9_evk_audio.sh` already sourced.
+
+    Replaces the manual ``source .gap9-venv/bin/activate`` /
+    ``source gap9_evk_audio.sh`` / ``export GVSOC_INSTALL_DIR=...`` dance
+    documented in ``README_GAP9.md``. Idempotent (guarded by the
+    ``DEEPLOY_GAP9_BOOTSTRAPPED`` env flag) and a no-op outside the GAP9
+    container, where the SDK paths don't exist. Override the SDK location
+    with ``GAP_SDK_HOME``.
+
+    Call this BEFORE importing anything that depends on the GAP9 venv's
+    site-packages — once we re-exec, the new interpreter starts from
+    scratch.
+    """
+    if os.environ.get(_BOOTSTRAP_FLAG) == "1":
+        return
+
+    sdk = Path(os.environ.get("GAP_SDK_HOME", _DEFAULT_SDK_HOME))
+    venv_dir = sdk / ".gap9-venv"
+    venv_py = venv_dir / "bin" / "python"
+    board_cfg = sdk / "configs" / "gap9_evk_audio.sh"
+    gvsoc_install = sdk / "install" / "workstation"
+
+    if not venv_py.exists() or not board_cfg.exists():
+        return
+
+    # Capture the env after sourcing the board config; suppress any chatter
+    # so it can't be mistaken for env entries.
+    out = subprocess.check_output(["bash", "-c", f"source {shlex.quote(str(board_cfg))} >/dev/null 2>&1 && env -0"])
+    new_env = dict(os.environ)
+    for entry in out.split(b"\x00"):
+        if not entry:
+            continue
+        key, _, value = entry.decode().partition("=")
+        new_env[key] = value
+
+    # Mimic what `activate` does so anything we shell out to (gapy, etc.)
+    # also picks up the venv.
+    new_env["VIRTUAL_ENV"] = str(venv_dir)
+    new_env["PATH"] = f"{venv_dir / 'bin'}{os.pathsep}{new_env.get('PATH', '')}"
+    new_env["GVSOC_INSTALL_DIR"] = str(gvsoc_install)
+    new_env[_BOOTSTRAP_FLAG] = "1"
+
+    if Path(sys.executable).resolve() == venv_py.resolve():
+        os.environ.update(new_env)
+        return
+
+    os.execve(str(venv_py), [str(venv_py), *sys.argv], new_env)