Struct PackageLock 

pub struct PackageLock {
    pub version: String,
    pub packages: Vec<LockedPackage>,
    pub artifacts: Vec<LockedArtifact>,
}

Top-level lockfile structure written to shape.lock.

Fields

version: String

Lockfile format version (currently “1”).

packages: Vec<LockedPackage>

Locked packages in dependency order.

artifacts: Vec<LockedArtifact>

Cached compile-time artifacts.

Implementations

impl PackageLock

pub fn new() -> Self

Create a new empty lockfile.

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

Read a lockfile from the given path. Returns None if the file doesn’t exist or cannot be parsed.

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

Write the lockfile to the given path.

pub fn is_fresh(&self, deps: &HashMap<String, DependencySpec>) -> bool

Check whether this lockfile is still fresh (matches the given deps).

A lockfile is fresh if every dependency in the spec is present in the lockfile and every locked package corresponds to a declared dependency.

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

Upsert a compile-time artifact by (namespace, key).

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

Upsert a compile-time artifact by (namespace, key, inputs_hash).

This is used for host-bound artifacts such as native dependency locks, where multiple variants for the same logical key may coexist across targets or fingerprints in a single committed lockfile.

pub fn artifact( &self, namespace: &str, key: &str, inputs_hash: &str, ) -> Option<&LockedArtifact>

Lookup artifact by (namespace, key, inputs_hash).

pub fn hash_inputs(inputs: &BTreeMap<String, String>) -> String

Compute a stable SHA-256 hash for inputs map.

pub fn artifact_inputs_hash( inputs: BTreeMap<String, String>, determinism: &ArtifactDeterminism, ) -> Result<String, String>

Compute artifact inputs hash after applying determinism policy rules.

pub fn hash_path(path: &Path) -> Result<String>

Compute a content hash for a directory or file at the given path.

For files, hashes the file content. For directories, hashes the concatenation of all .shape file contents (sorted by name).

Trait Implementations

impl Clone for PackageLock

fn clone(&self) -> PackageLock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackageLock

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

Formats the value using the given formatter.

impl Default for PackageLock

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PackageLock

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PackageLock

fn eq(&self, other: &PackageLock) -> 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 PackageLock

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 PackageLock