marxml 0.1.3

Fast markdown + XML query and mutation. Rust core for the marxml ecosystem.
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

//! CSS-subset selectors.
//!
//! See [`Selector::parse`] for the supported grammar.

mod ast;
mod error;
mod matcher;
mod parser;

pub use error::SelectorError;

use crate::types::{ElementData, ElementRef};

/// A compiled CSS-subset selector.
///
/// Parse once with [`Selector::parse`], then reuse against many documents.
///
/// # Supported grammar
///
/// ```text
/// selector    := compound ( "," compound )*
/// compound    := simple ( ( " " | " > " ) simple )*
/// simple      := ( tag | "*" ) predicate*
/// predicate   := "[" name ( ( "=" | "^=" | "$=" | "*=" ) "value" )? "]"
///              | ":first-child"
///              | ":nth-child(" n ")"
///              | ":not(" simple ")"
/// ```
///
/// Not yet supported: sibling combinators (`~`, `+`), `:has()`, attribute
/// negation operators (`~=`, `|=`), and case-insensitive flags.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Selector {
    compiled: ast::CompiledSelector,
}

impl Selector {
    /// Compile a selector string.
    ///
    /// # Errors
    ///
    /// Returns [`SelectorError`] if the string is empty, ends unexpectedly,
    /// or contains a syntax error.
    pub fn parse(input: &str) -> Result<Self, SelectorError> {
        Ok(Self {
            compiled: parser::parse(input)?,
        })
    }
}

impl std::str::FromStr for Selector {
    type Err = SelectorError;

    /// Equivalent to [`Selector::parse`]. Lets callers use the standard
    /// `"selector-string".parse::<Selector>()` form.
    fn from_str(input: &str) -> Result<Self, Self::Err> {
        Self::parse(input)
    }
}

pub(crate) fn select<'a>(
    roots: &'a [ElementData],
    raw: &'a str,
    trivia: &'a [core::ops::Range<usize>],
    sel: &Selector,
) -> Vec<ElementRef<'a>> {
    matcher::collect_matches(roots, raw, trivia, &sel.compiled)
}