Boris

A Simple Interpreted Language

This code prints every number 0-5000 that is evenly divisible by 3:

array []

let x 0

_ { 
    append .x array
    set x (+ .x 1)
}

repeat 5000 _

print_filtered x {
    if (! (% .x 3)) <
        print (concat .x " is evenly divisible by 3")
    >
}

forin array print_filtered

Installation / Using Boris:

Windows:

1. Clone this repo

2. Run makefile.bat to create boris.exe

3. Put boris.exe in your working directory (Or, put the path to boris.exe in your systems PATH env variable.)

4. Create a file with the extension .boris, for example main.boris

5. After writing Boris code, run your file using shell command boris.exe main.boris

Linux / Mac OS:

The code uses no OS-dependencies or libraries, but I have no build script for linux/mac at this time.

---

Boris' syntax is function definitions and function calls. For example, let/set is a function that defines or reassigns a variable. It is similar to Common Lisp in some ways.

All values are strings, and can be treated as all the same thing, except in functions like + where the number is parsed as a float or int. (In all of these cases, if one argument is a float they are all treated as floats.)

Function definitions can have parameter variables, scoped only to that function body (Parameters can have the same name as global variables, local version will be used first if it exists).

Any series of words followed by { } is a function definition. "If" statements use < > angle brackets to contain blocks.

Arrays are c++ vectors under the hood and are declared as such: name_you_want [] for an empty array, or name_you_want [ 3, .a_variable, 5, 1, "A string" ]. There are functions append <value> <array_name> and prepend <value> <array_name>.

The available built-in functions will have documentation soon, but for now their definitions and implementations are publicly visible in the "function_definitions" function in main.cpp. They include: "+", "%", "/", "concat", "print", "repeat", and "forin".

Thank you!

License:

Copyright 2023 Jackson Levine

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.