ferrin-provider-util 0.1.0

Ferrin provider utilities: HTTP transport trait, reqwest transport, SSE decoding, secure URL policy, settings.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Provider option parsing.

use ferrin_spec::JsonValue;
use ferrin_spec::ProviderOptions;
use ferrin_spec::error::InvalidArgumentError;
use serde::de::DeserializeOwned;

/// Extracts and deserializes the options addressed to `provider_key`.
///
/// Returns `None` when the key is absent.
///
/// # Errors
///
/// Returns [`InvalidArgumentError`] (argument `provider_options`) when the
/// options do not deserialize into `T`.
pub fn parse_provider_options<T: DeserializeOwned>(
    provider_key: &str,
    options: &ProviderOptions,
) -> Result<Option<T>, InvalidArgumentError> {
    let Some(raw) = options.get(provider_key) else {
        return Ok(None);
    };
    serde_json::from_value::<T>(JsonValue::Object(raw.clone()))
        .map(Some)
        .map_err(|error| {
            let mut invalid = InvalidArgumentError::new(
                "provider_options",
                format!("invalid {provider_key} provider options: {error}"),
            );
            invalid.cause = Some(Box::new(error));
            invalid
        })
}