Pular para o conteúdo principal

conditions

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tools/documentacao/analise.py:181.

Extrai condições de pré-processador ancestrais, incluindo negação de else.

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

Assinatura e expansão​

def conditions(source: Source, node: Node) -> list[dict]:

Parâmetros formais: source: Source, node: Node.

Como funciona​

Extrai condições de pré-processador ancestrais, incluindo negação de else.

Implementação​

def conditions(source: Source, node: Node) -> list[dict]:
"""Extrai condições de pré-processador ancestrais, incluindo negação de else."""
result = []
for parent in ancestors(node):
if parent.type not in {"preproc_if", "preproc_ifdef", "preproc_elif", "preproc_else"}:
continue
if parent.type in {"preproc_else", "preproc_elif"}:
previous = parent.prev_named_sibling
predicates = []
while previous is not None:
if previous.type in {"preproc_if", "preproc_ifdef"}:
cond = previous.child_by_field_name("condition") or previous.child_by_field_name("name")
if cond is not None:
predicates.append(segment(source, cond))
elif previous.type == "preproc_elif":
cond = previous.child_by_field_name("condition")
if cond is not None:
predicates.append(segment(source, cond))
previous = previous.prev_named_sibling
own = parent.child_by_field_name("condition")
if own is not None:
predicates.append(segment(source, own))
condition = ("NOT (" + " OR ".join(predicates) + ")") if predicates else "ramo alternativo"
if own is not None:
condition += " AND " + segment(source, own)
else:
child = parent.child_by_field_name("condition") or parent.child_by_field_name("name")
condition = segment(source, child) if child is not None else segment(source, parent).splitlines()[0]
if parent.type == "preproc_ifdef":
condition = f"defined({condition})"
result.append({"condition": condition, "line": parent.start_point.row + 1 + source.offset,
"kind": parent.type})
return list(reversed(result))

Nomes internos referenciados: ancestors, segment.

Como este símbolo aparece nos testes​

3 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/documentacao/test_gerador.py​

Contexto: GeradorTest.test_guards_de_compilador_preservados. Linhas: 38, 39, 40. Tipo de evidência: código; via conditions.

Linhas 36–42 · abrir contexto
"""A análise não escolhe um alvo e apaga os demais ramos."""
soma = self.inv.by_name["bg_soma_segura"][0]
conditions = " ".join(c["condition"] for c in soma.conditions)
self.assertIn("BG_USAR_EXTENSOES", conditions)
self.assertTrue("__GNUC__" in conditions or "__clang__" in conditions)
formata = self.inv.by_name["bg_formata_texto"][0]
source = self.inv.sources[formata.path]

Ver no GitHub

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.

Nenhum arquivo de teste foi localizado para os chamadores diretos.

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

Em uma frase, o que conditions faz?​

Extrai condições de pré-processador ancestrais, incluindo negação de else.

Qual é a assinatura e o tipo de retorno de conditions?​

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

def conditions(source: Source, node: Node) -> list[dict]:

Como conditions aparece em código real deste repositório?​

Uso extraído de tests/documentacao/test_gerador.py:36, com as linhas vizinhas preservadas:

"""A análise não escolhe um alvo e apaga os demais ramos."""
soma = self.inv.by_name["bg_soma_segura"][0]
conditions = " ".join(c["condition"] for c in soma.conditions)
self.assertIn("BG_USAR_EXTENSOES", conditions)
self.assertTrue("__GNUC__" in conditions or "__clang__" in conditions)

Onde conditions é exercitado nos testes?​

Há 3 ocorrência(s) em 1 arquivo(s): tests/documentacao/test_gerador.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.

conditions depende de compilador, padrão C ou sistema operacional?​

conditions é 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.