Enum StaticError 

#[non_exhaustive]
pub enum StaticError {
    NotFound(String),
    Traversal(String),
    Io(Error),
    PipelineSetup(String),
    Build(String),
}

Errors that can occur during static file serving.

This error type is non-exhaustive and may gain new variants in future releases.

Variants

• NotFound: The requested path does not exist.
• Traversal: The requested path attempts to escape the server root.
• Io: An I/O error occurred (file read, permission denied, etc.).
• PipelineSetup: A configured CSS/JS tool’s binary is missing from PATH, discovered at server startup (or crate::Server::build) before any build runs.
• Build: A configured build pipeline (CSS/JS tool or asset folder) failed to produce output.

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.

NotFound(String)

Requested path does not exist.

Traversal(String)

Path traversal attempt detected.

Io(Error)

I/O error from the filesystem.

PipelineSetup(String)

A configured build-pipeline tool could not be found or validated at startup.

Build(String)

A configured build pipeline ran but failed to produce output.

Implementations

impl StaticError

pub fn user_message(&self) -> &'static str

Returns a user-safe error message for use in HTTP responses.

Traversal errors return “not found” to avoid leaking information about the filesystem structure. I/O errors return “internal server error”.

Trait Implementations

impl Debug for StaticError

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

Formats the value using the given formatter.

impl Display for StaticError

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

Formats the value using the given formatter.

impl Error for StaticError

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<Error> for StaticError

fn from(e: Error) -> Self

Converts to this type from the input type.