Enum Error 

#[non_exhaustive]
pub enum Error {
    Config(String),
    Transport(Error),
    Http {
        status: u16,
        body: String,
    },
    Api {
        operation: &'static str,
        errors: Vec<GraphQlError>,
    },
    RateLimited {
        retry_after: Option<Duration>,
        info: Option<RateLimitInfo>,
    },
    Decode {
        operation: &'static str,
        source: Error,
    },
    MissingData {
        operation: &'static str,
    },
    MutationFailed {
        operation: &'static str,
    },
}

Everything that can go wrong talking to the Linear API.

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.

Config(String)

Client construction or configuration failure (missing API key, invalid endpoint URL, unset environment variable, …).

Transport(Error)

Network-level failure (connect, TLS, timeout). Mutations are NOT retried on post-send transport errors by default: Linear has no idempotency keys, so a timed-out issueCreate may have landed.

Http

Non-2xx HTTP response without a usable GraphQL error body.

Fields

status: u16

HTTP status code.

body: String

Raw response body (possibly truncated or non-JSON).

Api

The server executed the request and returned GraphQL errors. Fail-closed: raised even when partial data accompanied the errors (LinearClient::execute_raw is the lenient escape hatch).

Fields

operation: &'static str

Operation name of the failing document.

errors: Vec<GraphQlError>

The GraphQL errors as returned on the wire.

RateLimited

Rate limited and the required wait exceeded RetryConfig::max_rate_limit_wait, or retries were exhausted.

Fields

retry_after: Option<Duration>

Server-indicated wait before the budget resets, when known.

info: Option<RateLimitInfo>

Rate-limit budget snapshot from the rejecting response’s headers.

Decode

The response data did not match this crate’s models — the runtime schema-drift tripwire.

Fields

operation: &'static str

Operation name of the failing document.

source: Error

Underlying deserialization error.

MissingData

The server returned neither data nor errors.

Fields

operation: &'static str

Operation name of the failing document.

MutationFailed

A mutation payload reported success: false without GraphQL errors.

Fields

operation: &'static str

Operation name of the failing document.

Implementations

impl Error

pub fn is_rate_limited(&self) -> bool

true for Error::RateLimited, or an Error::Api carrying a RATELIMITED-typed GraphQL error.

pub fn is_authentication(&self) -> bool

true when any attached GraphQL error is an authentication failure.

pub fn error_types(&self) -> Vec<LinearErrorType>

Typed Linear error classifications attached to this error (empty for non-Error::Api variants and for errors without extensions).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.