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