config-get 0.1.7

Cross-platform configuration file locator and reader for Rust. Auto-discovers .env, .ini, .toml, .json, .yml, .yaml from OS-standard locations.
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

use std::path::PathBuf;

/// Returns a prioritised list of directories to search for configuration files.
///
/// ### Windows
/// 1. `%APPDATA%\<config_dir>\`
/// 2. `%USERPROFILE%\<config_dir>\`
/// 3. `%APPDATA%\`
/// 4. `%USERPROFILE%\`
/// 5. Current working directory
///
/// ### Linux / macOS
/// 1. `~/<config_dir>/`
/// 2. `~/.config/<config_dir>/`
/// 3. `~/.config/`
/// 4. `~/`
/// 5. Current working directory
#[must_use]
pub fn search_dirs(config_dir: &str) -> Vec<PathBuf> {
    let mut dirs: Vec<PathBuf> = Vec::new();

    #[cfg(target_os = "windows")]
    {
        if let Some(app_data) = dirs::data_dir() {
            dirs.push(app_data.join(config_dir));
            dirs.push(app_data);
        }
        if let Some(home) = dirs::home_dir() {
            dirs.push(home.join(config_dir));
            dirs.push(home);
        }
    }

    #[cfg(not(target_os = "windows"))]
    {
        if let Some(home) = dirs::home_dir() {
            dirs.push(home.join(config_dir));
            dirs.push(home.join(".config").join(config_dir));
            dirs.push(home.join(".config"));
            dirs.push(home);
        }
    }

    if let Ok(cwd) = std::env::current_dir() {
        dirs.push(cwd);
    }

    let mut seen = std::collections::HashSet::new();
    dirs.retain(|p| seen.insert(p.clone()));

    dirs
}