module-util 0.3.1

Utilities for working with module.
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

//! The [`File`] evaluator for working with modules from files.

#[allow(clippy::module_inception)]
mod file;
mod format;

pub use self::file::{File, read};
pub use self::format::{Format, Module};

macro_rules! formats {
    ($(
        $mod:ident::$name:ident $(if $cfg:meta)?,
    )*) => { $(
        $(#[cfg($cfg)])?
        mod $mod;
        $(#[cfg($cfg)])?
        pub use self::$mod::$name;

        $(#[cfg($cfg)])?
        impl<T> File<T, $name> {
            #[doc = concat!("Create a new [`File`] that reads [`", stringify!($name), "`] files.")]
            #[doc = ""]
            #[doc = concat!("See: [`", stringify!($name), "`].")]
            #[doc = ""]
            #[doc = concat!("Equivalent to: `File::new(", stringify!($name), "::default())`")]
            pub fn $mod() -> Self {
                Self::new($name::default())
            }
        }

        $(#[cfg($cfg)])?
        #[doc = concat!("Read the module at `path` with [`", stringify!($name), "`].")]
        #[doc = ""]
        #[doc = concat!("See: [`", stringify!($name), "`].")]
        pub fn $mod<T>(path: impl AsRef<std::path::Path>) -> Result<T, module::Error>
        where
            T: module::Merge + serde::de::DeserializeOwned,
        {
            read(path, $name::default())
        }
    )* };
}

formats! {
    json::Json if feature = "json",
    toml::Toml if feature = "toml",
    yaml::Yaml if feature = "yaml",
}