feat(tests): organize code

Author: BeyondMagic

Makefile

@@ -16,6 +16,11 @@ LEX_OUT = lex.yy.c
 YACC_OUT = parser.tab.c
 YACC_HEADER = parser.tab.h
 
+SMOKE_DIR = tests/smoke
+SMOKE_SOURCES := $(wildcard $(SMOKE_DIR)/*.c)
+SMOKE_CASES := $(basename $(notdir $(SMOKE_SOURCES)))
+SEMANTIC_SCRIPT = scripts/run_semantic_tests.sh
+
 all: $(TARGET)
 
 $(TARGET): $(LEX_OUT) $(YACC_OUT) $(SRC)
@@ -30,22 +35,32 @@ $(YACC_OUT) $(YACC_HEADER): $(YACC_SRC) src/ast.h src/ast.c
 clean:
 	rm -f $(TARGET) $(LEX_OUT) $(YACC_OUT) $(YACC_HEADER)
 
-TEST_CASES = \
-	expressions \
-	variable
-
 test: all
-	@echo "== Running sample tests =="
-	@for case in $(TEST_CASES); do \
-		output=$$(./c2lua tests/$$case.c); \
-		expected=$$(cat tests/$$case.lua); \
-		printf '%s' "-- $$case... "; \
-		if [ "$$output" = "$$expected" ]; then \
-			echo "ok"; \
-		else \
-			echo "fail"; \
-			printf 'Expected:\n%s\n\nGot:\n%s\n' "$$expected" "$$output"; \
-			exit 1; \
-		fi; \
-	done
-	@echo "All tests passed."
+	@echo "== Running smoke tests =="
+	@if [ -z "$(SMOKE_CASES)" ]; then \
+		echo "No smoke tests found under $(SMOKE_DIR)"; \
+	else \
+		for case in $(SMOKE_CASES); do \
+			input="$(SMOKE_DIR)/$$case.c"; \
+			expected_file="$(SMOKE_DIR)/$$case.lua"; \
+			if [ ! -f "$$expected_file" ]; then \
+				echo "Missing expected Lua file for $$case"; \
+				exit 1; \
+			fi; \
+			output=$$(./c2lua "$$input"); \
+			expected=$$(cat "$$expected_file"); \
+			printf '%s' "-- $$case... "; \
+			if [ "$$output" = "$$expected" ]; then \
+				echo "ok"; \
+			else \
+				echo "fail"; \
+				printf 'Expected:\n%s\n\nGot:\n%s\n' "$$expected" "$$output"; \
+				exit 1; \
+			fi; \
+		done; \
+		echo "All smoke tests passed."; \
+	fi
+
+semantic-test: all
+	@echo "== Running semantic tests =="
+	@COMPILER_CMD=./c2lua bash $(SEMANTIC_SCRIPT)

README.md

@@ -17,7 +17,9 @@ O que não será suportado:
 ├── lexer/        # regras léxicas (lexer.l)
 ├── parser/       # gramática e ações (parser.y)
 ├── src/          # main.c, AST, tabela de símbolos, gerador Lua
-├── tests/        # entradas C e saídas Lua esperadas
+├── tests/
+│   ├── smoke/    # testes rápidos de tradução (pares C/Lua)
+│   └── semantic/ # casos PASS/FAIL com golden files
 └── Makefile
 ```
 
@@ -29,21 +31,30 @@ sudo apt install -y flex bison build-essential git
 
 Build local (exemplo mínimo):
 ```nu
-flex lexer/lexer.l
-bison -d parser/parser.y
-gcc -o c2lua lex.yy.c parser.tab.c src/*.c -lfl
-./c2lua < tests/exemplo.c > out.lua
+make           # gera o binário ./c2lua a partir das fontes
+./c2lua tests/smoke/expressions.c
 ```
 
 # Documentação de cada sprint
 
 - [1ª sprint](./docs/sprints/1.md);
 - [2ª sprint](./docs/sprints/2.md);
-- 3ª sprint;
+- [3ª sprint](./docs/sprints/3.md);
 - 4ª sprint;
 
 # Testes
 
-A pasta `tests/` contém arquivos `.c` de entrada e os correspondentes `.lua` esperados. Use `diff` para comparar a saída gerada com a esperada.
+A pasta `tests/` está organizada em:
+- `tests/smoke/`: pares simples C/Lua utilizados pelos testes rápidos do Makefile;
+- `tests/semantic/pass`: casos que devem gerar Lua válido e executar com sucesso;
+- `tests/semantic/fail`: casos que precisam falhar na análise semântica (arquivos `.err` com a mensagem esperada);
+- `tests/semantic/golden/fail`: mensagens de erro normalizadas utilizadas como golden files.
 
-Padrão de nomenclatura: `descricao_curta_teste.c` para entrada, e `descricao_curta_teste.lua` para saída esperada.
+Execute as suítes pelo Makefile:
+
+```nu
+make test            # verifica os smoke tests (tradução direta C -> Lua)
+make semantic-test   # valida casos PASS/FAIL com comparação de golden files
+```
+
+Os golden files utilizam o mesmo nome-base do arquivo `.c`, com extensão `.lua` (para PASS) ou `.golden`/`.err` (para FAIL).

scripts/run_semantic_tests.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-COMPILER_CMD="${COMPILER_CMD:-compiler --semantic}"
+COMPILER_CMD="${COMPILER_CMD:-./c2lua}"
 
 RED=$(printf '\033[31m')
 GRN=$(printf '\033[32m')
@@ -28,7 +28,7 @@ echo ""
 echo "== FAIL cases =="
 for f in tests/semantic/fail/*.c; do
   base=$(basename "$f")
-  golden="tests/golden/fail/${base}.golden"
+  golden="tests/semantic/golden/fail/${base}.golden"
   if $COMPILER_CMD "$f" >/dev/null 2>tmp.err; then
     echo -e "${RED}FAIL (expected error, got success)${RST} $f"
     fail_count+=1