Guide
Learn how to use facet for serialization, deserialization, and rich diagnostics.
Start here
- First run: Getting Started — install → derive → round-trip → errors.
- Decide if facet fits: Why facet? — tradeoffs vs serde.
- See it in action: Showcases.
Guides
- Getting Started
- Why facet?
- Attributes Reference — complete
#[facet(...)]catalog - Dynamic Values —
Value,assert_same!,RawJson - Errors & diagnostics
- Variance and Soundness — lifetime safety in reflection
- Comparison with serde
- FAQ — common questions and quick answers
Reference (quick links)
- Format comparison matrix — feature support across format crates
- Extension Attributes — namespaced attributes by crate
Ecosystem
- Third-party types — uuid, chrono, time, camino, bytes, and more
structstruck— generate structs from sample data