domq 0.5.0

Tiny, zero-dependency, forgiving HTML parser: turn messy real-world HTML into a clean DOM tree (and JSON). WASM-first, no_std-friendly.
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

# Stream huge documents

`domq::events` streams a document as start, end, text, comment and doctype
events without building a tree. The events come *after* recovery, from the
same tree builder `parse` uses, so every start has exactly one end and
replaying them builds exactly the tree `parse` would. Memory grows with the
nesting depth, not the document size.

```rust
# extern crate domq;
use domq::Event;

let html = "<ul><li>Tom &amp; Jerry<li>Spike<br></ul>";
let mut items = Vec::new();
for (event, _range) in domq::events(html) {
    match event {
        Event::Start { name, .. } if name == "li" => items.push(String::new()),
        Event::Text(text) => {
            if let Some(item) = items.last_mut() {
                item.push_str(&text);
            }
        }
        _ => {}
    }
}
assert_eq!(items, ["Tom & Jerry", "Spike"]);
```

Each event carries its byte range in the input; implied end tags have an empty
range. For raw tokens before any recovery, use `domq::tokenize`.

Running CSS selectors directly over the event stream (for multi-gigabyte
dumps) is on the [roadmap](https://github.com/iamsaquib8/domq/blob/main/ROADMAP.md)
for 0.6.