Struct PluginLockfile 

pub struct PluginLockfile { /* private fields */ }

A plugin lockfile that tracks installed plugins, their sources, and integrity hashes.

Implementations

impl PluginLockfile

pub fn new() -> Self

Create an empty lockfile.

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

Load a lockfile from disk.

Acquires a shared (read) lock on a .lk sibling file to coordinate with concurrent writers.

Errors

Returns an error if the file cannot be read or parsed.

pub fn load_or_default(path: &Path) -> PluginResult<Self>

Load a lockfile from disk, returning an empty lockfile if the file doesn’t exist.

Uses an atomic read pattern to avoid TOCTOU races: attempts to read the file and handles NotFound instead of checking exists() first.

Errors

Returns an error if the file exists but cannot be read or parsed.

pub fn update<F>(path: &Path, f: F) -> PluginResult<()>

where F: FnOnce(&mut Self) -> PluginResult<()>,

Atomically load, mutate, and save the lockfile under a single exclusive lock.

Prevents TOCTOU races between concurrent plugin install / plugin remove operations that would otherwise load → drop lock → re-acquire → save, allowing another process to interleave and lose entries.

If the lockfile doesn’t exist, the closure receives an empty lockfile.

Errors

Returns an error if the file cannot be read, parsed, or written, or if the closure returns an error.

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

Save the lockfile to disk atomically.

Writes to a temporary file in the same directory (same filesystem), then atomically renames it into place. Acquires an exclusive lock on a .lk sibling file to coordinate with concurrent readers/writers.

Creates parent directories if needed.

Errors

Returns an error if the file cannot be written.

pub fn add(&mut self, entry: LockedPlugin)

Add or update a locked plugin entry.

If a plugin with the same ID already exists, it is replaced.

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

Remove a plugin entry by ID.

Returns true if an entry was removed.

pub fn get(&self, id: &PluginId) -> Option<&LockedPlugin>

Look up a locked plugin entry by ID.

pub fn entries(&self) -> &[LockedPlugin]

Get all locked plugin entries.

pub fn is_empty(&self) -> bool

Check whether the lockfile has any entries.

pub fn len(&self) -> usize

Number of locked plugin entries.

pub fn verify_integrity(&self, plugin_dir: &Path) -> Vec<IntegrityViolation>

Verify the integrity of installed plugins against the lockfile.

For each entry, checks:

1. The plugin directory and manifest exist on disk.
2. The manifest version matches the lockfile version.
3. The WASM module blake3 hash matches the lockfile hash.

Returns a list of violations (empty if everything is consistent).

Trait Implementations

impl Clone for PluginLockfile

fn clone(&self) -> PluginLockfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PluginLockfile

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

Formats the value using the given formatter.

impl Default for PluginLockfile

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PluginLockfile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PluginLockfile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.