extras: add SBo git hooks (pre-commit sbolint, post-commit archive)

Versioned source of truth for the hooks installed in .git/hooks/. Reinstall after reclone with: cp .extras/hooks/* .git/hooks/

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2 files changed, 141 insertions, 0 deletions

diff --git a/.extras/hooks/post-commit b/.extras/hooks/post-commit
new file mode 100755
index 0000000..6350615
--- /dev/null
+++ b/.extras/hooks/post-commit
@@ -0,0 +1,57 @@
+#!/bin/bash
+# post-commit hook: create SBo submission archive for added/updated packages
+set -u
+
+REPO_ROOT=$(git rev-parse --show-toplevel)
+SBO_DIR="$REPO_ROOT/SBo"
+
+# Find packages whose .SlackBuild was added (A) or modified (M) in this commit.
+# git diff-tree output format: <status>\t<file>
+# We only want files exactly one directory deep, e.g. hugo/hugo.SlackBuild.
+PACKAGES=()
+while IFS=$'\t' read -r status file; do
+    [[ "$status" != "A" && "$status" != "M" ]] && continue
+    dir=$(dirname "$file")
+    base=$(basename "$file")
+    [[ "$dir" == "." ]] && continue       # skip root-level files
+    [[ "$dir" == *"/"* ]] && continue     # skip files deeper than one level
+    [[ "$base" == *.SlackBuild ]] || continue
+    PACKAGES+=("$dir")
+done < <(git diff-tree --no-commit-id -r --name-status HEAD)
+
+[[ ${#PACKAGES[@]} -eq 0 ]] && exit 0
+
+for pkg in "${PACKAGES[@]}"; do
+    echo ""
+    echo "==> Package: $pkg"
+    echo ""
+    echo "Files to be archived:"
+    echo "---------------------"
+    while IFS= read -r f; do
+        printf '%s\n' "${f#"$REPO_ROOT/"}"
+    done < <(find "$REPO_ROOT/$pkg" -type f | sort)
+    echo ""
+    # Need an interactive terminal to prompt; skip cleanly if none.
+    if [ ! -r /dev/tty ]; then
+        echo "  -> No terminal, skipped (run hook interactively to archive)."
+        continue
+    fi
+    printf "Create SBo archive for '%s'? [y/N] " "$pkg"
+    answer=""
+    read -r answer </dev/tty || answer=""
+    case "$answer" in
+        [yY]|[yY][eE][sS])
+            mkdir -p "$SBO_DIR"
+            if tar -czf "$SBO_DIR/$pkg.tar.gz" -C "$REPO_ROOT" "$pkg"; then
+                echo "  -> Archive created: SBo/$pkg.tar.gz"
+            else
+                echo "  -> Archive FAILED." >&2
+            fi
+            ;;
+        *)
+            echo "  -> Skipped."
+            ;;
+    esac
+done
+
+exit 0
diff --git a/.extras/hooks/pre-commit b/.extras/hooks/pre-commit
new file mode 100755
index 0000000..d2f9506
--- /dev/null
+++ b/.extras/hooks/pre-commit
@@ -0,0 +1,84 @@
+#!/bin/bash
+
+# 20220315 bkw: SBo pre-commit hook, wrapper for sbolint.
+
+# Installation:
+
+# Copy this to <gitdir>/.git/hooks, mode 0755 (or anyway, make it
+# executable). Also get sbolint and install it somewhere on $PATH,
+# like /usr/local/bin. sbolint comes from:
+
+# https://slackware.uk/~urchlay/repos/sbostuff/plain/sbolint
+
+# That's a wgettable URL. You can also clone the sbostuff
+# repo from https://slackware.uk/~urchlay/repos/sbostuff if you want.
+
+# Usage:
+
+# Just do your usual "git commit". When you do, sbolint will run on
+# the build you're updating. If it finds any issues, it will cause the
+# commit to abort, so you can fix whatever's wrong and try the commit
+# again.
+
+# Since sbolint isn't perfect, you can skip the check for any commit
+# by running e.g:
+
+#  SBOLINT=no git commit <arguments>
+
+# You can also run sbolint by itself, and read its documentation with
+# "sbolint --docs".
+
+set -e
+exec 1>&2
+
+# Check for staged source archives (.tar.gz, .tar.xz, .tar.bz2, .zip, etc.)
+# Symlinks: auto-removed. Regular files: blocked (must not be committed).
+source_pattern='\.\(tar\.gz\|tar\.xz\|tar\.bz2\|tar\.zst\|tgz\|zip\|7z\|rpm\|deb\)$'
+source_blocked=""
+while IFS= read -r f; do
+	mode=$(git ls-files --stage -- "$f" | awk '{print $1}')
+	if [ "$mode" = "120000" ]; then
+		echo "Removing staged symlink to source archive: $f"
+		git rm --cached -q -- "$f"
+		rm -f "$f"
+	else
+		source_blocked="$source_blocked $f"
+	fi
+done < <(git diff --cached --name-only | grep -i "$source_pattern")
+if [ -n "$source_blocked" ]; then
+	echo "*** ERROR: source archives staged for commit:"
+	for f in $source_blocked; do echo "***   $f"; done
+	echo "*** Remove them with: git rm --cached -- $source_blocked"
+	exit 1
+fi
+
+# There should normally only be one changed build per commit, but this
+# rule may get broken when the repo's frozen pending a new Slackware
+# release. So use a loop.
+
+# The weird-looking "< <(command)" syntax is why this script must
+# have a #!/bin/bash at the top: it won't work with #!/bin/sh, even if
+# /bin/sh is a symlink to bash.
+
+if [ "${SBOLINT:-yes}" = "yes" ]; then
+	sbolintfailed=""
+	if ! which sbolint &>/dev/null; then
+		echo "WARNING: can't find sbolint in PATH, no linting will be done"
+	else
+		while read build; do
+			# if there's no slack-desc or README, assume the build has been removed.
+			# the directory still might exist after a "git rm -rf" because it
+			# might contain untracked files (e.g. the source tarball).
+			if [ -e "$build/slack-desc" -o -e "$build/README" ]; then
+				sbolint "$build" || sbolintfailed=1
+			fi
+		done < <(git diff --cached --name-only | cut -d/ -f1,2 | sort -u)
+	fi
+	if [ -n "$sbolintfailed" ]; then
+		echo "*** sbolint failed, fix the errors or set SBOLINT=no"
+		echo "*** in the environment to commit anyway."
+		exit 1
+	fi
+fi
+
+exit 0