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<Self, ParseError>

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

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>) -> Self

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) -> Self

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

pub fn with_option<K: Into<String>, V: Into<OptionValue>>( self, key: K, value: V, ) -> Self

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>) -> Self

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) -> Self

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Source

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Source

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

Formats the value using the given formatter.

impl From<Source> for SourceBuilder

fn from(value: Source) -> Self

Converts to this type from the input type.

impl FromStr for Source

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::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 Serialize for Source

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

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<Self, Self::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<Self, Self::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<Self, Self::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<Self, Self::Error>

Performs the conversion.