Struct HtmlReader 

pub struct HtmlReader { /* private fields */ }

A streaming HTML reader that implements EventSource.

HtmlReader parses HTML using html5gum and emits DocSpec events one at a time. Only <p> paragraph elements are recognized; all other elements are silently ignored.

Example

use docspec_html_reader::{HtmlReader, EventSource};

let mut reader = HtmlReader::from_str("<p>hello</p>");
while let Some(event) = reader.next_event()? {
    // Process events...
}

Implementations

impl HtmlReader

pub fn from_reader<R: Read + Seek + Send + 'static>(reader: R) -> Result<Self>

Creates an HtmlReader from any Read + Seek source.

The source is streamed via html5gum::IoReader’s 16 KB sliding-window buffer. Memory usage is constant regardless of document size.

The Seek bound is required for API symmetry with other DocSpec readers (e.g., DocxReader), even though html5gum::IoReader only needs Read.

Errors

This constructor does not read from the source eagerly and therefore currently cannot fail.

pub fn from_str(input: &str) -> Self

Creates an HtmlReader from a string slice.

The input bytes are copied into an owned Vec<u8> and streamed via html5gum::IoReader’s 16 KB sliding-window buffer.

Trait Implementations

impl EventSource for HtmlReader

fn next_event(&mut self) -> Result<Option<Event>>

Returns the next event from the stream, or None if the stream has ended.