Update README.md

Author: buildplan

README.md

@@ -222,11 +222,13 @@ END_EXCLUDES
 
 # =================================================================
 #                 SCRIPT INITIALIZATION & SETUP
-#                      v0.12 - 2025.08.10
+#                      v0.13 - 2025.08.10
 # =================================================================
 set -Euo pipefail
 umask 077
 
+HOSTNAME=$(hostname -s)
+
 # Check if the script is being run as root
 if (( EUID != 0 )); then
     echo "❌ This script must be run as root or with sudo." >&2
@@ -251,7 +253,7 @@ if [ -f "$CONFIG_FILE" ]; then
         fi
 
         if $in_exclude_block; then
-            [[ ! "$line" =~ ^\s*#|^\s*$ ]] && echo "$line" >> "$EXCLUDE_FILE_TMP"
+            [[ ! "$line" =~ ^([[:space:]]*#|[[:space:]]*$) ]] && echo "$line" >> "$EXCLUDE_FILE_TMP"
             continue
         fi
 
@@ -383,34 +385,54 @@ cleanup() {
 #               PRE-FLIGHT CHECKS & SETUP
 # =================================================================
 
+run_preflight_checks() {
+    # This function runs all checks. If 'true' is passed as an argument,
+    # it runs in a verbose test mode instead of sending notifications.
+    local test_mode=${1:-false}
+    local check_failed=false
+
+    # 1. Check for required commands
+    if [[ "$test_mode" == "true" ]]; then echo "--- Checking required commands..."; fi
+    for cmd in "${REQUIRED_CMDS[@]}"; do
+        if ! command -v "$cmd" &>/dev/null; then
+            echo "❌ FATAL: Required command '$cmd' not found. Please install it." >&2
+            check_failed=true
+        fi
+    done
+    if [[ "$check_failed" == "true" ]]; then exit 10; fi
+    if [[ "$test_mode" == "true" ]]; then echo "✅ All required commands are present."; fi
+
+    # 2. Check SSH connectivity
+    if [[ "$test_mode" == "true" ]]; then echo "--- Checking SSH connectivity..."; fi
+    if ! ssh ${SSH_OPTS_STR:-} -o BatchMode=yes -o ConnectTimeout=10 "$HETZNER_BOX" 'exit' 2>/dev/null; then
+        local err_msg="Unable to SSH into $HETZNER_BOX. Check keys and connectivity."
+        if [[ "$test_mode" == "true" ]]; then echo "❌ $err_msg"; else send_notification "❌ SSH FAILED: ${HOSTNAME}" "x" "${NTFY_PRIORITY_FAILURE}" "failure" "$err_msg"; fi
+        exit 6
+    fi
+    if [[ "$test_mode" == "true" ]]; then echo "✅ SSH connectivity OK."; fi
+
+    # 3. Check backup directories
+    if [[ "$test_mode" == "true" ]]; then echo "--- Checking backup directories..."; fi
+    for dir in $BACKUP_DIRS; do
+        if [[ ! -d "$dir" ]] || [[ "$dir" != */ ]]; then 
+            local err_msg="A directory in BACKUP_DIRS ('$dir') must exist and end with a trailing slash ('/')."
+            if [[ "$test_mode" == "true" ]]; then echo "❌ FATAL: $err_msg"; else send_notification "❌ Backup FAILED: ${HOSTNAME}" "x" "${NTFY_PRIORITY_FAILURE}" "failure" "FATAL: $err_msg"; fi
+            exit 2
+        fi
+    done
+    if [[ "$test_mode" == "true" ]]; then echo "✅ All backup directories are valid."; fi
+}
+
 trap cleanup EXIT
 trap 'send_notification "❌ Backup Crashed: ${HOSTNAME}" "x" "${NTFY_PRIORITY_FAILURE}" "failure" "Backup script terminated unexpectedly. Check log: ${LOG_FILE:-/dev/null}"' ERR
 
 REQUIRED_CMDS=(rsync curl flock hostname date stat mv touch awk numfmt grep printf nice ionice sed mktemp basename)
-for cmd in "${REQUIRED_CMDS[@]}"; do
-    if ! command -v "$cmd" &>/dev/null; then
-        echo "FATAL: Required command '$cmd' not found. Please install it." >&2; trap - ERR; exit 10
-    fi
-done
-
-if ! ssh ${SSH_OPTS_STR:-} -o BatchMode=yes -o ConnectTimeout=10 "$HETZNER_BOX" 'exit' 2>/dev/null; then
-    send_notification "❌ SSH FAILED: ${HOSTNAME}" "x" "${NTFY_PRIORITY_FAILURE}" "failure" "Unable to SSH into $HETZNER_BOX. Check keys and connectivity."
-    trap - ERR; exit 6
-fi
-
-for dir in $BACKUP_DIRS; do
-    if [[ ! -d "$dir" ]] || [[ "$dir" != */ ]]; then
-        send_notification "❌ Backup FAILED: ${HOSTNAME}" "x" "${NTFY_PRIORITY_FAILURE}" "failure" "FATAL: A directory in BACKUP_DIRS ('$dir') must exist and end with a trailing slash ('/')."
-        trap - ERR; exit 2
-    fi
-done
 
 
 # =================================================================
 #                       SCRIPT EXECUTION
 # =================================================================
 
-HOSTNAME=$(hostname -s)
 VERBOSE_MODE=false
 if [[ "${1:-}" == "--verbose" ]]; then
     VERBOSE_MODE=true; shift
@@ -468,6 +490,14 @@ if [[ "${1:-}" ]]; then
                 fi
             fi
             exit 0 ;;
+        --test)
+            echo "--- TEST MODE ACTIVATED ---"
+            # Call the pre-flight checks in test mode
+            run_preflight_checks true
+            echo "---------------------------"
+            echo "✅ All configuration checks passed."
+            exit 0
+            ;;
     esac
 fi