Struct MetraleHome 

pub struct MetraleHome {
    pub root: PathBuf,
    pub source: HomeSource,
}

2026-09-26: A resolved Metrale Engine home and its provenance.

Fields

root: PathBuf

source: HomeSource

Implementations

impl MetraleHome

pub fn resolve() -> Result<Self>

2026-09-26: Resolve from the environment: a non-empty METRALE_HOME wins, then $HOME/.metrale. An empty METRALE_HOME is an error, and so is having neither variable. Touches no file.

pub fn fault(&self) -> Option<HomeFault>

2026-09-26: Can this process use the home? None means yes.

Creates the directory if it is missing, then probes by writing and removing .metrale-write-probe, so ownership, ACLs, read-only mounts and a full disk all show up as the one failure that matters.

pub fn describe(&self) -> String

2026-09-26: One line naming the root and where it came from.

Trait Implementations

impl Clone for MetraleHome

fn clone(&self) -> MetraleHome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetraleHome

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

Formats the value using the given formatter.