@sebastienrousseau/dotfiles 0.2.469 → 0.2.499

package/dist/lib/functions/httpdebug.sh

@@ -1,113 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - HTTP Debugging Utility (httpdebug)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   httpdebug is a utility function to debug HTTP requests by measuring the
-#   timing of various stages of the request process in milliseconds. This
-#   includes DNS lookup, connection establishment, SSL handshake, and total
-#   request time. It also provides details like the server IP address.
-#
-# Usage:
-#   httpdebug [options] [url]
-#   httpdebug --help
-#
-# Arguments:
-#   options     Additional curl options (optional).
-#   url         The URL to debug.
-#   --help      Displays this help menu and exits.
-#
-# Examples:
-#   httpdebug https://example.com
-#       # Debugs the HTTP request to https://example.com and displays timing info.
-#
-#   httpdebug -v https://example.com
-#       # Debugs the HTTP request with verbose output from curl.
-#
-#   httpdebug --help
-#       # Displays the help menu.
-#
-################################################################################
-
-httpdebug() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "httpdebug: HTTP Debugging Utility"
-    echo
-    echo "Usage:"
-    echo "  httpdebug [options] [url]"
-    echo "  httpdebug --help"
-    echo
-    echo "Arguments:"
-    echo "  options     Additional curl options (optional)."
-    echo "  url         The URL to debug."
-    echo "  --help      Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  httpdebug https://example.com"
-    echo "      # Debugs the HTTP request to https://example.com and displays timing info."
-    echo
-    echo "  httpdebug -v https://example.com"
-    echo "      # Debugs the HTTP request with verbose output from curl."
-    echo
-    echo "  httpdebug --help"
-    echo "      # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Ensure curl is available
-  if ! command -v curl &>/dev/null; then
-    echo "[ERROR] 'curl' command is required but not installed. Please install it and try again." >&2
-    return 1
-  fi
-
-  # Check if a URL or options are provided
-  if [[ -z "$1" ]]; then
-    echo "[ERROR] No URL provided. Use 'httpdebug --help' for usage information." >&2
-    return 1
-  fi
-
-  # Perform HTTP request and measure timing
-  echo "[INFO] Debugging HTTP request to: ${*}"
-  curl_output=$(/usr/bin/curl "$@" -o /dev/null -s -w "\
-IP Address: %{remote_ip}\n\
-DNS Lookup: %{time_namelookup}\n\
-TCP Connection: %{time_connect}\n\
-SSL Handshake: %{time_appconnect}\n\
-Server Processing: %{time_pretransfer}\n\
-Time to First Byte: %{time_starttransfer}\n\
-Total Time: %{time_total}\n")
-
-  # Display results in a clean table format
-  printf "%-25s %-25s %-45s\n" "Metric" "Details" "Description"
-  printf "%-25s %-25s %-45s\n" "------------------------" "------------------------" "---------------------------------------------"
-
-  echo "$curl_output" | while IFS= read -r line; do
-    metric=$(echo "$line" | awk -F: '{print $1}')
-    value=$(echo "$line" | awk -F: '{print $2}' | xargs)
-    description=""
-
-    case "$metric" in
-      "IP Address") description="IP address of the server" ;;
-      "DNS Lookup") description="Time to resolve the domain name to an IP address" ;;
-      "TCP Connection") description="Time to establish a TCP connection to the server" ;;
-      "SSL Handshake") description="Time to complete the SSL/TLS handshake (if applicable)" ;;
-      "Server Processing") description="Time from connection to server readiness to transfer data" ;;
-      "Time to First Byte") description="Time until the first byte of the response is received" ;;
-      "Total Time") description="Total time for the request, including all stages" ;;
-    esac
-
-    if [[ "$metric" == "IP Address" ]]; then
-      printf "%-25s %-25s %-45s\n" "$metric" "$value" "$description"
-    else
-      # Convert time values to milliseconds for consistency
-      time_in_milliseconds=$(awk "BEGIN {printf \"%.2f\", $value * 1000}")
-      printf "%-25s %-25s %-45s\n" "$metric" "$time_in_milliseconds ms" "$description"
-    fi
-  done
-}
-

package/dist/lib/functions/kebabcase.sh

