# Run Unit Tests

> 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.

- Skill: `nvidiagameworks/run-unit-tests` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nvidiagameworks/run-unit-tests`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nvidiagameworks/run-unit-tests/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nvidiagameworks (https://skillmd.com/u/nvidiagameworks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nvidiagameworks/run-unit-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:

```powershell
.\build_dxvk.ps1 -BuildFlavour release -BuildSubDir _Comp64UnitTest -Backend ninja -EnableTracy false -BuildTarget unit_tests -InstallTags unit
```

## Running Tests

Once `_Comp64UnitTest` exists:

```powershell
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:

```powershell
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.