masterror 0.27.3

Application error types and response mapping
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

// SPDX-FileCopyrightText: 2025 RAprogramm <andrey.rozanov.vl@gmail.com>
//
// SPDX-License-Identifier: MIT

//! Convert [`config::ConfigError`] into [`Error`],
//! producing [`AppErrorKind::Config`].
//!
//! Enabled with the `config` feature.
//!
//! ## Example
//!
//! ```rust,ignore
//! use config::ConfigError;
//! use masterror::{AppErrorKind, Error};
//!
//! let err = ConfigError::Message("missing key".into());
//! let app_err: Error = err.into();
//! assert!(matches!(app_err.kind, AppErrorKind::Config));
//! ```
#[cfg(feature = "config")]
use config::ConfigError;

#[cfg(feature = "config")]
use crate::{AppErrorKind, Context, Error, field};

#[cfg(feature = "config")]
#[cfg_attr(docsrs, doc(cfg(feature = "config")))]
impl From<ConfigError> for Error {
    fn from(err: ConfigError) -> Self {
        build_context(&err).into_error(err)
    }
}

#[cfg(feature = "config")]
fn build_context(error: &ConfigError) -> Context {
    match error {
        ConfigError::Frozen => {
            Context::new(AppErrorKind::Config).with(field::str("config.phase", "frozen"))
        }
        ConfigError::NotFound(key) => Context::new(AppErrorKind::Config)
            .with(field::str("config.phase", "not_found"))
            .with(field::str("config.key", key.clone())),
        ConfigError::PathParse {
            ..
        } => Context::new(AppErrorKind::Config).with(field::str("config.phase", "path_parse")),
        ConfigError::FileParse {
            uri, ..
        } => {
            let mut ctx =
                Context::new(AppErrorKind::Config).with(field::str("config.phase", "file_parse"));
            if let Some(path) = uri {
                ctx = ctx.with(field::str("config.uri", path.clone()));
            }
            ctx
        }
        ConfigError::Type {
            origin,
            unexpected,
            expected,
            key
        } => {
            let mut ctx = Context::new(AppErrorKind::Config)
                .with(field::str("config.phase", "type"))
                .with(field::str("config.expected", *expected))
                .with(field::str("config.unexpected", unexpected.to_string()));
            if let Some(origin) = origin {
                ctx = ctx.with(field::str("config.origin", origin.clone()));
            }
            if let Some(key) = key {
                ctx = ctx.with(field::str("config.key", key.clone()));
            }
            ctx
        }
        ConfigError::At {
            origin,
            key,
            ..
        } => {
            let mut ctx =
                Context::new(AppErrorKind::Config).with(field::str("config.phase", "at"));
            if let Some(origin) = origin {
                ctx = ctx.with(field::str("config.origin", origin.clone()));
            }
            if let Some(key) = key {
                ctx = ctx.with(field::str("config.key", key.clone()));
            }
            ctx
        }
        ConfigError::Message(message) => Context::new(AppErrorKind::Config)
            .with(field::str("config.phase", "message"))
            .with(field::str("config.message", message.clone())),
        ConfigError::Foreign(_) => {
            Context::new(AppErrorKind::Config).with(field::str("config.phase", "foreign"))
        }
        other => Context::new(AppErrorKind::Config)
            .with(field::str("config.phase", "unclassified"))
            .with(field::str("config.debug", other.to_string()))
    }
}

#[cfg(all(test, feature = "config"))]
mod tests {
    use config::ConfigError;

    use super::*;
    use crate::{AppErrorKind, FieldValue};

    #[test]
    fn maps_to_config_kind() {
        let err = ConfigError::Message("dummy".into());
        let app_err = Error::from(err);
        assert!(matches!(app_err.kind, AppErrorKind::Config));
        let metadata = app_err.metadata();
        assert_eq!(
            metadata.get("config.phase"),
            Some(&FieldValue::Str("message".into()))
        );
    }
}