gdtest 0.2.5

Fast external test runner for Godot 4 - Rust orchestrator + GDScript harness
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# gdtest crate

`gdtest` is the CLI crate for the gdtest workspace.

It provides:

- Rust-side test discovery and scheduling
- Parallel Godot worker management
- Reporters: `pretty`, `tap`, `json`, `junit`
- Watch mode, retries, sharding, coverage, HTML reports
- Migration commands for GUT and gdUnit4
- Mutation testing and changed-test selection

Install from crates.io:

```sh
cargo install gdtest
```

Minimal project setup:

1. Copy `addons/gdtest/` into your Godot project.
2. Put tests under `test/`.
3. Run `gdtest test/`.

Example:

```sh
gdtest test/ -j 4
gdtest test/ --reporter junit
gdtest test/ --coverage --html-report
gdtest migrate gut test/
```

The full project documentation lives in the workspace [README](../../README.md).