zig compile commands

Simple build module to generate a compile_commands.json file from clang compilation database fragments dir.

Note: I will only maintain support for zig master.

Usage

Fetch the package:

zig fetch --save=compile_commands git+https://github.com/Tomcat-42/zig-compile-commands

Add the -gen-cdb-fragment-path <DIR> flag to your target. Here

could be any dir, for example the zig cache:

const flags: []const []const u8 = &.{ 
    "-std=c23",
    "-Wall",
    "-Wextra",
    "-Werror",
    "-Wpedantic",
    "-fno-strict-aliasing",
    "-gen-cdb-fragment-path",
    b.fmt("{s}/{s}", .{ b.cache_root.path.?, "cdb" }),
};

const mod = b.createModule(.{
    .target = target,
    .optimize = optimize,
    .link_libc = true,
    .pic = true,
});

mod.addIncludePath(b.path("include"));
mod.addCSourceFiles(.{
    .root = b.path("src"),
    .files = &.{"main.c"},
    .flags = flags,
});

const exe = b.addExecutable(.{
    .name = "exe",
    .root_module = mod,
});

Now, create the step. The arguments are the fragments dir(the same that you added to the flags) and the resulting compile_commands.json path:

const cc_step = b.step("cc", "Generate Compile Commands Database");
const gen_file_step = try GenCompileCommands.createStep(
    b,
    b.fmt("{s}/{s}", .{ b.cache_root.path orelse "./", "cdb" }),
    b.fmt("{s}/{s}", .{ b.cache_root.path orelse "./", "compile_commands.json" }),
);
gen_file_step.dependOn(&exe.step);
cc_step.dependOn(gen_file_step);

Finally, generate the file:

zig build cc