ucl-parser 0.1.13

Parser for the Unified Content Language (UCL)
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

//! # UCL Parser
//!
//! Parser for the Unified Content Language (UCL).
//!
//! UCL is a token-efficient command language for manipulating UCM documents.
//!
//! ## Document Structure
//!
//! ```text
//! STRUCTURE
//! <adjacency declarations>
//!
//! BLOCKS
//! <block definitions>
//!
//! COMMANDS
//! <transformation commands>
//! ```

pub mod ast;
pub mod lexer;
pub mod parser;

pub use ast::*;
pub use lexer::{Token, TokenKind};
pub use parser::{ParseError, ParseResult, Parser};

/// Parse a UCL document string
pub fn parse(input: &str) -> ParseResult<UclDocument> {
    let mut parser = Parser::new(input);
    parser.parse_document()
}

/// Parse UCL commands only (without STRUCTURE/BLOCKS sections)
pub fn parse_commands(input: &str) -> ParseResult<Vec<Command>> {
    let mut parser = Parser::new(input);
    parser.parse_commands_only()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_parse_simple_document() {
        let input = r#"
STRUCTURE
blk_000000000000: [blk_111111111111]

BLOCKS
text #blk_111111111111 label="Introduction" :: "Hello, world!"

COMMANDS
EDIT blk_111111111111 SET content.text = "Updated text"
"#;

        let doc = parse(input).unwrap();
        assert!(!doc.structure.is_empty());
        assert!(!doc.blocks.is_empty());
        assert!(!doc.commands.is_empty());
    }
}