ron-rs/ron
Ron
RON is a serializer and deserializer for a strongly typed, human-readable data exchange format. It mirrors Rust language syntax to represent complex data structures and configurations, serving as an alternative to formats like JSON and TOML.
The format preserves native Rust type idioms, including enums, structs, tuples, and ranges. It supports inline comments and specialized numeric bases, allowing for the creation of typed configuration files and human-editable data storage.
The library provides source-mapped error reporting to track character coordinates during syntax failures and includes options for configurable pretty-printing to manage indentation and whitespace. Data mapping is handled through common language interfaces to convert custom types into serialized text.
Features
- Rust - Provides a serialization library specifically designed for the Rust ecosystem to convert complex structures to readable text.
- Complex Data Serialization - Supports the serialization of complex Rust non-primitive types including structs, tuples, and lists.
- Data Serialization Formats - Provides a specialized data serialization format for converting RON strings back into typed Rust structures.
- Typed Configuration Files - Creates and manages typed configuration files that use Rust syntax to define complex application settings.
- Language-Mirroring Syntaxes - Implements a serialization format that replicates Rust's structural syntax for maximum consistency with the language.
- Strongly Typed Configuration Formats - Provides a configuration format that preserves native Rust type idioms including enums and structs.
- Human-Readable Configuration Formats - Provides a data format designed for manual editing, featuring native Rust syntax and inline comments.
- Recursive Descent Parsers - Implements a recursive descent parsing engine to translate formatted text into structured syntax trees.
- Serialized Data Comments - Enables the addition of single-line text annotations inside serialized data to provide context without altering the parsed value.
- Source Code Error Location Reporters - Tracks exact character coordinates in the input stream to provide precise line and column data during syntax failures.
- Human-Readable Formatting - Includes tools for transforming serialized data into human-readable versions with configurable indentation and spacing.
- Optional Value Serializers - Implements serialization logic that uses explicit markers to represent the presence or absence of optional values.
- Trait-Based Serialization - Uses Rust traits to define how custom data structures are encoded into the RON text format.
- Type-Safe Data Handling - Ensures type safety during data interchange by preserving strong typing and native Rust language idioms.
- Structured Text Pretty-Printing - Provides configurable visual layout options to format structured data into human-readable, indented text.
