Metadata-Version: 2.4
Name: MultiLangEngine
Version: 1.2.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)

---

## 📘 Comprehensive Documentation & Guide
Check out the official guide included in this repository:
📄 **[`MultiLang_Engine_Guide.docx`](https://github.com/gurtej9602/MultiLangEngine/blob/main/MultiLang_Engine_Guide.docx)**

---

## ⚡ 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 |

---

## 🎮 Practice Demo Programs

Try running these included demo scripts!

### 1. 🧮 MultiLang Calculator ([`calculator.mlang`](file:///C:/Users/sg938/MultiLangEngine/calculator.mlang))
```bash
mlang calculator.mlang
```

### 2. 🎯 Interactive Number Guessing Game ([`guessing_game.mlang`](file:///C:/Users/sg938/MultiLangEngine/guessing_game.mlang))
```bash
mlang guessing_game.mlang
```

### 3. ✨ Star Pattern Printer ([`pattern.mlang`](file:///C:/Users/sg938/MultiLangEngine/pattern.mlang))
```bash
mlang pattern.mlang
```

### 4. 🇮🇳 Hinglish Demo ([`demo.mlang`](file:///C:/Users/sg938/MultiLangEngine/demo.mlang))
```bash
mlang demo.mlang
```

### 5. 🪔 Punjabi Demo ([`punjabi_demo.mlang`](file:///C:/Users/sg938/MultiLangEngine/punjabi_demo.mlang))
```bash
mlang punjabi_demo.mlang
```

### 6. 🕉️ Sanskrit Demo ([`sanskrit_demo.mlang`](file:///C:/Users/sg938/MultiLangEngine/sanskrit_demo.mlang))
```bash
mlang sanskrit_demo.mlang
```

### 7. 🧢 Gen Z Slang Demo ([`genz_demo.mlang`](file:///C:/Users/sg938/MultiLangEngine/genz_demo.mlang))
```bash
mlang genz_demo.mlang
```

---

## ⚙️ 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
