peon/src/backend/vm.nim

# Copyright 2022 Mattia Giambirtone & All Contributors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

## The Peon runtime environment
import types
import strformat
import ../config
import ../frontend/meta/bytecode
import ../util/multibyte


type
    PeonVM* = ref object
        ## The Peon Virtual Machine
        stack: seq[PeonObject]
        ip: int                     # Instruction pointer
        cache: array[6, PeonObject] # Singletons cache
        chunk: Chunk                # Piece of bytecode to execute
        depth: int


proc initCache*(self: PeonVM) =
    ## Initializes the VM's
    ## singletons cache
    self.cache[0] = PeonObject(kind: Nil)
    self.cache[1] = PeonObject(kind: Bool, boolean: true)
    self.cache[2] = PeonObject(kind: Bool, boolean: false)
    self.cache[3] = PeonObject(kind: ObjectKind.Inf, positive: true)
    self.cache[4] = PeonObject(kind: ObjectKind.Inf, positive: false)
    self.cache[5] = PeonObject(kind: ObjectKind.Nan)


proc newPeonVM*: PeonVM =
    ## Initializes a new, blank VM
    ## for executing Peon bytecode
    new(result)
    result.ip = 0
    result.depth = 0
    result.stack = newSeq[PeonObject]()
    result.initCache()


## Getters for singleton types (they are cached!)

proc getNil*(self: PeonVM): PeonObject = self.cache[0]

proc getBool*(self: PeonVM, value: bool): PeonObject =
    if value:
        return self.cache[1]
    return self.cache[2]

proc getInf*(self: PeonVM, positive: bool): PeonObject =
    if positive:
        return self.cache[3]
    return self.cache[4]

proc getNan*(self: PeonVM): PeonObject = self.cache[5]

## Stack primitives

proc push(self: PeonVM, obj: PeonObject) =
    ## Pushes a Peon object onto the
    ## stack
    self.stack.add(obj)


proc pop(self: PeonVM): PeonObject =
    ## Pops a Peon object off the
    ## stack, decreasing the stack
    ## pointer. The object is returned
    return self.stack.pop()


proc peek(self: PeonVM): PeonObject =
    ## Returns the element at the top
    ## of the stack without consuming
    ## it
    return self.stack[^1]


proc readByte(self: PeonVM): uint8 =
    ## Reads a single byte from the
    ## bytecode and returns it as an
    ## unsigned 8 bit integer
    inc(self.ip)
    return self.chunk.code[self.ip - 1]


proc readShort(self: PeonVM): uint16 =
    ## Reads two bytes from the
    ## bytecode and returns them
    ## as an unsigned 16 bit
    ## integer
    return [self.readByte(), self.readByte()].fromDouble()


proc readLong(self: PeonVM): uint32 =
    ## Reads three bytes from the
    ## bytecode and returns them
    ## as an unsigned 32 bit
    ## integer. Note however that
    ## the boundary is capped at
    ## 24 bits instead of 32
    return uint32([self.readByte(), self.readByte(), self.readByte()].fromTriple())


proc readInt64(self: PeonVM, idx: int): PeonObject =
    ## Reads a constant from the
    ## chunk's constant table and
    ## returns a Peon object. Assumes
    ## the constant is an Int64
    var arr = [self.chunk.consts[idx], self.chunk.consts[idx + 1],
               self.chunk.consts[idx + 2], self.chunk.consts[idx + 3],
               self.chunk.consts[idx + 4], self.chunk.consts[idx + 5],
               self.chunk.consts[idx + 6], self.chunk.consts[idx + 7],
            ]
    result = PeonObject(kind: Int64)
    copyMem(result.long.addr, arr.addr, sizeof(arr))


proc readUInt64(self: PeonVM, idx: int): PeonObject =
    ## Reads a constant from the
    ## chunk's constant table and
    ## returns a Peon object. Assumes
    ## the constant is an UInt64
    var arr = [self.chunk.consts[idx], self.chunk.consts[idx + 1],
               self.chunk.consts[idx + 2], self.chunk.consts[idx + 3],
               self.chunk.consts[idx + 4], self.chunk.consts[idx + 5],
               self.chunk.consts[idx + 6], self.chunk.consts[idx + 7],
            ]
    result = PeonObject(kind: UInt64)
    copyMem(result.uLong.addr, arr.addr, sizeof(arr))


proc readUInt32(self: PeonVM, idx: int): PeonObject =
    ## Reads a constant from the
    ## chunk's constant table and
    ## returns a Peon object. Assumes
    ## the constant is an UInt32
    var arr = [self.chunk.consts[idx], self.chunk.consts[idx + 1],
               self.chunk.consts[idx + 2], self.chunk.consts[idx + 3]]
    result = PeonObject(kind: UInt32)
    copyMem(result.uInt.addr, arr.addr, sizeof(arr))


proc dispatch*(self: PeonVM) =
    ## Main bytecode dispatch loop
    var instruction: OpCode
    while true:
        instruction = OpCode(self.readByte())
        when DEBUG_TRACE_VM:
            echo &"Stack: {self.stack}"
            echo &"PC: {self.ip}"
            echo &"SP: {self.stack.high()}"
            echo &"Instruction: {instruction}"
            discard readLine stdin
        case instruction:
            of LoadTrue:
                self.push(self.getBool(true))
            of LoadFalse:
                self.push(self.getBool(false))
            of LoadNan:
                self.push(self.getNan())
            of LoadNil:
                self.push(self.getNil())
            of LoadInf:
                self.push(self.getInf(true))
            of LoadInt64:
                self.push(self.readInt64(int(self.readLong())))
            of LoadUInt64:
                self.push(self.readUInt64(int(self.readLong())))
            of LoadUInt32:
                self.push(self.readUInt32(int(self.readLong())))
            of OpCode.Return:
                if self.depth == 0:
                    return
                else:
                    self.ip = int(self.pop().uInt)
            of ReturnPop:
                var retVal = self.pop()
                self.ip = int(self.pop().uInt)
                self.push(retVal)
            of OpCode.LoadVar:
                self.push(self.stack[self.readLong()])
            of NoOp:
                continue
            of Pop:
                discard self.pop()
            of Call:
                self.ip = int(self.readLong())
            of Jump:
                self.ip = int(self.readShort())
            of JumpForwards:
                self.ip += int(self.readShort())
            of JumpBackwards:
                self.ip -= int(self.readShort())
            of JumpIfFalse:
                if not self.peek().boolean:
                    self.ip += int(self.readShort())
            of JumpIfTrue:
                if self.peek().boolean:
                    self.ip += int(self.readShort())
            of JumpIfFalsePop:
                if not self.peek().boolean:
                    self.ip += int(self.readShort())
                discard self.pop()
            of JumpIfFalseOrPop:
                if not self.peek().boolean:
                    self.ip += int(self.readShort())
                else:
                    discard self.pop()
            of LongJumpIfFalse:
                if not self.peek().boolean:
                    self.ip += int(self.readLong())
            of LongJumpIfFalsePop:
                if not self.peek().boolean:
                    self.ip += int(self.readLong())
                discard self.pop()
            of LongJumpForwards:
                self.ip += int(self.readLong())
            of LongJumpBackwards:
                self.ip -= int(self.readLong())
            of LongJump:
                self.ip = int(self.readLong())
            of LongJumpIfFalseOrPop:
                if not self.peek().boolean:
                    self.ip += int(self.readLong())
                else:
                    discard self.pop()
            else:
                discard


proc run*(self: PeonVM, chunk: Chunk) =
    ## Executes a piece of Peon bytecode.
    self.chunk = chunk
    self.ip = 0
    self.dispatch()