Awesome
<img src="/lib/images/README-EggPeggy.png" align="center"/> <h1 align="center">Legesher's Python Support for Atom</h1> <blockquote align="center">💻 Code in Python 🐍using your native written ✏️language.</blockquote> <p align="center">Programming with <b>Legesher</b>'s dev tools empowers any developer to create without losing the art of innovation 💡, creativity 🎨, or collaboration 🤝 in translation. </p> <!-- DEVELOPMENT BADGES --> <p align="center" style="margin-bottom: 5px; margin-top: 5px;"> <a href="https://github.com/legesher/language-legesher-python/actions/workflows/ci.yml"> <img src="https://github.com/legesher/language-legesher-python/actions/workflows/ci.yml/badge.svg?style=flat-square&labelColor=black&logoColor=white" alt="CI Build"></a> <a href="https://david-dm.org/legesher/language-legesher-python"> <img src="https://img.shields.io/david/legesher/language-legesher-python?style=flat-square&labelColor=black" alt="David Dependency Status"></a> <a href="http://makeapullrequest.com"> <img src="https://img.shields.io/badge/pull_requests-welcome-brightgreen.svg?style=flat-square&labelColor=black" alt="Pull Requests Welcome"></a> <a href="https://github.com/legesher/language-legesher-python/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22"> <img src="https://img.shields.io/badge/first--timers--only-friendly-success.svg?style=flat-square&labelColor=black" alt="First Timers Only"></a> </p> <!-- SUPPORT BADGES --> <p align="center" style="margin-bottom: 5px;> <a href="https://github.com/legesher/language-legesher-python" alt="Repository"> <img src="https://img.shields.io/badge/Language_Legesher_Python-0.58.3-f58977.svg?style=flat-square&labelColor=black&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNTAxLjE3IDUwMS4xNyI+PGRlZnM+PGNsaXBQYXRoIGlkPSJjbGlwLXBhdGgiPjxlbGxpcHNlIGN4PSIxNzUuMjMiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSJub25lIi8+PC9jbGlwUGF0aD48Y2xpcFBhdGggaWQ9ImNsaXAtcGF0aC0yIj48ZWxsaXBzZSBjeD0iMzI0LjIiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSJub25lIi8+PC9jbGlwUGF0aD48L2RlZnM+PHRpdGxlPlBlZ2d5LUhlYWRzaG90QWxwaGE8L3RpdGxlPjxnIHN0eWxlPSJpc29sYXRpb246aXNvbGF0ZSI+PGcgaWQ9IkxheWVyXzEiIGRhdGEtbmFtZT0iTGF5ZXIgMSI+PHBhdGggZD0iTTE2Mi40OCwzNjRjNzYuODgsNTEuNjUsMzYuNywyNTMuNDYsMjAxLDI1Mi4wOHM3Ni44My05NS4xLDc2LjgzLTk1LjEtMTksNDYuNjctNjguNywxMy41OC03MC0xNDUtNDEuMDktMTY0LjRTMTYyLjQ4LDM2NCwxNjIuNDgsMzY0WiIgZmlsbD0iI2ZmODk3NiIvPjxwYXRoIGQ9Ik0zMjIuNjEsNDU2YzEsMy42NSwyLjA5LDYuMTYsMy4zOSw3LjY5LTEyLjQ0LTQwLTEyLjIxLTgyLjMyLDQuNTYtOTMuNTcsMTQuODUtMTAtMjkuNzYtMTEuMzEtNzYuNzMtMTAuMjhsLTEwLjQyLDUuODYtMywyOS44M1MzMDkuMTUsNDA0LjUxLDMyMi42MSw0NTZaIiBmaWxsPSIjZjQ4ODc3IiBvcGFjaXR5PSIwLjUiIHN0eWxlPSJtaXgtYmxlbmQtbW9kZTptdWx0aXBseSIvPjxjaXJjbGUgY3g9IjI1MC41NSIgY3k9IjI1Ni45MSIgcj0iMTM4LjYyIiBmaWxsPSIjZmY4OTc2Ii8+PGcgY2xpcC1wYXRoPSJ1cmwoI2NsaXAtcGF0aCkiPjxlbGxpcHNlIGN4PSIxNzUuMjMiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSIjZmZmIi8+PGVsbGlwc2UgY3g9IjE4NS4zNyIgY3k9IjI0OS4xNCIgcng9IjMzLjAxIiByeT0iMzguNDMiIGZpbGw9IiMyNjI2MjYiLz48L2c+PGcgY2xpcC1wYXRoPSJ1cmwoI2NsaXAtcGF0aC0yKSI+PGVsbGlwc2UgY3g9IjMyNC4yIiBjeT0iMjUwLjEzIiByeD0iMzUuOTgiIHJ5PSI0MS44OSIgZmlsbD0iI2ZmZiIvPjxlbGxpcHNlIGN4PSIzMTQuMDYiIGN5PSIyNDkuMTQiIHJ4PSIzMy4wMSIgcnk9IjM4LjQzIiBmaWxsPSIjMjYyNjI2Ii8+PC9nPjxwb2x5Z29uIHBvaW50cz0iMTQwLjUzIDI4NC45NCAzNjAuMjggMjg0Ljk0IDMyMi4yMyAzMTYuMDIgMTY3LjkyIDMxOS4yMSAxNDAuNTMgMjg0Ljk0IiBmaWxsPSIjZmY4OTc2Ii8+PHBhdGggZD0iTTE5Ni4zNCwyNzMuN3MyMi4zMy0yNC45Miw1NS0yNC45Miw1My4yNCwyNC45Miw1My4yNCwyNC45Mi0xMiw1Ni40Mi01NC4xLDU2LjQyUzE5Ni4zNCwyNzMuNywxOTYuMzQsMjczLjdaIiBmaWxsPSIjZmJjNDk5Ii8+PHBhdGggZD0iTTE5Ni4zNCwyNzMuN3MyMi4zMy0yNC45Miw1NS0yNC45Miw1My4yNCwyNC45Miw1My4yNCwyNC45Mi0xMiwyOS43LTU0LjEsMjkuN1MxOTYuMzQsMjczLjcsMTk2LjM0LDI3My43WiIgZmlsbD0iI2ZkZTRkMyIvPjxwb2x5Z29uIHBvaW50cz0iMTQ0LjEgMjMzLjg3IDE2Ni4yOCAyNDcuNzQgMTQyLjUxIDI2MC4wMiAxNDQuMSAyMzMuODciIGZpbGw9IiNmZmYiLz48cG9seWdvbiBwb2ludHM9IjM1NS4zMyAyMzMuODcgMzMzLjE0IDI0Ny43NCAzNTYuOTEgMjYwLjAyIDM1NS4zMyAyMzMuODciIGZpbGw9IiNmZmYiLz48cGF0aCBkPSJNMjExLjEsMTIzLjgyczQ1LTIzLDU5LjY5LTIzLDEwLjQ3LDIzLDEwLjQ3LDIzWiIgZmlsbD0iI2ZmODk3NiIvPjxwYXRoIGQ9Ik0zNTIuMzYsMTE0LjY0YTkuNDMsOS40MywwLDAsMSw0LjE1LTE1Ljg5YzYuNDctMS42MSwxNi4xMi0uNzEsMzAuMDgsNy40NiwxOSwxMS4xMSwxOS4zMSwyNy4wNiwxNi4zLDM4LjM2LTEuODMsNi44OS0xMC41Niw5LjEtMTUuNjYsNC4xMloiIGZpbGw9IiMyNjI2MjYiLz48cGF0aCBkPSJNMTU0LjM5LDExNC42NGE5LjQzLDkuNDMsMCwwLDAtNC4xNS0xNS44OWMtNi40Ny0xLjYxLTE2LjEyLS43MS0zMC4wOCw3LjQ2LTE5LDExLjExLTE5LjMxLDI3LjA2LTE2LjMsMzguMzYsMS44Myw2Ljg5LDEwLjU2LDkuMSwxNS42Niw0LjEyWiIgZmlsbD0iIzI2MjYyNiIvPjwvZz48L2c+PC9zdmc+" /></a> <!-- <a href="https://github.com/legesher/language-legesher-python/graphs/contributors" alt="Contributors"> <img src="https://img.shields.io/github/contributors/legesher/language-legesher-python?style=flat-square&color=f58977&labelColor=black" /></a> --> <a href="#the-community" alt="All Contributors"> <img src="https://img.shields.io/badge/all_contributors-8-black?style=flat-square&color=f58977&labelColor=black" /></a> <a href="https://github.com/sponsors/madiedgar" alt="Sponsors on Github"> <img src="https://img.shields.io/badge/sponsor-@madiedgar-black?style=flat-square&color=f58977&labelColor=black" /></a> </p> <!-- SOCIAL BADGES --> <p align="center"> <a href="https://github.com/legesher"> <img src="https://img.shields.io/badge/-Contribute-black?style=flat-square&logo=github&logoColor=7ed2e7" alt="Contribute on Github"></a> <a href="https://twitch.tv/withmadico"> <img src="https://img.shields.io/badge/-Watch-black?style=flat-square&logo=twitch&logoColor=7ed2e7" alt="Watch on Twitch"></a> <a href="https://discord.gg/DkVjVDP"> <img src="https://img.shields.io/badge/-Chat-black?style=flat-square&logo=discord&logoColor=7ed2e7" alt="chat on Discord"></a> <a href="https://www.instagram.com/legesher/"> <img src="https://img.shields.io/badge/-Connect-black?style=flat-square&logo=instagram&logoColor=7ed2e7" alt="follow on Instagram"></a> <a href="https://twitter.com/intent/follow?screen_name=legesherio"> <img src="https://img.shields.io/badge/-Tweet-black?style=flat-square&logo=twitter&logoColor=7ed2e7" alt="follow on Twitter"></a> <a href="https://medium.com/@legesher"> <img src="https://img.shields.io/badge/-Read-black?style=flat-square&logo=medium&logoColor=7ed2e7" alt="Read on Medium"></a> <a href="https://legesher.io"> <img src="https://img.shields.io/badge/-Subscribe-black?style=flat-square&logo=mailchimp&logoColor=7ed2e7" alt="Subscribe on Mailchimp"></a> </p> <!-- SOCIAL MEDIA -->Introduction
language-legesher-python
:loudspeaker: is the written language interchangeable version for proramming in Python in Atom. This apm package (atom package) uses tree-sitter-legesher-python's
grammar to enable you to code in the language you natively use.
📢 Check if your native language is available in the Legesher translation repository! If not, we'd love your help to add it!!
Getting Started
In order to use the language-legesher-python
to code, you will need to follow the following steps:
1️⃣ Download Atom (a text editor)
Head on over to Atom.io to download the latest version of the text editor.
2️⃣ Update Preferences
Once installed on your local computer, open the Atom application. In the options in the top menu bar, navigate to Atom's Settings Atom > Preferences... . A settings window should pop up in your editor.
3️⃣ Disable Atom's language-python
Continue by clicking the Packages section. Here, you'll see a number of items: Installed Packages, Community Packages, Core Packages, Development Packages, Git Packages. Using the search bar, type language-python
to find the Core Package currently installed on your text editor. Click Disable.
4️⃣ Download Legesher's language-legesher-python
Now, head to the Install section to install a new package to your text editor (make sure that the Packages button is selected instead of the Themes). Type language-legesher-python
in the search bar to find Legesher's package, and click Install.
5️⃣ Enable Legesher's language-legesher-python
Sometimes you'll have to enable a newly installed package by clicking the Enable button in the package when it is within the Packages section of the settings.
6️⃣ Write A "Hello World" Program In Your Language
Now, you can start coding in Python using any written language currently available within Legesher's translation library! The syntax highlighting should match as if you were coding Python in English!
def main():
print "Hello World"
Contributing
❤️Legesher relies on the passionate members of its community (both developer and non-developer alike) to keep delivering impactful tools to people all over the world.
Before contributing, be sure to consult Legesher's contribution guidelines and language translation conventions. As a member of our community, you must abide by our Code Of Conduct.
Installation
1️⃣ Fork the legesher/language-legesher-python
repository
Follow these instructions on how to fork a repository
2️⃣ Cloning the repository
Once you have set up your fork of the legesher/language-legesher-python
repository, you'll want to clone it to your local machine. This is so you can make and test all of your personal edits before adding it to the master version of legesher/language-legesher-python
.
Navigate to the location on your computer where you want to host your code. Once in the appropriate folder, run the following command to clone the repository to your local machine.
git clone git@github.com:your-username/language-legesher-python.git
3️⃣ Bootstrapping the repository
You'll then want to navigate within the folder that was just created that contains all of the content of the forked repository. There you'll want to run the installation script to get the updated version of all the dependencies.
cd language-legesher-python
npm install
Development
We love your desire to give back, and want to make the process as welcoming to newcomers and experts as possible. We're working on developing more intuitive tutorials for individuals of all skill levels and expertise, so if you think the community would value from being walked through the steps you're going through please share! ❤️
Test Changes
When you start making changes to the code on your local branch, you'll need to test those changes. Before your code can be accepted into the master branch, it will have to pass all of the tests within /examples/*
. To check the updates made to the grammar, run the following commands:
1️⃣ Save Current Changes
When you get to a point when you want to test the functionality of the code, make sure all your changes are saved. ❗They don't necessarily have to be committed changes in order to test them.
5️⃣ Test changes
To make sure that the grammar is properly updated, run the tests. If you add elements that do not have tests to prove whether they work correctly or not, please include them in your pull request.
apm test
References
This repository is a forked extension of Atom's language-python
. This package works alongside the tree-sitter repository tree-sitter-legesher-python
. These two repositories work closely together, so it may be useful to touch up on both repositories' documentation.
The Python Language
Legesher Projects
Legesher Developer Tools might be useful to you if:
- you are a non-native english speaker
- you are new to programming
- you work on a team with non-native english speakers
Project | Purpose |
---|---|
tree-sitter-legesher-python | Tree-sitter python grammar used by text editors allowing Legesher's languages to be implemented |
language-legesher-python | Atom's programming language binding to allow syntax highlighting, code folding etc. to a specific grammar |
legesher-translations | Host and API of all the language translations for written languages for code keywords / concepts |
legesher-dot-io | Legesher's public website |
legesher-docs | Legesher's documentation hub. Will be transitioning to a documentation host soon. |
legesher | Git integration to collaborate with code and others in other languages |
legesher-pride | A non-programmer's dream to contributing to open source by sharing what they know and learning what's new |
The Community
A message from our founder, Madi:
It is truly a blessing to be surrounded by a community of passionate, driven individuals who love sharing their gifts to creating better products together. Your contribution means the world to me, and keeps me motivated to continue creating. This wouldn't be possible without you. From the bottom of my heart, 💛 THANK YOU!
Meet our community (full of contributors, backers, sponsors, and supporters) that give a little piece of their heart to this project. Thank you so much. (emoji key)
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="http://withmadi.co"><img src="https://avatars0.githubusercontent.com/u/7844510?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Madison (Pfaff) Edgar</b></sub></a><br /><a href="#projectManagement-madiedgar" title="Project Management">📆</a> <a href="https://github.com/legesher/language-legesher-python/commits?author=madiedgar" title="Code">💻</a></td> <td align="center"><a href="https://github.com/sdesani"><img src="https://avatars3.githubusercontent.com/u/10603196?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Santosh Desani</b></sub></a><br /><a href="#marketing-sdesani" title="Marketing - People who help in marketing the repo/project">💌</a></td> <td align="center"><a href="https://www.linkedin.com/in/rajitha-warusavitarana-858a11156/"><img src="https://avatars0.githubusercontent.com/u/36359382?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rajitha Warusavitarana</b></sub></a><br /><a href="https://github.com/legesher/language-legesher-python/commits?author=rajitha1998" title="Code">💻</a></td> <td align="center"><a href="https://Korolr.me/"><img src="https://avatars0.githubusercontent.com/u/11715165?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Alexsey Ramzaev</b></sub></a><br /><a href="https://github.com/legesher/language-legesher-python/commits?author=korolr" title="Documentation">📖</a></td> <td align="center"><a href="https://staticai.blogspot.com"><img src="https://avatars3.githubusercontent.com/u/30810386?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Aakash Singh</b></sub></a><br /><a href="#ideas-Aakash1822" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/imgovind"><img src="https://avatars0.githubusercontent.com/u/4269318?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Govindarajan Panneerselvam</b></sub></a><br /><a href="https://github.com/legesher/language-legesher-python/commits?author=imgovind" title="Documentation">📖</a></td> <td align="center"><a href="http://www.irfansener.com"><img src="https://avatars3.githubusercontent.com/u/2094635?v=4?s=100" width="100px;" alt=""/><br /><sub><b>İrfan Şener</b></sub></a><br /><a href="https://github.com/legesher/language-legesher-python/commits?author=irfansener" title="Documentation">📖</a></td> </tr> <tr> <td align="center"><a href="https://github.com/wescran"><img src="https://avatars2.githubusercontent.com/u/36459418?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Wesley Cranston</b></sub></a><br /><a href="#maintenance-wescran" title="Maintenance">🚧</a></td> </tr> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->This project follows the all-contributors specification. Contributions of any kind are welcome and recognized. ✨