@sebastienrousseau/dotfiles 0.2.466 → 0.2.469

package/dist/lib/functions/last.sh

@@ -1,11 +1,112 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - 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: List the modified files within 60 minutes.
 last() {
-  find . -type f -mmin -60
+  # 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,12 +1,120 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - 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: Function to logout from OS X via the Terminal
 logout() {
-	osascript -e 'tell application "System Events" to log out'
-	builtin 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,29 +1,61 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - 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: Function to move filenames or directory names to lowercase
 lowercase() {
-  if [[ "$#" != 1 ]]; then
-    echo "[ERROR] The filename or directory name is incorrect." >&2
+  # 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; do
-    filename=${file##*/}
-    case "${filename}" in
-    */*) [[ "dirname" = "${file%/*}" ]] ;;
-    *) dirname=. ;;
-    esac
-    nf=$(echo "${filename}" | tr '[:upper:]' '[:lower:]')
+
+  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 [[ "${nf}" != "${filename}" ]]; then
-      mv "${file}" "${newname}"
-      echo "[INFO] Renaming ${file} to lowercase: ${newname}"
+
+    if mv "$file" "$newname"; then
+      echo "[INFO] Renamed '$file' to '$newname'."
     else
-      echo "[ERROR] The operation is not valid, ${file} has not changed."
+      echo "[ERROR] Failed to rename '$file'." >&2
     fi
   done
 }

package/dist/lib/functions/matrix.sh

@@ -1,41 +1,216 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - Matrix Effect Generator (matrix)
+# Made with ♥ by Sebastien Rousseau
 # License: MIT
+#
+# Description:
+#   matrix is a utility function to generate Matrix-style effects in the terminal
+#   with customizable colors. It supports multiple color themes and a rainbow
+#   effect option.
+#
+################################################################################
 
-# matrix: Function to Enable Matrix Effect in the terminal
-matrix() {
-  printf '\e[1;40m'
+# Define colors
+MATRIX_GREEN='\033[38;5;46m'    # Green (#00FF00)
+MATRIX_PURPLE='\033[38;5;55m'   # Purple (#2D1681)
+MATRIX_RED='\033[38;5;196m'     # Red (#EB0000)
+MATRIX_BLUE='\033[38;5;33m'     # Blue (#007ACC)
+MATRIX_WHITE='\033[38;5;15m'    # White (#FFFFFF)
+MATRIX_YELLOW='\033[38;5;226m'  # Yellow
+RESET_COLOR='\033[0m'
+
+VERSION="1.0.0"
+
+# Logging functions
+log_info() {
+  echo "[INFO] $*"
+}
+
+log_warning() {
+  echo "[WARNING] $*" >&2
+}
+
+log_error() {
+  echo "[ERROR] $*" >&2
+  exit 1
+}
+
+show_help() {
+  cat << 'EOH'
+🅳🅾🆃🅵🅸🅻🅴🆂 - Matrix Effect Generator (matrix)
+
+Description:
+  Generate Matrix-style effects in the terminal with customizable colors.
+  Supports multiple color themes and a rainbow effect option.
+
+Usage:
+  matrix [options]
+  matrix --help
+
+Options:
+  --color <name>       Select color theme:
+                        green   - Classic green (default)
+                        purple  - Purple (#2D1681)
+                        red     - Red (#EB0000)
+                        blue    - Blue (#007ACC)
+                        white   - White (#FFFFFF)
+                        yellow  - Yellow
+  --rainbow            Enable rainbow color effect
+  --slow               Reduce animation speed
+  --fast               Increase animation speed
+  --help               Display this help menu and exit
+  --version            Display version information and exit
+
+Examples:
+  matrix
+      # Classic green Matrix effect
+
+  matrix --color purple
+      # Purple Matrix effect
+
+  matrix --rainbow
+      # Rainbow color effect
+
+  matrix --color blue --slow
+      # Slow blue Matrix effect
+
+Notes:
+  - Press Ctrl+C to exit
+  - Animation speed can be adjusted with --slow or --fast
+  - Terminal size is automatically detected
+  - Minimum terminal size required: 20x10
+  - Colors can be customized by modifying the color variables
+EOH
+}
+
+show_version() {
+  echo "Matrix Effect Generator v${VERSION}"
+}
+
+cleanup() {
+  printf '\e[?25h'  # Show cursor
+  tput rmcup        # Restore screen
+  tput cnorm        # Show cursor
   clear
-  while : || true; do
-    echo "${LINES} ${COLUMNS} $((RANDOM % COLUMNS)) $((RANDOM % 72))"
-    sleep 0.05 || true
-  done | awk '{ letters="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789@#$%^&*()"; c=$4; letter=substr(letters,c,1);a[$3]=0;for (x in a) {o=a[x];a[x]=a[x]+1; printf "\033[%s;%sH\033[2;32m%s",o,x,letter; printf "\033[%s;%sH\033[1;37m%s\033[0;0H",a[x],x,letter;if (a[x] >= $1) { a[x]=0; } }}'
+  exit 0
 }
 
-# matrix: Function to Enable Matrix Effect in the terminal in color
-matrix_color() {
+matrix() {
+  # Check for help and version flags before parsing options
+  if [[ "$1" == "--help" ]]; then
+    show_help
+    return 0
+  elif [[ "$1" == "--version" ]]; then
+    show_version
+    return 0
+  fi
+
+  # Check terminal size
+  if [[ "${LINES:-0}" -lt 10 || "${COLUMNS:-0}" -lt 20 ]]; then
+    log_error "Terminal window too small. Minimum size: 20x10"
+  fi
+
+  # Default settings
+  local color="$MATRIX_GREEN"
+  local speed=0.05
+  local rainbow=false
+
+  # Parse options
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --color)
+        case "$2" in
+          green) color="$MATRIX_GREEN" ;;
+          purple) color="$MATRIX_PURPLE" ;;
+          red) color="$MATRIX_RED" ;;
+          blue) color="$MATRIX_BLUE" ;;
+          white) color="$MATRIX_WHITE" ;;
+          yellow) color="$MATRIX_YELLOW" ;;
+          *) log_error "Invalid color: '$2'. Use 'matrix --help' for available colors." ;;
+        esac
+        shift 2
+        ;;
+      --rainbow)
+        rainbow=true
+        shift
+        ;;
+      --slow)
+        speed=0.1
+        shift
+        ;;
+      --fast)
+        speed=0.02
+        shift
+        ;;
+      --help)
+        show_help
+        return 0
+        ;;
+      --version)
+        show_version
+        return 0
+        ;;
+      *)
+        log_error "Unknown option: '$1'. Use 'matrix --help' for usage information."
+        ;;
+    esac
+  done
+
+  # Save screen state and hide cursor
+  tput smcup
+  printf '\e[?25l'
   printf '\e[1;40m'
   clear
-  while : || true; do
-    echo "${LINES} ${COLUMNS} $((RANDOM % COLUMNS)) $((RANDOM % 72))"
-    sleep 0.05 || true
-  done | awk '{
-    letters="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789@#$%^&*()";
-    c=$4;
-    letter=substr(letters,c,1);
-    a[$3]=0;
-    for (x in a) {
-      o=a[x];
-      a[x]=a[x]+1;
-      color="\033[38;5;" int(rand()*255) "m";
-      printf "\033[%s;%sH%s%s",o,x,color,letter;
-      printf "\033[%s;%sH\033[0m%s\033[0;0H",a[x],x,letter;
-      if (a[x] >= $1) {
-        a[x]=0;
+
+  # Trap cleanup for exit signals
+  trap cleanup INT TERM EXIT
+
+  if $rainbow; then
+    # Rainbow effect
+    while true; do
+      echo "${LINES:-40} ${COLUMNS:-80} $((RANDOM % COLUMNS)) $((RANDOM % 72))"
+      sleep "$speed"
+    done | awk -v reset="$RESET_COLOR" '
+    {
+      letters="日ﾊﾐﾋｰｳｼﾅﾐﾆｻﾜﾂｵﾘｱﾎﾃﾏｹﾒｴｶｷﾑﾕﾗｾﾈｽﾀﾇﾍ";
+      c=$4;
+      if (c <= 0 || c > length(letters)) next;
+      letter=substr(letters, c, 1);
+      a[$3] = 0;
+      for (x in a) {
+        o = a[x];
+        a[x] = a[x] + 1;
+        random_color = "\033[38;5;" int(rand() * 255) "m";
+        if (o > 0 && x > 0) {
+          printf "\033[%s;%sH%s%s%s", o, x, random_color, letter, reset;
+          printf "\033[%s;%sH%s%s%s", a[x], x, reset, letter, reset;
+        }
+        if (a[x] >= $1) a[x] = 0;
+      }
+    }'
+  else
+    # Single color effect
+    while true; do
+      echo "${LINES:-40} ${COLUMNS:-80} $((RANDOM % COLUMNS)) $((RANDOM % 72))"
+      sleep "$speed"
+    done | awk -v color="$color" -v reset="$RESET_COLOR" '
+    {
+      letters="日ﾊﾐﾋｰｳｼﾅﾐﾆｻﾜﾂｵﾘｱﾎﾃﾏｹﾒｴｶｷﾑﾕﾗｾﾈｽﾀﾇﾍ";
+      c=$4;
+      if (c <= 0 || c > length(letters)) next;
+      letter=substr(letters, c, 1);
+      a[$3] = 0;
+      for (x in a) {
+        o = a[x];
+        a[x] = a[x] + 1;
+        if (o > 0 && x > 0) {
+          printf "\033[%s;%sH%s%s%s", o, x, color, letter, reset;
+          printf "\033[%s;%sH%s%s%s", a[x], x, reset, letter, reset;
+        }
+        if (a[x] >= $1) a[x] = 0;
       }
-    }
-  }'
+    }'
+  fi
 }

package/dist/lib/functions/mount_read_only.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # mount_read_only: Function to mount a read-only disk image as read-write

package/dist/lib/functions/myproc.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # myproc: Function to list processes owned by an user

package/dist/lib/functions/prependpath.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 #   ----------------------------------------------------------------------------

package/dist/lib/functions/ql.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # ql: Function to open any file in MacOS Quicklook Preview

package/dist/lib/functions/rd.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # rd: Function to remove a directory and its files

package/dist/lib/functions/remove_disk.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # remove_disk: spin down unneeded disk