A Yoruba-first programming language
OduduwaLang
A powerful, open-source programming language that allows you to write real software natively in Yoruba. Oduduwa stands as a bridge between profound cultural heritage and modern software engineering.
It compiles directly to Python, meaning it has the full power of the Python ecosystem while maintaining Yoruba syntax and grammar.
---
## 🚀 Getting Started (How to Install)
To use OduduwaLang on any computer, follow these simple steps:
### 1. Install Python
OduduwaLang requires Python to run. If you don't have Python installed, download it from python.org.
### 2. Install OduduwaLang
Open your terminal (Command Prompt, PowerShell, or macOS Terminal) and type the following command to download OduduwaLang from the global PyPI registry:
```bash
pip install oduduwalang
```
*(If you are on Mac/Linux, you may need to use `pip3 install oduduwalang` instead).*
### 3. Install the VS Code Extension
To get beautiful syntax highlighting and the official Ife Bronze Head icon for your `.odu` files:
1. Open Visual Studio Code.
2. Go to the **Extensions** tab (or press `Ctrl+Shift+X`).
3. Search for **OduduwaLang**.
4. Click **Install**.
---
## đź’» Writing Your First Code
Once installed, create a new file named `hello.odu` and open it in VS Code.
Type the following Yoruba code to print a message to the screen:
```oduduwa
tejade("E kaaro Aye! (Hello World)")
```
### Running the Code
Open your terminal inside the folder where you saved `hello.odu` and run:
```bash
python -m oduduwa.cli sise hello.odu
```
*(Or, if your Python Scripts folder is added to your Windows PATH, you can simply type: `oduduwa run hello.odu`)*
---
## ⚡ The Interactive REPL
Want to just test some Yoruba code quickly without creating a file? You can open the Oduduwa Interactive Shell!
Just open your terminal and type:
```bash
python -m oduduwa.cli
```
You will see the interactive prompt where you can type code line-by-line:
```
=======================================
OduduwaLang REPL v0 …