@sebastienrousseau/dotfiles 0.2.481 → 0.2.500

package/dot_local/bin/executable_gl

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## gl — Interactive git log browser with fzf + delta.
+##
+## Searches both commit messages AND code changes (OR'd).
+## Smart case: case-sensitive if query has uppercase.
+##
+## # Usage
+##   gl                    # Browse full log
+##   gl --side             # Side-by-side delta mode
+##   gl [git log flags]    # Pass any git log flags through
+##
+## # Keybindings
+##   Enter    Show commit diff (paged)
+##   Ctrl+O   Open commit in browser (GitHub/GitLab/Bitbucket)
+##   Ctrl+Y   Copy commit hash to clipboard
+
+set -euo pipefail
+
+for cmd in fzf delta git; do
+  if ! command -v "$cmd" &>/dev/null; then
+    echo "gl requires $cmd" >&2
+    exit 1
+  fi
+done
+
+# R5: validate git repository
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  echo "gl: not a git repository" >&2
+  exit 1
+fi
+
+# Open a commit URL in the default browser.
+open_commit_url() {
+  local commit="${1}"
+  [[ -z "${commit}" ]] && return
+
+  local branch remote remote_url normalized_url
+  branch="$(git branch --show-current 2>/dev/null || echo "main")"
+  remote="$(git config --get "branch.${branch}.remote" 2>/dev/null || echo "origin")"
+  remote_url="$(git remote get-url "${remote}" 2>/dev/null || true)"
+  [[ -z "${remote_url}" ]] && return
+
+  # Normalize SSH/HTTPS/git@ URLs to https://
+  normalized_url="$(sed -E \
+    's|^(git@|https?://|ssh://git@)([:/]+)?||; s|\.git/?$||; s|:|/|; s|^|https://|; s|/+|/|g; s|https:/|https://|; s|/$||' \
+    <<<"${remote_url}")"
+
+  local commit_path
+  case "${normalized_url}" in
+    *gitlab*) commit_path="-/commit/${commit}" ;;
+    *bitbucket*) commit_path="commits/${commit}" ;;
+    *) commit_path="commit/${commit}" ;;
+  esac
+
+  open "${normalized_url}/${commit_path}" 2>/dev/null || xdg-open "${normalized_url}/${commit_path}" 2>/dev/null || true
+}
+export -f open_commit_url
+
+GIT_ARGS=()
+
+for arg in "$@"; do
+  if [[ "${arg}" == "--side" ]]; then
+    export DELTA_FEATURES="${DELTA_FEATURES:-} side-by-side"
+  else
+    GIT_ARGS+=("${arg}")
+  fi
+done
+
+GIT_ARGS+=("--color=always" "--date=short")
+
+# %at is a hidden timestamp for sorting. COLOR changes per result type.
+FORMAT="%at %C(magenta)%h %C(green)%ad %C(COLOR)> %C(reset)%s"
+FORMAT_MESSAGE="${FORMAT//COLOR/blue}"
+FORMAT_CODE="${FORMAT//COLOR/yellow}"
+
+STRIP_TIMESTAMP="cut -d ' ' -f 2-"
+
+# shellcheck disable=SC2124
+GIT_LOG_DEFAULT="git log --pretty='${FORMAT_MESSAGE}' ${GIT_ARGS[*]} | ${STRIP_TIMESTAMP}"
+
+fzf \
+  --border --border-label " [ Enter: Show | Ctrl+O: Browser | Ctrl+Y: Copy hash ] " \
+  --disabled --no-sort --query "" \
+  --bind "start:reload(${GIT_LOG_DEFAULT})" \
+  --bind "change:reload:sleep 0.15
+      query={q};
+      if [ -z \"\${query}\" ]; then
+        ${GIT_LOG_DEFAULT}
+      else
+        [[ \"\${query}\" =~ [A-Z] ]] && case= || case=\"--regexp-ignore-case\"
+        (git log \${case} --pretty='${FORMAT_CODE}' ${GIT_ARGS[*]} -G \"\${query}\"
+         git log \${case} --pretty='${FORMAT_MESSAGE}' ${GIT_ARGS[*]} --grep \"\${query}\") |
+         sort --numeric-sort --reverse --unique --key 1,1 |
+         ${STRIP_TIMESTAMP}
+      fi" \
+  --bind "enter:execute(git show {1} -- | delta --paging always)" \
+  --bind "ctrl-o:execute-silent(bash -c 'source ${0}; open_commit_url {1}')" \
+  --bind "ctrl-y:execute-silent(printf '%s' {1} | cb)" \
+  --preview "git show {1} -- | delta --width=\${FZF_PREVIEW_COLUMNS}" \
+  --preview-window="right:70%" || true

package/dot_local/bin/executable_hash

@@ -34,15 +34,44 @@ ALL_MODE=false
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    -m|--md5) ALGO="md5"; shift ;;
-    -1|--sha1) ALGO="sha1"; shift ;;
-    -2|--sha256) ALGO="sha256"; shift ;;
-    -5|--sha512) ALGO="sha512"; shift ;;
-    -a|--all) ALL_MODE=true; shift ;;
-    -f|--file) FILE_MODE=true; shift ;;
-    -c|--check) CHECK_MODE=true; EXPECTED="$2"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    -*) echo "Unknown option: $1"; usage; exit 1 ;;
+    -m | --md5)
+      ALGO="md5"
+      shift
+      ;;
+    -1 | --sha1)
+      ALGO="sha1"
+      shift
+      ;;
+    -2 | --sha256)
+      ALGO="sha256"
+      shift
+      ;;
+    -5 | --sha512)
+      ALGO="sha512"
+      shift
+      ;;
+    -a | --all)
+      ALL_MODE=true
+      shift
+      ;;
+    -f | --file)
+      FILE_MODE=true
+      shift
+      ;;
+    -c | --check)
+      CHECK_MODE=true
+      EXPECTED="$2"
+      shift 2
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    -*)
+      echo "Unknown option: $1"
+      usage
+      exit 1
+      ;;
     *) break ;;
   esac
 done
