Pular para o conteúdo principal

Renderer.portability

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tools/documentacao/render.py:631.

Renderiza guards, diretivas, marcadores e ressalvas de compilador/OS.

Tipo: função Python · Visibilidade: pública · Arquivo: tools/documentacao/render.py.

Assinatura e expansão​

def portability(self, symbol: Symbol) -> str:

Parâmetros formais: self, symbol: Symbol.

Como funciona​

Renderiza guards, diretivas, marcadores e ressalvas de compilador/OS.

Implementação completa · 52 linhas
def portability(self, symbol: Symbol) -> str:
"""Renderiza guards, diretivas, marcadores e ressalvas de compilador/OS."""
contract = self.contract(symbol)
nearby = self.nearby_directives(symbol)
markers = sorted(set(PLATFORM.findall(symbol.body + " " + symbol.signature + " " + " ".join(c["condition"] for c in symbol.conditions) + " " + " ".join(nearby))))
directives = [line.strip() for line in symbol.body.splitlines() if re.match(r"\s*#\s*(if|ifdef|ifndef|elif|else)", line)]
out = ["## Compiladores, padrão C e sistema operacional\n\n"]
if symbol.conditions:
out.append("**Condições que envolvem a definição:**\n\n")
for cond in symbol.conditions:
out.append(f"- `{cond['condition']}` ({self.gh_link(symbol.path, cond['line'], label='fonte')})\n")
out.append("\n")
else:
out.append("Nenhum ramo condicional externo foi detectado para este símbolo. ")
if directives:
out.append("**Diretivas dentro do corpo:**\n\n")
for directive in directives:
out.append(f"- `{directive}`\n")
out.append("\n")
if nearby:
out.append("**Diretivas próximas no fonte** (podem afetar atributos/diagnósticos ao redor da definição):\n\n")
for directive in nearby:
out.append(f"- `{directive}`\n")
out.append("\n")
if markers:
out.append("Marcadores de plataforma/representação presentes: " + ", ".join(f"`{m}`" for m in markers) + ".\n\n")
if not symbol.conditions and not directives and not nearby:
out.append("A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.\n\n")
notes = list(contract.get("portabilidade", []))
if symbol.language == "shell":
notes.append("Runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2. Não é um script CMD/PowerShell.")
elif symbol.language == "python":
notes.append("Script Python: usa a biblioteca padrão e pathlib/subprocess quando aplicável; caminhos não devem depender do separador de um único OS.")
elif symbol.path.startswith("tools/"):
notes.append("O transpilador abre entrada/saída em modo binário; BG_FORMATO só adiciona atributo printf em GCC/Clang.")
elif symbol.module == "caractere":
notes.append("ASCII explícito, sem ctype/locale; o sinal de char não muda a classificação.")
elif symbol.module == "texto":
notes.append("Tamanhos são bytes. Conversões reais usam a locale C corrente; o projeto não chama setlocale.")
elif symbol.module == "matematica":
notes.append("Limites de tipos vêm do alvo. Funções libm exigem -lm no caminho GCC/Clang documentado; o CRT do MSVC não usa essa flag.")
elif symbol.module == "utilidades":
notes.append("Gerador próprio com estado global; não é criptográfico nem thread-safe. A interface unsigned acompanha o alvo.")
if symbol.kind == "macro" and symbol.name not in {"BG_NORETURN", "__USE_MINGW_ANSI_STDIO", "BG_FORMATO"} and not symbol.conditions:
notes.append("Fora das extensões opcionais, a linguagem exige C11; diferenças de tipo, libc e CRT continuam sendo as do alvo.")
for note in dict.fromkeys(notes):
out.append(f"- {protect(note)}\n")
out.append("\n:::important[Não confunda implementação com certificação]\n"
"A matriz histórica distingue executado, compilado, avaliado e não testado. "
"Consulte [a matriz](/projeto/11-matriz-compatibilidade), [os compiladores](/projeto/10-compiladores) "
"e os logs atuais dos workflows antes de chamar um alvo de suportado.\n:::\n")
return "".join(out)

Nomes internos referenciados: protect.

Como este símbolo aparece nos testes​

Sem uso direto localizado

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.

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 Renderer.portability. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que Renderer.portability faz?​

Renderiza guards, diretivas, marcadores e ressalvas de compilador/OS.

Qual é a assinatura e o tipo de retorno de Renderer.portability?​

Assinatura extraída de tools/documentacao/render.py; visibilidade pública.

def portability(self, symbol: Symbol) -> str:

Como chamar Renderer.portability 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 portability(self, symbol: Symbol) -> str:

Por que não há teste direto para Renderer.portability?​

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.

Renderer.portability depende de compilador, padrão C ou sistema operacional?​

Renderer.portability é 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.