Struct CommentPreservingComposer 

pub struct CommentPreservingComposer {
    parser: BasicParser,
    scanner: BasicScanner,
    limits: Limits,
    resource_tracker: ResourceTracker,
    anchors: HashMap<String, CommentedValue>,
    current_depth: usize,
    alias_expansion_stack: Vec<String>,
    comment_map: HashMap<Position, String>,
    pending_comments: Vec<String>,
    yaml_version: YamlVersion,
}

A composer that preserves comments during parsing

Fields

parser: BasicParser

scanner: BasicScanner

limits: Limits

resource_tracker: ResourceTracker

anchors: HashMap<String, CommentedValue>

current_depth: usize

alias_expansion_stack: Vec<String>

comment_map: HashMap<Position, String>

Map of positions to comments (position -> comment text)

pending_comments: Vec<String>

Stack of pending comments that might belong to the next value

yaml_version: YamlVersion

Active YAML spec version for the current document.

Implementations

impl CommentPreservingComposer

pub fn new(input: String) -> Self

Create a new comment-preserving composer

pub fn with_limits(input: String, limits: Limits) -> Self

Create a new comment-preserving composer with limits

fn extract_comments(&mut self) -> Result<()>

Extract comments from the scanner and build a position map

fn get_comments_for_position(&self, position: Position) -> Comments

Get comments that should be associated with a value at the given position

pub fn compose_document(&mut self) -> Result<Option<CommentedValue>>

Compose a single document with comment preservation

fn compose_node(&mut self) -> Result<Option<CommentedValue>>

Compose a single node (value) with comments

fn compose_scalar( &mut self, value: String, anchor: Option<String>, position: Position, ) -> Result<Option<CommentedValue>>

Compose a scalar value

fn resolve_scalar_type( &self, value: String, position: Position, ) -> Result<Value>

Resolve scalar type from string value (version-aware).

Returns Err when the YAML 1.1 = value tag is detected — the CommentedValue tree has no tagged-scalar representation, so we surface the same error as the other composers (matches ruamel.yaml typ="safe").

fn compose_sequence( &mut self, anchor: Option<String>, position: Position, ) -> Result<Option<CommentedValue>>

Compose a sequence

fn compose_mapping( &mut self, anchor: Option<String>, position: Position, ) -> Result<Option<CommentedValue>>

Compose a mapping

fn compose_alias( &mut self, anchor: String, position: Position, ) -> Result<Option<CommentedValue>>

Compose an alias reference

fn collect_item_comments( &self, item: &CommentedValue, inner_comments: &mut Vec<String>, )

Collect comments from a commented value’s comments into inner comments

fn collect_comments( &self, comments: &Comments, inner_comments: &mut Vec<String>, )

Collect comments from a Comments struct into inner comments

fn process_merge_key( &self, mapping: &mut IndexMap<Value, Value>, merge_value: &Value, ) -> Result<()>

Process a merge key by merging values into the current mapping

Trait Implementations

impl Debug for CommentPreservingComposer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.