🌟 VISUALGPP 🌟

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.

🚀 About the Project

VisualGPP is an evolution of VisualG, created to bring its educational syntax and logic into the modern Python ecosystem.

The main goals of this project are:

• Transpile VisualG (.alg) files into Python
• Allow execution of VisualG algorithms outside the original VisualG environment
• Enable usage in modern terminals, editors and workflows
• Provide a simple, global CLI tool

Ideal for:

• Students
• Teachers
• Programming enthusiasts
• Anyone migrating from VisualG to Python

📦 Installation

VisualGPP is distributed via NPM.

Install it globally with:

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:

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

Show banner and status

visualgpp

This command displays the VisualGPP banner and confirms that the tool is installed and ready to use.

Transpile a VisualG file

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.

🚀 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.

Install globally:

npm install -g visualgpp