#!/bin/bash
set -euo pipefail
export LC_ALL=C

fail() {
    printf 'Error: %s\n' "$*" >&2
    exit 1
}

[[ $# -eq 4 ]] || fail 'Usage: /bin/bash batch-prefix-files.sh preview|apply /absolute/folder extension prefix'
mode=$1
folder=$2
extension=$3
prefix=$4

[[ "$mode" == preview || "$mode" == apply ]] || fail 'Mode must be preview or apply.'
[[ "$folder" == /* && -d "$folder" ]] || fail 'Choose an existing absolute folder path.'
[[ "$extension" =~ ^[A-Za-z0-9]+$ ]] || fail 'Use an extension without a dot, such as pdf.'
[[ "$prefix" =~ ^[A-Za-z0-9_-]+$ ]] || fail 'Use a nonempty prefix containing only letters, digits, hyphens or underscores.'
folder=$(cd -P -- "$folder" && pwd)
[[ "$folder" != / ]] || fail 'Choose a working folder, not the filesystem root.'
[[ -r "$folder" && -x "$folder" ]] || fail 'The folder must be readable and searchable.'
lock_path="$folder/.rulr-prefix-rename.lock"

if [[ "$mode" == apply ]]; then
    [[ -w "$folder" ]] || fail 'The folder must be writable.'
    /bin/mkdir "$lock_path" || fail 'Cannot acquire the folder lock. Check permissions or an existing run.'
    trap '/bin/rmdir "$lock_path"' EXIT
    trap 'exit 130' INT
    trap 'exit 143' TERM
else
    [[ ! -e "$lock_path" && ! -L "$lock_path" ]] || fail 'Another run or a leftover lock exists.'
fi

shopt -s nullglob
sources=()
targets=()
for source in "$folder"/*."$extension"; do
    [[ -f "$source" && ! -L "$source" ]] || continue
    filename=${source##*/}
    [[ "$filename" != "$prefix"* ]] || continue
    target="$folder/$prefix$filename"
    [[ ! -e "$target" && ! -L "$target" ]] || fail "Target already exists: $target. No files have been renamed."
    sources+=("$source")
    targets+=("$target")
done

if [[ ${#sources[@]} -eq 0 ]]; then
    printf 'No matching unprefixed files. Nothing changed.\n'
    exit 0
fi

printf 'Mode: %s; files: %s\n' "$mode" "${#sources[@]}"
for index in "${!sources[@]}"; do
    printf '%q -> %q\n' "${sources[$index]}" "${targets[$index]}"
done
[[ "$mode" == apply ]] || exit 0

for index in "${!sources[@]}"; do
    source=${sources[$index]}
    target=${targets[$index]}
    [[ -f "$source" && ! -L "$source" ]] || fail 'A source changed after preview. Earlier RENAMED entries may already be complete.'
    [[ ! -e "$target" && ! -L "$target" ]] || fail 'A target appeared after preview. Earlier RENAMED entries may already be complete.'
    /bin/mv -n "$source" "$target" || fail 'Move failed. Review earlier RENAMED entries before retrying.'
    [[ ! -e "$source" && ! -L "$source" ]] || fail 'Move was skipped. Review earlier RENAMED entries before retrying.'
    printf 'RENAMED %q -> %q\n' "$source" "$target"
done
