Enum BackendError 

#[non_exhaustive]
pub enum BackendError {
    Unauthorized,
    Rejected {
        code: String,
        message: String,
    },
    NotFound(String),
    Transport(String),
    LogStream(String),
    Local(String),
    SourceTooLarge {
        observed_bytes: u64,
        cap_bytes: u64,
        largest_paths: Vec<(String, u64)>,
    },
    Other(Box<dyn Error + Send + Sync>),
}

A backend failure returned across the ExecutionBackend boundary.

Distinguishes infrastructure failures (return Err) from a failed build (Ok(BuildOutcome { status: Failed, .. })). #[non_exhaustive] so new backends can add variants without breaking callers.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Unauthorized

Rejected

Fields

code: String

message: String

NotFound(String)

Transport(String)

LogStream(String)

Local(String)

SourceTooLarge

The worktree archive exceeds the upload cap. Carries the observed (compressed) size, the cap, and a human hint naming the largest top-level paths so the user can .gitignore the offenders. Fails fast BEFORE the upload (see the cloud backend’s start).

Fields

observed_bytes: u64

cap_bytes: u64

largest_paths: Vec<(String, u64)>

Other(Box<dyn Error + Send + Sync>)

Trait Implementations

impl Debug for BackendError

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

Formats the value using the given formatter.

impl Display for BackendError

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

Formats the value using the given formatter.

impl Error for BackendError

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<Box<dyn Error + Send + Sync>> for BackendError

fn from(source: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.