Pular para o conteúdo principal

t_falhou

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tests/lib.sh:16.

Registra falha do runner com contexto e acumula a lista de falhas.

Tipo: função Shell · Visibilidade: pública · Arquivo: tests/lib.sh.

Assinatura e expansão​

t_falhou()

Como funciona​

Incrementa T_FALHOU, imprime FALHA e o detalhe opcional, e acrescenta o nome a T_LISTA_FALHAS.

Implementação​

t_falhou() {
T_FALHOU=$((T_FALHOU + 1))
printf ' FALHA %s\n' "$1"
if [ -n "${2:-}" ]; then
printf ' %s\n' "$2"
fi
T_LISTA_FALHAS="${T_LISTA_FALHAS}
- $1"
}

Como este símbolo aparece nos testes​

39 ocorrência(s) em 2 arquivo(s) de teste. Os links apontam para linhas exatas; os trechos mostram o contexto local. Uma menção não prova que todos os ramos foi executado.

tests/lib.sh​

Contexto: caso_aviso, caso_erro_compilacao, caso_erro_transpilacao, caso_execucao. Linhas: 195, 203, 205, 211, 226, 233, 287, 293, 304, 310, 321, 327. Tipo de evidência: código; via t_falhou.

Linhas 193–197 · abrir contexto

nome="$(echo "$dir" | sed "s|^$T_CASOS/||")"
[ -f "$dir/esperado.txt" ] || { t_falhou "$nome" "caso sem esperado.txt"; return; }
[ -f "$dir/entrada.txt" ] && entrada="$dir/entrada.txt"
[ -f "$dir/esperado_rc.txt" ] && esperado_rc="$(cat "$dir/esperado_rc.txt")"

Ver no GitHub

Linhas 201–207 · abrir contexto
bin="$T_TMP/bin_m0_$(echo "$nome" | tr '/' '_')"
if [ -e "$dir/objetos" ]; then
compila_objetos "$dir" "$bin" || { t_falhou "$nome (M0)" "compilacao falhou: $(head -3 "$T_TMP/err.log" | tr '\n' ' ')"; return; }
else
compila_m0 "$dir" "$bin" || { t_falhou "$nome (M0)" "compilacao falhou: $(head -3 "$T_TMP/err.log" | tr '\n' ' ')"; return; }
fi
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out0" "$T_TMP/err0")

Ver no GitHub

Linhas 209–213 · abrir contexto
t_ok "$nome (M0)"
else
t_falhou "$nome (M0)" "resultado diferente (codigo $rc)"
if [ "$rc" != "$esperado_rc" ]; then
:

Ver no GitHub

Linhas 224–228 · abrir contexto
bin="$T_TMP/bin_m1_$(echo "$nome" | tr '/' '_')"
if ! compila_m1 "$dir" "$bin"; then
t_falhou "$nome (M1)" "transpilacao/compilacao falhou: $(head -3 "$T_TMP/err.m1" "$T_TMP/err.log" 2>/dev/null | tr '\n' ' ')"
return
fi

Ver no GitHub

Linhas 231–235 · abrir contexto
t_ok "$nome (M1)"
else
t_falhou "$nome (M1)" "resultado diferente (codigo $rc)"
if [ "$rc" != "$esperado_rc" ]; then
:

Ver no GitHub

Linhas 285–289 · abrir contexto
nome="$(echo "$dir" | sed "s|^$T_CASOS/||")"
if compila_m0 "$dir" "$T_TMP/bin_neg"; then
t_falhou "$nome" "compilou, mas deveria falhar"
return
fi

Ver no GitHub

5 outros blocos de contexto: use os links de linha e o JSON de inventário.

tests/run.sh​

Contexto: run.sh. Linhas: 66, 74, 83, 89, 93, 112, 116, 125, 133, 148, 151, 170, 196, 212, 226, 231, 239, 263, 272, 284, 288, 296, 303, 347, 367, 394, 413. Tipo de evidência: código; via t_falhou.

Linhas 64–68 · abrir contexto
t_ok "cabecalho compila sozinho"
else
t_falhou "cabecalho compila sozinho" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 72–76 · abrir contexto
t_ok "cabecalho e idempotente"
else
t_falhou "cabecalho e idempotente" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 81–85 · abrir contexto
t_ok "compila limpo com -Wpedantic"
else
t_falhou "compila limpo com -Wpedantic" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 87–95 · abrir contexto
printf '#include <basicgol.h>\nint main(void){return 0;}\n' > "$T_TMP/h4.c"
if $T_CC -std=c99 -I "$T_INCLUDE" -o "$T_TMP/h4" "$T_TMP/h4.c" 2> "$T_TMP/e"; then
t_falhou "C99 e rejeitado" "compilou em C99"
elif grep -q "exige C11" "$T_TMP/e"; then
t_ok "C99 e rejeitado com mensagem"
else
t_falhou "C99 e rejeitado com mensagem" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 110–118 · abrir contexto
t_ok "expansoes do cabecalho batem com a tabela documentada (AC-22)"
else
t_falhou "expansoes do cabecalho batem com a tabela documentada (AC-22)" \
"divergentes:$divergentes"
fi
else
t_falhou "expansoes do cabecalho batem com a tabela documentada (AC-22)" \
"$(head -2 "$T_TMP/e" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 123–127 · abrir contexto
t_ok "compila limpo em -std=c17"
else
t_falhou "compila limpo em -std=c17" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
fi

Ver no GitHub

16 outros blocos de contexto: use os links de linha e o JSON de inventário.

Compiladores, padrão C e sistema operacional​

Nenhum ramo condicional externo foi detectado para este símbolo. A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.

  • Runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2. Não é um script CMD/PowerShell.
Não confunda implementação com certificação

A matriz histórica distingue executado, compilado, avaliado e não testado. Consulte a matriz, os compiladores e os logs atuais dos workflows antes de chamar um alvo de suportado.

Perguntas frequentes​

Perguntas reunidas a partir da definição, do contrato editorial e dos testes de t_falhou. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que t_falhou faz?​

Registra falha do runner com contexto e acumula a lista de falhas.

Qual é a assinatura e o tipo de retorno de t_falhou?​

Assinatura extraída de tests/lib.sh; visibilidade pública.

t_falhou()

Como t_falhou aparece em código real deste repositório?​

Uso extraído de tests/lib.sh:193, com as linhas vizinhas preservadas:


nome="$(echo "$dir" | sed "s|^$T_CASOS/||")"
[ -f "$dir/esperado.txt" ] || { t_falhou "$nome" "caso sem esperado.txt"; return; }
[ -f "$dir/entrada.txt" ] && entrada="$dir/entrada.txt"
[ -f "$dir/esperado_rc.txt" ] && esperado_rc="$(cat "$dir/esperado_rc.txt")"

Onde t_falhou é exercitado nos testes?​

Há 39 ocorrência(s) em 2 arquivo(s): tests/lib.sh, tests/run.sh. Os links da seção de evidência apontam para a linha exata; uma menção não prova que todos os ramos foram executados.

t_falhou depende de compilador, padrão C ou sistema operacional?​

t_falhou é uma função de runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2, não CMD/PowerShell.

O que acontece em caso de falha ou uso inválido?​

Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.