lewp 0.3.0

Say goodbye to the web template hell. Generate your HTML5 website technically optimized and always valid. In your Rust source.
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

use {
    super::{Component, Entireness, ProcessedComponent},
    crate::{
        fh::{ComponentInformation, ComponentType, FileHierarchy, Level},
        LewpError,
    },
    std::{collections::HashMap, rc::Rc, sync::Arc},
};

/// Options for the Register.
pub struct RegisterOptions {}

impl RegisterOptions {
    /// Creates a new RegisterOptions instance.
    pub fn new() -> Self {
        Self {}
    }
}

/// Manages the CSS of lewp components in the given file hierarchy.
///
/// This register can be used in multi threaded environments as a shared
/// variable. It loads all components available in the given file hierarchy and
/// keeps them in memory, as long as this instance is available.
pub struct Register {
    fh: Rc<FileHierarchy>,
    options: RegisterOptions,
    components: HashMap<Rc<ComponentInformation>, ProcessedComponent>,
}

impl Register {
    /// Creates a new Register instance.
    pub fn new(fh: FileHierarchy, options: RegisterOptions) -> Self {
        Self {
            fh: Rc::new(fh),
            options,
            components: HashMap::new(),
        }
    }

    /// Queries the CSS of the given component using the given options.
    pub fn query(
        &self,
        component_information: Rc<ComponentInformation>,
        entity: Entireness,
    ) -> Option<Arc<String>> {
        let ref_css = self.components.get(&component_information)?;
        Some(ref_css.render_critical())
    }

    /// Collects, processes and caches all available CSS in the file hierarchy.
    pub fn load_process_components(&mut self) -> Result<(), LewpError> {
        self.load_process_modules()?;
        self.load_process_pages()
    }

    fn load_process_modules(&mut self) -> Result<(), LewpError> {
        let module_ids = self
            .fh
            .collect_component_ids(ComponentType::Css, Level::Module)?;
        for id in module_ids {
            let component_information = Rc::new(ComponentInformation {
                id: id.clone(),
                level: Level::Module,
                kind: ComponentType::Css,
            });
            let c =
                Component::new(component_information.clone(), self.fh.clone());
            let c = ProcessedComponent::from(&c)?;
            self.components.insert(component_information.clone(), c);
        }
        Ok(())
    }

    fn load_process_pages(&mut self) -> Result<(), LewpError> {
        let page_ids = self
            .fh
            .collect_component_ids(ComponentType::Css, Level::Page)?;
        for id in page_ids {
            let component_information = Rc::new(ComponentInformation {
                id: id.clone(),
                level: Level::Page,
                kind: ComponentType::Css,
            });
            let c =
                Component::new(component_information.clone(), self.fh.clone());
            let c = ProcessedComponent::from(&c)?;
            self.components.insert(component_information.clone(), c);
        }
        Ok(())
    }
}

impl Default for Register {
    fn default() -> Self {
        Self::new(FileHierarchy::new(), RegisterOptions::new())
    }
}