opencode-cloud-core 25.1.3

Core library for opencode-cloud - config management, singleton enforcement, and shared utilities
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
117
118
119
120
121
122

//! XDG-compliant path resolution for opencode-cloud
//!
//! Provides consistent path resolution across platforms:
//! - Linux/macOS: ~/.config/opencode-cloud/ and ~/.local/share/opencode-cloud/
//! - Windows: %APPDATA%\opencode-cloud\ and %LOCALAPPDATA%\opencode-cloud\

use std::path::PathBuf;

/// Get the configuration directory path
///
/// Returns the directory where config.json should be stored:
/// - Linux: `~/.config/opencode-cloud/`
/// - macOS: `~/.config/opencode-cloud/` (XDG-style, not ~/Library)
/// - Windows: `%APPDATA%\opencode-cloud\`
pub fn get_config_dir() -> Option<PathBuf> {
    #[cfg(any(target_os = "linux", target_os = "macos"))]
    {
        directories::BaseDirs::new()
            .map(|dirs| dirs.home_dir().join(".config").join("opencode-cloud"))
    }
    #[cfg(target_os = "windows")]
    {
        directories::BaseDirs::new()
            .and_then(|dirs| dirs.config_dir().map(|d| d.to_path_buf()))
            .map(|d| d.join("opencode-cloud"))
    }
    #[cfg(not(any(target_os = "linux", target_os = "macos", target_os = "windows")))]
    {
        None
    }
}

/// Get the data directory path
///
/// Returns the directory where runtime data (PID file, logs, etc.) should be stored:
/// - Linux: `~/.local/share/opencode-cloud/`
/// - macOS: `~/.local/share/opencode-cloud/` (XDG-style, not ~/Library)
/// - Windows: `%LOCALAPPDATA%\opencode-cloud\`
pub fn get_data_dir() -> Option<PathBuf> {
    #[cfg(any(target_os = "linux", target_os = "macos"))]
    {
        directories::BaseDirs::new().map(|dirs| {
            dirs.home_dir()
                .join(".local")
                .join("share")
                .join("opencode-cloud")
        })
    }
    #[cfg(target_os = "windows")]
    {
        directories::BaseDirs::new()
            .and_then(|dirs| dirs.data_local_dir().map(|d| d.to_path_buf()))
            .map(|d| d.join("opencode-cloud"))
    }
    #[cfg(not(any(target_os = "linux", target_os = "macos", target_os = "windows")))]
    {
        None
    }
}

/// Get the full path to the config file
///
/// Returns: `{config_dir}/config.json`
pub fn get_config_path() -> Option<PathBuf> {
    get_config_dir().map(|d| d.join("config.json"))
}

/// Get the full path to the PID lock file
///
/// Returns: `{data_dir}/opencode-cloud.pid`
pub fn get_pid_path() -> Option<PathBuf> {
    get_data_dir().map(|d| d.join("opencode-cloud.pid"))
}

/// Get the full path to the hosts configuration file
///
/// Returns: `{config_dir}/hosts.json`
pub fn get_hosts_path() -> Option<PathBuf> {
    get_config_dir().map(|d| d.join("hosts.json"))
}

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

    #[test]
    fn test_config_dir_exists() {
        let dir = get_config_dir();
        assert!(dir.is_some());
        let path = dir.unwrap();
        assert!(path.ends_with("opencode-cloud"));
    }

    #[test]
    fn test_data_dir_exists() {
        let dir = get_data_dir();
        assert!(dir.is_some());
        let path = dir.unwrap();
        assert!(path.ends_with("opencode-cloud"));
    }

    #[test]
    fn test_config_path_ends_with_config_json() {
        let path = get_config_path();
        assert!(path.is_some());
        assert!(path.unwrap().ends_with("config.json"));
    }

    #[test]
    fn test_pid_path_ends_with_pid() {
        let path = get_pid_path();
        assert!(path.is_some());
        assert!(path.unwrap().ends_with("opencode-cloud.pid"));
    }

    #[test]
    fn test_hosts_path_ends_with_hosts_json() {
        let path = get_hosts_path();
        assert!(path.is_some());
        assert!(path.unwrap().ends_with("hosts.json"));
    }
}