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

use super::{
    super::{configuration::*, coordinator::*},
    configuration::*,
    routers::*,
};

use {axum::routing::*, kutil::http::axum::*, std::path::*};

//
// Site
//

/// Credence site.
#[derive(Clone, Debug)]
pub struct Site {
    /// Configuration.
    pub configuration: CredenceConfiguration,

    /// Router
    pub router: Router,
}

impl Site {
    /// Constructor.
    pub fn new<PathT>(assets_path: PathT, shutdown: &Shutdown) -> Result<Self, ConfigurationError>
    where
        PathT: AsRef<Path>,
    {
        let assets_path = assets_path.as_ref();

        if !assets_path.exists() {
            return Err(format!("assets path does not exist: {}", assets_path.display()).into());
        } else if !assets_path.is_dir() {
            return Err(format!("assets path is not a directory: {}", assets_path.display()).into());
        }

        let configuration = load_configuration(assets_path)?;
        let cache = configuration.caching.cache();
        let router = new_site_router(shutdown, &cache, &configuration);

        Ok(Self { configuration, router })
    }

    /// Create a [Coordinator] if configured.
    pub fn new_coordinator(&self) -> Result<Option<Coordinator>, ConfigurationError> {
        Ok(self.configuration.files.coordinate.new_coordinator()?)
    }
}