Struct Deserializer 

pub struct Deserializer<'a> { /* private fields */ }

Deserializes types from a Value.

This is a Deserializer which emits the events of a value. It’s what from_value uses, use it directly to configure the deserialization, for instance to add layers:

use std::collections::BTreeMap;
use deser_path::{Path, PathLayer};
use deser_value::{value, Deserializer};

let value = value!({"items": [1, "two"]});
let err = Deserializer::new(&value)
    .deserialize_with::<BTreeMap<String, Vec<u32>>, _>(|driver| {
        driver.push_layer(PathLayer::new());
    })
    .unwrap_err();
assert_eq!(err.attachment::<Path>().unwrap().to_string(), "items[1]");

Strings and bytes are passed on borrowed from the value, which means that types like &str can be deserialized. The meta data of the values is restored for every event: event data is attached and if the value has spans, the input ranges and the source are published. This means that errors refer to the location in the input the value was deserialized from.

Implementations

impl<'a> Deserializer<'a>

pub fn new(value: &'a Value) -> Deserializer<'a>

Creates a deserializer for a value.

pub fn deserialize<T: Deserialize<'a>>(&mut self) -> Result<T, Error>

Deserializes the value.

pub fn deserialize_with<T, F>(&mut self, setup: F) -> Result<T, Error>

where T: Deserialize<'a>, F: FnOnce(&mut DeserializeDriver<'_, 'a>),

Deserializes the value with a configured driver.

The callback is invoked with the driver before the value is deserialized, for instance to add Layers.

pub fn set_context(&mut self, context: Context)

Sets the context the values are deserialized in.

The values of the context are the defaults of the extension values of the state (see Context). A context set on the driver (for instance in the setup callback of deserialize_with) takes precedence.

pub fn context(&self) -> &Context

Returns the context the values are deserialized in.

Trait Implementations

impl<'de> Deserializer<'de> for Deserializer<'de>

fn drive( &mut self, driver: &mut DeserializeDriver<'_, 'de>, ) -> Result<(), Error>

Parses the input and feeds the events of a value into the driver.

fn deserialize<T>(&mut self) -> Result<T, Error>

where T: Deserialize<'de>, Self: Sized,

Deserializes a value.

fn deserialize_with<T, F>(&mut self, setup: F) -> Result<T, Error>

where T: Deserialize<'de>, F: FnOnce(&mut DeserializeDriver<'_, 'de>), Self: Sized,

Deserializes a value with a configured driver.

fn update<T>(&mut self, value: &mut T) -> Result<(), Error>

where T: Deserialize<'de>, Self: Sized,

Updates an existing value with the next value.

fn update_with<T, F>(&mut self, value: &mut T, setup: F) -> Result<(), Error>

where T: Deserialize<'de>, F: FnOnce(&mut DeserializeDriver<'_, 'de>), Self: Sized,

Updates an existing value with the next value after setting up the driver.