@@ -1,61 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Cross-Platform Kebabcase Utility (kebabcase)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   kebabcase converts file or directory names to kebab-case. All letters
-#   are lowercase and spaces or other non-alphanumeric characters are replaced
-#   by hyphens.
-#
-# Usage:
-#   kebabcase <file_or_directory> [<file_or_directory> ...]
-#
-# Arguments:
-#   <file_or_directory>     One or more file or directory paths to rename
-#                           to kebab-case.
-#
-# Notes:
-#   - Already kebab-case files are skipped.
-#   - Non-existent paths will produce an error message.
-#   - Special characters (other than alphanumeric and '.') are replaced
-#     with hyphens.
-#
-################################################################################
-
-kebabcase() {
-  if [[ "$#" -lt 1 ]]; then
-    echo "[ERROR] Please provide at least one file or directory to convert to kebab-case." >&2
-    return 1
-  fi
-
-  for file in "$@"; do
-    if [[ ! -e "$file" ]]; then
-      echo "[ERROR] The file or directory '$file' does not exist." >&2
-      continue
-    fi
-
-    dirname=$(dirname "$file")
-    filename=$(basename "$file")
-
-    # Convert to lowercase and replace non-alphanumeric chars (except '.') with hyphens
-    kc_filename=$(printf "%s" "$filename" \
-      | tr '[:upper:]' '[:lower:]' \
-      | sed 's/[^[:alnum:].]/-/g')
-
-    # If already kebab-case, skip
-    if [[ "$filename" == "$kc_filename" ]]; then
-      echo "[INFO] '$file' is already in kebab-case."
-      continue
-    fi
-
-    newname="${dirname}/${kc_filename}"
-    if mv "$file" "$newname"; then
-      echo "[INFO] Renamed '$file' to '$newname'."
-    else
-      echo "[ERROR] Failed to rename '$file'." >&2
-    fi
-  done
-}

package/dist/lib/functions/keygen.sh

