Package assemblyscript

ctx := context.Background()

r := wazero.NewRuntime(ctx)
defer r.Close(ctx) // This closes everything this Runtime created.

// First construct your own module builder for "env"
envBuilder := r.NewHostModuleBuilder("env").
    NewFunctionBuilder().
    WithFunc(func() uint32 { return 1 }).
    Export("get_int")

// Now, add AssemblyScript special function imports into it.
assemblyscript.NewFunctionExporter().
    WithAbortMessageDisabled().
    ExportFunctions(envBuilder)

ctx := context.Background()

r := wazero.NewRuntime(ctx)
defer r.Close(ctx) // This closes everything this Runtime created.

// This adds the "env" module to the runtime, with AssemblyScript's special
// function imports.
assemblyscript.MustInstantiate(ctx, r)

func Instantiate ¶

func Instantiate(ctx context.Context, r wazero.Runtime) (api.Closer, error)

Instantiate instantiates the "env" module used by AssemblyScript into the runtime.

Notes

• Failure cases are documented on wazero.Runtime InstantiateModule.
• Closing the wazero.Runtime has the same effect as closing the result.
• To add more functions to the "env" module, use FunctionExporter.

func MustInstantiate ¶

func MustInstantiate(ctx context.Context, r wazero.Runtime)

MustInstantiate calls Instantiate or panics on error.

This is a simpler function for those who know the module "env" is not already instantiated, and don't need to unload it.

type FunctionExporter ¶

FunctionExporter configures the functions in the "env" module used by AssemblyScript.

Notes

• This is an interface for decoupling, not third-party implementations. All implementations are in wazero.

type FunctionExporter interface {
    // WithAbortMessageDisabled configures the AssemblyScript abort function to
    // discard any message.
    WithAbortMessageDisabled() FunctionExporter

    // WithTraceToStdout configures the AssemblyScript trace function to output
    // messages to Stdout, as configured by wazero.ModuleConfig WithStdout.
    WithTraceToStdout() FunctionExporter

    // WithTraceToStderr configures the AssemblyScript trace function to output
    // messages to Stderr, as configured by wazero.ModuleConfig WithStderr.
    //
    // Because of the potential volume of trace messages, it is often more
    // appropriate to use WithTraceToStdout instead.
    WithTraceToStderr() FunctionExporter

    // ExportFunctions builds functions to export with a wazero.HostModuleBuilder
    // named "env".
    ExportFunctions(wazero.HostModuleBuilder)
}

func NewFunctionExporter ¶

func NewFunctionExporter() FunctionExporter

NewFunctionExporter returns a FunctionExporter object with trace disabled.

Subdirectories