Struct GitRepo 

pub struct GitRepo { /* private fields */ }

Git repository wrapper

Implementations

impl GitRepo

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

Open a git repository

pub fn is_git_repo(path: &Path) -> bool

Check if path is a git repository

pub fn current_branch(&self) -> Result<String, GitError>

Get current branch name

pub fn current_commit(&self) -> Result<String, GitError>

Get current commit hash

pub fn short_hash(&self, commit: &str) -> Result<String, GitError>

Get short commit hash

pub fn diff_files( &self, from: &str, to: &str, ) -> Result<Vec<ChangedFile>, GitError>

Get files changed between two commits

pub fn status(&self) -> Result<Vec<ChangedFile>, GitError>

Get files changed in working tree

Returns both staged and unstaged changes. For renames, the old_path field contains the original filename.

pub fn log(&self, count: usize) -> Result<Vec<Commit>, GitError>

Get recent commits

pub fn file_log( &self, path: &str, count: usize, ) -> Result<Vec<Commit>, GitError>

Get commits that modified a specific file

pub fn blame(&self, path: &str) -> Result<Vec<BlameLine>, GitError>

Get blame information for a file

pub fn ls_files(&self) -> Result<Vec<String>, GitError>

Get list of files tracked by git

pub fn diff_content( &self, from: &str, to: &str, path: &str, ) -> Result<String, GitError>

Get diff content between two commits for a file

pub fn uncommitted_diff(&self, path: &str) -> Result<String, GitError>

Get diff content for uncommitted changes (working tree vs HEAD) Includes both staged and unstaged changes.

pub fn all_uncommitted_diffs(&self) -> Result<String, GitError>

Get diff content for all uncommitted changes Returns combined diff for all changed files.

pub fn has_changes(&self, path: &str) -> Result<bool, GitError>

Check if a file has uncommitted changes

pub fn last_modified_commit(&self, path: &str) -> Result<Commit, GitError>

Get the commit where a file was last modified

pub fn file_change_frequency( &self, path: &str, days: u32, ) -> Result<u32, GitError>

Calculate file importance based on recent changes

pub fn file_at_ref(&self, path: &str, git_ref: &str) -> Result<String, GitError>

Get file content at a specific git ref (commit, branch, tag)

Uses git show <ref>:<path> to retrieve file content at that revision.

Arguments

• path - File path relative to repository root
• git_ref - Git ref (commit hash, branch name, tag, HEAD~n, etc.)

Returns

File content as string, or error if file doesn’t exist at that ref

Example

let repo = GitRepo::open(Path::new("."))?;
let content = repo.file_at_ref("src/main.rs", "HEAD~5")?;

pub fn diff_hunks( &self, from_ref: &str, to_ref: &str, path: Option<&str>, ) -> Result<Vec<DiffHunk>, GitError>

Parse diff between two refs into structured hunks

Returns detailed hunk information including line numbers for each change.

Arguments

• from_ref - Starting ref (e.g., “main”, “HEAD~5”, commit hash)
• to_ref - Ending ref (e.g., “HEAD”, “feature-branch”)
• path - Optional file path to filter to a single file

Returns

Vec of DiffHunk with structured line-level information

pub fn uncommitted_hunks( &self, path: Option<&str>, ) -> Result<Vec<DiffHunk>, GitError>

Parse uncommitted changes (working tree vs HEAD) into structured hunks

Arguments

• path - Optional file path to filter to a single file

Returns

Vec of DiffHunk for uncommitted changes

pub fn staged_hunks( &self, path: Option<&str>, ) -> Result<Vec<DiffHunk>, GitError>

Parse staged changes into structured hunks

Arguments

• path - Optional file path to filter to a single file

Returns

Vec of DiffHunk for staged changes only