Golang wrapper for WASM3, WIP.
This is part of a series of WASM-related experiments: go-wavm and go-wasm-benchmark.
This is a fork of go-wasm3 by matiasinsaurralde starting from another fork.
- Add android static libraries to allow building in gomobile
- Add
Runtime.ResizeMemory()
- Add
Module.LinkRawFunction()
- Remove
Function.CallWithArgs()
- Allow any compatible input/output type in
Function.Call()
Build example for Android:
set -ex
mkdir -p /tmp/gomobile
docker run -it \
--mount type=bind,source=$HOME/git,target=/root/git,readonly \
--mount type=bind,source=/tmp/gomobile,target=/tmp/gomobile \
ed255/gomobile-android:latest \
/bin/bash -c 'set -ex && \
apt-get update && \
apt-get install -y cmake && \
rm -r /tmp/gomobile/git || true && \
mkdir -p /tmp/gomobile/git && \
cp -r /root/git/go-wasm3 /tmp/gomobile/git && \
cp -r /root/git/wasm3 /tmp/gomobile/git && \
cd /tmp/gomobile/git/wasm3 && \
cd android && \
rm -r build || true && \
mkdir build && \
cd build && \
NDK_HOME=/opt/android-ndk/android-ndk-r20 ../make_all.sh && \
cp -r android /tmp/gomobile/git/go-wasm3/lib/
cd /tmp/gomobile/git/go-wasm3 && \
go build && \
gomobile bind -androidapi=16 --target android -o /tmp/gomobile/wasm.aar'
# /bin/bash
This package ships with pre-built WASM3
libraries (static builds) for Linux and Android. If you want to hack around it, check the original repository.
Check the building instructions for Android if you want to rebuild the static libraries.
If you're using one of the mentioned platforms, you may install the package using go get
:
$ go get -u github.com/iden3/go-wasm3
To inspect or run the little sample use:
$ cd go-wasm3/examples/sum
$ go build # or "go run sum.go"
$ ./sum
The output will look as follows:
2020/01/15 09:51:24 Initializing WASM3
2020/01/15 09:51:24 Runtime ok
2020/01/15 09:51:24 Read WASM module (139 bytes)
2020/01/15 09:51:24 Module loaded
2020/01/15 09:51:24 Calling function
Result: 3
Result: 4
You will find additional sample projects in the next section.
This program uses the boa engine to evaluate JS code. Boa is an embeddable JS engine written in Rust, for this sample it was compiled targeting WASM.
Link here.
This program loads libxml2 as a WASM module (it's a custom build, full instructions here). The library is used to validate a XML file against a XSD (both loaded from the Go side).
Link here.
Take the following sample program:
#include <stdlib.h>
#include <string.h>
char* somecall() {
// Allocate a few bytes on the heap:
char* test = (char*) malloc(12*sizeof(char));
// Copy a string into the previously defined address:
strcpy(test, "testingonly");
// Return the pointer:
return test;
}
Build it using wasicc
, this will generate a cstring.wasm
file (WASM module):
wasicc cstring.c -Wl,--export-all -o cstring.wasm
The following Go code will load the WASM module and retrieve the data after calling somecall
:
// Initialize the runtime and load the module:
env := wasm3.NewEnvironment()
defer env.Destroy()
runtime := wasm3.NewRuntime(env, 64*1024)
defer runtime.Destroy()
wasmBytes, err := ioutil.ReadFile("program.wasm")
module, _ := env.ParseModule(wasmBytes)
runtime.LoadModule(module)
fn, _ := runtime.FindFunction(fnName)
// Call somecall and get the pointer to our data:
result := fn()
// Reconstruct the string from memory:
memoryLength = runtime.GetAllocatedMemoryLength()
mem := runtime.GetMemory(memoryLength, 0)
// Initialize a Go buffer:
buf := new(bytes.Buffer)
for n := 0; n < memoryLength; n++ {
if n < result {
continue
}
value := mem[n]
if value == 0 {
break
}
buf.WriteByte(value)
}
// Print the string: "testingonly"
str := buf.String()
fmt.Println(str)
For more details check this.
This is a WIP. Stay tuned!
A Rust wrapper is available here.
MIT.
wasm3 is also under this license.