🇮🇳 KemLang ✨

A Gujarati-Inspired Toy Programming Language with a Smile 😄

KemLang makes programming fun, cultural, and beginner-friendly. Blending playful Gujarati syntax with modern tools, it's perfect for learners who want to code in a language that feels close to home.

---

🌟 Features You’ll Love

• ✅ Gujarati-style syntax (sharu, samaapt, lakho, etc.)
• 🧠 Simple, English-like constructs to help beginners get started fast
• 🚀 Complete interpreter pipeline (Lexer → Parser → Evaluator)
• 💻 CLI support for executing .kem files effortlessly
• 🌐 Web API powered by FastAPI for remote execution
• 🤪 Playful Gujarati error messages for a cultural twist

💬 “Kem cho, developer? Let’s make code feel like garba!”

---

📦 Installation

Get started in seconds with either of these:

🧰 Option 1: Install globally

npm install -g kemlang

⚡ Option 2: Run instantly with npx

npx kemlang yourfile.kem

---

🎯 Quick Example

👩‍💻 Let’s write your first KemLang program!

1. Create hello.kem

sharu {
  do naam = "KemLang";
  lakho("Kem cho " + naam);
} samaapt

2. Run it

kemlang hello.kem

3. Output

Kem cho KemLang

👏 That’s it! You just coded in KemLang!

---

📜 Language Reference

💬 English	💻 KemLang Syntax
Start Block	sharu {
End Block	} samaapt
Print Statement	lakho()
Print Example	lakho("Hello");
Variable	do
Variable Ex.	do x = 10;
If / Else	jo / nahitar
If Example	jo (x > 5) {}
While Loop	jyaare
While Example	jyaare (x < 5) {}

📖 Pro Tip: It’s not just code. It’s a varta (story) your computer understands!

---

🛠 Development

Want to contribute or hack around? Here’s how:

1. Clone the repo

git clone https://github.com/yourusername/kemlang.git

2. Install dependencies

npm install

3. Run the test suite

npm test

4. Run locally in VS Code

Frontend

• Open the terminal in VS Code (Ctrl + ~ or Cmd + ~).
• Navigate to the frontend directory (e.g., cd frontend if applicable).
• Run the frontend development server:

npm run dev

• Open your browser and go to the URL displayed in the terminal (usually http://localhost:3000).

Backend

• Open a new terminal in VS Code.
• Navigate to the backend directory (e.g., cd backend if applicable).
• Ensure you have Python and FastAPI installed. If not, install dependencies:

pip install fastapi uvicorn

• Run the backend server with auto-reload:

uvicorn cli:app --reload

• The API will be available at http://localhost:8000 (or the port specified in your configuration).

---

📄 License

This project is licensed under the MIT License. See LICENSE for full details.

---

🙏 Credits

KemLang is lovingly inspired by:

• 🧑‍🤝‍🧑 BhaiLang
• 🌍 The Vernacular Programming Movement
• ⚓️ Gujarati Culture & Language

---

💫 Kem cho? Happy Coding! 🙌

Let your code speak your culture 🧡