A basic toy programming language written in python and inspired by python and BASIC.

You need python3 and git installed on your system.

git clone https://github.com/Sarthak2143/shin
cd shin/
python3 -m shin

You've shin shell already by using above commands. Now you have shell mode so you can do arithmetic calculations in the shell itself.

For example:

shin >>> 2 + 2
Output: 4

shin >>> 75 - 6
Output: 69

shin >>> 33*3
Output: 99

shin >>> 100/10
Output: 10

shin >>> 2^3
Output: 8

** is replaced by ^ for power.

Now, for script you can use the extension .shin for saving files and run with below command.

shin >>> run("<file_name>.shin")

Below is the official documentation of the language.

Note: You can run single line code in shell mode too.

1. + : It'll add the variable or integer.
2. - : It'll subtract the integers.
3. * : It'll multiply the integers
4. / : It'll divide the integer(s).
5. ^ : It's for power function. Eg: 2^3 = 8

# This is a comment.
# It's simlar to python

Shin lang only supports single line comments as for now.

print("Hello World!")

print("Its similar to python but just a capitalised version.")

let myVar = "Variable"

print(myVar)

print(2+3)

Only double quotes e.g "" are supported.

let myVariable = "Hello World"
let myInteger = 0123
let myBool = TRUE # It'll take TRUE as 1

For making or setting a value to a variable you've to use the let keyword.

The data is mutuable also i.e you can change the value of variables anytime.

shin >>> let Str = "Data"
shin >>> Str
shin >>> "Data"
shin >>> let Str = "It's mutuable"
shin >>> Str
shin >>> "It's mutuable"

Suported Data types -> Strings, Integers and Boolean.

Shin lang supports Strings, Integers, Flloats and Boolean as data.

String is a “string of characters” or in programming terms, an array of characters. A string is generally not a single object, but rather an array of characters that make a whole.

\\ -> This is a backslash and it's called escape as it escape some character specified.

Supported:

1. Quotes -> \"
2. Backlash -> \\
3. New line -> \n

"Text with \"quotes\""
"Text with backslash \\"
"Text \n in new \line."

An integer, in the context of computer programming, is a data type used to represent real numbers that do not have fractional values. ... For example, a short integer in many common programming languages is limited to a range of between 32,767 and -32,768.

In programming, a floating-point or float is a variable type that is used to store floating-point number values. A floating-point number is one where the position of the decimal point can "float" rather than being in a fixed position within a number. Examples of floating-point numbers are 1.23, 87.425, and 9039454.2.

In computer science, a boolean or bool is a data type with two possible values: true or false. ... When referring to the data type in computer programming, the word "boolean" is properly spelled with a lowercase b.

In shin, TRUE is simplified as 1 and FALSE is simplified as 0, That's how it's in low level languages.

1. == : Checks if the value of variable is satisfied or not. If yes then it will do the if not it'll be False or will continue to next

2. != : Checks if the value of variable is satisfied or not. If no then it will do the if not it'll be False or will continue to next

3. >= : Checks if the variables are equal or its greater than the other one.

4. <= : Checks if the variables are equal or its lesser than the other one.

1. and : It'll print True if both condition are True and False if one of them is False.

2. or : It'll print True if one of the conditions is correct.

3. not : It'll print True incase of False condition and False incase of True condition.

Functions are "self contained" modules of code that accomplish a specific task. Functions usually "take in" data, process it, and "return" a result. Once a function is written, it can be used over and over and over again.

Types of functions supported: 1. Short hand functions 2. Traditional functions 3. Anonymous functions

Short hand functions

func <func_name>(arguments) -> statement(s)

Traditional functions

func function_name(arguments)
    statement(s)
end # For ending the function

An example of using functions:

func myFunc(name)
    let new_name = "Mr./Ms./Mrs." + name
    return new_name
myFunc(John)

The return keyword is used for returning the value of a variable.

Output: Mr./Ms./Mrs. John

Anonymous functions

An anonymous function is a function that is not stored in a program file, but is associated with a variable whose data type is function_handle. Anonymous functions can accept multiple inputs and return one output.

Syntax:

func(params) -> <expression>

For example:

let func_name = func(a) -> a + 6
func_name(3)

Output: 9

You can assign a function to variable too.

For example

func oop(str) -> str + "oop"
var myFunc = oop
myFunc("P")

Output: "Poop"

**Conditions supoorted: ** -> IF, ELIF(ELSE IF) AND ELSE

if<condition> then <expression>

For example:

Below is the program that checks if the number is 69.

let num = 69
if num == 69 then print("yes")

if <condition> then <expression> else <expression>

For example:

Below is a program that checks if a number is 2 or not.

let num = 2
if num == then print("Yes it's 2") else print("No it's not 2")
let num1 = 3
if num1 == 2 then print("Yes it's 2") else print("No it's not 2")

Output:
"Yes it's two"
"No it's not 2"

if <condition> then <expression> elif <condition> then <expression> else <expression>

Types of WHILE statement:

1. Short Hand WHILE statement 2. Traditional WHILE statement

Short Hand WHILE statement

while <condition> then <expression>

Traditional WHILE statement

while <condition> then
    <statement>
end

For example:

while 1 then
    print("Yes")
end

The above program will keep printing "Yes" because it's TRUE.

Short Hand for statement

for <var_name> = <start_value> to <end_value> then <expression>

For example:

let result = 1
for i = 1 to 6 then let result = result*i
print(result)

Output: 120

Normal for statement

for <condition> or <increment> then
    <statement(s)>
end

<increment> = <var_name> = <start_value> to <end_value>

step keyword is for changing the increment value.

For example:

for i = 0 to 11 step 2 then ....

