Skip to content

Commit

Permalink
Adding Important Information.
Browse files Browse the repository at this point in the history
  • Loading branch information
DEMON1A committed Feb 8, 2021
1 parent 3213573 commit 1a3dea6
Showing 1 changed file with 8 additions and 61 deletions.
69 changes: 8 additions & 61 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# EasyShell
Cool Shell Written In Python3 Allows You To Write Your Own Commands And Execute It. That Includes It's Own Scripting Language.
- Cool Shell Written In Python3 Allows You To Write Your Own Commands And Execute It. That Includes It's Own Scripting Language.

## Usage:
- If You Run EasyShell Without Arguments. It Will Just Open You The Shell That Will Take Your Inputs. Otherwise If You Want To Translate Or Execute Your Easy Code You Will Have To Use One Of These Examples Below
Expand Down Expand Up @@ -48,62 +48,6 @@ testcommand - someinputhere
Cool, Your Input is: someinputhere
```

# How To Write Your Own Easy Code?
- I'm Not Really Sure If Easy Code Is Easy. But You Can Decide. Easy Code Is Based On Python So Every Easy Code You're Writing Is Getting Genrated Into a Python Code. You Can See `examples` Folder Or Follow The Documentation Below.

### Variable Assignment And Usage:
- Let's Start With The Most Basic Thing Here. In Easy You Can Store Local Variables Using `DEFINE` Key, When The Parser Adds That Variable Into The Dicc. You Will Be Able To Call It From Anywhere Outside Of This Of Code Using `ADD` Key. See The Example Below For More Information

```
DEFINE githubHandler=<'"DEMON1A"'>
STORE handler
ADD githubHandler;NEWLINE
CALL print,handler
```

- After Translating The Code With EasyShell, The Output Code Will Be Something Like This:

```python
handler = "DEMON1A"
print(handler)
```

- I Usally Use This Method To Add a Pure Python Code Into My Easy Code To Work With It Until I Implement a Key For The Thing I Need In Python
- You Can Define Multi Variables On a Line Using `,` Between Everyone. For Example: `STORE test,something,hi`. You Can Use This For Functions That Returns More Than One Variable

### Defining a Function:
- You Can Define Your Own Function With `FUNCTION` Key On The Code. That Will Create a Python Function For You But You Will Need To Use `.` at The End Of Every Syntax You Code. The Dot at The End Of The Code Adds a TAB Into **The Next Line Of Code**. So When You Define a Function You Should Use `.` At The End Of It. See The Example Below

```
FUNCTION Main.
CALL print,"Hello^World!"
NEWLINE
CALL Main
```

- After Translating The Code It Will Be Something Like This:

```python
def Main():
print("Hello World!")

Main()
```

### Import Python Modules.
- No Python Code Can Work Without Imports. To Import a Python Library You Need To Use `IMPORT` Key. For Example If You Used `IMPORT os,time` After Tranlating The Code It Will Be `import os,time` LOL.

### Call a Function And Store Python Variables
- To Call a Function In Easy, You Should Use `CALL` Key. That Allows You To Call a Python Function With Arguments By Sperating The Values With `,`. For Example: `CALL print,"Hello^World!"`

- To Store Python Variables You Can Use `STORE` Key. That Will Set The Variable Name. And The Next Line Of Code Will Be It's Value.

### TAB and NEWLINE:
- It's Just a Basic Keys On Easy To Add NewLines And Tabs On The Code. So When You Want To Add a NewLine On Your Code You Just Need To Add `NEWLINE` And When You're Coding On a Function And You Hate Using Dots. Then Use `TAB` Key. I Know It's Not Pretty To Have `NEWLINE` and `TAB` On a Single Line. So I Allowed Using `;` On The Code. So You Can Just Do Whatever Code You Want Then Add `;TAB` Or `;NEWLINE` To Add a NewLine/Tab at The End

## To-Do:
- [X] Adding Local Variable Assignment
- [X] Allowing Using `;` For Multi Code In One Line
Expand All @@ -121,14 +65,17 @@ Main()
- [X] Perform Some Tests On a Linux Machine. Or Ask Someone To-Do So.

### Changelog:
- EasyShell Beta Version Released
- [2021/2/2] EasyShell Beta Version Released 0.0.1
- [2021/2/8] EasyShell Beta Version Updated With More Features 0.0.2

## Notes:
- Easy Is Sensitive To Spaces More Than Python. I Did Build The Parser From Zero Using Split Methods And Other Things On The Code. One Wrong Space Can Make an Error On The Code And Your LineOfCode Won't Be Applied. It's Only One Space Between The Key And It's Value. So `CALL something` Is Right. But `CALL [SPACE]something` Will Kill The Code. And That's The Same For `;` You Can't Include Spaces On It. `NEWLINE;CALL something` Is Right, But `NEWLINE; CALL something` Is Really Wrong.
- ~~Easy Is Sensitive To Spaces More Than Python. I Did Build The Parser From Zero Using Split Methods And Other Things On The Code. One Wrong Space Can Make an Error On The Code And Your LineOfCode Won't Be Applied. It's Only One Space Between The Key And It's Value. So `CALL something` Is Right. But `CALL [SPACE]something` Will Kill The Code. And That's The Same For `;` You Can't Include Spaces On It. `NEWLINE;CALL something` Is Right, But `NEWLINE; CALL something` Is Really Wrong.~~

- ~~I Didn't Implement The Error Handler Yet *( it's on the to-do list )* So Invalid Code Won't Be Applied On The Translated Code. You Won't Get an Error. If You Can't See Your Code On The Translation Then Check Your Code Again Specially For Spaces.~~

- I Didn't Implement The Error Handler Yet *( it's on the to-do list )* So Invalid Code Won't Be Applied On The Translated Code. You Won't Get an Error. If You Can't See Your Code On The Translation Then Check Your Code Again Specially For Spaces.
- ~~As I Said Before. Easy Is Sensitive To Spaces. So You Can't Really Use Spaces On The Code. But You Can Use `^` On Variables On These Stuff And The Parser Will Make Them Spaces. For Example: `CALL print,"Hello^World!"` After Translating It Will Be: `print("Hello World!")`~~.

- As I Said Before. Easy Is Sensitive To Spaces. So You Can't Really Use Spaces On The Code. But You Can Use `^` On Variables On These Stuff And The Parser Will Make Them Spaces. For Example: `CALL print,"Hello^World!"` After Translating It Will Be: `print("Hello World!")`
- Easy is Ready For Real Usage Now, You Can Use Multi Spaces And Even Use Spaces Before The Syntax. And You Don't Need To Use `^` Instead Of Space. The Space Split Funcions Has Been Replacted With Characters Loop That Removes Spaces at The First And The End Of The File.

## Somethng Isn't Working Or You Have Suggestions?
- Oh, I Would Love To Hear People Suggestions Specially For This Case. If You See That Something Isn't Working Or You Want To Improve Something. Then Please Open a Github Issue Or Fork The Repo Then Create a Pull Request. Also, You Can DM Me On Twitter: [DemoniaSlash](https://twitter.com/DemoniaSlash).

0 comments on commit 1a3dea6

Please sign in to comment.