@sebastienrousseau/dotfiles 0.2.499 → 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

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+# Hash calculator (MD5, SHA1, SHA256, SHA512)
+# Usage: hash [algorithm] <string|file>
+
+set -euo pipefail
+
+usage() {
+  echo "Usage: hash [OPTIONS] [INPUT]"
+  echo ""
+  echo "Algorithms:"
+  echo "  -m, --md5       MD5 hash"
+  echo "  -1, --sha1      SHA-1 hash"
+  echo "  -2, --sha256    SHA-256 hash (default)"
+  echo "  -5, --sha512    SHA-512 hash"
+  echo "  -a, --all       Show all hashes"
+  echo ""
+  echo "Options:"
+  echo "  -f, --file      Hash file contents"
+  echo "  -c, --check     Verify hash (input: hash to verify)"
+  echo "  -h, --help      Show this help"
+  echo ""
+  echo "Examples:"
+  echo "  hash 'hello'              # SHA256 of string"
+  echo "  hash -m 'hello'           # MD5 of string"
+  echo "  hash -f myfile.txt        # SHA256 of file"
+  echo "  hash -a 'hello'           # All hashes"
+  echo "  hash -c abc123 'hello'    # Verify hash"
+}
+
+ALGO="sha256"
+FILE_MODE=false
+CHECK_MODE=false
+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
+      ;;
+    *) break ;;
+  esac
+done
+
+# Get hash command based on algorithm
+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"
+      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"
+      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"
+      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"
+      else echo "openssl sha512 -r"; fi
+      ;;
+  esac
+}
+
+compute_hash() {
+  local algo="$1"
+  local input="$2"
+  local cmd
+  cmd=$(get_hash_cmd "$algo")
+
+  if $FILE_MODE; then
+    $cmd "$input" | awk '{print $1}'
+  else
+    echo -n "$input" | $cmd | awk '{print $1}'
+  fi
+}
+
+# Get input
+if [[ $# -gt 0 ]]; then
+  INPUT="$1"
+else
+  read -r INPUT
+fi
+
+# Validate file mode
+if $FILE_MODE && [[ ! -f "$INPUT" ]]; then
+  echo "Error: File not found: $INPUT"
+  exit 1
+fi
+
+if $ALL_MODE; then
+  echo "MD5:    $(compute_hash md5 "$INPUT")"
+  echo "SHA1:   $(compute_hash sha1 "$INPUT")"
+  echo "SHA256: $(compute_hash sha256 "$INPUT")"
+  echo "SHA512: $(compute_hash sha512 "$INPUT")"
+elif $CHECK_MODE; then
+  COMPUTED=$(compute_hash "$ALGO" "$INPUT")
+  EXPECTED_LOWER=$(echo "$EXPECTED" | tr '[:upper:]' '[:lower:]')
+  COMPUTED_LOWER=$(echo "$COMPUTED" | tr '[:upper:]' '[:lower:]')
+
+  if [[ "$EXPECTED_LOWER" == "$COMPUTED_LOWER" ]]; then
+    echo "✓ Hash matches"
+    exit 0
+  else
+    echo "✗ Hash mismatch"
+    echo "  Expected: $EXPECTED"
+    echo "  Got:      $COMPUTED"
+    exit 1
+  fi
+else
+  compute_hash "$ALGO" "$INPUT"
+fi

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

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+## 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
+
+usage() {
+  echo "Usage: hex [OPTIONS] [INPUT]"
+  echo ""
+  echo "Options:"
+  echo "  -e, --encode    Convert string to hex"
+  echo "  -d, --decode    Convert hex to string"
+  echo "  -c, --color     Colorize output"
+  echo "  -n, --length N  Bytes per line (default: 16)"
+  echo "  -h, --help      Show this help"
+  echo ""
+  echo "Examples:"
+  echo "  hex file.bin           # View file in hex"
+  echo "  hex -e 'hello'         # String to hex"
+  echo "  hex -d '68656c6c6f'    # Hex to string"
+  echo "  cat file | hex         # View stdin in hex"
+}
+
+MODE="view"
+COLOR=false
+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
+      ;;
+    *) break ;;
+  esac
+done
+
+case "$MODE" in
+  encode)
+    INPUT="${1:-}"
+    [[ -z "$INPUT" ]] && read -r INPUT
+    echo -n "$INPUT" | xxd -p | tr -d '\n'
+    echo
+    ;;
+
+  decode)
+    INPUT="${1:-}"
+    [[ -z "$INPUT" ]] && read -r INPUT
+    # Remove spaces and newlines
+    INPUT=$(echo "$INPUT" | tr -d ' \n')
+    echo "$INPUT" | xxd -r -p
+    echo
+    ;;
+
+  view)
+    if [[ $# -gt 0 ]] && [[ -f "$1" ]]; then
+      INPUT_FILE="$1"
+    else
+      INPUT_FILE="-"
+    fi
+
+    if command -v xxd >/dev/null 2>&1; then
+      if $COLOR && command -v bat >/dev/null 2>&1; then
+        xxd -c "$BYTES_PER_LINE" "$INPUT_FILE" | bat --language=xxd --style=plain
+      else
+        xxd -c "$BYTES_PER_LINE" "$INPUT_FILE"
+      fi
+    elif command -v hexdump >/dev/null 2>&1; then
+      hexdump -C "$INPUT_FILE"
+    elif command -v od >/dev/null 2>&1; then
+      od -A x -t x1z -v "$INPUT_FILE"
+    else
+      echo "Error: xxd, hexdump, or od required"
+      exit 1
+    fi
+    ;;
+esac

package/dot_local/bin/executable_jsonv

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+## 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
+
+FORMAT=false
+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
+      ;;
+    *) break ;;
+  esac
+done
+
+validate_json() {
+  local input="$1"
+  if command -v jq >/dev/null 2>&1; then
+    if $FORMAT; then
+      jq '.' <<<"$input"
+    else
+      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"
+    else
+      python3 -c "import json; json.loads('''$input''')" 2>/dev/null
+    fi
+  else
+    echo "Error: jq or python3 required"
+    exit 1
+  fi
+}
+
+# Read input
+if [[ $# -gt 0 ]] && [[ -f "$1" ]]; then
+  INPUT=$(cat "$1")
+  SOURCE="$1"
+else
+  INPUT=$(cat)
+  SOURCE="stdin"
+fi
+
+if validate_json "$INPUT"; then
+  $QUIET || echo "Valid JSON ($SOURCE)"
+  exit 0
+else
+  echo "Invalid JSON ($SOURCE)"
+  exit 1
+fi

package/dot_local/bin/executable_jwt

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+## 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
+
+decode_base64url() {
+  local input="$1"
+  # Add padding
+  local mod=$((${#input} % 4))
+  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 '-_' '+/')"
+}
+
+format_json() {
+  if command -v jq >/dev/null 2>&1; then
+    jq '.' 2>/dev/null || cat
+  elif command -v python3 >/dev/null 2>&1; then
+    python3 -m json.tool 2>/dev/null || cat
+  else
+    cat
+  fi
+}
+
+# Get token
+if [[ $# -gt 0 ]]; then
+  TOKEN="$1"
+else
+  read -r TOKEN
+fi
+
+# Remove 'Bearer ' prefix if present
+TOKEN="${TOKEN#Bearer }"
+TOKEN="${TOKEN#bearer }"
+
+# Split into parts
+IFS='.' read -ra PARTS <<<"$TOKEN"
+
+if [[ ${#PARTS[@]} -lt 2 ]]; then
+  echo "Error: Invalid JWT format"
+  exit 1
+fi
+
+echo "=== Header ==="
+decode_base64url "${PARTS[0]}" | format_json
+echo ""
+
+echo "=== Payload ==="
+PAYLOAD=$(decode_base64url "${PARTS[1]}")
+echo "$PAYLOAD" | format_json
+echo ""
+
+# Check expiration
+if command -v jq >/dev/null 2>&1; then
+  EXP=$(echo "$PAYLOAD" | jq -r '.exp // empty' 2>/dev/null)
+  IAT=$(echo "$PAYLOAD" | jq -r '.iat // empty' 2>/dev/null)
+
+  if [[ -n "$EXP" ]]; 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"
+    else
+      echo "Token expires at: $EXP_DATE"
+    fi
+  fi
+
+  if [[ -n "$IAT" ]]; then
+    IAT_DATE=$(date -d "@$IAT" 2>/dev/null || date -r "$IAT" 2>/dev/null)
+    echo "  Issued at: $IAT_DATE"
+  fi
+fi
+
+echo ""
+echo "=== Signature ==="
+echo "(${#PARTS[2]} characters, verification requires secret key)"