1 stable release
1.0.0 | Jul 23, 2024 |
---|
#587 in Filesystem
Used in 6 crates
25KB
353 lines
File Paths
Work with textual file paths, including relativity and resolution. Features:
- Variant:
FlexPath
methods consider absolute paths according to the path'sFlexPathVariant
. Two variants are supported:Common
andWindows
. The native variant can be deduced directly through_native
suffixed methods.
Requirements:
- The Rust standard library (
std
).
Example
use hydroperfox_filepaths::FlexPath;
assert_eq!("a", FlexPath::new_common("a/b").resolve("..").to_string());
assert_eq!("a", FlexPath::new_common("a/b/..").to_string());
assert_eq!("a/b/c/d/e", FlexPath::from_n_common(["a/b", "c/d", "e/f", ".."]).to_string());
assert_eq!("../../c/d", FlexPath::new_common("/a/b").relative("/c/d"))
lib.rs
:
Work with file paths by text only.
In the Windows operating system, absolute paths may either start with a drive letter followed by
a colon or an UNC path prefix (\\
). Therefore, this crate provides
a FlexPath
that is based on a variant ([FlexPathVariant]), which you don't need to always
specify. This variant indicates whether to interpret Windows absolute paths
or not.
There are two FlexPathVariant variants currently:
- Common
- Windows
The constant FlexPathVariant::NATIVE
is one of these variants
based on the target platform. For the Windows operating system, it
is always Windows. For other platforms, it's always Common.
Example
use hydroperfox_filepaths::FlexPath;
assert_eq!("a", FlexPath::new_common("a/b").resolve("..").to_string());
assert_eq!("a", FlexPath::new_common("a/b/..").to_string());
assert_eq!("a/b/c/d/e", FlexPath::from_n_common(["a/b", "c/d", "e/f", ".."]).to_string());
assert_eq!("../../c/d", FlexPath::new_common("/a/b").relative("/c/d"));
Dependencies
~2.4–4MB
~71K SLoC