wa-lang.org/wazero@v1.0.2/internal/integration_test/bench/hostfunc_bench_test.go

package bench

import (
	"context"
	_ "embed"
	"encoding/binary"
	"fmt"
	"math"
	"testing"

	"wa-lang.org/wazero/api"
	"wa-lang.org/wazero/internal/engine/compiler"
	"wa-lang.org/wazero/internal/platform"
	"wa-lang.org/wazero/internal/testing/require"
	"wa-lang.org/wazero/internal/wasm"
)

const (
	// callGoHostName is the name of exported function which calls the
	// Go-implemented host function.
	callGoHostName = "call_go_host"
	// callGoReflectHostName is the name of exported function which calls the
	// Go-implemented host function defined in reflection.
	callGoReflectHostName = "call_go_reflect_host"
	// callWasmHostName is the name of exported function which calls the
	// Wasm-implemented host function.
	callWasmHostName = "call_wasm_host"
)

// BenchmarkHostFunctionCall measures the cost of host function calls whose target functions are either
// Go-implemented or Wasm-implemented, and compare the results between them.
func BenchmarkHostFunctionCall(b *testing.B) {
	if !platform.CompilerSupported() {
		b.Skip()
	}

	m := setupHostCallBench(func(err error) {
		if err != nil {
			b.Fatal(err)
		}
	})

	const offset = uint64(100)
	const val = float32(1.1234)

	binary.LittleEndian.PutUint32(m.Memory.Buffer[offset:], math.Float32bits(val))

	for _, fn := range []string{callGoReflectHostName, callGoHostName, callWasmHostName} {
		fn := fn

		b.Run(fn, func(b *testing.B) {
			ce, err := getCallEngine(m, fn)
			if err != nil {
				b.Fatal(err)
			}

			b.ResetTimer()
			for i := 0; i < b.N; i++ {
				res, err := ce.Call(testCtx, m.CallCtx, []uint64{offset})
				if err != nil {
					b.Fatal(err)
				}
				if uint32(res[0]) != math.Float32bits(val) {
					b.Fail()
				}
			}
		})
	}
}

func TestBenchmarkFunctionCall(t *testing.T) {
	if !platform.CompilerSupported() {
		t.Skip()
	}

	m := setupHostCallBench(func(err error) {
		require.NoError(t, err)
	})

	callWasmHost, err := getCallEngine(m, callWasmHostName)
	require.NoError(t, err)

	callGoHost, err := getCallEngine(m, callGoHostName)
	require.NoError(t, err)

	callGoReflectHost, err := getCallEngine(m, callGoReflectHostName)
	require.NoError(t, err)

	require.NotNil(t, callWasmHost)
	require.NotNil(t, callGoHost)
	require.NotNil(t, callGoReflectHost)

	tests := []struct {
		offset uint32
		val    float32
	}{
		{offset: 0, val: math.Float32frombits(0xffffffff)},
		{offset: 100, val: 1.12314},
		{offset: wasm.MemoryPageSize - 4, val: 1.12314},
	}

	mem := m.Memory.Buffer

	for _, f := range []struct {
		name string
		ce   wasm.CallEngine
	}{
		{name: "go", ce: callGoHost},
		{name: "go-reflect", ce: callGoReflectHost},
		{name: "wasm", ce: callWasmHost},
	} {
		f := f
		t.Run(f.name, func(t *testing.T) {
			for _, tc := range tests {
				binary.LittleEndian.PutUint32(mem[tc.offset:], math.Float32bits(tc.val))
				res, err := f.ce.Call(context.Background(), m.CallCtx, []uint64{uint64(tc.offset)})
				require.NoError(t, err)
				require.Equal(t, math.Float32bits(tc.val), uint32(res[0]))
			}
		})
	}
}

func getCallEngine(m *wasm.ModuleInstance, name string) (ce wasm.CallEngine, err error) {
	f := m.Exports[name].Function
	if f == nil {
		err = fmt.Errorf("%s not found", name)
		return
	}

	ce, err = m.Engine.NewCallEngine(m.CallCtx, f)
	return
}

