Struct GitRepository

pub struct GitRepository { /* private fields */ }

Wrapper around git2::Repository with safe operations

For thread safety, use the async variants (e.g., fetch_async, pull_async) which automatically handle threading using tokio::spawn_blocking. The async methods create new repository instances in background threads.

Implementations

impl GitRepository

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

Open a Git repository at the given path Automatically loads SSL configuration from cascade config if available

pub fn get_info(&self) -> Result<RepositoryInfo>

Get repository information

pub fn get_current_branch(&self) -> Result<String>

Get the current branch name

pub fn get_head_commit_hash(&self) -> Result<String>

Get the HEAD commit hash

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

Check if the working directory is dirty (has uncommitted changes)

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

Get list of untracked files

pub fn create_branch(&self, name: &str, target: Option<&str>) -> Result<()>

Create a new branch

pub fn checkout_branch(&self, name: &str) -> Result<()>

Switch to a branch with safety checks

pub fn checkout_branch_unsafe(&self, name: &str) -> Result<()>

Switch to a branch with force option to bypass safety checks

pub fn checkout_commit(&self, commit_hash: &str) -> Result<()>

Checkout a specific commit (detached HEAD) with safety checks

pub fn checkout_commit_unsafe(&self, commit_hash: &str) -> Result<()>

Checkout a specific commit with force option to bypass safety checks

pub fn branch_exists(&self, name: &str) -> bool

Check if a branch exists

pub fn branch_exists_or_fetch(&self, name: &str) -> Result<bool>

Check if a branch exists locally, and if not, attempt to fetch it from remote

pub fn get_branch_commit_hash(&self, branch_name: &str) -> Result<String>

Get the commit hash for a specific branch without switching branches

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

List all local branches

pub fn get_upstream_branch(&self, branch_name: &str) -> Result<Option<String>>

Get the upstream branch for a local branch

pub fn get_ahead_behind_counts( &self, local_branch: &str, upstream_branch: &str, ) -> Result<(usize, usize)>

Get ahead/behind counts compared to upstream

pub fn set_upstream( &self, branch_name: &str, remote: &str, remote_branch: &str, ) -> Result<()>

Set upstream tracking for a branch

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

Create a commit with all staged changes

pub fn commit_staged_changes( &self, default_message: &str, ) -> Result<Option<String>>

Commit any staged changes with a default message

pub fn stage_all(&self) -> Result<()>

Stage all changes

pub fn stage_files(&self, file_paths: &[&str]) -> Result<()>

Stage only specific files (safer than stage_all during rebase)

pub fn stage_conflict_resolved_files(&self) -> Result<()>

Stage only files that had conflicts (safer for rebase operations)

pub fn path(&self) -> &Path

Get repository path

pub fn commit_exists(&self, commit_hash: &str) -> Result<bool>

Check if a commit exists

pub fn get_head_commit(&self) -> Result<Commit<'_>>

Get the HEAD commit object

pub fn get_commit(&self, commit_hash: &str) -> Result<Commit<'_>>

Get a commit object by hash

pub fn get_branch_head(&self, branch_name: &str) -> Result<String>

Get the commit hash at the head of a branch

pub fn validate_git_user_config(&self) -> Result<()>

Validate git user configuration is properly set

pub fn get_status(&self) -> Result<Statuses<'_>>

Get repository status

pub fn get_status_summary(&self) -> Result<GitStatusSummary>

Get a summary of repository status

pub fn get_current_commit_hash(&self) -> Result<String>

Get the current commit hash (alias for get_head_commit_hash)

pub fn get_commit_count_between( &self, from_commit: &str, to_commit: &str, ) -> Result<usize>

Get the count of commits between two commits

pub fn get_remote_url(&self, name: &str) -> Result<String>

Get remote URL for a given remote name

pub fn cherry_pick(&self, commit_hash: &str) -> Result<String>

Cherry-pick a specific commit to the current branch

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

Check for merge conflicts in the index

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

Get list of conflicted files

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

Fetch from remote origin

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

Pull changes from remote (fetch + merge)

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

Push current branch to remote

pub fn delete_branch(&self, name: &str) -> Result<()>

Delete a local branch

pub fn delete_branch_unsafe(&self, name: &str) -> Result<()>

Delete a local branch with force option to bypass safety checks

pub fn get_commits_between( &self, from: &str, to: &str, ) -> Result<Vec<Commit<'_>>>

Get commits between two references

pub fn force_push_branch( &self, target_branch: &str, source_branch: &str, ) -> Result<()>

Force push one branch’s content to another branch name This is used to preserve PR history while updating branch contents after rebase

pub fn force_push_branch_unsafe( &self, target_branch: &str, source_branch: &str, ) -> Result<()>

Force push with explicit force flag to bypass safety checks

pub fn detect_main_branch(&self) -> Result<String>

Detect the main branch name (main, master, develop)

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

Get staged files in index

pub fn resolve_reference(&self, reference: &str) -> Result<Commit<'_>>

Resolve a reference (branch name, tag, or commit hash) to a commit

pub fn reset_soft(&self, target_ref: &str) -> Result<()>

Reset HEAD to a specific reference (soft reset)

pub fn find_branch_containing_commit(&self, commit_hash: &str) -> Result<String>

Find which branch contains a specific commit

pub async fn fetch_async(&self) -> Result<()>

Fetch from remote origin (async)

pub async fn pull_async(&self, branch: &str) -> Result<()>

Pull changes from remote (async)

pub async fn push_branch_async(&self, branch_name: &str) -> Result<()>

Push branch to remote (async)

pub async fn cherry_pick_commit_async( &self, commit_hash: &str, ) -> Result<String>

Cherry-pick commit (async)

pub async fn get_commit_hashes_between_async( &self, from: &str, to: &str, ) -> Result<Vec<String>>

Get commit hashes between two refs (async)

pub fn reset_branch_to_commit( &self, branch_name: &str, commit_hash: &str, ) -> Result<()>

Reset a branch to point to a specific commit