A unit testing framework for the Godot Engine that lets you write tests for GDScript in GDScript.
GUT is a unit testing framework for the Godot game engine. It allows developers to write tests for their GDScript code using GDScript itself, providing a seamless testing experience within the Godot editor. The tool helps ensure code quality and reliability in game development projects by enabling test-driven development practices.
Godot developers and game programmers who write GDScript and want to implement unit testing in their projects to improve code stability and maintainability.
Developers choose GUT because it is specifically designed for Godot, integrates natively via the Asset Library, and offers a comprehensive set of testing features like doubling, parameterized tests, and CLI support, making it the go-to testing solution for the Godot ecosystem.
Godot Unit Test. Unit testing tool for Godot Game Engine.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Installs directly via Godot's Asset Library and runs tests within the editor, mirroring the native development environment for reduced friction.
Offers a wide array of asserts, test doubling for mocking, parameterized tests, and JUnit XML export, enabling robust unit testing workflows.
Includes a command-line interface to run tests headlessly, facilitating easy integration into automated pipelines and continuous integration systems.
Requires careful version matching between GUT and Godot (e.g., 9.x for Godot 4.x, 7.x for Godot 3.x), which can complicate upgrades and project maintenance.
Exclusively designed for GDScript, making it unsuitable for testing C# or other languages within Godot, a noted gap in the ecosystem.
Documentation is hosted externally on Read the Docs, which may be less convenient than in-editor help and requires internet access for updates.