Enum Error 

pub enum Error {
    Authentication,
    MissingEnvVar(&'static str),
    MissingCredentials(&'static str),
    HttpClient(Error),
    Request(Error),
    ApiError {
        status: u16,
        body: String,
    },
    Parse {
        source: Error,
        body: String,
    },
}

Errors that can occur when using the Librus API client.

Example

use librus_rs::{Client, Error};

match Client::from_env().await {
    Ok(_) => println!("Success"),
    Err(Error::MissingEnvVar(var)) => eprintln!("Missing {}", var),
    Err(Error::Authentication) => eprintln!("Bad credentials"),
    Err(e) => eprintln!("Error: {}", e),
}

Variants

Authentication

Authentication with Librus failed due to invalid credentials or server error.

MissingEnvVar(&'static str)

Required environment variable is not set.

Returned by Client::from_env() when LIBRUS_USERNAME or LIBRUS_PASSWORD is missing.

MissingCredentials(&'static str)

Required credential is missing from the builder.

Returned by ClientBuilder::build() when username or password was not provided.

HttpClient(Error)

HTTP client construction failed.

Request(Error)

HTTP request failed due to network or connection error.

ApiError

API returned an error response.

Contains the HTTP status code and response body for debugging.

Fields

status: u16

HTTP status code returned by the API.

body: String

Response body content.

Parse

Failed to parse API response as JSON.

This usually indicates an unexpected response format from the API.

Fields

source: Error

The underlying JSON parsing error.

body: String

The raw response body that failed to parse.

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.