How samporter12/proyecto-integrador-final---minicompiler works
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.