func setupHostCallBench(requireNoError func(error)) *wasm.ModuleInstance {
	eng := compiler.NewEngine(context.Background(), api.CoreFeaturesV2)

	ft := &wasm.FunctionType{
		Params:           []wasm.ValueType{wasm.ValueTypeI32},
		Results:          []wasm.ValueType{wasm.ValueTypeF32},
		ParamNumInUint64: 1, ResultNumInUint64: 1,
	}

	// Build the host module.
	hostModule := &wasm.Module{
		TypeSection:     []*wasm.FunctionType{ft},
		FunctionSection: []wasm.Index{0, 0, 0},
		CodeSection: []*wasm.Code{
			{
				IsHostFunction: true,
				GoFunc: api.GoModuleFunc(func(ctx context.Context, mod api.Module, stack []uint64) {
					ret, ok := mod.Memory().ReadUint32Le(ctx, uint32(stack[0]))
					if !ok {
						panic("couldn't read memory")
					}
					stack[0] = uint64(ret)
				}),
			},
			wasm.MustParseGoReflectFuncCode(
				func(ctx context.Context, m api.Module, pos uint32) float32 {
					ret, ok := m.Memory().ReadUint32Le(ctx, pos)
					if !ok {
						panic("couldn't read memory")
					}
					return math.Float32frombits(ret)
				},
			),
			{
				IsHostFunction: true,
				Body: []byte{
					wasm.OpcodeLocalGet, 0,
					wasm.OpcodeI32Load, 0x2, 0x0, // offset = 0
					wasm.OpcodeF32ReinterpretI32,
					wasm.OpcodeEnd,
				},
			},
		},
		ExportSection: []*wasm.Export{
			{Name: "go", Type: wasm.ExternTypeFunc, Index: 0},
			{Name: "go-reflect", Type: wasm.ExternTypeFunc, Index: 1},
			{Name: "wasm", Type: wasm.ExternTypeFunc, Index: 2},
		},
		ID: wasm.ModuleID{1, 2, 3, 4, 5},
	}
	hostModule.BuildFunctionDefinitions()

	host := &wasm.ModuleInstance{Name: "host", TypeIDs: []wasm.FunctionTypeID{0}}
	host.Functions = host.BuildFunctions(hostModule)
	host.BuildExports(hostModule.ExportSection)
	goFn := host.Exports["go"].Function
	goReflectFn := host.Exports["go-reflect"].Function
	wasnFn := host.Exports["wasm"].Function

	err := eng.CompileModule(testCtx, hostModule, nil)
	requireNoError(err)

	hostME, err := eng.NewModuleEngine(host.Name, hostModule, nil, host.Functions)
	requireNoError(err)
	linkModuleToEngine(host, hostME)

	// Build the importing module.
	importingModule := &wasm.Module{
		TypeSection: []*wasm.FunctionType{ft},
		ImportSection: []*wasm.Import{
			// Placeholders for imports from hostModule.
			{Type: wasm.ExternTypeFunc},
			{Type: wasm.ExternTypeFunc},
			{Type: wasm.ExternTypeFunc},
		},
		FunctionSection: []wasm.Index{0, 0, 0},
		ExportSection: []*wasm.Export{
			{Name: callGoHostName, Type: wasm.ExternTypeFunc, Index: 2},
			{Name: callGoReflectHostName, Type: wasm.ExternTypeFunc, Index: 3},
			{Name: callWasmHostName, Type: wasm.ExternTypeFunc, Index: 4},
		},
		CodeSection: []*wasm.Code{
			{Body: []byte{wasm.OpcodeLocalGet, 0, wasm.OpcodeCall, 0, wasm.OpcodeEnd}}, // Calling the index 0 = host.go.
			{Body: []byte{wasm.OpcodeLocalGet, 0, wasm.OpcodeCall, 1, wasm.OpcodeEnd}}, // Calling the index 1 = host.go-reflect.
			{Body: []byte{wasm.OpcodeLocalGet, 0, wasm.OpcodeCall, 2, wasm.OpcodeEnd}}, // Calling the index 2 = host.wasm.
		},
		// Indicates that this module has a memory so that compilers are able to assemble memory-related initialization.
		MemorySection: &wasm.Memory{Min: 1},
		ID:            wasm.ModuleID{1},
	}

	importingModule.BuildFunctionDefinitions()
	err = eng.CompileModule(testCtx, importingModule, nil)
	requireNoError(err)

	importing := &wasm.ModuleInstance{TypeIDs: []wasm.FunctionTypeID{0}}
	importingFunctions := importing.BuildFunctions(importingModule)
	importing.Functions = append([]*wasm.FunctionInstance{goFn, wasnFn}, importingFunctions...)
	importing.BuildExports(importingModule.ExportSection)

	importingMe, err := eng.NewModuleEngine(importing.Name, importingModule, []*wasm.FunctionInstance{goFn, goReflectFn, wasnFn}, importingFunctions)
	requireNoError(err)
	linkModuleToEngine(importing, importingMe)

	importing.Memory = &wasm.MemoryInstance{Buffer: make([]byte, wasm.MemoryPageSize), Min: 1, Cap: 1, Max: 1}
	return importing
}

func linkModuleToEngine(module *wasm.ModuleInstance, me wasm.ModuleEngine) {
	module.Engine = me
	module.CallCtx = wasm.NewCallContext(nil, module, nil)
}