Enum RemoteBuildError 

pub enum RemoteBuildError {
    IncompatibleProtocolVersion {
        supported: ProtocolVersion,
        received: ProtocolVersion,
    },
    TruncatedEvent,
    MalformedEvent {
        message: String,
    },
    InvalidUtf8,
    EventTooLarge {
        bytes: usize,
        maximum: usize,
    },
    InvalidIdentifier {
        field: &'static str,
        reason: &'static str,
    },
    UnsafeEventText {
        field: &'static str,
    },
    InvalidEventPayload {
        event: &'static str,
        reason: &'static str,
    },
    InvalidSourceManifest {
        message: String,
    },
    InvalidJobTransition {
        from: JobState,
        to: JobState,
    },
    Cancelled,
    UnsupportedCapability {
        provider: String,
        feature: ProviderFeature,
    },
    ProviderFailure {
        provider: String,
        code: String,
        message: String,
        retryable: bool,
    },
    ArtifactNotFound {
        job_id: String,
        artifact_id: String,
    },
    IntegrityMismatch {
        artifact_id: String,
        expected: String,
        actual: String,
    },
    Serialization {
        message: String,
    },
}

Typed failures crossing the remote-build boundary.

Variants

IncompatibleProtocolVersion

The peer uses an incompatible protocol major version.

Fields

supported: ProtocolVersion

Highest protocol version understood by this implementation.

received: ProtocolVersion

Version sent by the peer.

TruncatedEvent

A stream ended before one complete JSON event was available.

MalformedEvent

A remote event was not valid JSON or did not match the protocol envelope.

Fields

message: String

Bounded parser description; never raw worker output.

InvalidUtf8

Event bytes were not UTF-8.

EventTooLarge

One event exceeded the protocol decoder limit.

Fields

bytes: usize

Received byte count.

maximum: usize

Decoder limit.

InvalidIdentifier

A stable identifier was empty, too long, or contained control characters.

Fields

field: &'static str

Protocol field name.

reason: &'static str

Stable validation reason.

UnsafeEventText

Event text contained terminal control sequences.

Fields

field: &'static str

Protocol field containing unsafe text.

InvalidEventPayload

A typed event carried inconsistent or impossible values.

Fields

event: &'static str

Stable event name.

reason: &'static str

Stable validation reason.

InvalidSourceManifest

The required source manifest was malformed or non-canonical.

Fields

message: String

Sanitized source-validation summary.

InvalidJobTransition

A provider reported an impossible job-state change.

Fields

from: JobState

State before the transition.

to: JobState

Requested state.

Cancelled

The caller requested cancellation.

UnsupportedCapability

The selected provider cannot satisfy a required feature.

Fields

provider: String

Stable provider identifier.

feature: ProviderFeature

Missing typed feature.

ProviderFailure

A provider failed with a stable provider-specific code.

Fields

provider: String

Stable provider identifier.

code: String

Stable provider-specific error code.

message: String

Sanitized failure summary.

retryable: bool

Whether retrying the same operation may succeed.

ArtifactNotFound

A requested artifact is absent from the job manifest.

Fields

job_id: String

Stable job identifier.

artifact_id: String

Stable artifact identifier.

IntegrityMismatch

Downloaded bytes do not match the signed manifest digest.

Fields

artifact_id: String

Stable artifact identifier.

expected: String

Manifest SHA-256 digest.

actual: String

Downloaded SHA-256 digest.

Serialization

A local protocol object could not be serialized.

Fields

message: String

Bounded serializer description.

Implementations

impl RemoteBuildError

pub const fn code(&self) -> &'static str

Stable machine-readable error code.

pub const fn retryable(&self) -> bool

Whether retrying the same operation may succeed without user changes.

Trait Implementations

impl Clone for RemoteBuildError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RemoteBuildError

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

Formats the value using the given formatter.

impl Display for RemoteBuildError

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

Formats the value using the given formatter.

impl Eq for RemoteBuildError

impl Error for RemoteBuildError

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 PartialEq for RemoteBuildError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RemoteBuildError