@@ -1,194 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - SSH Key Generator (keygen)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   keygen is a utility function to generate high-quality SSH key pairs with
-#   strong encryption and entropy. Supports ed25519, RSA, ECDSA, and DSA keys
-#   with configurable key lengths.
-#
-# Usage:
-#   keygen [name] [email] [type] [bits]
-#   keygen --help
-#
-# Arguments:
-#   name        The name for the SSH key (e.g., username, service name)
-#   email       The email address associated with the key
-#   type        Key type (ed25519, rsa, ecdsa, dsa). Default: ed25519
-#   bits        Key length in bits (RSA: 2048-8192, ECDSA: 256/384/521)
-#   --help      Displays this help menu and exits
-#
-################################################################################
-
-log_info() {
-  echo "[INFO] $*"
-}
-
-log_warning() {
-  echo "[WARNING] $*" >&2
-}
-
-log_error() {
-  echo "[ERROR] $*" >&2
-  exit 1
-}
-
-keygen() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    cat << 'EOH'
-SSH Key Generator (keygen)
-
-Description:
-  keygen is a utility function to generate high-quality SSH key pairs with
-  strong encryption and entropy. Supports ed25519, RSA, ECDSA, and DSA keys
-  with configurable key lengths.
-
-Usage:
-  keygen [name] [email] [type] [bits]
-  keygen --help
-
-Arguments:
-  name        The name for the SSH key (e.g., username, service name).
-              This name is used to create a unique file path for the key.
-  email       The email address associated with the key.
-  type        Key type (ed25519, rsa, ecdsa, dsa). Default: ed25519.
-  bits        Key length in bits:
-             - RSA:   2048-8192 bits (default: 4096).
-             - ECDSA: 256, 384, or 521 bits (default: 256).
-             - DSA:   1024, 2048, or 3072 bits (default: 3072).
-             - ED25519: Fixed length.
-  --help      Displays this help menu and exits.
-
-Examples:
-  keygen
-      # Interactive mode with prompts.
-
-  keygen mykey myemail@example.com
-      # Generates an ed25519 key pair named 'mykey'.
-
-  keygen mykey myemail@example.com rsa 4096
-      # Generates a 4096-bit RSA key pair named 'mykey'.
-
-  keygen mykey myemail@example.com ecdsa 256
-      # Generates a 256-bit ECDSA key pair named 'mykey'.
-
-  keygen mykey myemail@example.com dsa 1024
-      # Generates a 1024-bit DSA key pair named 'mykey'.
-
-Notes:
-  - Keys are stored in ~/.ssh with the specified name.
-  - Public keys are copied to the clipboard for convenience.
-  - The private key is never exposed; keep it secure.
-
-EOH
-    return 0
-  fi
-
-  # Ensure ~/.ssh directory exists
-  mkdir -p -m 700 ~/.ssh || log_error "Failed to create ~/.ssh directory."
-
-  # Collect inputs
-  local name email key_type key_bits
-  if [[ $# -eq 0 ]]; then
-    echo "Enter a unique name for the SSH key (e.g., 'myserver' or 'username'):"
-    read -r name
-    echo "Enter an email address associated with the key:"
-    read -r email
-    echo "Enter key type (ed25519, rsa, ecdsa, dsa) [default: ed25519]:"
-    read -r key_type
-    key_type="${key_type:-ed25519}"
-
-    if [[ "${key_type}" != "ed25519" ]]; then
-      case "${key_type}" in
-        "rsa") echo "Enter RSA key length (2048-8192) [default: 4096]:" && read -r key_bits ;;
-        "ecdsa") echo "Enter ECDSA key length (256/384/521) [default: 256]:" && read -r key_bits ;;
-        "dsa") echo "Enter DSA key length (1024/2048/3072) [default: 3072]:" && read -r key_bits ;;
-        *) log_error "Invalid key type: ${key_type}" ;;
-      esac
-    fi
-  elif [[ $# -ge 2 ]]; then
-    name="$1"
-    email="$2"
-    key_type="${3:-ed25519}"
-    key_bits="$4"
-  else
-    log_error "Usage: keygen [name] [email] [type] [bits] or keygen --help"
-  fi
-
-  # Validate inputs
-  [[ ! "${name}" =~ ^[a-zA-Z0-9_-]+$ ]] && log_error "Invalid name format. Only alphanumeric, _, and - are allowed."
-  [[ ! "${email}" =~ ^[^@]+@[^@]+\.[^@]+$ ]] && log_error "Invalid email format."
-
-  # Key validation
-  key_type="${key_type:-ed25519}"
-  case "${key_type}" in
-    "ed25519") ;;
-    "rsa")
-      key_bits="${key_bits:-4096}"
-      [[ ! "${key_bits}" =~ ^[0-9]+$ ]] && log_error "RSA key length must be a number."
-      [[ "${key_bits}" -lt 2048 || "${key_bits}" -gt 8192 ]] && log_error "RSA key length must be between 2048 and 8192 bits."
-      ;;
-    "ecdsa")
-      key_bits="${key_bits:-256}"
-      [[ ! "${key_bits}" =~ ^(256|384|521)$ ]] && log_error "ECDSA key length must be 256, 384, or 521 bits."
-      ;;
-    "dsa")
-      key_bits="${key_bits:-3072}"
-      [[ ! "${key_bits}" =~ ^(1024|2048|3072)$ ]] && log_error "DSA key length must be 1024, 2048, or 3072 bits."
-      ;;
-    *) log_error "Invalid key type: ${key_type}. Use 'ed25519', 'rsa', 'ecdsa', or 'dsa'." ;;
-  esac
-
-  # Set file paths
-  local key_path="${HOME}/.ssh/id_${key_type}_${name}"
-
-  # Generate key pair
-  log_info "Generating ${key_type} SSH key named '${name}'..."
-  if [[ "${key_type}" == "ed25519" ]]; then
-    ssh-keygen -t ed25519 -f "${key_path}" -C "${email}"
-  else
-    ssh-keygen -t "${key_type}" -b "${key_bits}" -f "${key_path}" -C "${email}"
-  fi
-
-  # Set permissions
-  chmod 600 "${key_path}" && chmod 644 "${key_path}.pub"
-
-  # Add to SSH agent
-  if ! ssh-add "${key_path}" &>/dev/null; then
-    log_warning "SSH agent not running. Start it and run 'ssh-add ${key_path}'."
-  fi
-
-  # Copy to clipboard
-  copy_to_clipboard "${key_path}.pub"
-
-  # Display success message
-  log_info "SSH key successfully generated!"
-  echo "  Private key: ${key_path}"
-  echo "  Public key: ${key_path}.pub"
-
-  # Display fingerprint
-  ssh-keygen -l -f "${key_path}.pub"
-}
-
-copy_to_clipboard() {
-  local pub_key_file="$1"
-  if command -v pbcopy &>/dev/null; then
-    pbcopy < "${pub_key_file}"
-    log_info "Public key copied to clipboard (macOS)."
-  elif command -v xclip &>/dev/null; then
-    xclip -selection clipboard < "${pub_key_file}"
-    log_info "Public key copied to clipboard (Linux)."
-  elif command -v wl-copy &>/dev/null; then
-    wl-copy < "${pub_key_file}"
-    log_info "Public key copied to clipboard (Wayland)."
-  elif command -v clip.exe &>/dev/null; then
-    clip.exe < "${pub_key_file}"
-    log_info "Public key copied to clipboard (Windows)."
-  else
-    log_warning "Clipboard tool not available. Public key not copied."
-  fi
-}

