Attempting to do CI to run unit tests on all PRs.

.github/actions-tests/README.md

@@ -0,0 +1,42 @@
+# Actions Tests
+
+This folder contains the Python unit-test harness for the reusable GitHub Actions under `.github/actions`.
+The subfolder layout mirrors the action names so each action's tests live beside the corresponding action name under `.github/actions-tests`.
+
+## Local setup
+
+1. Run the setup script:
+
+   ```bash
+   ./.github/actions-tests/setup_tests.sh
+   ```
+
+2. Run the tests and generate coverage artifacts:
+
+   ```bash
+   ./.github/actions-tests/run_tests.sh
+   ```
+
+If `.github/actions-tests/.venv` exists, the test runner will automatically use it.
+
+To use a specific Python interpreter during setup, set `PYTHON_ACTION_TEST_SETUP_PYTHON_BIN`:
+
+```bash
+PYTHON_ACTION_TEST_SETUP_PYTHON_BIN=python3.13 ./.github/actions-tests/setup_tests.sh
+```
+
+## Generated artifacts
+
+By default, test artifacts are written under `.github/actions-tests/build/python-action-test-results/`:
+
+- `junit.xml`
+- `coverage.xml`
+- `htmlcov/`
+
+## Optional coverage threshold
+
+To fail the test run if total coverage drops below a minimum percentage:
+
+```bash
+PYTHON_ACTION_TEST_COVERAGE_FAIL_UNDER=90 ./.github/actions-tests/run_tests.sh
+```

.github/actions-tests/conftest.py

@@ -0,0 +1,92 @@
+import importlib.util
+import sys
+from pathlib import Path
+
+import pytest
+
+
+def determine_repo_root() -> Path:
+    current_path = Path(__file__).resolve()
+    for candidate in current_path.parents:
+        if (candidate / ".git").exists():
+            return candidate
+
+    raise RuntimeError("Unable to determine repository root for Python action tests")
+
+
+REPO_ROOT = determine_repo_root()
+
+
+@pytest.fixture(scope="session")
+def repo_root() -> Path:
+    return REPO_ROOT
+
+
+@pytest.fixture(scope="session")
+def python_executable() -> str:
+    return sys.executable
+
+
+def load_module(module_name: str, relative_path: str):
+    module_path = REPO_ROOT / relative_path
+    spec = importlib.util.spec_from_file_location(module_name, module_path)
+    if spec is None or spec.loader is None:
+        raise RuntimeError(f"Unable to load module: {module_path}")
+
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[module_name] = module
+    spec.loader.exec_module(module)
+    return module
+
+
+@pytest.fixture(scope="session")
+def pick_simulator_module():
+    return load_module(
+        "test_pick_simulator_module",
+        ".github/actions/simctl-tricorder-selector/pick_simulator.py",
+    )
+
+
+@pytest.fixture(scope="session")
+def run_xcode_tests_module():
+    return load_module(
+        "test_run_xcode_tests_module",
+        ".github/actions/xcode-tricorder-tester/run_xcode_tests.py",
+    )
+
+
+@pytest.fixture(scope="session")
+def coverage_summary_module():
+    return load_module(
+        "test_generate_coverage_summary_module",
+        ".github/actions/xccov-warp-bubble/generate_coverage_summary.py",
+    )
+
+
+@pytest.fixture()
+def sample_devices_payload():
+    return {
+        "devices": {
+            "com.apple.CoreSimulator.SimRuntime.iOS-18-0": [
+                {"name": "iPhone 16", "udid": "IPHONE16", "isAvailable": True},
+                {"name": "iPhone 16 Pro Max", "udid": "IPHONE16PM", "isAvailable": True},
+                {"name": "iPad Pro 13-inch (M4)", "udid": "IPADPRO", "isAvailable": True},
+                {"name": "iPhone 14", "udid": "IPHONE14", "isAvailable": False},
+            ],
+            "com.apple.CoreSimulator.SimRuntime.iOS-17-5": [
+                {"name": "iPhone SE (3rd generation)", "udid": "IPHONESE", "isAvailable": True},
+            ],
+            "com.apple.CoreSimulator.SimRuntime.macOS-15-0": [
+                {"name": "My Mac", "udid": "MYMAC", "isAvailable": True},
+            ],
+            "com.apple.CoreSimulator.SimRuntime.watchOS-11-0": [
+                {"name": "Apple Watch Series 10 (42mm)", "udid": "WATCH10", "isAvailable": True},
+            ],
+            "com.apple.CoreSimulator.SimRuntime.visionOS-2-0": [
+                {"name": "Apple Vision Pro", "udid": "VISIONPRO", "isAvailable": True},
+            ],
+            "com.apple.CoreSimulator.SimRuntime.tvOS-18-0": [
+                {"name": "Apple TV", "udid": "TV", "isAvailable": True},
+            ],
+        }
+    }

