Struct Lockfile 

pub struct Lockfile {
    pub version: u32,
    pub tools: BTreeMap<String, LockedTool>,
    pub artifacts: Vec<LockedArtifact>,
}

The root lockfile structure.

Fields

version: u32

Lockfile format version (for future migrations).

tools: BTreeMap<String, LockedTool>

Locked tools with per-platform resolution (v2+).

artifacts: Vec<LockedArtifact>

Legacy OCI artifacts (for backward compatibility with v1).

Implementations

impl Lockfile

pub fn new() -> Self

Create a new empty lockfile.

pub fn load(path: &Path) -> Result<Option<Self>>

Load a lockfile from a TOML file.

Returns None if the file doesn’t exist. Returns an error if the file exists but is invalid.

pub fn save(&self, path: &Path) -> Result<()>

Save the lockfile to a TOML file.

pub fn find_image_artifact(&self, image: &str) -> Option<&LockedArtifact>

Find an image artifact by image reference.

pub fn find_tool(&self, name: &str) -> Option<&LockedTool>

Find a tool by name.

pub fn tool_names(&self) -> Vec<&str>

Get all tool names.

pub fn upsert_tool(&mut self, name: String, tool: LockedTool) -> Result<()>

Add or update a tool in the lockfile.

Errors

Returns an error if the tool fails validation (empty platforms or invalid digest format).

pub fn upsert_tool_platform( &mut self, name: &str, version: &str, platform: &str, data: LockedToolPlatform, ) -> Result<()>

Add or update a single platform for a tool.

Creates the tool entry if it doesn’t exist.

Errors

Returns an error if the platform data is invalid.

pub fn upsert_artifact(&mut self, artifact: LockedArtifact) -> Result<()>

Add or update an artifact in the lockfile (legacy v1 format).

Matches artifacts by image reference.

Errors

Returns an error if the artifact fails validation (empty platforms or invalid digest format).

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<'de> Deserialize<'de> for Lockfile

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

where __D: Deserializer<'de>,

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

impl StructuralPartialEq for Lockfile