b758344212
This renames `InstantiateModuleFromBinary` to `Instantiate` to both make first time use simpler to write and also de-complicate adding a `WithConfig` variant as requested in #1105 End users in simple case need to change their signature like so. ```diff - mod, err := r.InstantiateModuleFromBinary(ctx, addWasm) + mod, err := r.Instantiate(ctx, addWasm) ``` In practice, many will not need to change their signature because they had to use the `InstantiateModule` function in order to assign configuration such as the module name, filesystem or use a real clock. Instead, they had to use the more complicated chain of `CompileModule` and `InstantiateModule` even when only assigning config. Users in this situation can opt into the more simplified syntax below: ```go mod, err := r.InstantiateWithConfig(ctx, addWasm, wazero.NewModuleConfig().WithName("adder")) ``` ```diff - mod, err := r.InstantiateModuleFromBinary(ctx, addWasm) + mod, err := r.Instantiate(ctx, addWasm) ``` Signed-off-by: Adrian Cole <adrian@tetrate.io>
74 lines
2.1 KiB
Go
74 lines
2.1 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
_ "embed"
|
|
"fmt"
|
|
"log"
|
|
"os"
|
|
"strconv"
|
|
|
|
"github.com/tetratelabs/wazero"
|
|
"github.com/tetratelabs/wazero/imports/assemblyscript"
|
|
)
|
|
|
|
// asWasm compiled using `npm install && npm run build`
|
|
//
|
|
//go:embed testdata/index.wasm
|
|
var asWasm []byte
|
|
|
|
// main shows how to interact with a WebAssembly function that was compiled
|
|
// from AssemblyScript
|
|
//
|
|
// See README.md for a full description.
|
|
func main() {
|
|
// Choose the context to use for function calls.
|
|
ctx := context.Background()
|
|
|
|
// Create a new WebAssembly Runtime.
|
|
r := wazero.NewRuntime(ctx)
|
|
defer r.Close(ctx) // This closes everything this Runtime created.
|
|
|
|
// Instantiate a module implementing functions used by AssemblyScript.
|
|
// Thrown errors will be logged to os.Stderr
|
|
_, err := assemblyscript.Instantiate(ctx, r)
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
|
|
// Instantiate a WebAssembly module that imports the "abort" and "trace"
|
|
// functions defined by assemblyscript.Instantiate and exports functions
|
|
// we'll use in this example.
|
|
mod, err := r.InstantiateWithConfig(ctx, asWasm,
|
|
// Override the default module config that discards stdout and stderr.
|
|
wazero.NewModuleConfig().WithStdout(os.Stdout).WithStderr(os.Stderr))
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
|
|
// Get references to WebAssembly functions we'll use in this example.
|
|
helloWorld := mod.ExportedFunction("hello_world")
|
|
goodbyeWorld := mod.ExportedFunction("goodbye_world")
|
|
|
|
// Let's use the argument to this main function in Wasm.
|
|
numStr := os.Args[1]
|
|
num, err := strconv.Atoi(numStr)
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
|
|
// Call hello_world, which returns the input value incremented by 3.
|
|
// While this calls trace(), our configuration didn't enable it.
|
|
results, err := helloWorld.Call(ctx, uint64(num))
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
fmt.Printf("hello_world returned: %v", results[0])
|
|
|
|
// Call goodbye_world, which aborts with an error.
|
|
// assemblyscript.Instantiate was configured above to abort to stderr.
|
|
if _, err = goodbyeWorld.Call(ctx); err == nil {
|
|
log.Panicln("goodbye_world did not fail")
|
|
}
|
|
}
|