Repository navigation
Testes e Qualidade
PedroVMota edited this page Nov 13, 2026
·
2 revisions
| 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
|
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) |
| 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).
| 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. |
-
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-memoryconta 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.pylê todas as exportações (se houverpython3); owriterreescreve o mapalow1.mapbyte 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).
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.
bitwerk — simulador de circuitos lógicos digitais para macOS · Licença MIT OR Apache-2.0 (LICENSE-MIT e LICENSE-APACHE no repositório) · A fonte de verdade é o código e o README.md do repositório; esta wiki descreve a versão 0.1.0.
Começar
Utilização
- Componentes
- Fios e junções
- Simulação
- Memória
- Macros e hierarquia
- Parts Centre
- Importação do Digital Works
- Exportação para o Digital Works
Referência técnica
Projeto