freakynit / luna

🌙 A tiny sample compiler for WebAssembly Text Format, written in Go and built as one of my quest to conquer the WebAssembly dungeon

Luna 🌙

Luna is a reeeaaally tiny, yet expanding, sample compiler for WebAssembly Text Format, written in Go and built as one of my quest to conquer the WebAssembly dungeon.

(I just wanted to build something like wat2wasm)

It is so tiny that can only make additions lol.

I've built Luna because I wanted to learn how to build a compiler while learning WebAssembly.

The goal of Luna is not to replace (in a long distant future) solid tools like wat2wasm, wasmer or others; nor to do fancy stuff, the goal of this project is to be useful for anyone approaching WebAssembly and/or as a blueprint for anyone that wants to develop a compiled-to-wasm programming language.

I tried to document each section of the code as much as I could (I'm still doing it) with link to resources I've studied while building this, but if you want to improve it, feel free to open issues and pull requests.

How it works

Followed the amazing articles about the Chasm compiler (a WAT compiler written in Typescript for the Chasm language) and a guide to write a WAT compiler in Rust

• Luna takes a .wat file (or string if used in the browser)
• Splits it into tokens ./compiler/tokenizer.go
• Creates a very simple AST of the tokens ./compiler/parser.go
• Compiles ./compiler/compiler.go

Use it in the browser

Luna can also be used in the browsers

Demo: https://luna-demo.vercel.app/

The

make wasm

or

make update

commands will build (or update) with TinyGo the ./example/main.wasm file to be imported in the browser In the ./example directory there's a working example of how to do that.

Requirements

• Go
• Tinygo
• Make
• syscall/js set up (or simply comment out the startLuna function and the syscall/js import)

Roadmap

1. More interactivity

Currently Luna supports only the renaming of the exported function and some order scrumbling

2. More arithmetics

Currently Luna supports only addition

3. Expansion of Wat syntax

Luna is by no means finished there are a lot of things that can be implemented and A LOT of things that can be improved. Any suggestions, pull requests, issues or feedback is greatly welcomed!!!