auk 0.6.0

An eDSL for writing HTML using standard Rust syntax.
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

//! Constructs for rendering [`HtmlElement`]s to HTML.

use std::fmt::Write;

use pulldown_cmark_escape::{escape_href, escape_html, escape_html_body_text};

use crate::visitor::Visitor;
use crate::HtmlElement;

/// A renderer for [`HtmlElement`]s to a string of HTML.
pub struct HtmlElementRenderer {
    html: String,
}

impl HtmlElementRenderer {
    /// Returns a new [`HtmlElementRenderer`].
    pub fn new() -> Self {
        Self {
            html: String::new(),
        }
    }

    /// Returns the rendered HTML.
    pub fn html(&self) -> &str {
        &self.html
    }

    /// Renders the given [`HtmlElement`] to a string of HTML.
    pub fn render_to_string(mut self, element: &HtmlElement) -> Result<String, std::fmt::Error> {
        self.visit(element)?;

        Ok(self.html)
    }
}

impl Visitor for HtmlElementRenderer {
    type Error = std::fmt::Error;

    fn visit(&mut self, element: &HtmlElement) -> Result<(), Self::Error> {
        if element.tag_name == "html" {
            write!(&mut self.html, "<!DOCTYPE html>")?;
        }

        write!(&mut self.html, "<{}", element.tag_name)?;

        for (name, value) in &element.attrs {
            self.visit_attr(name, value)?;
        }

        write!(&mut self.html, ">")?;

        if element.is_void() {
            return Ok(());
        }

        self.visit_children(&element.children)?;

        write!(&mut self.html, "</{}>", element.tag_name)?;

        Ok(())
    }

    fn visit_text(&mut self, text: &str) -> Result<(), Self::Error> {
        escape_html_body_text(&mut self.html, text)?;

        Ok(())
    }

    fn visit_attr(&mut self, name: &str, value: &str) -> Result<(), Self::Error> {
        write!(&mut self.html, " ")?;
        write!(&mut self.html, "{name}")?;

        if !value.is_empty() {
            write!(&mut self.html, "=")?;
            write!(&mut self.html, "\"")?;
            if name == "href" || name == "src" {
                escape_href(&mut self.html, value)?;
            } else {
                escape_html(&mut self.html, value)?;
            }

            write!(&mut self.html, "\"")?;
        }

        Ok(())
    }
}