Struct BinFactory 

pub struct BinFactory {
    pub(crate) commands: Commands,
    runtime: Arc<dyn Runtime + Send + Sync + 'static>,
    pub(crate) local: Arc<RwLock<HashMap<String, Option<Arc<BinaryPackage>>>>>,
}

Fields

commands: Commands

runtime: Arc<dyn Runtime + Send + Sync + 'static>

local: Arc<RwLock<HashMap<String, Option<Arc<BinaryPackage>>>>>

Implementations

impl BinFactory

pub fn new(runtime: Arc<dyn Runtime + Send + Sync + 'static>) -> BinFactory

pub fn runtime(&self) -> &(dyn Runtime + Send + Sync)

pub fn register_builtin_command<C>(&mut self, cmd: C)

where C: VirtualCommand + Send + Sync + 'static,

Register a builtin command.

pub fn register_builtin_command_with_path<C, P>(&mut self, cmd: C, path: P)

where C: VirtualCommand + Send + Sync + 'static, P: Into<String>,

Register a builtin command at a custom path.

pub(crate) fn register_builtin_command_with_path_shared<P>( &mut self, cmd: Arc<dyn VirtualCommand + Send + Sync + 'static>, path: P, )

where P: Into<String>,

Register a builtin command behind an Arc at a custom path.

pub fn clear_builtin_commands(&mut self)

Remove all registered builtin commands.

pub fn set_binary(&self, name: &str, binary: &Arc<BinaryPackage>)

pub async fn get_binary( &self, name: &str, fs: Option<&dyn FileSystem>, ) -> Option<Arc<BinaryPackage>>

pub fn spawn<'a>( &'a self, name: String, invoked_as: Option<String>, env: WasiEnv, ) -> Pin<Box<dyn Future<Output = Result<TaskJoinHandle, SpawnError>> + 'a>>

invoked_as is the path the guest spelled, for a script that must be handed to its interpreter under that name rather than the path it resolved to. None selects the resolved path, which is what a PATH search produces on Unix.

Every name here is looked up on the filesystem, builtin commands included. A caller reaches those through Self::try_built_in before it gets here, and only for the name it started with, so a shebang naming a builtin interpreter (#!/bin/sh where sh is registered rather than a file on disk) fails with SpawnError::BinaryNotFound. Running that interpreter needs the parent context try_built_in takes, which a spawn already under way does not hold.

pub fn try_built_in( &self, name: String, parent_ctx: Option<&FunctionEnvMut<'_, WasiEnv>>, builder: &mut Option<WasiEnv>, ) -> Result<TaskJoinHandle, SpawnError>

pub async fn get_executable( &self, name: &str, fs: Option<&dyn FileSystem>, ) -> Option<Executable>

async fn get_executable_for_spawn( &self, name: &str, env: &WasiEnv, ) -> Result<Option<(String, Executable)>, SpawnError>

async fn get_executable_from_wasi_fs( &self, path: &str, env: &WasiEnv, ) -> Result<Option<Executable>, SpawnError>

Trait Implementations

impl Clone for BinFactory

fn clone(&self) -> BinFactory

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BinFactory

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

Formats the value using the given formatter.