Home

Gut 7.0.0

GUT (Godot Unit Test) is a utility for writing tests for your Godot Engine game. It allows you to write tests for your gdscripts in gdscript.

Godot 3.1.x, 3.2 Compatible.

• As of version 6.8.1 Gut is compatible with version 3.2.x as well as 3.1.x.

Getting Started

• Install
• Quick Start
• Asserts and Methods
• Creating Tests
• Gut Settings and Methods
• Using Gut at the command line

Advanced Testing

• Inner Test Classes
• Doubling
• Spies
• Stubbing
• Parameterized Tests
• Simulate
• Yielding during tests
• Pre/Post Run Hooks

GUI

1. Output Box.
2. List of Test Scripts. Inner Classes are indented under scripts.
3. Progress bars for all scripts and the current script.
4. Log Level slider.
5. Previous Script (in list of scripts)
6. Run the currently selected script and all scripts after it. This can be especially useful when running on another device and some script in the middle of the list causes a crash. To run the tests after the crash, just select that test in the list and click this button. It will run that one and all the ones after.
7. Next Script (in list of scripts)
8. Run the currently selected script. If an Inner Class is selected then just that class will be run. If a Script is selected then the script and all of its Inner Classes will be run.
9. Toggle display of List of Test Scripts
10. The Hamburger button. It shows some additional options.
11. Continue button will be enabled if a call to yield_before_teardown occurs. Click it to continue running tests.
12. The title bar. It has a maximize button, shows the current script, has a running tally on the left of the pass/fail count, shows the elapsed time. Also you can drag it all about.

Also, in the bottom right corner, you can drag to resize the dialog.

Engine Warnings

There are a fair number of warnings that Godot will show related to GUT. Some of the warnings are valid and are being cleaned up overtime. Most of the warnings are not valid and sometimes relate to generated code. As of 3.2 you can disable warnings for addons, and it recommended you do so.

License

Gut is provided under the MIT license. The license is distributed with Gut so it is in the addons/gut folder.

Contributing

Contributing

Who do I talk to?

You can talk to me, Butch Wesley

• Github: bitwes
• Godot forums: bitwes
• Godot Discord: bitwes