Harness unitário e runners
tests/test_biblioteca.c contém grupos de verificações e modos de subprocesso. VERIFICA conta condições; falhas fatais são isoladas em modos porque bg_erro encerra o processo.
Grupos e funções de teste
| Função | Localização | O que faz |
|---|---|---|
cria_arquivo_temporario | tests/test_biblioteca.c | Cria um FILE temporário contendo um cenário de entrada e o reposiciona no início. |
testa_console | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_entrada_numerica | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_texto | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_caracteres | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_matematica | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_utilidades | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_stdin_compativel | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_stdin_invalido | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
testa_stdin_texto_longo | tests/test_biblioteca.c | Grupo executável do harness da biblioteca padrão. |
executa_caso_fatal | tests/test_biblioteca.c | Despacha um modo de teste que deve terminar em erro fatal ou, em representação alternativa, código 3. |
Scripts de teste
- tests/auditar_exemplos.py — 151 linhas; funções indexadas em internos.
- tests/documentacao/check_llms_build.py — 35 linhas; funções indexadas em internos.
- tests/documentacao/test_gerador.py — 160 linhas; funções indexadas em internos.
- tests/fuzz_basicgolc.py — 184 linhas; funções indexadas em internos.
- tests/lib.sh — 329 linhas; funções indexadas em internos.
- tests/run.sh — 716 linhas; funções indexadas em internos.
- tests/run_biblioteca.sh — 126 linhas; funções indexadas em internos.
- tests/run_checkout_limpo.sh — 132 linhas; funções indexadas em internos.
- tests/run_matriz.sh — 83 linhas; funções indexadas em internos.
- tests/run_msvc.sh — 191 linhas; funções indexadas em internos.
- tests/run_portabilidade.sh — 562 linhas; funções indexadas em internos.
Cobertura e lacunas
O JSON de cobertura lista símbolos sem referência direta. Guardas/configuração e chamadas indiretas podem explicar uma lacuna; não a apague sem evidência.
Perguntas frequentes
Perguntas frequentes sobre o harness unitário em C e os runners em Bash.
Como uma verificação é contada?
VERIFICA recebe uma condição e é o ponto de contagem do harness. O resumo impresso ao final é dinâmico e depende dos grupos realmente executados.
Onde ficam as falhas fatais?
Em modos de subprocesso. O harness principal não pode chamar ERRO diretamente, porque o processo terminaria antes de imprimir o resumo.
Como rodar o harness sem o Makefile?
Compile o harness com o mesmo conjunto de avisos adotado pelo projeto e ligue a biblioteca; sanitizers são opcionais e habilitados por make test-sanitize.
cc -std=c11 -Wall -Wextra -Wformat=2 -I include tests/test_biblioteca.c \
build/libbasicgol.a -lm -o build/test_biblioteca
./build/test_biblioteca
Os runners funcionam no Windows?
Os runners são Bash com utilitários Unix; no Windows o projeto usa Git Bash/MSYS2 nos workflows. Eles não são scripts CMD/PowerShell e normalizam CR nas comparações.