git lfs stuff

Author: hazeycode

.gitattributes

@@ -12,3 +12,4 @@
 *.a filter=lfs diff=lfs merge=lfs -text
 bin/x64/dxc filter=lfs diff=lfs merge=lfs -text
 bin/x64/libdxcompiler.so.3.7 filter=lfs diff=lfs merge=lfs -text
+.lfs-content-token filter=lfs diff=lfs merge=lfs -text

.github/workflows/main.yml

@@ -20,6 +20,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
+        with:
+          lfs: true
       - name: Install Zig
         uses: mlugg/setup-zig@v2
       - name: Check format

.lfs-content-token

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:936686ef9b9485f027086ce1ed7b4f7461d0ceb7eeccb573e48582055ca1c00f
+size 87

build.zig

@@ -2,6 +2,13 @@ const std = @import("std");
 const builtin = @import("builtin");
 
 pub fn build(b: *std.Build) !void {
+    checkGitLfsContent() catch {
+        try ensureGit(b.allocator);
+        try ensureGitLfs(b.allocator, "install");
+        try ensureGitLfs(b.allocator, "pull");
+        try checkGitLfsContent();
+    };
+
     const options = .{
         .zxaudio2_debug_layer = b.option(
             bool,
@@ -266,3 +273,81 @@ pub fn addCompileShaders(
         .shader_ver = options.shader_ver,
     };
 }
+
+fn ensureGit(allocator: std.mem.Allocator) !void {
+    const printErrorMsg = (struct {
+        fn impl() void {
+            std.log.err("\n" ++
+                \\---------------------------------------------------------------------------
+                \\
+                \\'git version' failed. Is Git not installed?
+                \\
+                \\---------------------------------------------------------------------------
+                \\
+            , .{});
+        }
+    }).impl;
+    const argv = &[_][]const u8{ "git", "version" };
+    const result = std.process.Child.run(.{
+        .allocator = allocator,
+        .argv = argv,
+    }) catch { // e.g. FileNotFound
+        printErrorMsg();
+        return error.GitNotFound;
+    };
+    defer {
+        allocator.free(result.stderr);
+        allocator.free(result.stdout);
+    }
+    if (result.term.Exited != 0) {
+        printErrorMsg();
+        return error.GitNotFound;
+    }
+}
+
+fn ensureGitLfs(allocator: std.mem.Allocator, cmd: []const u8) !void {
+    const printNoGitLfs = (struct {
+        fn impl() void {
+            std.log.err("\n" ++
+                \\---------------------------------------------------------------------------
+                \\
+                \\Please install Git LFS (Large File Support) extension and run 'zig build' again.
+                \\
+                \\For more info about Git LFS see: https://git-lfs.github.com/
+                \\
+                \\---------------------------------------------------------------------------
+                \\
+            , .{});
+        }
+    }).impl;
+    const argv = &[_][]const u8{ "git", "lfs", cmd };
+    const result = std.process.Child.run(.{
+        .allocator = allocator,
+        .argv = argv,
+    }) catch { // e.g. FileNotFound
+        printNoGitLfs();
+        return error.GitLfsNotFound;
+    };
+    defer {
+        allocator.free(result.stderr);
+        allocator.free(result.stdout);
+    }
+    if (result.term.Exited != 0) {
+        printNoGitLfs();
+        return error.GitLfsNotFound;
+    }
+}
+
+fn checkGitLfsContent() !void {
+    const expected_contents =
+        \\DO NOT EDIT OR DELETE
+        \\This file is used to check if Git LFS content has been downloaded
+    ;
+    var buf: [expected_contents.len]u8 = undefined;
+    _ = std.fs.cwd().readFile(".lfs-content-token", &buf) catch {
+        return error.GitLfsContentTokenNotFound;
+    };
+    if (!std.mem.eql(u8, expected_contents, &buf)) {
+        return error.GitLfsContentCheckFailed;
+    }
+}