h2s_core 0.18.0

A core part of h2s
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

use std::error::Error;
use std::fmt::Debug;

/// HTML document
pub trait HtmlDocument: Debug {
    type Element<'a>: HtmlElement
    where
        Self: 'a;

    fn root_element(&self) -> Self::Element<'_>;
}

/// HTML Element
pub trait HtmlElement: Sized + Debug + Clone {
    type Backend: Backend;
    type Selector: CssSelector;

    fn select(&self, selector: &Self::Selector) -> Vec<Self>;
    // TODO remove this method
    fn text_contents(&self) -> String;
    fn attribute<S>(&self, attr: S) -> Option<&str>
    where
        S: AsRef<str>;
    fn child_nodes(&self) -> Vec<HtmlNode<'_, Self::Backend>>;
}

/// CSS Selector
pub trait CssSelector: Sized {
    type Error: Error;
    fn parse<S>(s: S) -> Result<Self, Self::Error>
    where
        S: AsRef<str>;
}

#[derive(Debug, Clone)]
pub enum HtmlNode<'a, B>
where
    B: Backend,
{
    Document(B::Document),
    Element(B::Element<'a>),
    Text(B::Text<'a>),
    // TODO
    Other,
}

pub trait TextNode: Debug {
    fn get_text(&self) -> String;
}

pub trait Backend: Debug {
    type Document: HtmlDocument;
    type Element<'a>: HtmlElement;
    type Text<'a>: TextNode;
    fn parse_document<S>(s: S) -> Self::Document
    where
        S: AsRef<str>;
}