vibe-forge 0.4.0 → 0.8.1

package/bin/lib/util.sh

@@ -1,126 +1,126 @@
-#!/usr/bin/env bash
-#
-# Vibe Forge - Cross-Platform Utilities
-# Source this file in other scripts: source "$SCRIPT_DIR/lib/util.sh"
-#
-# Contains cross-platform helper functions that abstract away differences
-# between macOS/BSD, Linux, and Windows (Git Bash).
-#
-
-# =============================================================================
-# Cross-Platform sed In-Place Editing
-# =============================================================================
-# macOS/BSD sed requires `sed -i ''` (empty string for backup extension)
-# Linux/GNU sed requires `sed -i` (no argument after -i)
-# Windows Git Bash uses GNU sed, so same as Linux
-#
-# Usage:
-#   sed_inplace 's/foo/bar/' file.txt
-#   sed_inplace 's/foo/bar/g' file.txt
-#
-# Arguments:
-#   $1 - sed expression (the pattern to apply)
-#   $2 - file to edit
-#
-# Returns:
-#   0 on success, non-zero on failure
-#
-# Example:
-#   sed_inplace 's/"validated": false/"validated": true/' "$config_file"
-
-sed_inplace() {
-    local pattern="$1"
-    local file="$2"
-
-    # Validate arguments
-    if [[ -z "$pattern" ]]; then
-        echo "sed_inplace: error: pattern argument required" >&2
-        return 1
-    fi
-
-    if [[ -z "$file" ]]; then
-        echo "sed_inplace: error: file argument required" >&2
-        return 1
-    fi
-
-    if [[ ! -f "$file" ]]; then
-        echo "sed_inplace: error: file does not exist: $file" >&2
-        return 1
-    fi
-
-    # SECURITY: Refuse to edit symlinks to prevent symlink attacks
-    if [[ -L "$file" ]]; then
-        echo "sed_inplace: error: refusing to edit symlink: $file" >&2
-        return 1
-    fi
-
-    # Platform-specific sed invocation
-    if [[ "$(uname)" == "Darwin" ]]; then
-        # macOS/BSD sed requires empty string after -i
-        sed -i '' "$pattern" "$file"
-    else
-        # Linux and Windows (Git Bash) use GNU sed
-        sed -i "$pattern" "$file"
-    fi
-}
-
-# =============================================================================
-# Detect Platform
-# =============================================================================
-# Returns a normalized platform name
-#
-# Usage:
-#   platform=$(get_platform)
-#   if [[ "$platform" == "macos" ]]; then ...
-#
-# Returns:
-#   "windows" - Windows (detected via MINGW/MSYS/Cygwin environment)
-#   "macos"   - macOS (Darwin)
-#   "linux"   - Linux
-#   "unknown" - Unrecognized platform
-
-get_platform() {
-    case "$(uname -s)" in
-        MINGW*|MSYS*|CYGWIN*)
-            echo "windows"
-            ;;
-        Darwin)
-            echo "macos"
-            ;;
-        Linux)
-            echo "linux"
-            ;;
-        *)
-            echo "unknown"
-            ;;
-    esac
-}
-
-# =============================================================================
-# Check if running in Git Bash on Windows
-# =============================================================================
-# Useful for Windows-specific behavior that differs from Linux
-
-is_git_bash() {
-    [[ "$(uname -s)" == MINGW* ]] || [[ "$(uname -s)" == MSYS* ]]
-}
-
-# =============================================================================
-# Cross-Platform stat for File Size
-# =============================================================================
-# macOS uses `stat -f%z` while Linux uses `stat --format=%s`
-#
-# Usage:
-#   size=$(get_file_size file.txt)
-
-get_file_size() {
-    local file="$1"
-
-    if [[ ! -f "$file" ]]; then
-        echo 0
-        return 1
-    fi
-
-    # Try macOS/BSD syntax first, fall back to GNU syntax
-    stat -f%z "$file" 2>/dev/null || stat --format=%s "$file" 2>/dev/null || echo 0
-}
+#!/usr/bin/env bash
+#
+# Vibe Forge - Cross-Platform Utilities
+# Source this file in other scripts: source "$SCRIPT_DIR/lib/util.sh"
+#
+# Contains cross-platform helper functions that abstract away differences
+# between macOS/BSD, Linux, and Windows (Git Bash).
+#
+
+# =============================================================================
+# Cross-Platform sed In-Place Editing
+# =============================================================================
+# macOS/BSD sed requires `sed -i ''` (empty string for backup extension)
+# Linux/GNU sed requires `sed -i` (no argument after -i)
+# Windows Git Bash uses GNU sed, so same as Linux
+#
+# Usage:
+#   sed_inplace 's/foo/bar/' file.txt
+#   sed_inplace 's/foo/bar/g' file.txt
+#
+# Arguments:
+#   $1 - sed expression (the pattern to apply)
+#   $2 - file to edit
+#
+# Returns:
+#   0 on success, non-zero on failure
+#
+# Example:
+#   sed_inplace 's/"validated": false/"validated": true/' "$config_file"
+
+sed_inplace() {
+    local pattern="$1"
+    local file="$2"
+
+    # Validate arguments
+    if [[ -z "$pattern" ]]; then
+        echo "sed_inplace: error: pattern argument required" >&2
+        return 1
+    fi
+
+    if [[ -z "$file" ]]; then
+        echo "sed_inplace: error: file argument required" >&2
+        return 1
+    fi
+
+    if [[ ! -f "$file" ]]; then
+        echo "sed_inplace: error: file does not exist: $file" >&2
+        return 1
+    fi
+
+    # SECURITY: Refuse to edit symlinks to prevent symlink attacks
+    if [[ -L "$file" ]]; then
+        echo "sed_inplace: error: refusing to edit symlink: $file" >&2
+        return 1
+    fi
+
+    # Platform-specific sed invocation
+    if [[ "$(uname)" == "Darwin" ]]; then
+        # macOS/BSD sed requires empty string after -i
+        sed -i '' "$pattern" "$file"
+    else
+        # Linux and Windows (Git Bash) use GNU sed
+        sed -i "$pattern" "$file"
+    fi
+}
+
+# =============================================================================
+# Detect Platform
+# =============================================================================
+# Returns a normalized platform name
+#
+# Usage:
+#   platform=$(get_platform)
+#   if [[ "$platform" == "macos" ]]; then ...
+#
+# Returns:
+#   "windows" - Windows (detected via MINGW/MSYS/Cygwin environment)
+#   "macos"   - macOS (Darwin)
+#   "linux"   - Linux
+#   "unknown" - Unrecognized platform
+
+get_platform() {
+    case "$(uname -s)" in
+        MINGW*|MSYS*|CYGWIN*)
+            echo "windows"
+            ;;
+        Darwin)
+            echo "macos"
+            ;;
+        Linux)
+            echo "linux"
+            ;;
+        *)
+            echo "unknown"
+            ;;
+    esac
+}
+
+# =============================================================================
+# Check if running in Git Bash on Windows
+# =============================================================================
+# Useful for Windows-specific behavior that differs from Linux
+
+is_git_bash() {
+    [[ "$(uname -s)" == MINGW* ]] || [[ "$(uname -s)" == MSYS* ]]
+}
+
+# =============================================================================
+# Cross-Platform stat for File Size
+# =============================================================================
+# macOS uses `stat -f%z` while Linux uses `stat --format=%s`
+#
+# Usage:
+#   size=$(get_file_size file.txt)
+
+get_file_size() {
+    local file="$1"
+
+    if [[ ! -f "$file" ]]; then
+        echo 0
+        return 1
+    fi
+
+    # Try macOS/BSD syntax first, fall back to GNU syntax
+    stat -f%z "$file" 2>/dev/null || stat --format=%s "$file" 2>/dev/null || echo 0
+}