Enum GitError 

pub enum GitError {
    PathTraversal(String),
    Unauthorised(String),
    NotARepository(String),
    BackendNotAvailable(String),
    BackendFailed {
        exit_code: Option<i32>,
        stderr: String,
    },
    MalformedCgi(String),
    Io(Error),
    Auth(AuthError),
}

All failure modes the Git HTTP service may surface.

Variants

PathTraversal(String)

Path-traversal attempt or otherwise invalid URL. JSS returns 400 for malformed requests and 403 for traversal; we fold both into a single 400 per Rust idiom (the leakage surface is identical — the client must not learn whether a repo exists via the status code).

Unauthorised(String)

Authorisation required but missing / malformed / rejected.

NotARepository(String)

The request targets a path that is not a git repository.

BackendNotAvailable(String)

git-http-backend (or git) binary not installed in PATH. Distinguished from a generic I/O error so callers can gate integration tests.

BackendFailed

The CGI process exited non-zero before emitting headers.

Fields

exit_code: Option<i32>

Process exit code, if the child did terminate.

stderr: String

Captured stderr content for diagnostics.

MalformedCgi(String)

The CGI process emitted malformed output.

Io(Error)

Generic underlying I/O failure.

Auth(AuthError)

Underlying auth-layer error (NIP-98 decode, Schnorr mismatch, …).

Implementations

impl GitError

pub fn status_code(&self) -> u16

Recommended HTTP status code to surface to the client.

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

fn from(source: AuthError) -> Self

Converts to this type from the input type.

impl From<Error> for GitError

fn from(source: Error) -> Self

Converts to this type from the input type.