Metadata-Version: 2.4
Name: mozhix
Version: 1.0.0
Summary: A programming language with Tamil syntax
Author: Ajay R
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# MozhiX (மொழிஎக்ஸ்) 🚀

**MozhiX** is a modern programming language with **Tamil syntax**, implemented in Python. It allows developers and students to write code using their native Tamil language, making programming more accessible and intuitive.

---

## 🌟 Features

- **Tamil Native Syntax**: Keywords like `எண்`, `செயல்பாடு`, and `ஆனால்` make code readable for Tamil speakers.
- **Complete Pipeline**: Features a custom Lexer, Parser, and Interpreter.
- **Unicode Support**: Fully supports Tamil characters in identifiers and strings.
- **Cross-Platform**: Runs anywhere Python is installed.
- **Tamil Error Messages**: Understand exactly what went wrong in your own language.

---

## ⌨️ Syntax Preview

```mozhi
# ஒரு எளிய செயல்பாடு (A simple function)
செயல்பாடு வணக்கம்(பெயர்) {
    அச்சிடு("வணக்கம் " + பெயர் + "!");
}

வணக்கம்("உலகமே");

# கட்டுப்பாடு மற்றும் சுழற்சி (Control and Loops)
எண் வயது = 18;
ஆனால் (வயது >= 18) {
    அச்சிடு("நீங்கள் வாக்களிக்கலாம்");
}
```

---

## 🚀 Getting Started

### Installation

You can install MozhiX locally using `pip`:

```bash
git clone https://github.com/yourusername/MozhiX.git
cd MozhiX
pip install .
```

### Running Your First Program

Create a file named `hello.mozhi`:
```mozhi
அச்சிடு("வாழ்க தமிழ்!");
```

Run it using the `mozhix` command:
```bash
mozhix hello.mozhi
```

### Interactive Shell (REPL)

Simply run `mozhix` without arguments to enter the interactive shell:
```bash
mozhix
mozhi> எண் அ = 10;
mozhi> அச்சிடு(அ + 5);
15
```

---

## 📚 Keywords Cheat Sheet

| Tamil | English | Description |
| :--- | :--- | :--- |
| `எண்` | `int` | Integer type |
| `மெய்` | `float` | Floating point type |
| `உரை` | `string` | String type |
| `ஆனால்` | `if` | If condition |
| `இல்லையெனில்` | `else` | Else condition |
| `வரை` | `while` | While loop |
| `செயல்பாடு` | `def/func` | Function definition |
| `அச்சிடு` | `print` | Output to console |
| `உள்ளீடு` | `input` | Input from user |
| `திரும்பு` | `return` | Return from function |

---

## 🛠️ Project Structure

- `lexer.py`: Tokenizes Tamil source code.
- `parser.py`: Generates the Abstract Syntax Tree (AST).
- `interpreter.py`: Executes the AST nodes.
- `main.py`: CLI and REPL entry point.

---

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 📄 License

This project is licensed under the MIT License.
