1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
#![cfg(any(doc, all(unix, feature = "std")))]
use std::env;
use std::io;
#[cfg(not(doc))]
use std::os::unix::ffi::OsStrExt;
use std::path::{Path, PathBuf};
pub trait PosixPathExt: Sealed {
/// [Unix only] Make a POSIX path absolute without changing its semantics.
///
/// Unlike canonicalize the path does not need to exist. Symlinks and `..`
/// components will not be resolved.
///
/// # Example
///
/// ```
/// #[cfg(unix)]
/// {
/// use omnipath::posix::PosixPathExt;
/// use std::path::Path;
/// use std::env::current_dir;
///
/// let path = Path::new(r"path/to/..//./file");
/// assert_eq!(
/// path.posix_absolute().unwrap(),
/// current_dir().unwrap().join("path/to/../file")
/// )
/// }
/// ```
fn posix_absolute(&self) -> io::Result<PathBuf>;
}
impl PosixPathExt for Path {
fn posix_absolute(&self) -> io::Result<PathBuf> {
// This is mostly a wrapper around collecting `Path::components`, with
// exceptions made where this conflicts with the POSIX specification.
// See 4.13 Pathname Resolution, IEEE Std 1003.1-2017
// https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13
// Get the components, skipping the redundant leading "." component if it exists.
let mut components = self.strip_prefix(".").unwrap_or(self).components();
let path_os = self.as_os_str().as_bytes();
let mut normalized = if self.is_absolute() {
// "If a pathname begins with two successive <slash> characters, the
// first component following the leading <slash> characters may be
// interpreted in an implementation-defined manner, although more than
// two leading <slash> characters shall be treated as a single <slash>
// character."
if path_os.starts_with(b"//") && !path_os.starts_with(b"///") {
components.next();
PathBuf::from("//")
} else {
PathBuf::new()
}
} else {
env::current_dir()?
};
normalized.extend(components);
// "Interfaces using pathname resolution may specify additional constraints
// when a pathname that does not name an existing directory contains at
// least one non- <slash> character and contains one or more trailing
// <slash> characters".
// A trailing <slash> is also meaningful if "a symbolic link is
// encountered during pathname resolution".
if path_os.ends_with(b"/") {
normalized.push("");
}
Ok(normalized)
}
}
mod private {
pub trait Sealed {}
impl Sealed for std::path::Path {}
}
use private::Sealed;