Crate xdg_user

This simple crate allows you to get paths to well known user directories, using xdg-user-dirss user-dirs.dirs file.

There are two ways of using this crate - with functions in the root of the crate, or with the UserDirs struct. UserDirs will read and parse the config file only once - when you call the UserDirs::new function. Functions in the root will read and parse the config file EVERY TIME you call them - so use them ONLY if you need to get one or two folders one or two times.

Example

println!("Pictures folder: {:?}", xdg_user::pictures()?);
println!("Music folder:    {:?}", xdg_user::music()?);

let dirs = xdg_user::UserDirs::new()?;
println!("Documents folder: {:?}", dirs.documents());
println!("Downloads folder: {:?}", dirs.downloads());

Structs

UserDirs

This crates main and only struct, allows you to access the paths to all the user directories

Enums

Error

This crates main and only error type

Functions

desktop

Returns an absolute path to users desktop directory (XDG_DESKTOP_DIR), if found

documents

Returns an absolute path to users documents directory (XDG_DOCUMENTS_DIR), if found

downloads

Returns an absolute path to users downloads directory (XDG_DOWNLOAD_DIR), if found

music

Returns an absolute path to users music directory (XDG_MUSIC_DIR), if found

pictures

Returns an absolute path to users pictures directory (XDG_PICTURES_DIR), if found

public

Returns an absolute path to users public share directory (XDG_PUBLICSHARE_DIR), if found

templates

Returns an absolute path to users templates directory (XDG_TEMPLATES_DIR), if found

videos

Returns an absolute path to users videos directory (XDG_VIDEOS_DIR), if found