madori 0.1.0

Madori (間取り) — GPU application framework for pleme-io apps
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

#[derive(thiserror::Error, Debug)]
pub enum MadoriError {
    #[error("GPU initialization failed: {0}")]
    GpuInit(String),

    #[error("window creation failed: {0}")]
    Window(String),

    #[error("render error: {0}")]
    Render(String),

    #[error("garasu error: {0}")]
    Garasu(#[from] garasu::GarasuError),

    #[error("event loop error: {0}")]
    EventLoop(String),
}

pub type Result<T> = std::result::Result<T, MadoriError>;

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

    #[test]
    fn gpu_init_display() {
        let e = MadoriError::GpuInit("no adapter".into());
        assert_eq!(e.to_string(), "GPU initialization failed: no adapter");
    }

    #[test]
    fn window_display() {
        let e = MadoriError::Window("no display".into());
        assert_eq!(e.to_string(), "window creation failed: no display");
    }

    #[test]
    fn render_display() {
        let e = MadoriError::Render("surface lost".into());
        assert_eq!(e.to_string(), "render error: surface lost");
    }

    #[test]
    fn event_loop_display() {
        let e = MadoriError::EventLoop("killed".into());
        assert_eq!(e.to_string(), "event loop error: killed");
    }

    #[test]
    fn garasu_from_conversion_preserves_source() {
        // `#[from] garasu::GarasuError` means `?` converts a garasu error
        // into MadoriError::Garasu without losing the chain. If a future
        // refactor drops #[from] (e.g. Box<dyn Error>), Error::source()
        // would return None here and downstream diagnostics would break.
        let inner = garasu::GarasuError::Gpu("adapter missing".into());
        let outer: MadoriError = inner.into();
        match &outer {
            MadoriError::Garasu(_) => {}
            other => panic!("expected Garasu variant, got {other:?}"),
        }
        assert!(outer.source().is_some());
        assert_eq!(outer.to_string(), "garasu error: GPU error: adapter missing");
    }

    #[test]
    fn result_alias_is_std_result() {
        // Result<T> is `std::result::Result<T, MadoriError>`. If this
        // alias ever shadows to anyhow::Result or similar, `?` chains
        // throughout the crate would change their error semantics.
        fn ok() -> Result<u8> { Ok(7) }
        fn err() -> Result<u8> { Err(MadoriError::Render("x".into())) }
        assert_eq!(ok().unwrap(), 7);
        assert!(err().is_err());
    }

    #[test]
    fn variants_are_distinguishable() {
        // Each variant matches its own arm — guards against an accidental
        // `Box<dyn Error>` collapse that would merge variants.
        let cases: Vec<MadoriError> = vec![
            MadoriError::GpuInit("a".into()),
            MadoriError::Window("b".into()),
            MadoriError::Render("c".into()),
            MadoriError::EventLoop("d".into()),
        ];
        for case in cases {
            match case {
                MadoriError::GpuInit(s) => assert_eq!(s, "a"),
                MadoriError::Window(s) => assert_eq!(s, "b"),
                MadoriError::Render(s) => assert_eq!(s, "c"),
                MadoriError::EventLoop(s) => assert_eq!(s, "d"),
                MadoriError::Garasu(_) => panic!("Garasu matched non-Garasu"),
            }
        }
    }
}