Module serde 

(De)serialization helpers for other Ruma crates.

Part of that is a fork of serde_urlencoded, with support for sequences in Deserialize / Serialize structs (e.g. Vec<Something>) that are (de)serialized as field=val1&field=val2.

Re-exports

pub use self::base64::Base64;

pub use self::base64::Base64DecodeError;

pub use self::can_be_empty::is_empty;

pub use self::can_be_empty::CanBeEmpty;

Modules

base64

Transparent base64 encoding / decoding as part of (de)serialization.

can_be_empty

Helpers for emptiness checks in #[serde(skip_serializing_if)].

duration

De-/serialization functions for std::time::Duration objects

json_string

De-/serialization functions to and from json strings, allows the type to be used as a query string.

single_element_seq

De-/serialization functions to and from single element sequences.

test

Helpers for tests

Structs

Raw

A wrapper around Box<RawValue> with a generic parameter for the expected Rust type.

Traits

JsonCastable

Marker trait for restricting the types Raw::deserialize_as, Raw::cast and Raw::cast_ref can be called with.

Functions

btreemap_deserialize_v1_powerlevel_values

Take a BTreeMap with values of either an integer number or a string and deserialize those to integer numbers.

default_on_error

Helper function for returning a default value if deserialization of the type fails.

default_true

Simply returns true.

deserialize_as_number_or_string

Take either a floating point number or a string and deserialize to an floating-point number.

deserialize_as_optional_number_or_string

Deserializes an Option<f64> from an encoded f64 or string or integer (i64 or u64).

deserialize_cow_str

Deserialize a Cow<'de, str>.

deserialize_v1_powerlevel

Take either an integer number or a string and deserialize to an integer number.

empty_string_as_none

Serde deserialization decorator to map empty Strings to None, and forward non-empty Strings to the Deserialize implementation for T.

from_raw_json_value

Helper function for serde_json::value::RawValue deserialization.

ignore_invalid_vec_items

Helper function for ignoring invalid items in a Vec, instead letting them cause the entire Vec to fail deserialization

is_default

Check whether a value is equal to its default value.

is_true

Simply dereferences the given bool.

json_to_buf

Creates a buffer and writes a serializable value to it.

none_as_default

Deserialize a T via Option<T>, falling back to T::default().

none_as_empty_string

Serde serializiation decorator to map None to an empty String, and forward Somes to the Serialize implementation for T.

slice_to_buf

Converts a byte slice to a buffer by copying.

Type Aliases

JsonObject

The inner type of JsonValue::Object.

Derive Macros

AsRefStr

Derive the AsRef<str> trait for an enum.

AsStrAsRefStr

Derive the as_str() method using the AsRef<str> implementation of the type.

DebugAsRefStr

Derive the fmt::Debug trait using the AsRef<str> implementation of the type.

DeserializeFromCowStr

Derive the Deserialize trait using the From<Cow<str>> implementation of the type.

DisplayAsRefStr

Derive the fmt::Display trait using the AsRef<str> implementation of the type.

EqAsRefStr

Derive the PartialEq and Eq traits using the AsRef<str> implementation of the type.

FromString

Derive the From<T: AsRef<str> + Into<Box<str>>> trait for an enum.

OrdAsRefStr

Derive the Ord and PartialOrd traits using the AsRef<str> implementation of the type.

SerializeAsRefStr

Derive the Serialize trait using the AsRef<str> implementation of the type.

StringEnum

Shorthand for the derives AsRefStr, FromString, DisplayAsRefStr, DebugAsRefStr, SerializeAsRefStr, DeserializeFromCowStr, EqAsRefStr and OrdAsRefStr.