@sebastienrousseau/dotfiles 0.2.469 → 0.2.481

package/dot_local/bin/executable_jsonv

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# JSON validator and formatter
+# Usage: jsonv <file> | jsonv (reads stdin) | jsonv --format <file>
+
+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,78 @@
+#!/usr/bin/env bash
+# JWT token decoder
+# Usage: jwt <token> | jwt (reads from stdin)
+
+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)"

package/dot_local/bin/executable_kill-port

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Kill process running on specified port
+# Usage: kill-port <port> [--force]
+
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: kill-port <port> [--force]"
+  echo "Example: kill-port 3000"
+  exit 1
+fi
+
+PORT="$1"
+FORCE=false
+[[ "${2:-}" == "--force" || "${2:-}" == "-f" ]] && FORCE=true
+
+# Validate port number
+if ! [[ "$PORT" =~ ^[0-9]+$ ]] || [[ "$PORT" -lt 1 ]] || [[ "$PORT" -gt 65535 ]]; then
+  echo "Error: Invalid port number: $PORT"
+  exit 1
+fi
+
+# Find process using the port
+find_pid() {
+  if command -v lsof >/dev/null 2>&1; then
+    lsof -ti ":$PORT" 2>/dev/null
+  elif command -v ss >/dev/null 2>&1; then
+    ss -tlnp "sport = :$PORT" 2>/dev/null | awk 'NR>1 {match($0, /pid=([0-9]+)/, a); print a[1]}'
+  elif command -v netstat >/dev/null 2>&1; then
+    netstat -tlnp 2>/dev/null | awk -v port=":$PORT" '$4 ~ port {split($7, a, "/"); print a[1]}'
+  else
+    echo "Error: No supported tool found (lsof, ss, or netstat required)"
+    exit 1
+  fi
+}
+
+PIDS=$(find_pid)
+
+if [[ -z "$PIDS" ]]; then
+  echo "No process found on port $PORT"
+  exit 0
+fi
+
+echo "Found process(es) on port $PORT:"
+for pid in $PIDS; do
+  ps -p "$pid" -o pid,comm,args --no-headers 2>/dev/null || echo "  PID: $pid"
+done
+
+if $FORCE; then
+  SIGNAL="-9"
+  echo "Force killing..."
+else
+  SIGNAL="-15"
+  echo "Sending SIGTERM..."
+fi
+
+for pid in $PIDS; do
+  kill $SIGNAL "$pid" 2>/dev/null && echo "Killed PID $pid" || echo "Failed to kill PID $pid"
+done

