Pular para o conteúdo principal

Shell · tests/lib

Fonte: tests/lib.

FunçãoLinhasResumoReferências diretas
t_ok9–14Conta uma verificação aprovada no runner principal e opcionalmente a imprime.25
t_falhou16–24Registra falha do runner com contexto e acumula a lista de falhas.39
t_titulo26–28Imprime o título de uma seção da suíte.3
compila_m035–330compila_m0 dir bin Compila todos os .c do diretório como um programa C11 (a fonte BG é .c mesmo). stderr vai para $T_TMP/err.log; devolve 0/1.2
compila_objetos57–72compila_objetos dir bin Compila cada fonte separadamente (-c) e liga no fim — exercita EXTERNO/ESTATICO e o cenário multi-arquivo real.1
transpila77–90transpila dir outdir - gera o C de cada fonte1
compila_m194–112compila_m1 dir bin Transpila cada .c do caso e compila o C gerado (a fonte BG já é .c).1
roda117–127Executa um binário de teste com entrada opcional e captura stdout/stderr/status.11
difere134–144Compara dois arquivos normalizando CR e distinguindo igualdade, diferença e erro de diff.6
resultado_confere148–170Compara o resultado de um caso com o contrato principal ou alternativo.2
mostra_diff172–177Mostra um diff curto e normalizado quando dois resultados diferem.3
caso_execucao191–243Executa um caso dourado nos caminhos M0 e M1 e compara stdout, stderr e status.0
normaliza_aspas249–251normaliza_aspas arquivo arquivo GCC e Clang usam aspas tipográficas (‘x’, “x”) quando o locale é UTF-8 e aspas retas quando é "C". O diagnóstico é do compilador1
confere_diagnostico260–278confere_diagnostico saida-do-compilador esperado_erro.txt esperado_erro.txt lista, uma por linha, as mensagens ACEITAS para o caso; linha vazia é ignorada e lin2
caso_erro_compilacao282–295caso_erro_compilacao caminho-do-caso programa.c + esperado_erro.txt (mensagens aceitas do erro de compilação M0)0
caso_aviso299–312caso_aviso caminho-do-caso codigo caso cujo basicgolc deve emitir um aviso W-xx0
caso_erro_transpilacao316–329caso_erro_transpilacao caminho-do-caso programa.c + esperado_erro.txt (mensagens aceitas do basicgolc)0

Perguntas frequentes​

Perguntas frequentes sobre tests/lib e as 17 função(ões) indexada(s) nele.

Que funções este arquivo expõe?​

As funções abaixo foram extraídas do próprio arquivo. Elas são internas ao projeto: não fazem parte da API pública de basicgol.h.

t_ok()
t_falhou()
t_titulo()
compila_m0()
compila_objetos()
transpila()

Como executar este arquivo?​

Depende do tipo de arquivo. A receita abaixo é a do projeto; flags e argumentos específicos estão na assinatura de cada função.

bash tests/lib

As funções internas têm teste próprio?​

13 das 17 funções possuem referência direta nos testes. As demais podem ser alcançadas apenas por chamadores; o JSON de cobertura registra a lacuna.

Qual é o contrato de t_ok?​

Conta uma verificação aprovada no runner principal e opcionalmente a imprime.

t_ok() {
T_OK=$((T_OK + 1))
if [ "${T_VERBOSO:-0}" = "1" ]; then
printf ' ok %s\n' "$1"
fi
}