Enum TransferError 

pub enum TransferError {
    ServerObject(ObjectError),
    NoDownloadAction,
    ActionStatus {
        status: u16,
        url: String,
        retry_after: Option<Duration>,
    },
    Http(Error),
    Io(Error),
    Store(StoreError),
    InvalidOid(OidParseError),
    UnsupportedHashAlgo(String),
    BatchResponse(Box<ApiError>),
}

Why a per-object transfer failed.

Errors with is_retryable() == true are retried by the queue up to TransferConfig::max_attempts; everything else fails fast.

Variants

ServerObject(ObjectError)

The batch endpoint returned a per-object error (404, 410, 422, …). Not retryable: the server has already classified the object.

NoDownloadAction

The batch response listed the object with neither actions nor error for a download — the spec forbids this, but real servers do it occasionally; we surface it instead of panicking.

ActionStatus

The action URL responded with a non-success status. The URL is embedded in the Display impl so users can see which endpoint failed (in particular, what insteadOf rewriting did to the original batch URL — see t-pull’s pull with invalid insteadof).

retry_after carries the parsed Retry-After response header when present — see retry_after.

Fields

status: u16

url: String

retry_after: Option<Duration>

Http(Error)

HTTP transport failure (connection reset, TLS error, …). Retryable.

Io(Error)

Local I/O while reading the object file (uploads) or the staging tempfile (downloads).

Store(StoreError)

The local store rejected the bytes — most importantly, hash mismatch after a download. Not retryable per attempt: the bytes the server gave us did not hash to what they promised.

InvalidOid(OidParseError)

The OID returned by the server is not valid hex.

UnsupportedHashAlgo(String)

The batch response advertised a hash_algo we don’t implement. Per the spec the only required value is sha256; anything else would mean we’d need to recompute every OID under a different digest before we could trust the server’s actions.

BatchResponse(Box<ApiError>)

The batch endpoint itself failed (network, auth, or decode). Wraps the underlying ApiError with upstream’s batch response: prefix so a Display of this error matches what users see in GIT_TRACE logs and shell-test grep patterns.

Implementations

impl TransferError

pub fn is_retryable(&self) -> bool

Worth another attempt? Network blips and 5xx are retryable; spec violations and hash mismatches are not.

pub fn retry_after(&self) -> Option<Duration>

Server-supplied retry delay, if any. Pulled from the Retry-After response header at error-construction time. The retry loop uses this in place of exponential backoff when Some. Mirrors upstream’s errors.IsRetriableLaterError gate. Batch-level Retry-After (slice 3) isn’t surfaced through BatchResponse yet.

Trait Implementations

impl Debug for TransferError

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

Formats the value using the given formatter.

impl Display for TransferError

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

Formats the value using the given formatter.

impl Error for TransferError

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<ApiError> for TransferError

fn from(value: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for TransferError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for TransferError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<OidParseError> for TransferError

fn from(source: OidParseError) -> Self

Converts to this type from the input type.

impl From<StoreError> for TransferError

fn from(source: StoreError) -> Self

Converts to this type from the input type.