From 55c1df7237871a8c4c3b057984ed6a898addbef0 Mon Sep 17 00:00:00 2001 From: Evan Lezar Date: Thu, 5 Nov 2026 11:56:01 +0100 Subject: [PATCH] docs(testing): note that tmachine runs on macOS tmachine boots guests with the Hypervisor framework on macOS, so the runner does not need KVM there. Signed-off-by: Evan Lezar --- TESTING.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/TESTING.md b/TESTING.md index 5e74f53c72..4d0213ef90 100644 --- a/TESTING.md +++ b/TESTING.md @@ -232,14 +232,14 @@ nix run .#openshell-test-runner -- \ --family conformance --package conformance ``` -It needs KVM, and tmachine only boots guests of the host's architecture. The -runner points the tests at the installed CLI and the gateway the installer -registered (`--gateway`, default `openshell`). A run passes if nextest -succeeds; nextest fails a run with no tests. The runner exits with 1 when a -test failed and 2 when the run could not complete, for example because the -environment didn't come up. It writes `junit.xml`, `nextest.log` and, after a -failure, the guest's diagnostics to `artifacts/test-results/` (`--results`), -even when the run timed out. +It needs KVM on Linux or the Hypervisor framework on macOS, and tmachine only +boots guests of the host's architecture. The runner points the tests at the +installed CLI and the gateway the installer registered (`--gateway`, default +`openshell`). A run passes if nextest succeeds; nextest fails a run with no +tests. The runner exits with 1 when a test failed and 2 when the run could not +complete, for example because the environment didn't come up. It writes +`junit.xml`, `nextest.log` and, after a failure, the guest's diagnostics to +`artifacts/test-results/` (`--results`), even when the run timed out. `--filter ` narrows the tests with a nextest filterset, and `--keep` leaves the VM running until you press Enter. Two runs on one host