package/dot_local/bin/executable_lorem

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# Lorem ipsum text generator
+# Usage: lorem [words|sentences|paragraphs] [count]
+
+set -euo pipefail
+
+# Lorem ipsum word pool
+WORDS=(
+  "lorem" "ipsum" "dolor" "sit" "amet" "consectetur" "adipiscing" "elit"
+  "sed" "do" "eiusmod" "tempor" "incididunt" "ut" "labore" "et" "dolore"
+  "magna" "aliqua" "enim" "ad" "minim" "veniam" "quis" "nostrud"
+  "exercitation" "ullamco" "laboris" "nisi" "aliquip" "ex" "ea" "commodo"
+  "consequat" "duis" "aute" "irure" "in" "reprehenderit" "voluptate"
+  "velit" "esse" "cillum" "fugiat" "nulla" "pariatur" "excepteur" "sint"
+  "occaecat" "cupidatat" "non" "proident" "sunt" "culpa" "qui" "officia"
+  "deserunt" "mollit" "anim" "id" "est" "laborum" "perspiciatis" "unde"
+  "omnis" "iste" "natus" "error" "voluptatem" "accusantium" "doloremque"
+  "laudantium" "totam" "rem" "aperiam" "eaque" "ipsa" "quae" "ab" "illo"
+  "inventore" "veritatis" "quasi" "architecto" "beatae" "vitae" "dicta"
+  "explicabo" "nemo" "ipsam" "quia" "voluptas" "aspernatur" "aut" "odit"
+  "fugit" "consequuntur" "magni" "dolores" "eos" "ratione" "sequi"
+  "nesciunt" "neque" "porro" "quisquam" "dolorem" "adipisci" "numquam"
+  "eius" "modi" "tempora" "incidunt" "magnam" "quaerat"
+)
+
+random_word() {
+  echo "${WORDS[$RANDOM % ${#WORDS[@]}]}"
+}
+
+generate_sentence() {
+  local word_count=$((RANDOM % 10 + 5))
+  local sentence=""
+  for ((i = 0; i < word_count; i++)); do
+    if [[ $i -eq 0 ]]; then
+      word=$(random_word)
+      sentence="${word^}"
+    else
+      sentence="$sentence $(random_word)"
+    fi
+  done
+  echo "$sentence."
+}
+
+generate_paragraph() {
+  local sentence_count=$((RANDOM % 4 + 3))
+  local paragraph=""
+  for ((i = 0; i < sentence_count; i++)); do
+    if [[ $i -eq 0 ]]; then
+      paragraph=$(generate_sentence)
+    else
+      paragraph="$paragraph $(generate_sentence)"
+    fi
+  done
+  echo "$paragraph"
+}
+
+# Parse arguments
+TYPE="${1:-paragraphs}"
+COUNT="${2:-1}"
+
+case "$TYPE" in
+  w|word|words)
+    for ((i = 0; i < COUNT; i++)); do
+      if [[ $i -eq 0 ]]; then
+        word=$(random_word)
+        echo -n "${word^}"
+      else
+        echo -n " $(random_word)"
+      fi
+    done
+    echo
+    ;;
+  s|sentence|sentences)
+    for ((i = 0; i < COUNT; i++)); do
+      generate_sentence
+    done
+    ;;
+  p|paragraph|paragraphs)
+    for ((i = 0; i < COUNT; i++)); do
+      generate_paragraph
+      [[ $i -lt $((COUNT - 1)) ]] && echo
+    done
+    ;;
+  -h|--help)
+    echo "Usage: lorem [type] [count]"
+    echo ""
+    echo "Types:"
+    echo "  words, w        Generate words"
+    echo "  sentences, s    Generate sentences"
+    echo "  paragraphs, p   Generate paragraphs (default)"
+    echo ""
+    echo "Examples:"
+    echo "  lorem               # 1 paragraph"
+    echo "  lorem p 3           # 3 paragraphs"
+    echo "  lorem words 10      # 10 words"
+    echo "  lorem sentences 5   # 5 sentences"
+    ;;
+  *)
+    echo "Unknown type: $TYPE"
+    echo "Use: words, sentences, or paragraphs"
+    exit 1
+    ;;
+esac

