Struct GitBackend 

pub struct GitBackend { /* private fields */ }

Git backend.

Uses gix::ThreadSafeRepository so the struct is natively Send + Sync without any mutex. Each method obtains a cheap thread-local repository view via gix::ThreadSafeRepository::to_thread_local, eliminating serialization under concurrent async load.

Implementations

impl GitBackend

pub fn open(path: &Path) -> Result<Self>

Opens or discovers a Git repository at or above path.

Traverses parent directories until it finds a .git directory (or a bare repository), so callers may pass any subdirectory of the worktree.

Trait Implementations

impl VcsBackend for GitBackend

fn status_digest(&self) -> Result<StatusDigest>

fn local_branches(&self) -> Result<Vec<BranchInfo>>

fn remote_branches(&self) -> Result<Vec<BranchInfo>>

fn list_commits(&self) -> Result<Vec<CommitInfo>>

fn list_commits_sorted(&self, order: SortOrder) -> Result<Vec<CommitInfo>>

fn log_since( &self, since: SystemTime, until: SystemTime, ) -> Result<Vec<CommitInfo>>

fn find_commit(&self, id: &CommitId) -> Result<CommitInfo>

fn query_commits(&self, query: CommitQuery) -> Result<CommitQueryResult>

Returns a bounded page of commit history according to query.

fn list_tags(&self) -> Result<Vec<TagInfo>>

fn list_tags_sorted(&self, order: SortOrder) -> Result<Vec<TagInfo>>

fn create_tag(&self, name: &str) -> Result<()>

Creates a lightweight tag at HEAD.

fn create_annotated_tag(&self, name: &str, message: &str) -> Result<()>

Creates an annotated tag at HEAD.

fn delete_tag(&self, name: &str) -> Result<()>

Deletes the named tag.

fn diff(&self, from: &CommitId, to: &CommitId) -> Result<DiffSummary>

fn remote_url(&self, name: &str) -> Result<Option<String>>

Returns the fetch URL of the named remote, or Ok(None) if not configured.

fn is_dirty(&self) -> Result<bool>

Returns true if the working tree has any uncommitted changes (staged or unstaged). Bare repositories always return false.

fn merge_base(&self, a: &CommitId, b: &CommitId) -> Result<Option<CommitId>>

Returns the best common ancestor of a and b, or None if there is no shared history (unrelated histories).

fn is_ancestor( &self, candidate: &CommitId, descendant: &CommitId, ) -> Result<bool>

Returns true if candidate is a direct or transitive ancestor of descendant. A commit is considered its own ancestor.

fn ahead_behind( &self, local: &CommitId, upstream: &CommitId, ) -> Result<AheadBehind>

Returns ahead/behind counts between local and upstream commit tips.

fn branch_ahead_behind(&self, branch: &str) -> Result<Option<AheadBehind>>

Returns ahead/behind counts for the configured upstream of branch.

fn repository_info(&self) -> Result<RepositoryInfo>

Returns a lightweight metadata snapshot of the repository.

fn branch_tracking(&self, branch: &str) -> Result<BranchTrackingInfo>

Returns tracking metadata and divergence data for branch.

fn local_branch_tracking(&self) -> Result<Vec<BranchTrackingInfo>>

Returns tracking metadata for all local branches, sorted ascending by full ref name.

fn is_merged_into(&self, b: &str, target: &str) -> Result<bool>

Returns true if branch has been merged into target.

fn blame(&self, path: &Path) -> Result<Vec<BlameEntry>>

Returns per-line commit attribution for path at HEAD.

fn worktree_status(&self) -> Result<WorktreeStatus>

Returns per-file working-tree status: staged changes, unstaged changes, and untracked files (with gitignore applied).

fn rich_worktree_status( &self, options: StatusOptions, ) -> Result<RichWorktreeStatus>

Returns a richer working-tree status with more file-level change kinds.

fn file_at_commit(&self, path: &Path, commit_id: &CommitId) -> Result<Vec<u8>>

Returns the raw bytes of path (relative to the repository root) as it exists in the tree of commit_id.

fn submodules(&self) -> Result<Vec<SubmoduleInfo>>

Returns metadata for all submodules declared in .gitmodules.

fn stash_entries(&self) -> Result<Vec<StashEntry>>

Returns all stash entries, newest first.

fn worktrees(&self) -> Result<Vec<WorktreeInfo>>

Returns all linked worktrees. The main worktree is not included.

fn operation_state(&self) -> Result<OperationState>

Returns the current in-progress repository operation, if any.

fn unmerged_paths(&self) -> Result<Vec<PathBuf>>

Returns paths with unmerged (higher-stage) index entries.

fn conflict_summary(&self) -> Result<ConflictSummary>

Returns a structured summary of all conflicted index entries.

fn blame_at(&self, path: &Path, commit_id: &CommitId) -> Result<Vec<BlameEntry>>

Per-line commit attribution for path at commit_id (not HEAD).

fn tree_at_commit(&self, commit_id: &CommitId) -> Result<Vec<TreeEntry>>

Non-recursive root-level tree listing at commit_id, sorted ascending by name.

fn tree_at_path( &self, commit_id: &CommitId, path: &Path, ) -> Result<Vec<TreeEntry>>

Non-recursive tree listing of the directory at path within commit_id.

fn remotes(&self) -> Result<Vec<RemoteInfo>>

Returns all configured remotes, sorted ascending by name.

fn references(&self) -> Result<Vec<RefInfo>>

Returns all references, sorted ascending by full name.

fn references_by_kind(&self, kind: RefKind) -> Result<Vec<RefInfo>>

Returns references matching kind, sorted ascending by full name.

fn submodule_summaries(&self) -> Result<Vec<SubmoduleSummary>>

Returns rich metadata for each submodule, including initialization and sync state. More expensive than submodules. Sorted ascending by path.

fn stash_detail(&self, index: usize) -> Result<StashDetail>

Returns detailed metadata for the stash entry at index.

fn stash_diff(&self, index: usize) -> Result<DiffSummary>

Returns a diff summary for the stash at index vs its first parent.

fn worktree_details(&self) -> Result<Vec<WorktreeDetail>>

Returns rich detail for all linked worktrees, sorted by id. Missing worktrees are reported as WorktreeState::MissingPath rather than omitted.