GDScript Test

Run GDUnit4 tests using the test wrapper script.

When to Use

• After implementing new features
• After fixing bugs
• After modifying GDScript files
• When you need to verify test coverage
• When running CI/CD validation locally

Test Execution

Run All Tests

.claude/skills/gdscript-test-skill/scripts/run_test.sh

Runs all tests in tests/ directory with suppressed Godot logs (only shows failures).

Run Specific Test File

.claude/skills/gdscript-test-skill/scripts/run_test.sh tests/test_foo.gd

Run Multiple Tests

.claude/skills/gdscript-test-skill/scripts/run_test.sh tests/test_foo.gd tests/test_bar.gd

Run Tests in Directory

.claude/skills/gdscript-test-skill/scripts/run_test.sh tests/application/

Verbose Mode

.claude/skills/gdscript-test-skill/scripts/run_test.sh -v

Shows all Godot logs (useful for debugging test issues).

Understanding Results

Success

=================================================
ALL TESTS PASSED (X tests)
=================================================

Failure

=================================================
TEST FAILURES (X of Y tests failed)
=================================================

[1] TestClassName :: test_method_name
    File: tests/test_file.gd:42
    Expected: 'expected_value'
    Actual:   'actual_value'

Exit Codes

• 0: All tests passed
• 1: Some tests failed
• 2: Error (e.g., report file not found)

Notes

• Script automatically changes to project root before running tests
• Test reports are saved in reports/ directory
• Uses gdUnit4 framework (configured in project.godot)
• Compatible with CI/CD environments