Skip to main content

oak_ini/
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//! Ini support for the Oak language framework.
7
8/// AST module.
9pub mod ast;
10/// Builder module.
11pub mod builder;
12
13/// Type definitions module.
14/// Language configuration module.
15pub mod language;
16/// Lexer module.
17pub mod lexer;
18/// LSP module.
19#[cfg(any(feature = "lsp", feature = "oak-highlight", feature = "oak-pretty-print"))]
20pub mod lsp;
21/// MCP module.
22#[cfg(feature = "mcp")]
23pub mod mcp;
24
25/// Parser module.
26pub mod parser;
27
28pub use crate::{ast::IniRoot, builder::IniBuilder, language::IniLanguage, lexer::IniLexer, parser::IniParser};
29
30/// Parses an INI string.
31pub fn parse(ini: &str) -> Result<crate::ast::IniRoot, String> {
32    use oak_core::{Builder, parser::session::ParseSession, source::SourceText};
33    let language = IniLanguage::default();
34    let builder = IniBuilder::new(&language);
35    let source = SourceText::new(ini.to_string());
36    let mut cache = ParseSession::default();
37    let result = builder.build(&source, &[], &mut cache);
38    result.result.map_err(|e| format!("{:?}", e))
39}
40
41/// Highlighter implementation.
42#[cfg(feature = "oak-highlight")]
43pub use crate::lsp::highlighter::IniHighlighter;
44
45/// LSP implementation.
46#[cfg(feature = "lsp")]
47pub use crate::lsp::IniLanguageService;
48
49/// MCP service implementation.
50#[cfg(feature = "mcp")]
51pub use crate::mcp::serve_ini_mcp;
52pub use lexer::token_type::IniTokenType;
53pub use parser::element_type::IniElementType;