mc-snap 0.6.0

Declarative Minecraft server management. Pin Minecraft, loader, mods, Java, and configs in one YAML file; resolve, install, run, and ship a reproducible bundle.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! Cross-process advisory lock on a project. Prevents two concurrent
//! `mc-snap install` / `update` / `start` invocations from stomping each
//! other's yml, lockfile, or `.mc-snap/server/`.
//!
//! Note: not to be confused with [`crate::lock`], which is the *lockfile schema*
//! (mc-snap.lock).

use anyhow::{Context, Result};
use fs2::FileExt;
use std::fs::{File, OpenOptions};
use std::path::Path;

/// RAII guard. Drop releases the lock and removes the file on a best-effort basis.
pub struct ProjectLock {
    file: File,
}

impl ProjectLock {
    /// Acquire an exclusive advisory lock on `path`. Errors immediately if another
    /// process holds it — callers should surface a clear message to the user.
    pub fn acquire(path: &Path) -> Result<Self> {
        if let Some(parent) = path.parent() {
            std::fs::create_dir_all(parent)?;
        }
        let file = OpenOptions::new()
            .read(true)
            .write(true)
            .create(true)
            .truncate(false)
            .open(path)
            .with_context(|| format!("opening lock file {}", path.display()))?;
        file.try_lock_exclusive().with_context(|| {
            format!(
                "another mc-snap command holds the project lock at {}",
                path.display()
            )
        })?;
        Ok(Self { file })
    }
}

impl Drop for ProjectLock {
    fn drop(&mut self) {
        let _ = FileExt::unlock(&self.file);
    }
}