Struct Source 

pub struct Source { /* private fields */ }

One configuration source declaration.

See the crate-level documentation for the source string format, parsing rules, and examples.

Implementations

impl Source

pub fn parse(input: &str) -> Result<Source, ParseError>

pub fn named(name: impl Into<String>) -> Source

Build a bare source with just a name — no options, no resource — infallibly.

Used for synthetic origins (e.g. tanzim_value::Locations that do not come from parsing a real source string). Unlike Source::parse this performs no validation, so the name may even be empty for a placeholder origin.

pub fn on_error(&self, stage: Stage) -> OnError

The error policy this source declares for stage, via its reserved on_error option.

Defaults to OnError::Fail when the option is absent, malformed, or does not mention the stage. on_error=(load=skip,validate=skip) yields OnError::Skip for those two stages.

pub fn source(&self) -> &str

pub fn source_mut(&mut self) -> &mut String

pub fn set_source(&mut self, source: impl Into<String>)

pub fn with_source(self, source: impl Into<String>) -> Source

pub fn options(&self) -> &Options

pub fn options_mut(&mut self) -> &mut Options

pub fn set_options(&mut self, options: Options)

pub fn with_options(self, options: Options) -> Source

pub fn set_option<K, V>(&mut self, key: K, value: V)

where K: Into<String>, V: Into<OptionValue>,

pub fn with_option<K, V>(self, key: K, value: V) -> Source

where K: Into<String>, V: Into<OptionValue>,

pub fn resource(&self) -> &str

pub fn resource_mut(&mut self) -> &mut String

pub fn set_resource(&mut self, resource: impl Into<String>)

pub fn with_resource(self, resource: impl Into<String>) -> Source

pub fn resource_colon(&self) -> bool

pub fn set_resource_colon(&mut self, resource_colon: bool)

pub fn with_resource_colon(self, resource_colon: bool) -> Source

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl Display for Source

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

Formats the value using the given formatter.

impl FromStr for Source

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Source, <Source as FromStr>::Err>

Parses a string s to return a value of this type.

impl PartialEq for Source

fn eq(&self, other: &Source) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Source

impl TryFrom<&String> for Source

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( value: &String, ) -> Result<Source, <Source as TryFrom<&String>>::Error>

Performs the conversion.

impl TryFrom<&str> for Source

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Source, <Source as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<Cow<'_, str>> for Source

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( value: Cow<'_, str>, ) -> Result<Source, <Source as TryFrom<Cow<'_, str>>>::Error>

Performs the conversion.

impl TryFrom<String> for Source

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Source, <Source as TryFrom<String>>::Error>

Performs the conversion.