migrate to v3

.github/scripts/parallel-go-build.sh

@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+# parallel-go-build.sh
+# Recursively find go.mod files and run `go build ./...` in each module directory.
+# - truncates build-errors.log at start
+# - appends failures immediately, annotated with source line + 1-line context
+# - runs in parallel (jobs = CPU cores)
+# - atomic appends (mkdir lock)
+# - handles Ctrl+C (SIGINT) and SIGTERM: kills children and cleans up
+# - colored terminal output (OK = green, FAIL = red, WARN = yellow)
+set -euo pipefail
+IFS=$'\n\t'
+
+JOBS="$(getconf _NPROCESSORS_ONLN 2>/dev/null || echo 4)"
+LOGFILE="build-errors.log"
+
+# Colors (only if stdout is a tty)
+if [ -t 1 ]; then
+  GREEN=$'\e[32m'
+  RED=$'\e[31m'
+  YELLOW=$'\e[33m'
+  RESET=$'\e[0m'
+else
+  GREEN=""
+  RED=""
+  YELLOW=""
+  RESET=""
+fi
+
+# truncate central logfile at start
+: > "$LOGFILE"
+
+# find all module directories (skip common vendor trees)
+mapfile -t MODULE_DIRS < <(
+  find . \( -path "./.git" -o -path "./vendor" -o -path "./node_modules" \) -prune -o \
+    -type f -name 'go.mod' -print0 |
+  xargs -0 -n1 dirname |
+  sort -u
+)
+
+if [ "${#MODULE_DIRS[@]}" -eq 0 ]; then
+  printf '%s\n' "No go.mod files found. Nothing to do."
+  exit 0
+fi
+
+# create absolute temp dir
+TMPDIR="$(mktemp -d 2>/dev/null || mktemp -d /tmp/build-logs.XXXXXX)"
+if [ -z "$TMPDIR" ] || [ ! -d "$TMPDIR" ]; then
+  printf '%s\n' "Failed to create temporary directory" >&2
+  exit 2
+fi
+
+# ensure cleanup on exit (will try multiple times)
+cleanup_tmpdir() {
+  local attempts=0
+  while [ "$attempts" -lt 5 ]; do
+    if rm -rf "$TMPDIR" 2>/dev/null; then
+      break
+    fi
+    attempts=$((attempts+1))
+    sleep 0.1
+  done
+  if [ -d "$TMPDIR" ]; then
+    printf '%s\n' "WARNING: could not fully remove temporary dir: $TMPDIR"
+  fi
+}
+
+# signal handling: kill children, wait, cleanup, exit
+pids=()
+on_interrupt() {
+  printf '%b\n' "${YELLOW}Received interrupt. Killing background jobs...${RESET}"
+  # kill all tracked background pids
+  for pid in "${pids[@]:-}"; do
+    if kill -0 "$pid" 2>/dev/null; then
+      kill "$pid" 2>/dev/null || true
+    fi
+  done
+  # give them a moment, then force
+  sleep 0.1
+  for pid in "${pids[@]:-}"; do
+    if kill -0 "$pid" 2>/dev/null; then
+      kill -9 "$pid" 2>/dev/null || true
+    fi
+  done
+  cleanup_tmpdir
+  printf '%b\n' "${YELLOW}Aborted by user.${RESET}"
+  exit 130
+}
+trap on_interrupt INT TERM
+
+# helper: sanitize a dir to a filename-safe token
+sanitize_name() {
+  local d="$1"
+  d="${d#./}"
+  d="${d//\//__}"
+  d="${d// /_}"
+  printf '%s' "${d//[^A-Za-z0-9._-]/_}"
+}
+
+# annotate a module's temp log and append to central logfile atomically
+annotate_and_append() {
+  local src_log="$1"   # absolute path to per-module temp log
+  local module_dir="$2"
+  local lockdir="$TMPDIR/.lock"
+
+  # create annotated temp file
+  local annotated
+  annotated="$(mktemp "$TMPDIR/annotated.XXXXXX")" || {
+    # fallback: append raw log
+    until mkdir "$lockdir" 2>/dev/null; do sleep 0.01; done
+    printf '==== %s ====\n' "$module_dir" >> "$LOGFILE"
+    cat "$src_log" >> "$LOGFILE"
+    rm -f "$src_log" || true
+    rmdir "$lockdir" 2>/dev/null || true
+    return
+  }
+
+  # process lines: if matches file.go:LINE[:COL] annotate with source snippet
+  while IFS= read -r line || [ -n "$line" ]; do
+    # regex: capture path ending with .go, line number, optional column, rest
+    if [[ $line =~ ^([^:]+\.go):([0-9]+):?([0-9]*)[:[:space:]]*(.*)$ ]]; then
+      local fp="${BASH_REMATCH[1]}"
+      local ln="${BASH_REMATCH[2]}"
+      local col="${BASH_REMATCH[3]}"
+      local rest="${BASH_REMATCH[4]}"
+      local candidate=""
+
+      # try to resolve file path: as-is, relative to module_dir, or relative to repo root
+      if [ -f "$fp" ]; then
+        candidate="$fp"
+      elif [ -f "$module_dir/$fp" ]; then
+        candidate="$module_dir/$fp"
+      elif [ -f "./$fp" ]; then
+        candidate="./$fp"
+      fi
+
+      if [ -n "$candidate" ]; then
+        # pick context: line-1 .. line+1
+        local start=$(( ln > 1 ? ln - 1 : 1 ))
+        local end=$(( ln + 1 ))
+        printf '%s\n' "---- source: $candidate:$ln ----" >> "$annotated"
+        # print numbered context lines
+        awk -v s="$start" -v e="$end" 'NR>=s && NR<=e { printf("%6d  %s\n", NR, $0) }' "$candidate" >> "$annotated"
+        printf '%s\n\n' "Error: $line" >> "$annotated"
+      else
+        printf '%s\n' "---- (source not found) $line ----" >> "$annotated"
+      fi
+    else
+      # plain copy line
+      printf '%s\n' "$line" >> "$annotated"
+    fi
+  done < "$src_log"
+
+  # append annotated file to central logfile under lock
+  until mkdir "$lockdir" 2>/dev/null; do
+    sleep 0.01
+  done
+  {
+    printf '==== %s ====\n' "$module_dir"
+    cat "$annotated"
+    printf '\n\n'
+  } >> "$LOGFILE"
+  rm -f "$annotated" "$src_log" || true
+  rmdir "$lockdir" 2>/dev/null || true
+}
+
+# run build for one module
+run_build() {
+  local module_dir="$1"
+  local safe
+  safe="$(sanitize_name "$module_dir")"
+  local mod_log="$TMPDIR/$safe.log"
+  mkdir -p "$(dirname "$mod_log")"
+
+  # run inside subshell to avoid changing caller's cwd
+  if ( cd "$module_dir" 2>/dev/null && go build ./... >/dev/null 2>"$mod_log" ); then
+    printf '%b\n' "${GREEN}OK:   ${RESET}$module_dir"
+    rm -f "$mod_log" >/dev/null 2>&1 || true
+    return 0
+  else
+    # ensure we captured something
+    if [ ! -s "$mod_log" ]; then
+      ( cd "$module_dir" 2>/dev/null && go build ./... >"$mod_log" 2>&1 ) || true
+    fi
+    printf '%b\n' "${RED}FAIL: ${RESET}$module_dir (appending to $LOGFILE)"
+    annotate_and_append "$mod_log" "$module_dir"
+    return 1
+  fi
+}
+
+# main launcher: spawn jobs, throttle to JOBS, wait properly
+fail_count=0
+
+for md in "${MODULE_DIRS[@]}"; do
+  run_build "$md" &
+  pids+=( "$!" )
+
+  # if we reached jobs, wait for the oldest launched
+  if [ "${#pids[@]}" -ge "$JOBS" ]; then
+    if wait "${pids[0]}"; then
+      :  # success
+    else
+      fail_count=$((fail_count+1))
+    fi
+    # drop first pid
+    pids=( "${pids[@]:1}" )
+  fi
+done
+
+# wait remaining background jobs
+for pid in "${pids[@]:-}"; do
+  if wait "$pid"; then :; else fail_count=$((fail_count+1)); fi
+done
+
+# final cleanup and status
+cleanup_tmpdir
+
+if [ "$fail_count" -gt 0 ]; then
+  printf '\n%b\n' "${RED}Done. $fail_count module(s) failed. See $LOGFILE for details (annotated snippets included).${RESET}"
+  exit 1
+else
+  printf '\n%b\n' "${GREEN}Done. All modules built successfully.${RESET}"
+  # remove logfile if empty
+  if [ -f "$LOGFILE" ] && [ ! -s "$LOGFILE" ]; then
+    rm -f "$LOGFILE"
+  fi
+  exit 0
+fi

