home

Crates.iohome
lib.rshome
version0.5.9
sourcesrc
created_at2017-07-18 23:38:10.759249
updated_at2023-12-15 21:00:16.911277
descriptionShared definitions of home directories.
homepage
repositoryhttps://github.com/rust-lang/cargo
max_upload_size
id24000
size26,043
(rust-lang-owner)

documentation

https://docs.rs/home

README

Documentation crates.io

Canonical definitions of home_dir, cargo_home, and rustup_home.

This provides the definition of home_dir used by Cargo and rustup, as well functions to find the correct value of CARGO_HOME and RUSTUP_HOME.

The definition of home_dir provided by the standard library is incorrect because it considers the HOME environment variable on Windows. This causes surprising situations where a Rust program will behave differently depending on whether it is run under a Unix emulation environment like Cygwin or MinGW. Neither Cargo nor rustup use the standard library's definition - they use the definition here.

This crate further provides two functions, cargo_home and rustup_home, which are the canonical way to determine the location that Cargo and rustup store their data.

See rust-lang/rust#43321.

License

MIT OR Apache-2.0

Commit count: 18807

cargo fmt