Skip to content

Testes e Qualidade

PedroVMota edited this page Nov 13, 2026 · 2 revisions

Testes e qualidade

Verificações

Comando O que faz
make test cargo test --workspace
make lint cargo clippy --workspace --all-targets -- -D warnings (Clippy pedantic, unwrap_used/expect_used a avisar fora dos testes)
make fmt-check cargo fmt --all -- --check (max_width = 120, use_small_heuristics = "Max")
make fuzz-check Compila o crate de fuzzing em stable
make audit cargo deny check (ainda não corrido; ver Segurança)
make check-all fmt-check + lint + test + audit

Testes por crate

O workspace tem 215 testes (#[test]), dos quais 5 são #[ignore] (medições). Com cargo test --workspace correm 210 (210 passam, 5 ignorados).

Crate Testes Ignorados Principais ficheiros
bw-core 21 0 tests/wiring.rs (junções, limpeza, validação ao juntar redes, rubber-banding, determinismo do replay); testes unitários de circuit, component, memenc, note, wiring
bw-sim 91 1 tests/sim.rs (motor, thread do simulador, flip-flops, memória, barramentos, step), components.rs (componentes do formato 5, modos de avaliação), macros.rs (achatamento, aninhamento, limites, edições de definições, erros com caminho, vista interior), library.rs (gerador e comportamento de todas as peças incluídas), dwm.rs (circuitos importados do Digital Works, também depois de exportados e reimportados), dwm_export.rs (comportamento igual depois da exportação: fixtures, exemplos, cada tipo em cada rotação, circuitos e macros aleatórios)
bw-io 56 0 Testes unitários do formato e migrações (fixtures v1–v4), .map, biblioteca, datasheets, mutações; tests/dwm.rs (importação, deduplicação, templates, mapas, fluxos hostis, mutações); tests/dwm_export.rs (ida e volta estrutural, parser Python, circuitos aleatórios, carga, estabilidade da reexportação); tests/dwm_corpus.rs; testes unitários do writer e do .map binário
bw-render 38 2 tests/shaders.rs (valida o WGSL offline com naga, sem GPU), scene_incremental.rs (cena incremental = reconstrução completa), gpu_smoke.rs (renderização real, incluindo a medição de make bench); testes de símbolos, atlas, tesselação, fonte, rasterização e câmara
bw-app 9 2 Propriedades, janela de memória (também o .map binário), importação, exportação (--export-dwm, caminhos .dwm); stress.rs (medições stress_sim_cost e stress_macros_cost)

Testes ignorados (medições)

Teste Como correr
bw-render gpu_smoke::stress_frame_cost make bench
bw-render symbols::raster::gallery cargo test -p bw-render -- --ignored gallery
bw-app stress_sim_cost, stress_macros_cost cargo test --release -p bw-app -- --ignored --nocapture <nome>
bw-sim sim_bench_flip_flops_and_memory cargo test --release -p bw-sim --test sim -- --ignored --nocapture sim_bench_flip_flops_and_memory

Os testes de GPU precisam de um adaptador Metal (correm num Mac).

Testes com dados externos ou regeneração

Variável Uso
BITWERK_DWM_CORPUS=<pasta> cargo test --release -p bw-io --test dwm_corpus -- --nocapture importa todos os .dwm da pasta, grava e reabre cada um, e (whole_corpus_round_trips_through_export) exporta, reimporta e volta a exportar cada um. Sem a variável, os testes passam sem fazer nada. Resultados com o pacote oficial: 495/495 importam; 495/495 fazem a ida e volta pela exportação com a mesma estrutura e reexportam byte a byte iguais; 437/437 macros exportam como macros.
BITWERK_REGEN_LIBRARY=1 cargo test -p bw-sim --test library regenera crates/bw-io/library/*.bwmacro e examples/macros-demo.bitwerk. Sem a variável, o teste falha se os ficheiros incluídos divergirem do gerador.

O que os testes garantem (exemplos)

  • Compatibilidade de formato: fixtures de cada versão antiga (crates/bw-io/tests/fixtures/v1-* … v4-*) abrem com os mesmos componentes, redes e hashes de macros, gravam na versão atual e reabrem iguais.
  • Pinos = símbolos: os pontos de ligação de cada símbolo coincidem com a geometria de pinos do bw-core, para todos os tipos, variantes de flip-flop, tamanhos de memória, números de entradas e estilos.
  • Edições geométricas não recompilam: verificado com a thread do simulador.
  • Step: um flip-flop por flanco ascendente muda num passo de meio ciclo sim e no seguinte não.
  • Exemplos: flipflops-memory conta 0, 1, …, 15, 0; Create Macro from Selection aplicado aos exemplos não muda o comportamento.
  • Biblioteca: tabelas de verdade completas e sequências de relógio para todas as peças.
  • Digital Works (importação): XOR com NAND, igualdade de 4 bits (256 combinações), JK master-slave com portas (só no modo sequencial), contador em 7 segmentos, bus contention, 74HC00/74/76/125 em DIL.
  • Digital Works (exportação): os mesmos circuitos, exportados e reimportados, comportam-se da mesma forma (simulação lado a lado); as 13 fixtures e os 5 exemplos mantêm componentes e redes; reexportar dá o mesmo ficheiro byte a byte; o parser Python tools/dwm_parse.py lê todas as exportações (se houver python3); o writer reescreve o mapa low1.map byte a byte. Ver Exportação para o Digital Works.
  • Robustez: mutações determinísticas e fluxos hostis nunca dão pânico (ver Segurança).

Fuzzing

cargo install --locked cargo-fuzz
make fuzz        # load_project, load_memory_map, load_macro, load_dwm, roundtrip_dwm — 5 min cada (nightly)

O alvo roundtrip_dwm (exportação) só foi compilado até agora (make fuzz-check). Os artefactos e o corpus gerados (fuzz/corpus, fuzz/artifacts) estão no .gitignore.

Clone this wiki locally