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 insert_ip_net_port_range( &mut self, ip_net: IpNet, ports_start: u16, ports_end: Option<u16> )

Insert IP network with a given port range

pub fn inherit_limited_network(&mut self)

Inherit the host network with a few hardcoded caveats

pub fn stdin_pipe( &mut self, r: impl AsyncRead + Read + ReadReady + Send + Sync + Unpin + '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, w: Box<dyn WasiFile>) -> Result<()>

Sets the WASI stdout descriptor to the given Writeer.

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

Sets the WASI stdout descriptor to the given Writeer.

pub fn stdout_buffered(&mut self) -> Result<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_pipe( &mut self, w: impl AsyncWrite + Write + Send + Sync + Unpin + 'static )

Sets the WASI stderr descriptor to the given Writeer.

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 [Store::build].

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

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