muta
Gerada por tools/gerar_documentacao.py. Definição: tests/fuzz_basicgolc.py:58.
Aplica uma mutação e devolve (bytes, nome da mutação).
Tipo: função Python · Visibilidade: pública · Arquivo: tests/fuzz_basicgolc.py.
Assinatura e expansão
def muta(rng: random.Random, base: bytes) -> tuple[bytes, str]:
Parâmetros formais: rng: random.Random, base: bytes.
Como funciona
Aplica uma mutação e devolve (bytes, nome da mutação).
Implementação completa · 48 linhas
def muta(rng: random.Random, base: bytes) -> tuple[bytes, str]:
"""Aplica uma mutação e devolve (bytes, nome da mutação)."""
escolha = rng.randrange(9)
if escolha == 0: # truncar
corte = rng.randrange(0, len(base) + 1)
return base[:corte], "truncar"
if escolha == 1: # apagar um intervalo
if not base:
return base, "apagar(no-op)"
ini = rng.randrange(0, len(base))
fim = min(len(base), ini + rng.randrange(2, 64))
return base[:ini] + base[fim:], "apagar"
if escolha == 2: # inserir fragmento
pos = rng.randrange(0, len(base) + 1)
frag = rng.choice(FRAGMENTOS)
return base[:pos] + frag + base[pos:], "inserir"
if escolha == 3: # trocar um byte
if not base:
return base, "trocar(no-op)"
pos = rng.randrange(0, len(base))
return base[:pos] + bytes([rng.randrange(0, 256)]) + base[pos + 1:], "trocar"
if escolha == 4: # duplicar uma linha (aninhamento/quebra de bloco)
linhas = base.split(b"\n")
if not linhas:
return base, "duplicar(no-op)"
i = rng.randrange(0, len(linhas))
linhas.insert(i, linhas[i])
return b"\n".join(linhas), "duplicar"
if escolha == 5: # CRLF
return base.replace(b"\n", b"\r\n"), "crlf"
if escolha == 6: # BOM + CRLF
return b"\xef\xbb\xbf" + base.replace(b"\n", b"\r\n"), "bom+crlf"
if escolha == 7: # remover o último fechamento de bloco
for fecha in (b"FIM\n", b"FIM_SE", b"FIM_PARA", b"FIM_ENQUANTO"):
if fecha in base:
return base.replace(fecha, b"", 1), "sem-fechamento"
return base, "sem-fechamento(no-op)"
# escolha == 8: muitas chaves de abertura (estouro de pilha)
return base + b"\n" + b"SE 1 ENTAO\n" * 300, "aninhamento-300"
Como este símbolo aparece nos testes
1 ocorrência(s) em 1 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: 161. Tipo de evidência: código; via muta.
Linhas 159–163 · abrir contexto
for n in range(args.iteracoes):
base = rng.choice(corpus).read_bytes()
dados, nome = muta(rng, base)
por_mutacao[nome] = por_mutacao.get(nome, 0) + 1
rc, detalhe = roda(basicgolc, dados, tmp)
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 muta. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que muta faz?
Aplica uma mutação e devolve (bytes, nome da mutação).
Qual é a assinatura e o tipo de retorno de muta?
Assinatura extraída de tests/fuzz_basicgolc.py; visibilidade pública.
def muta(rng: random.Random, base: bytes) -> tuple[bytes, str]:
Como muta aparece em código real deste repositório?
Uso extraído de tests/fuzz_basicgolc.py:159, com as linhas vizinhas preservadas:
for n in range(args.iteracoes):
base = rng.choice(corpus).read_bytes()
dados, nome = muta(rng, base)
por_mutacao[nome] = por_mutacao.get(nome, 0) + 1
rc, detalhe = roda(basicgolc, dados, tmp)
Onde muta é exercitado nos testes?
Há 1 ocorrência(s) em 1 arquivo(s): tests/fuzz_basicgolc.py. 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.
muta depende de compilador, padrão C ou sistema operacional?
muta é 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.