========================================================================

1. DESCRIÇÃO DO PROJETO

   Este projeto consiste no desenvolvimento de um Interpretador e Front-end de Compilador para um subconjunto da linguagem C.

DEFINIÇÃO TÉCNICA:

• Linguagem de Implementação (Host): Python 3
• Linguagem Fonte (Source): C (Subset)

O sistema foi desenvolvido em Python utilizando o ANTLR4 para a análise sintática. Ele lê o código fonte em C, valida sua estrutura gramatical e lógica (tipagem, escopo e integridade de variáveis) e, caso não haja erros, percorre a Árvore Sintática Abstrata (AST) para executar o programa diretamente no terminal.

FUNCIONALIDADES IMPLEMENTADAS: [x] Tipos de dados: int, float, char. [x] Declaração e atribuição de variáveis. [x] Estruturas de controle: if / else. [x] Estruturas de repetição: while e do...while. [x] Entrada e Saída: printf e scanf (com validação semântica). [x] Verificação de variáveis não declaradas ou duplicadas.

======================================================================== 2. # ESTRUTURA DOS ARQUIVOS O pacote de entrega contém:

• CompiladorX.exe -> Executável standalone (não requer Python).
• main.py -> Código fonte principal (Driver do compilador).
• SemanticVisitor.py -> Lógica de análise semântica e Tabela de Símbolos.
• InterpreterVisitor.py-> Lógica do interpretador (execução do código).
• LinguagemX.g4 -> Gramática do ANTLR4 (regras da linguagem C).
• Arquivos ANTLR -> Lexer/Parser/Visitor gerados automaticamente.
• Relatorio.pdf -> Documentação técnica do projeto.
• teste_final.c -> Código de teste demonstrando as funcionalidades.

======================================================================== 3. # COMO RODAR O PROJETO (MODO FÁCIL - EXECUTÁVEL)

Requisito: Apenas sistema operacional Windows.

1. Abra o terminal (CMD ou PowerShell) na pasta onde está o executável.

2. Certifique-se de que o arquivo de teste (ex: teste_final.c) está na mesma pasta.

3. Execute o comando:

   CompiladorX.exe teste_final.c

======================================================================== 4. # COMO RODAR O PROJETO (MODO DESENVOLVEDOR - CÓDIGO FONTE)

Requisito: Python 3 instalado.

1. Instale a biblioteca runtime do ANTLR4:

   pip install antlr4-python3-runtime

2. Abra o terminal na pasta dos arquivos fonte.

3. Execute o main.py passando o arquivo de teste:

   python main.py teste_final.c

======================================================================== 5. # OBSERVAÇÕES SOBRE A EXECUÇÃO

O compilador foi configurado para rodar em dois estágios:

1. Compilação: Valida a sintaxe e a semântica. Se houver erro, para.
2. Interpretação: Se a compilação for "SUCESSO", o código é executado.

• O comando 'printf' exibirá o texto/valor no console.
• O comando 'scanf' pausará a execução aguardando entrada do usuário.