Type Alias RelativePath

Source

pub type RelativePath = Path<Relative>;

Expand description

A path that is strictly relative.

I.e., this path is guaranteed to never be absolute.

RelativePaths cannot be easily converted into a std::path::Path by design. Other Nushell crates need to account for the emulated current working directory before passing a path to functions in std or other third party crates. You can join a RelativePath onto an AbsolutePath or a CanonicalPath. This will return an AbsolutePathBuf which can be referenced as a std::path::Path. If you really mean it, you can use as_relative_std_path to get the underlying std::path::Path from a RelativePath. But this may cause third-party code to use std::env::current_dir to resolve the path which is almost always incorrect behavior. Extra care is needed to ensure that this is not the case after using as_relative_std_path.

§Examples

RelativePaths can be created by using try_relative on a Path, by using try_new, or by using strip_prefix on a Path of any form.

use nu_path::{Path, RelativePath};

let path1 = Path::new("foo.txt");
let path1 = path1.try_relative().unwrap();

let path2 = RelativePath::try_new("foo.txt").unwrap();

let path3 = Path::new("/prefix/foo.txt").strip_prefix("/prefix").unwrap();

assert_eq!(path1, path2);
assert_eq!(path2, path3);

You can also use RelativePath::try_from or try_into. This supports attempted conversions from Path as well as types in std::path.

use nu_path::{Path, RelativePath};

let path1 = Path::new("foo.txt");
let path1: &RelativePath = path1.try_into().unwrap();

let path2 = std::path::Path::new("foo.txt");
let path2: &RelativePath = path2.try_into().unwrap();

assert_eq!(path1, path2)

Aliased Type§

struct RelativePath { /* private fields */ }

Type Alias RelativePathCopy item path

§Examples

Aliased Type§

Trait Implementations§

impl AsRef<Path> for Box<RelativePath>

fn as_ref(&self) -> &Path

impl<'a> PartialEq<&'a Path> for RelativePath

fn eq(&self, other: &&'a Path) -> bool

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

impl<'a, 'b> PartialEq<Cow<'a, Path>> for &'b RelativePath

fn eq(&self, other: &Cow<'a, Path>) -> bool

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

impl<'a> PartialEq<Cow<'a, Path>> for RelativePath

fn eq(&self, other: &Cow<'a, Path>) -> bool

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

impl<'a> PartialEq<Path> for &'a RelativePath

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

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

impl PartialEq<Path> for RelativePath

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

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

impl<'a> PartialEq<PathBuf> for &'a RelativePath

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

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

impl PartialEq<PathBuf> for RelativePath

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

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

impl<'a> PartialOrd<&'a Path> for RelativePath

fn partial_cmp(&self, other: &&'a Path) -> Option<Ordering>

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

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

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

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

impl<'a, 'b> PartialOrd<Cow<'a, Path>> for &'b RelativePath

fn partial_cmp(&self, other: &Cow<'a, Path>) -> Option<Ordering>

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

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

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

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

impl<'a> PartialOrd<Cow<'a, Path>> for RelativePath

fn partial_cmp(&self, other: &Cow<'a, Path>) -> Option<Ordering>

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

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

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

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

impl<'a> PartialOrd<Path> for &'a RelativePath

fn partial_cmp(&self, other: &Path) -> Option<Ordering>

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

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

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

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

impl PartialOrd<Path> for RelativePath

fn partial_cmp(&self, other: &Path) -> Option<Ordering>

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

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

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

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

impl<'a> PartialOrd<PathBuf> for &'a RelativePath

fn partial_cmp(&self, other: &PathBuf) -> Option<Ordering>

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

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

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

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

impl PartialOrd<PathBuf> for RelativePath

fn partial_cmp(&self, other: &PathBuf) -> Option<Ordering>

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

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

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

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

impl<'a> TryFrom<&'a Component<'_>> for &'a RelativePath

type Error = TryRelativeError

fn try_from(component: &'a Component<'_>) -> Result<Self, Self::Error>

impl<'a> TryFrom<&'a Components<'_>> for &'a RelativePath

type Error = TryRelativeError

fn try_from(components: &'a Components<'_>) -> Result<Self, Self::Error>

impl<'a> TryFrom<&'a Cow<'_, OsStr>> for &'a RelativePath

type Error = TryRelativeError

fn try_from(s: &'a Cow<'_, OsStr>) -> Result<Self, Self::Error>

impl<'a> TryFrom<&'a Iter<'_>> for &'a RelativePath

type Error = TryRelativeError

Type Alias RelativePath