# Sanskritayam Programming Language
Sanskritayam is a fun and experimental programming language inspired by Sanskrit, the ancient language of India. This project was created based on a viral meme from last year, where a group of aunties were discussing the idea of making Sanskrit a coding language. As a joke, my friend [Pinakkk](https://github.com/pinakkk) and I thought of turning this idea into reality, and thus, Sanskritayam was born!
Please note that Sanskritayam is not intended for serious production use and comes with no warranty. It's a purely recreational project meant for learning and entertainment purposes.
## Features
- Sanskrit-inspired syntax and keywords
- Basic programming constructs like variables, conditionals, loops, and functions
- Support for common data types such as integers, floats, strings, lists, and dictionaries
- File I/O operations
- Exception handling
- Object-oriented programming concepts
- Write "Swaha" to have some extra fun!
## Getting Started Using Repo
To get started with Sanskritayam, follow these steps:
1. Clone the repository:
```
git clone https://github.com/thtskaran/sanskritayam.git
```
2. Install Python 3.x if you haven't already.
3. Navigate to the directory containing the setup.py file:
```
cd sanskritayam
4. Install the Sanskritayam interpreter:
```
pip install -e .
## Getting Started Using PyPi Releases
Alternatively you can install the latest release from PyPi using `pip install sanskritayam` command .
## Executing .skt Files
Whatever way you opted to install Sanskritayam now you should be able to execute .skt codes right away , choose the way most suited :
1. Non-Sudo Installation
If you didnt use `sudo` privelleges while installation , sanskritayam wont be in your `$PATH` , and you must use it in this way :
```
python -m sanskritayam <filename.skt>
2. Sudo Installation
If you used `sudo` while installation of sanskritayam you should be able to use it right away without explicitly using `python -m`
```
sanskrityam <filename.skt>
## Updating Sanskritayam
If Sanskritayam interpreter is updated on GitHub and want to update your local installation, follow either ways:
1. Pull the latest changes from GitHub:
```
git pull origin main
Replace `main` with the name of the branch that contains the updated Sanskritayam interpreter, if it's not the main branch.
Reinstall the Sanskritayam interpreter:
```
pip install --upgrade --force-reinstall -e .
Now, your local installation of the Sanskritayam interpreter should be updated with the latest changes from GitHub.
2. Pull the latest release from PyPi:
```
pip install --upgrade sanskritayam
Now, you should have the latest release of sanskritayam which was published on PyPi (could be a downstream version , but the most stable one.)
## Documentation
Sanskritayam has a simple and intuitive syntax inspired by Sanskrit words and concepts. Here's an overview of the language's syntax and usage:
### Swaha Ability
To give your code more extraordinary looks! you can try writing "swaha" after each line of code!
Note :
- You should not use "swaha" inside any functions nor with when writing functions.
- You can use the "swaha" at the end of the line when calling a function. (Use cases are mentioned below in the docucmentation)
- You cannot use swaha with if(yadi) and else(anyatha).
- The "swaha" is not mandatory for the user to write but you can write it to make your coding more fun!
### Variables and Data Types
To declare a variable in Sanskritayam, you can use the following syntax:
```
<variable_name> = <value> swaha
```
The "swaha" is not mandatory for the user to write but you can write it to make your coding more fun!
For example:
```
ganakah = 42
```
Sanskritayam supports various data types, including:
- Integers (`ganakah`)
- Floats (`chhedakah`)
- Strings (`aksharankhyata`)
- Lists (`samhata`)
- Dictionaries (`nirukti`)
### Control Flow
Sanskritayam includes control flow statements like conditional statements and loops:
#### Conditional Statements
```
yadi <condition>:
# code block
anyatha:
# code block
```
You can also use the `athavayadi` statement for else-if conditions.
#### Loops
For loops:
```
krte <variable> antargatam <iterable>:
# code block
```
While loops:
```
jabtak <condition>:
# code block
```
### Functions
To define a function in Sanskritayam, use the `paribhasha` keyword:
```
paribhasha <function_name>(<arguments>):
# function body
pratyahar <return_value>
```
To call a function, simply use its name followed by parentheses with the arguments:
You can also use the "swaha" ability here -->
```
<function_name>(<arguments>) swaha
```
### File I/O
Sanskritayam allows you to read from and write to files using the following functions:
```
ayatah "<file_path>", "r" yatha patham:
# read from the file
```
```
ayatah "<file_path>", "w" yatha lekhyam:
# write to the file
```
### Exception Handling
Sanskritayam provides exception handling capabilities using the `prayatnah`, `apavadah`, and `antatah` keywords:
```
prayatnah:
# code that might raise an exception
apavadah <exception_type>:
# exception handling code
antatah:
# code that will always execute
```
### Object-Oriented Programming
Sanskritayam supports object-oriented programming concepts like classes and objects:
```
vargah <class_name>:
# class body
# Creating an instance of the class
samskritayam = <class_name>()
```
To learn how to write code in Sanskritayam, check out the [usage guide](docs/docs.md).
## Examples
You can find various example programs written in Sanskritayam in the [examples](examples/) directory. These examples demonstrate different aspects of the language and serve as a starting point for learning Sanskritayam.
## Testing
To ensure the correctness and reliability of the Sanskritayam language, a comprehensive test suite is available in the [tests](tests/) directory. The test suite covers various language features and helps maintain the integrity of the language implementation.
To run the tests, execute the following command:
`python -m skm tests/sanskritayam_comprehensive_test.skt`
## License
The Sanskritayam programming language is released under the [Apache License 2.0]([LICENSE](https://www.apache.org/licenses/LICENSE-2.0)). Feel free to use, modify, and distribute the language according to the terms of the license.
## Disclaimer
Sanskritayam is a joke programming language created for fun and learning purposes. It is not recommended for use in production environments, and no warranty or support is provided. Use it at your own risk!
If anyone feels offended or uncomfortable with the concept or any aspect of this project, we sincerely apologize. Our intention is not to mock or disrespect any language, culture, political party, or religion. It's purely a lighthearted attempt to explore the idea of creating a programming language based on Sanskrit.
## Acknowledgements
We would like to acknowledge the creators of the viral meme that inspired this project. Their humorous discussion sparked the idea of creating Sanskritayam, and we are grateful for the laughter and inspiration they provided.
Special thanks to [Pinakkk](https://github.com/pinakkk) for his invaluable contributions and collaboration in bringing Sanskritayam to life. His creativity, technical expertise, and sense of humor have been instrumental in shaping this project.
We also want to acknowledge that we may have unintentionally caused offense or hurt sentiments with this project. We deeply apologize if this is the case. Please read our [full apology and explanation](/docs/apology.md) in the documentation.
## Contributing
As Sanskritayam is a fun and experimental project, we welcome contributions from the community. If you have any ideas, suggestions, or improvements, feel free to open an issue or submit a pull request on the [GitHub repository](https://github.com/thtskaran/sanskritayam).
Let's have fun coding in Sanskritayam and embrace the quirks and joys of this unique language!
Raw data
{
"_id": null,
"home_page": null,
"name": "sanskritayam",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, sanskritayam, skm, skt, thtskaran, sabskrit, language, transpiler",
"author": "thtskaran",
"author_email": "<hello@karanprasad.com>",
"download_url": "https://files.pythonhosted.org/packages/b6/fb/82fba2322c90f2365bc79b9a541b0a8f5469009d0ba6ef357fbde4614b29/sanskritayam-0.0.25.tar.gz",
"platform": null,
"description": "\n\n# Sanskritayam Programming Language\n\nSanskritayam is a fun and experimental programming language inspired by Sanskrit, the ancient language of India. This project was created based on a viral meme from last year, where a group of aunties were discussing the idea of making Sanskrit a coding language. As a joke, my friend [Pinakkk](https://github.com/pinakkk) and I thought of turning this idea into reality, and thus, Sanskritayam was born!\n\n\n\nPlease note that Sanskritayam is not intended for serious production use and comes with no warranty. It's a purely recreational project meant for learning and entertainment purposes.\n\n## Features\n\n- Sanskrit-inspired syntax and keywords\n- Basic programming constructs like variables, conditionals, loops, and functions\n- Support for common data types such as integers, floats, strings, lists, and dictionaries\n- File I/O operations\n- Exception handling\n- Object-oriented programming concepts\n- Write \"Swaha\" to have some extra fun!\n\n## Getting Started Using Repo\n\nTo get started with Sanskritayam, follow these steps:\n\n1. Clone the repository:\n ```\n git clone https://github.com/thtskaran/sanskritayam.git\n ```\n2. Install Python 3.x if you haven't already.\n\n3. Navigate to the directory containing the setup.py file:\n ```\n cd sanskritayam\n4. Install the Sanskritayam interpreter:\n ```\n pip install -e .\n\n## Getting Started Using PyPi Releases\nAlternatively you can install the latest release from PyPi using `pip install sanskritayam` command .\n\n\n## Executing .skt Files \nWhatever way you opted to install Sanskritayam now you should be able to execute .skt codes right away , choose the way most suited :\n1. Non-Sudo Installation \nIf you didnt use `sudo` privelleges while installation , sanskritayam wont be in your `$PATH` , and you must use it in this way :\n ```\n python -m sanskritayam <filename.skt>\n2. Sudo Installation\nIf you used `sudo` while installation of sanskritayam you should be able to use it right away without explicitly using `python -m` \n ```\n sanskrityam <filename.skt>\n\n## Updating Sanskritayam\n\nIf Sanskritayam interpreter is updated on GitHub and want to update your local installation, follow either ways:\n\n1. Pull the latest changes from GitHub:\n ```\n git pull origin main\n\nReplace `main` with the name of the branch that contains the updated Sanskritayam interpreter, if it's not the main branch.\n\nReinstall the Sanskritayam interpreter:\n\n ```\n pip install --upgrade --force-reinstall -e .\n\nNow, your local installation of the Sanskritayam interpreter should be updated with the latest changes from GitHub.\n\n2. Pull the latest release from PyPi:\n ```\n pip install --upgrade sanskritayam\nNow, you should have the latest release of sanskritayam which was published on PyPi (could be a downstream version , but the most stable one.)\n\n\n## Documentation\n\nSanskritayam has a simple and intuitive syntax inspired by Sanskrit words and concepts. Here's an overview of the language's syntax and usage:\n\n### Swaha Ability \nTo give your code more extraordinary looks! you can try writing \"swaha\" after each line of code!\nNote : \n- You should not use \"swaha\" inside any functions nor with when writing functions. \n- You can use the \"swaha\" at the end of the line when calling a function. (Use cases are mentioned below in the docucmentation)\n- You cannot use swaha with if(yadi) and else(anyatha).\n- The \"swaha\" is not mandatory for the user to write but you can write it to make your coding more fun!\n\n### Variables and Data Types\n\nTo declare a variable in Sanskritayam, you can use the following syntax:\n\n```\n<variable_name> = <value> swaha\n```\n\nThe \"swaha\" is not mandatory for the user to write but you can write it to make your coding more fun!\n\nFor example:\n\n```\nganakah = 42\n```\n\nSanskritayam supports various data types, including:\n\n- Integers (`ganakah`)\n- Floats (`chhedakah`)\n- Strings (`aksharankhyata`)\n- Lists (`samhata`)\n- Dictionaries (`nirukti`)\n\n### Control Flow\n\nSanskritayam includes control flow statements like conditional statements and loops:\n\n#### Conditional Statements\n\n```\nyadi <condition>:\n # code block\nanyatha:\n # code block\n```\n\nYou can also use the `athavayadi` statement for else-if conditions.\n\n#### Loops\n\nFor loops:\n\n```\nkrte <variable> antargatam <iterable>:\n # code block\n```\n\nWhile loops:\n\n```\njabtak <condition>:\n # code block\n```\n\n### Functions\n\nTo define a function in Sanskritayam, use the `paribhasha` keyword:\n\n```\nparibhasha <function_name>(<arguments>):\n # function body\n pratyahar <return_value>\n```\n\nTo call a function, simply use its name followed by parentheses with the arguments:\n\nYou can also use the \"swaha\" ability here -->\n\n```\n<function_name>(<arguments>) swaha\n```\n\n\n### File I/O\n\nSanskritayam allows you to read from and write to files using the following functions:\n\n```\nayatah \"<file_path>\", \"r\" yatha patham:\n # read from the file\n```\n\n```\nayatah \"<file_path>\", \"w\" yatha lekhyam:\n # write to the file\n```\n\n### Exception Handling\n\nSanskritayam provides exception handling capabilities using the `prayatnah`, `apavadah`, and `antatah` keywords:\n\n```\nprayatnah:\n # code that might raise an exception\napavadah <exception_type>:\n # exception handling code\nantatah:\n # code that will always execute\n```\n\n### Object-Oriented Programming\n\nSanskritayam supports object-oriented programming concepts like classes and objects:\n\n```\nvargah <class_name>:\n # class body\n\n# Creating an instance of the class\nsamskritayam = <class_name>()\n```\n\n\nTo learn how to write code in Sanskritayam, check out the [usage guide](docs/docs.md).\n\n## Examples\n\nYou can find various example programs written in Sanskritayam in the [examples](examples/) directory. These examples demonstrate different aspects of the language and serve as a starting point for learning Sanskritayam.\n\n## Testing\n\nTo ensure the correctness and reliability of the Sanskritayam language, a comprehensive test suite is available in the [tests](tests/) directory. The test suite covers various language features and helps maintain the integrity of the language implementation.\n\nTo run the tests, execute the following command:\n `python -m skm tests/sanskritayam_comprehensive_test.skt`\n\n## License\n\nThe Sanskritayam programming language is released under the [Apache License 2.0]([LICENSE](https://www.apache.org/licenses/LICENSE-2.0)). Feel free to use, modify, and distribute the language according to the terms of the license.\n\n## Disclaimer\n\nSanskritayam is a joke programming language created for fun and learning purposes. It is not recommended for use in production environments, and no warranty or support is provided. Use it at your own risk!\n\nIf anyone feels offended or uncomfortable with the concept or any aspect of this project, we sincerely apologize. Our intention is not to mock or disrespect any language, culture, political party, or religion. It's purely a lighthearted attempt to explore the idea of creating a programming language based on Sanskrit.\n\n## Acknowledgements\n\nWe would like to acknowledge the creators of the viral meme that inspired this project. Their humorous discussion sparked the idea of creating Sanskritayam, and we are grateful for the laughter and inspiration they provided.\n\nSpecial thanks to [Pinakkk](https://github.com/pinakkk) for his invaluable contributions and collaboration in bringing Sanskritayam to life. His creativity, technical expertise, and sense of humor have been instrumental in shaping this project.\n\nWe also want to acknowledge that we may have unintentionally caused offense or hurt sentiments with this project. We deeply apologize if this is the case. Please read our [full apology and explanation](/docs/apology.md) in the documentation.\n\n## Contributing\n\nAs Sanskritayam is a fun and experimental project, we welcome contributions from the community. If you have any ideas, suggestions, or improvements, feel free to open an issue or submit a pull request on the [GitHub repository](https://github.com/thtskaran/sanskritayam).\n\nLet's have fun coding in Sanskritayam and embrace the quirks and joys of this unique language!\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Sanskritayam to Python translator",
"version": "0.0.25",
"project_urls": null,
"split_keywords": [
"python",
" sanskritayam",
" skm",
" skt",
" thtskaran",
" sabskrit",
" language",
" transpiler"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "963c9dc5713d0ddcdd3d8d65b78085e5a4ff215c59f101e1a8a3cfaf711f7cff",
"md5": "7ebe7d42b053678f92d9081b5786b814",
"sha256": "0438c42beb5336f47ede4366ed6c8805d7f199a4945c3912881bc2e8251c2d06"
},
"downloads": -1,
"filename": "sanskritayam-0.0.25-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ebe7d42b053678f92d9081b5786b814",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7104,
"upload_time": "2024-03-26T06:02:47",
"upload_time_iso_8601": "2024-03-26T06:02:47.576001Z",
"url": "https://files.pythonhosted.org/packages/96/3c/9dc5713d0ddcdd3d8d65b78085e5a4ff215c59f101e1a8a3cfaf711f7cff/sanskritayam-0.0.25-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b6fb82fba2322c90f2365bc79b9a541b0a8f5469009d0ba6ef357fbde4614b29",
"md5": "9a8c955deb0cab7b6dbd8ef41a2378df",
"sha256": "e64e9eeb4e573bae0f3cab69deef014f91f33928d1221433f046f6e4795dff15"
},
"downloads": -1,
"filename": "sanskritayam-0.0.25.tar.gz",
"has_sig": false,
"md5_digest": "9a8c955deb0cab7b6dbd8ef41a2378df",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 8355,
"upload_time": "2024-03-26T06:02:49",
"upload_time_iso_8601": "2024-03-26T06:02:49.522183Z",
"url": "https://files.pythonhosted.org/packages/b6/fb/82fba2322c90f2365bc79b9a541b0a8f5469009d0ba6ef357fbde4614b29/sanskritayam-0.0.25.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-26 06:02:49",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sanskritayam"
}
JSON