ox_content_parser 0.3.0-alpha.9

High-performance Markdown parser for Ox Content
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

//! Error types for the parser.

use ox_content_ast::Span;
use thiserror::Error;

/// Result type for parsing operations.
pub type ParseResult<T> = Result<T, ParseError>;

/// Parse error.
#[derive(Debug, Error)]
pub enum ParseError {
    /// Unexpected token encountered.
    #[error("unexpected token at {span:?}: expected {expected}, found {found}")]
    UnexpectedToken {
        /// The span where the error occurred.
        span: Span,
        /// Expected token description.
        expected: String,
        /// Found token description.
        found: String,
    },

    /// Unexpected end of input.
    #[error("unexpected end of input at {span:?}")]
    UnexpectedEof {
        /// The span where the error occurred.
        span: Span,
    },

    /// Invalid syntax.
    #[error("invalid syntax at {span:?}: {message}")]
    InvalidSyntax {
        /// The span where the error occurred.
        span: Span,
        /// Error message.
        message: String,
    },

    /// Nesting too deep.
    #[error("nesting too deep at {span:?}: maximum depth is {max_depth}")]
    NestingTooDeep {
        /// The span where the error occurred.
        span: Span,
        /// Maximum allowed depth.
        max_depth: usize,
    },
}

impl ParseError {
    /// Returns the span where the error occurred.
    #[must_use]
    pub fn span(&self) -> Span {
        match self {
            Self::UnexpectedToken { span, .. }
            | Self::UnexpectedEof { span }
            | Self::InvalidSyntax { span, .. }
            | Self::NestingTooDeep { span, .. } => *span,
        }
    }
}