Testes e rastreabilidade
135 casos em disco, 10 suítes e 29 modos unitários/integração extraídos do harness. Contagens são estáticas: não são o total impresso por uma execução.
make test
make test-biblioteca
make test-portabilidade
make fuzz
Caminhos de execução
- M0: o compilador C processa diretamente as macros de
basicgol.h. - M1:
basicgolctraduz blocos/açúcar para C; o compilador C ainda verifica tipos e liga a biblioteca. - Casos de execução comparam stdout, stderr declarado e status com o resultado dourado principal ou alternativo.
- Negativos exigem falha e diagnóstico; avisos exigem W-xx sem necessariamente falhar a tradução.
- CR é normalizado nas comparações para acomodar o modo texto do CRT Windows.
| Suíte | Casos | Caminhos | Registro no runner |
|---|---|---|---|
| 02_basico | 7 | M0+M1 | sim |
| 03_controle | 40 | +M1, M0+M1 | sim |
| 04_estruturas | 11 | M0+M1 | sim |
| 05_entrada_saida | 15 | M0+M1 | sim |
| 06_negativos | 23 | sim | |
| 07_multiarquivo | 2 | M0+M1 | sim |
| 08_aplicacao | 1 | M0+M1 | sim |
| 09_tipos_expr | 15 | M0+M1 | sim |
| 12_negativos_m1 | 14 | +M1 | sim |
| 13_avisos | 7 | +M1 | sim |
Um diretório novo aparece aqui automaticamente. Para ser executado por make test, ele também precisa seguir a seleção de suítes de tests/run.sh; a coluna acima mostra se o nome da suíte aparece nesse runner.
Harness, runners e modos
Perguntas frequentes
Perguntas frequentes sobre a suíte de testes, os caminhos M0/M1 e a leitura dos resultados.
Quais comandos cobrem a suíte inteira?
Cada alvo do Makefile executa uma camada diferente; make test não substitui a suíte da biblioteca nem a matriz de portabilidade.
make test
make test-biblioteca
make test-portabilidade
make test-sanitize
make fuzz
O que significa um caso ser M0, M1 ou ambos?
M0 compila o fonte diretamente com as macros de basicgol.h. M1 passa antes por basicgolc, que traduz blocos e o açúcar PARA i DE …. Um caso só em M1 usa sintaxe que o pré-processador não reduz sozinho.
Como sei o que um caso compara?
Abra a página do caso: ela lista todos os arquivos versionados, inclusive o esperado, entradas de stdin e alternativas aceitas, além do tipo (execução, negativo ou aviso).
As contagens desta página são o total de verificações?
Não. Aqui há 135 casos em disco e 29 modos. O total impresso por make test é dinâmico e inclui verificações repetidas, sanitizers e ferramentas disponíveis.
Como adicionar um caso novo?
Crie tests/casos/<suite>/<caso>/ com o programa e os arquivos esperados. O gerador descobre o diretório automaticamente; para ser executado, o nome da suíte também precisa constar em tests/run.sh.
mkdir -p tests/casos/20_minha_suite/n01_ola
printf '#include <basicgol.h>
INICIO
ESCREVAL("ola");
FIM
' > tests/casos/20_minha_suite/n01_ola/programa.c
printf 'ola
' > tests/casos/20_minha_suite/n01_ola/esperado.txt