package/dot_local/bin/executable_regex

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+# Regex tester
+# Usage: regex <pattern> <string> | regex -f <pattern> <file>
+
+set -euo pipefail
+
+usage() {
+  echo "Usage: regex [OPTIONS] <pattern> [string|file]"
+  echo ""
+  echo "Options:"
+  echo "  -f, --file       Test against file contents"
+  echo "  -g, --global     Find all matches"
+  echo "  -i, --ignore     Case insensitive"
+  echo "  -m, --multiline  Multiline mode"
+  echo "  -c, --color      Colorize matches"
+  echo "  -h, --help       Show this help"
+  echo ""
+  echo "Examples:"
+  echo "  regex '[0-9]+' 'abc123def'      # Test pattern"
+  echo "  regex -g '[a-z]+' 'hello world' # Find all"
+  echo "  regex -f '^#' config.txt        # Test file"
+}
+
+FILE_MODE=false
+GLOBAL=false
+IGNORE_CASE=""
+COLOR=true
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -f|--file) FILE_MODE=true; shift ;;
+    -g|--global) GLOBAL=true; shift ;;
+    -i|--ignore) IGNORE_CASE="-i"; shift ;;
+    -c|--color) COLOR=true; shift ;;
+    --no-color) COLOR=false; shift ;;
+    -h|--help) usage; exit 0 ;;
+    -*) echo "Unknown option: $1"; usage; exit 1 ;;
+    *) break ;;
+  esac
+done
+
+if [[ $# -lt 1 ]]; then
+  usage
+  exit 1
+fi
+
+PATTERN="$1"
+shift
+
+# Get input
+if $FILE_MODE; then
+  if [[ $# -lt 1 ]] || [[ ! -f "$1" ]]; then
+    echo "Error: File required for -f mode"
+    exit 1
+  fi
+  INPUT=$(cat "$1")
+elif [[ $# -gt 0 ]]; then
+  INPUT="$*"
+else
+  INPUT=$(cat)
+fi
+
+# Color settings
+if $COLOR; then
+  GREP_COLOR="--color=always"
+else
+  GREP_COLOR="--color=never"
+fi
+
+# Test and show matches
+echo "Pattern: $PATTERN"
+echo "---"
+
+if $GLOBAL; then
+  # Find all matches
+  if echo "$INPUT" | grep -oE $IGNORE_CASE "$PATTERN" $GREP_COLOR; then
+    echo "---"
+    MATCH_COUNT=$(echo "$INPUT" | grep -oE $IGNORE_CASE "$PATTERN" | wc -l)
+    echo "✓ Found $MATCH_COUNT match(es)"
+  else
+    echo "✗ No matches found"
+    exit 1
+  fi
+else
+  # Test if pattern matches
+  if echo "$INPUT" | grep -qE $IGNORE_CASE "$PATTERN"; then
+    echo "$INPUT" | grep -E $IGNORE_CASE "$PATTERN" $GREP_COLOR
+    echo "---"
+    echo "✓ Pattern matches"
+  else
+    echo "$INPUT"
+    echo "---"
+    echo "✗ Pattern does not match"
+    exit 1
+  fi
+fi

package/dot_local/bin/executable_tmux-sessionizer

@@ -0,0 +1,187 @@
+#!/usr/bin/env bash
+# tmux-sessionizer - Fuzzy session switcher for tmux
+#
+# This script provides a fuzzy-finder interface for switching between
+# tmux sessions and creating new sessions from project directories.
+#
+# Usage:
+#   tmux-sessionizer [directory]
+#
+# If no directory is provided, uses fzf to select from:
+#   - Existing tmux sessions
+#   - Project directories from configured paths
+#
+# Configuration:
+#   Set TMUX_SESSIONIZER_DIRS to customise search paths (colon-separated)
+#   Default: ~/projects:~/work:~/src:~/.dotfiles
+#
+# References:
+#   - ThePrimeagen's original: https://github.com/ThePrimeagen/.dotfiles
+
+set -euo pipefail
+
+# Configuration
+SESSIONIZER_DIRS="${TMUX_SESSIONIZER_DIRS:-$HOME/projects:$HOME/work:$HOME/src:$HOME/.dotfiles}"
+
+# Colours for output
+readonly RED='\033[0;31m'
+readonly GREEN='\033[0;32m'
+readonly NC='\033[0m' # No Colour
+
+log_error() {
+    echo -e "${RED}Error:${NC} $1" >&2
+}
+
+log_info() {
+    echo -e "${GREEN}Info:${NC} $1"
+}
+
+# Check dependencies
+if ! command -v fzf &>/dev/null; then
+    log_error "fzf is required but not installed."
+    exit 1
+fi
+
+if ! command -v tmux &>/dev/null; then
+    log_error "tmux is required but not installed."
+    exit 1
+fi
+
+# Get list of directories to search (as newline-separated list for safe iteration)
+get_search_dirs() {
+    local paths
+    IFS=':' read -ra paths <<< "$SESSIONIZER_DIRS"
+    for path in "${paths[@]}"; do
+        # Expand tilde
+        local expanded_path="${path/#\~/$HOME}"
+        if [[ -d "$expanded_path" ]]; then
+            printf '%s\n' "$expanded_path"
+        fi
+    done
+}
+
+# Get list of project directories
+get_projects() {
+    local search_dirs
+    search_dirs=$(get_search_dirs)
+
+    if [[ -z "$search_dirs" ]]; then
+        return
+    fi
+
+    # Find directories (1-2 levels deep) - iterate safely over newline-separated dirs
+    while IFS= read -r dir; do
+        find "$dir" -mindepth 1 -maxdepth 2 -type d 2>/dev/null
+    done <<< "$search_dirs" | sort -u
+}
+
+# Get list of existing tmux sessions
+get_sessions() {
+    tmux list-sessions -F "#{session_name}" 2>/dev/null || true
+}
+
+# Format session name from directory path (sanitized for tmux)
+format_session_name() {
+    local dir="$1"
+    local name
+
+    # Get basename, replace dots with underscores, and strip unsafe chars
+    name=$(basename "$dir" | tr '.' '_' | tr -cd '[:alnum:]._-')
+
+    # Remove leading numbers/dashes for cleaner names
+    name="${name##[0-9_-]}"
+    name="${name##[0-9_-]}"
+    name="${name##[0-9_-]}"
+
+    # If name is empty after cleanup, use sanitized full basename
+    if [[ -z "$name" ]]; then
+        name=$(basename "$dir" | tr -cd '[:alnum:]._-')
+    fi
+
+    # Limit length for safety
+    echo "${name:0:32}"
+}
+
+# Switch to or create a tmux session
+switch_to_session() {
+    local selected="$1"
+    local session_name
+
+    if [[ -z "$selected" ]]; then
+        log_error "No selection made."
+        exit 0
+    fi
+
+    # Check if selection is an existing session
+    if tmux has-session -t="$selected" 2>/dev/null; then
+        session_name="$selected"
+    else
+        # It's a directory - create or switch to session
+        if [[ ! -d "$selected" ]]; then
+            log_error "Directory does not exist: $selected"
+            exit 1
+        fi
+
+        session_name=$(format_session_name "$selected")
+
+        # Create session if it doesn't exist
+        if ! tmux has-session -t="$session_name" 2>/dev/null; then
+            tmux new-session -ds "$session_name" -c "$selected"
+            log_info "Created new session: $session_name"
+        fi
+    fi
+
+    # Switch to the session
+    if [[ -z "${TMUX:-}" ]]; then
+        # Not inside tmux - attach directly
+        tmux attach-session -t "$session_name"
+    else
+        # Inside tmux - switch client
+        tmux switch-client -t "$session_name"
+    fi
+}
+
+# Main function
+main() {
+    local selected
+
+    # If argument provided, use it directly
+    if [[ $# -eq 1 ]]; then
+        selected="$1"
+    else
+        # Build selection list: existing sessions + project directories
+        local sessions projects combined
+
+        sessions=$(get_sessions)
+        projects=$(get_projects)
+
+        # Combine and deduplicate
+        if [[ -n "$sessions" ]] && [[ -n "$projects" ]]; then
+            combined=$(printf "%s\n%s" "$sessions" "$projects" | sort -u)
+        elif [[ -n "$sessions" ]]; then
+            combined="$sessions"
+        elif [[ -n "$projects" ]]; then
+            combined="$projects"
+        else
+            log_error "No sessions or project directories found."
+            exit 1
+        fi
+
+        # Use fzf for selection
+        selected=$(echo "$combined" | fzf \
+            --height=50% \
+            --layout=reverse \
+            --border=rounded \
+            --prompt="Session > " \
+            --header="Select a session or directory" \
+            --preview='if [ -d {} ]; then ls -la {}; else tmux capture-pane -pt {} -p 2>/dev/null | head -20; fi' \
+            --preview-window=right:50%:wrap \
+            --bind='ctrl-d:preview-page-down' \
+            --bind='ctrl-u:preview-page-up' \
+        ) || exit 0
+    fi
+
+    switch_to_session "$selected"
+}
+
+main "$@"