Struct GitRepository 

pub struct GitRepository { /* private fields */ }

Git repository wrapper that handles Send/Sync constraints

git2::Repository is not Send/Sync due to internal raw pointers. We work around this by storing the path and using spawn_blocking for all git operations.

Implementations

impl GitRepository

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

Open a repository at the given path

pub fn discover<P: AsRef<Path>>(path: P) -> Result<Self>

Discover a repository starting from the given path

pub fn path(&self) -> &Path

Get the repository path (the .git directory or workdir path)

pub fn workdir(&self) -> &Path

Get the working directory root (parent of .git directory).

If path ends with .git, returns its parent. Otherwise returns path as-is. This is the directory that contains the actual source files.

pub async fn ensure_depth(&self, depth: u32) -> Result<()>

Ensure repository has sufficient depth for diff

pub async fn ensure_depth_with_retry( &self, base_sha: &str, head_sha: &str, initial_depth: u32, max_retries: u32, ) -> Result<()>

Ensure repository has sufficient depth with retry and exponential deepening

Tries to find the merge base between base and head. If the merge base is not reachable (shallow clone), deepens the repository and retries.

pub fn is_symlink_in_tree(&self, sha: &str, file_path: &str) -> Result<bool>

Check if a path is a symlink in a specific tree (by SHA)

Useful for detecting symlinks in deleted files where the working tree no longer has the file. Falls back to checking the git tree object.

pub fn diff_sync( &self, base_sha: &str, head_sha: &str, interner: &StringInterner, diff_filter: &str, ) -> Result<DiffResult>

Compute diff between two commits (sync version)

pub fn resolve_sha_sync(&self, reference: &str) -> Result<String>

Resolve a reference to a SHA (sync version)

pub fn submodules_sync(&self) -> Result<Vec<String>>

Get list of submodule paths (sync version)

impl GitRepository

pub async fn diff( &self, base_sha: &str, head_sha: &str, interner: &StringInterner, diff_filter: &str, ) -> Result<DiffResult>

Compute the diff between two SHAs, interning paths as they stream out.

The git2 work runs inline on the calling task: the endpoint tree diff is CPU/page-cache bound and completes in single-digit milliseconds on real repositories, so a spawn_blocking hop would cost more than it saves.

Trait Implementations

impl Send for GitRepository

impl Sync for GitRepository