t_ok
Gerada por tools/gerar_documentacao.py. Definição: tests/lib.sh:9.
Conta uma verificação aprovada no runner principal e opcionalmente a imprime.
Tipo: função Shell · Visibilidade: pública · Arquivo: tests/lib.sh.
Assinatura e expansão
t_ok()
Como funciona
Incrementa T_OK e imprime ok apenas quando T_VERBOSO está ativo.
Implementação
t_ok() {
T_OK=$((T_OK + 1))
if [ "${T_VERBOSO:-0}" = "1" ]; then
printf ' ok %s\n' "$1"
fi
}
Como este símbolo aparece nos testes
25 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: 209, 231, 291, 308, 325. Tipo de evidência: código; via t_ok.
Linhas 207–211 · abrir contexto
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out0" "$T_TMP/err0")
if resultado_confere "$dir" "$rc" "$T_TMP/out0" "$T_TMP/err0"; then
t_ok "$nome (M0)"
else
t_falhou "$nome (M0)" "resultado diferente (codigo $rc)"
Linhas 229–233 · abrir contexto
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out1" "$T_TMP/err1")
if resultado_confere "$dir" "$rc" "$T_TMP/out1" "$T_TMP/err1"; then
t_ok "$nome (M1)"
else
t_falhou "$nome (M1)" "resultado diferente (codigo $rc)"
Linhas 289–293 · abrir contexto
fi
if confere_diagnostico "$T_TMP/err.log" "$dir/esperado_erro.txt"; then
t_ok "$nome"
else
t_falhou "$nome" "$DIAG_DETALHE: $(head -2 "$T_TMP/err.log" | tr '\n' ' ')"
Linhas 306–310 · abrir contexto
fi
if grep -q "\[$codigo\]" "$T_TMP/err.aviso"; then
t_ok "$nome"
else
t_falhou "$nome" "aviso nao emitido"
Linhas 323–327 · abrir contexto
fi
if confere_diagnostico "$T_TMP/err.m1" "$dir/esperado_erro.txt"; then
t_ok "$nome"
else
t_falhou "$nome" "$DIAG_DETALHE: $(head -2 "$T_TMP/err.m1" | tr '\n' ' ')"
tests/run.sh
Contexto: run.sh. Linhas: 64, 72, 81, 91, 110, 123, 131, 136, 146, 168, 194, 210, 225, 233, 238, 308, 345, 365, 392, 411. Tipo de evidência: código; via t_ok.
Linhas 62–66 · abrir contexto
printf '#include <basicgol.h>\nint main(void) { return 0; }\n' > "$T_TMP/h1.c"
if $T_CC $T_CFLAGS -I "$T_INCLUDE" -o "$T_TMP/h1" "$T_TMP/h1.c" 2> "$T_TMP/e"; then
t_ok "cabecalho compila sozinho"
else
t_falhou "cabecalho compila sozinho" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
Linhas 70–74 · abrir contexto
printf '#include <basicgol.h>\n#include <basicgol.h>\nint main(void){return 0;}\n' > "$T_TMP/h2.c"
if $T_CC $T_CFLAGS -I "$T_INCLUDE" -o "$T_TMP/h2" "$T_TMP/h2.c" 2> "$T_TMP/e"; then
t_ok "cabecalho e idempotente"
else
t_falhou "cabecalho e idempotente" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
Linhas 79–83 · abrir contexto
if $T_CC -std=c11 -Wall -Wextra -Wpedantic -Werror -I "$T_INCLUDE" \
-o "$T_TMP/h3" "$T_TMP/h3.c" -lm 2> "$T_TMP/e"; then
t_ok "compila limpo com -Wpedantic"
else
t_falhou "compila limpo com -Wpedantic" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
Linhas 89–93 · abrir contexto
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' ' ')"
Linhas 108–112 · abrir contexto
done < "$RAIZ/tests/expansoes.txt"
if [ -z "$divergentes" ]; then
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)" \
Linhas 121–125 · abrir contexto
if $T_CC -std=c17 $T_CFLAGS -I "$T_INCLUDE" -o "$T_TMP/h9" "$T_TMP/h3.c" -lm \
2> "$T_TMP/e"; then
t_ok "compila limpo em -std=c17"
else
t_falhou "compila limpo em -std=c17" "$(head -2 "$T_TMP/e" | tr '\n' ' ')"
12 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.
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_ok. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que t_ok faz?
Conta uma verificação aprovada no runner principal e opcionalmente a imprime.
Qual é a assinatura e o tipo de retorno de t_ok?
Assinatura extraída de tests/lib.sh; visibilidade pública.
t_ok()
Como t_ok aparece em código real deste repositório?
Uso extraído de tests/lib.sh:207, com as linhas vizinhas preservadas:
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out0" "$T_TMP/err0")
if resultado_confere "$dir" "$rc" "$T_TMP/out0" "$T_TMP/err0"; then
t_ok "$nome (M0)"
else
t_falhou "$nome (M0)" "resultado diferente (codigo $rc)"
Onde t_ok é exercitado nos testes?
Há 25 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_ok depende de compilador, padrão C ou sistema operacional?
t_ok é 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.