nondescript/README.md

38 lines
1.2 KiB
Markdown

# nondescript
Nondescript is a nim implementation of lox (see https://craftinginterpreters.com) with large deviations.
## Deviations from lox
- NOT SOURCE COMPATIBLE WITH LOX
- Everything is an expression, except variable declarations and break statements
- hence expressions can contain statements, so the stack is tracked inside the compiler, using compiler.stackCount
- uses different local representation than lox inside the compiler
- compiler.addLocal also has a delta argument - check it out if interested
- 1 file = 1 chunk
- function objects are just a pointer to an instruction to jump to (right now instruction index, but this will change)
- constant indexes, local indexes have 2 bytes as arguments
- no object orientation
- closures are not implemented yet
- block expressions can be labelled and break takes a label to break out of
- set block expression results using ^, ^label
- set the return value of functions using ^result
- plans for the far future: defer, tables, lists
## Examples
benchmarks/fib.nds
## Building
Requirements:
- nim (1.6.2 tested)
- c compiler (gcc, glibc tested)
The 4 steps to a REPL:
```
git clone https://github.com/prod2/nondescript
cd nondescript
nim c main
./nds
```