Enum PageError 

pub enum PageError {
    Redirect {
        location: String,
        hx: bool,
    },
    Rendered {
        status: StatusCode,
        code: &'static str,
        message: String,
    },
}

A failed page request.

Variants

Redirect

Sign-in is needed: 303 + Location for a browser, HX-Redirect for htmx.

Fields

location: String

hx: bool

Rendered

Anything else: the real status, plus a standalone HTML document.

Fields

status: StatusCode

code: &'static str

The same stable snake_case code the JSON API uses, so an operator reporting a problem quotes one string whichever front end they were on.

message: String

Implementations

impl PageError

pub fn login_required(hx: bool) -> Self

The redirect an expired or absent session produces.

pub fn not_found(message: impl Into<String>) -> Self

404 — no such row.

pub fn bad_request(message: impl Into<String>) -> Self

400 — the request named something that does not exist, and said so itself (an unparseable filter, not a missing row).

pub fn internal() -> Self

500 — anything the operator can only find in the log.

pub fn status(&self) -> StatusCode

The status this will answer with, which for a redirect is the redirect’s own — useful mostly to tests.

Trait Implementations

impl Debug for PageError

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

Formats the value using the given formatter.

impl Display for PageError

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

Formats the value using the given formatter.

impl Eq for PageError

impl Error for PageError

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<AdminError> for PageError

A 401 from the API layer means “sign in”; everything else keeps its status.

This is the one place the two error vocabularies meet, and it is a conversion rather than a shared type on purpose: AdminError answers a script, PageError answers a browser, and the day one grows a member the other should not have, nothing has to be untangled.

fn from(error: AdminError) -> Self

Converts to this type from the input type.

impl From<Error> for PageError

Routed through AdminError so the admin_db_error log line — which carries the table and column names the body must not — still happens exactly once.

fn from(error: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for PageError

fn into_response(self) -> Response

Create a response.

impl PartialEq for PageError

fn eq(&self, other: &PageError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PageError