mask_code
Gerada por tools/gerar_documentacao.py. Definição: tools/documentacao/analise.py:257.
Substitui comentários e literais por espaços, preservando linhas/colunas.
Tipo: função Python · Visibilidade: pública · Arquivo: tools/documentacao/analise.py.
Assinatura e expansão
def mask_code(text: str, language: str) -> str:
Parâmetros formais: text: str, language: str.
Como funciona
Substitui comentários e literais por espaços, preservando linhas/colunas.
Não interpreta o pré-processador. Strings não são tratadas como chamadas; nomes de modos de teste são extraídos separadamente pela AST C.
Implementação completa · 53 linhas
def mask_code(text: str, language: str) -> str:
"""Substitui comentários e literais por espaços, preservando linhas/colunas.
Não interpreta o pré-processador. Strings não são tratadas como chamadas;
nomes de modos de teste são extraídos separadamente pela AST C.
"""
out = list(text)
i = 0
n = len(text)
line_comment = "//" if language in {"c", "cpp"} else "#"
block = language in {"c", "cpp"}
while i < n:
if block and text.startswith("/*", i):
end = text.find("*/", i + 2)
end = n if end < 0 else end + 2
for j in range(i, end):
if out[j] != "\n":
out[j] = " "
i = end
continue
if text.startswith(line_comment, i):
end = text.find("\n", i)
end = n if end < 0 else end
out[i:end] = " " * (end - i)
i = end
continue
if language == "python" and text[i:i+3] in {"'''", '"""'}:
quote = text[i:i+3]
end = text.find(quote, i + 3)
end = n if end < 0 else end + 3
for j in range(i, end):
if out[j] != "\n":
out[j] = " "
i = end
continue
if text[i] in {"'", '"', "`"}:
quote = text[i]
j = i + 1
while j < n:
if text[j] == "\\":
j += 2
continue
if text[j] == quote or (language == "shell" and text[j] == "\n" and quote != "`"):
break
j += 1
end = min(n, j + 1)
for k in range(i, end):
if out[k] != "\n":
out[k] = " "
i = end
continue
i += 1
return "".join(out)
Como este símbolo aparece nos testes
Nenhuma referência direta a este nome foi encontrada nos arquivos de teste. Isso pode ser esperado para guardas de inclusão, configuração ou código exercitado indiretamente; não é uma afirmação de cobertura zero.
Evidência indireta
Estes símbolos chamam/encaminham para este nome. As referências deles ajudam a rastrear o caminho, mas não substituem um teste específico deste símbolo.
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 mask_code. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que mask_code faz?
Substitui comentários e literais por espaços, preservando linhas/colunas.
Qual é a assinatura e o tipo de retorno de mask_code?
Assinatura extraída de tools/documentacao/analise.py; visibilidade pública.
def mask_code(text: str, language: str) -> str:
Como chamar mask_code corretamente?
Nenhum exemplo editorial nem chamada direta em teste foi localizada. A forma de uso é a assinatura acima; os chamadores aparecem na seção de evidência indireta quando existem.
def mask_code(text: str, language: str) -> str:
Por que não há teste direto para mask_code?
A busca estática não encontrou o identificador nos arquivos de teste. Isso é esperado para guardas de inclusão, configuração de build e nomes alcançados apenas por chamadores internos. O JSON de cobertura registra a lacuna em vez de convertê-la em aprovação.
mask_code depende de compilador, padrão C ou sistema operacional?
mask_code é 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.