GdUnit4 - Unit Testing Framework 6.0.0 Tools 4.5 Community

Submitted by user NullPointer; MIT; 2025-10-07

# GdUnit4 v6.0.0
This version of GdUnit4 is build on Godot v4.5.stable.mono.official [876b29033]


## Please read the following disclaimer carefully before proceeding!
Before you install the new version, you have to disable the plugin and delete.
- Deactivate the GdUnit4 plugin if you have installed
- Uninstall the current GdUnit4 version (delete the folder res://addons/gdUnit4)
- Restart Godot
- Install this version and restart Godot
- Activate the GdUnit4 plugin

https://mikeschulze.github.io/gdUnit4/

## Features

### Core Testing Features

* **Support for GDScript and C#**
Write and execute tests in both GDScript and C#
* **Embedded Test Inspector**
Navigate your test suites directly within the Godot editor
* **Test Discovery**
Automatically searches for tests at runtime and adds them to the inspector
* **Convenient Interface**
Run test-suites directly from Godot using the context menu (FileSystem panel, ScriptEditor, or GdUnit Inspector)
* **Create Tests from Editor**
Right-click on any function in the ScriptEditor and select "Create TestCase" to generate tests automatically

### Test Writing & Assertions

* **Fluent Syntax**
Write test cases with an easy-to-read, fluent interface
* **Wide Range of Assertions**
Comprehensive assertion methods for verifying behavior and output
* **Argument Matchers**
Verify function calls with expected arguments
* **Unicode Text Support**
Full support for unicode characters in test strings and assertions
* **Variadic Arguments Support**
Test functions that accept variable numbers of arguments

### Advanced Testing Capabilities

* **Test Fuzzing**
Generate random inputs to test edge cases and boundary conditions
* **Parameterized Tests**
Test functions with multiple sets of inputs and expected outputs
* **Test Session Hooks**
Set up and tear down test resources at the session level for efficient test management
* **Mocking & Spying**
* Mock classes to simulate behavior and define output for specific functions
* Spy on functions to verify they were called with expected parameters
* Mock or spy on scenes to simulate behavior and verify function calls
* **Scene Runner**
Simulate different kinds of inputs and actions:
* Mouse clicks and movements
* Keyboard inputs
* Touch screen interactions
* Custom input actions
* Wait for specific signals or function return values
* **Flaky Test Handling**
Detect and handle flaky tests by rerunning failed tests
Configure retry count and mark non-deterministic failures in test results
* **Configurable Templates**
Customize templates for generating new test-suites

### Continuous Integration Support

* **Command Line Tool**
Run tests outside the Godot editor for CI/CD pipelines
* **HTML Report Generation**
Generate comprehensive HTML test reports
* **JUnit XML Report**
Export test results in JUnit XML format for CI integration
* **GitHub Action Integration**
Public marketplace action for integrating GdUnit4 into your CI workflow
[gdunit4-action](https://github.com/marketplace/actions/gdunit4-test-runner-action)

### GdUnit4Net - C# Support

* **C# API** - [gdUnit4.api](https://github.com/MikeSchulze/gdUnit4Net/blob/master/README.md)
Full support for writing tests in C#
* **VSTest Integration** - [gdunit4.test.adapter](https://github.com/MikeSchulze/gdUnit4Net/blob/master/TestAdapter/README.md)
Run and debug tests in:
* Visual Studio
* Visual Studio Code
* JetBrains Rider

---

- You are welcome to test in and send me your feedback
- You are welcome to suggest improvements
- You are welcome to report bugs