package/dist/lib/functions/last.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Recently Modified Files Viewer (last)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   last is a utility function to list recently modified files within a
-#   specified time range. By default, it lists files modified in the last 60
-#   minutes but allows customization.
-#
-# Usage:
-#   last [minutes]
-#   last --help
-#
-# Arguments:
-#   minutes     Number of minutes to look back for modified files (default: 60)
-#             Maximum: 7 days (10080 minutes)
-#   --help      Displays this help menu and exits
-#
-################################################################################
-
-log_info() {
-  echo "[INFO] $*"
-}
-
-log_error() {
-  echo "[ERROR] $*" >&2
-  exit 1
-}
-
-detect_tool() {
-  if command -v /usr/bin/find &>/dev/null; then
-    echo "find"
-  elif command -v fd &>/dev/null; then
-    echo "fd"
-  elif command -v rg &>/dev/null; then
-    echo "rg"
-  else
-    log_error "No compatible tools found (find, fd, or rg)."
-  fi
-}
-
-last() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    cat << 'EOH'
-🅳🅾🆃🅵🅸🅻🅴🆂 - Recently Modified Files Viewer
-
-Description:
-  last is a utility function to list recently modified files within a specified
-  time range. By default, it lists files modified in the last 60 minutes.
-
-Usage:
-  last [minutes]
-  last --help
-
-Arguments:
-  minutes     Number of minutes to look back for modified files (default: 60)
-             Maximum: 7 days (10080 minutes)
-  --help      Displays this help menu and exits
-
-Examples:
-  last
-      # Lists files modified within the last 60 minutes
-  last 120
-      # Lists files modified within the last 120 minutes
-
-Notes:
-  - Only regular files are shown
-  - Symbolic links and directories are excluded from the results
-  - Searches recursively starting from the current directory
-  - Maximum time range is 7 days (10080 minutes)
-EOH
-    return 0
-  fi
-
-  # Default time range (60 minutes)
-  local minutes=${1:-60}
-
-  # Validate that the input is a positive integer
-  if ! [[ "$minutes" =~ ^[0-9]+$ ]]; then
-    log_error "Invalid input: '$minutes'. Please provide a positive integer for minutes."
-  fi
-
-  # Check maximum time range (7 days = 10080 minutes)
-  if ((minutes > 10080)); then
-    log_error "Time range too large. Maximum is 7 days (10080 minutes)."
-  fi
-
-  # Detect which tool to use
-  local tool
-  tool=$(detect_tool)
-
-  # Find and list modified files
-  log_info "Listing files modified in the last ${minutes} minutes (using $tool):"
-  case "$tool" in
-    "find")
-      /usr/bin/find . -type f -mmin -"${minutes}"
-      ;;
-    "fd")
-      fd --type file --changed-within "${minutes}m"
-      ;;
-    "rg")
-      rg --type file --changed-within "${minutes}m"
-      ;;
-    *)
-      log_error "Unknown tool detected."
-      ;;
-  esac
-}

package/dist/lib/functions/logout.sh

