Pular para o conteúdo principal

roda

Página gerada do fonte

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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:

Ver no GitHub

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'

Ver no GitHub

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