Struct InstalledComponentRegistry 

pub struct InstalledComponentRegistry { /* private fields */ }

The persisted registry of installed components.

Implementations

impl InstalledComponentRegistry

pub fn path() -> PathBuf

Path to the persisted registry file: ~/.mlstack/installed.json.

pub fn load() -> Self

Load the registry from disk, returning an empty one if absent or unreadable (never panics — a corrupt registry degrades to empty).

pub fn save(&self) -> Result<()>

Persist the registry to disk atomically, creating ~/.mlstack/ first.

Writes to installed.json.tmp in the same directory, then fs::renames it into place. rename is atomic on the same filesystem, so an interrupted write (crash, disk full, power loss) can never leave a corrupt installed.json that would make load() return empty and risk clobbering a sealed core component (Tenet 2).

pub fn reload_and_save() -> Result<()>

Load then save — normalizes the file on disk (used after manual edits).

pub fn mark_installed(&mut self, component: InstalledComponent)

Record (or update) a component. If sealed is requested on a component that is already sealed, the seal is preserved (never accidentally unsealed via re-mark without explicit Self::unseal).

pub fn seal_core( &mut self, id: &str, version: Option<String>, source_index: Option<String>, location: Option<String>, pip_packages: Vec<String>, installed_at: Option<String>, )

Convenience: mark a core component as installed + sealed.

pub fn get(&self, id: &str) -> Option<&InstalledComponent>

Lookup a component by id.

pub fn is_installed(&self, id: &str) -> bool

Is a component with this id recorded as installed?

pub fn is_sealed(&self, id: &str) -> bool

Is this a sealed core component?

pub fn installed_ids(&self) -> HashSet<String>

All recorded component ids.

pub fn all_pip_packages(&self) -> Vec<String>

Every pip package name owned by any recorded component (for uninstall).

pub fn unseal(&mut self, id: &str) -> bool

Explicitly unseal a core component (only via deliberate user action, e.g. --unseal-core). Returns true if it was sealed and is now not.

pub fn remove(&mut self, id: &str) -> bool

Remove a component record (does not uninstall — see Stage 6).

pub fn clear(&mut self)

Clear all records.

pub fn len(&self) -> usize

Number of recorded components.

pub fn is_empty(&self) -> bool

Is the registry empty?

pub fn iter(&self) -> impl Iterator<Item = &InstalledComponent>

Iterate over recorded components.

Trait Implementations

impl Clone for InstalledComponentRegistry

fn clone(&self) -> InstalledComponentRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstalledComponentRegistry

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

Formats the value using the given formatter.

impl Default for InstalledComponentRegistry

fn default() -> InstalledComponentRegistry

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InstalledComponentRegistry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InstalledComponentRegistry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.