Pular para o conteúdo principal

Python · tests/documentacao/test_gerador

Fonte: tests/documentacao/test_gerador.

FunçãoLinhasResumoReferências diretas
GeradorTest.setUpClass17–19Extrai o repositório real uma vez para os testes de integração.0
GeradorTest.test_funcoes_publicas_tem_corpo_e_prototipo21–27Funções bg_ públicas são ligadas à declaração do cabeçalho.0
GeradorTest.test_apelidos_e_expansao29–33SE e BG_SE são reunidos sem perder a expansão literal.0
GeradorTest.test_guards_de_compilador_preservados35–45A análise não escolhe um alvo e apaga os demais ramos.0
GeradorTest.test_referencias_de_teste_tem_linha_real47–54Uma chamada de teste aponta para arquivo e linha existentes.0
GeradorTest.test_casos_multiarquivo_e_marcadores56–62Descoberta inclui todos os .c e marcadores, não só programa.c.0
GeradorTest.test_modos_fatais_e_stdin64–68strcmp do harness é ligado ao ramo e às primitivas chamadas.0
GeradorTest.test_python_e_shell_descobertos70–75Funções além do C entram no inventário interno.0
GeradorTest.test_escrita_mdx_nao_quebra_codigo77–83Chaves e ângulos em prosa são escapados; código inline permanece.0
GeradorTest.test_saida_deterministica_e_check85–97Dois builds dos mesmos insumos têm hashes iguais; --check detecta drift.0
GeradorTest.test_toda_pagina_tem_faq_com_codigo99–112Toda página MDX gerada traz FAQ própria e pelo menos um trecho de código.0
GeradorTest.test_faq_de_simbolo_usa_dados_da_pagina114–124A FAQ repete a expansão real e a contagem de referências do símbolo.0
GeradorTest.test_nao_apaga_saida_nao_gerenciada126–134Limpeza recusa diretório sem marcador de geração.0
GeradorTest.test_funcao_e_caso_novos_aparecem_sem_lista_manual136–156Um repositório mínimo prova a descoberta automática de adições futuras.0

Perguntas frequentes​

Perguntas frequentes sobre tests/documentacao/test_gerador e as 14 função(ões) indexada(s) nele.

Que funções este arquivo expõe?​

As funções abaixo foram extraídas do próprio arquivo. Elas são internas ao projeto: não fazem parte da API pública de basicgol.h.

def setUpClass(cls) -> None:
def test_funcoes_publicas_tem_corpo_e_prototipo(self) -> None:
def test_apelidos_e_expansao(self) -> None:
def test_guards_de_compilador_preservados(self) -> None:
def test_referencias_de_teste_tem_linha_real(self) -> None:
def test_casos_multiarquivo_e_marcadores(self) -> None:

Como executar este arquivo?​

Depende do tipo de arquivo. A receita abaixo é a do projeto; flags e argumentos específicos estão na assinatura de cada função.

python3 tests/documentacao/test_gerador

As funções internas têm teste próprio?​

0 das 14 funções possuem referência direta nos testes. As demais podem ser alcançadas apenas por chamadores; o JSON de cobertura registra a lacuna.

Qual é o contrato de GeradorTest.setUpClass?​

Extrai o repositório real uma vez para os testes de integração.

def setUpClass(cls) -> None:
"""Extrai o repositório real uma vez para os testes de integração."""
cls.inv = collect(ROOT)