Compare commits

..

No commits in common. "40d0f231350129c060b3dea1861d16ae17f6f1f2" and "7bae3ad249e4e3f5382984267531e785dff5bc7d" have entirely different histories.

10 changed files with 109 additions and 239 deletions

View File

@ -1,8 +1,7 @@
# Peon - Bytecode Specification
This document aims to document peon's bytecode as well as how it is (de-)serialized to/from files and
other file-like objects. Note that the segments in a bytecode dump appear in the order they are listed
in this document.
other file-like objects.
## Code Structure
@ -10,12 +9,12 @@ A peon program is compiled into a tightly packed sequence of bytes that contain
the VM needs to execute said program. There is no dependence between the frontend and the backend outside of the
bytecode format (which is implemented in a separate serialiazer module) to allow for maximum modularity.
A peon bytecode file contains the following:
A peon bytecode dump contains:
- Constants
- The program's code
- Debugging information (file and version metadata, module info. Optional)
- The bytecode itself
- Debugging information
- File and version metadata
## File Headers
@ -35,7 +34,7 @@ in release builds.
### Line data segment
The line data segment contains information about each instruction in the code segment and associates them
1:1 with a line number in the original source file for easier debugging using run-length encoding. The segment's
1:1 with a line number in the original source file for easier debugging using run-length encoding. The section's
size is fixed and is encoded at the beginning as a sequence of 4 bytes (i.e. a single 32 bit integer). The data
in this segment can be decoded as explained in [this file](../src/frontend/compiler/targgets/bytecode/opcodes.nim#L29), which is quoted
below:
@ -58,7 +57,7 @@ below:
This segment contains details about each function in the original file. The segment's size is fixed and is encoded at the
beginning as a sequence of 4 bytes (i.e. a single 32 bit integer). The data in this segment can be decoded as explained
in [this file](../src/frontend/compiler/targets/bytecode/opcodes.nim#L39), which is quoted below:
in [this file](../src/frontend/compiler/targgets/bytecode/opcodes.nim#L39), which is quoted below:
```
[...]
@ -75,26 +74,6 @@ in [this file](../src/frontend/compiler/targets/bytecode/opcodes.nim#L39), which
[...]
```
### Modules segment
This segment contains details about the modules that make up the original source code which produced a given bytecode dump.
The data in this segment can be decoded as explained in [this file](../src/frontend/compiler/targets/bytecode/opcodes.nim#L49), which is quoted below:
```
[...]
## modules contains information about all the peon modules that the compiler has encountered,
## along with their start/end offset in the code. Unlike other bytecode-compiled languages like
## Python, peon does not produce a bytecode file for each separate module it compiles: everything
## is contained within a single binary blob. While this simplifies the implementation and makes
## bytecode files entirely "self-hosted", it also means that the original module information is
## lost: this segment serves to fix that. The segment's size is encoded at the beginning as a 4-byte
## sequence (i.e. a single 32-bit integer) and its encoding is similar to that of the functions segment:
## - First, the position into the bytecode where the module begins is encoded (as a 3 byte integer)
## - Second, the position into the bytecode where the module ends is encoded (as a 3 byte integer)
## - Lastly, the module's name is encoded in ASCII, prepended with its size as a 2-byte integer
[...]
```
## Constant segment
The constant segment contains all the read-only values that the code will need at runtime, such as hardcoded
@ -108,6 +87,6 @@ real-world scenarios it likely won't be.
## Code segment
The code segment contains the linear sequence of bytecode instructions of a peon program to be fed directly to
peon's virtual machine. The segment's size is fixed and is encoded at the beginning as a sequence of 3 bytes
The code segment contains the linear sequence of bytecode instructions of a peon program. It is to be read directly
and without modifications. The segment's size is fixed and is encoded at the beginning as a sequence of 3 bytes
(i.e. a single 24 bit integer). All the instructions are documented [here](../src/frontend/compiler/targgets/bytecode/opcodes.nim)

View File

@ -68,8 +68,7 @@ type
## this system and is not handled
## manually by the VM
bytesAllocated: tuple[total, current: int]
when debugGC or debugAlloc:
cycles: int
cycles: int
nextGC: int
pointers: HashSet[uint64]
PeonVM* = object
@ -94,10 +93,9 @@ type
frames: seq[uint64] # Stores the bottom of stack frames
results: seq[uint64] # Stores function return values
gc: PeonGC # A reference to the VM's garbage collector
when debugVM:
breakpoints: seq[uint64] # Breakpoints where we call our debugger
debugNext: bool # Whether to debug the next instruction
lastDebugCommand: string # The last debugging command input by the user
breakpoints: seq[uint64] # Breakpoints where we call our debugger
debugNext: bool # Whether to debug the next instruction
lastDebugCommand: string # The last debugging command input by the user
# Implementation of peon's memory manager
@ -107,8 +105,7 @@ proc newPeonGC*: PeonGC =
## garbage collector
result.bytesAllocated = (0, 0)
result.nextGC = FirstGC
when debugGC or debugAlloc:
result.cycles = 0
result.cycles = 0
proc collect*(self: var PeonVM)
@ -217,16 +214,6 @@ proc markRoots(self: var PeonVM): HashSet[ptr HeapObject] =
# will mistakenly assume the object to be reachable, potentially
# leading to a nasty memory leak. Let's just hope a 48+ bit address
# space makes this occurrence rare enough not to be a problem
# handles a single type (uint64), while Lox has a stack
# of heap-allocated structs (which is convenient, but slow).
# What we do instead is store all pointers allocated by us
# in a hash set and then check if any source of roots contained
# any of the integer values that we're keeping track of. Note
# that this means that if a primitive object's value happens to
# collide with an active pointer, the GC will mistakenly assume
# the object to be reachable (potentially leading to a nasty
# memory leak). Hopefully, in a 64-bit address space, this
# occurrence is rare enough for us to ignore
var result = initHashSet[uint64](self.gc.pointers.len())
for obj in self.calls:
if obj in self.gc.pointers:
@ -298,6 +285,7 @@ proc sweep(self: var PeonVM) =
## during the mark phase.
when debugGC:
echo "DEBUG - GC: Beginning sweeping phase"
when debugGC:
var count = 0
var current: ptr HeapObject
var freed: HashSet[uint64]
@ -1062,11 +1050,10 @@ proc run*(self: var PeonVM, chunk: Chunk, breakpoints: seq[uint64] = @[], repl:
self.frames = @[]
self.calls = @[]
self.operands = @[]
self.breakpoints = breakpoints
self.results = @[]
self.ip = 0
when debugVM:
self.breakpoints = breakpoints
self.lastDebugCommand = ""
self.lastDebugCommand = ""
try:
self.dispatch()
except NilAccessDefect:

View File

@ -134,7 +134,7 @@ type
node*: Declaration
# Who is this name exported to? (Only makes sense if isPrivate
# equals false)
exportedTo*: HashSet[string]
exportedTo*: HashSet[Name]
# Has the compiler generated this name internally or
# does it come from user code?
isReal*: bool
@ -212,7 +212,7 @@ type
# The module importing us, if any
parentModule*: Name
# Currently imported modules
modules*: HashSet[string]
modules*: HashSet[Name]
TypedNode* = ref object
## A wapper for AST nodes
@ -354,7 +354,7 @@ proc resolve*(self: Compiler, name: string): Name =
# module, so we definitely can't
# use it
continue
elif self.currentModule.path in obj.exportedTo:
elif self.currentModule in obj.exportedTo:
# The name is public in its owner
# module and said module has explicitly
# exported it to us: we can use it
@ -713,7 +713,7 @@ method findByName*(self: Compiler, name: string): seq[Name] =
for obj in reversed(self.names):
if obj.ident.token.lexeme == name:
if obj.owner.path != self.currentModule.path:
if obj.isPrivate or self.currentModule.path notin obj.exportedTo:
if obj.isPrivate or self.currentModule notin obj.exportedTo:
continue
result.add(obj)
@ -727,13 +727,11 @@ method findInModule*(self: Compiler, name: string, module: Name): seq[Name] =
## the current one or not
if name == "":
for obj in reversed(self.names):
if obj.owner.isNil():
continue
if not obj.isPrivate and obj.owner.path == module.path:
if not obj.isPrivate and obj.owner == module:
result.add(obj)
else:
for obj in self.findInModule("", module):
if obj.ident.token.lexeme == name and self.currentModule.path in obj.exportedTo:
if obj.ident.token.lexeme == name and self.currentModule in obj.exportedTo:
result.add(obj)
@ -1036,7 +1034,7 @@ proc declare*(self: Compiler, node: ASTNode): Name {.discardable.} =
break
if name.ident.token.lexeme != declaredName:
continue
if name.owner != n.owner and (name.isPrivate or n.owner.path notin name.exportedTo):
if name.owner != n.owner and (name.isPrivate or n.owner notin name.exportedTo):
continue
if name.kind in [NameKind.Var, NameKind.Module, NameKind.CustomType, NameKind.Enum]:
if name.depth < n.depth:

View File

@ -124,11 +124,11 @@ type
of Reference:
# A managed reference
nullable*: bool # Is null a valid value for this type? (false by default)
value*: TypedNode # The type the reference points to
value*: Type # The type the reference points to
of Pointer:
# An unmanaged reference. Much
# like a raw pointer in C
data*: TypedNode # The type we point to
data*: Type # The type we point to
of TypeDecl:
# A user-defined type
fields*: seq[TypedArgument] # List of fields in the object. May be empty
@ -317,17 +317,17 @@ proc step*(self: Compiler): ASTNode {.inline.} =
# Some forward declarations
proc compareUnions*(self: Compiler, a, b: seq[tuple[match: bool, kind: Type]]): bool
proc expression*(self: Compiler, node: Expression, compile: bool = true): TypedNode {.discardable.} = nil
proc identifier*(self: Compiler, node: IdentExpr, name: Name = nil, compile: bool = true, strict: bool = true): TypedNode {.discardable.} = nil
proc call*(self: Compiler, node: CallExpr, compile: bool = true): TypedNode {.discardable.} = nil
proc getItemExpr*(self: Compiler, node: GetItemExpr, compile: bool = true, matching: Type = nil): TypedNode {.discardable.} = nil
proc unary*(self: Compiler, node: UnaryExpr, compile: bool = true): TypedNode {.discardable.} = nil
proc binary*(self: Compiler, node: BinaryExpr, compile: bool = true): TypedNode {.discardable.} = nil
proc lambdaExpr*(self: Compiler, node: LambdaExpr, compile: bool = true): TypedNode {.discardable.} = nil
proc literal*(self: Compiler, node: ASTNode, compile: bool = true): TypedNode {.discardable.} = nil
proc infer*(self: Compiler, node: LiteralExpr): TypedNode
proc infer*(self: Compiler, node: Expression): TypedNode
proc inferOrError*(self: Compiler, node: Expression): TypedNode
proc expression*(self: Compiler, node: Expression, compile: bool = true): Type {.discardable.} = nil
proc identifier*(self: Compiler, node: IdentExpr, name: Name = nil, compile: bool = true, strict: bool = true): Type {.discardable.} = nil
proc call*(self: Compiler, node: CallExpr, compile: bool = true): Type {.discardable.} = nil
proc getItemExpr*(self: Compiler, node: GetItemExpr, compile: bool = true, matching: Type = nil): Type {.discardable.} = nil
proc unary*(self: Compiler, node: UnaryExpr, compile: bool = true): Type {.discardable.} = nil
proc binary*(self: Compiler, node: BinaryExpr, compile: bool = true): Type {.discardable.} = nil
proc lambdaExpr*(self: Compiler, node: LambdaExpr, compile: bool = true): Type {.discardable.} = nil
proc literal*(self: Compiler, node: ASTNode, compile: bool = true): Type {.discardable.} = nil
proc infer*(self: Compiler, node: LiteralExpr): Type
proc infer*(self: Compiler, node: Expression): Type
proc inferOrError*(self: Compiler, node: Expression): Type
proc findByName*(self: Compiler, name: string): seq[Name]
proc findInModule*(self: Compiler, name: string, module: Name): seq[Name]
proc findByType*(self: Compiler, name: string, kind: Type): seq[Name]
@ -420,7 +420,7 @@ proc compare*(self: Compiler, a, b: Type): bool =
# a and b are of either of the two
# types in this branch, so we just need
# to compare their values
return self.compare(a.value.value, b.value.value)
return self.compare(a.value, b.value)
of Function:
# Functions are a bit trickier to compare
if a.arguments.len() != b.arguments.len():
@ -569,7 +569,7 @@ proc toIntrinsic*(name: string): Type =
return Type(kind: String)
proc infer*(self: Compiler, node: LiteralExpr): TypedNode =
proc infer*(self: Compiler, node: LiteralExpr): Type =
## Infers the type of a given literal expression
if node.isNil():
return nil
@ -577,32 +577,32 @@ proc infer*(self: Compiler, node: LiteralExpr): TypedNode =
of intExpr, binExpr, octExpr, hexExpr:
let size = node.token.lexeme.split("'")
if size.len() == 1:
return TypedNode(node: node, value: Type(kind: Int64))
return Type(kind: Int64)
let typ = size[1].toIntrinsic()
if not self.compare(typ, nil):
return TypedNode(node: node, value: typ)
return typ
else:
self.error(&"invalid type specifier '{size[1]}' for int", node)
of floatExpr:
let size = node.token.lexeme.split("'")
if size.len() == 1:
return TypedNode(node: node, value: Type(kind: Float64))
return Type(kind: Float64)
let typ = size[1].toIntrinsic()
if not typ.isNil():
return TypedNode(node: node, value: typ)
return typ
else:
self.error(&"invalid type specifier '{size[1]}' for float", node)
of trueExpr:
return TypedNode(node: node, value: Type(kind: Bool))
return Type(kind: Bool)
of falseExpr:
return TypedNode(node: node, value: Type(kind: Bool))
return Type(kind: Bool)
of strExpr:
return TypedNode(node: node, value: Type(kind: String))
return Type(kind: String)
else:
discard # Unreachable
proc infer*(self: Compiler, node: Expression): TypedNode =
proc infer*(self: Compiler, node: Expression): Type =
## Infers the type of a given expression and
## returns it
if node.isNil():
@ -621,9 +621,9 @@ proc infer*(self: Compiler, node: Expression): TypedNode =
of NodeKind.callExpr:
result = self.call(CallExpr(node), compile=false)
of NodeKind.refExpr:
result = TypedNode(node: node, value: Type(kind: Reference, value: self.infer(Ref(node).value)))
result = Type(kind: Reference, value: self.infer(Ref(node).value))
of NodeKind.ptrExpr:
result = TypedNode(node: node, value: Type(kind: Pointer, data: self.infer(Ptr(node).value)))
result = Type(kind: Pointer, data: self.infer(Ptr(node).value))
of NodeKind.groupingExpr:
result = self.infer(GroupingExpr(node).expression)
of NodeKind.getItemExpr:
@ -634,7 +634,7 @@ proc infer*(self: Compiler, node: Expression): TypedNode =
discard # TODO
proc inferOrError*(self: Compiler, node: Expression): TypedNode =
proc inferOrError*(self: Compiler, node: Expression): Type =
## Attempts to infer the type of
## the given expression and raises an
## error if it fails
@ -648,16 +648,16 @@ proc stringify*(self: Compiler, typ: Type): string =
## type object
if typ.isNil():
return "nil"
case typ.kind:
case typ.value.kind:
of Int8, UInt8, Int16, UInt16, Int32,
UInt32, Int64, UInt64, Float32, Float64,
Char, Byte, String, Nil, TypeKind.Nan, Bool,
TypeKind.Inf, Auto:
result &= ($typ.kind).toLowerAscii()
result &= ($typ.value.kind).toLowerAscii()
of Pointer:
result &= &"ptr {self.stringify(typ)}"
result &= &"ptr {self.stringify(typ.value)}"
of Reference:
result &= &"ref {self.stringify(typ)}"
result &= &"ref {self.stringify(typ.value)}"
of Any:
return "any"
of Union:
@ -770,9 +770,9 @@ proc check*(self: Compiler, term: Expression, kind: Type) {.inline.} =
## Raises an error if appropriate and returns
## otherwise
let k = self.inferOrError(term)
if not self.compare(k.value, kind):
if not self.compare(k, kind):
self.error(&"expecting value of type {self.stringify(kind)}, got {self.stringify(k)}", term)
elif k.value.kind == Any and kind.kind != Any:
elif k.kind == Any and kind.kind != Any:
self.error(&"any is not a valid type in this context")
@ -857,7 +857,7 @@ proc unpackGenerics*(self: Compiler, condition: Expression, list: var seq[tuple[
## Recursively unpacks a type constraint in a generic type
case condition.kind:
of identExpr:
list.add((accept, self.inferOrError(condition).value))
list.add((accept, self.inferOrError(condition)))
if list[^1].kind.kind == Auto:
self.error("automatic types cannot be used within generics", condition)
of binaryExpr:
@ -883,7 +883,7 @@ proc unpackUnion*(self: Compiler, condition: Expression, list: var seq[tuple[mat
## Recursively unpacks a type union
case condition.kind:
of identExpr:
list.add((accept, self.inferOrError(condition).value))
list.add((accept, self.inferOrError(condition)))
of binaryExpr:
let condition = BinaryExpr(condition)
case condition.operator.lexeme:
@ -966,13 +966,13 @@ proc declare*(self: Compiler, node: ASTNode): Name {.discardable.} =
n.isGeneric = true
var typ: Type
for argument in node.arguments:
typ = self.infer(argument.valueType).value
typ = self.infer(argument.valueType)
if not typ.isNil() and typ.kind == Auto:
n.obj.value.isAuto = true
if n.isGeneric:
self.error("automatic types cannot be used within generics", argument.valueType)
break
typ = self.infer(node.returnType).value
typ = self.infer(node.returnType)
if not typ.isNil() and typ.kind == Auto:
n.obj.value.isAuto = true
if n.isGeneric:
@ -1023,7 +1023,7 @@ proc declare*(self: Compiler, node: ASTNode): Name {.discardable.} =
else:
case node.value.kind:
of identExpr:
n.obj.value = self.inferOrError(node.value).value
n.obj.value = self.inferOrError(node.value)
of binaryExpr:
# Type union
n.obj.value = Type(kind: Union, types: @[])

View File

@ -46,21 +46,10 @@ type
## - After that follows the argument count as a 1 byte integer
## - Lastly, the function's name (optional) is encoded in ASCII, prepended with
## its size as a 2-byte integer
## modules contains information about all the peon modules that the compiler has encountered,
## along with their start/end offset in the code. Unlike other bytecode-compiled languages like
## Python, peon does not produce a bytecode file for each separate module it compiles: everything
## is contained within a single binary blob. While this simplifies the implementation and makes
## bytecode files entirely "self-hosted", it also means that the original module information is
## lost: this segment serves to fix that. The segment's size is encoded at the beginning as a 4-byte
## sequence (i.e. a single 32-bit integer) and its encoding is similar to that of the functions segment:
## - First, the position into the bytecode where the module begins is encoded (as a 3 byte integer)
## - Second, the position into the bytecode where the module ends is encoded (as a 3 byte integer)
## - Lastly, the module's name is encoded in ASCII, prepended with its size as a 2-byte integer
consts*: seq[uint8]
code*: seq[uint8]
lines*: seq[int]
functions*: seq[uint8]
modules*: seq[uint8]
OpCode* {.pure.} = enum
## Enum of Peon's bytecode opcodes

View File

@ -1006,7 +1006,7 @@ proc terminateProgram(self: BytecodeCompiler, pos: int) =
self.emitByte(ReplExit, self.peek().token.line)
else:
self.emitByte(OpCode.Return, self.peek().token.line)
self.emitByte(0, self.peek().token.line) # Entry point has no return value
self.emitByte(0, self.peek().token.line) # Entry point has no return value (TODO: Add easter eggs, cuz why not)
self.patchReturnAddress(pos)
@ -1478,9 +1478,8 @@ method lambdaExpr(self: BytecodeCompiler, node: LambdaExpr, compile: bool = true
line: node.token.line,
kind: NameKind.Function,
belongsTo: function,
isReal: true,
)
if compile and node notin self.lambdas and not node.body.isNil():
isReal: true)
if compile and node notin self.lambdas:
self.lambdas.add(node)
let jmp = self.emitJump(JumpForwards, node.token.line)
if BlockStmt(node.body).code.len() == 0:
@ -1688,7 +1687,7 @@ proc importStmt(self: BytecodeCompiler, node: ImportStmt, compile: bool = true)
# Importing a module automatically exports
# its public names to us
for name in self.findInModule("", module):
name.exportedTo.incl(self.currentModule.path)
name.exportedTo.incl(self.currentModule)
except IOError:
self.error(&"could not import '{module.ident.token.lexeme}': {getCurrentExceptionMsg()}")
except OSError:
@ -1706,22 +1705,22 @@ proc exportStmt(self: BytecodeCompiler, node: ExportStmt, compile: bool = true)
var name = self.resolveOrError(node.name)
if name.isPrivate:
self.error("cannot export private names")
name.exportedTo.incl(self.parentModule.path)
name.exportedTo.incl(self.parentModule)
case name.kind:
of NameKind.Module:
# We need to export everything
# this module defines!
for name in self.findInModule("", name):
name.exportedTo.incl(self.parentModule.path)
name.exportedTo.incl(self.parentModule)
of NameKind.Function:
# Only exporting a single function (or, well
# all of its implementations)
for name in self.findByName(name.ident.token.lexeme):
if name.kind != NameKind.Function:
continue
name.exportedTo.incl(self.parentModule.path)
name.exportedTo.incl(self.parentModule)
else:
self.error("unsupported export type")
discard
proc breakStmt(self: BytecodeCompiler, node: BreakStmt) =
@ -2074,7 +2073,6 @@ proc compile*(self: BytecodeCompiler, ast: seq[Declaration], file: string, lines
self.disabledWarnings = disabledWarnings
self.showMismatches = showMismatches
self.mode = mode
let start = self.chunk.code.len()
if not incremental:
self.jumps = @[]
let pos = self.beginProgram()
@ -2083,6 +2081,8 @@ proc compile*(self: BytecodeCompiler, ast: seq[Declaration], file: string, lines
while not self.done():
self.declaration(Declaration(self.step()))
self.terminateProgram(pos)
# TODO: REPL is broken, we need a new way to make
# incremental compilation resume from where it stopped!
result = self.chunk
@ -2100,7 +2100,7 @@ proc compileModule(self: BytecodeCompiler, module: Name) =
break
elif i == searchPath.high():
self.error(&"""could not import '{path}': module not found""")
if self.modules.contains(module.path):
if self.modules.contains(module):
return
let source = readFile(path)
let current = self.current
@ -2115,19 +2115,11 @@ proc compileModule(self: BytecodeCompiler, module: Name) =
self.replMode = false
self.parentModule = currentModule
self.currentModule = module
let start = self.chunk.code.len()
discard self.compile(self.parser.parse(self.lexer.lex(source, path),
path, self.lexer.getLines(),
self.lexer.getSource(), persist=true),
path, self.lexer.getLines(), self.lexer.getSource(), chunk=self.chunk, incremental=true,
isMainModule=false, self.disabledWarnings, self.showMismatches, self.mode)
# Mark the end of a new module
self.chunk.modules.extend(start.toTriple())
self.chunk.modules.extend(self.chunk.code.high().toTriple())
# I swear to god if someone ever creates a peon module with a name that's
# longer than 2^16 bytes I will hit them with a metal pipe. Mark my words
self.chunk.modules.extend(self.currentModule.ident.token.lexeme.len().toDouble())
self.chunk.modules.extend(self.currentModule.ident.token.lexeme.toBytes())
module.file = path
# No need to save the old scope depth: import statements are
# only allowed at the top level!
@ -2141,4 +2133,4 @@ proc compileModule(self: BytecodeCompiler, module: Name) =
self.replMode = replMode
self.lines = lines
self.source = src
self.modules.incl(module.path)
self.modules.incl(module)

View File

@ -22,15 +22,12 @@ import std/terminal
type
Function = object
start, stop, argc: int
name: string
Module = object
start, stop: int
Function = ref object
start, stop, bottom, argc: int
name: string
started, stopped: bool
Debugger* = ref object
chunk: Chunk
modules: seq[Module]
functions: seq[Function]
current: int
@ -69,38 +66,21 @@ proc checkFunctionStart(self: Debugger, n: int) =
## Checks if a function begins at the given
## bytecode offset
for i, e in self.functions:
# Avoids duplicate output
if n == e.start:
if n == e.start and not (e.started or e.stopped):
e.started = true
styledEcho fgBlue, "\n==== Peon Bytecode Disassembler - Function Start ", fgYellow, &"'{e.name}' ", fgBlue, "(", fgYellow, $i, fgBlue, ") ===="
styledEcho fgGreen, "\t- Start offset: ", fgYellow, $e.start
styledEcho fgGreen, "\t- End offset: ", fgYellow, $e.stop
styledEcho fgGreen, "\t- Argument count: ", fgYellow, $e.argc, "\n"
styledEcho fgGreen, "\t- Argument count: ", fgYellow, $e.argc
proc checkFunctionEnd(self: Debugger, n: int) =
## Checks if a function ends at the given
## bytecode offset
for i, e in self.functions:
if n == e.stop:
if n == e.stop and e.started and not e.stopped:
e.stopped = true
styledEcho fgBlue, "\n==== Peon Bytecode Disassembler - Function End ", fgYellow, &"'{e.name}' ", fgBlue, "(", fgYellow, $i, fgBlue, ") ===="
proc checkModuleStart(self: Debugger, n: int) =
## Checks if a module begins at the given
## bytecode offset
for i, m in self.modules:
if m.start == n:
styledEcho fgBlue, "\n==== Peon Bytecode Disassembler - Module Start ", fgYellow, &"'{m.name}' ", fgBlue, "(", fgYellow, $i, fgBlue, ") ===="
styledEcho fgGreen, "\t- Start offset: ", fgYellow, $m.start
styledEcho fgGreen, "\t- End offset: ", fgYellow, $m.stop, "\n"
proc checkModuleEnd(self: Debugger, n: int) =
## Checks if a module ends at the given
## bytecode offset
for i, m in self.modules:
if m.stop == n:
styledEcho fgBlue, "\n==== Peon Bytecode Disassembler - Module End ", fgYellow, &"'{m.name}' ", fgBlue, "(", fgYellow, $i, fgBlue, ") ===="
proc simpleInstruction(self: Debugger, instruction: OpCode) =
@ -114,6 +94,9 @@ proc simpleInstruction(self: Debugger, instruction: OpCode) =
else:
stdout.styledWriteLine(fgYellow, "No")
self.current += 1
self.checkFunctionEnd(self.current - 2)
self.checkFunctionEnd(self.current - 1)
self.checkFunctionEnd(self.current)
proc stackTripleInstruction(self: Debugger, instruction: OpCode) =
@ -185,27 +168,20 @@ proc jumpInstruction(self: Debugger, instruction: OpCode) =
self.current += 4
while self.chunk.code[self.current] == NoOp.uint8:
inc(self.current)
for i in countup(orig, self.current + 1):
self.checkFunctionStart(i)
proc disassembleInstruction*(self: Debugger) =
## Takes one bytecode instruction and prints it
let opcode = OpCode(self.chunk.code[self.current])
self.checkModuleStart(self.current)
self.checkFunctionStart(self.current)
printDebug("Offset: ")
stdout.styledWriteLine(fgYellow, $(self.current))
printDebug("Line: ")
stdout.styledWriteLine(fgYellow, &"{self.chunk.getLine(self.current)}")
var opcode = OpCode(self.chunk.code[self.current])
case opcode:
of simpleInstructions:
self.simpleInstruction(opcode)
# Functions (and modules) only have a single return statement at the
# end of their body, so we never execute this more than once per module/function
if opcode == Return:
# -2 to skip the hardcoded argument to return
# and the increment by simpleInstruction()
self.checkFunctionEnd(self.current - 2)
self.checkModuleEnd(self.current - 1)
of constantInstructions:
self.constantInstruction(opcode)
of stackDoubleInstructions:
@ -221,9 +197,7 @@ proc disassembleInstruction*(self: Debugger) =
else:
echo &"DEBUG - Unknown opcode {opcode} at index {self.current}"
self.current += 1
proc parseFunctions(self: Debugger) =
## Parses function information in the chunk
@ -232,7 +206,7 @@ proc parseFunctions(self: Debugger) =
name: string
idx = 0
size = 0
while idx < self.chunk.functions.high():
while idx < len(self.chunk.functions) - 1:
start = int([self.chunk.functions[idx], self.chunk.functions[idx + 1], self.chunk.functions[idx + 2]].fromTriple())
idx += 3
stop = int([self.chunk.functions[idx], self.chunk.functions[idx + 1], self.chunk.functions[idx + 2]].fromTriple())
@ -246,36 +220,15 @@ proc parseFunctions(self: Debugger) =
self.functions.add(Function(start: start, stop: stop, argc: argc, name: name))
proc parseModules(self: Debugger) =
## Parses module information in the chunk
var
start, stop: int
name: string
idx = 0
size = 0
while idx < self.chunk.modules.high():
start = int([self.chunk.modules[idx], self.chunk.modules[idx + 1], self.chunk.modules[idx + 2]].fromTriple())
idx += 3
stop = int([self.chunk.modules[idx], self.chunk.modules[idx + 1], self.chunk.modules[idx + 2]].fromTriple())
idx += 3
size = int([self.chunk.modules[idx], self.chunk.modules[idx + 1]].fromDouble())
idx += 2
name = self.chunk.modules[idx..<idx + size].fromBytes()
inc(idx, size)
self.modules.add(Module(start: start, stop: stop, name: name))
proc disassembleChunk*(self: Debugger, chunk: Chunk, name: string) =
## Takes a chunk of bytecode and prints it
self.chunk = chunk
styledEcho fgBlue, &"==== Peon Bytecode Disassembler - Chunk '{name}' ====\n"
self.current = 0
self.parseFunctions()
self.parseModules()
while self.current < self.chunk.code.len:
self.disassembleInstruction()
echo ""
styledEcho fgBlue, &"==== Peon Bytecode Disassembler - Chunk '{name}' ===="

View File

@ -64,8 +64,7 @@ proc newSerializer*(self: Serializer = nil): Serializer =
proc writeHeaders(self: Serializer, stream: var seq[byte]) =
## Writes the Peon bytecode headers in-place into the
## given byte sequence
## Writes the Peon bytecode headers in-place into a byte stream
stream.extend(PeonBytecodeMarker.toBytes())
stream.add(byte(PEON_VERSION.major))
stream.add(byte(PEON_VERSION.minor))
@ -78,31 +77,25 @@ proc writeHeaders(self: Serializer, stream: var seq[byte]) =
proc writeLineData(self: Serializer, stream: var seq[byte]) =
## Writes line information for debugging
## bytecode instructions to the given byte
## sequence
## bytecode instructions
stream.extend(len(self.chunk.lines).toQuad())
for b in self.chunk.lines:
stream.extend(b.toTriple())
proc writeFunctions(self: Serializer, stream: var seq[byte]) =
## Writes debug info about functions to the
## given byte sequence
proc writeCFIData(self: Serializer, stream: var seq[byte]) =
## Writes Call Frame Information for debugging
## functions
stream.extend(len(self.chunk.functions).toQuad())
stream.extend(self.chunk.functions)
proc writeConstants(self: Serializer, stream: var seq[byte]) =
## Writes the constants table in-place into the
## byte sequence
## given stream
stream.extend(self.chunk.consts.len().toQuad())
stream.extend(self.chunk.consts)
proc writeModules(self: Serializer, stream: var seq[byte]) =
## Writes module information to the given stream
stream.extend(self.chunk.modules.len().toQuad())
stream.extend(self.chunk.modules)
for constant in self.chunk.consts:
stream.add(constant)
proc writeCode(self: Serializer, stream: var seq[byte]) =
@ -113,7 +106,7 @@ proc writeCode(self: Serializer, stream: var seq[byte]) =
proc readHeaders(self: Serializer, stream: seq[byte], serialized: Serialized): int =
## Reads the bytecode headers from a given sequence
## Reads the bytecode headers from a given stream
## of bytes
var stream = stream
if stream[0..<len(PeonBytecodeMarker)] != PeonBytecodeMarker.toBytes():
@ -138,6 +131,7 @@ proc readHeaders(self: Serializer, stream: seq[byte], serialized: Serialized): i
result += 8
proc readLineData(self: Serializer, stream: seq[byte]): int =
## Reads line information from a stream
## of bytes
@ -148,11 +142,10 @@ proc readLineData(self: Serializer, stream: seq[byte]): int =
self.chunk.lines.add(int([stream[0], stream[1], stream[2]].fromTriple()))
result += 3
stream = stream[3..^1]
doAssert len(self.chunk.lines) == int(size)
proc readFunctions(self: Serializer, stream: seq[byte]): int =
## Reads the function segment from a stream
proc readCFIData(self: Serializer, stream: seq[byte]): int =
## Reads Call Frame Information from a stream
## of bytes
let size = [stream[0], stream[1], stream[2], stream[3]].fromQuad()
result += 4
@ -160,34 +153,22 @@ proc readFunctions(self: Serializer, stream: seq[byte]): int =
for i in countup(0, int(size) - 1):
self.chunk.functions.add(stream[i])
inc(result)
doAssert len(self.chunk.functions) == int(size)
proc readConstants(self: Serializer, stream: seq[byte]): int =
## Reads the constant table from the given
## byte sequence
## Reads the constant table from the given stream
## of bytes
let size = [stream[0], stream[1], stream[2], stream[3]].fromQuad()
result += 4
var stream = stream[4..^1]
for i in countup(0, int(size) - 1):
self.chunk.consts.add(stream[i])
inc(result)
doAssert len(self.chunk.consts) == int(size)
proc readModules(self: Serializer, stream: seq[byte]): int =
## Reads module information
let size = [stream[0], stream[1], stream[2], stream[3]].fromQuad()
result += 4
var stream = stream[4..^1]
for i in countup(0, int(size) - 1):
self.chunk.modules.add(stream[i])
inc(result)
doAssert len(self.chunk.modules) == int(size)
proc readCode(self: Serializer, stream: seq[byte]): int =
## Reads the bytecode from a given byte sequence
## Reads the bytecode from a given stream and writes
## it into the given chunk
let size = [stream[0], stream[1], stream[2]].fromTriple()
var stream = stream[3..^1]
for i in countup(0, int(size) - 1):
@ -197,16 +178,13 @@ proc readCode(self: Serializer, stream: seq[byte]): int =
proc dumpBytes*(self: Serializer, chunk: Chunk, filename: string): seq[byte] =
## Dumps the given chunk to a sequence of bytes and returns it.
## The filename argument is for error reporting only, use dumpFile
## to dump bytecode to a file
## Dumps the given bytecode and file to a sequence of bytes and returns it.
self.filename = filename
self.chunk = chunk
self.writeHeaders(result)
self.writeLineData(result)
self.writeFunctions(result)
self.writeCFIData(result)
self.writeConstants(result)
self.writeModules(result)
self.writeCode(result)
@ -229,9 +207,8 @@ proc loadBytes*(self: Serializer, stream: seq[byte]): Serialized =
try:
stream = stream[self.readHeaders(stream, result)..^1]
stream = stream[self.readLineData(stream)..^1]
stream = stream[self.readFunctions(stream)..^1]
stream = stream[self.readCFIData(stream)..^1]
stream = stream[self.readConstants(stream)..^1]
stream = stream[self.readModules(stream)..^1]
stream = stream[self.readCode(stream)..^1]
except IndexDefect:
self.error("truncated bytecode stream")

View File

@ -246,11 +246,6 @@ proc runFile(f: string, fromString: bool = false, dump: bool = true, breakpoints
styledEcho fgGreen, "OK"
else:
styledEcho fgRed, "Corrupted"
stdout.styledWrite(fgBlue, "\t- Modules segment: ")
if serialized.chunk.modules == compiled.modules:
styledEcho fgGreen, "OK"
else:
styledEcho fgRed, "Corrupted"
if run:
case backend:
of PeonBackend.Bytecode:

View File

@ -1,7 +1,7 @@
import std;
const max = 500000;
const max = 50000;
var x = max;
var s = "just a test";