dullabs/bhai-lang

A toy programming language written in Typescript

Bhai Lang

This is official repository for bhai-lang.

Bhai lang is a toy programming language written in Typescript.

Installation

npm i -g bhailang

Usage

Create a new file (test.bhai)

Edit the file with a text editor. You can also try out your code on Bhai Lang PlayGround

hi bhai
  bol bhai "Hello bhai";
bye bhai

Run

bhailang test.bhai

Output

hello bhai

Documentation

General

hi bhai is the entrypoint for the program and all program must end with bye bhai. Anything outside of it will be ignored.

This will be ignored

hi bhai
// Write code here
bye bhai

This too

Variables

Variables can be declared using bhai ye hai.

hi bhai
  bhai ye hai a = 10;
  bhai ye hai b = "two";
  bhai ye hai c = 15;
  a = a + 1;
  b = 21;
  c *= 2;
bye bhai

Types

Numbers and strings are like other languages. Null values can be denoted using nalla. sahi and galat are the boolean values.

hi bhai
  bhai ye hai a = 10;
  bhai ye hai b = 10 + (15*20);
  bhai ye hai c = "two";
  bhai ye hai d = 'ok';
  bhai ye hai e = nalla;
  bhai ye hai f = sahi;
  bhai ye hai g = galat;
bye bhai

Built-ins

Use bol bhai to print anything to console.

hi bhai
  bol bhai "Hello World";
  bhai ye hai a = 10;
  {
    bhai ye hai b = 20;
    bol bhai a + b;
  }
  bol bhai 5, 'ok', nalla , sahi , galat;
bye bhai

Conditionals

Bhailang supports if-else-if ladder construct , agar bhai block will execute if condition is sahi, otherwise one of the subsequently added nahi to bhai blocks will execute if their respective condition is sahi, and the warna bhai block will eventually execute if all of the above conditions are galat

hi bhai
  bhai ye hai a = 10;
  agar bhai (a < 20) {
    bol bhai "a is less than 20";
  } nahi to bhai ( a < 25 ) {
    bol bhai "a is less than 25";
  } warna bhai {
    bol bhai "a is greater than or equal to 25";
  }
bye bhai

Loops

Statements inside jab tak bhai blocks are executed as long as a specified condition evaluates to sahi. If the condition becomes galat, statement within the loop stops executing and control passes to the statement following the loop. Use bas kar bhai to break the loop and agla dekh bhai to continue within loop.

hi bhai
  bhai ye hai a = 0;
  jab tak bhai (a < 10) {
   a += 1;
   agar bhai (a == 5) {
    bol bhai "andar se bol bhai ", a;
    agla dekh bhai;
   }
   agar bhai (a == 6) {
    bas kar bhai;
   }
   bol bhai a;
  }
  bol bhai "done";
bye bhai

Development

You can explore abstract syntax tree(AST) of bhailang here.

bhai-lang's Issues

Add readme for npm, support for logical operators, support for % operator

Project not running on localhost

Description

Unable to run on local system
I have gone through issue #80 , but no luck!
Please help me out with this @ankitchouhan1020

Domain

Develop

Type of Contribution

No response

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Change Request: Change Exception error text to "Bhai kia kar rha hai tu"

Description

The Following error text should be changed to Bhai kya kar rha hai tu to look funnier following the meme trend

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

docs: project setup & getting started

As of now, there are no docs for Project setup for contributing and trying it out locally.

Let me know if help is needed.

docs if any?

Any docs for this if provided will be helpful. Also, do mention planned features so as to contribute if possible in some way

Support for "Pata nai bhai"!!!

Description

Support for Null or Undefined!

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Change Comment Text to Bhai yaha Code likh

Description

It's written

hi bhai 
  // write code here
bye bhai

I am suggesting to change it to // bhai yaha code likh

Domain

Other

Type of Contribution

Documentation

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Bug or feature? : Adding nalla or boolean type to string is possible

Right now, if a developer tries to add nalla or boolean type to string then its possible:

hi bhai;
bol bhai nalla + " crap";
bye bhai;

Output : "nalla crap"

hi bhai;
bol bhai sahi + " crap";
bye bhai;

Output : "sahi crap"

also, if developer tries to add nalla / boolean to number then :

hi bhai;
bol bhai nalla + 45;
bye bhai;