404-handler/go.mod

@@ -2,18 +2,22 @@ module main
 
 go 1.25.0
 
-require github.com/gofiber/fiber/v2 v2.52.10
+require github.com/gofiber/fiber/v3 v3.0.0-rc.3
 
 require (
 	github.com/andybalholm/brotli v1.2.0 // indirect
-	github.com/clipperhouse/stringish v0.1.1 // indirect
-	github.com/clipperhouse/uax29/v2 v2.3.0 // indirect
+	github.com/gofiber/schema v1.6.0 // indirect
+	github.com/gofiber/utils/v2 v2.0.0-rc.2 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/klauspost/compress v1.18.1 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/mattn/go-runewidth v0.0.19 // indirect
+	github.com/philhofer/fwd v1.2.0 // indirect
+	github.com/tinylib/msgp v1.5.0 // indirect
 	github.com/valyala/bytebufferpool v1.0.0 // indirect
 	github.com/valyala/fasthttp v1.68.0 // indirect
+	golang.org/x/crypto v0.44.0 // indirect
+	golang.org/x/net v0.47.0 // indirect
 	golang.org/x/sys v0.38.0 // indirect
+	golang.org/x/text v0.31.0 // indirect
 )

404-handler/go.sum

@@ -1,11 +1,15 @@
 github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=
 github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=
