Enum GotifyError 

#[non_exhaustive]
pub enum GotifyError {
    MissingUrl,
    MissingClientToken,
    MissingAppToken,
    ClientBuild(Error),
    Unauthorized(String),
    NotFound {
        method: String,
        url: String,
    },
    RateLimited {
        method: String,
        url: String,
        retry_after: Option<Duration>,
    },
    UnexpectedStatus {
        status: u16,
        url: String,
        body: Box<Value>,
    },
    Decode {
        url: String,
        source: Error,
    },
    Timeout {
        method: String,
        url: String,
        source: Error,
    },
    Connect {
        method: String,
        url: String,
        source: Error,
    },
    Request {
        method: String,
        url: String,
        source: Error,
    },
}

Everything that can go wrong talking to a Gotify server.

Marked #[non_exhaustive]: this crate is meant to be published and consumed externally, so a caller that matches on this must include a wildcard arm — adding a new variant must never be a semver break for downstream code.

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.

MissingUrl

crate::GotifyConfig::url was empty at crate::GotifyClient::new.

MissingClientToken

The requested operation needs a client token (crate::GotifyConfig::client_token), but none is configured. Client tokens authenticate management operations (messages, applications, clients, current user) — create one under Clients in the Gotify web UI.

MissingAppToken

crate::GotifyClient::send_message needs an app token (crate::GotifyConfig::app_token), but none is configured. App tokens are distinct from client tokens — create one under Applications in the Gotify web UI.

ClientBuild(Error)

The underlying reqwest::Client failed to construct.

Unauthorized(String)

HTTP 401 — the configured token was rejected.

NotFound

HTTP 404.

Fields

method: String

HTTP method of the request.

url: String

Full request URL.

RateLimited

HTTP 429.

Fields

method: String

HTTP method of the rate-limited request.

url: String

Full request URL.

retry_after: Option<Duration>

Parsed Retry-After response header, when present and expressed in seconds (the HTTP-date form is not parsed).

UnexpectedStatus

Any other non-success status. body is JSON when the response was JSON, otherwise the raw text; boxed to keep this enum small.

Fields

status: u16

HTTP status code.

url: String

Full request URL.

body: Box<Value>

Best-effort response body.

Decode

The response body wasn’t valid JSON on an otherwise-successful status.

Fields

url: String

Full request URL.

source: Error

The underlying deserialization failure.

Timeout

Request timed out.

Fields

method: String

HTTP method of the request.

url: String

Full request URL.

source: Error

The underlying transport error.

Connect

Failed to connect to the configured URL.

Fields

method: String

HTTP method of the request.

url: String

Full request URL.

source: Error

The underlying transport error.

Request

Any other transport-level failure.

Fields

method: String

HTTP method of the request.

url: String

Full request URL.

source: Error

The underlying transport error.

Trait Implementations

impl Debug for GotifyError

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

Formats the value using the given formatter.

impl Display for GotifyError

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

Formats the value using the given formatter.

impl Error for GotifyError

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.