Skip to content

Latest commit

 

History

History
175 lines (139 loc) · 3.25 KB

README.md

File metadata and controls

175 lines (139 loc) · 3.25 KB
Raw

🍁 koshur-lang

A simple programming language inspired by the Kashmiri language (Koshur).

Try it out: Koshur Online

Author: Afaan Bilal

Hello World

wan("Hello, world!");

Run

node koshur.js <filename>

The filename must be the last parameter and must end with .k or .ast.

node koshur.js [--print-ast] [--write-ast] [--from-ast] <filename>
  • Add --print-ast to print the Abstract Syntax Tree.
  • Add --write-ast to write the Abstract Syntax Tree to a file named filename with extension set to .ast.
  • Add --from-ast to evaluate from an Abstract Syntax Tree loaded from filename. File must end with .ast.

Run examples

See examples in the examples/ directory.

node run-examples.js

Syntax

Koshur-lang has a very brief syntax. Semi-colons are required except after expressions.

Comments

# This is a comment

Print to screen

wan("Hello!");

Variables

x = 10;
y = 20;

wan(x); # Prints 10
wan(y); # Prints 20

Control flow

  • poz means true
  • apuz means false
  • yeli means if
  • nate means else
  • teli means then and is only required after if when braces ({}) are skipped.
yeli poz {
    wan("Poz chu!");
} nate {
    wan("Apuz hasa!");
};

yeli apuz teli
    wan("apuz!")
nate
    wan("poz!");

Functions

Functions in koshur-lang are lambdas.

bod-kus = banav(x, y) yeli x > y teli x nate y;

wan(bod-kus(10, 20)); # Prints 20

This creates a function (lambda) named bod-kus which returns the bigger of the two parameters.

Functions may be multiline:

karunPrintFibonacci = banav(hadd, aediuk, patium) {
    yeli (hadd > 0) {
        wan(aediuk + patium);
        karunPrintFibonacci(hadd - 1, patium, aediuk + patium);
    } nate {
        wan("Done!");
    }
};

karunPrintFibonacci(10, 0, 1);

The above code prints:

1
2
3
5
8
13
21
34
55
89
Done!

Shortcut for banav is λ

lakut-kus = λ(x, y) yeli x < y teli x nate y;

wan(lakut-kus(10, 20)); # Prints 10

This creates a function (lambda) named lakut-kus which returns the smaller of the two parameters.

Keywords

This is a list of all the keywords in koshur-lang.

  • yeli
  • teli
  • nate
  • poz
  • apuz
  • banav
  • λ

Operators

This is a list of all the operators available in koshur-lang.

Operator Description
+ Addition
- Subtraction
* Multiplication
/ Division
% Modulo (Remainder)
&& Logical AND
|| Logical OR
< Less than
> Greater than
<= Less or Equal
>= Greater or Equal
== Equals
!= Not Equal

Contributing

All contributions are welcome. Please create an issue first for any feature request or bug. Then fork the repository, create a branch and make any changes to fix the bug or add the feature and create a pull request. That's it! Thanks!

License

koshur-lang is released under the MIT License. Check out the full license here.