Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions TESTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <filterset>` narrows the tests with a nextest filterset, and
`--keep` leaves the VM running until you press Enter. Two runs on one host
Expand Down
Loading