8 releases

0.1.6 May 12, 2023
0.1.5 Mar 25, 2023
0.1.1 Oct 20, 2022
0.0.0 Sep 27, 2022

#160 in Filesystem

Download history 2228/week @ 2024-02-26 2539/week @ 2024-03-04 1776/week @ 2024-03-11 2106/week @ 2024-03-18 2113/week @ 2024-03-25 2512/week @ 2024-04-01 2390/week @ 2024-04-08 2066/week @ 2024-04-15 1908/week @ 2024-04-22 2225/week @ 2024-04-29 2115/week @ 2024-05-06 1984/week @ 2024-05-13 1863/week @ 2024-05-20 1559/week @ 2024-05-27 1484/week @ 2024-06-03 1322/week @ 2024-06-10

6,441 downloads per month
Used in 67 crates (via nu-path)

MIT/Apache

46KB
797 lines

A path handling library for Rust. See the api docs!

Quick tour

The sys_absolute function is similar to std::fs::canonicalize but doesn't require accessing the filesystem.

// Normalizes the path and makes it absolute.
// On Windows platforms this will use `\` as the path separator.
let absolute = omnipath::sys_absolute("path/to/.//file".as_ref());

The sys_canonicalize function is almost the same std::fs::canonicalize except that it will try to return an non-verbatim path on Windows.

// On Windows this returns r"C:\path\to\file" instead of `\\?\C:\path\file`
let canonical = omnipath::sys_absolute(r"C:\path\to\file".as_ref());

Platform-specific functions

The traits PosixPathExt and WinPathExt provide platform specific extension traits for std::path::Path. For example, on Windows they allow converting to a user path (useful for displaying a path to the user without the \\?\ part) or as a verbatim path

No runtime deps

Features