@sebastienrousseau/dotfiles 0.2.469 → 0.2.499

package/dist/lib/functions/backup.sh

@@ -1,143 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Cross-Platform Backup Utility (backup)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   backup is a utility that creates timestamped backups of files and directories.
-#   It can automatically compress large backups and maintains a configurable
-#   backup history.
-#
-# Usage:
-#   backup [--max-size SIZE] [--keep N] <file_or_directory> [<file_or_directory> ...]
-#
-# Arguments:
-#   <file_or_directory>     One or more file or directory paths to back up.
-#
-# Options:
-#   --max-size SIZE         Maximum uncompressed backup size before compression.
-#                           Uses 'M' for megabytes, 'K' for kilobytes, or no suffix
-#                           for bytes. Default is '100M' (100 megabytes).
-#
-#   --keep N                Number of most recent backups to keep. Older backups
-#                           are removed. Default is 5.
-#
-# Notes:
-#   - Backups are stored in a 'backups' directory in the current working directory.
-#     Adjust the BACKUP_DIR variable if needed.
-#   - The script creates a timestamped tar archive for the backup.
-#   - If the tar archive exceeds --max-size, it will be compressed with gzip.
-################################################################################
-
-backup() {
-  # Default configuration
-  BACKUP_DIR="${BACKUP_DIR:-./backups}"
-  MAX_SIZE="100M"   # Default max size before compression
-  KEEP=5             # Default number of backups to keep
-
-  # Parse arguments
-  while [[ "$#" -gt 0 ]]; do
-    case "$1" in
-      --max-size)
-        MAX_SIZE="$2"
-        shift 2
-        ;;
-      --keep)
-        KEEP="$2"
-        shift 2
-        ;;
-      -*)
-        echo "[ERROR] Unknown option: $1" >&2
-        return 1
-        ;;
-      *)
-        # Once we hit a non-option, break to treat all remaining as files/dirs
-        break
-        ;;
-    esac
-  done
-
-  # Ensure at least one file or directory is provided
-  if [[ "$#" -lt 1 ]]; then
-    echo "[ERROR] Please provide at least one file or directory to back up." >&2
-    return 1
-  fi
-
-  # Create backup directory if it doesn't exist
-  if [[ ! -d "$BACKUP_DIR" ]]; then
-    mkdir -p "$BACKUP_DIR"
-  fi
-
-  # Generate a timestamp for the backup filename
-  TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
-
-  # Construct a temporary tar archive name (uncompressed)
-  TAR_NAME="backup_${TIMESTAMP}.tar"
-  TAR_PATH="${BACKUP_DIR}/${TAR_NAME}"
-
-  # Create the tar archive
-  if tar cf "${TAR_PATH}" "$@"; then
-    echo "[INFO] Created backup archive '${TAR_PATH}'."
-  else
-    echo "[ERROR] Failed to create the backup archive." >&2
-    return 1
-  fi
-
-  # Convert MAX_SIZE to bytes for comparison
-  convert_size_to_bytes() {
-    local size_str="$1"
-    local num="${size_str//[!0-9]/}"
-    local unit=$(echo "${size_str}" | sed 's/[0-9]//g' | tr '[:upper:]' '[:lower:]')
-
-    case "$unit" in
-      m) echo $((num * 1024 * 1024)) ;;
-      k) echo $((num * 1024)) ;;
-      "") echo "${num}" ;; # No unit means bytes
-      *)
-        echo "[ERROR] Invalid unit in --max-size. Use M for megabytes, K for kilobytes, or no unit for bytes." >&2
-        return 1
-        ;;
-    esac
-  }
-
-  MAX_BYTES=$(convert_size_to_bytes "$MAX_SIZE")
-  [[ $? -ne 0 ]] && return 1
-
-  # Get file size in bytes using wc -c
-  FILE_SIZE=$(wc -c < "${TAR_PATH}")
-
-  if (( FILE_SIZE > MAX_BYTES )); then
-    # Compress the backup
-    if gzip "${TAR_PATH}"; then
-      COMPRESSED_PATH="${TAR_PATH}.gz"
-      echo "[INFO] Backup exceeded ${MAX_SIZE}. Compressed to '${COMPRESSED_PATH}'."
-    else
-      echo "[ERROR] Failed to compress the backup." >&2
-      return 1
-    fi
-  else
-    COMPRESSED_PATH="${TAR_PATH}"
-    echo "[INFO] No compression required."
-  fi
-
-  # Enforce backup retention
-  BACKUPS=($(ls -1t "${BACKUP_DIR}"/backup_*.tar* 2>/dev/null))
-  BACKUP_COUNT=${#BACKUPS[@]}
-
-  # Only attempt removal if we actually have more backups than KEEP
-  if (( BACKUP_COUNT > KEEP )); then
-    REMOVE_COUNT=$((BACKUP_COUNT - KEEP))
-    OLD_BACKUPS=("${BACKUPS[@]:$KEEP:$REMOVE_COUNT}")
-    for old_backup in "${OLD_BACKUPS[@]}"; do
-      if rm -f "$old_backup"; then
-        echo "[INFO] Removed old backup '$old_backup'."
-      else
-        echo "[ERROR] Failed to remove old backup '$old_backup'." >&2
-      fi
-    done
-  fi
-
-  echo "[INFO] Backup completed successfully. Current backups stored in '${BACKUP_DIR}'."
-}