@@ -1,120 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Cross-Platform Logout Utility (logout)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   logout is a utility function to log out from macOS, Linux, or Windows via
-#   the terminal. It provides options for confirmation and forceful logout if
-#   necessary.
-#
-# Usage:
-#   logout [--force] [--help]
-#
-# Arguments:
-#   --force     Skips confirmation and forces logout.
-#   --help      Displays this help menu and exits.
-#
-################################################################################
-
-log_info() {
-  echo "[INFO] $*"
-}
-
-log_warning() {
-  echo "[WARNING] $*" >&2
-}
-
-log_error() {
-  echo "[ERROR] $*" >&2
-  exit 1
-}
-
-logout() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    cat << 'EOH'
-Cross-Platform Logout Utility (logout)
-
-Description:
-  logout is a utility function to log out from macOS, Linux, or Windows via the
-  terminal. It provides options for confirmation and forceful logout if
-  necessary.
-
-Usage:
-  logout [--force] [--help]
-
-Arguments:
-  --force     Skips confirmation and forces logout.
-  --help      Displays this help menu and exits.
-
-Examples:
-  logout
-      # Prompts for confirmation before logging out.
-
-  logout --force
-      # Logs out immediately without confirmation.
-
-Notes:
-  - Requires administrative privileges for some systems (Linux/Windows).
-  - May prompt for a password depending on system settings.
-EOH
-    return 0
-  fi
-
-  # Check if the user passed --force
-  local force=false
-  if [[ "$1" == "--force" ]]; then
-    force=true
-  fi
-
-  # Prompt for confirmation if not forced
-  if [[ "$force" == false ]]; then
-    echo "Are you sure you want to log out? (y/n):"
-    read -r response
-    case "$response" in
-      [Yy]*)
-        ;;
-      *)
-        log_info "Logout canceled."
-        return 0
-        ;;
-    esac
-  fi
-
-  # Detect operating system
-  local os
-  os=$(uname | tr '[:upper:]' '[:lower:]')
-
-  case "$os" in
-    "darwin")
-      log_info "Logging out from macOS..."
-      if ! osascript -e 'tell application "System Events" to log out'; then
-        log_error "Failed to log out using AppleScript. Try logging out manually."
-      fi
-      ;;
-    "linux")
-      log_info "Logging out from Linux..."
-      if command -v gnome-session-quit &>/dev/null; then
-        gnome-session-quit --logout --no-prompt
-      elif command -v loginctl &>/dev/null; then
-        loginctl terminate-user "$USER"
-      else
-        log_error "Unable to determine logout method for your Linux system. Try logging out manually."
-      fi
-      ;;
-    "msys" | "cygwin" | "mingw"*)
-      log_info "Logging out from Windows..."
-      if ! shutdown /l; then
-        log_error "Failed to log out from Windows. Try logging out manually."
-      fi
-      ;;
-    *)
-      log_error "Unsupported operating system: $os"
-      ;;
-  esac
-
-  return 0
-}

package/dist/lib/functions/lowercase.sh

@@ -1,61 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Cross-Platform Lowercase Utility (lowercase)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   lowercase is a utility function that converts file or directory names to
-#   lowercase. It supports multiple arguments and provides informative messages
-#   for each operation, including errors and successful renames.
-#
-# Usage:
-#   lowercase <file_or_directory> [<file_or_directory> ...]
-#
-# Arguments:
-#   <file_or_directory>     One or more file or directory paths to rename
-#                           to lowercase.
-#
-# Notes:
-#   - This utility will skip renaming files or directories that are already
-#     in lowercase.
-#   - Invalid or non-existent paths will result in an error message.
-#
-################################################################################
-
-lowercase() {
-  # Ensure at least one argument is provided
-  if [[ "$#" -lt 1 ]]; then
-    echo "[ERROR] Please provide at least one file or directory to convert to lowercase." >&2
-    return 1
-  fi
-
-  for file in "$@"; do
-    # Check if the file/directory exists
-    if [[ ! -e "$file" ]]; then
-      echo "[ERROR] The file or directory '$file' does not exist." >&2
-      continue
-    fi
-
-    dirname=$(dirname "$file")
-    filename=$(basename "$file")
-
-    # Convert filename to lowercase using tr
-    nf=$(printf "%s" "$filename" | tr '[:upper:]' '[:lower:]')
-
-    # If already lowercase, skip
-    if [[ "$filename" == "$nf" ]]; then
-      echo "[INFO] '$file' is already in lowercase."
-      continue
-    fi
-
-    newname="${dirname}/${nf}"
-
-    if mv "$file" "$newname"; then
-      echo "[INFO] Renamed '$file' to '$newname'."
-    else
-      echo "[ERROR] Failed to rename '$file'." >&2
-    fi
-  done
-}