-github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
-github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
-github.com/clipperhouse/uax29/v2 v2.3.0 h1:SNdx9DVUqMoBuBoW3iLOj4FQv3dN5mDtuqwuhIGpJy4=
-github.com/clipperhouse/uax29/v2 v2.3.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
-github.com/gofiber/fiber/v2 v2.52.10 h1:jRHROi2BuNti6NYXmZ6gbNSfT3zj/8c0xy94GOU5elY=
-github.com/gofiber/fiber/v2 v2.52.10/go.mod h1:YEcBbO/FB+5M1IZNBP9FO3J9281zgPAreiI1oqg8nDw=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/fxamacker/cbor/v2 v2.9.0 h1:NpKPmjDBgUfBms6tr6JZkTHtfFGcMKsw3eGcmD/sapM=
+github.com/fxamacker/cbor/v2 v2.9.0/go.mod h1:vM4b+DJCtHn+zz7h3FFp/hDAI9WNWCsZj23V5ytsSxQ=
+github.com/gofiber/fiber/v3 v3.0.0-rc.3 h1:h0KXuRHbivSslIpoHD1R/XjUsjcGwt+2vK0avFiYonA=
+github.com/gofiber/fiber/v3 v3.0.0-rc.3/go.mod h1:LNBPuS/rGoUFlOyy03fXsWAeWfdGoT1QytwjRVNSVWo=
+github.com/gofiber/schema v1.6.0 h1:rAgVDFwhndtC+hgV7Vu5ItQCn7eC2mBA4Eu1/ZTiEYY=
+github.com/gofiber/schema v1.6.0/go.mod h1:WNZWpQx8LlPSK7ZaX0OqOh+nQo/eW2OevsXs1VZfs/s=
+github.com/gofiber/utils/v2 v2.0.0-rc.2 h1:NvJTf7yMafTq16lUOJv70nr+HIOLNQcvGme/X+ftbW8=
+github.com/gofiber/utils/v2 v2.0.0-rc.2/go.mod h1:gXins5o7up+BQFiubmO8aUJc/+Mhd7EKXIiAK5GBomI=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/klauspost/compress v1.18.1 h1:bcSGx7UbpBqMChDtsF28Lw6v/G94LPrrbMbdC3JH2co=
@@ -14,14 +18,32 @@ github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHP
 github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