Output : RuntimeException: Are bhai bhai bhai.... : Ye kya kar raha hai: "+" ke sath "string" aur "number" nahi jamte.

Which is kinda misleading.

Support for "bhai 10 londa dasti ready kr"

For Example

This might be a complex feature to ask for but if a user want to init 10 workers or something else,

bhai 10 londa dasti ready kr 

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Issue templates now use Issue forms instead of markdown

Markdown templates often made it difficult to capture the whole context, by expecting the contributors to read the markup, uncomment lines and delete relevant context.

Issue forms beta was released for public repositories last month, as mentioned by GitHub on this blog. We would like to migrate the issue templates to YAML-based forms which are easy to fill up and maintain, helping us capture relevant context.

https://user-images.githubusercontent.com/67006255/157601493-30b1757d-1acf-4ab3-b732-a8973a1b4139.png

Support for "gol chakkar" while true loop

Description

DescriptionSupport for "gol chakkar" while true loop

Domain

Bhai Lang

Type of Contribution

Addition

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Suport for compilation error as "Dil se bura lagta hai bhai"

Can we have a support for compilation error msg as "dil se bura lagta hai bhai"

Domain

Bhai Lang

Type of Contribution

No response

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Bhai Bhai Bhai as catch block

Small Suggestion :

I see that nalla, sahi and galat are language specific bult-in variables/macros here.
Make them _nalla, _sahi and _galat or make them all capital to differentiate them from normal variables.

Whats the use-case for NodeType.InitStatement

Hey folks, great work in this.

I am curious, there is a specific reason why the Program contains an InitStatement as it's start block ?

From a brief look I have had till now, this seems it can be removed from the AST, but would love to learn more on why is this designed like this :)

Feat : Ability to copy code on clicking

Description

Description: Currently in the documentation examples on-site and in the playground as well we don't have the ability to copy on click,

Proposed solution: to resolve this we can add a new button at the side of pre-existing buttons like "run" and "clear" named "copy" that will help users to copy the code of the playground that he/she wrote, and for examples in documentation, we can use the similar functionality that we use for GitHub or most other documentation sites that placing a small icon at the markdown example and by clicking on that icon show "copied on clipboard" .

Domain

UI/UX

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Dena bhai for import

Description

Using dena bhai for importing any thing

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for "Bata Bhai"

Hey all, I just got to know about this today.
Right now I don't see taking input as a feature. I want to propose a "Bata bhai" or "pooch bhai" statement to take input.

What say bhai log ?

Null pointer exception error

Description

Null pointer exception could also be renamed to for more meme potential..

Domain

Develop

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

how to run the project

i tried to run the project, installed turbo and ran 'turbo run dev --parallel' but local host not opening up, donno at which port is it running... can anyone help me out

Support for "Are Bhai Bhai Bhai"

This is amazing!!

We can have "Are Bhai Bhai Bhai" for error statements

Add Support For Runtime limit exceed error: "Emotional Damage"

Description

Add Error for run-time limit exceed with "Emotional Damage

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Suggestions for control statements if we don't have it already.

Continue: aage badho bhai
Break: kat lo bhai

Issue with playground code editor on bhailang.js.org

Description

• Cursor position not proper wrt the word being typed.
• Syntax highlighting makes other bigger smaller, i.e until a particular word is not keyword it's font size is incosistent with the font size of the keyword.

Requirements
Need the repository for the website.

Domain

Other

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Memes!!

Hey folks,

A lot of memes related to bhailang are being shared online. If you are creating one, please share in this issue.
Les.. go! BhaiLang to the moon 🚀

Support for Arrays

Description

Looks like arrays are not supported yet.

Domain

Bhai Lang

Type of Contribution

Addition, Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Hi bro.... I want to create my final year project like this one. How shall I do it? Please give some guidance. Thank you

"Nikal bhai" for return statement

Description

Using nikal bhai for returning from a function

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Change `hi bhai` to `namaste bhai`

Description

It will be much more indic, if we can say namaste bhai instead of hi bhai

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for try catch "isko dekh bhai"

Description