@@ -52,23 +81,31 @@ get_hash_cmd() {
   local algo="$1"
   case "$algo" in
     md5)
-      if command -v md5sum >/dev/null 2>&1; then echo "md5sum"
-      elif command -v md5 >/dev/null 2>&1; then echo "md5 -q"
+      if command -v md5sum >/dev/null 2>&1; then
+        echo "md5sum"
+      elif command -v md5 >/dev/null 2>&1; then
+        echo "md5 -q"
       else echo "openssl md5 -r"; fi
       ;;
     sha1)
-      if command -v sha1sum >/dev/null 2>&1; then echo "sha1sum"
-      elif command -v shasum >/dev/null 2>&1; then echo "shasum -a 1"
+      if command -v sha1sum >/dev/null 2>&1; then
+        echo "sha1sum"
+      elif command -v shasum >/dev/null 2>&1; then
+        echo "shasum -a 1"
       else echo "openssl sha1 -r"; fi
       ;;
     sha256)
-      if command -v sha256sum >/dev/null 2>&1; then echo "sha256sum"
-      elif command -v shasum >/dev/null 2>&1; then echo "shasum -a 256"
+      if command -v sha256sum >/dev/null 2>&1; then
+        echo "sha256sum"
+      elif command -v shasum >/dev/null 2>&1; then
+        echo "shasum -a 256"
       else echo "openssl sha256 -r"; fi
       ;;
     sha512)
-      if command -v sha512sum >/dev/null 2>&1; then echo "sha512sum"
-      elif command -v shasum >/dev/null 2>&1; then echo "shasum -a 512"
+      if command -v sha512sum >/dev/null 2>&1; then
+        echo "sha512sum"
+      elif command -v shasum >/dev/null 2>&1; then
+        echo "shasum -a 512"
       else echo "openssl sha512 -r"; fi
       ;;
   esac
