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

//! Tests for Android initialization.
//!
//! Verifies that init_android() and init_android_with_cache() set paths correctly.

#![cfg(target_os = "android")]

use std::path::PathBuf;

#[test]
fn test_init_android_sets_paths() {
	sysdirs::init_android("/data/data/com.example.app/files");

	assert_eq!(
		sysdirs::home_dir(),
		Some(PathBuf::from("/data/data/com.example.app/files"))
	);
	assert_eq!(
		sysdirs::config_dir(),
		Some(PathBuf::from("/data/data/com.example.app/files"))
	);
	assert_eq!(
		sysdirs::data_dir(),
		Some(PathBuf::from("/data/data/com.example.app/files"))
	);
	// Default cache is files_dir + "/cache"
	assert_eq!(
		sysdirs::cache_dir(),
		Some(PathBuf::from("/data/data/com.example.app/files/cache"))
	);
}

#[test]
fn test_init_android_with_cache_sets_separate_cache() {
	sysdirs::init_android_with_cache(
		"/data/data/com.example.app/files",
		"/data/data/com.example.app/cache",
	);

	assert_eq!(
		sysdirs::home_dir(),
		Some(PathBuf::from("/data/data/com.example.app/files"))
	);
	// Cache should be the explicit path, not derived
	assert_eq!(
		sysdirs::cache_dir(),
		Some(PathBuf::from("/data/data/com.example.app/cache"))
	);
}

#[test]
fn test_temp_dir_derived_from_files() {
	sysdirs::init_android("/data/data/com.example.app/files");

	assert_eq!(
		sysdirs::temp_dir(),
		Some(PathBuf::from("/data/data/com.example.app/files/tmp"))
	);
}

#[test]
fn test_user_dirs_return_none_on_android() {
	sysdirs::init_android("/data/data/com.example.app/files");

	// Android doesn't expose user directories to native code
	assert_eq!(sysdirs::audio_dir(), None);
	assert_eq!(sysdirs::desktop_dir(), None);
	assert_eq!(sysdirs::document_dir(), None);
	assert_eq!(sysdirs::download_dir(), None);
	assert_eq!(sysdirs::picture_dir(), None);
	assert_eq!(sysdirs::public_dir(), None);
	assert_eq!(sysdirs::video_dir(), None);
}

#[test]
fn test_library_dir_none_on_android() {
	sysdirs::init_android("/data/data/com.example.app/files");

	// Library is an Apple concept
	assert_eq!(sysdirs::library_dir(), None);
}