Struct wasmtime_wasi::WasiCtxBuilder

pub struct WasiCtxBuilder { /* fields omitted */ }

A builder allowing customizable construction of WasiCtx instances.

Methods

impl WasiCtxBuilder

pub fn new() -> WasiCtxBuilder

Builder for a new WasiCtx.

pub fn args<S>(
    &mut self,
    args: impl IntoIterator<Item = S>
) -> &mut WasiCtxBuilder where
    S: AsRef<[u8]>, 

Add arguments to the command-line arguments list.

Arguments must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn arg<S>(&mut self, arg: S) -> &mut WasiCtxBuilder where
    S: AsRef<[u8]>, 

Add an argument to the command-line arguments list.

Arguments must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn inherit_args(&mut self) -> &mut WasiCtxBuilder

Inherit the command-line arguments from the host process.

If any arguments from the host process contain invalid UTF-8, WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn inherit_stdin(&mut self) -> &mut WasiCtxBuilder

Inherit stdin from the host process.

pub fn inherit_stdout(&mut self) -> &mut WasiCtxBuilder

Inherit stdout from the host process.

pub fn inherit_stderr(&mut self) -> &mut WasiCtxBuilder

Inherit stdout from the host process.

pub fn inherit_stdio(&mut self) -> &mut WasiCtxBuilder

Inherit the stdin, stdout, and stderr streams from the host process.

pub fn inherit_env(&mut self) -> &mut WasiCtxBuilder

Inherit the environment variables from the host process.

If any environment variables from the host process contain invalid Unicode (UTF-16 for Windows, UTF-8 for other platforms), WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn env<S>(&mut self, k: S, v: S) -> &mut WasiCtxBuilder where
    S: AsRef<[u8]>, 

Add an entry to the environment.

Environment variable keys and values must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn envs<S, T>(
    &mut self,
    envs: impl IntoIterator<Item = T>
) -> &mut WasiCtxBuilder where
    S: AsRef<[u8]>,
    T: Borrow<(S, S)>, 

Add entries to the environment.

Environment variable keys and values must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn stdin(&mut self, file: File) -> &mut WasiCtxBuilder

Provide a File to use as stdin

pub fn stdout(&mut self, file: File) -> &mut WasiCtxBuilder

Provide a File to use as stdout

pub fn stderr(&mut self, file: File) -> &mut WasiCtxBuilder

Provide a File to use as stderr

pub fn preopened_dir<P>(
    &mut self,
    dir: File,
    guest_path: P
) -> &mut WasiCtxBuilder where
    P: AsRef<Path>, 

Add a preopened directory.

pub fn build(&mut self) -> Result<WasiCtx, Error>

Build a WasiCtx, consuming this WasiCtxBuilder.

If any of the arguments or environment variables in this builder cannot be converted into CStrings, either due to NUL bytes or Unicode conversions, this returns Error::EILSEQ.