Testes
Três camadas de teste: Catch2 para o motor, testes Rust unitários e de integração para o Doppio, e flows de UI headless que conduzem a árvore de widgets real sem janela. O CI corre as três.
Camadas#
| Camada | Framework | Comando | Localização |
|---|---|---|---|
| Motor C++ | Catch2 v3 | ctest --output-on-failure | tests/, binário build/tests/CaffeineTest |
| Editor Rust | cargo test | cd doppio && cargo test | doppio/crates/ui/src/windows/main/tests.rs, testes da crate do motor |
| Flows de UI headless | doppio-headless | ./scripts/check-rust-ui.sh | doppio/tests/ui-flows/*.json |
Suite C++#
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
cd build && ctest --output-on-failure
Corra uma tag ou teste diretamente:
./build/tests/CaffeineTest "[ecs]"
./build/tests/CaffeineTest "World *" --success
Os testes têm tags; [stress] marca os casos longos que o CI só corre num
workflow_dispatch manual. A suite cobre tipos do core, allocators, containers,
matemática, ECS, jobs, assets, RHI, física, áudio, animação, scripting, terreno e a
C ABI.
Suite do editor Rust#
cd doppio
cargo test
cargo test -p doppio-ui --features headless
A feature headless corre os flows comprometidos através de
every_shipped_flow_passes. A suite do editor cobre mensagens de App, estado de
painéis/docking, edições no inspector, pesquisa na hierarchy, gestos do viewport,
filtros da console, asset wizard e os grafos dos geradores.
Flows de UI headless#
./scripts/doppio-headless.sh run doppio/tests/ui-flows --format text
Cada flow começa numa fixture determinística, age com targets id:/text: e verifica
com expect. Capturas, baselines e gravação GIF/MP4 estão disponíveis para trabalho
visual. Veja Headless testing
e Automação de testes.
CI#
.github/workflows/test.yml corre em pushes para main, develop e feature/**, e
em pull requests para main/develop:
- configurar e compilar com GCC 13;
./build/tests/CaffeineTest ~[stress] --success;./scripts/check-rust-ui.sh;- opcionalmente
./build/tests/CaffeineTest "[stress]" --successem dispatch manual.
Uma alteração está pronta quando a suite C++ e as verificações Rust/headless passam. Uma mudança visível no editor acrescenta um flow; uma mudança de comportamento do motor acrescenta um caso Catch2.
Escrever testes#
Convenções Catch2
- Um ficheiro por módulo:
tests/test_<module>.cpp. - Use
TEST_CASE("Behaviour", "[module]")eSECTIONpara variantes. - Prefira dados determinísticos; sem sleeps, janelas GPU reais ou rede.
- Marque casos lentos com
[stress]para o CI padrão os saltar.
Convenções dos flows headless
- Comece em
entities,emptyou numa fixture de gerador. - Use ids do catálogo, não pontos de ecrã, exceto quando o ponto é o comportamento.
- Faça asserções após cada ação relevante e rotule a asserção.
- Guarde capturas como artefactos; use baselines só para regressões visuais.