Interface HostModule

module.go:20–31

HostModule is an interface representing type-safe wazero host modules. The interface is parametrized on the module type that it instantiates. HostModule instances are expected to be immutable and therfore safe to use concurrently from multiple goroutines.

// HostModule instances are expected to be immutable and therfore safe to use
// concurrently from multiple goroutines.
type HostModule[T Module] interface {
	// Returns the name of the host module (e.g. "wasi_snapshot_preview1").
	Name() string
	// Returns the collection of functions exported by the host module.
	// The method may return the same value across multiple calls to this
	// method, the program is expected to treat it as a read-only value.
	Functions() Functions[T]
	// Creates a new instance of the host module type, using the list of options
	// passed as arguments to configure it. This method is intended to be called
	// automatically when instantiating a module via an instantiation context.
	Instantiate(ctx context.Context, options ...Option[T]) (T, error)
}

// Build builds the host module p in the wazero runtime r, returning the
// instance of HostModuleBuilder that was created. This is a low level function