libmars 0.6.2

Library to build window managers and accompanying utilities
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use core::result::Result as CoreResult;
use std::fmt::{Display, Formatter, Result as FmtResult};

use crate::platforms::x11::misc::atoms::X11Atom;

pub type Result<T> = CoreResult<T, MarsError>;

#[derive(Debug,Clone)]
pub struct MarsError {
    kind: MarsErrorKind,
    info: Option<String>,
}

#[derive(Debug,Copy,Clone)]
pub enum MarsErrorKind {
    ConnectionFailed,
    FailedRequest,
    IllegalValue,
    InvalidInput,
    PropertyUnavailable,
    Unknown,
    UnsupportedProtocol,
}


impl MarsError {
    pub fn failed_request(call: &str) -> MarsError {
        MarsError {
            kind: MarsErrorKind::FailedRequest,
            info: Some(format!("{} failed", call)),
        }
    }

    pub fn failed_conversion(value: impl std::fmt::Debug, from: &str, to: &str) -> MarsError {
        MarsError {
            kind: MarsErrorKind::IllegalValue,
            info: Some(format!("unable to convert {:?} from {} to {}", value, from, to)),
        }
    }

    pub fn invalid_input(msg: impl ToString) -> MarsError {
        MarsError {
            kind: MarsErrorKind::InvalidInput,
            info: Some(msg.to_string()),
        }
    }

    pub fn invalid_response(request: impl Display) -> MarsError {
        MarsError {
            kind: MarsErrorKind::IllegalValue,
            info: Some(format!("invalid response value to request '{}'", request)),
        }
    }

    pub fn property_unavailable(property: impl ToString) -> MarsError {
        MarsError {
            kind: MarsErrorKind::PropertyUnavailable,
            info: Some(property.to_string()),
        }
    }

    pub fn unknown(info: impl ToString) -> MarsError {
        MarsError {
            kind: MarsErrorKind::Unknown,
            info: Some(info.to_string()),
        }
    }

    pub fn x11_unsupported_atom(atom: X11Atom) -> MarsError {
        MarsError {
            kind: MarsErrorKind::UnsupportedProtocol,
            info: Some(atom.to_string()),
        }
    }

    pub fn x11_open_display() -> MarsError {
        MarsError {
            kind: MarsErrorKind::ConnectionFailed,
            info: Some("XOpenDisplay".to_owned()),
        }
    }
}


impl Display for MarsError {
    fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {
        self.kind.fmt(f)?;
        if let Some(info) = &self.info {
            write!(f, " ({})", info)?;
        }
        Ok(())
    }
}

impl From<MarsError> for String {
    fn from(value: MarsError) -> Self {
        value.to_string()
    }
}

impl Display for MarsErrorKind {
    fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {
        let name = match self {
            Self::ConnectionFailed => "Connection failed",
            Self::FailedRequest => "Failed request",
            Self::IllegalValue => "Illegal value",
            Self::InvalidInput => "Invalid input",
            Self::PropertyUnavailable => "Property not available",
            Self::Unknown => "Unknown error",
            Self::UnsupportedProtocol => "Protocol not supported",
        };
        write!(f, "{}", name)
    }
}