maclarian 0.1.3

Larian file format library for Baldur's Gate 3 - PAK, LSF, LSX, GR2, DDS, and more
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

//! Path helpers for BG3 data locations

use std::path::{Path, PathBuf};

/// Default BG3 data path on macOS
pub const BG3_DATA_PATH_MACOS: &str = "~/Library/Application Support/Steam/steamapps/common/Baldurs Gate 3/Baldur's Gate 3.app/Contents/Data";

/// Default BG3 data path on Linux
pub const BG3_DATA_PATH_LINUX: &str = "~/.steam/steam/steamapps/common/Baldurs Gate 3/Data";

/// Get the expanded BG3 data path for the current platform (resolves ~)
#[must_use]
pub fn bg3_data_path() -> Option<PathBuf> {
    let home = std::env::var("HOME").ok()?;

    #[cfg(target_os = "macos")]
    {
        Some(PathBuf::from(BG3_DATA_PATH_MACOS.replace('~', &home)))
    }

    #[cfg(target_os = "linux")]
    {
        Some(PathBuf::from(BG3_DATA_PATH_LINUX.replace('~', &home)))
    }

    #[cfg(not(any(target_os = "macos", target_os = "linux")))]
    {
        None
    }
}

/// Get the path to VirtualTextures.pak
#[must_use]
pub fn virtual_textures_pak_path() -> Option<PathBuf> {
    bg3_data_path().map(|p| p.join("VirtualTextures.pak"))
}

/// Replace home directory with ~ in a path string
#[must_use]
pub fn path_with_tilde(path: &Path) -> String {
    let path_str = path.to_string_lossy();
    if let Ok(home) = std::env::var("HOME") {
        path_str.replace(&home, "~")
    } else {
        path_str.to_string()
    }
}

/// Expand ~ to home directory in a path string
#[must_use]
pub fn expand_tilde(path: &str) -> String {
    if let Ok(home) = std::env::var("HOME") {
        path.replace('~', &home)
    } else {
        path.to_string()
    }
}