Struct Lockfile 

pub struct Lockfile {
    pub version: u32,
    pub packages: Vec<LockedPackage>,
    pub patches: Vec<LockedPatch>,
    pub source_replacements: Vec<LockedSourceReplacement>,
}

In-memory representation of a cabin.lock.

Constructed by crate::io::parse_lockfile_str / crate::io::read_lockfile and serialized by crate::io::render_lockfile / crate::io::write_lockfile. The lockfile only records resolved registry dependencies — local path packages are intentionally not included.

Fields

version: u32

Schema version (currently always LOCKFILE_VERSION).

packages: Vec<LockedPackage>

Resolved registry packages, sorted by name for determinism.

patches: Vec<LockedPatch>

Active patch entries recorded for stale-detection under --locked. Empty for projects with no patches; old lockfiles that omit the [[patch]] array continue to parse cleanly thanks to #[serde(default)] on the raw shape.

source_replacements: Vec<LockedSourceReplacement>

Active source-replacement entries, recorded for the same reason. Empty for projects with no replacements.

Implementations

impl Lockfile

pub fn empty() -> Self

An empty lockfile at the current schema version.

pub fn find(&self, name: &PackageName) -> Option<&LockedPackage>

Look up a locked package by name. Linear scan — typical lockfiles are small enough that this stays cheap.

pub fn matches_patch_state( &self, active_patches: &[LockedPatch], active_source_replacements: &[LockedSourceReplacement], ) -> bool

Whether the lockfile’s recorded patch + source-replacement arrays equal the supplied active policy. Used by cabin <command> --locked to detect that the user changed patch policy since the lockfile was last written: the recorded arrays already serialize deterministically (sorted in crate::io::render_lockfile), so a slice comparison is the canonical staleness check and lives next to the types it compares.

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 Default for Lockfile

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Lockfile

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 StructuralPartialEq for Lockfile