src/platform/linux.rs - master - dcr_labs/dcr

src/platform/linux.rs
126 строк4 KB
Dexoron
docs: add and clean up AI-generated rustdoc comments (grok-4.5)
05 авг 2026, 14:21
05 авг 2026, 14:21a20c61c
// DCR — Cargo-like C/C++ project manager.
//
// Copyright (C) 2026 Dexoron (Bezotechestvo Vladimir) <main@dexoron.su>
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

use super::path_util::{default_bin_rel, default_lib_rel, join_dir};
use crate::utils::build::default_target_triple;

/// Returns the default target triple string for the host platform.
fn host_triple() -> String {
    default_target_triple()
}

/// Constructs the path to a binary executable.
/// If `target_dir` is provided, joins it with the name; otherwise uses default_bin_rel with the host triple.
pub fn bin_path(profile: &str, name: &str, target_dir: Option<&str>) -> String {
    match target_dir {
        Some(dir) => join_dir(dir, name),
        None => default_bin_rel(profile, name, Some(&host_triple())),
    }
}

/// Constructs the path to a static library archive.
pub fn lib_path(profile: &str, name: &str, target_dir: Option<&str>) -> String {
    let file = format!("lib{name}.a");
    match target_dir {
        Some(dir) => join_dir(dir, &file),
        None => default_lib_rel(profile, &file, Some(&host_triple())),
    }
}

/// Constructs the path to an ELF binary.
pub fn elf_path(profile: &str, name: &str, target_dir: Option<&str>) -> String {
    bin_path(profile, name, target_dir)
}

/// Constructs the path to an EFI binary.
pub fn efi_path(profile: &str, name: &str, target_dir: Option<&str>) -> String {
    let file = format!("{name}.efi");
    match target_dir {
        Some(dir) => join_dir(dir, &file),
        None => default_lib_rel(profile, &file, Some(&host_triple())),
    }
}

/// Constructs the path to a shared library.
pub fn shared_lib_path(profile: &str, name: &str, target_dir: Option<&str>) -> String {
    let file = format!("lib{name}.so");
    match target_dir {
        Some(dir) => join_dir(dir, &file),
        None => default_lib_rel(profile, &file, Some(&host_triple())),
    }
}

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

    #[test]
    fn bin_path_default() {
        let expected = default_bin_rel("debug", "hello", Some(&host_triple()));
        assert_eq!(bin_path("debug", "hello", None), expected);
    }

    #[test]
    fn bin_path_release() {
        let expected = default_bin_rel("release", "hello", Some(&host_triple()));
        assert_eq!(bin_path("release", "hello", None), expected);
    }

    #[test]
    fn bin_path_custom_target() {
        assert_eq!(
            bin_path("debug", "hello", Some("out")),
            join_dir("out", "hello")
        );
    }

    #[test]
    fn bin_path_custom_target_trailing_slash() {
        assert_eq!(
            bin_path("debug", "hello", Some("out/")),
            join_dir("out/", "hello")
        );
    }

    #[test]
    fn lib_path_default() {
        let expected = default_lib_rel("debug", "libmylib.a", Some(&host_triple()));
        assert_eq!(lib_path("debug", "mylib", None), expected);
    }

    #[test]
    fn lib_path_custom_target() {
        assert_eq!(
            lib_path("debug", "mylib", Some("out")),
            join_dir("out", "libmylib.a")
        );
    }

    #[test]
    fn shared_lib_path_default() {
        let expected = default_lib_rel("debug", "libmylib.so", Some(&host_triple()));
        assert_eq!(shared_lib_path("debug", "mylib", None), expected);
    }

    #[test]
    fn shared_lib_path_custom_target() {
        assert_eq!(
            shared_lib_path("release", "mylib", Some("dist")),
            join_dir("dist", "libmylib.so")
        );
    }
}