# samporter12/proyecto-integrador-final---minicompiler architecture

> Architecture diagram of the GitHub repository samporter12/proyecto-integrador-final---minicompiler, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/samporter12/proyecto-integrador-final---minicompiler
- Repository: https://github.com/samporter12/proyecto-integrador-final---minicompiler

## Overview

##### Identificación del proyecto y su propósito
- Se trata de un mini compilador (Proyecto-Integrador-Final---MiniCompiler) escrito en Python y construido sobre ANTLR4.
- Su objetivo es leer un archivo con código fuente definido por “gramatica.g4”, analizarlo léxica y sintácticamente, hacer comprobaciones semánticas, generar una representación intermedia y producir código Python de salida.

##### Análisis de la estructura de archivos
- Top-level:
- gramatica.g4: definición de la gramática.
- main.py: punto de entrada que orquesta todo el proceso.
- Flujos/: conjunto de casos de prueba y errores esperados.
- generated/: código generado por ANTLR (Lexer, Parser, Visitor, Listener).
- semantic_analyzer/: lógica que recorre el árbol de análisis y produce una representación intermedia.
- codegen/: módulo que transforma la representación intermedia en código Python.
- Patrón: flujo lineal de etapas (Lex–Parse–Semantic–IR–CodeGen).

##### Componentes principales y su interacción (diagrama de flujo en español)
Inicio
↓
[Entrada: archivos en “Flujos/” o código fuente genérico]
↓
[1. ANTLR4]
- Toma gramatica.g4
- Genera Parser y Lexer en generated/
↓
[2. Análisis Léxico y Sintáctico]
- main.py invoca generated/gramaticaLexer y generated/gramaticaParser
- Produce un árbol de análisis sintáctico (Parse Tree)
↓
[3. Análisis Semántico]
- semantic_analyzer/SemanticAnalyzerVisitor recorre el Parse Tree
- Utiliza IntermediateRepresentation.py para construir el IR
- Detecta errores semánticos (variables no definidas, tareas duplicadas, etc.)
↓
[4. Generación de Código Intermedio (IR)]
- IR contiene estructuras de datos que representan instrucciones y bloques
↓
[5. Generación de Código Python]
- codegen/PythonCodeGenerator.py convierte el IR en un script Python final
↓
[6. Salida]
- Código Python listo para ejecutarse o más pruebas
- Registros de errores en consola o archivo

##### Pautas para el diagrama
- Componentes (recuadros):
- Entrada (archivo fuente)
- ANTLR4
- Parser/Lexer
- Árbol de Sintaxis
- SemanticAnalyzerVisitor
- IntermediateRepresentation
- PythonCodeGenerator
- Salida (código final)
- Flechas direccionales:
- Mostrar el flujo de datos de arriba hacia abajo
- Etiquetar cada flecha (por ejemplo, “Parse Tree → SemanticAnalysis”)
- Colores/ Formas:
- Azul: etapas de lectura y generación (ANTLR4, Parser/Lexer)
- Verde: fases de procesamiento interno (Semántico, IR)
- Naranja: generación final y salida
- Notas:
- Añadir pequeños bloques laterales para “Flujos/” donde se validan casos de prueba.
- Usar iconos o etiquetas para indicar archivos clave (gramatica.g4, main.py).

##### Consejos finales
- Sea muy detallado: incluya cada paso y artefacto generado.
- Use leyendas para explicar colores y símbolos.
- Etiquete claramente cada componente y cada flecha.
- Asegúrese de mostrar las comprobaciones de errores semánticos (casos de “Flujos/error_*”) como rutas alternativas en el diagrama.
- Mantenga todo el diagrama en español y en estilo de diagrama de flujo.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Nodos principales
    TestCases["Flujos/"]:::external
    Entrada["Entrada: archivo fuente"]:::external
    Gramática["Gramática ANTLR4: gramatica.g4"]:::reading
    ANTLR4["ANTLR4 Generación"]:::reading
    ParserLexer["Parser & Lexer Generados"]:::reading
    Árbol["Árbol de Sintaxis (Parse Tree)"]:::processing
    SemanticVisitor["SemanticAnalyzerVisitor"]:::processing
    IR["IntermediateRepresentation"]:::processing
    CodeGen["PythonCodeGenerator"]:::final
    Salida["Salida: Código Python / Registros"]:::final
    ErrorSem["Errores Semánticos (Flujos/error_*)"]:::final

    %% Flujo principal
    TestCases -->|"casos de prueba"| Entrada
    Entrada -->|"lee gramatica.g4"| Gramática
    Gramática -->|"genera código"| ANTLR4
    ANTLR4 -->|"produce lexer y parser"| ParserLexer
    click Gramática "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/gramatica.g4"
    click ParserLexer "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/generated/gramaticaParser.py"
    click ParserLexer "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/generated/gramaticaLexer.py"
    click ParserLexer "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/generated/gramaticaListener.py"
    click ParserLexer "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/generated/gramaticaVisitor.py"
    ParserLexer -->|"invocado por main.py"| Árbol
    click Entrada "https://github.com/samporter12/proyecto-integrador-final---minicompiler/tree/main/Flujos/"
    click Main "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/main.py"
    Árbol -->|"recorrido semántico"| SemanticVisitor
    click SemanticVisitor "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/semantic_analyzer/SemanticAnalyzerVisitor.py"
    SemanticVisitor -->|"construye IR"| IR
    click IR "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/semantic_analyzer/IntermediateRepresentation.py"
    IR -->|"genera código Python"| CodeGen
    click CodeGen "https://github.com/samporter12/proyecto-integrador-final---minicompiler/blob/main/codegen/PythonCodeGenerator.py"
    CodeGen --> Salida

    %% Ruta alternativa de errores
    SemanticVisitor -->|"detecta errores"| ErrorSem
    ErrorSem --> Salida

    %% Estilos
    classDef reading fill:#AED6F1,stroke:#3498DB,color:#1B4F72,stroke-width:2px;
    classDef processing fill:#ABEBC6,stroke:#27AE60,color:#145A32,stroke-width:2px;
    classDef final fill:#F9E79F,stroke:#D68910,color:#7E5109,stroke-width:2px;
    classDef external fill:#E5E7E9,stroke:#95A5A6,color:#2C3E50,stroke-width:2px;
```
