Module parser 

XML parsing and deserialization for OpenSCENARIO documents

This module provides comprehensive parsing capabilities for OpenSCENARIO XML files, including scenario definitions, parameter variations, and catalog files.

Features

• Fast XML parsing using quick-xml with zero-copy deserialization
• Type-safe validation with comprehensive error reporting
• Choice group handling for XSD polymorphic elements
• Catalog file support for reusable components
• Parameter and expression resolution

Basic Usage

use openscenario_rs::parser::xml::{parse_from_file, parse_from_str};
use openscenario_rs::parser::validation::ScenarioValidator;

// Parse a scenario file
let scenario = parse_from_file("scenario.xosc")?;

// Parse from XML string
let xml_content = r#"<?xml version="1.0"?>
<OpenSCENARIO>
  <FileHeader revMajor="1" revMinor="3" date="2024-01-01T00:00:00"
              author="Example" description="Basic scenario"/>
  <!-- scenario content -->
</OpenSCENARIO>"#;
let scenario = parse_from_str(xml_content)?;

// Validate the parsed scenario
let mut validator = ScenarioValidator::new();
let result = validator.validate_scenario(&scenario);
if result.is_valid() {
    println!("Scenario is valid!");
} else {
    for error in result.errors {
        println!("Error: {}", error.message);
    }
}

Advanced Features

Custom Validation Configuration

use openscenario_rs::parser::validation::{ScenarioValidator, ValidationConfig};

let config = ValidationConfig {
    strict_mode: true,
    validate_references: true,
    validate_constraints: true,
    max_errors: 50,
    ..Default::default()
};

let mut validator = ScenarioValidator::with_config(config);
let result = validator.validate_scenario(&scenario);

Performance Considerations

• Parsing is optimized for speed with zero-copy deserialization
• Enable validation caching for repeated validation operations

Modules

choice_groups

XSD Choice Group Infrastructure

validation

Validation system for parsed OpenSCENARIO content

xml

XML parsing implementation using quick-xml and serde