nondescript/README.md

1.2 KiB

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
./build.sh
./nds