credence-lib 0.0.6

An unfussy web server designed for straightforward authoring and scalable performance
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

use super::{
    super::{render::*, util::*},
    coordinate::*,
    error::*,
};

use {compris::resolve::*, kutil::cli::depict::*, std::path::*};

//
// FilesConfiguration
//

/// Files configuration.
#[derive(Clone, Debug, Depict, Resolve)]
pub struct FilesConfiguration {
    /// Assets path.
    #[resolve]
    #[depict(as(debug), style(string))]
    pub assets: PathBuf,

    /// Status path.
    #[resolve]
    #[depict(as(debug), style(string))]
    pub status: PathBuf,

    /// Templates path.
    #[resolve]
    #[depict(as(debug), style(string))]
    pub templates: PathBuf,

    /// Coordinate.
    #[resolve]
    #[depict(as(depict))]
    pub coordinate: CoordinateConfiguration,
}

impl FilesConfiguration {
    /// Set assets paths if not already set.
    pub fn set_assets_path<PathT>(&mut self, assets_path: PathT)
    where
        PathT: AsRef<Path>,
    {
        if self.assets.as_os_str().is_empty() {
            self.assets = assets_path.as_ref().into();
        }
    }

    /// Validate.
    pub fn validate<PathT>(&mut self, base_path: PathT) -> Result<(), ConfigurationError>
    where
        PathT: AsRef<Path>,
    {
        let base_path = base_path.as_ref();

        if !self.status.is_absolute() {
            self.status = base_path.join(&self.status);
        }

        if !self.templates.is_absolute() {
            self.templates = base_path.join(&self.templates);
        }

        self.coordinate.validate(base_path, vec![self.templates.clone()])?;

        Ok(())
    }

    /// Asset path.
    pub fn asset(&self, uri_path: &str) -> PathBuf {
        self.assets.join(uri_path.trim_start_matches(PATH_SEPARATOR))
    }

    /// Templates.
    pub fn templates(&self) -> Templates {
        Templates::new(self)
    }
}

impl Default for FilesConfiguration {
    fn default() -> Self {
        Self {
            assets: Default::default(),
            status: PathBuf::from("status"),
            templates: PathBuf::from("templates"),
            coordinate: Default::default(),
        }
    }
}