Struct Memory 

pub struct Memory { /* private fields */ }

A host whose inputs are named byte strings and whose outputs stay in memory: what the bindings give the surface (spec 027, 3.1.3), where a command’s artifacts are returned as bytes rather than written to files. It has no aggregate read budget; each read is bounded by its maximum.

Implementations

impl Memory

pub fn new(inputs: BTreeMap<String, Vec<u8>>) -> Self

pub fn inputs(&self) -> &BTreeMap<String, Vec<u8>>

The inputs, by label.

pub fn output(&self, label: &str) -> Option<Vec<u8>>

A copy of one published output, by label.

pub fn into_outputs(self) -> BTreeMap<String, Vec<u8>>

The outputs the command published, by label.

Trait Implementations

impl Debug for Memory

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

Formats the value using the given formatter.

impl Default for Memory

fn default() -> Self

Returns the “default value” for a type.

impl Host for Memory

fn read_classified( &self, label: &str, max: usize, ) -> Result<Option<Vec<u8>>, ReadFail>

Read label, at most max bytes of it; None when it does not exist. A failure of the input is told from an exhausted command budget, which depends on read order rather than on the input.

fn ensure_absent(&self, label: &str) -> Result<(), IoFail>

Refuse an output that already exists, before any work. A pure check that changes nothing, so calling it again for the same label gives the same answer: commands check every output up front and again just before writing.

fn create(&self, label: &str, bytes: &[u8]) -> Result<(), IoFail>

Publish one output, never overwriting.

fn write_all(&self, files: &[(String, Vec<u8>)]) -> Result<(), IoFail>

Publish every (label, bytes), all or none.

fn join(&self, dir: &str, name: &str) -> String

The label of name inside the output or input directory dir.

fn read(&self, label: &str, limit: usize) -> Result<Vec<u8>, IoFail>

Read label up to its document limit plus one byte, so an oversized input reaches the parser and is refused by the document’s own bound.

fn read_bounded( &self, label: &str, max: usize, ) -> Result<Option<Vec<u8>>, IoFail>

Like Host::read with an explicit maximum, returning None for an input that does not exist.