Struct GitChangeTracker 

pub struct GitChangeTracker { /* private fields */ }

High-level facade for git change tracking

This provides a convenient API over the GitBackend trait with caching and error handling.

Implementations

impl GitChangeTracker

pub fn new(root: &Path) -> Result<Self>

Create a new git change tracker

Automatically selects the appropriate backend based on the SQRY_GIT_BACKEND environment variable:

• auto (default): Use subprocess git, fall back to NoGit
• subprocess: Force subprocess git (fail if git not found)
• none: Always use NoGit (disable git integration)

Errors

Returns GitError::NotFound if git binary is not in PATH and backend is set to subprocess.

Returns GitError::NotARepo if path is not a git repository (only when backend is subprocess or auto with git available).

pub fn detect_changes( &mut self, baseline: Option<&str>, ) -> Result<(ChangeSet, Option<String>)>

Detect changes since last indexed commit

If baseline is None, returns uncommitted changes only. If baseline is Some(commit_sha), returns changes since that commit.

Returns

• ChangeSet - Files changed
• Option<String> - Current HEAD commit SHA (for updating baseline)

Configuration

Respects these environment variables:

• SQRY_GIT_INCLUDE_UNTRACKED: Include untracked files (default: 1)
• SQRY_GIT_RENAME_SIMILARITY: Rename detection threshold 0-100 (default: 50)

Errors

Returns GitError when the underlying backend encounters IO failures, the repository is not available, or git command output is malformed.

pub fn head(&mut self) -> Result<Option<String>>

Get the current HEAD commit SHA

Uses cached value if available, otherwise queries git.

Errors

Returns GitError when requesting the HEAD from the backend fails.

pub fn repo_root(&self) -> Result<PathBuf>

Get the repository root path

Errors

Returns GitError when the backend cannot determine or canonicalize the root directory.

pub fn capabilities(&self) -> GitCapabilities

Get backend capabilities