Pular para o conteúdo principal

BASICGOL — Relatório de testes da Fase 3 (controle de fluxo)

Registro histórico: as contagens abaixo são o retrato da suíte no encerramento da Fase 3. Fases posteriores acrescentaram testes; os totais atuais estão no README e são reproduzidos por make test.

Resultado: 294 verificações, 294 aprovadas, 0 reprovadas (GCC 12.2, -std=c11 e -std=c17, -Wall -Wextra -Wformat=2 -Wvla -Werror). Antes da fase, a suíte tinha 244 verificações; a fase acrescentou 50 sem remover nenhuma.

Ambiente: Debian 12, GCC 12.2.0. Clang não estava instalado neste ambiente e não foi executado localmente; a matriz GCC × Clang × c11 × c17 do CI continua sendo a validação oficial para Clang (ver §5).

Comandos executados:

make # constrói build/basicgolc
make test # suíte completa -> TUDO OK: 294
T_CFLAGS="-std=c17 -Wall -Wextra -Wformat=2 -Wvla -Werror" ./tests/run.sh # -> TUDO OK: 294
make exemplos # 19 exemplos compilados com -Werror
make cobertura # regenera tests/COBERTURA.md (CI verifica que está atualizado)

1. Resultado por seção​

SeçãoVerificaçõesAprovadasReprovadas
01 — sanidade (cabeçalho, C11, expansões AC-22, avaliação única)19190
casos 02_basico14140
casos 03_controle (c01–c40)77770
casos 04_estruturas22220
casos 05_entrada_saida30300
casos 07_multiarquivo440
casos 08_aplicacao220
casos 09_tipos_expr30300
06 — negativos, erros do compilador C (M0)20200
06b — negativos, diagnósticos do transpilador (M1)14140
06c — avisos W-01…W-07770
09 — transpilador M115150
10 — exemplos (M0 e M1 contra a saída dourada)36360
11 — estresse440
Total2942940

Na seção 03_controle, 37 casos rodam nos dois caminhos (M0 e M1) e 3 (c15, c16, c17) só no M1, por serem açúcar. Por isso são 77 verificações e não 80.

2. Verificações novas desta fase (50)​

CasoO que provaM0M1
03_controle/c24_zero_iteracoesPARA, PARA_PASSO, ENQUANTO com zero iterações; REPITA roda uma vez✔✔
c25_limites_inclusivosextremos incluídos; passo que não cai no fim; faixa com negativos✔✔
c26_passo_zero_erropasso zero em execução: PARA_PASSO: passo zero, código 1✔✔
c27_passo_zero_intervalo_vaziopasso zero é erro mesmo com intervalo vazio✔✔
c28_aninhados_pare_prossigaPARE e PROSSIGA afetam só o laço mais interno✔✔
c29_saida_de_dois_lacossaída de dois laços com bandeira; caso sem solução termina✔✔
c30_repita_prossigaPROSSIGA em REPITA vai ao teste (sem laço infinito)✔✔
c31_enquanto_prossigaPROSSIGA em ENQUANTO com contador já incrementado✔✔
c32_para_prossiga_avancaPROSSIGA em PARA avança a variável; valor final fim + 1✔✔
c33_condicoes_aninhadasquatro combinações de SE aninhado; cada SENAO no seu SE✔✔
c34_faixas_senao_secadeia SENAO_SE com faixas e OU; primeiro ramo verdadeiro vence✔✔
c35_escolha_no_lacoPARE sai só do ESCOLHA; PROSSIGA vai ao próximo i; rótulos agrupados✔✔
c36_laco_entrada_sentinelaleitura até a sentinela; segunda rodada com zero iterações; LEIA_INTEIRO✔✔
c37_laco_interno_vaziolaço interno vazio não encerra o externo✔✔
c38_virgula_em_enquantovírgula de nível superior na condição de ENQUANTO✔✔
c39_senao_com_se_aninhadopadrão recomendado para SE aninhado dentro de SENAO✔✔
c40_passo_sem_sinalpasso NATURAL sem avisos sob -Wextra -Wpedantic✔✔
06_negativos/n17_pare_fora_de_lacoPARE fora de laço é recusado pelo C✔—
n18_prossiga_fora_de_lacoPROSSIGA sem laço é recusado✔—
n19_ate_que_com_virgulavírgula de nível superior em ATE_QUE é recusada✔—
n20_escolha_com_virgulavírgula de nível superior em ESCOLHA é recusada✔—
12_negativos_m1/t12_passo_zero_literalPASSO 0 literal recusado pelo transpilador—✔
t13_senao_sem_seSENAO sem SE aberto recusado—✔
t14_ate_que_sem_ponto_e_virgulaATE_QUE(c) sem ; recusado pelo transpilador—✔
10_exemplos controle_condicoescondições aninhadas, FUNCAO TEXTO, sinal e paridade✔✔
controle_lacostabela com PROSSIGA, Collatz (ENQUANTO), REPITA, bandeira✔✔
controle_acumuladoressoma, produto, contagem, maior/menor, média REAL, laço vazio✔✔
controle_entradavalidação com REPITA, sentinela, zero iterações✔✔
controle_para_acucaraçúcar PARA i DE … FACA, PASSO negativo, ATE em REPITA—✔

