oak_xml/
lib.rs

1#![doc = include_str!("readme.md")]
2#![feature(new_range_api)]
3#![warn(missing_docs)]
4#![doc(html_logo_url = "https://raw.githubusercontent.com/ygg-lang/oaks/refs/heads/dev/documents/logo.svg")]
5#![doc(html_favicon_url = "https://raw.githubusercontent.com/ygg-lang/oaks/refs/heads/dev/documents/logo.svg")]
6
7/// AST module.
8pub mod ast;
9/// Builder module.
10pub mod builder;
11
12// pub mod formatter;
13// pub mod highlighter;
14/// Type definitions module.
15/// Language configuration module.
16pub mod language;
17/// Lexer module.
18pub mod lexer;
19/// LSP module.
20#[cfg(any(feature = "lsp", feature = "oak-highlight", feature = "oak-pretty-print"))]
21pub mod lsp;
22
23// pub mod mcp;
24/// Parser module.
25pub mod parser;
26
27pub use crate::{
28    ast::{XmlNode, XmlValue},
29    language::XmlLanguage,
30    lexer::{XmlLexer, token_type::XmlTokenType},
31    parser::XmlParser,
32};
33
34// #[cfg(feature = "oak-highlight")]
35// pub use crate::lsp::highlighter::XmlHighlighter;
36
37// /// LSP implementation.
38#[cfg(feature = "lsp")]
39pub use crate::lsp::XmlLanguageService;
40// #[cfg(feature = "lsp")]
41// pub use crate::lsp::formatter::XmlFormatter;
42
43#[cfg(feature = "serde")]
44pub use crate::language::serde::{from_value, to_value};
45
46/// Serializes a value to an XML string.
47#[cfg(feature = "serde")]
48pub fn to_string<T: ::serde::Serialize>(value: &T) -> Result<String, String> {
49    let xml_value = to_value(value).map_err(String::from)?;
50    Ok(xml_value.to_string())
51}
52
53/// Deserializes a value from an XML string.
54#[cfg(feature = "serde")]
55pub fn from_str<T: ::serde::de::DeserializeOwned>(s: &str) -> Result<T, String> {
56    let xml_value = parse(s)?;
57    from_value(xml_value).map_err(String::from)
58}
59
60/// Parses an XML string into an `XmlValue`.
61pub fn parse(xml: &str) -> Result<XmlValue, String> {
62    use crate::builder::XmlBuilder;
63    use oak_core::{Builder, parser::session::ParseSession, source::SourceText};
64    let builder = XmlBuilder::new();
65    let source = SourceText::new(xml.to_string());
66    let mut cache = ParseSession::default();
67    let result = builder.build(&source, &[], &mut cache);
68    result.result.map(|root| root.value).map_err(|e| format!("Parse failed: {:?}, diagnostics: {:?}", e, result.diagnostics))
69}
70
71pub use parser::element_type::XmlElementType;
oak_xml/lib.rs

oak_xml/
lib.rs
