Vadi: A Python repository from Vyogami

Vadi is a simple, interpreted and dynamically-typed programming language. It comes with its own tool called a REPL, which lets you try out code quickly.

The interpreter which is the part of Vadi that runs your code, uses a technique named "Recursive Descent Parsing." This technique helps the interpreter understand your high-level code by creating a data-structure called a parse tree. Then, the interpreter uses this parse tree to figure out what your code is asking it to do.You can check out the Vadi's Syntax Grammar in BNF for more information.

Installation

Use pip or pipx to install vadi's REPL.

Warning

Use Python versions >=3.10 for installing Vadi.

Tip

The pipx package installer is strongly recommend for installing vadi on a global level to avoid conflicts.

pipx install vadi

pip install vadi

Now, run the REPL.

vadi

Grammar

The grammar is written in BNF(Backus Naur Form) notation.

<Interpreter> ::= <binary_expression>
                | <unary_expression>
                | <statement>
                | <expression>
                | <VAR>
                | <FLT>
                | <INT>

<binary_expression> ::= <expression> "+" <expression>
                      | <expression> "-" <expression>
                      | <expression> "*" <expression>
                      | <expression> "/" <expression>
                      | <expression> "=" <expression>

<unary_expression> ::= "+" <expression>
                     | "-" <expression>

<statement> ::= "DECL" <variable> "=" <expression>

<expression> ::= <term> "+" <term>
               | <term> "-" <term>

<term> ::= <factor> "*" <factor>
         | <factor> "/" <factor>

<factor> ::= "INT"
           | "FLT"
           | "(" <expression> ")"
           | <VAR>

Syntax

Unary operations
```
+1
-5
```
Binary operations
```
56+23
```
Complex arithmetic operations
```
1*2(4+5(5/6))
```

Variable declarations

var int = 89;
var float = 3.1415;
var difference = int - 20;

Conditionals: if-else

TODO: issue#2
Conditionals: loops

TODO: issue#2

Supported datatypes

Integer
Float

Contributing

Issues and Pull Requests are definitely welcome! Check out Contributing guidelines to get started. Everyone who interacts with the vadi project via codebase, issue tracker, chat rooms, or otherwise is expected to follow the Code of Conduct.

License