Metadata-Version: 2.4
Name: MultiLangEngine
Version: 1.1.0
Summary: A fully customizable multi-language programming engine (Hinglish, Punjabi, Sanskrit, GenZ, etc.)
Home-page: https://github.com/gurtej9602/MultiLangEngine
Author: MultiLang Developer
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-python
Dynamic: summary

# 🚀 MultiLang Engine (`.mlang`)

> **MultiLang** is a fully customizable, multi-language programming engine where developers can write code using their own native or slang words (**Hinglish**, **Punjabi**, **Sanskrit**, **Gen Z slang**, **Spanish**, etc.) by simply editing a `keywords.txt` mapping file!

[![PyPI Version](https://img.shields.io/pypi/v/MultiLangEngine.svg)](https://pypi.org/project/MultiLangEngine/)
[![GitHub](https://img.shields.io/github/license/gurtej9602/MultiLangEngine)](https://github.com/gurtej9602/MultiLangEngine)

---

## ⚡ Key Features

- **🌐 Multi-Language Syntax**: Support for Hinglish (`lelo`, `dikhao`), Punjabi (`lao`, `daso`), Sanskrit (`grahan_karo`, `prakashaya`), Gen Z Slang (`spill_tea`, `yap`, `no_cap`), and English out of the box!
- **🔁 Interactive REPL Shell**: Run `mlang` with no arguments to launch an interactive live terminal environment.
- **⚙️ Dynamic `keywords.txt` Mapping**: Modify keywords globally or per-project.
- **🔄 Control Flow & Loops**: Supports `if / else`, `for` loops, and `while` loops.
- **⏱️ Useful Built-in Operations**: Includes Modulo (`rem`/`shesh`/`%`), Delay/Sleep (`roko`/`thero`/`sleep`), Screen Wiping (`saaf`/`clear`/`cls`), and standard mathematical operators.

---

## 📦 Installation

Install globally via `pip`:

```bash
pip install MultiLangEngine
```

Or install the latest dev version directly from GitHub:

```bash
pip install git+https://github.com/gurtej9602/MultiLangEngine.git
```

---

## 🛠️ Commands & Usage

| Command | Action |
|---|---|
| `mlang` | Launches the interactive live REPL terminal |
| `mlang script.mlang` | Runs a `.mlang` file |
| `mlang --version` | Displays installed version |
| `mlang config --edit` | Opens global `keywords.txt` in Notepad/Editor to customize words |
| `mlang config --init` | Creates a local `keywords.txt` in current project directory |

---

## 📝 Code Examples Across Languages

### 1. Hinglish Style (`demo.mlang`)
```mlang
lelo number daldo x me
lelo dusra number y me

dikhao "Pahla number hai: " x
dikhao "Dusra number hai: " y

rakho sum = x jodo y
dikhao "Dono ka jod hai: " sum

agar sum > 10
    dikhao "Jod 10 se bada hai!"
warna
    dikhao "Jod 10 ya usse chhota hai."
khatam
```

---

### 2. Punjabi Style (`punjabi_demo.mlang`)
```mlang
daso "--- Punjabi MultiLang Test ---"
lao n vich
karo count = 1

jadon_tak count <= n
    daso "Ginti (Count): " count
    karo count = count + 1
samapt
```

---

### 3. Sanskrit Style (`sanskrit_demo.mlang`)
```mlang
prakashaya "--- Sanskrit MultiLang Test ---"
pratyek i se 1 tak 3
    prakashaya "Mantra count: " i
samaptam
```

---

### 4. Gen Z Slang Style (`genz_demo.mlang`)
```mlang
yap "--- Gen Z Slang MultiLang Test ---"
spill_tea score
is_it_giving score > 80
    no_cap "W rizz! You cooked!"
side_eye
    real_talk "Major L... Touch grass!"
touch_grass
```

---

## ⚙️ How to Customize `keywords.txt`

Users can customize keywords in **3 easy ways**:

### 1. Global Edit
Run `mlang config --edit` in terminal. It opens `~/.multilang/keywords.txt` in your text editor.

### 2. Local Project Edit
Run `mlang config --init` inside your project folder to create a project-specific `keywords.txt`.

### 🔍 Priority Order of `keywords.txt` Resolution:
1. Local project folder (`./keywords.txt`)
2. User home directory (`~/.multilang/keywords.txt`)
3. Built-in defaults

---

## 📜 License
MIT License © 2026 MultiLang Developer