microxdg 0.2.0

An XDG Base Directory Specification library.
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

use std::ffi::OsString;
use std::path::PathBuf;
use std::{error, fmt};

/// [_XDG Base Directory Specification_](<https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html>)
/// errors.
#[derive(Debug, PartialEq, Eq)]
pub enum XdgError {
    /// Unable to retrieve user's home directory.
    HomeNotFound,
    /// XDG environment variable contains a relative path.
    RelativePath {
        /// XDG environment variable key (variable name).
        env_var_key: &'static str,
        /// XDG environment variable's relative path.
        path: PathBuf,
    },
    /// XDG Environment variable set to invalid unicode.
    InvalidUnicode {
        /// XDG environment variable key (variable name).
        env_var_key: &'static str,
        /// XDG environment variable value.
        env_var_val: OsString,
    },
}

impl fmt::Display for XdgError {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            XdgError::HomeNotFound => formatter.write_str(
                "Unable to retrieve user's home directory, neither HOME nor USER environment \
                 variable set",
            ),
            XdgError::RelativePath { env_var_key, path } => formatter.write_fmt(format_args!(
                "The `{env_var_key}` environment variable contains a relative path, while paths \
                 in XDG environment variables must be asbolute: `{path}`",
                path = path.display()
            )),
            XdgError::InvalidUnicode { env_var_key, env_var_val } => {
                formatter.write_fmt(format_args!(
                    "The `{env_var_key}` environment variable contains invalid unicode: \
                     {env_var_val:?}",
                ))
            },
        }
    }
}

impl error::Error for XdgError {}

#[cfg(test)]
mod test {
    use std::error::Error;
    use std::ffi::OsStr;
    use std::os::unix::prelude::OsStrExt;

    use super::*;

    const INVALID_UNICODE_BYTES: [u8; 4] = [0xF0, 0x90, 0x80, 0x67];

    #[test]
    fn display_error() -> Result<(), Box<dyn Error>> {
        assert_eq!(
            "Unable to retrieve user's home directory, neither HOME nor USER environment variable \
             set",
            XdgError::HomeNotFound.to_string()
        );
        assert_eq!(
            "The `XDG_CONFIG_HOME` environment variable contains a relative path, while paths in \
             XDG environment variables must be asbolute: `./config`",
            XdgError::RelativePath {
                env_var_key: "XDG_CONFIG_HOME",
                path: PathBuf::from("./config"),
            }
            .to_string(),
        );
        assert_eq!(
            "The `XDG_CONFIG_HOME` environment variable contains invalid unicode: \
             \"\\xF0\\x90\\x80g\"",
            XdgError::InvalidUnicode {
                env_var_key: "XDG_CONFIG_HOME",
                env_var_val: OsStr::from_bytes(&INVALID_UNICODE_BYTES).to_os_string(),
            }
            .to_string(),
        );

        Ok(())
    }
}