**VisualGPP (VisualG++)** is a Python-based transpiler that converts **VisualG** (`.alg`) source files into **Python code**, allowing VisualG algorithms to run in modern environments using a simple command-line interface.
npm install @r1tkill/visualgpp.alg) source files into Python code, allowing VisualG algorithms to run in modern environments using a simple command-line interface.
bash
npm install -g visualgpp
`
---
⚠️ Requirements
- Python 3 must be installed on your system
- Either python or python3 must be available in your PATH
- Node.js (only required for installation via NPM)
Check your Python installation with:
`bash
python --version
`
If Python is not installed, download it from:
https://www.python.org/downloads/
If Python is missing, VisualGPP will automatically display a clear error message when executed.
---
If Python is not installed, download it from:
https://www.python.org/downloads/
If Python is missing, VisualGPP will automatically display a clear error message when executed.
---
🧪 Usage
$3
`bash
visualgpp
`
This command displays the VisualGPP banner and confirms that the tool is installed and ready to use.
---
$3
`bash
visualgpp my_program.alg
`
When running this command:
- The .alg file is transpiled to Python
- A .py file is generated
- The generated Python code is executed automatically
---
🧠 How It Works
VisualGPP reads the .alg source file and parses VisualG structures, including:
- Variable declarations
- Assignments
- Conditionals (se, senao)
- Loops (para, enquanto)
- Functions and procedures
- Vectors and matrices
- File operations
After parsing, VisualGPP:
- Transpiles everything into valid Python syntax
- Executes the generated Python code
The command-line interface is powered by Node.js, while the transpiler core is written entirely in Python.
---
💡 Notes
- VisualGPP is a transpiler, not an interpreter
- The generated Python code can be freely edited or reused
- Designed to be simple, educational and extensible
---
📌 Version
- Current Version: 1.0.0
- Status: Active development
---
👤 Author
R1TKILL
GitHub: https://github.com/R1TKILL
---
✨ Turning VisualG into Python, one .alg at a time!
It is designed as an evolution of VisualG, bringing its syntax and logic to the Python ecosystem while preserving its educational purpose.
---
!Python
!Node.js
!Version
!Status
---
🚀 About the Project
VisualGPP aims to:
- Transpile VisualG (.alg) files into Python
- Allow execution of VisualG algorithms outside the original VisualG environment
- Make VisualG usable in modern workflows, editors and terminals
- Provide a simple CLI tool accessible from any shell
This project is ideal for:
- Students
- Teachers
- Programming enthusiasts
- Anyone migrating from VisualG to Python
---
📦 Installation (Recommended)
VisualGPP is distributed via NPM.
$3
``bash