Pular para o conteúdo principal

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: basicgolc traduz 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íteCasosCaminhosRegistro no runner
02_basico7M0+M1sim
03_controle40+M1, M0+M1sim
04_estruturas11M0+M1sim
05_entrada_saida15M0+M1sim
06_negativos23sim
07_multiarquivo2M0+M1sim
08_aplicacao1M0+M1sim
09_tipos_expr15M0+M1sim
12_negativos_m114+M1sim
13_avisos7+M1sim
Descoberta não altera o runner

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