Contagem: 17 casos × 2 = 34; negativos 4 + 3 = 7; exemplos 4 × 2 + 1 = 9. Total 50.

3. Defeitos encontrados nesta fase​

Três defeitos reais, todos observados antes da correção e fixados por teste depois.

#DefeitoComo apareceu (antes)CorreçãoTeste que fixa
D1PARA_PASSO com passo 0 não terminaPARA_PASSO (i, 10, 1, 0) { … } sem PARE: a execução foi interrompida por timeout (código 124 após 3 s)a condição chama bg_passo_zero (erro com linha, código 1); expansão igual para p ≠ 0; M1 usa a mesma formac26, c27
D2M1 aceitava ATE_QUE(cond) sem ;ATE_QUE(a > 3) seguido de outra instrução: o basicgolc saiu com código 0 e o erro só apareceria no C. A documentação do próprio README afirmava que o transpilador acusava issoverificação em basicgolc: o ; precisa vir logo após o )t14
D3Mensagem de SENAO SE enganosadizia só "use SENAO_SE", que é errado para quem queria um SE aninhado dentro de SENAOa mensagem agora diz como escrever o SE aninhadot02 (prefixo preservado) e c39 (padrão recomendado)

Erro de autoria, também corrigido: o caso c36 foi escrito inicialmente com SENAO seguido de SE. O M1 recusou, corretamente, pela regra CND-2. O programa é que estava fora da especificação, não o transpilador.

4. Divergência conhecida (documentada, não corrigida)​

SENAO seguido de SE (dois tokens) é aceito pelo M0 como bloco aninhado e recusado pelo M1 pela regra CND-2. As macros não conseguem recusar essa sequência, porque ela é C válido. Não foi corrigido porque a regra é normativa; o comportamento está em 07-controle-de-fluxo.md §6.2 e o padrão recomendado (c39) passa nos dois caminhos.

5. O que não foi verificado​

ItemSituação
Clang (CI: gcc e clang × c11 e c17)não executado localmente; as variantes de texto dos negativos foram escritas para GCC e Clang, mas só a execução no CI confirma
MSVCnúcleo com /std:c11 /W4 /WX e exemplos nos caminhos M0/M1 verificados em CI (workflow msvc.yml)
MinGWnão executado
Revisão humana (AC-17, AC-18 de 05)não feita nesta fase
Desempenho de laçosnão medido; a suíte não tem teste de tempo
Versão da linguagemmantida em 1.1.0: a mudança de passo zero é correção de comportamento indefinido, mas subir a versão é decisão de quem publica

6. Como reproduzir​

make && make test
./tests/run.sh -v 03_controle # os casos de controle, um a um
./tests/run.sh -v 06_negativos # negativos M0 e M1
make exemplos

Cada caso de execução é compilado e rodado nos dois caminhos e comparado à saída dourada; a falha de qualquer um deles reprova o caso.

Símbolos citados neste documento​

Nomes que aparecem literalmente no texto acima e que possuem página de referência gerada do fonte:

bg_passo_zero.

Perguntas frequentes​

Perguntas frequentes sobre este documento, respondidas a partir do conteúdo versionado e da referência gerada.

Quantas verificações a fase 3 adicionou?​

50 verificações novas, com 294 aprovadas e nenhuma reprovada no total da fase. A tabela §1 detalha por seção; 37 casos de controle rodam em M0 e M1 e 3 rodam só em M1 por serem açúcar.

Quais defeitos foram encontrados?​

Três: PARA_PASSO com passo zero não terminava; o M1 aceitava ATE_QUE(cond) sem ;; e a mensagem de SENAO SE era enganosa. Todos foram corrigidos e fixados por teste (c26, c27, t14, t02, c39).

O que não foi verificado nesta fase?​

Clang nativo, MSVC, MinGW, revisão humana dos critérios e desempenho de laços. A seção §5 declara cada lacuna; versão da linguagem mantida em 1.1.0.

Como reproduzir o relatório?​

Os comandos estão no §6 do documento e correspondem aos alvos do Makefile. Compare os números com o log da execução, não com as contagens estáticas do site.

make test
make test-portabilidade
make test-sanitize