Struct DelimitedEntries

pub struct DelimitedEntries<K, V, DeK = <K as WellKnown>::Deserializer, DeV = <V as WellKnown>::Deserializer, ESep = &'static str, KvSep = &'static str> { /* private fields */ }

Delimited variant of Entries that can deserialize a map from a delimited string (with addition to the conventional object deserialization). Can be constructed using Entries::delimited().

DelimitedEntries are characterized by 2 separators: one between entries, and another between key and value.

Examples

use smart_config::{de, testing, DescribeConfig, DeserializeConfig};

#[derive(DescribeConfig, DeserializeConfig)]
struct TestConfig {
    #[config(with = de::Entries::WELL_KNOWN.delimited(",", "="))]
    map: HashMap<String, i64>,
}

let config = smart_config::config!("map": "call=5,send=-3");
let config: TestConfig = testing::test(config)?;
assert_eq!(
    config.map,
    HashMap::from([("call".into(), 5), ("send".into(), -3)])
);

Regex separators

Similar configuration that allows for whitespace around separators.

use smart_config::pat::lazy_regex;

#[derive(DescribeConfig, DeserializeConfig)]
struct TestConfig {
    #[config(
        with = de::Entries::WELL_KNOWN.delimited(
            // see `lazy_regex!` docs for the syntax explanation
            lazy_regex!(ref r"\s*,\s*"),
            lazy_regex!(ref r"\s*=\s*"),
        )
    )]
    map: HashMap<String, i64>,
}

let config = smart_config::config!("map": "call = 5, send = -3");
let config: TestConfig = testing::test(config)?;

Trait Implementations

impl<K, V, DeK, DeV, ESep, KvSep> Debug for DelimitedEntries<K, V, DeK, DeV, ESep, KvSep>

where DeK: Debug, DeV: Debug, ESep: Split, KvSep: Split,

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<K, V, DeK, DeV, ESep, KvSep, C> DeserializeParam<C> for DelimitedEntries<K, V, DeK, DeV, ESep, KvSep>

where DeK: DeserializeParam<K>, DeV: DeserializeParam<V>, ESep: Split, KvSep: Split, C: FromIterator<(K, V)>, Entries<K, V, DeK, DeV>: DeserializeParam<C>,

const EXPECTING: BasicTypes

Describes which parameter this deserializer is expecting.

fn describe(&self, description: &mut TypeDescription)

Additional info about the deserialized type, e.g., extended description.

fn deserialize_param( &self, ctx: DeserializeContext<'_>, param: &'static ParamMetadata, ) -> Result<C, ErrorWithOrigin>

Performs deserialization given the context and param metadata.

fn serialize_param(&self, param: &C) -> Value

Serializes the provided parameter to the JSON model.