babbel_yaml 0.1.0

Fast, modular YAML 1.2 parser and emitter with anchors, aliases, and tags
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


/*
 * Comment Error Helpers
 *
 * Centralizes error construction for YAML comment parsing, providing helpers
 * for consistent error messages and easier future maintenance.
 *
 * Copyright (c) 2026 YAML Library Developers
 */

use crate::error::YamlError;
use crate::io::traits::ISource;
use crate::parser::utils::error_builder::syntax_error;

/// Centralized constructors for comment-related parsing errors.
/// Behavior-neutral: messages match existing strings exactly.
pub struct CommentErrors;

impl CommentErrors {
    /// A comment character '#' immediately after a closing quoted scalar
    /// without separating whitespace is invalid.
    pub fn comment_must_be_separated_from_quoted_scalar_by_whitespace(
        source: &mut dyn ISource,
    ) -> YamlError {
        syntax_error(
            source,
            "YAML syntax error: comment must be separated from quoted scalar by whitespace",
        )
    }

    /// A comment character '#' immediately after a flow closer ('}' or ']')
    /// without separating whitespace is invalid.
    pub fn comment_must_be_preceded_by_whitespace_after_flow_closer(
        source: &mut dyn ISource,
        closer: char,
    ) -> YamlError {
        syntax_error(
            source,
            &format!(
                "YAML syntax error: comment must be preceded by whitespace after '{}' in flow collection",
                closer
            ),
        )
    }
}