Struct SystemGit 

pub struct SystemGit {
    credentials: Option<RemoteCredentials>,
}

Production Git adapter backed by libgit2.

Fields

credentials: Option<RemoteCredentials>

Implementations

impl SystemGit

pub const fn authenticated(credentials: RemoteCredentials) -> Self

An adapter that answers HTTPS authentication requests with credentials.

fn proxy() -> ProxyOptions<'static>

Proxy settings taken from the Git configuration and environment, as the git command line uses them.

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

fn commit<'r>(repo: &'r Repository, rev: &str) -> Result<Commit<'r>, Git2Error>

The commit a revision expression names.

fn origin(repo: &Repository) -> Result<Remote<'_>, GitError>

fn worktree_name(path: &Path) -> String

The worktree and private branch name for a worktree directory, derived from its path so that removal finds what creation registered.

fn callbacks(&self) -> RemoteCallbacks<'_>

Callbacks that offer the configured credential once per connection, so a rejected token fails instead of being retried forever.

fn remote_head( &self, remote: &mut Remote<'_>, reference: &str, ) -> Result<Option<Oid>, GitError>

Read the head of reference on remote right now.

fn push( &self, remote: &mut Remote<'_>, refspec: &str, reference: &str, ) -> Result<(), GitError>

Push refspec to remote, failing when the remote rejects an update.

Trait Implementations

impl Clone for SystemGit

fn clone(&self) -> SystemGit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SystemGit

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

Formats the value using the given formatter.

impl Default for SystemGit

fn default() -> SystemGit

Returns the “default value” for a type.

impl GitCommands for SystemGit

type Error = GitError

The failure of a tag or authority operation.

fn authoritative_head( &self, repository: &Path, branch: &str, ) -> Result<String, Self::Error>

Commit branch points at now.

fn create_tag( &self, repository: &Path, tag: &str, commit: &str, author: Author<'_>, ) -> Result<(), Self::Error>

Create an annotated tag on commit locally, tagged by author.

fn push_tag(&self, repository: &Path, tag: &str) -> Result<(), Self::Error>

Push a local tag to origin.

impl GitHistory for SystemGit

type Error = GitError

The failure of a history read.

fn tags( &self, repository: &Path, prefix: &str, ) -> Result<Vec<String>, Self::Error>

List the tag names that start with prefix.

fn resolve(&self, repository: &Path, rev: &str) -> Result<String, Self::Error>

The commit a revision expression such as origin/main names.

fn has_changes( &self, repository: &Path, from: Option<&str>, to: &str, scope: UnitScope<'_>, ) -> Result<bool, Self::Error>

Whether scope differs between the commits from and to. Without from the comparison starts from the empty tree.

fn commit_messages( &self, repository: &Path, from: Option<&str>, to: &str, scope: UnitScope<'_>, ) -> Result<Vec<String>, Self::Error>

Messages of the commits after from up to to that change scope, oldest first. Without from the walk reaches the root commit. Merge commits are left out.

fn is_ancestor( &self, repository: &Path, ancestor: &str, descendant: &str, ) -> Result<bool, Self::Error>

Whether ancestor is descendant or reachable from it.

fn equivalent( &self, repository: &Path, base: &str, first: &str, second: &str, ) -> Result<bool, Self::Error>

Whether the first-parent chains from base to first and from base to second have the same length and the same trees and messages. A chain that does not reach base is equivalent to nothing.

impl GitRefs for SystemGit

type Error = GitError

The failure of a reference lookup.

fn reference( &self, repository: &Path, name: &str, ) -> Result<Option<String>, Self::Error>

The commit a full reference name points at, or None when the reference does not exist.

impl ProposalGit for SystemGit

fn push_with_lease( &self, worktree: &Path, branch: &str, expected: Option<&str>, ) -> Result<(), Self::Error>

Emulates --force-with-lease by reading the remote branch head immediately before a forced push; a concurrent update between the read and the push can still be overwritten.

type Error = GitError

The failure of a branch update.

fn fetch_if_present( &self, repository: &Path, refspec: &str, ) -> Result<(), Self::Error>

Like fetch, but succeed when the remote has no reference named by refspec.

fn fetch(&self, repository: &Path, refspec: &str) -> Result<(), Self::Error>

Update local references from origin as refspec maps them.

fn worktree_add( &self, repository: &Path, path: &Path, baseline: &str, ) -> Result<(), Self::Error>

Create a disposable worktree at the not yet existing path, checked out to baseline on a private branch.

fn worktree_remove( &self, repository: &Path, path: &Path, ) -> Result<(), Self::Error>

Remove a worktree created with ProposalGit::worktree_add.

fn stage_update( &self, worktree: &Path, paths: &[PathBuf], ) -> Result<(), Self::Error>

Stage the changes at these worktree-relative paths, tracked or not.

fn commit_if_staged( &self, worktree: &Path, message: &str, author: Author<'_>, ) -> Result<Option<String>, Self::Error>

Commit staged changes, returning the new commit hash, or None when nothing was staged.