Add test runner script with auto venv activation

Author: SCLW

.gitignore

@@ -11,3 +11,4 @@ test/sim_build
 test/__pycache__/
 test/results.xml
 test/gate_level_netlist.v
+test/.venv/

test/run.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Run tt-lfsr32 cocotb tests. Activates the Python 3.13 venv automatically.
+# Usage: ./run.sh            (RTL sim)
+#        ./run.sh GATES=yes  (gate-level sim)
+cd "$(dirname "$0")" || exit 1
+
+if [ ! -d .venv ]; then
+  echo "venv missing — creating it with python3.13 ..."
+  python3.13 -m venv .venv && .venv/bin/pip install -r requirements.txt || exit 1
+fi
+
+source .venv/bin/activate
+make "$@"