astral-yaml

A fast, safe Rust YAML 1.2 parser.

Warning

This README is human-edited, but all code changes, PR summaries, and additional documentation were authored entirely by Codex. Use at your own risk.

Core parts:

• astral-yaml: parsing, syntax, source spans, and comments.
• astral-yaml-serde: serialization and deserialization.
• astral-yaml-python: Python bindings.

The parser targets YAML 1.2.2.

See conformance and limitations for supported behavior, and SECURITY.md for resource limits and vulnerability reporting.

Usage

The primary interfaces are:

• astral-yaml provides a low-level stream of syntax nodes with byte ranges, comment states, scalar styles, tags, and anchors. Aliases are not expanded.

• astral-yaml-serde provides a high-level serde-compatible serialization and deserialization interface. The serializer uses flow style and quoted strings.

• astral-yaml-python provides the astral_yaml module for reading and writing YAML with Python's built-in types.

See each crate's documentation for more information on usage.

Development

See CONTRIBUTING.md for development setup and checks.

Performance

See benchmarks for workloads, comparison settings, and commands. Pull requests include CodSpeed performance reports.