Name Description Size Coverage
enumerable.rs 17618 -
field.rs 3648 -
lib.rs Valuable provides object-safe value inspection. Use cases include passing structured data to trait objects and object-safe serialization. # Getting started First, derive [`Valuable`][macro@crate::Valuable] on your types. ``` use valuable::Valuable; #[derive(Valuable)] struct HelloWorld { message: Message, } #[derive(Valuable)] enum Message { HelloWorld, Custom(String), } ``` Then, implement a [visitor][Visit] to inspect the data. ``` use valuable::{NamedValues, Value, Valuable, Visit}; struct Print; impl Visit for Print { fn visit_value(&mut self, value: Value<'_>) { match value { Value::Structable(v) => { println!("struct {}", v.definition().name()); v.visit(self); } Value::Enumerable(v) => { println!("enum {}::{}", v.definition().name(), v.variant().name()); v.visit(self); } Value::Listable(v) => { println!("list"); v.visit(self); } Value::Mappable(v) => { println!("map"); v.visit(self); } _ => { println!("value {:?}", value); } } } fn visit_named_fields(&mut self, named_fields: &NamedValues<'_>) { for (field, value) in named_fields.iter() { println!("named field {}", field.name()); value.visit(self); } } fn visit_unnamed_fields(&mut self, values: &[Value<'_>]) { for value in values { value.visit(self); } } fn visit_entry(&mut self, key: Value<'_>, value: Value<'_>) { println!("key / value"); key.visit(self); value.visit(self); } } ``` Then, use the visitor to visit the value. ``` # use valuable::*; # #[derive(Valuable)] # struct HelloWorld { message: Message } # #[derive(Valuable)] # enum Message { HelloWorld } # struct Print; # impl Visit for Print { # fn visit_value(&mut self, _: Value<'_>) {} # } let hello_world = HelloWorld { message: Message::HelloWorld }; hello_world.visit(&mut Print); ``` # Related Crates - [`valuable-serde`] provides a bridge between `valuable` and the [`serde`] serialization ecosystem. Using [`valuable_serde::Serializable`] allows any type that implements [`Valuable`] to be serialized by any [`serde::ser::Serializer`]. [`valuable-serde`]: https://crates.io/crates/valuable-serde [`serde`]: https://crates.io/crates/serde [`valuable_serde::Serializable`]: https://docs.rs/valuable-serde/latest/valuable_serde/struct.Serializable.html [`serde::ser::Serializer`]: https://docs.rs/serde/latest/serde/ser/trait.Serializer.html 4155 -
listable.rs 7623 -
mappable.rs 5579 -
named_values.rs 5558 -
slice.rs 9947 -
structable.rs 14006 -
tuplable.rs 9357 -
valuable.rs 8387 -
value.rs 22294 -
visit.rs 13621 -