12 releases

Uses old Rust 2015

0.4.1 Apr 30, 2023
0.4.0 Mar 3, 2023
0.3.7 Mar 17, 2022
0.3.6 Apr 23, 2021
0.3.4 Jul 28, 2019

#163 in Filesystem

Download history 609002/week @ 2024-01-25 629506/week @ 2024-02-01 634041/week @ 2024-02-08 602988/week @ 2024-02-15 608232/week @ 2024-02-22 636379/week @ 2024-02-29 661511/week @ 2024-03-07 676953/week @ 2024-03-14 672448/week @ 2024-03-21 613802/week @ 2024-03-28 614408/week @ 2024-04-04 619252/week @ 2024-04-11 627503/week @ 2024-04-18 609442/week @ 2024-04-25 617702/week @ 2024-05-02 502963/week @ 2024-05-09

2,468,559 downloads per month
Used in 5,793 crates (10 directly)


370 lines

crates.io API documentation actively developed License: MIT/Apache-2.0


System-level helper functions for the dirs and directories crates.

Do not use this library directly, use dirs or directories.


This crate only exists to facilitate code sharing between dirs and directories.

There are no compatibility guarantees whatsoever. Functions may change or disappear without warning or any kind of deprecation period.


This library is written in Rust, and supports Linux, Redox, macOS and Windows. Other platforms are also supported; they use the Linux conventions.


It's possible to cross-compile this library if the necessary toolchains are installed with rustup. This is helpful to ensure a change has not broken compilation on a different platform.

The following commands will build this library on Linux, macOS and Windows:

cargo build --target=x86_64-unknown-linux-gnu
cargo build --target=x86_64-pc-windows-gnu
cargo build --target=x86_64-apple-darwin
cargo build --target=x86_64-unknown-redox


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~89K SLoC