-github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
+github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM=
+github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/shamaton/msgpack/v2 v2.4.0 h1:O5Z08MRmbo0lA9o2xnQ4TXx6teJbPqEurqcCOQ8Oi/4=
+github.com/shamaton/msgpack/v2 v2.4.0/go.mod h1:6khjYnkx73f7VQU7wjcFS9DFjs+59naVWJv1TB7qdOI=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/tinylib/msgp v1.5.0 h1:GWnqAE54wmnlFazjq2+vgr736Akg58iiHImh+kPY2pc=
+github.com/tinylib/msgp v1.5.0/go.mod h1:cvjFkb4RiC8qSBOPMGPSzSAx47nAsfhLVTCZZNuHv5o=
 github.com/valyala/bytebufferpool v1.0.0 h1:GqA5TC/0021Y/b9FG4Oi9Mr3q7XYx6KllzawFIhcdPw=
 github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc=
 github.com/valyala/fasthttp v1.68.0 h1:v12Nx16iepr8r9ySOwqI+5RBJ/DqTxhOy1HrHoDFnok=
 github.com/valyala/fasthttp v1.68.0/go.mod h1:5EXiRfYQAoiO/khu4oU9VISC/eVY6JqmSpPJoHCKsz4=
+github.com/x448/float16 v0.8.4 h1:qLwI1I70+NjRFUR3zs1JPUCgaCXSh3SW62uAKT1mSBM=
+github.com/x448/float16 v0.8.4/go.mod h1:14CWIYCyZA/cWjXOioeEpHeN/83MdbZDRQHoFcYsOfg=
 github.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU=
 github.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3iGxZ18UQApw/E=
+golang.org/x/crypto v0.44.0 h1:A97SsFvM3AIwEEmTBiaxPPTYpDC47w720rdiiUvgoAU=
+golang.org/x/crypto v0.44.0/go.mod h1:013i+Nw79BMiQiMsOPcVCB5ZIJbYkerPrGnOa00tvmc=
+golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY=
+golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
 golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
+golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

404-handler/main.go

@@ -7,7 +7,7 @@ package main
 import (
 	"log"
 
-	"github.com/gofiber/fiber/v2"
+	"github.com/gofiber/fiber/v3"
 )
 
 func main() {
@@ -18,7 +18,7 @@ func main() {
 	app.Get("/hello", hello)
 
 	// 404 Handler
-	app.Use(func(c *fiber.Ctx) error {
+	app.Use(func(c fiber.Ctx) error {
 		return c.SendStatus(404) // => 404 "Not Found"
 	})
 
@@ -27,6 +27,6 @@ func main() {
 }
 
 // Handler
-func hello(c *fiber.Ctx) error {
+func hello(c fiber.Ctx) error {
 	return c.SendString("I made a ☕ for you!")
 }

air/go.mod

@@ -2,18 +2,22 @@ module main
 
 go 1.25.0
 
-require github.com/gofiber/fiber/v2 v2.52.10
+require github.com/gofiber/fiber/v3 v3.0.0-rc.3
 
 require (
 	github.com/andybalholm/brotli v1.2.0 // indirect
-	github.com/clipperhouse/stringish v0.1.1 // indirect
-	github.com/clipperhouse/uax29/v2 v2.3.0 // indirect
+	github.com/gofiber/schema v1.6.0 // indirect
+	github.com/gofiber/utils/v2 v2.0.0-rc.2 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/klauspost/compress v1.18.1 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/mattn/go-runewidth v0.0.19 // indirect
+	github.com/philhofer/fwd v1.2.0 // indirect
+	github.com/tinylib/msgp v1.5.0 // indirect
 	github.com/valyala/bytebufferpool v1.0.0 // indirect
 	github.com/valyala/fasthttp v1.68.0 // indirect
+	golang.org/x/crypto v0.44.0 // indirect
+	golang.org/x/net v0.47.0 // indirect
 	golang.org/x/sys v0.38.0 // indirect
+	golang.org/x/text v0.31.0 // indirect
 )