Struct DirLock 

pub struct DirLock { /* private fields */ }

An advisory file lock scoped to a directory.

The lock is acquired on creation and released when the guard is dropped. This uses fs2 advisory locking which coordinates between cooperating processes — it does not prevent non-cooperating processes from accessing the directory.

Example

use std::path::Path;
use aperture_cli::atomic::DirLock;

let lock = DirLock::acquire(Path::new("/tmp/cache")).unwrap();
// … perform cache operations …
drop(lock); // lock is released

Implementations

impl DirLock

pub fn acquire(dir: &Path) -> Result<Self>

Acquire an exclusive advisory lock on dir.

Creates the lock file (<dir>/.aperture.lock) if it does not exist. Blocks until the lock is available.

Errors

Returns an error if the lock file cannot be created or locked.

pub fn try_acquire(dir: &Path) -> Result<Option<Self>>

Try to acquire an exclusive advisory lock without blocking.

Returns Ok(None) if the lock is held by another process.

Errors

Returns an error if the lock file cannot be created.