TOML guides
Recipe-style walk-throughs for Bodu.Text.Toml (TomlSerializer). Each guide is written against the real TOML surface. The sibling libraries Bodu.Text.Bencode and Bodu.Text.Yaml share the same architecture, so a pattern learned here transfers by swapping the prefix - see the serializer guides hub.
New to the library? Start with the introduction for what is specific to TOML, then work through the guides below.
Using TOML
Round-trip configuration types, the full type-mapping table, spec-version selection (v1.0.0 / v1.1.0), nested tables and arrays of tables, both DOMs, streams, and error handling.
Mapping attributes
The full shared Bodu.Text.Serialization attribute family - rename, ignore, include, order, require, extension data, constructor selection, and the precedence ladder.
Writing converters
Custom TomlConverter<T> shapes, registration, resolution order, the enum converters, and clear failure with the serialization exception.
Polymorphic converters
TomlConverterFactory for open-generic families and tagged (discriminated) hierarchies - reading and writing a discriminator.
Serialization callbacks
The four shared IOnSerializing / IOnSerialized / IOnDeserializing / IOnDeserialized lifecycle hooks - defaults that survive omitted keys, post-deserialization validation, and derived state on write.
Built-in converter catalog
Every type the serializer handles without a user converter - its wire form and what the read path accepts.
Where to go next
- Runnable samples - offline sample projects under
samples/Text.Toml/covering the serializer surface, both DOMs, the token layer, and streaming reads. - Bodu serializer guides - the family guide hub across all three libraries.
- Bodu.Text.Toml introduction and core concepts - the format-specific shape and vocabulary.
- Text & Serialization guides - how these guides sit alongside the encoding and format guides.
- API reference - Bodu.Text.Toml.