koi-vm-ruby

Koi-vm-ruby is a simple proof-of-concept Virtual Machine for the Koi programming language written in Ruby. It was created with learning in mind and is written so that it is easy to understand and play with. This virtual machine implements an instruction set specifically designed for running the Koi programming language. A compiler for producing compatible bytecode can be found at the koi-reference-compiler.

Examples

The standard ‘Hello world!’, KoiVM style:

require 'koi'
include KoiVMRuby

VM.new.run [
  PUSH_STRING, "Hello World!\n",
  PRINT
]

#=> Hello world!

And an old-school ‘Blast off’ example:

require 'koi'
include KoiVMRuby

VM.new.run [
  PUSH_INT, 11,
  PUSH_INT, 1,
  SUBTRACT,
  DUP,
  TO_STRING,
  PRINT,
  PUSH_STRING, ", ",
  PRINT,
  DUP,
  PUSH_INT, 0,
  EQUAL,
  JUMP_UNLESS, -13,
  PUSH_STRING, "Blast Off!\n",
  PRINT
]

#=> 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0, Blast off!

Installation

This VM is normally installed as part of Koi’s default toolchain. However if you would like to install it on it’s own you can do so by installing the gem like so:

gem install koi-vm-ruby

Usage

require 'rubygems'
require 'koi-vm-ruby'

include KoiVMRuby

vm = VM.new

vm.run( bytecode )

Author & Credits

Author: Aaron Gough