Skip to main content

scyph_extractors/
error.rs

1//! Granular error types for request body, query, and path extraction and validation.
2
3use scyph_core::AppError;
4
5/// Granular errors encountered during request payload extraction and validation.
6///
7/// Converts automatically into [`AppError`] RFC 7807 problem details responses:
8/// - [`ExtractorError::JsonParse`], [`ExtractorError::QueryParse`], [`ExtractorError::PathParse`] map to HTTP 400 Bad Request.
9/// - [`ExtractorError::Validation`] maps to HTTP 422 Unprocessable Entity.
10#[derive(Debug, thiserror::Error)]
11pub enum ExtractorError {
12    /// JSON request body deserialization failure.
13    #[error("Invalid JSON body payload: {0}")]
14    JsonParse(String),
15
16    /// Query parameter parsing failure.
17    #[error("Invalid query parameters: {0}")]
18    QueryParse(String),
19
20    /// Path parameter parsing failure.
21    #[error("Invalid path parameter: {0}")]
22    PathParse(String),
23
24    /// `garde` validation rule violation.
25    #[error("Validation failed: {0}")]
26    Validation(String),
27}
28
29impl From<ExtractorError> for AppError {
30    fn from(err: ExtractorError) -> Self {
31        match err {
32            ExtractorError::JsonParse(msg) => AppError::BadRequest(msg),
33            ExtractorError::QueryParse(msg) => AppError::BadRequest(msg),
34            ExtractorError::PathParse(msg) => AppError::BadRequest(msg),
35            ExtractorError::Validation(msg) => AppError::UnprocessableEntity(msg),
36        }
37    }
38}