godot-testing-patterns

name	godot-testing-patterns
description	Expert testing decision trees for GdUnit4: unit vs scene vs CI gates, headless runners, snapshots, and mock networks. Use when choosing test layers, wiring CI, or validating signals/physics without beginner assert catalogs. Keywords: GdUnit4, GdUnitTestSuite, headless CI, snapshot test, mock network, scene integration test, TDD.

Decision Tree → Scripts

Need	Choice	Script (MANDATORY when chosen)
Pure logic / no tree	Unit	basic_unit_test.gd, mock_dependency_test.gd, test_data_factory.gd
Node interaction after instantiate	Scene integration	scene_integration_test.gd, integration_test_base.gd
Signal contracts	Unit or scene	signal_emission_test.gd
Multi-frame / physics step	Async scene	wait_for_frame_test.gd, physics_collision_test.gd
Flaky physics / timing races	Frame step gate	MANDATORY wait_for_frame_test.gd — never wall-clock sleep
CI / no display