sqlite3 build script

Author: leroycep

.github/workflows/ci.yaml

@@ -0,0 +1,24 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches: [main]
+
+  pull_request:
+    branches: [main]
+
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Zig
+        uses: mlugg/setup-zig@v2
+
+      - name: Run `build`
+        run: zig build

.gitignore

@@ -0,0 +1,2 @@
+.zig-cache/
+zig-out/

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025 LeRoyce Pearson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this build script and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next
+paragraph) shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,23 @@
+This build script takes the SQLite source code amalgam and exposes a statically
+linked `sqlite3` library and the `sqlite3` shell executable.
+
+To add it to your `build.zig.zon`:
+
+```
+zig fetch --save git+https://github.com/allyourcodebase/sqlite3
+```
+
+Using it in your build script:
+
+```zig
+const sqlite3 = b.dependency("sqlite3", .{
+  .target = target,
+  .optimize = optimize,
+});
+const sqlite3_lib = b.artifact("sqlite3");
+const sqlite3_exe = b.artifact("shell");
+```
+
+[This build script is licensed under the MIT License](./LICENSE).
+
+[SQLite itself is dedicated to the public domain](https://sqlite.org/copyright.html).

build.zig

@@ -0,0 +1,47 @@
+const std = @import("std");
+
+pub fn build(b: *std.Build) void {
+    const run_step = b.step("run", "run sqlite shell");
+
+    const target = b.standardTargetOptions(.{});
+    const optimize = b.standardOptimizeOption(.{});
+
+    const src = b.dependency("sqlite3", .{});
+
+    const lib = b.addLibrary(.{
+        .name = "sqlite3",
+        .root_module = b.createModule(.{
+            .target = target,
+            .optimize = optimize,
+            .link_libc = true,
+        }),
+    });
+    lib.root_module.addCSourceFile(.{
+        .file = src.path("sqlite3.c"),
+    });
+    lib.installHeader(src.path("sqlite3.h"), "sqlite3.h");
+    lib.installHeader(src.path("sqlite3ext.h"), "sqlite3ext.h");
+    b.installArtifact(lib);
+
+    const shell = b.addExecutable(.{
+        .name = "shell",
+        .root_module = b.createModule(.{
+            .target = target,
+            .optimize = optimize,
+        }),
+    });
+    shell.root_module.addCSourceFile(.{
+        .file = src.path("shell.c"),
+    });
+    shell.linkLibrary(lib);
+    const shell_install = b.addInstallArtifact(shell, .{
+        .dest_sub_path = "sqlite3",
+    });
+    b.getInstallStep().dependOn(&shell_install.step);
+
+    const shell_run = b.addRunArtifact(shell);
+    if (b.args) |args| {
+        shell_run.addArgs(args);
+    }
+    run_step.dependOn(&shell_run.step);
+}

build.zig.zon

@@ -0,0 +1,13 @@
+.{
+    .name = .sqlite3,
+    .version = "3.51.0",
+    .dependencies = .{
+        .sqlite3 = .{
+            .url = "https://sqlite.org/2025/sqlite-amalgamation-3510000.zip",
+            .hash = "N-V-__8AALNYqgDpBBECZ3Jn_VpVGjX4xX7uTSZg00tYjmy3",
+        },
+    },
+    .minimum_zig_version = "0.15.2",
+    .paths = .{""},
+    .fingerprint = 0x6edcd7115a4bcc0c,
+}