package/dist/lib/functions/cdls.sh

@@ -1,60 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Change Directory and List Contents (cdls)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   cdls is a simple function that combines the functionality of `cd` and `ls`.
-#   When called, it changes the current working directory and immediately lists
-#   the contents of the new directory.
-#
-# Usage:
-#   cdls [directory]
-#   cdls --help
-#
-# Arguments:
-#   directory    The directory to change to. If omitted, changes to the home
-#                directory (default behavior of `cd`).
-#   --help       Displays this help menu and exits.
-#
-# Examples:
-#   cdls /tmp    # Changes to the /tmp directory and lists its contents.
-#   cdls         # Changes to the home directory and lists its contents.
-#   cdls --help  # Displays the help menu.
-#
-################################################################################
-
-# Function to combine cd and ls
-cdls() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "cdls: Change Directory and List Contents"
-    echo
-    echo "Usage:"
-    echo "  cdls [directory]"
-    echo "  cdls --help"
-    echo
-    echo "Aliases:"
-    echo "  alias cdl='cdls' # Alias for cdls to simplify usage"
-    echo
-    echo "Arguments:"
-    echo "  directory    The directory to change to. If omitted, changes to the home"
-    echo "               directory (default behavior of \`cd\`)."
-    echo "  --help       Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  cdls /tmp    # Changes to the /tmp directory and lists its contents."
-    echo "  cdls         # Changes to the home directory and lists its contents."
-    echo "  cdls --help  # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Change to the specified directory and list its contents
-  cd "$@" && ls
-}
-
-# Alias for convenience
-alias cdl='cdls' # Alias for cdls to simplify usage

package/dist/lib/functions/curlheader.sh

@@ -1,78 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Curl Header Viewer (curlheader)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   curlheader is a function to fetch and display HTTP headers for a given URL.
-#   It can either display all headers or filter for a specific header by name.
-#
-# Usage:
-#   curlheader [header] [url]
-#   curlheader --help
-#
-# Arguments:
-#   header    The specific HTTP header to filter and display (optional).
-#   url       The URL for which to fetch headers.
-#   --help    Displays this help menu and exits.
-#
-# Examples:
-#   curlheader https://example.com
-#       # Fetch and display all headers for the given URL.
-#
-#   curlheader Content-Type https://example.com
-#       # Fetch and display only the Content-Type header for the given URL.
-#
-#   curlheader --help
-#       # Displays the help menu.
-#
-################################################################################
-
-# Function to fetch and display HTTP headers
-curlheader() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "curlheader: Curl Header Viewer"
-    echo
-    echo "Usage:"
-    echo "  curlheader [header] [url]"
-    echo "  curlheader --help"
-    echo
-    echo "Arguments:"
-    echo "  header    The specific HTTP header to filter and display (optional)."
-    echo "  url       The URL for which to fetch headers."
-    echo "  --help    Displays this help menu and exits."
-    echo
-    echo "Aliases:"
-    echo "  alias chd='curlheader'  # Alias for curlheader"
-    echo "  alias chdr='curlheader' # Alias for curlheader"
-    echo
-    echo "Examples:"
-    echo "  curlheader https://example.com"
-    echo "      # Fetch and display all headers for the given URL."
-    echo
-    echo "  curlheader Content-Type https://example.com"
-    echo "      # Fetch and display only the Content-Type header for the given URL."
-    echo
-    echo "  curlheader --help"
-    echo "      # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Check if only a URL is provided
-  if [[ -z "$2" ]]; then
-    echo "Fetching all headers for URL: $1"
-    curl -k -s -D - "$1" -o /dev/null
-  else
-    # Fetch and filter for a specific header
-    echo "Fetching '$1' header for URL: $2"
-    curl -k -s -D - "$2" -o /dev/null | grep -i "$1:"
-  fi
-}
-
-# Aliases for convenience
-alias chd='curlheader'  # Alias for curlheader
-alias chdr='curlheader' # Alias for curlheader

