xee-xpath-ast 0.1.4

XPath parser and AST implementation
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

use xee_name::VariableNames;

use crate::ast;
use crate::{Namespaces, ParserError};

#[derive(Debug, Default)]
pub struct XPathParserContext {
    pub namespaces: Namespaces,
    pub variable_names: VariableNames,
}

impl XPathParserContext {
    /// Construct a new XPath parser context.
    ///
    /// This consists of information about namespaces and variable names
    /// available.
    pub fn new(namespaces: Namespaces, variable_names: VariableNames) -> Self {
        Self {
            namespaces,
            variable_names,
        }
    }

    /// Given an XPath string, parse into an XPath AST
    ///
    /// This uses the namespaces and variable names with which
    /// this static context has been initialized.
    pub fn parse_xpath(&self, s: &str) -> Result<ast::XPath, ParserError> {
        ast::XPath::parse(s, &self.namespaces, &self.variable_names)
    }

    /// Given an XSLT pattern, parse into an AST
    pub fn parse_pattern(&self, s: &str) -> Result<crate::Pattern<ast::ExprS>, ParserError> {
        crate::Pattern::parse(s, &self.namespaces, &self.variable_names)
    }

    /// Parse an XPath string as it would appear in an XSLT value template.
    /// This means it should have a closing `}` following the xpath expression.
    pub fn parse_value_template_xpath(&self, s: &str) -> Result<ast::XPath, ParserError> {
        ast::XPath::parse_value_template(s, &self.namespaces, &self.variable_names)
    }
}