Struct GitRepo 

pub struct GitRepo { /* private fields */ }

Implementations

impl GitRepo

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

Attempt to open (discover) a git repository at or above path. Returns None if path is not inside a git repository.

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

Returns the current branch name, or None if HEAD is detached.

pub fn summary(&self) -> Result<GitSummary>

Returns a high-level summary of the repository state: branch, dirty counts, ahead/behind.

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

Returns true if the working tree has any uncommitted changes or untracked files.

pub fn ahead_behind(&self) -> Result<Option<(usize, usize)>>

Returns (ahead, behind) counts relative to the upstream tracking branch. Returns None if there’s no tracking branch configured or HEAD is detached.

pub fn commit_all(&self, message: &str) -> Result<()>

Stage all changes and create a commit. Errors if there’s nothing to commit.

pub fn dirty_files(&self) -> Result<Vec<DirtyFile>>

Returns a list of dirty files with their statuses. Uses git status --porcelain for reliable results across all repo states.

pub fn push(&self) -> Result<PushResult>

pub fn pull(&self) -> Result<PullResult>