Struct LockFile 

pub struct LockFile {
    pub version: u32,
    pub dependencies: IndexMap<SourceName, LockedSource>,
    pub items: IndexMap<String, LockedItemV2>,
    pub config_entries: BTreeMap<String, BTreeMap<String, ConfigEntryRecord>>,
}

The complete lock file — ownership registry for all managed items.

Schema version 2: items are keyed by logical identity (“kind/name”), and each item carries a list of per-output records (one per target root materialization).

TOML format, deterministically ordered (sorted keys) for clean git diffs.

Fields

version: u32

Schema version. Current version is 2.

dependencies: IndexMap<SourceName, LockedSource>

items: IndexMap<String, LockedItemV2>

V2: logical items keyed by “kind/name” identity string.

config_entries: BTreeMap<String, BTreeMap<String, ConfigEntryRecord>>

Config entries installed by mars sync, keyed by target root and entry key.

Implementations

impl LockFile

pub fn empty() -> Self

Create a new empty lock file with the current schema version.

pub fn find_by_dest_path(&self, dest_path: &DestPath) -> Option<LockedItem>

Look up a locked item by its output dest_path, returning a flat LockedItem view.

Searches across all items and their output records. Returns the first match.

pub fn contains_dest_path(&self, dest_path: &DestPath) -> bool

Check if any output record has the given dest_path.

pub fn all_output_dest_paths(&self) -> impl Iterator<Item = &DestPath>

Iterate all output dest_paths across all items.

pub fn output_dest_paths_for_target(&self, target_root: &str) -> HashSet<String>

Dest paths previously managed under a specific target root.

pub fn contains_output(&self, target_root: &str, dest_path: &str) -> bool

Whether the lock records ownership of dest_path under target_root.

pub fn canonical_flat_items(&self) -> Vec<(DestPath, LockedItem)>

Flat view of canonical .mars outputs only.

pub fn flat_items_for_target( &self, target_root: &str, ) -> Vec<(DestPath, LockedItem)>

Flat view of outputs materialized under target_root.

pub fn flat_items(&self) -> Vec<(DestPath, LockedItem)>

Flat view of all items as owned (dest_path, LockedItem) pairs.

Used by diff, orphan scan, and CLI commands that need a per-output view.

Trait Implementations

impl Clone for LockFile

fn clone(&self) -> LockFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LockFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LockFile

Custom Deserialize for LockFile: delegates to the v2 wire type.

For reading v1 lock files, always go through load() which handles the v1→v2 promotion. Direct deserialization via toml::from_str::<LockFile> only supports v2 format.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for LockFile

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LockFile

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 LockFile