pullup 0.4.3

Convert between markup formats
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

pub mod assert;
pub mod filter;

#[cfg(feature = "markdown")]
pub mod markdown;
#[cfg(feature = "mdbook")]
pub mod mdbook;
#[cfg(feature = "typst")]
pub mod typst;

/// Represents all the types of markup events this crate can operate on.
///
/// Markup adapters:
/// * Convert format-specific iterators to [`ParserEvent`] iterators for further
///   processing.
/// * Convert [`ParserEvent`] iterators to format-specific iterators for output.
#[derive(Debug, Clone, PartialEq)]
pub enum ParserEvent<'a> {
    #[cfg(feature = "markdown")]
    Markdown(markdown::Event<'a>),
    #[cfg(feature = "mdbook")]
    Mdbook(mdbook::Event<'a>),
    #[cfg(feature = "typst")]
    Typst(typst::Event<'a>),
    #[cfg(not(any(feature = "markdown", feature = "mdbook", feature = "typst")))]
    NoFeaturesEnabled(core::marker::PhantomData<&'a ()>),
}

#[macro_export]
/// Convert between markup events without a buffer or lookahead.
macro_rules! converter {
    (
        $(#[$attr:meta])*
        $struct_name:ident,
        $in:ty => $out:ty,
        $body:expr
    ) => {
        // Define the struct with the given name
        #[derive(Debug, Clone)]
        $(#[$attr])*
        pub struct $struct_name<'a, I> {
            iter: I,
            p: core::marker::PhantomData<&'a ()>,
        }

        // Define an implementation for the struct
        impl<'a, I> $struct_name<'a, I>
        where
            I: Iterator<Item = ParserEvent<'a>>,
        {
            #[allow(dead_code)]
            pub fn new(iter: I) -> Self {
                Self {
                    iter,
                    p: core::marker::PhantomData,
                }
            }
        }

        impl<'a, I> Iterator for $struct_name<'a, I>
        where
            I: Iterator<Item = $in>,
        {
            type Item = $out;

            fn next(&mut self) -> Option<Self::Item> {
                #[cfg(feature = "tracing")]
                let span = tracing::span!(tracing::Level::TRACE, &"next");
                #[cfg(feature = "tracing")]
                let _enter = span.enter();
                #[allow(clippy::redundant_closure_call)]
                $body(self)
            }
        }
    };
}