freya-html 0.5.0

HTML + CSS rendering for Freya using Blitz
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

use std::borrow::Cow;

use url::{
    ParseError,
    Url,
};

/// Inline HTML and its optional base URL for resolving relative resources and links.
/// Static HTML is borrowed, while dynamically generated HTML is owned.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct HtmlContent {
    pub(crate) html: Cow<'static, str>,
    pub(crate) base_url: Option<Url>,
}

impl HtmlContent {
    pub fn new(html: impl Into<Cow<'static, str>>) -> Self {
        Self {
            html: html.into(),
            base_url: None,
        }
    }

    /// Sets an absolute base URL, rejecting malformed URLs and opaque URLs such as `data:`.
    pub fn with_base_url(mut self, base_url: impl AsRef<str>) -> Result<Self, ParseError> {
        let base_url = Url::parse(base_url.as_ref())?;
        if base_url.cannot_be_a_base() {
            return Err(ParseError::RelativeUrlWithCannotBeABaseBase);
        }

        self.base_url = Some(base_url);
        Ok(self)
    }
}

impl<T: Into<Cow<'static, str>>> From<T> for HtmlContent {
    fn from(html: T) -> Self {
        Self::new(html)
    }
}