Enum WebServerError 

pub enum WebServerError {
    Env(EnvError),
    Bind {
        addr: SocketAddr,
        source: Error,
    },
    SentryDsn(SentryDsnParseError),
    Serve(Error),
    Template(TemplateError),
    TemplatesNotConfigured,
    CacheBuster(CacheBusterError),
    Sitemap(SitemapError),
    Feed(FeedError),
    FeedWithoutFrontend,
    Observability(ObservabilityError),
    PagesRequireTemplates,
    DynamicPagePathHasParameters {
        path: String,
    },
}

Every way the web server can fail.

Composed from the per-kit errors rather than replacing them: a crate on only telegram sees TelegramError and never this type. Deliberately not #[non_exhaustive].

Variants

Env(EnvError)

A required environment variable was missing or malformed.

Bind

The listener could not bind.

Fields

addr: SocketAddr

source: Error

SentryDsn(SentryDsnParseError)

The browser Sentry DSN could not be parsed.

Serve(Error)

The server stopped with an error rather than a shutdown.

Template(TemplateError)

A template could not be loaded or rendered.

TemplatesNotConfigured

A render was attempted without .templates(..) having been called.

CacheBuster(CacheBusterError)

The asset cache could not be built.

Sitemap(SitemapError)

The sitemap could not be written.

Feed(FeedError)

A feed could not be built.

FeedWithoutFrontend

.feed(..) was called on a server that is not a frontend.

A boot failure rather than a shrug: the feed would simply not be served, the autodiscovery links would not be emitted, and nothing at runtime would ever say so.

Observability(ObservabilityError)

Observability could not be configured.

PagesRequireTemplates

Pages were declared without the template data needed to render or list them.

DynamicPagePathHasParameters

A parameterised path was declared as a single page. /blog/{slug} matches many URLs, so it cannot be one sitemap entry.

Fields

path: String

Trait Implementations

impl Debug for WebServerError

Renders the whole error chain, not the enum’s shape.

main returning a Result prints its error with Debug, so a derived one would surface CacheBuster(AmbiguousFavicon) — the variant name — and throw away the sentence that says what to do about it. Every message in this crate is written for a human who has just had a boot fail; this is what makes them visible.

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

Formats the value using the given formatter.

impl Display for WebServerError

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

Formats the value using the given formatter.

impl Error for WebServerError

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<CacheBusterError> for WebServerError

fn from(source: CacheBusterError) -> Self

Converts to this type from the input type.

impl From<EnvError> for WebServerError

fn from(source: EnvError) -> Self

Converts to this type from the input type.

impl From<FeedError> for WebServerError

fn from(source: FeedError) -> Self

Converts to this type from the input type.

impl From<ObservabilityError> for WebServerError

fn from(source: ObservabilityError) -> Self

Converts to this type from the input type.

impl From<SentryDsnParseError> for WebServerError

fn from(source: SentryDsnParseError) -> Self

Converts to this type from the input type.

impl From<SitemapError> for WebServerError

fn from(source: SitemapError) -> Self

Converts to this type from the input type.

impl From<TemplateError> for WebServerError

fn from(source: TemplateError) -> Self

Converts to this type from the input type.

impl IntoResponse for WebServerError

fn into_response(self) -> Response

The body says nothing beyond “internal error”; the detail goes to the log.