Struct linera_witty::MockInstance

pub struct MockInstance<UserData> { /* private fields */ }

A fake Wasm instance.

Only contains exports for the memory and the canonical ABI allocation functions.

Implementations

impl<UserData> MockInstance<UserData>

pub fn new(user_data: UserData) -> Self

Creates a new MockInstance using the provided user_data.

pub fn with_exported_function<Parameters, Results, Handler>( self, name: impl Into<String>, handler: Handler, ) -> Self

where Parameters: 'static, Results: 'static, Handler: Fn(MockInstance<UserData>, Parameters) -> Result<Results, RuntimeError> + 'static,

Adds a mock exported function to this MockInstance.

The handler will be called whenever the exported function is called.

pub fn add_exported_function<Parameters, Results, Handler>( &mut self, name: impl Into<String>, handler: Handler, ) -> &mut Self

where Parameters: 'static, Results: 'static, Handler: Fn(MockInstance<UserData>, Parameters) -> Result<Results, RuntimeError> + 'static,

Adds a mock exported function to this MockInstance.

The handler will be called whenever the exported function is called.

pub fn call_imported_function<Parameters, Results>( &self, function: &str, parameters: Parameters, ) -> Result<Results, RuntimeError>

where Parameters: WitStore + 'static, Results: WitLoad + 'static,

Calls a function that the mock instance imported from the host.

pub fn memory_contents(&self) -> Vec<u8>

Returns a copy of the current memory contents.

Trait Implementations

impl<UserData> Clone for MockInstance<UserData>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<UserData> Default for MockInstance<UserData>

where UserData: Default,

fn default() -> Self

Returns the “default value” for a type.

impl<Handler, Parameters, Results, UserData> ExportFunction<Handler, Parameters, Results> for MockInstance<UserData>

where Handler: Fn(MockInstance<UserData>, Parameters) -> Result<Results, RuntimeError> + 'static, Parameters: 'static, Results: 'static,

fn export( &mut self, module_name: &str, function_name: &str, handler: Handler, ) -> Result<(), RuntimeError>

Registers a host function executed by the handler with the provided module_name and function_name as an export for a guest Wasm instance.

impl<UserData> Instance for MockInstance<UserData>

type Runtime = MockRuntime

The runtime this instance is running in.

type UserData = UserData

Custom user data stored in the instance.

type UserDataReference<'a> = MutexGuard<'a, UserData> where Self::UserData: 'a, Self: 'a

A reference to the custom user data stored in the instance.

type UserDataMutReference<'a> = MutexGuard<'a, UserData> where Self::UserData: 'a, Self: 'a

A mutable reference to the custom user data stored in the instance.

fn load_export(&mut self, name: &str) -> Option<String>

Loads an export from the guest module.

fn user_data(&self) -> Self::UserDataReference<'_>

Returns a reference to the custom user data stored in this instance.

fn user_data_mut(&mut self) -> Self::UserDataMutReference<'_>

Returns a mutable reference to the custom user data stored in this instance.

impl<Parameters, Results, UserData> InstanceWithFunction<Parameters, Results> for MockInstance<UserData>

where Parameters: FlatLayout + 'static, Results: FlatLayout + 'static,

type Function = String

The runtime-specific type to represent the function.

fn function_from_export( &mut self, name: <Self::Runtime as Runtime>::Export, ) -> Result<Option<Self::Function>, RuntimeError>

Converts an export into a function, if it is one.

fn call( &mut self, function: &Self::Function, parameters: Parameters, ) -> Result<Results, RuntimeError>

Calls the function from this instance using the specified parameters.

fn load_function(&mut self, name: &str) -> Result<Self::Function, RuntimeError>

Loads a function from the guest Wasm instance.

impl<UserData> InstanceWithMemory for MockInstance<UserData>

fn memory_from_export( &self, export: String, ) -> Result<Option<Arc<Mutex<Vec<u8>>>>, RuntimeError>

Converts an export into the runtime’s specific memory type.

fn memory(&mut self) -> Result<Memory<'_, Self>, RuntimeError>

Returns the memory export from the current Wasm module instance.

impl<UserData> RuntimeMemory<MockInstance<UserData>> for Arc<Mutex<Vec<u8>>>

fn read<'instance>( &self, instance: &'instance MockInstance<UserData>, location: GuestPointer, length: u32, ) -> Result<Cow<'instance, [u8]>, RuntimeError>

Reads length bytes from memory from the provided location.

fn write( &mut self, instance: &mut MockInstance<UserData>, location: GuestPointer, bytes: &[u8], ) -> Result<(), RuntimeError>

Writes the bytes to memory at the provided location.