Crate serde_plain [−] [src]

This crate implements a plain text serializer and deserializer. It can only serialize and deserialize primitives and derivatives thereof (like basic enums or newtypes). It internally uses the FromStr and Display trait to convert objects around.

The idea of this crate is that you can use the serde system to implement FromStr or Display for your own types based on the how serde would handle the type.

From String

To parse a value from a string the from_str helper can be used:

assert_eq!(serde_plain::from_str::<i32>("42").unwrap(), 42);

This is particularly useful if enums are in use:

#[derive(Deserialize, Debug, PartialEq, Eq)]
pub enum MyEnum {
    VariantA,
    VariantB,
}

assert_eq!(serde_plain::from_str::<MyEnum>("VariantA").unwrap(), MyEnum::VariantA);

To String

The inverse is also possible with to_string:

assert_eq!(serde_plain::to_string(&true).unwrap(), "true");

Macros

derive_deserialize_from_str	Derives `serde::Deserialize` a type that implements `FromStr`.
derive_serialize_from_display	Derives `serde::Serialize` a type that implements `fmt::Display`.
forward_display_to_serde	Implements `fmt::Display` for a type that forwards to serde.
forward_from_str_to_serde	Implements `FromStr` for a type that forwards to serde.

Structs

Deserializer	A simple deserializer that works with plain strings.
Serializer	A simple serializer that can dump out strings.

Enums

Error

Errors created from this crate.

Functions

from_str	Deserialize an instance of type `T` from a string of plain text.
to_string	Serialize the given data value as a plain string.