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>
89 lines
2.5 KiB
Go
89 lines
2.5 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
_ "embed"
|
|
"fmt"
|
|
"log"
|
|
"os"
|
|
"strconv"
|
|
"time"
|
|
|
|
"github.com/tetratelabs/wazero"
|
|
)
|
|
|
|
// ageCalculatorWasm was generated by the following:
|
|
//
|
|
// cd testdata; wat2wasm --debug-names age_calculator.wat
|
|
//
|
|
//go:embed testdata/age_calculator.wasm
|
|
var ageCalculatorWasm []byte
|
|
|
|
// main shows how to define, import and call a Go-defined function from a
|
|
// WebAssembly-defined function.
|
|
//
|
|
// 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 Go-defined module named "env" that exports functions to
|
|
// get the current year and log to the console.
|
|
//
|
|
// Note: As noted on wazero.HostFunctionBuilder documentation, function
|
|
// signatures are constrained to a subset of numeric types.
|
|
// Note: "env" is a module name conventionally used for arbitrary
|
|
// host-defined functions, but any name would do.
|
|
_, err := r.NewHostModuleBuilder("env").
|
|
NewFunctionBuilder().
|
|
WithFunc(func(v uint32) {
|
|
fmt.Println("log_i32 >>", v)
|
|
}).
|
|
Export("log_i32").
|
|
NewFunctionBuilder().
|
|
WithFunc(func() uint32 {
|
|
if envYear, err := strconv.ParseUint(os.Getenv("CURRENT_YEAR"), 10, 64); err == nil {
|
|
return uint32(envYear) // Allow env-override to prevent annual test maintenance!
|
|
}
|
|
return uint32(time.Now().Year())
|
|
}).
|
|
Export("current_year").
|
|
Instantiate(ctx)
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
|
|
// Instantiate a WebAssembly module named "age-calculator" that imports
|
|
// functions defined in "env".
|
|
//
|
|
// Note: The import syntax in both Text and Binary format is the same
|
|
// regardless of if the function was defined in Go or WebAssembly.
|
|
ageCalculator, err := r.Instantiate(ctx, ageCalculatorWasm)
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
|
|
// Read the birthYear from the arguments to main
|
|
birthYear, err := strconv.ParseUint(os.Args[1], 10, 64)
|
|
if err != nil {
|
|
log.Panicf("invalid arg %v: %v", os.Args[1], err)
|
|
}
|
|
|
|
// First, try calling the "get_age" function and printing to the console externally.
|
|
results, err := ageCalculator.ExportedFunction("get_age").Call(ctx, birthYear)
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
fmt.Println("println >>", results[0])
|
|
|
|
// First, try calling the "log_age" function and printing to the console externally.
|
|
_, err = ageCalculator.ExportedFunction("log_age").Call(ctx, birthYear)
|
|
if err != nil {
|
|
log.Panicln(err)
|
|
}
|
|
}
|