Struct BackendRegistry 

pub struct BackendRegistry {
    pub schema: String,
    pub discovered_at_unix: u64,
    pub source: String,
    pub reserve_bytes: u64,
    pub reserve_basis: String,
    pub entries: Vec<BackendEntry>,
    pub selected: Selection,
}

The machine as discovered at startup. Never cached, never persisted (REG-12).

Fields

schema: String

Schema id.

discovered_at_unix: u64

Unix seconds at discovery.

source: String

“machine” or “fixture(path)”.

reserve_bytes: u64

REG-7 reserve applied to every Ready GPU entry.

reserve_basis: String

Where the reserve number comes from.

entries: Vec<BackendEntry>

Every entry, in kind order; at least one per kind.

selected: Selection

REG-8 default selection (recomputed on every discovery).

Implementations

impl BackendRegistry

pub fn discover() -> Self

Discover the machine with the built-in factories.

pub fn discover_with( factories: &[Box<dyn BackendFactory>], reserve_bytes: Option<u64>, ) -> Self

Discover with explicit factories (tests, mocks) and an optional reserve override (APR_RESERVE_BYTES; the CLI prints the override — REG-8).

pub fn from_fixture_json(json: &str, path: &str) -> Result<Self, String>

Build from a fixture document (the JSON to_json writes). The source names the file so a fixture-built registry is never mistaken for the machine.

Errors

The JSON does not parse as a registry document.

pub fn with_reserve(self, reserve_bytes: u64, basis: &str) -> Self

Re-apply a reserve (an APR_RESERVE_BYTES override on a fixture) and reselect.

pub fn ready(&self) -> impl Iterator<Item = &BackendEntry>

The Ready entries.

pub fn select_default(&self) -> Selection

REG-8: first Ready non-cpu entry (deduplicated by device_uid), else cpu.

pub fn distinct_devices(&self) -> usize

Physical devices among the Ready non-cpu entries (two entries with one uid count once — lane 2’s rule).

pub fn to_json(&self) -> Result<String, String>

The JSON document apr devices --json prints.

Errors

Serialisation failed (cannot happen for these types; surfaced anyway).

pub fn render_block(&self, version: &str) -> String

The printed block (spec §5 R-0, normative shape).

Trait Implementations

impl Clone for BackendRegistry

fn clone(&self) -> BackendRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BackendRegistry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BackendRegistry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for BackendRegistry

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BackendRegistry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BackendRegistry