Enum GitError 

pub enum GitError {
    Open {
        path: PathBuf,
        source: Error,
    },
    Tags(Error),
    Resolve {
        revision: String,
        source: Error,
    },
    Reference {
        name: String,
        source: Error,
    },
    Ancestry {
        ancestor: String,
        descendant: String,
        source: Error,
    },
    Diff {
        from: Option<String>,
        to: String,
        paths: Vec<PathBuf>,
        source: Error,
    },
    History {
        from: Option<String>,
        to: String,
        paths: Vec<PathBuf>,
        source: Error,
    },
    Remote {
        name: String,
        source: Error,
    },
    Fetch {
        remote: String,
        refspec: String,
        source: Error,
    },
    WorktreeAdd {
        path: PathBuf,
        source: Error,
    },
    WorktreeRemove {
        path: PathBuf,
        source: Error,
    },
    WorktreeRemoveFailed {
        path: PathBuf,
        prune: Error,
        branch: Error,
    },
    Stage {
        worktree: PathBuf,
        source: Error,
    },
    Commit {
        worktree: PathBuf,
        source: Error,
    },
    Tag {
        tag: String,
        source: Error,
    },
    List {
        remote: String,
        source: Error,
    },
    StaleLease {
        reference: String,
        expected: Option<String>,
        actual: Option<String>,
    },
    Push {
        reference: String,
        source: Error,
    },
    Rejected {
        reference: String,
        status: String,
    },
}

A Git query or mutation failure.

Variants

Open

The directory is not a Git repository or worktree libgit2 can open.

Fields

path: PathBuf

The directory.

source: Error

The libgit2 failure.

Tags(Error)

The tag names could not be read.

Resolve

A revision expression does not name a commit.

Fields

revision: String

The revision expression.

source: Error

The libgit2 failure.

Reference

A reference exists but cannot be read or peeled to a commit.

Fields

name: String

The full reference name.

source: Error

The libgit2 failure.

Ancestry

The ancestry of two commits could not be read.

Fields

ancestor: String

The possible ancestor.

descendant: String

The possible descendant.

source: Error

The libgit2 failure.

Diff

Two commits could not be compared.

Fields

from: Option<String>

The older revision, absent for the empty tree.

to: String

The newer revision.

paths: Vec<PathBuf>

The repository paths the comparison is limited to.

source: Error

The libgit2 failure.

History

The commits between two revisions could not be listed.

Fields

from: Option<String>

The older revision, absent for the whole history.

to: String

The newer revision.

paths: Vec<PathBuf>

The repository paths the commits are limited to.

source: Error

The libgit2 failure.

Remote

The named remote is not configured.

Fields

name: String

The remote name.

source: Error

The libgit2 failure.

Fetch

A fetch failed.

Fields

remote: String

The remote name.

refspec: String

The requested refspec.

source: Error

The libgit2 failure.

WorktreeAdd

A disposable worktree could not be created.

Fields

path: PathBuf

The worktree directory.

source: Error

The libgit2 failure.

WorktreeRemove

A disposable worktree could not be removed.

Fields

path: PathBuf

The worktree directory.

source: Error

The libgit2 failure.

WorktreeRemoveFailed

The worktree could not be pruned and its branch could not be deleted.

Fields

path: PathBuf

The worktree directory.

prune: Error

The prune failure.

branch: Error

The branch deletion failure.

Stage

Worktree changes could not be staged.

Fields

worktree: PathBuf

The worktree.

source: Error

The libgit2 failure.

Commit

The staged changes could not be committed.

Fields

worktree: PathBuf

The worktree.

source: Error

The libgit2 failure.

Tag

An annotated tag could not be created.

Fields

tag: String

The tag name.

source: Error

The libgit2 failure.

List

The remote reference heads could not be listed.

Fields

remote: String

The remote name.

source: Error

The libgit2 failure.

StaleLease

The remote branch moved away from the head the push expected.

Fields

reference: String

The full remote reference name.

expected: Option<String>

The head the push was based on; None requires the branch to be absent.

actual: Option<String>

The head on the remote; None when the branch is absent.

Push

The push could not be sent.

Fields

reference: String

The full remote reference name.

source: Error

The libgit2 failure.

Rejected

The remote refused a reference update.

Fields

reference: String

The full remote reference name.

status: String

The status the remote reported.

Trait Implementations

impl Debug for GitError

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

Formats the value using the given formatter.

impl Display for GitError

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

Formats the value using the given formatter.

impl Error for GitError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.