Enum Error 

pub enum Error {
    BadRequest(String),
    JobNotFound,
    NotFound(String),
    JobNotFinished,
    RenderFailed(String),
    Multipart(MultipartError),
    USBNotecardParse(LocationParseError),
    USBNotecardLoad(USBNotecardLoadError),
    RegionCache(Box<CacheError>),
    USBNotecardToGridRectangle(Box<USBNotecardToGridRectangleError>),
    Map(Box<MapError>),
    MapTileCache(Box<MapTileCacheError>),
    Image(Box<ImageError>),
    Io(Error),
    Json(Error),
    Unauthenticated,
    Forbidden(String),
    InvalidCredentials,
    InvalidOrExpiredToken,
    Database,
    PasswordHash(String),
    TooManyRequests {
        retry_after_secs: u64,
    },
    GlwEventCache(GlwEventCacheError),
    FontParse(InvalidFont),
}

Top-level error for the web service. Wraps the various library and IO errors so that handlers can use ? and the central IntoResponse impl turns them into HTTP responses.

The bigger inner errors (MapError, MapTileCacheError, USBNotecardToGridRectangleError) are boxed so the discriminant stays small and Result<T, Error> doesn’t blow up in size.

Variants

BadRequest(String)

the request body could not be parsed.

JobNotFound

the requested job id is unknown or has been evicted.

NotFound(String)

the request asked for a part of a job that does not exist (e.g. image-without-route when no without-route image was saved).

JobNotFinished

the job is still running; the requested artifact is not ready yet.

RenderFailed(String)

the underlying render job failed with the given message.

Multipart(MultipartError)

multipart upload parsing failed.

USBNotecardParse(LocationParseError)

a USB notecard line could not be parsed.

USBNotecardLoad(USBNotecardLoadError)

loading a USB notecard from disk failed (only used by the loader helper).

RegionCache(Box<CacheError>)

the region name to grid coordinates cache failed.

USBNotecardToGridRectangle(Box<USBNotecardToGridRectangleError>)

converting a USB notecard to a grid rectangle failed.

Map(Box<MapError>)

the map renderer returned an error.

MapTileCache(Box<MapTileCacheError>)

the map tile cache returned an error.

Image(Box<ImageError>)

image encoding failed.

Io(Error)

generic I/O error.

Json(Error)

JSON serialization failed.

Unauthenticated

the request lacks a valid session cookie or bearer token.

Forbidden(String)

the authenticated user is not permitted to perform this action.

InvalidCredentials

the credentials presented at login do not match a known user.

InvalidOrExpiredToken

the set-password / reset token is missing, malformed, used, or expired.

Database

a database operation failed. Detail is logged via tracing to avoid leaking internals over HTTP.

PasswordHash(String)

argon2 hashing or verification failed.

TooManyRequests

the caller exhausted their per-user token bucket for a rate-limited create endpoint. The wrapped value is the number of seconds the client should wait before retrying; it is also emitted as a Retry-After HTTP header.

Fields

retry_after_secs: u64

recommended wait in whole seconds.

GlwEventCache(GlwEventCacheError)

error in the GLW event cache (HTTP fetch / on-disk redb / JSON).

FontParse(InvalidFont)

error parsing a TrueType font file.

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.

impl From<CacheError> for Error

fn from(value: RegionCacheError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FontError> for Error

fn from(value: FontError) -> Self

Converts to this type from the input type.

impl From<GlwEventCacheError> for Error

fn from(source: GlwEventCacheError) -> Self

Converts to this type from the input type.

impl From<ImageError> for Error

fn from(value: ImageError) -> Self

Converts to this type from the input type.

impl From<InvalidFont> for Error

fn from(source: InvalidFont) -> Self

Converts to this type from the input type.

impl From<LocationParseError> for Error

fn from(source: LocationParseError) -> Self

Converts to this type from the input type.

impl From<MapError> for Error

fn from(value: MapError) -> Self

Converts to this type from the input type.

impl From<MapTileCacheError> for Error

fn from(value: MapTileCacheError) -> Self

Converts to this type from the input type.

impl From<MultipartError> for Error

fn from(source: MultipartError) -> Self

Converts to this type from the input type.

impl From<USBNotecardLoadError> for Error

fn from(source: USBNotecardLoadError) -> Self

Converts to this type from the input type.

impl From<USBNotecardToGridRectangleError> for Error

fn from(value: USBNotecardToGridRectangleError) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

fn into_response(self) -> Response

Create a response.