oak-xml 0.0.11

High-performance incremental XML parser for the oak ecosystem with flexible configuration.
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

#![doc = include_str!("readme.md")]
#![feature(new_range_api)]
#![warn(missing_docs)]
#![doc(html_logo_url = "https://raw.githubusercontent.com/ygg-lang/oaks/refs/heads/dev/documents/logo.svg")]
#![doc(html_favicon_url = "https://raw.githubusercontent.com/ygg-lang/oaks/refs/heads/dev/documents/logo.svg")]

/// AST module.
pub mod ast;
/// Builder module.
pub mod builder;

// pub mod formatter;
// pub mod highlighter;
/// Type definitions module.
/// Language configuration module.
pub mod language;
/// Lexer module.
pub mod lexer;
/// LSP module.
#[cfg(any(feature = "lsp", feature = "oak-highlight", feature = "oak-pretty-print"))]
pub mod lsp;

// pub mod mcp;
/// Parser module.
pub mod parser;

pub use crate::{
    ast::{XmlNode, XmlValue},
    language::XmlLanguage,
    lexer::{XmlLexer, token_type::XmlTokenType},
    parser::XmlParser,
};

// #[cfg(feature = "oak-highlight")]
// pub use crate::lsp::highlighter::XmlHighlighter;

// /// LSP implementation.
#[cfg(feature = "lsp")]
pub use crate::lsp::XmlLanguageService;
// #[cfg(feature = "lsp")]
// pub use crate::lsp::formatter::XmlFormatter;

#[cfg(feature = "serde")]
pub use crate::language::serde::{from_value, to_value};

/// Serializes a value to an XML string.
#[cfg(feature = "serde")]
pub fn to_string<T: ::serde::Serialize>(value: &T) -> Result<String, String> {
    let xml_value = to_value(value).map_err(String::from)?;
    Ok(xml_value.to_string())
}

/// Deserializes a value from an XML string.
#[cfg(feature = "serde")]
pub fn from_str<T: ::serde::de::DeserializeOwned>(s: &str) -> Result<T, String> {
    let xml_value = parse(s)?;
    from_value(xml_value).map_err(String::from)
}

/// Parses an XML string into an `XmlValue`.
pub fn parse(xml: &str) -> Result<XmlValue, String> {
    use crate::builder::XmlBuilder;
    use oak_core::{Builder, parser::session::ParseSession, source::SourceText};
    let builder = XmlBuilder::new();
    let source = SourceText::new(xml.to_string());
    let mut cache = ParseSession::default();
    let result = builder.build(&source, &[], &mut cache);
    result.result.map(|root| root.value).map_err(|e| format!("Parse failed: {:?}, diagnostics: {:?}", e, result.diagnostics))
}

pub use parser::element_type::XmlElementType;