vacuum-safari.sh

#!/bin/sh

########################################################################
# vacuum-safari.sh: Optimize Safari Cache Database
#
#  Description:
#  This script performs the SQLite vacuum command on Safari's cache
#  database to optimize it. Vacuuming reclaims free space and can improve
#  performance.
#
#  Author: id774 (More info: http://id774.net)
#  Source Code: https://github.com/id774/scripts
#  License: The GPL version 3, or LGPL version 3 (Dual License).
#  Contact: idnanashi@gmail.com
#
#  Version History:
#  v1.2 2025-03-22
#       Unify usage information by extracting help text from header comments.
#  v1.1 2025-03-13
#       Redirected error messages to stderr for better logging and debugging.
#  v1.0 2010-11-29
#       Initial release.
#
#  Usage:
#      ./vacuum-safari.sh
#
#  Notes:
#  - Ensure Safari is not running while executing this script.
#  - It's recommended to back up the cache database before running.
#
########################################################################

# Display script usage information
usage() {
    awk '
        BEGIN { in_usage = 0 }
        /^#  Usage:/ { in_usage = 1; print substr($0, 4); next }
        /^#{10}/ { if (in_usage) exit }
        in_usage && /^#/ { print substr($0, 4) }
    ' "$0"
    exit 0
}

# Function to check if sqlite3 command is available
check_sqlite3() {
    if ! command -v sqlite3 >/dev/null 2>&1; then
        echo "sqlite3 command not found. Please install sqlite3." >&2
        exit 1
    fi
}

# Function to vacuum Safari's cache database
vacuum_safari_cache() {
    SAFARI_CACHE_DIR="$HOME/Library/Caches/com.apple.Safari"

    if [ -d "$SAFARI_CACHE_DIR" ]; then
        if [ -w "$SAFARI_CACHE_DIR/Cache.db" ]; then
            cd "$SAFARI_CACHE_DIR"
            sqlite3 Cache.db vacuum
            echo "Safari cache database vacuumed."
        else
            echo "Safari cache Cache.db not found or not writable." >&2
        fi
    else
        echo "Safari cache directory not found." >&2
        exit 1
    fi
}

# Main function to execute the script
main() {
    case "$1" in
        -h|--help) usage ;;
    esac

    check_sqlite3
    vacuum_safari_cache
}

# Execute main function
main "$@"