credent_fs_model 0.4.1

Reads / Writes credentials from / to disk.
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130

use std::{fmt, path::PathBuf};

use credent_model::{Credentials, Profiles};

/// Errors when reading the user credentials file.
#[derive(Debug)]
pub enum Error<C = Credentials>
where
    C: Clone + Eq,
{
    /// Unable to determine user configuration directory.
    UserConfigDirNotFound,
    /// Failed to create the parent directory of the credentials file.
    CredentialsParentDirCreate {
        /// Path to the user credentials file.
        parent_path: PathBuf,
        /// The underlying IO error.
        error: std::io::Error,
    },
    /// User credentials file does not exist.
    CredentialsFileNonExistent {
        /// Path to the user credentials file.
        credentials_path: PathBuf,
    },
    /// User credentials file is a directory.
    CredentialsFileIsDir {
        /// Path to the user credentials file.
        credentials_path: PathBuf,
    },
    /// Failed to read from the user credentials file.
    CredentialsFileRead {
        /// Path to the user credentials file.
        credentials_path: PathBuf,
        /// The underlying IO error.
        error: std::io::Error,
    },
    /// Failed to write to the user credentials file.
    CredentialsFileWrite {
        /// Path to the user credentials file.
        credentials_path: PathBuf,
        /// The underlying IO error.
        error: std::io::Error,
    },
    /// Failed to deserialize user credentials file contents.
    CredentialsFileDeserialize {
        /// Path to the user credentials file.
        credentials_path: PathBuf,
        /// The underlying TOML error.
        error: toml::de::Error,
    },
    /// Failed to serialize user credentials.
    CredentialsFileSerialize {
        /// Profiles which failed to be serialized.
        profiles: Profiles<C>,
        /// The underlying TOML error.
        error: toml::ser::Error,
    },
}

impl<C> fmt::Display for Error<C>
where
    C: Clone + Eq + fmt::Debug,
{
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Self::UserConfigDirNotFound => {
                write!(f, "Unable to determine user configuration directory.")
            }
            Self::CredentialsParentDirCreate { parent_path, .. } => write!(
                f,
                "Failed to create credentials file parent directory. Path: `{}`",
                parent_path.display()
            ),
            Self::CredentialsFileNonExistent { credentials_path } => write!(
                f,
                "User credentials does not exist or cannot be accessed. Path: `{}`",
                credentials_path.display()
            ),
            Self::CredentialsFileIsDir { credentials_path } => write!(
                f,
                "User credentials file should be a file, but it is a directory. Path: `{}`",
                credentials_path.display()
            ),
            Self::CredentialsFileRead {
                credentials_path, ..
            } => write!(
                f,
                "User credentials file failed to be read. Path: `{}`",
                credentials_path.display()
            ),
            Self::CredentialsFileWrite {
                credentials_path, ..
            } => write!(
                f,
                "User credentials file failed to be read. Path: `{}`",
                credentials_path.display()
            ),
            Self::CredentialsFileDeserialize {
                credentials_path, ..
            } => write!(
                f,
                "User credentials file failed to be deserialized. Path: `{}`",
                credentials_path.display()
            ),
            Self::CredentialsFileSerialize { profiles, .. } => write!(
                f,
                "User credentials failed to be serialized. Profiles: `{:?}`",
                profiles
            ),
        }
    }
}

impl<C> std::error::Error for Error<C>
where
    C: Clone + Eq + fmt::Debug,
{
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        match self {
            Self::UserConfigDirNotFound => None,
            Self::CredentialsParentDirCreate { error, .. } => Some(error),
            Self::CredentialsFileNonExistent { .. } => None,
            Self::CredentialsFileIsDir { .. } => None,
            Self::CredentialsFileRead { error, .. } => Some(error),
            Self::CredentialsFileWrite { error, .. } => Some(error),
            Self::CredentialsFileDeserialize { error, .. } => Some(error),
            Self::CredentialsFileSerialize { error, .. } => Some(error),
        }
    }
}