III.9 Running tests
| Flag | Meaning |
|---|---|
[paths] | packages, modules or files (svc/orders, src/cart/cart_test.oxl) |
--kind unit,integ,sim,contract,ab,bench,fuzz | kinds of tests; unit,integ,contract by default |
-f, --filter <regex> | by the full name module::name |
--exact <name> | a single test by exact name |
-t, --tag slow,db | only those with these labels; --tag !flaky — exclude |
--skip <regex> | exclude by name |
--failed | only those that failed in the last run |
--changed [ref] | tests affected by changes relative to a git reference (by the dependency graph) |
--seed N, --seeds a..b | seed for sim |
-j, --parallel N | number of parallel tests (cores by default) |
--timeout d | per-test limit (TEST_TIMEOUT = 60 s by default) |
--repeat N | repeat N times (finding flaky tests) |
--fail-fast | stop at the first failure |
--list | show the selected tests without running |
--coverage [--html] | coverage of lines, branches and error variants |
--update-snapshots | overwrite snapshots |
--graph | open the call graph of a failed integ/sim test |
--debug | run the test under the debugger |
--format pretty|json|junit | report format |
Selection is combined with AND: oxl test svc/orders --kind sim -t payments --seeds 1..200 -f checkout.
Source: docs/spec/oxl-standard.en.md