Enum GitError 

pub enum GitError {
    NotFound,
    NotARepo(PathBuf),
    Timeout(u64),
    CommandFailed {
        message: String,
        stdout: String,
        stderr: String,
    },
    InvalidOutput(String),
    OutputExceededLimit {
        limit_bytes: usize,
        actual_bytes: usize,
    },
    Io(Error),
    NotSupported(String),
}

Errors that can occur during git operations

Variants

NotFound

Git binary not found in PATH

NotARepo(PathBuf)

Directory is not a git repository

Timeout(u64)

Git command timed out

CommandFailed

Git command failed with non-zero exit

Fields

message: String

Error message describing the failure

stdout: String

Standard output from the git command

stderr: String

Standard error from the git command

InvalidOutput(String)

Failed to parse git output

OutputExceededLimit

Git output exceeded configured limit (P1-17)

This error occurs when a git command produces more output than the configured limit (default 10MB, range 1MB-100MB via SQRY_GIT_MAX_OUTPUT_SIZE).

Security

This protects against DoS attacks from malicious repositories with arbitrarily large git diffs or status output.

Resolution

1. Investigate the large output: git diff --stat
2. Check for accidentally committed binaries or vendored dependencies
3. If legitimate, increase the limit: export SQRY_GIT_MAX_OUTPUT_SIZE=<bytes>

Fields

limit_bytes: usize

Configured limit in bytes

actual_bytes: usize

Actual output size in bytes (conservative estimate if truncated)

Io(Error)

IO error occurred

NotSupported(String)

Feature not supported by this backend

Implementations

impl GitError

pub fn suggested_limit(&self) -> usize

Calculate suggested new limit (2× actual, rounded up to nearest MB)

pub fn detailed_message(&self) -> String

Get detailed error message with suggestions (P1-17)

For OutputExceededLimit, returns a detailed message with:

• Current limit in MB
• Actual output size in MB
• Suggested new limit (2× actual, rounded up)
• Investigation steps

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<Error> for GitError

fn from(source: Error) -> Self

Converts to this type from the input type.