Skip to content

A language created by a middle-schooler made to teach first graders Python in an approachable way.

License

Notifications You must be signed in to change notification settings

abhiramasonny/jaithon

Repository files navigation

We suffer so that you don't

This is a simple compiler/interpreter that supports operations. It can parse and execute code containing variable assignments, print statements, import statements, input statements, time functions, and much more. The objective behind this interpreter is to provide a fun and easy way to get introduced to programming.

Description

JAITHON: A Simple Introduction to Math and Programming

JAITHON is a programming language put together for the purpose of teaching children and/or adults the basics of programming. Its simplicity and intuitive syntax make it an ideal choice for young learners, allowing them to grasp programming concepts quickly and enjoyably. Jaithon's syntax is so simple, that it's basically like reading/writing English. All you need is a 1st-grade education (Just know English...) to be able to enjoy my language. By providing a beginner-friendly environment, Jaithon removes the tech-savvy knowledge needed with standerd/high-level programming languages, making it accessible to people with little or no prior programming experience. The intended use of my language is to help the transition to Python. JAITHON will help you get from a beginner to a basic grasp of Python syntax.

Crossing the age barrier:

The primary problem JAITHON addresses is the stress often felt by young learners when approaching programming. As a quote from Munna Bhai MBBS, "Bhai, tension nahin lene ka bhai!", meaning leave the tension behind. By offering straightforward and visually appealing syntax, JAITHON enables children to effectively leave the tension behind. This approach cultivates a positive learning experience, encouraging children to explore and develop problem-solving skills, logical thinking, and computational creativity from an early age. Our syntax is structured in such a way, that anyone who reads it will be able to tell you what the program does. Ive got proof for that as well. Star the GH repo and ill tell it to you :DD.

Usage

SHELL MODE CURRENTLY AVALIBLE AT https://6vlgvljc.usw3.devtunnels.ms:8080/

To use the compiler/interpreter on UNIX, follow these steps:

git clone https://github.com/abhiramasonny/jaithon
cd jaithon
make #for updates
./jaithon Test/jaithon

You must have gcc and Make installed otherwise the script wont work.

Or you can run

./jaithon

for a shell.
There are a lot more options you can access by doing
./jaithon -h

Writing code

  1. Create a new file with the .jai extension, then write code in the JAI language.
  2. Execute the compiler/interpreter with filename as input/argument.
  3. The programs output will be displayed.

Features

  • Variable Assignment: You can assign values to variables using the var keyword. Syntax: var x = 5
  • String: You can do strings by doing same as variable but with Quotes. Sytnax: var hi = "hello world"
  • Print Statement: You can use the print keyword to print values to the console. Syntax: print x
  • Mathematical Expressions: You can perform arithmetic operations (+, -, *, /) on numbers.
  • Comparisons: you can preform comparisons by using the > and < symbols. Syntax: var a = 1>4 >> the output would be a = 0 because that statement is false.
  • Parentheses: You can use parentheses to group expressions and control operator precedence. PEMDAS
  • Trigonometric Functions: You can use trigonometric functions such as sin, cos, tan, asin, acos, atan, sqrt. Syntax: math.sin(3) math.sin(x)
  • Detecting User input: You can detect user input. Syntax: input variable_name
  • Time: You can access the users internal Clock by using the time keyword. Syntax: var t = time() This saves the time as an integer.
  • Comments: You can add comments using the # symbol. Commented lines are displayed in green.
  • If loops: You can do if loops by using the if/then/do keywords. Syntax: if 1>4 then do print 1
  • Not: You can do not operations by using the not keyword. Syntax: var a = 1 not
  • Quadratic function: You can solve quadratic functions using the inbuilt math function. Syntax: var q = math.quad(1,2,1)
  • The rest of the functions/keywords/things are located in the documentation.

For more documentation, visit

Documentation/grammar.txt

NOTE Jaithon is actually Faster then its counterpart Python! Here are the results from the tests I ran. Jaithon Speed Result Python Speed Result Please Note, the 0.05 user time in python is not 'user' input. It can not be avoided. You can try the time command on your UNIX running computer with

time ./jaithon filename

Flowchart: JAI Programming Language Interpreter

  1. Read Input Code: Read the code to be compiled/interpreted.
  2. Initialize Token List: Convert the input code into tokens.
  3. Start Parsing Program: Begin parsing the program.
  4. Are Tokens Remaining Loop:: Loop while tokens exist, otherwise GOTO 22.
  5. Parse Variable Assignment: Assign variable a value.
  6. If Print Statement: Parse and display variable/expression value.
  7. Parse Print Statement: Evaluate and print.
  8. If Input Statement: Parse and read user input.
  9. Parse Input Statement: Read and store user's input value.
  10. If Trigonometric Function: Parse and compute trigonometric value.
  11. Parse Trigonometric Function: Calculate the trigonometric value.
  12. If Time Function: Parse and compute time-related value.
  13. Parse Time Function: Calculate the time-related value.
  14. End of loop: Continue processing remaining tokens. GOTO 5 (Loop back).
  15. All Tokens Processed: Execution complete, proceed to the end.
  16. Error Handling: Handle parsing errors or undefined variables.
  17. Stop: End the interpreter's execution.

Syntax Highlighting

This is a really cool feature and takes like 3 seconds to do so don't be lazy and follow the steps. Only if you have VS-Code as your IDE

cd Extensions
cp -r jai ~/.vscode/extensions

Reload VS-Code Note: this is for Mac/linux.
Hasn't been tested on windows

Examples

Examples are located in the Test directory. There is also documentation of the syntax located at

Documentation/grammar.txt

Info

For more info and to appreciate my hard webdev work go to the html page located at

https://abhiramasonny.github.io/Projects/JAITHON%20website/index.html

or the youtube video

https://www.youtube.com/watch?v=4CcsI82OGq0

or contact me at abhirama.sonny@gmail.com.

Credits

  • Abhirama
  • Sonny

:DD