Struct WorktreeManager 

pub struct WorktreeManager { /* private fields */ }

Manages git worktrees for a project.

Implementations

impl WorktreeManager

pub fn new(project_dir: impl Into<PathBuf>) -> Self

Create a new manager for the given project directory.

Worktrees are stored under ~/.opendev/data/worktree/.

pub fn with_base( project_dir: impl Into<PathBuf>, worktree_base: impl Into<PathBuf>, ) -> Self

Create a new manager with a custom worktree base directory.

Primarily useful for tests.

pub fn project_dir(&self) -> &Path

Get the project directory.

pub fn worktree_base(&self) -> &Path

Get the worktree base directory.

pub async fn create( &mut self, name: Option<&str>, branch: Option<&str>, base_branch: &str, ) -> Result<WorktreeInfo, WorktreeError>

Create a new worktree.

• name: worktree name (auto-generated if None)
• branch: branch name (defaults to worktree-{name})
• base_branch: base commit/branch to start from (defaults to "HEAD")

pub async fn list(&self) -> Result<Vec<WorktreeInfo>, WorktreeError>

List all worktrees for the project (from git worktree list --porcelain).

pub async fn remove( &mut self, name: &str, force: bool, ) -> Result<(), WorktreeError>

Remove a worktree by name (or absolute path).

pub async fn cleanup(&self) -> Result<String, WorktreeError>

Clean up stale/prunable worktree references.

pub fn tracked(&self) -> &HashMap<String, WorktreeInfo>

Get tracked worktrees in session state.

pub fn track(&mut self, name: String, info: WorktreeInfo)

Track a worktree in session state.

pub fn untrack(&mut self, name: &str) -> Option<WorktreeInfo>

Untrack a worktree from session state.