Este repositório contém a implementação e estudo de um compilador para a linguagem de programação Poglin(Baseada em Kotlin), desenvolvido como projeto da disciplina de Compiladores (2025-1, Prof. Dr. Ed Wilson Tavares Ferreira).

O compilador executa as seguintes fases:

• Análise léxica, sintática e semântica
• Geração de Árvore Sintática Abstrata (AST)
• Tradução para Código de Três Endereços (TAC)
• Tradução para LLVM IR usando llvmlite

• Int: Inteiros (32 bits)
• String: Sequência de caracteres

• start, end, var, if, else, while, println, readLine, pog, Int, String

• Aritméticos: +, -, *, / (e + também concatena String)
• Lógicos: &&, ||, !
• Relacionais: ==, !=, <, <=, >, >=

if (cond) { bloco } else { bloco }

while (cond) { bloco }

%%{ init : { "theme": "dark" } }%%
graph TD
    A[Código Fonte .pog] --> B(Analisador Léxico)
    B --> C{Tokens}
    C --> D(Analisador Sintático)
    D --> E{Árvore de Parse}
    E --> F(Gerador de AST)
    F --> G{AST}
    G --> H(Analisador Semântico)
    H -- Erros --> I[Relatório de Erros]
    H -- OK --> J{AST + Tabela de Símbolos}
    J --> K(Gerador de TAC)
    K --> L{TAC}
    L --> M(Gerador LLVM IR)
    M --> N{LLVM IR}
    N --> O(Compilador clang)
    O --> P[Executável]
    P --> Q(Resultado no Terminal)

compiler_poglin/
├── grammars/                 # Gramática ANTLR (.g4)
│   └── .antlr/              # Cache ANTLR gerado
├── output/                  # Saída (.png, .tac, .ll)
├── src/
│   ├── ast/                 # Geração e visualização da AST
│   │   └── __pycache__/
│   ├── final_code/          # Geração de código LLVM
│   │   └── __pycache__/
│   ├── intermediario/       # Geração do código TAC
│   │   └── __pycache__/
│   ├── lexer/               # Lexer ANTLR e wrapper
│   │   └── __pycache__/
│   ├── parser/              # Parser ANTLR e wrapper
│   │   ├── generated/       # Arquivos ANTLR gerados
│   │   └── __pycache__/
│   ├── semantic/            # Analisador semântico e símbolos
│   │   └── __pycache__/
│   └── __pycache__/
├── tests/                   # Testes da linguagem (.pog)
├── main.py                  # Ponto de entrada do compilador

• poglinLexer.py: Gerado pelo ANTLR para tokenização
• poglin_lexer.py: Wrapper com tratamento de erros e formatação

• poglinParser.py: Parser gerado pelo ANTLR
• poglin_parser.py: Wrapper customizado com validação sintática

• ast_generator.py: Percorre a árvore de parse e gera a AST com Graphviz

• symbol_table.py: Tabela de símbolos com escopos e tipos
• semantic_analyzer.py: Validações semânticas (declarações, tipos, uso)

• tac_classes.py: Representações de operandos e instruções TAC
• tac_generator.py: Gera código intermediário linear (TAC)

• llvm_generator.py: Traduz TAC para LLVM IR usando llvmlite

• Python 3.8+
• Java (JRE) para executar o ANTLR
• Clang (para compilar LLVM IR em executável)
• Graphviz (software + lib Python)

pip install antlr4-python3-runtime==4.11.1 llvmlite graphviz

Obs: Certifique-se de que o executável dot do Graphviz está no PATH do sistema.

Certifique-se que o antlr-4.11.1-complete.jar foi renomeado para antlr.jar e está na raiz do projeto.

java -jar antlr.jar -Dlanguage=Python -o src/parser/generated grammars/poglin.g4 -visitor -no-listener

python main.py <caminho_para_arquivo.pog> [--ast] [--tac] [--llvm]

• --ast: Gera e salva a AST em .png
• --tac: Imprime e salva o código de três endereços .tac
• --llvm: Imprime e salva o LLVM IR .ll

python main.py tests/classify_triangle.pog --ast --tac --llvm

Após gerar um .ll, compile e execute assim:

clang output/classify_triangle.ll -o output/classify_triangle -lm
./output/classify_triangle

Use -lm apenas se estiver usando funções matemáticas.

A pasta tests/ contém exemplos de programas Poglin:

• classify_triangle.pog: Classificação de triângulos
• pascal_triangle.pog: Geração de triângulo de Pascal
• sum_numbers.pog: Entrada e concatenação de strings
• divide_by_zero.pog: Testa erro semântico de divisão por zero