# 🌀 SaLangDev — The Simple Abstract Language for Developers
**Version:** 1.0.0
**Author:** *Salman Fareed Chishty*
**License:** MIT
**Extension:** `.salangdev`
---
## 📖 Introduction
**SaLangDev (Simple Abstract Language for Developers)** is a lightweight and beginner-friendly programming language designed to show **how interpreters and languages work internally**.
Built entirely in **Python**, SaLangDev lets you write small programs using **human-friendly commands** instead of traditional syntax.
The purpose of SaLangDev is **education**, **experimentation**, and **inspiration** — a great tool for learning the basics of language design and execution.
---
## ✨ Features
✅ **Custom Syntax:** Write programs using commands like `digit`, `letters`, and `outcome`.
✅ **Python-Powered Execution:** SaLangDev converts your code into Python and runs it instantly.
✅ **No Dependencies:** 100% pure Python — just install and run.
✅ **.salangdev File Support:** Run your own `.salangdev` scripts directly from the terminal.
✅ **Extensible:** Add new keywords or grammar rules easily.
---
## 🧠 SaLangDev Syntax
| SaLangDev Keyword | Meaning / Python Equivalent |
| ----------------- | --------------------------- |
| `digit` | `int` (integer values) |
| `one_letter` | `char` (single character) |
| `letters` | `str` (string type) |
| `outcome` | `print()` function |
| `+ - * /` | Same as Python operators |
| `=` | Assignment operator |
| `#` | Comment indicator |
---
## 💡 Example Program
```salangdev
# SaLangDev Example
digit x = 10
letters name = "Salman"
outcome("Welcome to SaLangDev!")
outcome(name)
outcome(x + 5)
```
### Output:
```
Welcome to SaLangDev!
Salman
15
```
---
## ⚙️ Installation
You can install SaLangDev directly from [PyPI](https://pypi.org/project/salangdev/) using:
```bash
pip install salangdev
```
---
## ▶️ Usage
Create a new file:
```bash
nano test.salangdev
```
Write:
```salangdev
outcome("Hello from SaLangDev!")
```
Then run it:
```bash
salangdev test.salangdev
```
Output:
```
Hello from SaLangDev!
```
---
## 🧩 Supported Data Types
| Type Keyword | Description | Example |
| ------------ | ---------------- | --------------------------- |
| `digit` | Integer values | `digit age = 25` |
| `letters` | Strings or text | `letters msg = "Hi there!"` |
| `one_letter` | Single character | `one_letter grade = 'A'` |
---
## 🔍 Internal Working
When you execute a `.salangdev` file, the interpreter:
1. Reads the file line by line.
2. Replaces SaLangDev keywords with their Python equivalents.
3. Runs the translated Python code.
For example:
```
digit x = 5
outcome(x)
```
Internally becomes:
```python
x = int(5)
print(x)
```
---
## 🧑💻 Development & Contribution
Contributions are welcome! You can:
* Add new keywords like `repeat`, `loop`, or `if`
* Improve parsing logic
* Add error handling and debugging
* Extend the runtime
To contribute:
```bash
git clone https://github.com/<yourusername>/salangdev
cd salangdev
pip install -e .
```
Then test:
```bash
salangdev examples/hello.salangdev
```
---
## 🧰 Future Roadmap
🚧 Planned Features:
* Control structures (`if`, `loop`)
* String concatenation and interpolation
* File I/O support
* Error tracking and debugging mode
* Graphical editor for SaLangDev programs
---
## 📜 License
```
MIT License
Copyright (c) 2025 Salman Fareed
```
You are free to use, modify, and distribute SaLangDev with proper attribution.
---
## ❤️ Credits
Developed by **Salman Fareed Chishty**
📍 Lahore Garrison University (LGU)
🎯 Inspired by curiosity and passion for software construction.
---
## 🌐 Links
🔗 **PyPI:** [https://pypi.org/project/salangdev](https://pypi.org/project/salangdev)
🔗 **GitHub:** *(Add your GitHub repo link here)*
🔗 **Author:** [Salman Fareed Chishty](https://www.linkedin.com/in/salmanfareedchishty)
Raw data
{
"_id": null,
"home_page": null,
"name": "salangdev",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "language interpreter education salang programming",
"author": "Salman Fareed Chishty",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f3/16/8e315a6e28a1e4e77a33bcf0b72399d1d2c4be9a8449fbafef802188ac82/salangdev-1.0.3.tar.gz",
"platform": null,
"description": "# \ud83c\udf00 SaLangDev \u2014 The Simple Abstract Language for Developers\r\n\r\n**Version:** 1.0.0\r\n**Author:** *Salman Fareed Chishty*\r\n**License:** MIT\r\n**Extension:** `.salangdev`\r\n\r\n---\r\n\r\n## \ud83d\udcd6 Introduction\r\n\r\n**SaLangDev (Simple Abstract Language for Developers)** is a lightweight and beginner-friendly programming language designed to show **how interpreters and languages work internally**.\r\n\r\nBuilt entirely in **Python**, SaLangDev lets you write small programs using **human-friendly commands** instead of traditional syntax.\r\n\r\nThe purpose of SaLangDev is **education**, **experimentation**, and **inspiration** \u2014 a great tool for learning the basics of language design and execution.\r\n\r\n---\r\n\r\n## \u2728 Features\r\n\r\n\u2705 **Custom Syntax:** Write programs using commands like `digit`, `letters`, and `outcome`.\r\n\u2705 **Python-Powered Execution:** SaLangDev converts your code into Python and runs it instantly.\r\n\u2705 **No Dependencies:** 100% pure Python \u2014 just install and run.\r\n\u2705 **.salangdev File Support:** Run your own `.salangdev` scripts directly from the terminal.\r\n\u2705 **Extensible:** Add new keywords or grammar rules easily.\r\n\r\n---\r\n\r\n## \ud83e\udde0 SaLangDev Syntax\r\n\r\n| SaLangDev Keyword | Meaning / Python Equivalent |\r\n| ----------------- | --------------------------- |\r\n| `digit` | `int` (integer values) |\r\n| `one_letter` | `char` (single character) |\r\n| `letters` | `str` (string type) |\r\n| `outcome` | `print()` function |\r\n| `+ - * /` | Same as Python operators |\r\n| `=` | Assignment operator |\r\n| `#` | Comment indicator |\r\n\r\n---\r\n\r\n## \ud83d\udca1 Example Program\r\n\r\n```salangdev\r\n# SaLangDev Example\r\ndigit x = 10\r\nletters name = \"Salman\"\r\n\r\noutcome(\"Welcome to SaLangDev!\")\r\noutcome(name)\r\noutcome(x + 5)\r\n```\r\n\r\n### Output:\r\n\r\n```\r\nWelcome to SaLangDev!\r\nSalman\r\n15\r\n```\r\n\r\n---\r\n\r\n## \u2699\ufe0f Installation\r\n\r\nYou can install SaLangDev directly from [PyPI](https://pypi.org/project/salangdev/) using:\r\n\r\n```bash\r\npip install salangdev\r\n```\r\n\r\n---\r\n\r\n## \u25b6\ufe0f Usage\r\n\r\nCreate a new file:\r\n\r\n```bash\r\nnano test.salangdev\r\n```\r\n\r\nWrite:\r\n\r\n```salangdev\r\noutcome(\"Hello from SaLangDev!\")\r\n```\r\n\r\nThen run it:\r\n\r\n```bash\r\nsalangdev test.salangdev\r\n```\r\n\r\nOutput:\r\n\r\n```\r\nHello from SaLangDev!\r\n```\r\n\r\n---\r\n\r\n## \ud83e\udde9 Supported Data Types\r\n\r\n| Type Keyword | Description | Example |\r\n| ------------ | ---------------- | --------------------------- |\r\n| `digit` | Integer values | `digit age = 25` |\r\n| `letters` | Strings or text | `letters msg = \"Hi there!\"` |\r\n| `one_letter` | Single character | `one_letter grade = 'A'` |\r\n\r\n---\r\n\r\n## \ud83d\udd0d Internal Working\r\n\r\nWhen you execute a `.salangdev` file, the interpreter:\r\n\r\n1. Reads the file line by line.\r\n2. Replaces SaLangDev keywords with their Python equivalents.\r\n3. Runs the translated Python code.\r\n\r\nFor example:\r\n\r\n```\r\ndigit x = 5\r\noutcome(x)\r\n```\r\n\r\nInternally becomes:\r\n\r\n```python\r\nx = int(5)\r\nprint(x)\r\n```\r\n\r\n---\r\n\r\n## \ud83e\uddd1\u200d\ud83d\udcbb Development & Contribution\r\n\r\nContributions are welcome! You can:\r\n\r\n* Add new keywords like `repeat`, `loop`, or `if`\r\n* Improve parsing logic\r\n* Add error handling and debugging\r\n* Extend the runtime\r\n\r\nTo contribute:\r\n\r\n```bash\r\ngit clone https://github.com/<yourusername>/salangdev\r\ncd salangdev\r\npip install -e .\r\n```\r\n\r\nThen test:\r\n\r\n```bash\r\nsalangdev examples/hello.salangdev\r\n```\r\n\r\n---\r\n\r\n## \ud83e\uddf0 Future Roadmap\r\n\r\n\ud83d\udea7 Planned Features:\r\n\r\n* Control structures (`if`, `loop`)\r\n* String concatenation and interpolation\r\n* File I/O support\r\n* Error tracking and debugging mode\r\n* Graphical editor for SaLangDev programs\r\n\r\n---\r\n\r\n## \ud83d\udcdc License\r\n\r\n```\r\nMIT License\r\nCopyright (c) 2025 Salman Fareed\r\n```\r\n\r\nYou are free to use, modify, and distribute SaLangDev with proper attribution.\r\n\r\n---\r\n\r\n## \u2764\ufe0f Credits\r\n\r\nDeveloped by **Salman Fareed Chishty**\r\n\ud83d\udccd Lahore Garrison University (LGU)\r\n\ud83c\udfaf Inspired by curiosity and passion for software construction.\r\n\r\n---\r\n\r\n## \ud83c\udf10 Links\r\n\r\n\ud83d\udd17 **PyPI:** [https://pypi.org/project/salangdev](https://pypi.org/project/salangdev)\r\n\ud83d\udd17 **GitHub:** *(Add your GitHub repo link here)*\r\n\ud83d\udd17 **Author:** [Salman Fareed Chishty](https://www.linkedin.com/in/salmanfareedchishty)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "SaLangDev - A tiny educational programming language (digit, one_letter, letters, outcome)",
"version": "1.0.3",
"project_urls": null,
"split_keywords": [
"language",
"interpreter",
"education",
"salang",
"programming"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "87187c82dcaf8577902095a86c369329365cd9680ff746ddcbb0e32b376e2d2b",
"md5": "d1f6f42c42947fdeb90481bd9a710042",
"sha256": "867c76a45795cf2b9d8f05a92879f2cbc24f7d37e0547904f7016161b2e3070c"
},
"downloads": -1,
"filename": "salangdev-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1f6f42c42947fdeb90481bd9a710042",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 6920,
"upload_time": "2025-10-23T18:38:28",
"upload_time_iso_8601": "2025-10-23T18:38:28.444247Z",
"url": "https://files.pythonhosted.org/packages/87/18/7c82dcaf8577902095a86c369329365cd9680ff746ddcbb0e32b376e2d2b/salangdev-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f3168e315a6e28a1e4e77a33bcf0b72399d1d2c4be9a8449fbafef802188ac82",
"md5": "1d98610c3c68cfd24844fa2cea7e08bd",
"sha256": "b91408132217323547abca7f1b802940c9825859b01523a46bf05b5ff469792d"
},
"downloads": -1,
"filename": "salangdev-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "1d98610c3c68cfd24844fa2cea7e08bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 6572,
"upload_time": "2025-10-23T18:38:29",
"upload_time_iso_8601": "2025-10-23T18:38:29.706646Z",
"url": "https://files.pythonhosted.org/packages/f3/16/8e315a6e28a1e4e77a33bcf0b72399d1d2c4be9a8449fbafef802188ac82/salangdev-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-23 18:38:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "salangdev"
}
JSON