Struct path_dsl::PathDSL

pub struct PathDSL { /* fields omitted */ }

A PathBuf wrapper that has support for a Path DSL.

It is usable nearly identically to a PathBuf. Supports Deref to PathBuf to cover all edge cases.

See crate documentation for usage examples.

Methods

impl PathDSL

pub fn new() -> Self

pub fn into_os_string(self) -> OsString

pub fn into_boxed_path(self) -> Box<Path>

Methods from Deref<Target = PathBuf>

pub 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());

pub fn push<P>(&mut self, path: P) where
    P: AsRef<Path>, 

Extends self with path.

If path is absolute, it replaces the current path.

On Windows:

• if path has a root but no prefix (e.g., \windows), it replaces everything except for the prefix (if any) of self.
• if path has a prefix but no root, it replaces self.

Examples

Pushing a relative path extends the existing path:

use std::path::PathBuf;

let mut path = PathBuf::from("/tmp");
path.push("file.bk");
assert_eq!(path, PathBuf::from("/tmp/file.bk"));

Pushing an absolute path replaces the existing path:

use std::path::PathBuf;

let mut path = PathBuf::from("/tmp");
path.push("/etc");
assert_eq!(path, PathBuf::from("/etc"));

pub fn pop(&mut self) -> bool

Truncates self to self.parent.

Returns false and does nothing if self.parent is None. Otherwise, returns true.

Examples

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

let mut p = PathBuf::from("/test/test.rs");

p.pop();
assert_eq!(Path::new("/test"), p);
p.pop();
assert_eq!(Path::new("/"), p);

pub fn set_file_name<S>(&mut self, file_name: S) where
    S: AsRef<OsStr>, 

Updates self.file_name to file_name.

If self.file_name was None, this is equivalent to pushing file_name.

Otherwise it is equivalent to calling pop and then pushing file_name. The new path will be a sibling of the original path. (That is, it will have the same parent.)

Examples

use std::path::PathBuf;

let mut buf = PathBuf::from("/");
assert!(buf.file_name() == None);
buf.set_file_name("bar");
assert!(buf == PathBuf::from("/bar"));
assert!(buf.file_name().is_some());
buf.set_file_name("baz.txt");
assert!(buf == PathBuf::from("/baz.txt"));

pub fn set_extension<S>(&mut self, extension: S) -> bool where
    S: AsRef<OsStr>, 

Updates self.extension to extension.

Returns false and does nothing if self.file_name is None, returns true and updates the extension otherwise.

If self.extension is None, the extension is added; otherwise it is replaced.

Examples

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

let mut p = PathBuf::from("/feel/the");

p.set_extension("force");
assert_eq!(Path::new("/feel/the.force"), p.as_path());

p.set_extension("dark_side");
assert_eq!(Path::new("/feel/the.dark_side"), p.as_path());

pub fn capacity(&self) -> usize

🔬 This is a nightly-only experimental API. (path_buf_capacity)

Invokes capacity on the underlying instance of OsString.

pub fn clear(&mut self)

🔬 This is a nightly-only experimental API. (path_buf_capacity)

Invokes clear on the underlying instance of OsString.

pub fn reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (path_buf_capacity)

Invokes reserve on the underlying instance of OsString.

pub fn reserve_exact(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (path_buf_capacity)

Invokes reserve_exact on the underlying instance of OsString.

pub fn shrink_to_fit(&mut self)

🔬 This is a nightly-only experimental API. (path_buf_capacity)

Invokes shrink_to_fit on the underlying instance of OsString.

pub fn shrink_to(&mut self, min_capacity: usize)

🔬 This is a nightly-only experimental API. (path_buf_capacity)

Invokes shrink_to on the underlying instance of OsString.

Trait Implementations

impl Clone for PathDSL

fn clone(&self) -> PathDSL

Returns a copy of the value.

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

Performs copy-assignment from source.

impl AsRef<Path> for PathDSL

fn as_ref(&self) -> &Path

Performs the conversion.

impl Default for PathDSL

fn default() -> PathDSL

Returns the "default value" for a type.

impl<'_, T: ?Sized> From<&'_ T> for PathDSL where
    T: AsRef<Path>, 

fn from(other: &T) -> Self

Performs the conversion.

impl From<PathBuf> for PathDSL

fn from(other: PathBuf) -> Self

Performs the conversion.

impl From<OsString> for PathDSL

fn from(other: OsString) -> Self

Performs the conversion.

impl From<String> for PathDSL

fn from(other: String) -> Self

Performs the conversion.

impl From<Box<Path>> for PathDSL

fn from(other: Box<Path>) -> Self

Performs the conversion.

impl<'_> From<Cow<'_, Path>> for PathDSL

fn from(other: Cow<Path>) -> Self

Performs the conversion.

impl Into<OsString> for PathDSL

fn into(self) -> OsString

Performs the conversion.

impl Into<Box<Path>> for PathDSL

fn into(self) -> Box<Path>

Performs the conversion.

impl<'a> Into<Cow<'a, Path>> for PathDSL

fn into(self) -> Cow<'a, Path>

Performs the conversion.

impl<'a> Into<Cow<'a, Path>> for &'a PathDSL

fn into(self) -> Cow<'a, Path>

Performs the conversion.

impl<'a> Into<Arc<Path>> for PathDSL

fn into(self) -> Arc<Path>

Performs the conversion.

impl<'a> Into<Rc<Path>> for PathDSL

fn into(self) -> Rc<Path>

Performs the conversion.

impl AsMut<PathBuf> for PathDSL

fn as_mut(&mut self) -> &mut PathBuf

Performs the conversion.

impl DerefMut for PathDSL

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Debug for PathDSL

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

Formats the value using the given formatter.

impl Div<PathDSL> for PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: PathDSL) -> Self::Output

Performs the / operation.

impl<'_, T: ?Sized> Div<&'_ T> for PathDSL where
    T: AsRef<Path>, 

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: &T) -> Self::Output

Performs the / operation.

impl Div<OsString> for PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: OsString) -> Self::Output

Performs the / operation.

impl Div<String> for PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: String) -> Self::Output

Performs the / operation.

impl Div<PathBuf> for PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: PathBuf) -> Self::Output

Performs the / operation.

impl Div<Box<Path>> for PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: Box<Path>) -> Self::Output

Performs the / operation.

impl<'_> Div<Cow<'_, Path>> for PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: Cow<Path>) -> Self::Output

Performs the / operation.

impl<'_> Div<PathDSL> for &'_ PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: PathDSL) -> Self::Output

Performs the / operation.

impl<'_, '_, T: ?Sized> Div<&'_ T> for &'_ PathDSL where
    T: AsRef<Path>, 

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: &T) -> Self::Output

Performs the / operation.

impl<'_> Div<OsString> for &'_ PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: OsString) -> Self::Output

Performs the / operation.

impl<'_> Div<String> for &'_ PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: String) -> Self::Output

Performs the / operation.

impl<'_> Div<PathBuf> for &'_ PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: PathBuf) -> Self::Output

Performs the / operation.

impl<'_> Div<Box<Path>> for &'_ PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: Box<Path>) -> Self::Output

Performs the / operation.

impl<'_, '_> Div<Cow<'_, Path>> for &'_ PathDSL

type Output = PathDSL

The resulting type after applying the / operator.

fn div(self, rhs: Cow<Path>) -> Self::Output

Performs the / operation.

impl Deref for PathDSL

type Target = PathBuf

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.