gdUnit4.api 4.3.0

dotnet add package gdUnit4.api --version 4.3.0                
NuGet\Install-Package gdUnit4.api -Version 4.3.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="gdUnit4.api" Version="4.3.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add gdUnit4.api --version 4.3.0                
#r "nuget: gdUnit4.api, 4.3.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install gdUnit4.api as a Cake Addin
#addin nuget:?package=gdUnit4.api&version=4.3.0

// Install gdUnit4.api as a Cake Tool
#tool nuget:?package=gdUnit4.api&version=4.3.0                

The C# GdUnit4 API

What is GdUnit4.Api

gdUnit4.api is the C# package to enable GdUnit4 to run/write unit tests in C#.


  • Support for writing and executing tests in C#
  • Convenient interface for running test-suites directly from Godot<br> One of the main features of GdUnit4 is the ability to run test-suites directly from the Godot editor using the context menu. You can run test-suites from the FileSystem panel, the ScriptEditor, or the GdUnit Inspector. To do this, simply right-click on the desired test-suite or test-case and select "Run Test(s)" from the context menu. This will run the selected tests and display the results in the GdUnit Inspector.<br> You can create new test cases directly from the ScriptEditor by right-clicking on the function you want to test and selecting "Create TestCase" from the context menu.
  • Fluent syntax for writing test cases that's easy to read and understand
  • Configurable template for generating new test-suites when creating test-cases
  • Wide range of assertion methods for verifying the behavior and output of your code
  • Test Fuzzing support for generating random inputs to test edge cases and boundary conditions
  • Parameterized Tests (Test Cases) for testing functions with multiple sets of inputs and expected outputs
  • Scene runner for simulating different kinds of inputs and actions, such as mouse clicks and keyboard inputs<br> For example, you can simulate mouse clicks and keyboard inputs by calling the appropriate methods on the runner instance. Additionally, you can wait for a specific signal to be emitted by the scene, or you can wait for a specific function to return a certain value.

Short Example

namespace GdUnit4.Tests
    using static Assertions;

    public class StringAssertTest
        public void IsEqual()
            AssertThat("This is a test message").IsEqual("This is a test message");

You are welcome to

Thank you for supporting my project


Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on gdUnit4.api:

Package Downloads

GdUnit4 Test Adapter is the test adapter to run GdUnit4 tests in C#.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.3.0 431 7/9/2024
4.2.5 961 6/24/2024
4.2.4 736 6/4/2024
4.2.4-rc3 553 5/1/2024
4.2.4-rc2 178 4/27/2024
4.2.4-rc1 395 4/25/2024
4.2.3 2,354 4/17/2024
4.2.2 431 4/12/2024 753 3/10/2024
4.2.1 904 2/24/2024
4.2.0-rc.202402222030 1,855 2/22/2024
4.2.0-rc.202402212033 90 2/21/2024
4.2.0-rc.202312021729 3,236 12/2/2023


* GD-127: Replace stdout based TestEventProcessor by IPC implementation
* GD-124: Use LaunchProcessWithDebuggerAttached instead of AttachDebuggerIfNeed for Rider 2024.2



Bug Fixes:
* GD-110: Allow a Node to be passed in to SceneRunner.Load as the root of the scene.
* GD-121: Improve AssertSignal by adding a StartMonitoring method



* GD-89: Add input action support to the `SceneRunner` by @MikeSchulze in
   - Added input action handling to the SceneRunner
   - `SimulateActionPressed(string action)`
   - `SimulateActionPress(string action)`
   - `SimulateActionRelease(string action)`
* GD-94: Improve assertions error message when comparing objects by @MikeSchulze in
* GD-99: Add support to load a scene by `uid://` path to the Scene Runner by @MikeSchulze in

Bug Fixes:
* GD-90: Cleanup old runner configuration before run new tests by @MikeSchulze in
* GD-96: Fix methods with a single parameterized test case are not executed by @MikeSchulze in
* GD-101: Respect the GdUnit4 settings to notify about orphan nodes by @MikeSchulze in
* GD-103: Trim MSTest assert stack trace by @MikeSchulze in
* GD-104: Fix exception failure message propagation by @MikeSchulze in



Bug Fixes:
- Fix `AssertThat` for dynamic assert type resolving



What's Changed:

- Rename repository from `gdUnit4Mono` to `gdUnit4Net`
- Update project to GodotSharp v4.1.0
- Format and fix warnings according to C# standards
- Format the tests according to the C# Formatting rules
- Format the code to C# standard
- Support both net7 and net8 at once
- Add full .NET8 support
- Provide generic vector assert to support all Godot vector types
- Revision of the stack trace collection for failed tests
- Complete missing features for `IDictionaryAssert`
- Complete missing features for `IEnumerableAssert`
- Complete missing features for `INumberAssert`
- Add missing `SimulateMouseMoveRelative` and `SimulateMouseMoveAbsolute` to `ISceneRunner`

Bug Fixes:
- SceneRunner: Fix InputEvent handling
- Calling Invoke on `SceneRunner` must propagate exceptions
- Fix GdUnit4MonoAPI `IsTestSuite` cannot run TestSuite
- Fix test run stops at some point
- Parameterized test cases are not run from Godot Editor GdUnit4 inspector



- gdUnit4 API initial version.