gdscript-test

minami110 的头像作者 minami110

为Godot项目运行GDUnit4测试。在实现功能、修复错误或修改GDScript文件后验证正确性时使用。

📖 中文导读:为Godot项目运行GDUnit4测试。在实现功能、修复错误或修改GDScript文件后验证正确性时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: GDScript Test description: Run GDUnit4 tests for Godot projects. Use after implementing features, fixing bugs, or modifying GDScript files to verify correctness.

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