sysdirs 0.9.4

Cross-platform system directory paths for iOS, macOS, Android, Linux, Windows and other Unix
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

//! Windows platform implementation
//!
//! TODO: Implement using Known Folders API for full correctness.
//! Currently uses environment variables as fallback.

use std::path::PathBuf;

// =============================================================================
// Helpers
// =============================================================================

fn home() -> Option<PathBuf> {
	std::env::var_os("USERPROFILE").map(PathBuf::from)
}

fn appdata_roaming() -> Option<PathBuf> {
	std::env::var_os("APPDATA").map(PathBuf::from)
}

fn appdata_local() -> Option<PathBuf> {
	std::env::var_os("LOCALAPPDATA").map(PathBuf::from)
}

// =============================================================================
// Directory implementations
// =============================================================================

pub fn home_dir() -> Option<PathBuf> {
	home()
}

pub fn cache_dir() -> Option<PathBuf> {
	appdata_local()
}

pub fn config_dir() -> Option<PathBuf> {
	appdata_roaming()
}

pub fn config_local_dir() -> Option<PathBuf> {
	appdata_local()
}

pub fn data_dir() -> Option<PathBuf> {
	appdata_roaming()
}

pub fn data_local_dir() -> Option<PathBuf> {
	appdata_local()
}

pub fn executable_dir() -> Option<PathBuf> {
	None
}

pub fn preference_dir() -> Option<PathBuf> {
	appdata_roaming()
}

pub fn runtime_dir() -> Option<PathBuf> {
	None
}

pub fn state_dir() -> Option<PathBuf> {
	None
}

pub fn audio_dir() -> Option<PathBuf> {
	home().map(|h| h.join("Music"))
}

pub fn desktop_dir() -> Option<PathBuf> {
	home().map(|h| h.join("Desktop"))
}

pub fn document_dir() -> Option<PathBuf> {
	home().map(|h| h.join("Documents"))
}

pub fn download_dir() -> Option<PathBuf> {
	home().map(|h| h.join("Downloads"))
}

pub fn font_dir() -> Option<PathBuf> {
	None
}

pub fn picture_dir() -> Option<PathBuf> {
	home().map(|h| h.join("Pictures"))
}

pub fn public_dir() -> Option<PathBuf> {
	std::env::var_os("PUBLIC").map(PathBuf::from)
}

pub fn template_dir() -> Option<PathBuf> {
	appdata_roaming().map(|a| a.join("Microsoft\\Windows\\Templates"))
}

pub fn video_dir() -> Option<PathBuf> {
	home().map(|h| h.join("Videos"))
}

// =============================================================================
// sysdirs extensions
// =============================================================================

pub fn temp_dir() -> Option<PathBuf> {
	std::env::var_os("TEMP")
		.or_else(|| std::env::var_os("TMP"))
		.map(PathBuf::from)
}

pub fn library_dir() -> Option<PathBuf> {
	None
}