docspec 1.1.0

Streaming document conversion: convenience facade re-exporting readers, writers, and event types
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

//! Reader factory for creating readers from input formats.

use docspec_core::{Event, EventSource, Result};

#[cfg(feature = "html")]
use docspec_html_reader::HtmlReader;
#[cfg(feature = "markdown")]
use docspec_markdown_reader::MarkdownReader;

use crate::format::InputFormat;

/// Enum-dispatch reader for any registered input format.
///
/// Constructed via [`AnyReader::new`]. Implements [`EventSource`] by delegating
/// `next_event` to the inner concrete reader. Zero heap allocation, zero
/// virtual-dispatch overhead.
pub enum AnyReader<'a> {
    /// HTML reader from [`docspec_html_reader`] (paragraph-only; see crate docs).
    #[cfg(feature = "html")]
    Html(HtmlReader<'a>),
    /// Markdown reader from [`docspec_markdown_reader`].
    #[cfg(feature = "markdown")]
    Markdown(MarkdownReader<'a>),
    /// Phantom variant when no reader features are active.
    #[cfg(not(any(feature = "markdown", feature = "html")))]
    _Phantom(std::marker::PhantomData<&'a ()>),
}

impl<'a> AnyReader<'a> {
    /// Construct a reader for the given format from an in-memory string.
    #[inline]
    #[must_use]
    pub fn new(format: InputFormat, input: &'a str) -> Self {
        #[cfg(not(any(feature = "markdown", feature = "html")))]
        {
            let _ = input;
            match format {}
        }
        #[cfg(any(feature = "markdown", feature = "html"))]
        match format {
            #[cfg(feature = "html")]
            InputFormat::Html => Self::Html(HtmlReader::new(input)),
            #[cfg(feature = "markdown")]
            InputFormat::Markdown => Self::Markdown(MarkdownReader::new(input)),
        }
    }
}

impl EventSource for AnyReader<'_> {
    #[inline]
    fn next_event(&mut self) -> Result<Option<Event>> {
        match self {
            #[cfg(feature = "html")]
            Self::Html(r) => r.next_event(),
            #[cfg(feature = "markdown")]
            Self::Markdown(r) => r.next_event(),
            #[cfg(not(any(feature = "markdown", feature = "html")))]
            Self::_Phantom(_) => Ok(None),
        }
    }
}