astu 0.0.0

Astu library
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

//! Wrapper for getting default data storage paths.
//!
//! Follows these rules:
//!
//! - XDG base directory (all platforms if environment variable is set)
//! - Platform-specific well known directory (see [`dirs`])
//! - Home directory
//! - Current directory

use std::env;
use std::path::PathBuf;

const XDG_CONFIG_HOME: &str = "XDG_CONFIG_HOME";
const XDG_DATA_HOME: &str = "XDG_DATA_HOME";

/// Gets the config directory. Creates it if it does not exist.
///
/// # Panics
///
/// If none of the rules succeeds.
#[must_use]
pub fn config_dir(name: &str) -> PathBuf {
    let dir = if let Ok(path) = env::var(XDG_CONFIG_HOME) {
        PathBuf::from(path).join(name)
    } else if let Some(path) = dirs::config_dir() {
        path.join(name)
    } else if let Some(path) = dirs::home_dir() {
        path.join(format!(".{name}"))
    } else if let Ok(path) = env::current_dir() {
        path.join(format!(".{name}"))
    } else {
        panic!("all sources for config dir failed");
    };
    std::fs::create_dir_all(&dir).expect("unable to ensure config dir exists");
    dir
}

/// Gets the data directory. Creates it if it does not exist.
///
/// # Panics
///
/// If none of the rules succeeds.
#[must_use]
pub fn data_dir(name: &str) -> PathBuf {
    let dir = if let Ok(path) = env::var(XDG_DATA_HOME) {
        PathBuf::from(path).join(name)
    } else if let Some(path) = dirs::data_dir() {
        path.join(name)
    } else if let Some(path) = dirs::home_dir() {
        path.join(format!(".{name}"))
    } else if let Ok(path) = env::current_dir() {
        path.join(format!(".{name}"))
    } else {
        panic!("all sources for data dir failed");
    };
    std::fs::create_dir_all(&dir).expect("unable to ensure data dir exists");
    dir
}