Enum LseErrorKind 

#[non_exhaustive]
pub enum LseErrorKind {
    Authentication,
    RateLimit,
    Network,
    Timeout,
    Api,
    Decode,
    InvalidInput,
    Io,
}

A coarse classification of LseError, for deciding what to do next.

LseError is #[non_exhaustive] and has a variant per measured provider behaviour, which is the right shape for diagnosing one failure and the wrong shape for reacting to one: a consumer writing retry logic wants five or six categories, not thirty, and should not have to revisit its match every time an endpoint gains a variant. This is that projection, and it is what DataError::Lse carries so the classification survives being flattened into a String.

Mirrors DatabentoErrorKind — not linked, since that lives behind the databento feature and this type does not — plus the categories this integration’s file and export surface adds.

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.

Authentication

API key missing, malformed, or rejected. Retrying changes nothing until it is fixed.

RateLimit

Throttled, or a metered allowance is spent. Resumable once it replenishes — see LseError::RateLimited’s retry_after and LseError::QuotaExceeded’s status.

Network

Transport-level failure. Resumable; a retry may well succeed.

Timeout

An export job did not reach a terminal state within the caller’s timeout. Resumable: the job keeps building and its identifier stays valid, so polling again spends no allowance.

Api

The provider rejected the request or the job failed. Not resumable by retrying alone.

Decode

The bytes could not be read as what they claim to be — a malformed body, an unsupported or mistyped Parquet schema, a value with no representation, an ordering violation, an integrity mismatch. Terminal: the data is what it is.

InvalidInput

The caller’s request or instrument registry is wrong. Terminal until the caller changes it.

Io

A local filesystem failure.

Implementations

impl LseErrorKind

pub fn is_resumable(&self) -> bool

Whether retrying the same operation could succeed without the caller changing anything.

RateLimit and Timeout require waiting first; this says the attempt is worth making again, not that it is worth making immediately.

Trait Implementations

impl Clone for LseErrorKind

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LseErrorKind

impl Debug for LseErrorKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LseErrorKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for LseErrorKind

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

Formats the value using the given formatter.

impl Eq for LseErrorKind

impl Hash for LseErrorKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for LseErrorKind

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for LseErrorKind

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for LseErrorKind

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for LseErrorKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LseErrorKind