Trait wasmer_engine::Engine

pub trait Engine {
    fn target(&self) -> &Target;
    fn register_signature(
        &self, 
        func_type: FunctionTypeRef<'_>
    ) -> VMSharedSignatureIndex;
    fn register_function_metadata(
        &self, 
        func_data: VMCallerCheckedAnyfunc
    ) -> VMFuncRef;
    fn lookup_signature(
        &self, 
        sig: VMSharedSignatureIndex
    ) -> Option<FunctionType>;
    fn validate(&self, binary: &[u8]) -> Result<(), CompileError>;
    fn compile(
        &self, 
        binary: &[u8], 
        tunables: &dyn Tunables
    ) -> Result<Box<dyn Executable>, CompileError>;
    fn load(
        &self, 
        executable: &dyn Executable
    ) -> Result<Arc<dyn Artifact>, CompileError>;
    fn id(&self) -> &EngineId;
    fn cloned(&self) -> Arc<dyn Engine + Send + Sync>;
}

A unimplemented Wasmer Engine.

This trait is used by implementors to implement custom engines such as: Universal or Native.

The product that an Engine produces and consumes is the Artifact.

Required Methods

fn target(&self) -> &Target

Gets the target

fn register_signature(
    &self,
    func_type: FunctionTypeRef<'_>
) -> VMSharedSignatureIndex

Register a signature

fn register_function_metadata(
    &self,
    func_data: VMCallerCheckedAnyfunc
) -> VMFuncRef

Register a function’s data.

fn lookup_signature(&self, sig: VMSharedSignatureIndex) -> Option<FunctionType>

Lookup a signature

fn validate(&self, binary: &[u8]) -> Result<(), CompileError>

Validates a WebAssembly module

fn compile(
    &self,
    binary: &[u8],
    tunables: &dyn Tunables
) -> Result<Box<dyn Executable>, CompileError>

Compile a WebAssembly binary

fn load(
    &self,
    executable: &dyn Executable
) -> Result<Arc<dyn Artifact>, CompileError>

Load a compiled executable with this engine.

fn id(&self) -> &EngineId

A unique identifier for this object.

This exists to allow us to compare two Engines for equality. Otherwise, comparing two trait objects unsafely relies on implementation details of trait representation.

fn cloned(&self) -> Arc<dyn Engine + Send + Sync>

Clone the engine

Implementations

impl dyn Engine

pub fn downcast_ref<T: Engine + 'static>(&self) -> Option<&T>

Downcast a dynamic Executable object to a concrete implementation of the trait.

Implementors