alef 0.25.27

Opinionated polyglot binding generator for Rust libraries
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

//! Shared utilities for the package sub-modules.

use crate::publish::platform::{Os, RustTarget};
use anyhow::{Context, Result};
use std::fs;
use std::path::Path;
use std::process::Command;

/// Recursively copy a directory tree, skipping hidden dirs and common build artifacts.
///
/// Skips:
/// - Any entry whose name starts with `.`
/// - `target`, `node_modules`, `__pycache__`, `.git`, `zig-cache`
pub fn copy_dir_recursive(src: &Path, dst: &Path) -> Result<()> {
    for entry in fs::read_dir(src).context("reading source directory")? {
        let entry = entry?;
        let path = entry.path();
        let file_name = entry.file_name();
        let dest_path = dst.join(&file_name);

        if path.is_dir() {
            let name = file_name.to_string_lossy();
            if name.starts_with('.') {
                continue;
            }
            if matches!(
                name.as_ref(),
                "target" | "node_modules" | "__pycache__" | ".git" | "zig-cache"
            ) {
                continue;
            }
            fs::create_dir_all(&dest_path)?;
            copy_dir_recursive(&path, &dest_path)?;
        } else {
            fs::copy(&path, &dest_path)?;
        }
    }
    Ok(())
}

/// Copy an optional top-level file (README, CHANGELOG, LICENSE) from workspace_root into dst.
///
/// Silently skips the copy if the file does not exist.
pub fn copy_optional_file(workspace_root: &Path, filename: &str, dst: &Path) -> Result<()> {
    let src = workspace_root.join(filename);
    if src.exists() {
        fs::copy(&src, dst.join(filename)).with_context(|| format!("copying {filename}"))?;
    }
    Ok(())
}

/// Rewrite a macOS dylib install name from the absolute CI build path to `@rpath/<name>`.
///
/// On non-macOS targets this is a no-op. Callers must invoke this immediately after copying
/// the `.dylib` into its package staging directory so that consumers can locate the library
/// via `@rpath` rather than the absolute runner path baked in during the cross-compile step.
pub(super) fn fix_macos_dylib_id(target: &RustTarget, path: &Path, shared_lib: &str) -> Result<()> {
    if target.os != Os::MacOs {
        return Ok(());
    }
    let status = Command::new("install_name_tool")
        .arg("-id")
        .arg(format!("@rpath/{shared_lib}"))
        .arg(path)
        .status()
        .with_context(|| format!("running install_name_tool for {}", path.display()))?;
    if !status.success() {
        anyhow::bail!("install_name_tool failed for {}", path.display());
    }
    Ok(())
}