ass-core 0.1.2

High-performance ASS subtitle format parser and analyzer
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

//! Single-section header parsing and dispatch.
//!
//! Implements [`Parser::parse_section`], which reads a section header and
//! delegates to the appropriate specialized parser, updating parser state and
//! recovering from unknown or malformed sections.

use super::Parser;
use crate::{
    parser::{
        ast::Section,
        binary_data::{FontsParser, GraphicsParser},
        errors::{IssueCategory, IssueSeverity, ParseError, ParseIssue},
        sections::{EventsParser, ScriptInfoParser, StylesParser},
    },
    utils::CoreError,
    Result,
};
use alloc::string::ToString;

impl<'a> Parser<'a> {
    /// Parse a single section (e.g., [Script Info])
    pub(super) fn parse_section(&mut self) -> Result<Section<'a>> {
        if !self.source[self.position..].starts_with('[') {
            return Err(CoreError::from(ParseError::ExpectedSectionHeader {
                line: self.line,
            }));
        }

        let header_end = self.source[self.position..].find(']').ok_or_else(|| {
            CoreError::from(ParseError::UnclosedSectionHeader { line: self.line })
        })? + self.position;

        let section_name = &self.source[self.position + 1..header_end];
        self.position = header_end + 1;
        self.skip_line();

        let start_line = self.line;

        match section_name.trim() {
            "Script Info" => {
                let parser = ScriptInfoParser::new(self.source, self.position, start_line);
                let (section, detected_version, issues, final_position, final_line) =
                    parser.parse().map_err(CoreError::from)?;

                // Update parser state
                if let Some(version) = detected_version {
                    self.version = version;
                }
                self.issues.extend(issues);
                self.position = final_position;
                self.line = final_line;

                Ok(section)
            }
            "V4+ Styles" | "V4 Styles" | "V4++ Styles" => {
                let parser = StylesParser::new(self.source, self.position, start_line);
                let (section, format, issues, final_position, final_line) =
                    parser.parse().map_err(CoreError::from)?;

                // Update parser state
                self.styles_format = format;
                self.issues.extend(issues);
                self.position = final_position;
                self.line = final_line;

                Ok(section)
            }
            "Events" => {
                let parser = EventsParser::new(self.source, self.position, start_line);
                let (section, format, issues, final_position, final_line) =
                    parser.parse().map_err(CoreError::from)?;

                // Update parser state
                self.events_format = format;
                self.issues.extend(issues);
                self.position = final_position;
                self.line = final_line;

                Ok(section)
            }
            "Fonts" => {
                let (section, final_position, final_line) =
                    FontsParser::parse(self.source, self.position, start_line);

                // Update parser state
                self.position = final_position;
                self.line = final_line;

                Ok(section)
            }
            "Graphics" => {
                let (section, final_position, final_line) =
                    GraphicsParser::parse(self.source, self.position, start_line);

                // Update parser state
                self.position = final_position;
                self.line = final_line;

                Ok(section)
            }
            _ => {
                #[cfg(feature = "plugins")]
                if self.registry.is_some() {
                    // Try to process unknown section with registered processors
                    if let Some(result) = self.try_process_with_registry(section_name, start_line) {
                        return result;
                    }
                }

                let suggestion = self.skip_to_next_section();
                let error = ParseError::UnknownSection {
                    section: section_name.to_string(),
                    line: self.line,
                };

                // Add suggestion to issues if we found one
                if let Some(suggestion_text) = suggestion {
                    self.issues.push(ParseIssue {
                        severity: IssueSeverity::Info,
                        category: IssueCategory::Structure,
                        message: suggestion_text,
                        line: self.line,
                        column: Some(0),
                        span: None,
                        suggestion: None,
                    });
                }

                Err(CoreError::from(error))
            }
        }
    }
}