Struct figment::providers::Json

pub struct Json;

Available on crate feature json only.

A JSON Format Data provider.

Static constructor methods on Json return a Data value with a generic marker of Json. Thus, further use occurs via methods on Data.

use figment::providers::{Format, Json};

// Source directly from a source string...
let provider = Json::string("source-string");

// Or read from a file on disk.
let provider = Json::file("path-to-file");

// Or configured as nested (via Data::nested()):
let provider = Json::file("path-to-file").nested();

See also serde_json::from_str for parsing details.

Trait Implementations

impl Format for Json

type Error = Error

The data format’s error type.

const NAME: &'static str = "JSON"

The name of the data format, for instance "JSON" or "TOML".

fn from_str<'de, T: DeserializeOwned>(s: &'de str) -> Result<T, Error>

Parses string as the data format Self as a T or returns an error if the string is an invalid T. Note: This method is not intended to be called directly. Instead, it is intended to be implemented and then used indirectly via the Data::file() or Data::string() methods.

fn file<P: AsRef<Path>>(path: P) -> Data<Self>

Returns a Data provider that sources its values by parsing the file at path as format Self. See Data::file() for more details. The default implementation calls Data::file(path).

fn file_exact<P: AsRef<Path>>(path: P) -> Data<Self>

Returns a Data provider that sources its values by parsing the file at path as format Self. See Data::file_exact() for more details. The default implementation calls Data::file_exact(path).

fn string(string: &str) -> Data<Self>

Returns a Data provider that sources its values by parsing string as format Self. See Data::string() for more details. The default implementation calls Data::string(string).

fn from_path<T: DeserializeOwned>(path: &Path) -> Result<T, Self::Error>

Parses the file at path as the data format Self as a T or returns an error if the string is an invalid T. The default implementation calls Format::from_str() with the contents of the file. Note: This method is not intended to be called directly. Instead, it is intended to be implemented on special occasions and then used indirectly via the Data::file() or Data::string() methods.