The above block of code will take numbers from 0 to 11 with a increment value of 2, so the numbers should be 0,2,4,6,8,10.

step values can be negative too i.e STEP -n

List is the most versatile data type available in functional programming languages used to store a collection of similar data items. The concept is similar to arrays in object-oriented programming. List items can be written in a square bracket separated by commas.

Creating a empty list

[]

It'll create a empty list, you can assign a name to a list.

let myList = []

Creating a list with elements

shin >>> let myList = [1,2,3]
shin >>> [1,2,3]

Adding elements in a list

Element can be added by + operator.

shin >>> let myList = [1,2,3]
shin >>> [1,2,3]
shin >>> myList + 4
shin >>> [1,2,3,4]

A list can be added as an element too aka list concatenation.

shin >>> let myList = [1,2,3]
shin >>> [1,2,3]
shin >>> let newList = [4,5,6]
shin > [1,2,3,[4,5,6]]

Combining two lists

Two lists can be combined by * operator.

shin >>> let myList = [1,2,3]
shin >>> [1,2,3]
shin >>> let newList = [4,5,6]
shin >>> [4,5,6]
shin >>> myList * newList
shin >>> [1,2,3,4,5,6]

Removing elements

Elements can be removed by their index number. Elements can be removed by <list_name> - <index>.

Index number starts from 0. Negative index number starts from -1.

shin >>> let myList = [1,2,3,4]
shin >>> [1,2,3,4]
shin >>> myList - 0
shin >>> [2,3,4]
shin >>> myList - 1
shin >>> [2,4]
shin >>> myList - -1
shin >>> [2]

In the above block of code, first 1 is removed as it's index number is 0. Then, 3 is removed as it's index number is 1. Then, 4 is removed as it's index number is -1.

Printing elements

Elements can be printed by their index number.

<list_name>/index

shin >>> let myList = [1,2,3,4,5,6]
shin >>> [1,2,3,4,5,6]
shin >>> myList/0
shin >>> 1
shin >>>  myList/3
shin >>> 4
shin >>> myList/-2
shin >>> 5

It'll add elements in a pre-defined list.

shin >>> let <list_name> = []
shin >>> append(<list_name, <element>)

For example:

shin >>> let myList = [1,2,3]
shin >>> [1,2,3]
shin >>> append(myList, 4)
shin >>> [1,2,3,4]

You can add lists as an element too.

shin >>> let myList = [1,2,3]
shin >>> [1,2,3]
shin >>> append(myList, [4,5,6])
shin >>> [1,2,3,[4,5,6]]

It removes an element from a list by it's index number.

shin >>> let <list_name> = []
shin >>> pop(<list_name>, <index>)

For example:

shin >>> let list = [1,2,3,4]
shin >>> pop(list, 3)
shin >>> list
shin >>> [1,2,3]

It removed 4 as it's index number is 3.

Negative indexing can be also used.

In shin lang, EXTEND is the operation for concatenating linked lists.

Basically elements of 2nd list is joint in 1st list

shin >>> let <list1> = []
shin >>> let <list2> = []
shin >>> extend(<list1>, <list2>)

For example:

shin >>> let list1 = [2,4,89]
shin >>> let list2 = [23,78,99]
shin >>> extend(list1, list2)
shin >>> list1
shin >>> [2,4,89,23,78]

It prints the length of a list.

Usage:

shin >>> let <list_name> = []
shin >>> let(<list_name>)

For example:

shin >>> let myList = [1,2,3,3,5]
shin >>> len(myList)
shin >>> 5

__

A function that is built into an application and can be accessed by end-users. For example, most spreadsheet applications support a built-in SUM function that adds up all cells in a row or column.

Prints the value of Pi/π.

shin >>> math_pi
shin >>> 3.141592653589793

An input/output statement or I/O statement is a portion of a program that instructs a computer how to read and process information. It pertains to gather information from an input device, or sending information to an output device.

It only supports Strings, For integer see INPUT_INT

shin >>> let <var_name> = input()

The above block of code will assign a value to the variable that is entered by user.

shin >>> let name = input()
John Doe
shin >>> "John Doe"

It's pyally the same keyword as above but it's for integers.

shin >>> let <var_name> = input_int()

The above block of code will assign an integer to the variable that is entered by user.

shin >>> var myAge = input_int()
69
shin >>> 69

Erorr if the taken input isn't an integer.

shin >>> let <var_name> = input_int()
Text
"Text" must be an integer, Try again!
69
shin >>> 69

It'll clear the screen.

shin >>> cls() #for windows nt
shin >>> clear() # for mac and linux

It'll check if the given data is an integer or not.

shin >>> is_num(69)
shin >>> 1
shin >>> is_num("String")
shin >>> 0
shin >>> is_num([])
shin >>> 0

As specified earlier, 1 is TRUE and 0 is FALSE.

It'll check if the given data is a string or not.

shin >>> is_str("HEY")
shin >>> 1
shin >>> is_str(69)
shin >>> 0
shin >>> is_str([])
shin >>> 0

It'll check if the given data is a list or not.

shin >>> is_list([])
shin >>> 1
shin >>> let myList = [1,2,3]
shin >>> [1,2,3]
shin >>> is_list(myList)
shin >>> 1
shin >>> is_list(23)
shin >>> 0

It'll check if the given data is a function or not, it works on built in function and defined function both.

shin >>> is_func(print)
shin >>> 1
shin >>> func oop() -> print("oop")
shin >>> is_func(oop)
shin >>> 1
shin >>> is_func(23)
shin >>> 0

Thanks, for coming till here.

• Make a language
• Upload on GitHub
• Make documentation
• Brushing the language
• Adding examples for programs
• Adding more built-in functions
• Make a website
• Make a package manager(maybe not)