package/dist/lib/functions/curlstatus.sh

@@ -1,74 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Curl HTTP Status Code Viewer (curlstatus)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   curlstatus is a function to fetch and display the HTTP status code for a
-#   given URL. It uses curl to make a request and extracts the HTTP status
-#   code.
-#
-# Usage:
-#   curlstatus [url]
-#   curlstatus --help
-#
-# Arguments:
-#   url         The URL for which to fetch the HTTP status code.
-#   --help      Displays this help menu and exits.
-#
-# Examples:
-#   curlstatus https://example.com
-#       # Fetch and display the HTTP status code for the given URL.
-#
-#   curlstatus --help
-#       # Displays the help menu.
-#
-################################################################################
-
-# Function to fetch and display HTTP status code
-curlstatus() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "curlstatus: Curl HTTP Status Code Viewer"
-    echo
-    echo "Usage:"
-    echo "  curlstatus [url]"
-    echo "  curlstatus --help"
-    echo
-    echo "Aliases:"
-    echo "  alias cs='curlstatus'       # Alias for curlstatus"
-    echo "  alias cst='curlstatus'      # Alias for curlstatus"
-    echo "  alias httpcode='curlstatus' # Alias for curlstatus"
-    echo
-    echo "Arguments:"
-    echo "  url         The URL for which to fetch the HTTP status code."
-    echo "  --help      Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  curlstatus https://example.com"
-    echo "      # Fetch and display the HTTP status code for the given URL."
-    echo
-    echo "  curlstatus --help"
-    echo "      # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Check if a URL is provided
-  if [[ -z "$1" ]]; then
-    echo "[ERROR] No URL provided. Use 'curlstatus --help' for usage information." >&2
-    return 1
-  fi
-
-  # Fetch and display the HTTP status code
-  echo "Fetching HTTP status code for URL: $1"
-  curl -k -s -o /dev/null -w "%{http_code}" "$1"
-  echo
-}
-
-# Aliases for convenience
-alias cs='curlstatus'       # Alias for curlstatus
-alias cst='curlstatus'      # Alias for curlstatus
-alias httpcode='curlstatus' # Alias for curlstatus

package/dist/lib/functions/curltime.sh

@@ -1,75 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Curl Timing Viewer (curltime)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   curltime is a function that measures and displays various timing metrics for
-#   an HTTP request made to a given URL using `curl`. It provides detailed
-#   information on DNS resolution time, connection time, and total transfer time.
-#
-# Usage:
-#   curltime [url]
-#   curltime --help
-#
-# Arguments:
-#   url         The URL for which to fetch timing metrics.
-#   --help      Displays this help menu and exits.
-#
-# Examples:
-#   curltime https://example.com
-#       # Displays the timing metrics for the given URL.
-#
-#   curltime --help
-#       # Displays the help menu.
-#
-################################################################################
-
-# Function to display timing metrics for a given URL
-curltime() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "curltime: Curl Timing Viewer"
-    echo
-    echo "Usage:"
-    echo "  curltime [url]"
-    echo "  curltime --help"
-    echo
-    echo "Arguments:"
-    echo "  url         The URL for which to fetch timing metrics."
-    echo "  --help      Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  curltime https://example.com"
-    echo "      # Displays the timing metrics for the given URL."
-    echo
-    echo "  curltime --help"
-    echo "      # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Check if a URL is provided
-  if [[ -z "$1" ]]; then
-    echo "[ERROR] No URL provided. Use 'curltime --help' for usage information." >&2
-    return 1
-  fi
-
-  # Fetch and display timing metrics for the URL
-  curl -w "\n\
-┌──────────────────────────────┐\n\
-│Time appconnect:    %{time_appconnect}s │\n\
-│Time connect:       %{time_connect}s │\n\
-│Time namelookup:    %{time_namelookup}s │\n\
-│Time pretransfer:   %{time_pretransfer}s │\n\
-│Time redirect:      %{time_redirect}s │\n\
-│Time starttransfer: %{time_starttransfer}s │\n\
-└──────────────────────────────┘\n\
-Time total:  %{time_total}s\n\n" -o /dev/null -s "$1"
-}
-
-# Aliases for convenience
-alias cht="curltime"  # Alias for curltime
-alias chtm="curltime" # Alias for curltime

