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 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) -> Option<String>

Returns the fetch URL of the named remote, or 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 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.