memsafe 1.0.2

A Secure cross-platform Rust library for securely wrapping data in memory
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

use std::error::Error;
use std::fmt::Display;

#[derive(Debug)]
pub struct MemoryError(std::io::Error);

impl From<std::io::Error> for MemoryError {
    fn from(err: std::io::Error) -> Self {
        MemoryError(err)
    }
}

impl MemoryError {
    pub fn inner(&self) -> &std::io::Error {
        &self.0
    }
}

impl Display for MemoryError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "Memory error: {}", self.0)
    }
}

impl Error for MemoryError {
    /// Expose the underlying `io::Error` to error-chain walkers (`anyhow`,
    /// `eyre`, `thiserror::Error::source`-aware reporters, etc.) so they
    /// can drill into the root cause without parsing the `Display` text.
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        Some(&self.0)
    }
}

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

    #[test]
    fn display_includes_inner_error_message() {
        let err = MemoryError::from(std::io::Error::other("boom"));
        let rendered = format!("{err}");
        assert!(rendered.starts_with("Memory error:"));
        assert!(rendered.contains("boom"));
    }

    #[test]
    fn inner_exposes_io_error() {
        let err = MemoryError::from(std::io::Error::new(
            std::io::ErrorKind::InvalidInput,
            "bad input",
        ));
        assert_eq!(err.inner().kind(), std::io::ErrorKind::InvalidInput);
    }
}