# henoc03/compiladores architecture

> Architecture diagram of the GitHub repository henoc03/compiladores, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/henoc03/compiladores
- Repository: https://github.com/henoc03/compiladores

## Overview

Fangless Python is a Python-to-C++ transpiler: users submit source code, which is tokenized, parsed into an AST, and translated into C++ using a PyVal compatibility runtime. The README describes compiling and running the generated C++ as the final step. The repository also contains independent Python-learning import examples; they are separate from the compiler path. The source index and excerpts establish the main compiler calls, while later execution is documented in the README; unsampled example-module links are not inferred.

Main entry points: [`Tarea_3_CodeGen/code_generator.py`](https://github.com/henoc03/compiladores/blob/main/Tarea_3_CodeGen/code_generator.py) (C++ generator), [`Tarea_1_Lexer/lexer.py`](https://github.com/henoc03/compiladores/blob/main/Tarea_1_Lexer/lexer.py) (Lexer), [`Tarea_2_Parser/parser.py`](https://github.com/henoc03/compiladores/blob/main/Tarea_2_Parser/parser.py) (Parser and AST), [`Actividad2/Organizado/10_Imports/Circular Imports/circular_3.py`](https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_3.py) (Circular import driver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compiler["Compiler stages"]
  node_lexer["Lexer<br/>[lexer.py]"]
  node_parser["Parser and AST<br/>[parser.py]"]
  node_generator["C++ generator<br/>[code_generator.py]"]
end

subgraph group_runtime["C++ runtime"]
  node_pyval["PyVal runtime<br/>[pyval.hpp]"]
end

subgraph group_learning["Import examples"]
  node_circular_driver["Circular import driver<br/>[circular_3.py]"]
  node_circular_one["Circular example one"]
  node_circular_two["Circular example two"]
  node_module_driver["Module example driver<br/>[module_1.py]"]
  node_module_example["Module example<br/>[module_example.py]"]
end

node_user(("Source author"))
node_cpp["Generated C++"]
node_compiler_tool["G++"]
node_program["Executable"]

node_user -->|"submits source"| node_lexer
node_lexer -->|"provides tokens"| node_parser
node_parser -->|"provides AST"| node_generator
node_generator -->|"resets state"| node_lexer
node_generator -->|"parses source"| node_parser
node_generator -->|"emits C++"| node_cpp
node_generator -->|"includes runtime"| node_pyval
node_cpp -->|"compiled by"| node_compiler_tool
node_compiler_tool -->|"uses header"| node_pyval
node_compiler_tool -->|"builds executable"| node_program
node_program -->|"runs result"| node_user
node_circular_driver -->|"calls functions"| node_circular_one
node_circular_driver -->|"calls functions"| node_circular_two
node_module_driver -->|"calls functions"| node_module_example

click node_lexer "https://github.com/henoc03/compiladores/blob/main/Tarea_1_Lexer/lexer.py"
click node_parser "https://github.com/henoc03/compiladores/blob/main/Tarea_2_Parser/parser.py"
click node_generator "https://github.com/henoc03/compiladores/blob/main/Tarea_3_CodeGen/code_generator.py"
click node_pyval "https://github.com/henoc03/compiladores/blob/main/Tarea_3_CodeGen/pyval.hpp"
click node_circular_driver "https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_3.py"
click node_circular_one "https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_example_1.py"
click node_circular_two "https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_example_2.py"
click node_module_driver "https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Modules/module_1.py"
click node_module_example "https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Modules/module_example.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lexer,node_parser,node_generator toneBlue
class node_pyval toneAmber
class node_circular_driver,node_circular_one,node_circular_two,node_module_driver,node_module_example toneMint
class node_user,node_cpp,node_compiler_tool,node_program toneIndigo
```

## Components

### Compiler stages

- [Lexer](https://github.com/henoc03/compiladores/blob/main/Tarea_1_Lexer/lexer.py): `Tarea_1_Lexer/lexer.py`
- [Parser and AST](https://github.com/henoc03/compiladores/blob/main/Tarea_2_Parser/parser.py): `Tarea_2_Parser/parser.py`
- [C++ generator](https://github.com/henoc03/compiladores/blob/main/Tarea_3_CodeGen/code_generator.py): `Tarea_3_CodeGen/code_generator.py`

### C++ runtime

- [PyVal runtime](https://github.com/henoc03/compiladores/blob/main/Tarea_3_CodeGen/pyval.hpp): `Tarea_3_CodeGen/pyval.hpp`

### Import examples

- [Circular import driver](https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_3.py): `Actividad2/Organizado/10_Imports/Circular Imports/circular_3.py`
- [Circular example one](https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_example_1.py): `Actividad2/Organizado/10_Imports/Circular Imports/circular_example_1.py`
- [Circular example two](https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Circular%20Imports/circular_example_2.py): `Actividad2/Organizado/10_Imports/Circular Imports/circular_example_2.py`
- [Module example driver](https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Modules/module_1.py): `Actividad2/Organizado/10_Imports/Modules/module_1.py`
- [Module example](https://github.com/henoc03/compiladores/blob/main/Actividad2/Organizado/10_Imports/Modules/module_example.py): `Actividad2/Organizado/10_Imports/Modules/module_example.py`

### Other components

- **Source author**
- **Generated C++**
- **G++**
- **Executable**

## Connections

- Source author → Lexer: submits source (evidence: `README.md`)
- Lexer → Parser and AST: provides tokens (evidence: `Tarea_2_Parser/parser.py`)
- Parser and AST → C++ generator: provides AST (evidence: `Tarea_3_CodeGen/code_generator.py`)
- C++ generator → Lexer: resets state (evidence: `Tarea_3_CodeGen/code_generator.py`)
- C++ generator → Parser and AST: parses source (evidence: `Tarea_3_CodeGen/code_generator.py`)
- C++ generator → Generated C++: emits C++ (evidence: `README.md`)
- C++ generator → PyVal runtime: includes runtime (evidence: `Tarea_3_CodeGen/code_generator.py`)
- Generated C++ → G++: compiled by (evidence: `README.md`)
- G++ → PyVal runtime: uses header (evidence: `README.md`)
- G++ → Executable: builds executable (evidence: `README.md`)
- Executable → Source author: runs result (evidence: `README.md`)
- Circular import driver → Circular example one: calls functions (evidence: `Actividad2/Organizado/10_Imports/Circular Imports/circular_3.py`)
- Circular import driver → Circular example two: calls functions (evidence: `Actividad2/Organizado/10_Imports/Circular Imports/circular_3.py`)
- Module example driver → Module example: calls functions (evidence: `Actividad2/Organizado/10_Imports/Modules/module_1.py`)