@@ -77,7 +114,8 @@ get_hash_cmd() {
 compute_hash() {
   local algo="$1"
   local input="$2"
-  local cmd=$(get_hash_cmd "$algo")
+  local cmd
+  cmd=$(get_hash_cmd "$algo")
 
   if $FILE_MODE; then
     $cmd "$input" | awk '{print $1}'

package/dot_local/bin/executable_hashsum

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+# shellcheck disable=SC2034
+## Hash Calculator — Compute cryptographic hashes of strings or files.
+##
+## Supports MD5, SHA1, SHA256, and SHA512 algorithms.
+## Can verify hashes and show all algorithms at once.
+##
+## # Requirements
+## - md5sum/sha*sum (Linux) or shasum/md5 (macOS)
+##
+## # Usage
+## hashsum "string"            # SHA256 of string (default)
+## hashsum -f file.txt         # SHA256 of file
+## hashsum -a "string"         # All algorithms
+## hashsum -c HASH "string"    # Verify hash matches
+## hashsum -1 "string"         # SHA1 hash
+## hashsum -5 "string"         # SHA512 hash
+##
+## # Platform Notes
+## - Linux: Uses md5sum, sha*sum
+## - macOS: Uses md5 -q, shasum -a
+
+set -euo pipefail
+
+# --- UI Theme ---
+CYAN='\033[38;5;86m'
+GREEN='\033[38;5;84m'
+RED='\033[38;5;203m'
+GRAY='\033[38;5;244m'
+NC='\033[0m'
+
+usage() {
+  echo "Usage: hashsum [options] [input]"
+  echo "  -m, --md5       MD5"
+  echo "  -1, --sha1      SHA1"
+  echo "  -2, --sha256    SHA256 (default)"
+  echo "  -5, --sha512    SHA512"
+  echo "  -a, --all       Show all hashes"
+  echo "  -f, --file      Hash a file"
+  echo "  -c, --check     Verify hash (expects: -c <hash> <input>)"
+  echo "  -h, --help      Show help"
+  echo ""
+  echo "Note: This tool was renamed from 'hash' to avoid shell builtin collisions."
+}
+
+get_cmd() {
+  case "$1" in
+    md5)
+      command -v md5sum >/dev/null && echo "md5sum" || echo "md5 -q"
+      ;;
+    sha1)
+      command -v sha1sum >/dev/null && echo "sha1sum" || echo "shasum -a 1"
+      ;;
+    sha256)
+      command -v sha256sum >/dev/null && echo "sha256sum" || echo "shasum -a 256"
+      ;;
+    sha512)
+      command -v sha512sum >/dev/null && echo "sha512sum" || echo "shasum -a 512"
+      ;;
+    *)
+      echo "openssl $1 -r"
+      ;;
+  esac
+}
+
+ALGO="sha256"
+FILE_MODE=false
+CHECK_MODE=false
+ALL_MODE=false
+EXPECTED=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -m | --md5)
+      ALGO="md5"
+      shift
+      ;;
+    -1 | --sha1)
+      ALGO="sha1"
+      shift
+      ;;
+    -2 | --sha256)
+      ALGO="sha256"
+      shift
+      ;;
+    -5 | --sha512)
+      ALGO="sha512"
+      shift
+      ;;
+    -a | --all)
+      ALL_MODE=true
+      shift
+      ;;
+    -f | --file)
+      FILE_MODE=true
+      shift
+      ;;
+    -c | --check)
+      CHECK_MODE=true
+      EXPECTED="$2"
+      shift 2
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    -*)
+      echo "Unknown option: $1"
+      usage
+      exit 1
+      ;;
+    *) break ;;
+  esac
+done
+
+compute() {
+  local cmd
+  cmd=$(get_cmd "$1")
+  if $FILE_MODE; then
+    $cmd "$2" | awk '{print $1}'
+  else
+    echo -n "$2" | $cmd | awk '{print $1}'
+  fi
+}
+
+if [[ $# -gt 0 ]]; then
+  INPUT="$1"
+else
+  read -r INPUT
+fi
+
+if $FILE_MODE && [[ ! -f "$INPUT" ]]; then
+  echo "File not found: $INPUT"
+  exit 1
+fi
+
+if $ALL_MODE; then
+  for a in md5 sha1 sha256 sha512; do
+    printf "${CYAN}%-8s${NC} %s\n" "$a:" "$(compute "$a" "$INPUT")"
+  done
+  exit 0
+fi
+
+if $CHECK_MODE; then
+  COMPUTED=$(compute "$ALGO" "$INPUT")
+  EXPECTED_LOWER=$(echo "$EXPECTED" | tr '[:upper:]' '[:lower:]')
+  COMPUTED_LOWER=$(echo "$COMPUTED" | tr '[:upper:]' '[:lower:]')
+
+  if [[ "$EXPECTED_LOWER" == "$COMPUTED_LOWER" ]]; then
+    printf '%b\n' "${GREEN}Hash matches${NC}"
+    exit 0
+  else
+    printf '%b\n' "${RED}Hash mismatch${NC}"
+    echo "  Expected: $EXPECTED"
+    echo "  Got:      $COMPUTED"
+    exit 1
+  fi
+fi
+
+compute "$ALGO" "$INPUT"

package/dot_local/bin/executable_hex

@@ -1,6 +1,23 @@
 #!/usr/bin/env bash
-# Hex viewer/converter
-# Usage: hex <file> | hex -e <string> | hex -d <hex>
+## Hex Viewer — View files in hexadecimal or convert strings to/from hex.
+##
+## Multi-mode hex utility supporting file viewing, string encoding,
+## and hex decoding. Colorized output available with bat.
+##
+## # Requirements
+## - xxd: Primary hex converter (vim package)
+## - hexdump or od: Fallback converters
+## - bat (optional): For colorized output
+##
+## # Usage
+## hex file.bin               # View file in hex
+## hex -e "hello"             # String to hex
+## hex -d "68656c6c6f"        # Hex to string
+## cat file | hex             # View stdin in hex
+## hex -c -n 32 file.bin      # Colorized, 32 bytes per line
+##
+## # Platform Notes
+## - All platforms: Requires xxd, hexdump, or od
 
 set -euo pipefail
 
@@ -27,12 +44,31 @@ BYTES_PER_LINE=16
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    -e|--encode) MODE="encode"; shift ;;
-    -d|--decode) MODE="decode"; shift ;;
-    -c|--color) COLOR=true; shift ;;
-    -n|--length) BYTES_PER_LINE="$2"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    -*) echo "Unknown option: $1"; usage; exit 1 ;;
+    -e | --encode)
+      MODE="encode"
+      shift
+      ;;
+    -d | --decode)
+      MODE="decode"
+      shift
+      ;;
+    -c | --color)
+      COLOR=true
+      shift
+      ;;
+    -n | --length)
+      BYTES_PER_LINE="$2"
+      shift 2
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    -*)
+      echo "Unknown option: $1"
+      usage
+      exit 1
+      ;;
     *) break ;;
   esac
 done

