Struct lucet_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>(self, args: impl IntoIterator<Item = S>) -> 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>(self, arg: S) -> 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(self) -> 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_stdio(self) -> WasiCtxBuilder

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

pub fn inherit_env(self) -> 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>(self, k: S, v: S) -> 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>(self, envs: impl IntoIterator<Item = T>) -> 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(self, file: File) -> WasiCtxBuilder

Provide a File to use as stdin

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

Provide a File to use as stdout

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

Provide a File to use as stderr

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

Add a preopened directory.

pub fn build(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.