Struct RuntimeRef 

pub struct RuntimeRef { /* private fields */ }

A runtime the node resolves by name, as opposed to runtime = "self" which resolves inside the bundle.

Wire form is slash-separated, either <name>/<version> (stock, e.g. mesofact/0.8.20) or <namespace>/<name>/<version> (a custom runtime published under an org/project, e.g. acme/site/1.2.3). The namespace is what keeps two orgs’ site runtimes from colliding in one node cache.

This parses the general form even though BundleRuntime::parse accepts only mesofact/<ver> today: the node cache layout is the thing that is expensive to change later (bytes on disk across a fleet), the manifest field is not. Accepting a namespaced ref here early is forward-compatible and unreachable in practice until a manifest can express one — R746-F6 versioned the contract such an expression would range over, but left the field itself a single runtime name (W272 §7).

Implementations

impl RuntimeRef

pub fn parse(s: &str) -> Result<Self, BundleError>

Parse the wire form (<name>/<ver> or <ns>/<name>/<ver>).

Every segment is validated to [A-Za-z0-9._+-]+ and rejected if it is . or ... That is not decoration: these segments are joined onto a node’s cache directory, so a permissive parse would let a published manifest name a write target outside the cache. Same reasoning as store::checked_rel for bundle content paths.

pub fn namespace(&self) -> Option<&str>

Publishing namespace (None for a stock runtime).

pub fn name(&self) -> &str

Runtime name, e.g. mesofact.

pub fn version(&self) -> &str

Exact runtime version, e.g. 0.8.20.

pub fn as_wire(&self) -> String

The wire string this was parsed from.

pub fn cache_rel_bin(&self, triple: &str, bin: &str) -> PathBuf

Cache-relative path to the binary named bin: runtimes/[<ns>/]<name>/<ver>/<triple>/<bin>.

bin is a bare filename, never a path — it comes from a published manifest, and joining an unchecked one onto the cache dir would be the same write-outside-the-cache primitive RuntimeRef::parse exists to deny. Callers pass a compile-time constant (SERVE_BIN, kamaji’s FEED_BIN_NAME); check_bin_name enforces it for the manifest-supplied side.

pub fn cache_rel_dir(&self, triple: &str) -> PathBuf

Cache-relative directory holding this runtime’s binaries for triple: runtimes/[<ns>/]<name>/<ver>/<triple>.

pub fn cache_rel_serve(&self, triple: &str) -> PathBuf

Cache-relative path to the serve binary: runtimes/[<ns>/]<name>/<ver>/<triple>/serve. The SERVE_BIN case of cache_rel_bin.

pub fn asset_manifest_prefix(&self) -> String

Object-store key prefix every published asset manifest for this runtime sits directly under: runtimes/[<ns>/]<name>/<ver>/.

The trailing slash is load-bearing — without it mesofact/0.8.2 would list mesofact/0.8.20’s assets too. Entries below it are <triple>.toml and nothing else, so a listed key with a further / in it belongs to some other ref and is not this runtime’s.

pub fn asset_manifest_key(&self, triple: &str) -> String

Object-store key of the published asset manifest for triple: runtimes/[<ns>/]<name>/<ver>/<triple>.toml.

By name, not by content — this is the one mutable-shaped key in the scheme, and it is what turns “mesofact/0.8.20 on x86_64 musl” into a blake3 the node can then verify bytes against.

Trait Implementations

impl Clone for RuntimeRef

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeRef

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

Formats the value using the given formatter.

impl Display for RuntimeRef

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

Formats the value using the given formatter.

impl Eq for RuntimeRef

impl Hash for RuntimeRef

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for RuntimeRef

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for RuntimeRef

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for RuntimeRef

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for RuntimeRef