package/dot_local/bin/executable_jsonv

@@ -1,6 +1,21 @@
 #!/usr/bin/env bash
-# JSON validator and formatter
-# Usage: jsonv <file> | jsonv (reads stdin) | jsonv --format <file>
+## JSON Validator — Validate and optionally format JSON data.
+##
+## Validates JSON syntax and reports success or failure.
+## Supports formatting output and quiet mode for scripts.
+##
+## # Requirements
+## - jq: Primary JSON processor (recommended)
+## - python3: Fallback JSON validator
+##
+## # Usage
+## jsonv file.json             # Validate JSON file
+## jsonv < file.json           # Validate from stdin
+## jsonv -f file.json          # Validate and format
+## jsonv -q file.json          # Quiet mode (exit code only)
+##
+## # Platform Notes
+## - All platforms: Requires jq or python3
 
 set -euo pipefail
 
@@ -9,9 +24,18 @@ QUIET=false
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    -f|--format) FORMAT=true; shift ;;
-    -q|--quiet) QUIET=true; shift ;;
-    -*) echo "Unknown option: $1"; exit 1 ;;
+    -f | --format)
+      FORMAT=true
+      shift
+      ;;
+    -q | --quiet)
+      QUIET=true
+      shift
+      ;;
+    -*)
+      echo "Unknown option: $1"
+      exit 1
+      ;;
     *) break ;;
   esac
 done
