fsqlite 0.1.5

Public API facade
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! Optional extension trait, analogous to `rusqlite::OptionalExtension`.

use fsqlite_error::FrankenError;

/// Convert a `QueryReturnedNoRows` error into `Ok(None)`, analogous to
/// `rusqlite::OptionalExtension`.
///
/// # Examples
///
/// ```ignore
/// use fsqlite::compat::OptionalExtension;
///
/// let maybe_row = conn.query_row("SELECT 1 WHERE 0").optional()?;
/// assert!(maybe_row.is_none());
/// ```
pub trait OptionalExtension<T> {
    /// If the result is `Err(QueryReturnedNoRows)`, convert to `Ok(None)`.
    /// All other errors pass through unchanged.
    fn optional(self) -> Result<Option<T>, FrankenError>;
}

impl<T> OptionalExtension<T> for Result<T, FrankenError> {
    fn optional(self) -> Result<Option<T>, FrankenError> {
        match self {
            Ok(val) => Ok(Some(val)),
            Err(FrankenError::QueryReturnedNoRows) => Ok(None),
            Err(e) => Err(e),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn ok_becomes_some() {
        let result: Result<i32, FrankenError> = Ok(42);
        assert_eq!(result.optional().unwrap(), Some(42));
    }

    #[test]
    fn no_rows_becomes_none() {
        let result: Result<i32, FrankenError> = Err(FrankenError::QueryReturnedNoRows);
        assert_eq!(result.optional().unwrap(), None);
    }

    #[test]
    fn other_error_passes_through() {
        let result: Result<i32, FrankenError> = Err(FrankenError::DatabaseFull);
        let err = result.optional().unwrap_err();
        assert!(matches!(err, FrankenError::DatabaseFull));
    }
}