| name | test |
| description | Guide for running Nanvix tests with z. Use this when asked to run unit tests, integration tests, or the full test suite. |
Test Nanvix
Use this skill when the user asks to run tests on Nanvix. This covers unit tests, system
integration tests, and the combined test suite exposed through the z utility.
Prerequisites
- Development environment set up per
doc/setup.md.
- A successful build of the components under test (see the
build skill).
Unit Tests
./z build -- run-unit-tests
System Integration Tests (microvm only)
./z build -- run-nanvix-tests
Test configurations are auto-selected based on deployment mode:
- Standalone:
test/test-standalone.toml (Linux), test/test-standalone-windows.toml (Windows)
- Single-process:
test/test-single_process.toml
All Tests
./z build -- test
Windows
On Windows, unit tests can be run natively through z.ps1:
.\z.ps1 build -- run-unit-tests
System integration tests are also available on Windows for standalone mode
(DEPLOYMENT_MODE=standalone) on microvm machines:
.\z.ps1 build -- run-nanvix-tests
Single-process deployment mode remains Linux-only as it requires
nanvixd in HTTP mode.
Troubleshooting Test Failures
- Ensure the project builds successfully before running tests (see the
build skill).
- Use
LOG_LEVEL=trace or LOG_LEVEL=debug for more verbose output when diagnosing failures.
- See the
troubleshooting skill for deeper diagnosis of runtime and test failures.
