Git хуки (hooks): автоматизация проверок при коммитах

ls .git/hooks/
# applypatch-msg.sample
# commit-msg.sample
# post-update.sample
# pre-applypatch.sample
# pre-commit.sample      ← пример pre-commit
# pre-push.sample
# pre-rebase.sample
# prepare-commit-msg.sample
# update.sample

# .git/hooks/pre-commit
#!/bin/sh
# Запустить линтер
npm run lint

# Если линтер упал — прервать коммит
if [ $? -ne 0 ]; then
    echo "Lint failed. Fix errors before committing."
    exit 1
fi

exit 0

# .git/hooks/commit-msg
#!/bin/sh
# Проверить что сообщение соответствует Conventional Commits
COMMIT_MSG_FILE=$1
COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")

# Паттерн: type(scope): description
if ! echo "$COMMIT_MSG" | grep -qE "^(feat|fix|docs|style|refactor|perf|test|chore|ci)(\(.+\))?: .+"; then
    echo "ERROR: Commit message must follow Conventional Commits format"
    echo "Example: feat: add user authentication"
    exit 1
fi

# .git/hooks/pre-push
#!/bin/sh
# Запустить тесты перед push
npm test

if [ $? -ne 0 ]; then
    echo "Tests failed. Fix tests before pushing."
    exit 1
fi

# Создать pre-commit хук
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/sh
echo "Running pre-commit checks..."

# Проверить форматирование
npx prettier --check "src/**/*.{js,ts,jsx,tsx}"
if [ $? -ne 0 ]; then
    echo "Code is not formatted. Run: npx prettier --write ."
    exit 1
fi

echo "Pre-commit checks passed."
exit 0
EOF

# Дать права на выполнение (обязательно!)
chmod +x .git/hooks/pre-commit

# Проверить
git commit --allow-empty -m "test"

# pre-receive — перед получением push
# Расположение: на сервере в hooks/pre-receive

#!/bin/sh
# Запретить force push в main
while read oldrev newrev refname; do
    if [ "$refname" = "refs/heads/main" ]; then
        if [ "$oldrev" != "0000000000000000000000000000000000000000" ]; then
            if ! git merge-base --is-ancestor "$oldrev" "$newrev"; then
                echo "ERROR: Force push to main is not allowed."
                exit 1
            fi
        fi
    fi
done

# Установить Husky
npm install -D husky

# Активировать
npx husky init

# Это создаёт .husky/ папку и добавляет prepare скрипт

# Добавить pre-commit хук
echo "npx lint-staged" > .husky/pre-commit

# Установить lint-staged
npm install -D lint-staged

# Конфигурация в package.json

// package.json
{
  "lint-staged": {
    "*.{js,ts,jsx,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{css,scss}": [
      "prettier --write"
    ]
  },
  "scripts": {
    "prepare": "husky"
  }
}

# Добавить commit-msg хук с commitlint
npm install -D @commitlint/cli @commitlint/config-conventional

echo "npx --no commitlint --edit \$1" > .husky/commit-msg

# Создать commitlint.config.js
echo "module.exports = { extends: ['@commitlint/config-conventional'] }" > commitlint.config.js

# Установить pre-commit
pip install pre-commit

# Создать конфигурацию .pre-commit-config.yaml
cat > .pre-commit-config.yaml << 'EOF'
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.4.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
      - id: check-merge-conflict

  - repo: https://github.com/psf/black
    rev: 23.3.0
    hooks:
      - id: black

  - repo: https://github.com/pycqa/flake8
    rev: 6.0.0
    hooks:
      - id: flake8
EOF

# Установить хуки
pre-commit install

# Запустить вручную на всех файлах
pre-commit run --all-files

# Пропустить pre-commit хук
git commit --no-verify -m "WIP: work in progress"
# или
git commit -n -m "Emergency fix"

# Пропустить pre-push хук
git push --no-verify

# Когда это оправдано:
# - Срочные hotfix в нерабочее время
# - WIP коммиты для резервного копирования
# - Временный обход при отладке CI

# Способ 1: хранить в папке scripts/hooks
mkdir -p scripts/hooks
cp .git/hooks/pre-commit scripts/hooks/

# Инструкция для команды:
# git config core.hooksPath scripts/hooks

# Способ 2: Husky (для Node.js) — .husky/ папка коммитится
# Способ 3: pre-commit framework — .pre-commit-config.yaml коммитится

# pre-commit: запуск тестов на изменённых файлах
#!/bin/sh
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep ".js$")
if [ -n "$STAGED_FILES" ]; then
    npm test -- --testPathPattern="$(echo $STAGED_FILES | tr ' ' '|')"
fi

# commit-msg: добавить ID задачи из имени ветки
#!/bin/sh
BRANCH=$(git rev-parse --abbrev-ref HEAD)
TICKET=$(echo $BRANCH | grep -oE "PROJ-[0-9]+")
if [ -n "$TICKET" ]; then
    sed -i "1s/^/$TICKET: /" $1
fi