Struct WasiState

pub struct WasiState {
    pub fs: WasiFs,
    pub inodes: Arc<RwLock<WasiInodes>>,
    pub args: Vec<Vec<u8>>,
    pub envs: Vec<Vec<u8>>,
    /* private fields */
}

Top level data type containing all* the state with which WASI can interact.

• The contents of files are not stored and may be modified by other, concurrently running programs. Data such as the contents of directories are lazily loaded.

Usage:

WasiState::new("program_name")
   .env(b"HOME", "/home/home".to_string())
   .arg("--help")
   .envs({
       let mut hm = std::collections::HashMap::new();
       hm.insert("COLOR_OUTPUT", "TRUE");
       hm.insert("PATH", "/usr/bin");
       hm
   })
   .args(&["--verbose", "list"])
   .preopen(|p| p.directory("src").read(true).write(true).create(true))?
   .preopen(|p| p.directory(".").alias("dot").read(true))?
   .build()?;

Fields

fs: WasiFs

inodes: Arc<RwLock<WasiInodes>>

args: Vec<Vec<u8>>

envs: Vec<Vec<u8>>

Implementations

impl WasiState

pub fn new(program_name: impl AsRef<str>) -> WasiStateBuilder

Create a WasiStateBuilder to construct a validated instance of WasiState.

pub fn stdout( &self, ) -> Result<Option<Box<dyn VirtualFile + Send + Sync + 'static>>, FsError>

Get the VirtualFile object at stdout

pub fn stdout_mut( &self, ) -> Result<Option<Box<dyn VirtualFile + Send + Sync + 'static>>, FsError>

👎Deprecated since 3.0.0: stdout_mut() is no longer needed - just use stdout() instead

pub fn stderr( &self, ) -> Result<Option<Box<dyn VirtualFile + Send + Sync + 'static>>, FsError>

Get the VirtualFile object at stderr

pub fn stderr_mut( &self, ) -> Result<Option<Box<dyn VirtualFile + Send + Sync + 'static>>, FsError>

👎Deprecated since 3.0.0: stderr_mut() is no longer needed - just use stderr() instead

pub fn stdin( &self, ) -> Result<Option<Box<dyn VirtualFile + Send + Sync + 'static>>, FsError>

Get the VirtualFile object at stdin

pub fn stdin_mut( &self, ) -> Result<Option<Box<dyn VirtualFile + Send + Sync + 'static>>, FsError>

👎Deprecated since 3.0.0: stdin_mut() is no longer needed - just use stdin() instead

Trait Implementations

impl Debug for WasiState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.