Struct GitRepo 

pub struct GitRepo { /* private fields */ }

A git repository handle providing typed methods for git operations. All operations shell out to git -C {path} with LC_ALL=C.

Implementations

impl GitRepo

pub fn new(path: impl Into<PathBuf>) -> Self

pub fn path(&self) -> &Path

pub fn is_git_repo(&self) -> bool

Check if the path is a git repository (has .git directory or file)

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

Get the default branch name (main or master)

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

Check if the working tree has uncommitted changes

pub fn change_count(&self) -> Result<usize, GitError>

Count the number of changed files (staged + unstaged + untracked).

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

Get the current branch name (empty string if detached HEAD)

pub fn ahead_behind(&self, base: &str) -> Result<(u32, u32), GitError>

Get ahead/behind counts relative to a base branch

pub fn worktree_add( &self, path: &Path, branch: &str, base: &str, ) -> Result<(), GitError>

Add a new worktree

pub fn worktree_remove(&self, path: &Path, force: bool) -> Result<(), GitError>

Remove a worktree

pub fn worktree_lock(&self, path: &Path, reason: &str) -> Result<(), GitError>

Lock a worktree with a reason

pub fn worktree_unlock(&self, path: &Path) -> Result<(), GitError>

Unlock a worktree

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

Prune stale worktree entries

pub fn worktree_list(&self) -> Result<Vec<WorktreeEntry>, GitError>

List worktrees using --porcelain format for reliable parsing

pub fn branch_delete(&self, name: &str, force: bool) -> Result<(), GitError>

Delete a local branch

pub fn ref_exists(&self, refspec: &str) -> Result<bool, GitError>

Check if a ref exists (local branch, remote ref, tag, or arbitrary ref).

pub fn push_tracking(&self, branch: &str) -> Result<(), GitError>

Push a branch and set up tracking

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

Fetch from origin

pub fn resolve_start_point(&self, branch: &str) -> String

Resolve the best available start point for a new worktree. Prefers origin/{branch} (freshest state), falls back to local {branch}. Call after fetch() to ensure remote refs are up-to-date.

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

Pull with rebase from origin

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

Abort a rebase in progress

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

Hard reset to HEAD (discard all staged and unstaged changes)

pub fn reset_hard_to(&self, target: &str) -> Result<(), GitError>

Hard reset to a specific ref

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

Remove untracked files and directories

pub fn rebase(&self, target: &str) -> Result<(), GitError>

Rebase current branch onto a target ref

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

Stage a file

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

Commit with a message

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

Push to origin (current branch)

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

Get the remote URL for origin

Trait Implementations

impl Clone for GitRepo

fn clone(&self) -> GitRepo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GitRepo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.