Crate clean_path

source · [−]
Expand description

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

About

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. However, the current implementation is not highly-optimized, so if performance is top-priority, consider using path-clean instead.

Specification

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.

Example

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"));
assert_eq!(
    PathBuf::from("/test/../path/").clean(),
    PathBuf::from("/path")
);

Traits

Clean

The Clean trait implements the clean method.

Functions

clean

Clean the given path to according to a set of rules: