← ClaudeAtlas

gdunit-driverlisted

Run gdUnit4 unit tests and parse results into structured output. Use this skill after writing or modifying code to verify correctness via unit tests, when diagnosing test failures, or when writing new test files. Triggers: "run tests", "test fails", "write a test", any gdUnit4/unit test mention. Supports both GDScript (.gd) and C# (.cs) test files.
RandallLiuXin/GodotMaker · ★ 219 · AI & Automation · score 79
Install: claude install-skill RandallLiuXin/GodotMaker
# gdUnit4 Test Driver $ARGUMENTS ## 1. Locate the Godot executable Read the path from the project's config file. This avoids hardcoding paths that differ per machine. ```bash # From a skill script: GODOT=$(bash "${CLAUDE_SKILL_DIR}/../_read_config.sh" godot_path) # Or parse directly — .claude/godotmaker.yaml contains: # godot_path: "C:/path/to/Godot.exe" # Fall back to "godot" if config is missing. ``` ## 2. Run tests The CLI runner across all supported versions (v4.x, v5.x, v6.x) is `addons/gdUnit4/bin/GdUnitCmdTool.gd`. The path uses capital-U `gdUnit4/` to match the upstream repo layout — Windows is case-insensitive but Godot's global script registry de-duplicates by exact path string, so a casing mismatch between the runner invocation and the on-disk directory triggers `Class "..." hides a global script class` parse errors and a non-zero exit. ```bash # Single file "$GODOT" --headless -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd \ --add res://test/test_example.gd --ignoreHeadlessMode # Multiple files "$GODOT" --headless -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd \ --add res://test/test_physics.gd --add res://test/test_spawner.gd \ --ignoreHeadlessMode # All tests in a directory "$GODOT" --headless -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd \ --add res://test/ --ignoreHeadlessMode ``` Notes: - Include `--ignoreHeadlessMode` for headless runs. - Use `--add` to enqueue test files or directories (repeat the flag for multiples). - Runner path needs the