universal-config 0.5.1

A library to simplify reading configuration files from various file formats.
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

use thiserror::Error;

#[derive(Error, Debug)]
pub enum UniversalConfigError {
    #[error("unable to locate user config or home directories")]
    MissingUserDir,
    #[error("unable to find any valid config file within the config directory")]
    FileNotFound,
    #[error(transparent)]
    Io(#[from] std::io::Error),
    #[error(transparent)]
    Encoding(#[from] std::str::Utf8Error),
    #[error(transparent)]
    Deserialization(#[from] DeserializationError),
    #[error(transparent)]
    Serialization(#[from] SerializationError),
}

#[derive(Error, Debug)]
pub enum DeserializationError {
    #[cfg(feature = "json")]
    #[error(transparent)]
    Json(#[from] serde_json::Error),

    #[cfg(feature = "yaml")]
    #[error(transparent)]
    Yaml(#[from] serde_yaml::Error),

    #[cfg(feature = "toml")]
    #[error(transparent)]
    Toml(#[from] toml::de::Error),

    #[cfg(feature = "corn")]
    #[error(transparent)]
    Corn(#[from] corn::error::Error),

    #[cfg(feature = "xml")]
    #[error(transparent)]
    Xml(#[from] serde_xml_rs::Error),

    #[cfg(feature = "ron")]
    #[error(transparent)]
    Ron(#[from] ron::de::SpannedError),

    #[cfg(feature = "kdl")]
    #[error(transparent)]
    Kdl(#[from] kaydle::serde::de::Error),

    #[error("unsupported file extension: '{0}'")]
    UnsupportedExtension(String),
}

#[derive(Error, Debug)]
pub enum SerializationError {
    #[cfg(feature = "json")]
    #[error(transparent)]
    Json(#[from] serde_json::Error),

    #[cfg(feature = "yaml")]
    #[error(transparent)]
    Yaml(#[from] serde_yaml::Error),

    #[cfg(feature = "toml")]
    #[error(transparent)]
    Toml(#[from] toml::ser::Error),

    #[cfg(feature = "corn")]
    #[error(transparent)]
    Corn(#[from] corn::error::Error),

    #[cfg(feature = "xml")]
    #[error(transparent)]
    Xml(#[from] serde_xml_rs::Error),

    #[cfg(feature = "ron")]
    #[error(transparent)]
    Ron(#[from] ron::Error),

    #[error("unsupported file extension: '{0}'")]
    UnsupportedExtension(String),
}

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