README.md

anotherBuildStep (a.k.a aBS)

Overview

anotherBuildStep is a project designed to leverage the Zig build system (build.zig) for building projects with various other toolchains. This allows developers to use Zig as a unified build system across different environments and toolsets.

TODO

• ldc2 support
• flang-new support
• rustc (no cargo) support
• rustc (cargo) support (need to figure out how to get the cargo build system to work)
• swiftc-6 support

Required

• zig v0.13.0 or master

Supported

• ldc2 v1.38.0 or latest-CI
• flang (a.k.a flang-new) LLVM-18.1.3 or master
• rustc stable or nightly
• swift v6.0 or main-snapshots

Usage

Make new project or add to existing project:

In project folder, add this package as dependency on your build.zig.zon

$ zig fetch --save=abs git+https://github.com/kassane/anotherBuildStep

• add const abs = @import("abs") in build.zig

const std = @import("std");
// get build.zig from pkg to extend your build.zig project (only pub content module)
const abs = @import("abs");
// Dlang
const ldc2 = abs.ldc2;
// Fortran
const flang = abs.flang;
// Rust
const rustc = abs.rust;
// Swift
const swiftc = abs.swift;
// zig-cc wrapper
const zcc = abs.zcc;

pub fn build(b: *std.Build) !void {
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});
    
    const exeDlang = try ldc2.BuildStep(b, .{
        .name = "d_example",
        .target = target,
        .optimize = optimize,
        .sources = &.{
            "src/main.d",
        },
        .dflags = &.{
            "-w",
        },
    });
    b.default_step.dependOn(&exeDlang.step);

    // or
    
    const exeFortran = try flang.BuildStep(b, .{
        .name = "fortran_example",
        .target = target,
        .optimize = optimize,
        .sources = &.{
            "src/main.f90",
        },
        .use_zigcc = true,
        .zcc_options = try zcc.buildOptions(b, target),
    });
    b.default_step.dependOn(&exeFortran.step);

    // or

    const exeRust = try rustc.BuildStep(b, .{
        .name = "rust_example",
        .target = target,
        .optimize = optimize,
        .source = b.path("src/main.rs"),
        .rflags = &.{
            "-C",
            "panic=abort",
        },
    });
    b.default_step.dependOn(&exeRust.step);

    // or

    const exeSwift = try swift.BuildStep(b, .{
        .name = "swift_example",
        .target = target,
        .optimize = optimize,
        .sources = &.{
            "examples/main.swift",
        },
        .use_zigcc = true,
        .zcc_options = try zcc.buildOptions(b, target),
    });
    b.default_step.dependOn(&exeSwift.step);
}