Коллекция сниппетов Bash

#!/usr/bin/env bash
# Шебанг: запускает bash, найденный через env - более переносимо, чем /bin/bash

# Параметры безопасности (повышает надёжность и предсказуемость скрипта)
set -Eeuo pipefail
# -e - выход при ошибке
# -E - trap ERR работает в функциях/subshell
# -u - ошибка при обращении к неустановленной переменной
# -o pipefail - конвейер завершается при ошибке любой команды

# Явное определение PATH
# Исключает зависимость от окружения и защищает от подмены команд
export PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin"

# Базовые переменные
SCRIPT_PID=$$  # PID скрипта, полезно для логов и уникальных файлов
# Абсолютный путь к каталогу скрипта (без симлинков)
SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" &>/dev/null && pwd -P)
SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")"      # Имя файла скрипта
SCRIPT_LOG="${SCRIPT_DIR}/${SCRIPT_NAME%.*}.log"   # Файл лога
SCRIPT_LOG_PREFIX='[%Y-%m-%d %H:%M:%S.%3N]'        # Формат метки времени
SCRIPT_LOCK="${SCRIPT_DIR}/${SCRIPT_NAME%.*}.lock" # Файл блокировки
# Используется для логирования и предотвращения одновременного запуска

SCRIPT_PID=$$  # PID скрипта
# Абсолютный путь к каталогу скрипта
SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" &>/dev/null && pwd -P)
SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")"      # Имя файла скрипта
SCRIPT_LOCK="${SCRIPT_DIR}/${SCRIPT_NAME%.*}.lock" # Файл блокировки

# Функция блокировки
setup_lock() {
    # Открываем файл блокировки и сохраняем дескриптор
    exec {fd_lock}>> "${SCRIPT_LOCK}"

    # Пытаемся захватить блокировку (без ожидания)
    if ! flock -n "$fd_lock"; then
        echo "Script instance is already running, exiting..."
        exit 1   # Выходим, если файл уже заблокирован
    fi

    # Записываем PID текущего процесса в lock-файл
    echo "$SCRIPT_PID" > "$SCRIPT_LOCK"
}

# Инициализация блокировки
setup_lock

SCRIPT_PID=$$   # PID скрипта
# Абсолютный путь к каталогу скрипта
SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" &> /dev/null && pwd -P)
SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")"      # Имя файла скрипта
SCRIPT_LOCK="${SCRIPT_DIR}/${SCRIPT_NAME%.*}.lock" # Файл блокировки

# Открываем файл блокировки и сохраняем дескриптор
exec {fd_lock}>> "${SCRIPT_LOCK}"
# Пытаемся захватить блокировку (без ожидания)
flock -n "$fd_lock"
# Записываем PID текущего процесса в lock-файл
echo "$SCRIPT_PID" > "$SCRIPT_LOCK"

# Функция очистки, вызываемая при завершении работы скрипта (сработке trap)
cleanup() {
    # Сбрасываем все установленные trap'ы, чтобы избежать рекурсивных вызовов
    trap - SIGINT SIGTERM SIGHUP SIGQUIT ERR EXIT

    # Если файловый дескриптор был открыт - закрываем его
    [[ -n "${fd_lock-}" ]] && exec {fd_lock}>&-

    # Проверяем, существует ли lock-файл и содержит ли он PID текущего процесса
    # Это предотвращает случайное удаление чужого lock-файла
    if [[ -f "$SCRIPT_LOCK" && $(< "$SCRIPT_LOCK") -eq $SCRIPT_PID ]]; then
        # Удаляем lock-файл, освобождая ресурс
        rm -f "$SCRIPT_LOCK"
    fi
}

# Устанавливаем trap (ловушку),
# чтобы при выходе из скрипта, вызывалась функция cleanup
# Старайтесь завершать trap'ы командой exit
trap 'RC=$?; cleanup; exit $RC' SIGINT SIGHUP SIGTERM SIGQUIT ERR EXIT