git-paw 0.3.0

Parallel AI Worktrees — orchestrate multiple AI coding CLI sessions across git worktrees
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

//! Platform directory helpers.
//!
//! Provides XDG-compatible data and config directory resolution without
//! external dependencies. Matches the behaviour of the `dirs` crate:
//!
//! | Platform | Config dir                        | Data dir                          |
//! |----------|-----------------------------------|-----------------------------------|
//! | Linux    | `$XDG_CONFIG_HOME` or `~/.config` | `$XDG_DATA_HOME` or `~/.local/share` |
//! | macOS    | `~/Library/Application Support`   | `~/Library/Application Support`   |

use std::path::PathBuf;

/// Returns the user's home directory, or `None` if it cannot be determined.
fn home_dir() -> Option<PathBuf> {
    std::env::var_os("HOME").map(PathBuf::from)
}

/// Returns the platform config directory.
///
/// - **Linux:** `$XDG_CONFIG_HOME` or `~/.config`
/// - **macOS:** `~/Library/Application Support`
pub fn config_dir() -> Option<PathBuf> {
    #[cfg(target_os = "macos")]
    {
        home_dir().map(|h| h.join("Library/Application Support"))
    }
    #[cfg(not(target_os = "macos"))]
    {
        std::env::var_os("XDG_CONFIG_HOME")
            .map(PathBuf::from)
            .filter(|p| p.is_absolute())
            .or_else(|| home_dir().map(|h| h.join(".config")))
    }
}

/// Returns the platform data directory.
///
/// - **Linux:** `$XDG_DATA_HOME` or `~/.local/share`
/// - **macOS:** `~/Library/Application Support`
pub fn data_dir() -> Option<PathBuf> {
    #[cfg(target_os = "macos")]
    {
        home_dir().map(|h| h.join("Library/Application Support"))
    }
    #[cfg(not(target_os = "macos"))]
    {
        std::env::var_os("XDG_DATA_HOME")
            .map(PathBuf::from)
            .filter(|p| p.is_absolute())
            .or_else(|| home_dir().map(|h| h.join(".local/share")))
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn config_dir_returns_some_when_home_is_set() {
        // HOME is always set in test environments
        let dir = config_dir();
        assert!(dir.is_some(), "config_dir should return Some");
        assert!(dir.unwrap().is_absolute(), "config_dir should be absolute");
    }

    #[test]
    fn data_dir_returns_some_when_home_is_set() {
        let dir = data_dir();
        assert!(dir.is_some(), "data_dir should return Some");
        assert!(dir.unwrap().is_absolute(), "data_dir should be absolute");
    }

    #[test]
    fn config_and_data_dirs_live_under_home() {
        let home = home_dir().expect("HOME should be set in tests");
        let config = config_dir().unwrap();
        let data = data_dir().unwrap();
        assert!(
            config.starts_with(&home),
            "config_dir {config:?} should be under HOME {home:?}"
        );
        assert!(
            data.starts_with(&home),
            "data_dir {data:?} should be under HOME {home:?}"
        );
    }

    #[test]
    fn config_and_data_dirs_are_distinct_from_home() {
        let home = home_dir().unwrap();
        let config = config_dir().unwrap();
        let data = data_dir().unwrap();
        assert_ne!(config, home, "config_dir should not be HOME itself");
        assert_ne!(data, home, "data_dir should not be HOME itself");
    }
}