Struct Process 

pub struct Process { /* private fields */ }

process: the arguments a run was given, its exit status, and the executables the host allows it to start.

Implementations

impl Process

pub fn real(args: Vec<String>, allowed: Vec<PathBuf>) -> Self

The real process.

args are the arguments the host chose to pass on, not the host’s own command line: a run sees what it was given and nothing else. allowed is the list of executables run may start, each an absolute path. An empty list is a process that can read its arguments and end itself but cannot start anything, which is the only safe default a host that knows nothing about the program can offer.

pub fn recorded( args: Vec<String>, outputs: BTreeMap<String, String>, log: ProcessLog, ) -> Self

A fake process that records what it was asked to do, for tests.

outputs maps an executable path to the standard output run should answer with, and is also the allow-list: a program the fake has no answer for is refused exactly as the real host refuses one the host did not name.

Trait Implementations

impl HostApi for Process

fn module_schema(&self) -> ModuleSchema

The whole of what this module declares about itself: the name Cove source uses, the capability a host must grant for it, the operations it exposes, the types it declares, and the kinds of resource it can open.

fn call(&self, op: &str, args: Vec<Value>) -> Result<Value, RuntimeError>

Invokes one operation.

fn call_with( &self, op: &str, args: Vec<Value>, back: &mut dyn Reentry, ) -> Result<Value, RuntimeError>

Invokes one operation.

fn call_resource( &self, handle: &ResourceHandle, op: &str, args: Vec<Value>, back: &mut dyn Reentry, ) -> Result<Value, RuntimeError>

Invokes one operation on a handle this module issued.