Struct CfgPath

pub struct CfgPath(/* private fields */);

A path in a configuration file: tilde expansion is performed, along with expansion of variables provided by a CfgPathResolver.

The tilde expansion is performed using the home directory given by the directories crate, which may be based on an environment variable. For more information, see BaseDirs::home_dir.

Alternatively, a CfgPath can contain literal PathBuf, which will not be expanded.

Implementations

impl CfgPath

pub fn new(s: String) -> CfgPath

Create a new configuration path

pub fn new_literal<P>(path: P) -> CfgPath

where P: Into<PathBuf>,

Construct a new CfgPath designating a literal not-to-be-expanded PathBuf

pub fn path( &self, path_resolver: &CfgPathResolver, ) -> Result<PathBuf, CfgPathError>

Return the path on disk designated by this CfgPath.

Variables may or may not be resolved using path_resolver, depending on whether the expand-paths feature is enabled or not.

pub fn as_unexpanded_str(&self) -> Option<&str>

If the CfgPath is a string that should be expanded, return the (unexpanded) string,

Before use, this string would have be to expanded. So if you want a path to actually use, call path instead.

Returns None if the CfgPath is a literal PathBuf not intended for expansion.

pub fn as_literal_path(&self) -> Option<&Path>

If the CfgPath designates a literal not-to-be-expanded Path, return a reference to it

Returns None if the CfgPath is a string which should be expanded, which is the usual case.

Trait Implementations

impl Clone for CfgPath

fn clone(&self) -> CfgPath

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CfgPath

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CfgPath

fn deserialize<__D>( __deserializer: __D, ) -> Result<CfgPath, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CfgPath

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

Formats the value using the given formatter.

impl PartialEq for CfgPath

fn eq(&self, other: &CfgPath) -> 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 CfgPath

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CfgPath

impl StructuralPartialEq for CfgPath