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

use {crate::fh::ComponentInformation, std::rc::Rc};

/// List of error kinds that occur within lewp.
#[derive(Debug)]
pub enum LewpErrorKind {
    /// Raised when a loop reference has been detected.
    LoopDetection,
    /// Indicates that a module has not been found.
    ModuleNotFound,
    /// Indicates an error that occured during CSS processing.
    Css,
    /// Error occured in functions of the FileHierarchy.
    FileHierarchy,
    /// Error occured in functions of a component of the FileHierarchy.
    FileHierarchyComponent,
    /// Indicates an error happened at runtime.
    Runtime,
    /// Indicates an error that occured during rendering.
    Render,
}

/// Contains the error definitions that occur in [lewp](crate).
#[derive(Debug)]
pub struct LewpError {
    /// The error type.
    pub kind: LewpErrorKind,
    /// The error message.
    pub message: String,
    /// The component where the error has been occurred.
    pub source_component: Rc<ComponentInformation>,
}

impl From<Rc<ComponentInformation>> for LewpError {
    fn from(meta: Rc<ComponentInformation>) -> Self {
        Self {
            kind: LewpErrorKind::FileHierarchyComponent,
            message: String::from("Unspecified error occured!"),
            source_component: meta,
        }
    }
}

impl LewpError {
    /// Creates a [LewpError] instance with the given details.
    pub fn new(
        kind: LewpErrorKind,
        message: &str,
        meta: Rc<ComponentInformation>,
    ) -> Self {
        Self {
            kind,
            message: message.to_string(),
            source_component: meta,
        }
    }
    /// Creates a [LewpError] instance with the given message.
    pub fn from_with_message(
        meta: Rc<ComponentInformation>,
        message: &str,
    ) -> Self {
        Self {
            kind: LewpErrorKind::FileHierarchyComponent,
            message: message.to_string(),
            source_component: meta,
        }
    }
}

impl std::fmt::Display for LewpError {
    fn fmt(
        &self,
        f: &mut std::fmt::Formatter<'_>,
    ) -> Result<(), std::fmt::Error> {
        use LewpErrorKind::*;
        let kind = match self.kind {
            LoopDetection => "LOOP DETECTION",
            ModuleNotFound => "MODULE NOT FOUND",
            Css => "CSS PROCESSING",
            FileHierarchy => "FILE HIERARCHY",
            FileHierarchyComponent => "FILE HIERARCHY COMPONENT",
            Runtime => "Runtime",
            Render => "RENDER",
        };
        write!(
            f,
            "Component with id '{}', on level '{}' of type '{}' returned [{}]: {}",
            &self.source_component.id,
            &self.source_component.level,
            &self.source_component.kind,
            kind,
            self.message
            )
    }
}