Enum GitError 

pub enum GitError {
    NotRepository,
    UnsupportedRepositoryPath,
    InvalidPath(RepoPathError),
    PathEscapesRepository {
        path: String,
    },
    NotAFile {
        path: String,
    },
    EmptyCommitMessage,
    Spawn {
        operation: &'static str,
        source: Error,
    },
    CommandFailed {
        operation: &'static str,
        status: Option<i32>,
        stderr: String,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    SourceTooLarge {
        bytes: u64,
    },
    UnstableSnapshot,
    Diff(DiffError),
}

An error from repository discovery, Git execution, or worktree access.

Variants

NotRepository

The supplied location is not inside a Git worktree.

UnsupportedRepositoryPath

Git returned a repository root that cannot be represented as UTF-8.

InvalidPath(RepoPathError)

A repository-relative path failed validation.

PathEscapesRepository

A validated path resolved outside the repository root.

Fields

path: String

The rejected path.

NotAFile

A file operation unexpectedly targeted a directory.

Fields

path: String

The rejected path.

EmptyCommitMessage

A commit message was empty or only whitespace.

Spawn

The Git process could not be started or awaited.

Fields

operation: &'static str

A non-sensitive operation label.

source: Error

The subprocess I/O error.

CommandFailed

Git exited unsuccessfully.

stderr is retained for diagnostics, but omitted from Display to avoid leaking file contents or other sensitive command output.

Fields

operation: &'static str

A non-sensitive operation label.

status: Option<i32>

The process exit code, when one was available.

stderr: String

Git’s standard error bytes, decoded lossily.

Io

A filesystem operation failed.

Fields

path: PathBuf

The affected host path.

source: Error

The filesystem error.

SourceTooLarge

A source version exceeded the per-file capture limit.

Fields

bytes: u64

UnstableSnapshot

Repository metadata or worktree content changed during capture.

Diff(DiffError)

Core diff normalization failed.

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.

impl From<DiffError> for GitError

fn from(source: DiffError) -> Self

Converts to this type from the input type.

impl From<RepoPathError> for GitError

fn from(source: RepoPathError) -> Self

Converts to this type from the input type.