Struct WorktreeGuard 

pub struct WorktreeGuard { /* private fields */ }

RAII guard for a temporary git worktree.

Creates a detached worktree on construction, removes it on drop. This provides the language-agnostic foundation — just git checkout, no build steps. Language crates that need build steps (npm install, tsc, mvn compile) should compose with this guard:

// In a language crate:
pub struct TsWorktreeGuard {
    inner: semver_analyzer_core::git::WorktreeGuard,
    warnings: Vec<ExtractionWarning>,
}

Implementations

impl WorktreeGuard

pub fn new(repo: &Path, git_ref: &str) -> Result<Self>

Create a new worktree for the given git ref.

Validates the repository and ref, then creates a detached worktree at <repo>/.semver-worktrees/<sanitized-ref>. If a stale worktree exists at the same path, it is removed first.

On drop, the worktree is automatically removed.

pub fn path(&self) -> &Path

Path to the worktree directory.

pub fn git_ref(&self) -> &str

The git ref this worktree was created for.

pub fn cleanup_stale(repo: &Path) -> Result<usize>

Scan for and remove stale worktrees from previous crashed runs.

Looks in <tmp>/semver-worktrees/<repo-hash>/ for any existing directories and attempts to clean them up via git worktree remove.

Trait Implementations

impl Drop for WorktreeGuard

fn drop(&mut self)

Executes the destructor for this type.