Add ryaml as optional YAML parser dependency

[koxudaxi]

Summary

ryaml is a Rust-based YAML parser that offers better performance than PyYAML. Development has resumed with a comprehensive roadmap (see ryaml#10). Once the next version is released, we should consider adding it as an optional dependency.

Background

• ryaml is a Rust-based YAML parser with potential performance benefits
• Development was on hiatus but has now resumed
• Planned improvements include:
  • Python 3.13+ and free-threading support
  • Migration to actively maintained YAML parser (Saphyr)
  • Broader platform support via cibuildwheel
  • YAML spec conformance testing

Proposal

Once a stable release is available:

1. Add ryaml as an optional dependency in pyproject.toml

   [project.optional-dependencies]
   ryaml = ["ryaml>=X.Y.Z"]
   

2. Implement runtime detection to use ryaml when available, falling back to PyYAML
3. Benchmark performance improvements for large schema files

Blocked By

• Next stable release of ryaml with the roadmap improvements

References

• ryaml repository: https://github.com/emmatyping/ryaml
• Development roadmap: Revamp Roadmap emmatyping/ryaml#10

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

---

🔗 Similar Issues

Related Issues

• Migrate to Ruff as the default formatter for improved performance #2775

👤 Suggested Assignees

• koxudaxi

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!