Struct spin_core::StoreBuilder

pub struct StoreBuilder { /* private fields */ }

A builder interface for configuring a new Store.

A new StoreBuilder can be obtained with crate::Engine::store_builder.

Implementations

impl StoreBuilder

pub fn max_memory_size(&mut self, max_memory_size: usize)

Sets a maximum memory allocation limit.

See wasmtime::ResourceLimiter::memory_growing (maximum) for details on how this limit is enforced.

pub fn inherit_stdin(&mut self)

Inherit stdin from the host process.

pub fn stdin(&mut self, file: impl WasiFile + 'static)

Sets the WASI stdin descriptor.

pub fn stdin_pipe(&mut self, r: impl Read + Send + Sync + 'static)

Sets the WASI stdin descriptor to the given Reader.

pub fn inherit_stdout(&mut self)

Inherit stdin from the host process.

pub fn stdout(&mut self, file: impl WasiFile + 'static)

Sets the WASI stdout descriptor.

pub fn stdout_pipe(&mut self, w: impl Write + Send + Sync + 'static)

Sets the WASI stdout descriptor to the given Writeer.

pub fn stdout_buffered(&mut self) -> OutputBuffer

Sets the WASI stdout descriptor to an in-memory buffer which can be retrieved after execution from the returned OutputBuffer.

pub fn inherit_stderr(&mut self)

Inherit stdin from the host process.

pub fn stderr(&mut self, file: impl WasiFile + 'static)

Sets the WASI stderr descriptor.

pub fn stderr_pipe(&mut self, w: impl Write + Send + Sync + 'static)

Sets the WASI stderr descriptor to the given Writeer.

pub fn stderr_buffered(&mut self) -> OutputBuffer

Sets the WASI stderr descriptor to an in-memory buffer which can be retrieved after execution from the returned OutputBuffer.

pub fn args<'b>(&mut self, args: impl IntoIterator<Item = &'b str>) -> Result<()>

Appends the given strings to the the WASI ‘args’.

pub fn env(
    &mut self,
    vars: impl IntoIterator<Item = (impl AsRef<str>, impl AsRef<str>)>
) -> Result<()>

Sets the given key/value string entries on the the WASI ‘env’.

pub fn read_only_preopened_dir(
    &mut self,
    host_path: impl AsRef<Path>,
    guest_path: PathBuf
) -> Result<()>

“Mounts” the given host_path into the WASI filesystem at the given guest_path with read-only capabilities.

pub fn read_write_preopened_dir(
    &mut self,
    host_path: impl AsRef<Path>,
    guest_path: PathBuf
) -> Result<()>

“Mounts” the given host_path into the WASI filesystem at the given guest_path with read and write capabilities.

pub fn host_components_data(&mut self) -> &mut HostComponentsData

Returns a mutable reference to the built

pub fn build_with_data<T>(self, inner_data: T) -> Result<Store<T>>

Builds a Store from this builder with given host state data.

If T: Default, it may be preferable to use StoreBuilder::build.

pub fn build<T: Default>(self) -> Result<Store<T>>

Builds a Store from this builder with Default host state data.