Pular para o conteúdo principal

t_ok

Página gerada do fonte

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)"

Ver no GitHub

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)"

Ver no GitHub

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' ' ')"

Ver no GitHub

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"

Ver no GitHub

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' ' ')"

Ver no GitHub

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' ' ')"

Ver no GitHub

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' ' ')"

Ver no GitHub

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' ' ')"

Ver no GitHub

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' ' ')"

Ver no GitHub

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)" \

Ver no GitHub

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' ' ')"

Ver no GitHub

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.
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_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.