| name | run-unit-tests |
| description | Build and run dxvk-remix unit tests. Use when the user asks to run tests, add new tests, or verify that code changes pass existing tests. |
Run Unit Tests
All commands run in PowerShell from the repo root.
Unit tests live in tests/rtx/unit/. New test files must be added to tests/rtx/unit/meson.build.
IMPORTANT: Unit tests use a separate dedicated build directory (_Comp64UnitTest) with special build flags. Do NOT run unit tests from game build directories (_Comp64DebugOptimized, _Comp64Release, etc.) — they will fail.
First-Time Setup
Build the unit test configuration:
.\build_dxvk.ps1 -BuildFlavour release -BuildSubDir _Comp64UnitTest -Backend ninja -EnableTracy false -BuildTarget unit_tests -InstallTags unit
Running Tests
Once _Comp64UnitTest exists:
cd _Comp64UnitTest
meson test --verbose # run all tests
meson test --verbose <name> # run a specific test
Incremental Rebuild and Retest
If test source files have changed, rebuild before running:
cd _Comp64UnitTest; meson compile -v; meson test --verbose <name>
Test Guidelines
- Minimal dependencies. Refactor tested code if needed to reduce coupling.
- Full branch coverage with carefully designed test data.
- Return 0 on success, -1 on failure.
- Include descriptive logging on failure.
If the above steps don't work, check tools/ci/gitlab/unit_test.yml for the latest commands.
