Pular para o conteúdo principal

muta

Página gerada do fonte

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)

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.

  • Script Python: usa a biblioteca padrão e pathlib/subprocess quando aplicável; caminhos não devem depender do separador de um único OS.
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 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.