Struct Toml

pub struct Toml;

Available on crate feature toml only.

A TOML Format Data provider.

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

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

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

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

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

See also toml::from_str for parsing details.

Trait Implementations

impl Format for Toml

const NAME: &'static str = "TOML"

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

type Error = Error

The data format’s error type.

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

where T: DeserializeOwned,

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>(path: P) -> Data<Self>

where P: AsRef<Path>,

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>(path: P) -> Data<Self>

where P: AsRef<Path>,

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>(path: &Path) -> Result<T, Self::Error>

where T: DeserializeOwned,

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.