package/dist/lib/functions/encode64.sh

@@ -1,107 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Base64 Encode and Decode (encode64/decode64)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   encode64 and decode64 are functions for encoding and decoding strings to and
-#   from base64. These functions can process input either directly as arguments
-#   or via standard input (pipe).
-#
-# Usage:
-#   encode64 [string]
-#   encode64 --help
-#
-#   decode64 [base64_string]
-#   decode64 --help
-#
-# Arguments:
-#   string             The string to encode into base64 (optional).
-#   base64_string      The base64-encoded string to decode (optional).
-#   --help             Displays the help menu and exits.
-#
-# Examples:
-#   echo "Hello World" | encode64
-#       # Encodes "Hello World" to base64 via pipe.
-#
-#   encode64 "Hello World"
-#       # Encodes "Hello World" to base64 directly from arguments.
-#
-#   decode64 "SGVsbG8gV29ybGQK"
-#       # Decodes the given base64 string to plaintext.
-#
-################################################################################
-
-# Function to encode a string to base64
-encode64() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "encode64: Encode a string to base64"
-    echo
-    echo "Usage:"
-    echo "  encode64 [string]"
-    echo "  encode64 --help"
-    echo
-    echo "Arguments:"
-    echo "  string     The string to encode into base64 (optional)."
-    echo "  --help     Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  echo \"Hello World\" | encode64"
-    echo "      # Encodes \"Hello World\" to base64 via pipe."
-    echo
-    echo "  encode64 \"Hello World\""
-    echo "      # Encodes \"Hello World\" to base64 directly from arguments."
-    echo
-    return 0
-  fi
-
-  # Encode input to base64
-  if [[ $# -eq 0 ]]; then
-    # Process input from stdin
-    cat | base64
-  else
-    # Process input from arguments
-    printf '%s' "$1" | base64
-  fi
-}
-
-# Function to decode a base64 string
-decode64() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "decode64: Decode a base64-encoded string"
-    echo
-    echo "Usage:"
-    echo "  decode64 [base64_string]"
-    echo "  decode64 --help"
-    echo
-    echo "Arguments:"
-    echo "  base64_string  The base64-encoded string to decode (optional)."
-    echo "  --help         Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  echo \"SGVsbG8gV29ybGQK\" | decode64"
-    echo "      # Decodes the base64 string via pipe."
-    echo
-    echo "  decode64 \"SGVsbG8gV29ybGQK\""
-    echo "      # Decodes the given base64 string to plaintext."
-    echo
-    return 0
-  fi
-
-  # Decode input from base64
-  if [[ $# -eq 0 ]]; then
-    # Process input from stdin
-    cat | base64 --decode
-  else
-    # Process input from arguments
-    printf '%s\n' "$1" | base64 --decode
-  fi
-}
-
-# Aliases for convenience
-alias e64=encode64 # Encode to base64.
-alias d64=decode64 # Decode from base64.

package/dist/lib/functions/environment.sh

@@ -1,78 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Environment Detector (environment)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   environment is a function that detects the current operating system
-#   environment. It identifies whether the system is macOS, Linux, or Windows
-#   (including Cygwin and MING environments).
-#
-# Usage:
-#   environment
-#   environment --help
-#
-# Arguments:
-#   --help      Displays this help menu and exits.
-#
-# Examples:
-#   environment
-#       # Detects and displays the current operating system environment.
-#
-#   environment --help
-#       # Displays the help menu.
-#
-################################################################################
-
-# Function to detect the current environment
-environment() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "environment: Environment Detector"
-    echo
-    echo "Usage:"
-    echo "  environment"
-    echo "  environment --help"
-    echo
-    echo "Arguments:"
-    echo "  --help      Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  environment"
-    echo "      # Detects and displays the current operating system environment."
-    echo
-    echo "  environment --help"
-    echo "      # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Detect the environment
-  LOCAL_OS="other"  # Fallback OS
-
-  # macOS
-  if [[ "$(uname -s | grep -c Darwin)" -gt 0 ]]; then
-    LOCAL_OS="mac"
-
-  # Linux
-  elif [[ "$(uname -s | grep -c Linux)" -gt 0 ]]; then
-    LOCAL_OS="linux"
-
-  # Windows via MING
-  elif [[ "$(uname -s | grep -c MING)" -gt 0 ]]; then
-    LOCAL_OS="win"
-
-  # Cygwin
-  elif [[ "$(uname -s | grep -c Cygwin)" -gt 0 ]]; then
-    LOCAL_OS="win"
-
-  # Cygwin via Babun
-  elif [[ "$(uname -s | grep -c CYGWIN)" -gt 0 ]]; then
-    LOCAL_OS="win"
-  fi
-
-  # Output the result
-  echo "${LOCAL_OS}"
-}

package/dist/lib/functions/extract.sh

@@ -1,86 +0,0 @@
-#!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - Archive Extractor (extract)
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# Description:
-#   extract is a function to extract most known archive formats with a single
-#   command. It supports various archive types like .tar, .zip, .gz, .7z, and more.
-#
-# Usage:
-#   extract [file]
-#   extract --help
-#
-# Arguments:
-#   file        The archive file to extract.
-#   --help      Displays this help menu and exits.
-#
-# Examples:
-#   extract file.tar.gz
-#       # Extracts the contents of file.tar.gz.
-#
-#   extract archive.zip
-#       # Extracts the contents of archive.zip.
-#
-#   extract --help
-#       # Displays the help menu.
-#
-################################################################################
-
-# Function to extract most known archive formats
-extract() {
-  # Display help menu
-  if [[ "$1" == "--help" ]]; then
-    echo "extract: Archive Extractor"
-    echo
-    echo "Usage:"
-    echo "  extract [file]"
-    echo "  extract --help"
-    echo
-    echo "Arguments:"
-    echo "  file        The archive file to extract."
-    echo "  --help      Displays this help menu and exits."
-    echo
-    echo "Examples:"
-    echo "  extract file.tar.gz"
-    echo "      # Extracts the contents of file.tar.gz."
-    echo
-    echo "  extract archive.zip"
-    echo "      # Extracts the contents of archive.zip."
-    echo
-    echo "  extract --help"
-    echo "      # Displays the help menu."
-    echo
-    return 0
-  fi
-
-  # Validate input
-  if [[ "$#" != 1 ]]; then
-    echo "[ERROR] Please provide one argument (the archive file to extract)." >&2
-    return 1
-  fi
-
-  # Check if the file exists
-  if [[ -f "$1" ]]; then
-    echo "[INFO] Extracting '$1'..."
-    case "$1" in
-      *.tar.bz2) tar xjf "$1" ;;
-      *.tar.gz)  tar xzf "$1" ;;
-      *.bz2)     bunzip2 "$1" ;;
-      *.rar)     unrar e "$1" ;;
-      *.gz)      gunzip "$1" ;;
-      *.tar)     tar xf "$1" ;;
-      *.tbz2)    tar xjf "$1" ;;
-      *.tgz)     tar xzf "$1" ;;
-      *.zip)     unzip "$1" ;;
-      *.Z)       uncompress "$1" ;;
-      *.7z)      7z x "$1" ;;
-      *)         echo "[ERROR] '$1' cannot be extracted via extract()." ;;
-    esac
-  else
-    echo "[ERROR] '$1' is not a valid file." >&2
-    return 1
-  fi
-}