belong 0.1.0

Simple and flexible static site generator.
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::str;

use serde::{Deserialize, Serialize};

use crate::util::TomlValueExt;

/////////////////////////////////////////////////////////////////////////
// Config definitions
/////////////////////////////////////////////////////////////////////////

/// Project specific configuration.
#[derive(Debug, Default, PartialEq, Deserialize, Serialize)]
pub struct ProjectConfig {
    /// The title of the project.
    pub title: Option<String>,
    /// The project's authors.
    pub authors: Option<Vec<String>>,
}

/// The overall configuration for a project.
#[derive(Debug, PartialEq, Deserialize, Serialize)]
pub struct Config {
    /// Project specific configuration.
    #[serde(default)]
    pub project: ProjectConfig,
    /// The rest of the TOML configuration file.
    #[serde(flatten)]
    rest: toml::Value,
}

/////////////////////////////////////////////////////////////////////////
// Config implementations
/////////////////////////////////////////////////////////////////////////

impl Default for Config {
    fn default() -> Self {
        Self {
            project: ProjectConfig::default(),
            rest: toml::Value::default(),
        }
    }
}

impl str::FromStr for Config {
    type Err = anyhow::Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Ok(toml::from_str(s)?)
    }
}

/////////////////////////////////////////////////////////////////////////
// Unit tests
/////////////////////////////////////////////////////////////////////////

#[cfg(test)]
mod test {
    use super::*;

    use toml::toml;

    #[test]
    fn config_from_str_empty() {
        let config: Config = toml::from_str("").unwrap();
        assert_eq!(config, Config::default());
    }

    #[test]
    fn config_from_str_project() {
        let content = r#"
            [project]
            title = "My Blog"
        "#;
        let config: Config = toml::from_str(content).unwrap();
        assert_eq!(
            config,
            Config {
                project: ProjectConfig {
                    title: Some("My Blog".to_string()),
                    ..Default::default()
                },
                ..Default::default()
            }
        );
    }

    #[test]
    fn config_from_str_rest() {
        let content = r#"
            [plugin]
            another = 5
        "#;
        let config: Config = toml::from_str(content).unwrap();
        assert_eq!(
            config,
            Config {
                rest: toml! {
                    [plugin]
                    another = 5
                },
                ..Default::default()
            }
        );
    }

    #[test]
    fn config_from_str_both() {
        let content = r#"
            [project]
            title = "My Blog"

            [plugin]
            another = 5
        "#;
        let config: Config = toml::from_str(content).unwrap();
        assert_eq!(
            config,
            Config {
                project: ProjectConfig {
                    title: Some("My Blog".to_string()),
                    ..Default::default()
                },
                rest: toml! {
                    [plugin]
                    another = 5
                },
            }
        );
    }
}