This project is a golang based compiler and intepreter for a simple virtual machine. It is a port of the existing project:

• https://github.com/skx/simple.vm

(The original project has a perl based compiler/decompiler and an interpreter written in C.)

Install the code via:

$ go get -u github.com/skx/go.vm
$ go installgithub.com/skx/go.vm

Once installed there are three sub-commands of interest:

• go.vm compile $file.in
  • Compiles the given program into bytecode.
• go.vm execute $file.raw
  • Given the path to a file of bytecode, then interpret it.
• go.vm run $file.in
  • Compiles the specified program, then directly executes it.

So to compile the input-file examples/hello.in into bytecode:

 $ go.vm compile examples/hello.in

Then to execute the resulting bytecode:

 $ go.vm execute examples/hello.raw

Or you can handle both steps at once:

 $ go.vm run examples/hello.in

The compiler is built in a traditional fashion:

• Input is split into tokens via lexer.go
  • This uses the token.go for the definition of constants.
• The stream of tokens is iterated over by compiler.go
  • This uses the constants in opcodes.go for the bytecode generation

The intepreter is located in the file cpu.go and is as simple and naive as you would expect.