Vertex Language Documentation 🌀

Welcome to Vertex — a simple, expressive, and powerful programming language designed to be the next Python killer.
Currently, Vertex runs on an interpreter and a Python transpiler, but will evolve into a full standalone compiler.

---

🚀 Getting Started

Clone the repository:

git clone https://github.com/Ugochi56/Vertex.git
cd Vertex

Installation

Install the package in editable mode:

pip install -e .

Compile to Python

You can compile Vertex files using the vertex command (if installed) or by running the module directly.

Using the installed command:

vertex examples/hello.vx -o out/hello.py
python out/hello.py

Using the module directly:

python -m vertex examples/hello.vx -o out/hello.py
python out/hello.py

---

✨ Language Features

1. Variables Declare variables with let:

vertex

let name: string = "Ugo"
let year: int = 2025

let keyword is used for variable declaration.

Types are optional but encouraged (string, int, etc.).

2. Printing

vertex

print "Hello, " + name
print year

Use print to output values.

Concatenate strings with +.

3. Arithmetic

vertex

let x: int = 10
let y: int = 5

print x + y       # 15
print x * y       # 50
print x - y       # 5
print x / y       # 2

📝 Example Program

vertex

let name: string = "NAME"
let year: int = 2025

print "Hello, " + name
print "It is currently " + year

let x: int = 10
let y: int = 5

print "Sum: " + (x + y)
print "Product: " + (x * y)

Output

Hello, NAME
It is currently 2025
Sum: 15
Product: 50

🔮 Roadmap (Planned Features)

📝 Conditionals (if / else)

📝 Loops (for, while)

📝 Functions (fn greet(name: string))

📝 Classes & Objects (OOP support)

📝 Modules & Imports

📝 Custom Types & Enums 📝 Error Handling (try / catch) 📝 Direct Bytecode Compilation (no Python dependency)

🤝 Contributing

We welcome contributors!
. Fork the repo
. Create a branch (feature-x)
. Submit a pull request 🚀