Kong is a small, self-contained compiler and bytecode virtual machine that implements the Monkey programming language.
Kong compiles Monkey source code to compact bytecode and executes it with a stack-based VM. A built-in REPL lets you experiment with the language interactively.
It is a faster, more efficient, and more robust Monke.
- Lexer: Tokenizes input source code.
- Parser: Builds an Abstract Syntax Tree (AST) from tokens.
- AST: Represents the structure of parsed code.
- Compiler: Translates the AST to bytecode.
- Virtual Machine (VM): Stack-based VM that executes the bytecode.
- REPL: Interactive shell for running Monkey code.
- Built-in Functions: Includes basic built-in functions for convenience.
- First-class Functions: Supports functions as first-class citizens, including closures.
- Data Structures: Supports arrays and hash maps.
- Error Handling: Graceful handling of syntax and runtime errors.
- Go 1.25 or newer
To install Kong, you can install it via go install:
go install github.com/dr8co/kong@latestThis will install the kong executable in your $GOPATH/bin directory.
You can also clone the repository and build it manually:
git clone https://github.com/dr8co/kong.git
cd kong
go buildPre-built binaries are available for download.
See the Releases Page.
main.go— CLI & entry point. Starts the REPL by default.token/— Token definitions.lexer/— Lexical analyzer (tokenizer).parser/— Parses Monkey source code into an Abstract Syntax Tree (AST).ast/— Abstract Syntax Tree definitions.object/— runtime value representations and environment.compiler/— Compiler that generates bytecode.code/— Bytecode instruction definitions and helpers.vm/— Virtual Machine that executes bytecode.repl/— the REPL that wires compiler + VM to provide a persistent interactive session.docs/— design docs, language spec, REPL guide and examples.
Evaluate a single expression from the command line:
kong -e 'let x = 5; x + 10;'Run kong -h for help and options.
To start the REPL, run kong with no arguments:
kong # if you installed via go install, ensure $GOPATH/bin is in your PATH
# or
./kong # if you built manually or downloaded the binary$ kong
>> let x = 5;
5
>> x + 10;
15
>> let add = fn(a, b) { a + b; };
Closure[0xc000200000]
>> add(2, 3);
5
>> let arr = [1, 2, 3];
[1, 2, 3]
>> arr[1];
2
>> last(arr);
3
>> puts("Hello, Kong!");
Hello, Kong!
nullTo run the tests:
go test ./...- Language specification:
docs/language_spec.md(Monkey syntax & semantics) - Architecture & design decisions:
docs/architecture.md(Kong compiler and VM) - REPL guide & examples:
docs/repl_guide.mdanddocs/examples/
For more details and examples, check the documentation.
Contributions are welcome! Please open issues or submit pull requests for improvements or bug fixes. See CONTRIBUTING.md for guidelines.
This project is licensed under the MIT License. See the LICENSE file for details.