Trait GitOps 

pub trait GitOps {
    // Required methods
    fn workdir(&self) -> Option<&Path>;
    fn current_branch(&self) -> Result<String>;
    fn head_detached(&self) -> Result<bool>;
    fn is_rebasing(&self) -> bool;
    fn branch_exists(&self, name: &str) -> bool;
    fn create_branch(&self, name: &str) -> Result<Oid>;
    fn checkout(&self, branch: &str) -> Result<()>;
    fn delete_branch(&self, name: &str) -> Result<()>;
    fn list_branches(&self) -> Result<Vec<String>>;
    fn branch_commit(&self, branch: &str) -> Result<Oid>;
    fn remote_branch_commit(&self, branch: &str) -> Result<Oid>;
    fn branch_commit_message(&self, branch: &str) -> Result<String>;
    fn merge_base(&self, one: Oid, two: Oid) -> Result<Oid>;
    fn commits_between(&self, from: Oid, to: Oid) -> Result<Vec<Oid>>;
    fn count_commits_between(&self, from: Oid, to: Oid) -> Result<usize>;
    fn is_clean(&self) -> Result<bool>;
    fn require_clean(&self) -> Result<()>;
    fn stage_all(&self) -> Result<()>;
    fn has_staged_changes(&self) -> Result<bool>;
    fn create_commit(&self, message: &str) -> Result<Oid>;
    fn amend_commit(&self, new_message: Option<&str>) -> Result<Oid>;
    fn rebase_onto(&self, target: Oid) -> Result<()>;
    fn rebase_onto_from(&self, onto: Oid, from: Oid) -> Result<()>;
    fn conflicting_files(&self) -> Result<Vec<String>>;
    fn predict_rebase_conflicts(
        &self,
        branch: &str,
        onto: Oid,
    ) -> Result<Vec<ConflictPrediction>>;
    fn rebase_abort(&self) -> Result<()>;
    fn rebase_continue(&self) -> Result<()>;
    fn origin_url(&self) -> Result<String>;
    fn remote_divergence(&self, branch: &str) -> Result<RemoteDivergence>;
    fn detect_default_branch(&self) -> Option<String>;
    fn push(&self, branch: &str, force: bool) -> Result<()>;
    fn fetch_all(&self) -> Result<()>;
    fn fetch(&self, branch: &str) -> Result<()>;
    fn pull_ff(&self) -> Result<()>;
    fn reset_branch(&self, branch: &str, commit: Oid) -> Result<()>;
}

Trait for git repository operations.

This trait abstracts git operations, allowing for:

• Dependency injection in commands/services
• Mock implementations for testing
• Alternative implementations (e.g., dry-run mode)

Note: Unlike GitHubApi, git operations are synchronous since git2 is a synchronous library.

Required Methods

fn workdir(&self) -> Option<&Path>

Get the working directory path.

fn current_branch(&self) -> Result<String>

Get the current branch name.

Returns an error if HEAD is detached or not on a branch.

fn head_detached(&self) -> Result<bool>

Check if HEAD is detached.

fn is_rebasing(&self) -> bool

Check if a rebase is in progress.

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

Check if a branch exists.

fn create_branch(&self, name: &str) -> Result<Oid>

Create a new branch at the current HEAD.

Returns the OID of the new branch’s tip commit.

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

Checkout a branch.

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

Delete a local branch.

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

List all local branches.

fn branch_commit(&self, branch: &str) -> Result<Oid>

Get the commit ID for a branch.

fn remote_branch_commit(&self, branch: &str) -> Result<Oid>

Get the commit ID for a remote branch.

fn branch_commit_message(&self, branch: &str) -> Result<String>

Get the commit message for a branch’s tip.

fn merge_base(&self, one: Oid, two: Oid) -> Result<Oid>

Find the merge base of two commits.

fn commits_between(&self, from: Oid, to: Oid) -> Result<Vec<Oid>>

Get commits between two OIDs.

fn count_commits_between(&self, from: Oid, to: Oid) -> Result<usize>

Count commits between two OIDs.

fn is_clean(&self) -> Result<bool>

Check if the working directory is clean.

fn require_clean(&self) -> Result<()>

Require that the working directory is clean.

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

Stage all changes.

fn has_staged_changes(&self) -> Result<bool>

Check if there are staged changes.

fn create_commit(&self, message: &str) -> Result<Oid>

Create a commit with the staged changes.

fn amend_commit(&self, new_message: Option<&str>) -> Result<Oid>

Amend the last commit with staged changes.

fn rebase_onto(&self, target: Oid) -> Result<()>

Rebase the current branch onto a target commit.

fn rebase_onto_from(&self, onto: Oid, from: Oid) -> Result<()>

Rebase using –onto semantics (rebase commits from from onto onto).

fn conflicting_files(&self) -> Result<Vec<String>>

Get files with conflicts during a rebase.

fn predict_rebase_conflicts( &self, branch: &str, onto: Oid, ) -> Result<Vec<ConflictPrediction>>

Predict conflicts that would occur when rebasing a branch onto a target.

Returns a list of commits that would cause conflicts along with the conflicting files. An empty list means no conflicts are predicted.

fn rebase_abort(&self) -> Result<()>

Abort a rebase in progress.

fn rebase_continue(&self) -> Result<()>

Continue a rebase after resolving conflicts.

fn origin_url(&self) -> Result<String>

Get the origin URL.

fn remote_divergence(&self, branch: &str) -> Result<RemoteDivergence>

Check divergence between local and remote branch.

fn detect_default_branch(&self) -> Option<String>

Detect the default branch (main/master).

Returns None if neither main nor master exists.

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

Push a branch to the remote.

fn fetch_all(&self) -> Result<()>

Fetch all remotes.

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

Fetch a specific branch.

fn pull_ff(&self) -> Result<()>

Pull with fast-forward only.

fn reset_branch(&self, branch: &str, commit: Oid) -> Result<()>

Reset a branch to a specific commit.

Implementors

impl GitOps for Repository