Skip to main content

mockserver_client/
error.rs

1use std::fmt;
2
3/// Result type alias using [`Error`].
4pub type Result<T> = std::result::Result<T, Error>;
5
6/// Errors returned by the MockServer client.
7#[derive(Debug)]
8pub enum Error {
9    /// The server returned a verification failure (HTTP 406).
10    VerificationFailure(String),
11    /// The server returned an invalid request error (HTTP 400).
12    InvalidRequest(String),
13    /// The requested feature is disabled on the server (e.g. HTTP 403 from an
14    /// SRE control-plane endpoint such as load generation or SLO tracking).
15    ///
16    /// Enable it via the corresponding server property (e.g.
17    /// `loadGenerationEnabled=true`, `sloTrackingEnabled=true`).
18    FeatureDisabled(String),
19    /// A named resource was not found (HTTP 404), e.g. starting or fetching a
20    /// load scenario whose `name` is not registered.
21    NotFound(String),
22    /// An unexpected HTTP status was returned.
23    UnexpectedStatus { status: u16, body: String },
24    /// A network or transport error from reqwest.
25    Transport(reqwest::Error),
26    /// Failed to serialize or deserialize JSON.
27    Json(serde_json::Error),
28}
29
30impl fmt::Display for Error {
31    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
32        match self {
33            Error::VerificationFailure(msg) => write!(f, "verification failed: {msg}"),
34            Error::InvalidRequest(msg) => write!(f, "invalid request (400): {msg}"),
35            Error::FeatureDisabled(msg) => {
36                write!(f, "feature disabled on server (403): {msg}")
37            }
38            Error::NotFound(msg) => write!(f, "not found (404): {msg}"),
39            Error::UnexpectedStatus { status, body } => {
40                write!(f, "unexpected HTTP {status}: {body}")
41            }
42            Error::Transport(e) => write!(f, "transport error: {e}"),
43            Error::Json(e) => write!(f, "JSON error: {e}"),
44        }
45    }
46}
47
48impl std::error::Error for Error {
49    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
50        match self {
51            Error::Transport(e) => Some(e),
52            Error::Json(e) => Some(e),
53            _ => None,
54        }
55    }
56}
57
58impl From<reqwest::Error> for Error {
59    fn from(e: reqwest::Error) -> Self {
60        Error::Transport(e)
61    }
62}
63
64impl From<serde_json::Error> for Error {
65    fn from(e: serde_json::Error) -> Self {
66        Error::Json(e)
67    }
68}