Crate serde_plain[][src]

Expand description

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:

use serde::Deserialize;

#[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

Derives Deserialize for a type that implements FromStr.

Implements Display for a type that forwards to Serialize.

Implements FromStr for a type that forwards to Deserialize.

Derives Serialize a type that implements Display.

Structs

A simple deserializer that works with plain strings.

A simple serializer that can dump out strings.

Enums

Errors created from this crate.

Functions

Deserialize an instance of type T from a string of plain text.

Serialize the given data value as a plain string.