Enum EmbedError 

#[non_exhaustive]
pub enum EmbedError {
    Network(String),
    Auth(String),
    RateLimited(String),
    BadRequest {
        status: u16,
        body: String,
    },
    Server {
        status: u16,
        body: String,
    },
    Decode(String),
    DimMismatch {
        expected: u32,
        got: u32,
    },
    Config(String),
    MissingApiKey {
        var: String,
    },
}

Every fallible operation on an crate::Embedder returns this.

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.

Network(String)

Network / transport failure: TCP refused, DNS, TLS handshake, read timeout.

Auth(String)

Provider rejected our credentials (HTTP 401 / 403).

RateLimited(String)

Provider rate-limited (HTTP 429). Fail-fast; a retry-with-backoff layer belongs in the caller, not in the adapter.

BadRequest

Client-side 4xx other than 401/403/429 (bad model name, invalid JSON, input too long, …).

Fields

status: u16

HTTP status code.

body: String

Response body (usually a JSON-encoded error message).

Server

Provider-side 5xx. Treated as transient; caller decides retry.

Fields

status: u16

HTTP status code.

body: String

Response body.

Decode(String)

Response parsed as JSON but did not match the expected shape.

DimMismatch

Provider returned a vector whose length disagrees with the configured dimension.

Fields

expected: u32

Dimension the adapter expected (from config or prior calls).

got: u32

Dimension the provider actually returned.

Config(String)

Config is malformed (e.g. unknown model string, invalid URL).

MissingApiKey

The env var named by api_key_env is not set in the process environment. Surfaced verbatim so the CLI can suggest export.

Fields

var: String

Name of the missing env var, exactly as configured.

Trait Implementations

impl Debug for EmbedError

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

Formats the value using the given formatter.

impl Display for EmbedError

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

Formats the value using the given formatter.

impl Error for EmbedError

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.