@@ -20,13 +44,13 @@ validate_json() {
   local input="$1"
   if command -v jq >/dev/null 2>&1; then
     if $FORMAT; then
-      jq '.' <<< "$input"
+      jq '.' <<<"$input"
     else
-      jq -e '.' <<< "$input" >/dev/null 2>&1
+      jq -e '.' <<<"$input" >/dev/null 2>&1
     fi
   elif command -v python3 >/dev/null 2>&1; then
     if $FORMAT; then
-      python3 -m json.tool <<< "$input"
+      python3 -m json.tool <<<"$input"
     else
       python3 -c "import json; json.loads('''$input''')" 2>/dev/null
     fi
@@ -46,9 +70,9 @@ else
 fi
 
 if validate_json "$INPUT"; then
-  $QUIET || echo "✓ Valid JSON ($SOURCE)"
+  $QUIET || echo "Valid JSON ($SOURCE)"
   exit 0
 else
-  echo "✗ Invalid JSON ($SOURCE)"
+  echo "Invalid JSON ($SOURCE)"
   exit 1
 fi

package/dot_local/bin/executable_jwt

@@ -1,6 +1,22 @@
 #!/usr/bin/env bash
-# JWT token decoder
-# Usage: jwt <token> | jwt (reads from stdin)
+## JWT Decoder — Decode and inspect JWT tokens.
+##
+## Decodes JWT header and payload, checks expiration status,
+## and displays token metadata. Does not verify signatures.
+##
+## # Requirements
+## - base64: Core utility for decoding
+## - jq (optional): For JSON formatting
+## - python3 (optional): Fallback JSON formatter
+##
+## # Usage
+## jwt "eyJhbG..."              # Decode JWT token
+## jwt < token.txt              # Decode from stdin
+## echo "Bearer xxx" | jwt      # Handles Bearer prefix
+##
+## # Platform Notes
+## - macOS: Uses base64 -D for decode
+## - Linux: Uses base64 -d for decode
 
 set -euo pipefail
 
@@ -11,7 +27,7 @@ decode_base64url() {
   if [[ $mod -eq 2 ]]; then input="${input}=="; fi
   if [[ $mod -eq 3 ]]; then input="${input}="; fi
   # Convert URL-safe to standard base64
-  echo "$input" | tr '-_' '+/' | base64 -d 2>/dev/null || base64 -D <<< "$(echo "$input" | tr '-_' '+/')"
+  echo "$input" | tr '-_' '+/' | base64 -d 2>/dev/null || base64 -D <<<"$(echo "$input" | tr '-_' '+/')"
 }
 
 format_json() {
@@ -36,7 +52,7 @@ TOKEN="${TOKEN#Bearer }"
 TOKEN="${TOKEN#bearer }"
 
 # Split into parts
-IFS='.' read -ra PARTS <<< "$TOKEN"
+IFS='.' read -ra PARTS <<<"$TOKEN"
 
 if [[ ${#PARTS[@]} -lt 2 ]]; then
   echo "Error: Invalid JWT format"
@@ -61,9 +77,9 @@ if command -v jq >/dev/null 2>&1; then
     NOW=$(date +%s)
     EXP_DATE=$(date -d "@$EXP" 2>/dev/null || date -r "$EXP" 2>/dev/null)
     if [[ $EXP -lt $NOW ]]; then
-      echo "⚠️  Token EXPIRED at: $EXP_DATE"
+      echo "Token EXPIRED at: $EXP_DATE"
     else
-      echo "✓ Token expires at: $EXP_DATE"
+      echo "Token expires at: $EXP_DATE"
     fi
   fi
 

package/dot_local/bin/executable_kill-port

@@ -1,6 +1,22 @@
 #!/usr/bin/env bash
-# Kill process running on specified port
-# Usage: kill-port <port> [--force]
+## Kill Port — Terminate processes listening on a specified port.
+##
+## Finds and kills processes bound to a given port number.
+## Supports both graceful (SIGTERM) and forced (SIGKILL) termination.
+##
+## # Requirements
+## - lsof, ss, or netstat: For finding processes
+## - kill: For process termination
+## - ps: For process information display
+##
+## # Usage
+## kill-port 3000              # Kill process on port 3000
+## kill-port 8080 --force      # Force kill (SIGKILL)
+## kill-port 443               # May require sudo for privileged ports
+##
+## # Platform Notes
+## - Linux: Uses lsof or ss
+## - macOS: Uses lsof
 
 set -euo pipefail
 

package/dot_local/bin/executable_lorem

@@ -1,6 +1,21 @@
 #!/usr/bin/env bash
-# Lorem ipsum text generator
-# Usage: lorem [words|sentences|paragraphs] [count]
+## Lorem Ipsum Generator — Generate placeholder text.
+##
+## Generates lorem ipsum text in words, sentences, or paragraphs.
+## Useful for testing layouts and content rendering.
+##
+## # Requirements
+## - bash 4+: For array operations
+##
+## # Usage
+## lorem                       # 1 paragraph
+## lorem p 3                   # 3 paragraphs
+## lorem words 10              # 10 words
+## lorem sentences 5           # 5 sentences
+## lorem w 50                  # 50 words (short form)
+##
+## # Platform Notes
+## - All platforms: Pure bash implementation
 
 set -euo pipefail
 
@@ -59,7 +74,7 @@ TYPE="${1:-paragraphs}"
 COUNT="${2:-1}"
 
 case "$TYPE" in
-  w|word|words)
+  w | word | words)
     for ((i = 0; i < COUNT; i++)); do
       if [[ $i -eq 0 ]]; then
         word=$(random_word)
@@ -70,18 +85,18 @@ case "$TYPE" in
     done
     echo
     ;;
-  s|sentence|sentences)
+  s | sentence | sentences)
     for ((i = 0; i < COUNT; i++)); do
       generate_sentence
     done
     ;;
-  p|paragraph|paragraphs)
+  p | paragraph | paragraphs)
     for ((i = 0; i < COUNT; i++)); do
       generate_paragraph
       [[ $i -lt $((COUNT - 1)) ]] && echo
     done
     ;;
-  -h|--help)
+  -h | --help)
     echo "Usage: lorem [type] [count]"
     echo ""
     echo "Types:"

package/dot_local/bin/executable_mkscript

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## mkscript — Create a ready-to-go shell script.
+##
+## # Usage
+##   mkscript hello
+##   mkscript /tmp/myscript
+
+set -euo pipefail
+
+file="${1:-}"
+
+if [[ -z "${file}" ]]; then
+  echo "Usage: mkscript <path>" >&2
+  exit 1
+fi
+
+if [[ -f "${file}" ]]; then
+  echo "${file} already exists, aborting." >&2
+  exit 1
+fi
+
+mkdir -p "$(dirname "${file}")"
+
+cat >"${file}" <<'EOF'
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+
+set -euo pipefail
+
+echo "hello world"
+EOF
+
+chmod +x "${file}"
+echo "Created ${file}"