Struct conch_runtime::path::NormalizedPath

pub struct NormalizedPath { /* fields omitted */ }

A PathBuf wrapper which ensures paths do not have . or .. components.

Methods

impl NormalizedPath

fn new() -> Self

Creates a new, empty NormalizedPath.

fn new_normalized_logical(buf: PathBuf) -> Self

Creates a new NormalizedPath instance with the provided buffer.

If buf is non-empty, it will be logically normalized as needed. See the documentation for join_normalized_logial for more information on how the normalization is performed.

fn new_normalized_physical(buf: PathBuf) -> Result<Self, NormalizationError>

Creates a new NormalizedPath instance with the provided buffer.

If buf is non-empty, it will be physically normalized as needed. See the documentation for join_normalized_physical for more information on how the normalization is performed.

fn join_normalized_logial<P: AsRef<Path>>(&mut self, path: P)

Joins a path to the buffer, normalizing away any . or .. components, without following any symbolic links.

For example, joining ../some/path to /root/dir will yield /root/some/path.

The normal behaviors of joining Paths will take effect (e.g. joining with an absolute path will replace the previous contents).

fn join_normalized_physical<P: AsRef<Path>>(
    &mut self,
    path: P
) -> Result<(), NormalizationError>

Joins a path to the buffer, normalizing away any . or .. components after following any symbolic links.

For example, joining ../some/path to /root/dir (where /root/dir is a symlink to /root/another/place) will yield /root/another/some/path.

The normal behaviors of joining Paths will take effect (e.g. joining with an absolute path will replace the previous contents).

Errors

If an error occurs while resolving symlinks, the current path buffer will be reset to its previous state (as if the call never happened) before the error is propagated to the caller.

fn into_inner(self) -> PathBuf

Unwraps the inner PathBuf.

Methods from Deref<Target = PathBuf>

fn as_path(&self) -> &Path

Coerces to a Path slice.

Examples

use std::path::{Path, PathBuf};

let p = PathBuf::from("/test");
assert_eq!(Path::new("/test"), p.as_path());

fn into_os_string(self) -> OsString

Consumes the PathBuf, yielding its internal OsString storage.

Examples

use std::path::PathBuf;

let p = PathBuf::from("/the/head");
let os_str = p.into_os_string();

fn into_boxed_path(self) -> Box<Path>

Converts this PathBuf into a boxed Path.

Trait Implementations

impl PartialEq for NormalizedPath

fn eq(&self, __arg_0: &NormalizedPath) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &NormalizedPath) -> bool

This method tests for !=.

impl Eq for NormalizedPath

impl Clone for NormalizedPath

fn clone(&self) -> NormalizedPath

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NormalizedPath

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for NormalizedPath

fn default() -> NormalizedPath

Returns the "default value" for a type.

impl Deref for NormalizedPath

type Target = PathBuf

The resulting type after dereferencing.

fn deref(&self) -> &PathBuf

Dereferences the value.