You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# Rusty Value
|
|
[![](https://img.shields.io/crates/v/rusty-value?style=for-the-badge)](https://crates.io/crates/rusty-value)
|
|
[![](https://img.shields.io/docsrs/rusty-value/latest?style=for-the-badge)](https://docs.rs/rusty-value/)
|
|
|
|
This crate adds a `RustyValue` trait that can be derived for all types (except unions)
|
|
to create a generic value that represents a rust value.
|
|
This can be used to implement serialization of types without having to rely on serde.
|
|
|
|
## Usage
|
|
|
|
The trait `RustyValue` allows one to create a `rusty_value::Value` for any
|
|
type that implements it. This trait can be derived if the `derive` **feature** is enabled.
|
|
|
|
```rust
|
|
|
|
use rusty_value::{RustyValue, Value};
|
|
|
|
#[derive(RustyValue)]
|
|
struct MyStruct {
|
|
foo: String,
|
|
bar: u8,
|
|
}
|
|
|
|
fn main() {
|
|
let value = MyStruct {
|
|
foo: "Hello World".to_string(),
|
|
bar: 12,
|
|
}.into_rusty_value();
|
|
|
|
match value {
|
|
Value::Primitive(p) => match p {
|
|
rusty_value::Primitive::Integer(_) => println!("is an integer"),
|
|
rusty_value::Primitive::Float(_) => println!("is a float"),
|
|
rusty_value::Primitive::String(_) => println!("is a string"),
|
|
rusty_value::Primitive::OsString(_) => println!("is a os string"),
|
|
rusty_value::Primitive::Char(_) => println!("is a char"),
|
|
rusty_value::Primitive::Bool(_) => println!("is a boolean"),
|
|
},
|
|
Value::Struct(s) => println!("is a struct with name {}", s.name),
|
|
Value::Enum(e) => println!("is an enum with name {} of variant {}", e.name, e.variant),
|
|
Value::Map(_) => println!("is a map"),
|
|
Value::List(_) => println!("is a list"),
|
|
Value::None => println!("is none"),
|
|
}
|
|
}
|
|
```
|
|
|
|
Converting a type into a rusty value cannot fail as `rusty_value::RustyValue` is
|
|
able to represent any safe rust data type. The trait `RustyValue` is already implemented for
|
|
most std types and can therefore be easily derived. |