roda
Gerada por tools/gerar_documentacao.py. Definição: tests/fuzz_basicgolc.py:108.
Executa um binário de teste com entrada opcional e captura stdout/stderr/status.
Tipo: função Python · Visibilidade: pública · Arquivo: tests/fuzz_basicgolc.py.
Assinatura e expansão
def roda(basicgolc: Path, dados: bytes, tmp: Path, limite: float = 10.0) -> tuple[int, str]:
Parâmetros formais: basicgolc: Path, dados: bytes, tmp: Path, limite: float.
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.
Comentário do fonte
Executa uma mutação sob timeout e classifica crash, sinal ou sanitizer.
Implementação
def roda(basicgolc: Path, dados: bytes, tmp: Path, limite: float = 10.0) -> tuple[int, str]:
"""Executa uma mutação sob timeout e classifica crash, sinal ou sanitizer."""
alvo = tmp / "mutado.c"
alvo.write_bytes(dados)
try:
proc = subprocess.run(
[str(basicgolc), "--checar", str(alvo)],
stdout=subprocess.DEVNULL,
stderr=subprocess.PIPE,
timeout=limite,
env={"ASAN_OPTIONS": "detect_leaks=0", "LC_ALL": "C",
"PATH": "/usr/bin:/bin"},
)
except subprocess.TimeoutExpired:
return 124, "tempo limite"
err = proc.stderr.decode("utf-8", "replace")
if proc.returncode < 0:
return proc.returncode, f"sinal {-proc.returncode}"
if "Sanitizer" in err or "runtime error" in err:
return 99, err.strip().splitlines()[0][:200] if err.strip() else "sanitizer"
return proc.returncode, err[:300]
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.
- Script Python: usa a biblioteca padrão e pathlib/subprocess quando aplicável; caminhos não devem depender do separador de um único OS.
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/fuzz_basicgolc.py; visibilidade pública.
def roda(basicgolc: Path, dados: bytes, tmp: Path, limite: float = 10.0) -> tuple[int, str]:
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 Python: requer Python 3.10+ e biblioteca padrão, sem compilador C.
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.