roda
Gerada por tools/gerar_documentacao.py. Definição: tests/run_checkout_limpo.sh:69.
Executa um binário de teste com entrada opcional e captura stdout/stderr/status.
Tipo: função Shell · Visibilidade: pública · Arquivo: tests/run_checkout_limpo.sh.
Assinatura e expansão
roda()
Como funciona
Redireciona stdin de arquivo ou /dev/null, grava saídas em arquivos temporários e ecoa o código de saída para o chamador.
Implementação
roda() {
local rotulo="$1"; shift
if "$@" > "$TMP/saida.log" 2>&1; then
ok "$rotulo"
else
falhou "$rotulo" "$(tail -5 "$TMP/saida.log" | tr '\n' ' ')"
fi
}
Como este símbolo aparece nos testes
11 ocorrência(s) em 3 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/fuzz_basicgolc.py
Contexto: main. Linhas: 163. Tipo de evidência: código; via roda.
Linhas 161–165 · abrir contexto
dados, nome = muta(rng, base)
por_mutacao[nome] = por_mutacao.get(nome, 0) + 1
rc, detalhe = roda(basicgolc, dados, tmp)
if rc not in (0, 1):
falhas += 1
tests/lib.sh
Contexto: caso_execucao. Linhas: 207, 229. Tipo de evidência: código; via roda.
Linhas 205–209 · abrir contexto
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)"
Linhas 227–231 · abrir contexto
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)"
tests/run_checkout_limpo.sh
Contexto: run_checkout_limpo.sh. Linhas: 80, 81, 82, 83, 84, 86, 117, 121. Tipo de evidência: código; via roda.
Linhas 78–88 · abrir contexto
# ------------------------------------------------- 2. comandos do README
printf '\n== comandos documentados no README\n'
roda "make (transpilador + biblioteca)" make -C "$DEST" --no-print-directory
roda "make biblioteca" make -C "$DEST" --no-print-directory biblioteca
roda "make test" make -C "$DEST" --no-print-directory test
roda "make test-biblioteca" make -C "$DEST" --no-print-directory test-biblioteca
roda "make exemplos" make -C "$DEST" --no-print-directory exemplos
cp "$DEST/tests/COBERTURA.md" "$TMP/COBERTURA.antes.md"
roda "make cobertura" make -C "$DEST" --no-print-directory cobertura
# Equivalente à checagem do CI (`git diff --exit-code`), sem depender de .git:
Linhas 115–123 · abrir contexto
# make test-portabilidade também precisa funcionar do zero
roda "make test-portabilidade" make -C "$DEST" --no-print-directory test-portabilidade
# e o fuzz, que depende de python3
if command -v python3 > /dev/null 2>&1; then
roda "make fuzz (100 mutações)" make -C "$DEST" --no-print-directory fuzz
else
printf ' -- python3 ausente: make fuzz ignorado\n'
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 roda. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que roda faz?
Executa um binário de teste com entrada opcional e captura stdout/stderr/status.
Qual é a assinatura e o tipo de retorno de roda?
Assinatura extraída de tests/run_checkout_limpo.sh; visibilidade pública.
roda()
Como roda aparece em código real deste repositório?
Uso extraído de tests/fuzz_basicgolc.py:161, com as linhas vizinhas preservadas:
dados, nome = muta(rng, base)
por_mutacao[nome] = por_mutacao.get(nome, 0) + 1
rc, detalhe = roda(basicgolc, dados, tmp)
if rc not in (0, 1):
falhas += 1
Onde roda é exercitado nos testes?
Há 11 ocorrência(s) em 3 arquivo(s): tests/fuzz_basicgolc.py, tests/lib.sh, tests/run_checkout_limpo.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.
roda depende de compilador, padrão C ou sistema operacional?
roda é 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.