Pular para o conteúdo principal

caso_execucao

Página gerada do fonte

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

Executa um caso dourado nos caminhos M0 e M1 e compara stdout, stderr e status.

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

Assinatura e expansão​

caso_execucao()

Como funciona​

Resolve arquivos opcionais, compila/linka conforme marcadores, roda com entrada ou /dev/null e usa resultado_confere para aceitar o resultado principal ou alternativo.

Comentário do fonte​

caso_execucao <caminho-do-caso> Convenção de arquivos do caso: .c, *.h fontes (a fonte BG é um .c com #include <basicgol.h>) entrada.txt stdin (opcional) esperado.txt stdout esperado (obrigatório neste tipo) esperado_rc.txt código de saída esperado (padrão 0) esperado_stderr.txt trecho que DEVE aparecer em stderr alternativo.txt + arquivos rc/stderr opcionais: alternativa; sem stderr declarado, exige stderr vazio sem_m0 / sem_m1 marcadores para pular um caminho objetos marcador: compilar em etapas separadas (-c + link)

Implementação completa · 53 linhas
caso_execucao() {
local dir="$1" nome entrada="" esperado_rc="0" bin rc

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

# ---- caminho M0
if [ ! -e "$dir/sem_m0" ]; then
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")
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)"
if [ "$rc" != "$esperado_rc" ]; then
:
elif difere "$dir/esperado.txt" "$T_TMP/out0"; then
mostra_diff "$dir/esperado.txt" "$T_TMP/out0"
elif [ -f "$dir/esperado_stderr.txt" ]; then
printf ' stderr esperado: %s\n' "$(cat "$dir/esperado_stderr.txt")"
fi
fi
fi

# ---- caminho M1 (equivalência com o esperado, não com o M0)
if [ ! -e "$dir/sem_m1" ]; then
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
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)"
if [ "$rc" != "$esperado_rc" ]; then
:
elif difere "$dir/esperado.txt" "$T_TMP/out1"; then
mostra_diff "$dir/esperado.txt" "$T_TMP/out1"
elif [ -f "$dir/esperado_stderr.txt" ]; then
printf ' stderr esperado: %s\n' "$(cat "$dir/esperado_stderr.txt")"
fi
fi
fi
}

Nomes internos referenciados: compila_m0, compila_m1, compila_objetos, difere, mostra_diff, resultado_confere, t_falhou, t_ok.

Como este símbolo aparece nos testes​

Sem uso direto localizado

Nenhuma referência direta a este nome foi encontrada nos arquivos de teste. Isso pode ser esperado para guardas de inclusão, configuração ou código exercitado indiretamente; não é uma afirmação de cobertura zero.

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.

  • Comparações removem CR para tolerar o modo texto do CRT Windows sem ignorar o conteúdo.
  • 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 caso_execucao. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que caso_execucao faz?​

Executa um caso dourado nos caminhos M0 e M1 e compara stdout, stderr e status.

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

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

caso_execucao()

Como chamar caso_execucao corretamente?​

Nenhum exemplo editorial nem chamada direta em teste foi localizada. A forma de uso é a assinatura acima; os chamadores aparecem na seção de evidência indireta quando existem.

caso_execucao()

Por que não há teste direto para caso_execucao?​

A busca estática não encontrou o identificador nos arquivos de teste. Isso é esperado para guardas de inclusão, configuração de build e nomes alcançados apenas por chamadores internos. O JSON de cobertura registra a lacuna em vez de convertê-la em aprovação.

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

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

Ressalvas registradas: Comparações removem CR para tolerar o modo texto do CRT Windows sem ignorar o conteúdo.

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.