for
try {}
catch(){}
finally{} ->
isko dekh bhai { // try block }
pakad bhai (//exception) {//exception block}
akhir me bhai {//final block }

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Add CODE_OF_CONDUCT file

Description

I want to add CODE_OF_CONDUCT file to this repository which is currently missing here.
Kindly assign this issue to me,.

Domain

Other

Type of Contribution

Addition, Documentation

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Can we have this image?

Description

n

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for "Ye Kar lo Pehle"

Description

Import statement with the syntax as "Ye Kar lo Pehle"

Domain

Develop

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for Kuch bhi

This is fun!

can we have error handling via "Kuch bhi"

Add support for 'beda gark'

Description

Add support for beda gark for try-catch bhai yeh kar, beda gark (try - catch)

bhai yeh kar
         bhai ye hai a = 10;
         bhai ye hai b = 10 + (15*20);
         bol bhai "b is greater than a";
beda gark (err)
         bol bhai err

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for Try Catch Finally block "Try kar bhai, pakad bhai, sab theek hai bhai"

Description

try: try kar bhai
catch:pakad bhai
finally:sab theek hai bhai
lafda: error

try kar bhai {

 // kuch kaam kar bhai 

} pakad bhai (lafda) {

 // lag gye bhai ;-;

} sab theek hai bhai {
 
// aage badh

}

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Arre Bhai Bhai Bhai !!! > Unexpected token: "."

Description

Description Arre Bhai Bhai Bhai !!!

Unexpected token: "."

Not able to work with float value
  bhai ye hai c = 15.1;

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Can we start contributing

Description

Wanna make it a fun thing,
So if you guys are open for contribution

Domain

Other

Type of Contribution

Others

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for "Bhai kya kar raha hai tu?"

Can we have this as the parent exception?

bhai bhai bhai bhai

Possible issue in static scope during multiple runs of the code.

Context: Scope of the entire program is statically set only once. This can potentially create a problem while re-running the code without refreshing the browser. The static scope will persist if the user doesn't refresh the browser tab.

I have observed this while testing:

While running multiple cases one after other, the variables in scope of previous test case were interfering with the current test case variables. To resolve this in testing, I did a scope reset before each test case.

Possible scenario demonstration:

Code 1:

hi bhai;
bhai ye hai a = 7;
bye bhai;

Code 2:

hi bhai;
bhai ye hai a = 30, b = 4;
bye bhai;

Let's say this code 1 runs in the browser and then user runs code 2 in the browser without refreshing the tab, the variable "a" from code 1 will persist in the scope and while running code 2, an error will be thrown.

Possible solution:

in interpret method:

interpret(code: string) {
  const ast = this._parser.parse(code);
  InterpreterModule.getVisitor(ast.type).visitNode(ast);
  InterpreterModule.setCurrentScope(new Scope(null)); // this will make sure that scope is reset after running the code.
}

Add unary operator : Support for Negative number and Logical Not (!)

Support for "Ya fir Bhai"

Description

this will be used in place of "else if"

agar bhai(condition) { // code here, for if part } ya fir bhai(another condition) { // more code here, for else if part } warna bhai{ // else part of code here }

this will help differentiate between, 2 if conditions and a single nested conditions

Domain

Bhai Lang

Type of Contribution

Enhancement

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Add copy to clipboard icons on landing page documentation

Support for Ruk Ja Bhai

Description

Petition to add Ruk Ja Bhai or Tham Ja Bhai for break statement 😂

Domain

Bhai Lang

Type of Contribution

Addition

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for error messages

Currently errors like "divide by zero" gives out message as "infinity".

There is potential here to expand on this, like -
"Bhai ye kya kiya"
"Bhai aise nahi hota"
"Bhai ye kya kar diya"

division by zero

Description

DivisionByZeroException

it shows Infinity

mere khayal se

bhai zero se divison kaha

and missing semi-colon ka

bhai semi-colon lga de

should be good......must change to something better if required

Domain

Bhai Lang

Type of Contribution

Refactoring

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Support for input

Can we use this for input?
bhai sun variable

Help

Description

Hi bro .... I want to make my final year project like this one. Can you please help me how should I do it. Which resources should i follow. Please give me the guidence.

Thank you

Domain

Bhai Lang

Type of Contribution

Others

Code of Conduct

• I follow Contributing Guidelines & Code of conduct of bhai-lang.

Add Documentation for Contributors

👍 Nice Project
It would be great if the CONTRIBUTING.md file is there. So that community can get started to contribute🚀.