#directories #low-level #function #helper #dirs-next #fork #path


system-level helper functions for the dirs and directories crates

3 releases

0.1.2 Jan 9, 2021
0.1.1 Oct 13, 2020
0.1.0 May 7, 2020
0.0.0 May 6, 2020

#955 in Filesystem

Download history 477707/week @ 2024-03-14 489802/week @ 2024-03-21 475581/week @ 2024-03-28 519208/week @ 2024-04-04 491977/week @ 2024-04-11 499953/week @ 2024-04-18 476488/week @ 2024-04-25 475996/week @ 2024-05-02 476099/week @ 2024-05-09 509545/week @ 2024-05-16 479333/week @ 2024-05-23 509939/week @ 2024-05-30 476430/week @ 2024-06-06 508779/week @ 2024-06-13 503780/week @ 2024-06-20 400159/week @ 2024-06-27

1,980,992 downloads per month
Used in 3,534 crates (3 directly)


355 lines

crates.io API documentation


NOTE: This crate is a fork of once-abandoned dirs-sys crate.

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


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

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.

Minimum Rust version policy

The minimal required version of Rust is 1.34.0^.

We may bump the Rust version in major and minor releases (x/y in x.y.z). Changing the Rust version will be written in the CHANGELOG.

^ Except for Redox, where the Rust version depends on the redox_users crate.


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.