README
¶
wagon
wagon is a WebAssembly-based interpreter in Go, for Go.
NOTE: wagon requires Go >= 1.9.x.
Purpose
wagon aims to provide tools (executables+libraries) to:
- decode
wasmbinary files - load and execute
wasmmodules' bytecode.
wagon doesn't concern itself with the production of the wasm binary files;
these files should be produced with another tool (such as wabt or binaryen.)
wagon may provide a utility to produce wasm files from wast or wat files (and vice versa.)
The primary goal of wagon is to provide the building blocks to be able to build an interpreter for Go code, that could be embedded in Jupyter or any Go program.
Contributing
See the CONTRIBUTING guide for pointers on how to contribute to go-interpreter and wagon.
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
Package disasm provides functions for disassembling WebAssembly bytecode.
|
Package disasm provides functions for disassembling WebAssembly bytecode. |
|
Package exec provides functions for executing WebAssembly bytecode.
|
Package exec provides functions for executing WebAssembly bytecode. |
|
internal/compile
Package compile is used internally by wagon to convert standard structured WebAssembly bytecode into an unstructured form suitable for execution by it's VM.
|
Package compile is used internally by wagon to convert standard structured WebAssembly bytecode into an unstructured form suitable for execution by it's VM. |
|
internal
|
|
|
stack
Package stack implements a growable uint64 stack
|
Package stack implements a growable uint64 stack |
|
Package validate provides functions for validating WebAssembly modules.
|
Package validate provides functions for validating WebAssembly modules. |
|
Package wasm provides functions for reading and parsing WebAssembly modules.
|
Package wasm provides functions for reading and parsing WebAssembly modules. |
|
leb128
Package leb128 provides functions for reading integer values encoded in the Little Endian Base 128 (LEB128) format: https://en.wikipedia.org/wiki/LEB128
|
Package leb128 provides functions for reading integer values encoded in the Little Endian Base 128 (LEB128) format: https://en.wikipedia.org/wiki/LEB128 |
|
operators
Package operators provides all operators used by WebAssembly bytecode, together with their parameter and return type(s).
|
Package operators provides all operators used by WebAssembly bytecode, together with their parameter and return type(s). |
|
Package wast implements a WebAssembly text format.
|
Package wast implements a WebAssembly text format. |
Click to show internal directories.
Click to hide internal directories.