.github/actions-tests/pyproject.toml

@@ -0,0 +1,26 @@
+[tool.pytest.ini_options]
+testpaths = [
+  "simctl-tricorder-selector",
+  "xcode-tricorder-tester",
+  "xccov-warp-bubble",
+]
+python_files = ["*_tests.py"]
+junit_family = "xunit2"
+addopts = ["-ra"]
+
+[tool.coverage.run]
+branch = true
+relative_files = true
+patch = ["subprocess"]
+source = [
+  ".github/actions/simctl-tricorder-selector",
+  ".github/actions/xccov-warp-bubble",
+  ".github/actions/xcode-tricorder-tester",
+]
+omit = [".github/actions-tests/*"]
+
+[tool.coverage.report]
+show_missing = true
+skip_empty = true
+precision = 2
+omit = [".github/actions-tests/*"]

.github/actions-tests/requirements.txt

@@ -0,0 +1,2 @@
+pytest>=8.0,<9
+pytest-cov>=5.0,<7

.github/actions-tests/run_tests.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+repo_root="$(cd "$script_dir/../.." && pwd)"
+
+results_dir="${PYTHON_ACTION_TEST_RESULTS_DIR:-$script_dir/build/python-action-test-results}"
+coverage_fail_under="${PYTHON_ACTION_TEST_COVERAGE_FAIL_UNDER:-}"
+python_bin="${PYTHON_ACTION_TEST_PYTHON_BIN:-}"
+
+if [[ -z "$python_bin" && -x "$script_dir/.venv/bin/python" ]]; then
+  python_bin="$script_dir/.venv/bin/python"
+fi
+
+if [[ -z "$python_bin" ]]; then
+  python_bin="python3"
+fi
+
+mkdir -p "$results_dir"
+cd "$repo_root"
+export COVERAGE_FILE="$script_dir/.coverage"
+rm -f "$script_dir"/.coverage "$script_dir"/.coverage.*
+
+cleanup_python_caches() {
+  find "$repo_root" -type d \( -name "__pycache__" -o -name ".pytest_cache" \) -prune -exec rm -rf {} +
+}
+
+trap cleanup_python_caches EXIT
+
+pytest_args=(
+  "-c" "$script_dir/pyproject.toml"
+  "$script_dir/simctl-tricorder-selector"
+  "$script_dir/xcode-tricorder-tester"
+  "$script_dir/xccov-warp-bubble"
+  "--junitxml=$results_dir/junit.xml"
+  "--cov=.github/actions/simctl-tricorder-selector"
+  "--cov=.github/actions/xcode-tricorder-tester"
+  "--cov=.github/actions/xccov-warp-bubble"
+  "--cov-branch"
+  "--cov-report="
+)
+
+if [[ -n "$coverage_fail_under" ]]; then
+  pytest_args+=("--cov-fail-under=$coverage_fail_under")
+fi
+
+set +e
+"$python_bin" -m pytest "${pytest_args[@]}"
+pytest_exit_code=$?
+set -e
+
+shopt -s nullglob
+coverage_shards=( "$script_dir"/.coverage.* )
+shopt -u nullglob
+
+if [[ ${#coverage_shards[@]} -gt 0 ]]; then
+  "$python_bin" -m coverage combine "$script_dir"
+fi
+
+"$python_bin" -m coverage report --skip-covered --show-missing
+"$python_bin" -m coverage xml -o "$results_dir/coverage.xml"
+"$python_bin" -m coverage html -d "$results_dir/htmlcov"
+
+exit "$pytest_exit_code"

.github/actions-tests/setup_tests.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+python_bin="${PYTHON_ACTION_TEST_SETUP_PYTHON_BIN:-python3}"
+venv_dir="${PYTHON_ACTION_TEST_VENV_DIR:-$script_dir/.venv}"
+venv_python="$venv_dir/bin/python"
+
+if [[ ! -d "$venv_dir" ]]; then
+  "$python_bin" -m venv "$venv_dir"
+fi
+
+"$venv_python" -m pip install -r "$script_dir/requirements.txt"
+
+echo "Python action test environment is ready: $venv_dir"