use super::PackageArtifact;
use super::util::{copy_dir_recursive, copy_optional_file};
use crate::core::config::ResolvedCrateConfig;
use anyhow::{Context, Result};
use std::fs;
use std::path::Path;
const LINUX_BUILDING_MD: &str = "\
# Building on Linux\n\
\n\
The same `rust/` swift-bridge crate that drives the macOS/iOS XCFramework also\n\
builds on Linux. swift-bridge generates Swift glue files at build time; SwiftPM\n\
on Linux consumes them via the same `Package.swift` checked into this archive.\n\
\n\
## Steps\n\
\n\
1. Build the Rust shared library:\n\
\n\
```sh\n\
cd rust\n\
cargo build --release --target x86_64-unknown-linux-gnu\n\
# Or for ARM64 servers:\n\
cargo build --release --target aarch64-unknown-linux-gnu\n\
```\n\
\n\
2. The build script (`rust/build.rs`) writes Swift glue into `OUT_DIR`. Surface it\n\
to SwiftPM by symlinking or copying into `Sources/<Module>/generated/`.\n\
\n\
3. Build and test the Swift package:\n\
\n\
```sh\n\
swift build -c release\n\
swift test\n\
```\n\
\n\
Linux Swift consumers (e.g., Vapor servers) link the resulting `.so` directly\n\
through SwiftPM — no XCFramework involvement. The `LD_LIBRARY_PATH` export is\n\
required because SwiftPM does not auto-discover Cargo's `target/release/` output\n\
at runtime; without it, `swift test` fails with a dynamic linker error.\n\
";
const BUILDING_MD: &str = "\
# Building the XCFramework\n\
\n\
Real XCFramework creation requires `xcodebuild` and must be performed on a macOS host\n\
after compiling the Rust crate for all desired Apple targets.\n\
\n\
## Steps\n\
\n\
1. Build the Rust crate for each target slice, e.g.:\n\
\n\
```sh\n\
cargo build --release --target aarch64-apple-ios\n\
cargo build --release --target x86_64-apple-ios-simulator\n\
cargo build --release --target aarch64-apple-darwin\n\
```\n\
\n\
2. Create a fat library for the simulator slice (optional):\n\
\n\
```sh\n\
lipo -create \\\n\
target/x86_64-apple-ios-simulator/release/libmy_lib.a \\\n\
target/aarch64-apple-ios-simulator/release/libmy_lib.a \\\n\
-output libmy_lib_simulator.a\n\
```\n\
\n\
3. Assemble the XCFramework:\n\
\n\
```sh\n\
xcodebuild -create-xcframework \\\n\
-library target/aarch64-apple-ios/release/libmy_lib.a \\\n\
-headers include/ \\\n\
-library libmy_lib_simulator.a \\\n\
-headers include/ \\\n\
-output MyLib.xcframework\n\
```\n\
\n\
4. Compress and compute checksum:\n\
\n\
```sh\n\
zip -r MyLib.xcframework.zip MyLib.xcframework\n\
swift package compute-checksum MyLib.xcframework.zip\n\
```\n\
\n\
The `Package.swift` in this archive references `XCFramework.xcframework/`; replace\n\
this placeholder with the real framework after completing the above steps.\n\
";
pub fn package_swift(
config: &ResolvedCrateConfig,
workspace_root: &Path,
output_dir: &Path,
version: &str,
) -> Result<PackageArtifact> {
let module = config.swift_module();
let pkg_dir = config.package_dir(crate::core::config::extras::Language::Swift);
let pkg_name = format!("{module}-{version}");
let staging = output_dir.join(&pkg_name);
if staging.exists() {
fs::remove_dir_all(&staging)?;
}
fs::create_dir_all(&staging)?;
let pkg_src = workspace_root.join(&pkg_dir);
if !pkg_src.exists() {
anyhow::bail!("Swift package directory not found: {}", pkg_dir);
}
copy_dir_recursive(&pkg_src, &staging).context("copying Swift package directory")?;
let root_manifest = workspace_root.join("Package.swift");
if root_manifest.exists() {
fs::copy(&root_manifest, staging.join("Package.swift")).context("copying root Swift Package.swift")?;
}
patch_root_package_manifest(&staging, version).context("patching root Swift Package.swift")?;
let xcframework_dir = staging.join("xcframework");
fs::create_dir_all(&xcframework_dir).context("creating xcframework placeholder directory")?;
fs::write(xcframework_dir.join("BUILDING.md"), BUILDING_MD).context("writing xcframework/BUILDING.md")?;
let linux_dir = staging.join("linux");
fs::create_dir_all(&linux_dir).context("creating linux build instructions directory")?;
fs::write(linux_dir.join("BUILDING.md"), LINUX_BUILDING_MD).context("writing linux/BUILDING.md")?;
for filename in ["README.md", "CHANGELOG.md", "LICENSE"] {
copy_optional_file(workspace_root, filename, &staging)
.with_context(|| format!("staging {filename} for Swift package"))?;
}
let archive_name = format!("{pkg_name}.tar.gz");
let archive_path = output_dir.join(&archive_name);
super::create_tar_gz(&staging, &archive_path)?;
fs::remove_dir_all(&staging).ok();
Ok(PackageArtifact {
path: archive_path,
name: archive_name,
checksum: None,
})
}
fn patch_root_package_manifest(staging: &Path, version: &str) -> Result<()> {
let manifest = staging.join("Package.swift");
if !manifest.exists() {
return Ok(());
}
let mut content = fs::read_to_string(&manifest).context("reading staged Package.swift")?;
content = content.replace("__ALEF_SWIFT_VERSION__", version);
if content.contains("__ALEF_SWIFT_CHECKSUM__") {
let checksum = std::env::var("ALEF_SWIFT_CHECKSUM")
.or_else(|_| std::env::var("SWIFT_ARTIFACT_CHECKSUM"))
.context("ALEF_SWIFT_CHECKSUM must be set when Package.swift contains __ALEF_SWIFT_CHECKSUM__")?;
content = content.replace("__ALEF_SWIFT_CHECKSUM__", &checksum);
}
fs::write(&manifest, content).context("writing staged Package.swift")?;
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
use crate::core::config::{NewAlefConfig, ResolvedCrateConfig};
use std::fs;
fn minimal_config(name: &str) -> ResolvedCrateConfig {
let toml = format!(
r#"
[workspace]
languages = ["swift"]
[[crates]]
name = "{name}"
sources = []
"#
);
let cfg: NewAlefConfig = toml::from_str(&toml).expect("valid config");
cfg.resolve().unwrap().remove(0)
}
#[test]
fn package_swift_errors_when_pkg_dir_missing() {
let config = minimal_config("my-lib");
let tmp = tempfile::tempdir().expect("tempdir");
let output = tmp.path().join("out");
fs::create_dir_all(&output).unwrap();
let err = package_swift(&config, tmp.path(), &output, "0.1.0").unwrap_err();
assert!(
err.to_string().contains("Swift package directory not found"),
"unexpected error: {err}"
);
}
#[test]
fn package_swift_produces_tarball() {
let config = minimal_config("my-lib");
let tmp = tempfile::tempdir().expect("tempdir");
let swift_pkg = tmp.path().join("packages/swift");
fs::create_dir_all(swift_pkg.join("Sources/MyLib")).unwrap();
fs::write(swift_pkg.join("Package.swift"), "// swift-tools-version:5.9\n").unwrap();
fs::write(swift_pkg.join("Sources/MyLib/MyLib.swift"), "public struct MyLib {}\n").unwrap();
let output = tmp.path().join("out");
fs::create_dir_all(&output).unwrap();
let artifact = package_swift(&config, tmp.path(), &output, "0.1.0").unwrap();
assert!(artifact.path.exists(), "tarball should exist");
assert_eq!(artifact.name, "MyLib-0.1.0.tar.gz");
}
#[test]
fn package_swift_module_name_from_config() {
let toml = r#"
[workspace]
languages = ["swift"]
[[crates]]
name = "my-lib"
sources = []
[crates.swift]
module_name = "AlefCore"
"#;
let cfg: NewAlefConfig = toml::from_str(toml).expect("valid config");
let config = cfg.resolve().unwrap().remove(0);
let tmp = tempfile::tempdir().expect("tempdir");
let swift_pkg = tmp.path().join("packages/swift");
fs::create_dir_all(&swift_pkg).unwrap();
fs::write(swift_pkg.join("Package.swift"), "// swift-tools-version:5.9\n").unwrap();
let output = tmp.path().join("out");
fs::create_dir_all(&output).unwrap();
let artifact = package_swift(&config, tmp.path(), &output, "1.2.3").unwrap();
assert_eq!(artifact.name, "AlefCore-1.2.3.tar.gz");
}
#[test]
fn patch_root_package_manifest_replaces_release_placeholders() {
let tmp = tempfile::tempdir().expect("tempdir");
let manifest = tmp.path().join("Package.swift");
fs::write(
&manifest,
r#"url: "https://example.test/releases/download/v__ALEF_SWIFT_VERSION__/Demo.zip",
checksum: "__ALEF_SWIFT_CHECKSUM__"
"#,
)
.unwrap();
unsafe {
std::env::set_var("ALEF_SWIFT_CHECKSUM", "abc123");
}
patch_root_package_manifest(tmp.path(), "1.2.3").unwrap();
unsafe {
std::env::remove_var("ALEF_SWIFT_CHECKSUM");
}
let content = fs::read_to_string(manifest).unwrap();
assert!(
content.contains("v1.2.3"),
"version placeholder must be replaced: {content}"
);
assert!(
content.contains("abc123"),
"checksum placeholder must be replaced: {content}"
);
assert!(
!content.contains("__ALEF_SWIFT_"),
"no Swift placeholders should remain: {content}"
);
}
}