Pular para o conteúdo principal

Python · tools/cobertura

Fonte: tools/cobertura.

FunçãoLinhasResumoReferências diretas
nomes_curtos27–32Todos os nomes curtos (a sintaxe canônica) definidos no cabeçalho.0
arquivos_com35–44Arquivos de teste que citam o nome como palavra inteira.0
casos_por_suite47–70(suíte, número de casos, o que cobre).0
main153–294Regenera tests/COBERTURA.md de forma determinística a partir dos nomes e casos.9

Perguntas frequentes​

Perguntas frequentes sobre tools/cobertura e as 4 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 nomes_curtos() -> list[str]:
def arquivos_com(nome: str) -> list[str]:
def casos_por_suite() -> list[tuple[str, int, str]]:
def main() -> 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 tools/cobertura

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

1 das 4 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 nomes_curtos?​

Todos os nomes curtos (a sintaxe canônica) definidos no cabeçalho.

def nomes_curtos() -> list[str]:
"""Todos os nomes curtos (a sintaxe canônica) definidos no cabeçalho."""
texto = HEADER.read_text(encoding="utf-8")
inicio = texto.index("3. Nomes curtos")
secao = texto[inicio:]
return sorted(set(re.findall(r"^#define\s+([A-Z][A-Z0-9_]*)", secao, re.M)))