fix(go): Update user facing utility scripts

Author: bartventer

src/go/bin/go-install.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# This script upgrades Go to the specified version.
+# Usage: ./go-install.sh <version>
+# Example: ./go-install.sh go1.20.5
+# Note: Ensure that the GOROOT environment variable is set to the desired
+# installation path before running this script.
+set -euo pipefail
+
+install_go() {
+  local go_version="${1:?Version argument is required}"
+  local go_root="${GOROOT:?Environment variable GOROOT must be set}"
+
+  local go_arch
+  go_arch=$(uname -m)
+  case $go_arch in
+  x86_64) go_arch="amd64" ;;
+  aarch64 | armv8*) go_arch="arm64" ;;
+  i?86) go_arch="386" ;;
+  *)
+    echo "Error: Unsupported architecture '$go_arch'. Supported architectures are x86_64 (amd64), aarch64 (arm64), and i386 (386)."
+    exit 1
+    ;;
+  esac
+  local download_url="https://go.dev/dl/${go_version}.linux-${go_arch}.tar.gz"
+
+  echo "Removing any existing Go installation"
+  rm -rfv "$go_root"
+  echo "Downloading and extracting Go from $download_url to $(dirname "$go_root")..."
+  curl -sSL "$download_url" | tar -C "$(dirname "$go_root")" -xz
+
+  echo "Go $go_version installed to $go_root."
+  echo "(*) Please ensure that $go_root/bin is in your PATH."
+}
+
+if [ "$#" -ne 1 ]; then
+  echo "Usage: $0 <version>"
+  echo "Example: $0 go1.20.5"
+  echo "See https://go.dev/dl/ and https://github.com/golang/go/tags for available versions."
+  exit 1
+fi
+
+install_go "$1"

src/go/bin/go-tools-install.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# This script installs Go tools specified in a tools.txt file.
+# Usage: ./go-tools-install.sh <path/to/tools.txt>
+# Example: ./go-tools-install.sh /usr/local/share/go-tools.txt
+
+set -euo pipefail
+
+make_bin_completions() {
+  local _completion_dir_bash="/etc/bash_completion.d"
+  local _completion_dir_zsh="/usr/share/zsh/site-functions"
+  local _completion_dir_fish="/usr/share/fish/vendor_completions.d"
+  echo "::Detected $1, generating completions..."
+  local bin_name="$1"
+  mkdir -pv "$_completion_dir_bash" "$_completion_dir_zsh" "$_completion_dir_fish"
+  "$GOBIN/$bin_name" completion bash >"$_completion_dir_bash/$bin_name"
+  "$GOBIN/$bin_name" completion zsh >"$_completion_dir_zsh/_$bin_name"
+  "$GOBIN/$bin_name" completion fish >"$_completion_dir_fish/$bin_name.fish"
+  echo "$bin_name completion scripts installed."
+}
+
+install_go_tools() {
+  local go_toolstxt_path="${1:?Path to tools.txt is required}"
+  local go_tools
+  go_tools=$(cat "$go_toolstxt_path")
+  echo "Tools to be installed:"
+  xargs -I{} -n 1 echo " -  {}" <<<"$go_tools"
+  [[ -z "${GOBIN:-}" ]] && {
+    echo "Error: GOBIN environment variable must be set."
+    exit 1
+  }
+  xargs -n 1 go install -v <<<"$go_tools"
+  echo "Go tools installed (via go install)."
+  if grep -xqE "github.com/golangci/golangci-lint/(v[0-9]+/)?cmd/golangci-lint@([a-zA-Z0-9._-]+)?" <<<"$go_tools"; then
+    make_bin_completions "golangci-lint"
+  fi
+  if grep -xqE "github.com/spf13/cobra-cli@([a-zA-Z0-9._-]+)?" <<<"$go_tools"; then
+    make_bin_completions "cobra-cli"
+  fi
+}
+
+if [ "$#" -ne 1 ]; then
+  echo "Usage: $0 <path/to/tools.txt>"
+  echo "Example: $0 /usr/local/share/go-tools.txt"
+  exit 1
+fi
+
+install_go_tools "$1"