toasty_core/error/invalid_result.rs
1use super::Error;
2
3/// Error when a query result has an unexpected structure.
4///
5/// This occurs when:
6/// - A query returns a different result type than expected (Count vs Stream)
7/// - A row value has an unexpected type (expected Record, got something else)
8/// - A field has an unexpected type (expected I64, got something else)
9///
10/// This indicates the database returned valid data, but its structure doesn't match
11/// what the query operation expected based on the schema and query type.
12#[derive(Debug)]
13pub(super) struct InvalidResult {
14 message: Box<str>,
15}
16
17impl std::error::Error for InvalidResult {}
18
19impl core::fmt::Display for InvalidResult {
20 fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
21 write!(f, "invalid result: {}", self.message)
22 }
23}
24
25impl Error {
26 /// Creates an invalid result error.
27 ///
28 /// This is used when a query result has an unexpected structure - the database
29 /// returned valid data, but its shape doesn't match what the operation expected.
30 pub fn invalid_result(message: impl Into<String>) -> Error {
31 Error::from(super::ErrorKind::InvalidResult(InvalidResult {
32 message: message.into().into(),
33 }))
34 }
35
36 /// Returns `true` if this error is an invalid result error.
37 pub fn is_invalid_result(&self) -> bool {
38 matches!(self.kind(), super::ErrorKind::InvalidResult(_))
39 }
40}