This crate provides methods to normalize paths in the recommended way for the operating system.

It was made to fix a recurring bug caused by using fs::canonicalize on Windows: #45067, #48249, #52440, #55812, #58613, #59107, #74327. Normalization is usually a better choice unless you specifically need a canonical path.

Add the following lines to your "Cargo.toml" file:

[dependencies]
normpath = "1.3"

See the documentation for available functionality and examples.

The minimum supported Rust toolchain version is currently Rust 1.74.0.

Minor version updates may increase this version requirement. However, the previous two Rust releases will always be supported. If the minimum Rust version must not be increased, use a tilde requirement to prevent updating this crate's minor version:

[dependencies]
normpath = "~1.3"

Licensing terms are specified in COPYRIGHT.

Unless you explicitly state otherwise, any contribution submitted for inclusion in this crate, as defined in LICENSE-APACHE, shall be licensed according to COPYRIGHT, without any additional terms or conditions.

This crate includes copies and modifications of content developed by third parties:

• src/cmp.rs and tests/rust.rs contain modifications of code from The Rust Programming Language, licensed under the MIT License or the Apache License, Version 2.0.

• src/common/localize/macos/fruity.rs contains modifications of code from crate fruity, licensed under the MIT License or the Apache License, Version 2.0.

See those files for more details.

Copies of third-party licenses can be found in LICENSE-THIRD-PARTY.