Add workflow

Author: Pablo Alessandro Santos Hugen

.github/workflows/ci.yaml

@@ -0,0 +1,49 @@
+name: Test, Package, and Release
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Zig
+        uses: mlugg/setup-zig@v1
+        with:
+          version: "master"
+
+      - name: Build example
+        working-directory: ./example
+        run: zig build cc
+
+      - name: Verify compile_commands.json
+        working-directory: ./example
+        run: |
+          if [ ! -f "compile_commands.json" ]; then
+            echo "error: compile_commands.json not found!"
+            exit 1
+          fi
+
+          if [ ! -s "compile_commands.json" ]; then
+            echo "compile_commands.json is empty!"
+            exit 1
+          fi
+
+          if ! jq empty compile_commands.json 2>/dev/null; then
+            echo "error: compile_commands.json contains invalid JSON!"
+            exit 1
+          fi
+
+          echo "compile_commands.json validation passed"
+

example/build.zig

@@ -0,0 +1,28 @@
+const std = @import("std");
+const CompileCommands = @import("compile_commands");
+
+pub fn build(b: *std.Build) !void {
+    const target = b.standardTargetOptions(.{});
+    const optimize = b.standardOptimizeOption(.{});
+    const flags: []const []const u8 = &.{ "-gen-cdb-fragment-path", "cdb" };
+
+    const example_mod = b.createModule(.{
+        .target = target,
+        .optimize = optimize,
+        .link_libc = true,
+    });
+    const example = b.addExecutable(.{
+        .name = "example",
+        .root_module = example_mod,
+    });
+    example.addCSourceFiles(.{
+        .root = b.path("src"),
+        .files = &.{"example.c"},
+        .flags = flags,
+    });
+
+    const cc_step = b.step("cc", "Generate Compile Commands Database");
+    const gen_file_step = try CompileCommands.createStep(b, "cdb", "compile_commands.json");
+    gen_file_step.dependOn(&example.step);
+    cc_step.dependOn(gen_file_step);
+}

example/build.zig.zon

@@ -0,0 +1,14 @@
+.{
+    .name = .example,
+    .version = "0.0.0",
+    .fingerprint = 0x6eec9b9f0a97f862, // Changing this has security and trust implications.
+    .minimum_zig_version = "0.15.0-dev.208+8acedfd5b",
+    .dependencies = .{
+        .compile_commands = .{ .path = "../" },
+    },
+   .paths = .{
+        "build.zig",
+        "build.zig.zon",
+        "src",
+    },
+}

example/src/example.c

@@ -0,0 +1,3 @@
+#include <stdio.h>
+
+int main(void) { printf("Hello, World!\n"); }