Python · tools/cobertura
Fonte: tools/cobertura.
| Função | Linhas | Resumo | Referências diretas |
|---|---|---|---|
nomes_curtos | 27–32 | Todos os nomes curtos (a sintaxe canônica) definidos no cabeçalho. | 0 |
arquivos_com | 35–44 | Arquivos de teste que citam o nome como palavra inteira. | 0 |
casos_por_suite | 47–70 | (suíte, número de casos, o que cobre). | 0 |
main | 153–294 | Regenera 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)))