2 releases

Uses old Rust 2015

0.2.1 Jun 2, 2022
0.2.0 May 15, 2022

#316 in Filesystem

Download history 6939/week @ 2023-12-13 3931/week @ 2023-12-20 2547/week @ 2023-12-27 4722/week @ 2024-01-03 18651/week @ 2024-01-10 44217/week @ 2024-01-17 47735/week @ 2024-01-24 60961/week @ 2024-01-31 60509/week @ 2024-02-07 68433/week @ 2024-02-14 64839/week @ 2024-02-21 61672/week @ 2024-02-28 21000/week @ 2024-03-06 14946/week @ 2024-03-13 14305/week @ 2024-03-20 8398/week @ 2024-03-27

70,192 downloads per month
Used in 79 crates (12 directly)


164 lines


crates.io version docs.rs docs license

clean-path is a safe fork of the path-clean crate.


cargo add clean-path


use std::path::{Path, PathBuf};
use clean_path::{clean, Clean};

assert_eq!(clean("foo/../../bar"), PathBuf::from("../bar"));
assert_eq!(Path::new("hello/world/..").clean(), PathBuf::from("hello"));


This fork aims to provide the same utility as path-clean, without using unsafe. Additionally, the api is improved (clean takes AsRef<Path> instead of just &str) and Clean is implemented on Path in addition to just PathBuf.

The main cleaning procedure is implemented using the methods provided by PathBuf, thus it should bring portability benefits over path-clean w.r.t. correctly handling cross-platform filepaths.

Additionally, the original implementation in path-clean is rather inscrutible, and as such if being able to inspect and understand the code is important to you, this crate provides a more readable implementation.

However, the current implementation is not highly-optimized, so if performance is top-priority, consider using path-clean instead.


The cleaning works as follows:

  1. Reduce multiple slashes to a single slash.
  2. Eliminate . path name elements (the current directory).
  3. Eliminate .. path name elements (the parent directory) and the non-. non-.., element that precedes them.
  4. Eliminate .. elements that begin a rooted path, that is, replace /.. by / at the beginning of a path.
  5. Leave intact .. elements that begin a non-rooted path.

If the result of this process is an empty string, return the string ".", representing the current directory.

This transformation is performed lexically, without touching the filesystem. Therefore it doesn't do any symlink resolution or absolute path resolution. For more information you can see "Getting Dot-Dot Right".

This functionality is exposed in the clean function and Clean trait implemented for std::path::PathBuf and std::path::Path.


MIT OR Apache-2.0

No runtime deps