8.3 Налаштування Git - Гаки (hooks) Git

Перші чотири гаки пов’язані з процесом створення комітів.

Спочатку виконується гак pre-commit, навіть перед тим, як ви набрали повідомлення коміту. Він використовується щоб оглянути відбиток, який ви збираєтесь зберегти в коміті, щоб побачити, чи забули ви щось, переконатись, що тести проходять, чи щоб перевірити будь-що в коді. Вихід з цього гака не з нулем скасовує коміт, хоча щоб цього уникнути за допомогою git commit --no-verify. Ви можете робити такі речі, як перевірка стилю коду (виконати lint чи аналог), перевірити пробільні символи наприкінці рядка (типовий гак саме це й робить), чи перевірити відповідність документації новим методам.

Гак prepare-commit-msg викликається перед тим, як запускається редактор повідомлення коміту, проте після того, як типове повідомлення створено. Це дозволяє вам редагувати типове повідомлення перед тим, як автор коміту побачить його. Цей гак приймає декілька параметрів: шлях до файлу, який містить поточне повідомлення коміту, тип коміту та SHA-1 коміту, якщо це виправлення (amend) коміту. Цей гак зазвичай не є дуже корисним для нормальних комітів: швидше він є доречним для комітів, для яких типове повідомлення комітів автоматично генеруються, наприклад шаблонні повідомлення комітів, коміти злиття, коміти зварювання та коміти виправлення. Ви можете використовувати його разом з шаблоном коміту, щоб програмно додати інформацію.

Гак commit-msg приймає один параметр — той самий шлях до тимчасового файлу, який містить повідомлення коміту, яке написав розробник. Якщо скрипт виходить не з нулем, то Git скасовує коміт, отже ви можете використати його, щоб перевіряти стан або повідомлення коміту перед тим, як дозволити йти далі. В останній секції цього розділу, ми продемонструємо використання цього гаку для перевірки відповідності повідомлення коміту необхідному взірцю.

Після того, як весь процес коміту завершено, виконується гак post-commit. Він не приймає жодних параметрів, проте ви легко можете отримати останній коміт за допомогою git log -1 HEAD. Зазвичай, цей скрипт використовують для звісток чи чогось схожого.

Ви можете налаштувати три клієнтські гаки для процесу роботи з поштою. Вони всі викликаються командою git am, отже якщо ви її не використовуєте в роботі, ви можете спокійнісінько пропустити цей підрозділ. Якщо ви отримуєте латки через пошту, та вони були підготовлені командою git format-patch, то якісь з них можуть бути для вас корисними.

Спершу виконується гак applypatch-msg. Він приймає один аргумент: імʼя тимчасового файлу, що містить пропоноване повідомлення коміту. Git відкидає латку, якщо скрипт виходить не з нулем. Ви можете використати його, щоб переконатися, що повідомлення коміту написано належним чином, чи для нормалізації повідомлення — скрипт може одразу відредагувати його.

Наступний гак — pre-applypatch —  викликається під час застосування латок командою git am. Це може збити з пантелику, проте він виконується після того, як латку застосовано, проте перед тим, як створюється коміт. Отже, його можна використати для перевірки відбитку перед додаванням коміту. Ви можете виконати тести, чи іншим чином перевірити робоче дерево в цьому скрипті. Якщо чогось бракує, чи тести не пройшли, вихід з ненульовим значенням припиняє скрипт git am без створення коміту з латкою.

Останній гак, який виконується під час праці git am, називається post-applypatch, та викликається після створення коміту. Його можна використати для сповіщення групи чи автора, в якого ви взяли латку, про те, що ви зробили. Ви не можете зупинити процес застосування латки в цьому скрипті.

Гак pre-rebase виконується перед кожним перебазуванням, та може припинити процес, якщо поверне не нуль. Ви можете його використати, щоб заборонити перебазування будь-яких вже надісланих комітів. Приклад гаку pre-rebase, який встановлює Git, робить це, хоч і деякими припущеннями, яки можуть бути неправильними для вашого процесу роботи.

Гак post-rewrite виконується командами, які замінюють коміти — такими як git commit --amend та git rebase (хоча git filter-branch його не викликає). Його єдиним аргументом є команда, яка спричинила переписування, а список переписувань надається через stdin. Цей гак має багато спільних використань з гаками post-checkout та post-merge.

Після успішного виконання git checkout, викликається гак post-checkout; його можна використати, щоб правильно налаштувати вашу робочу директорію для середовища проекту. Це може означати пересування великих двійкових файлів, які не перебувають під контролем версій, автоматична генерація документацій, чи щось схоже на ці приклади.

Гак post-merge викликається після успішної команди merge. Його можна використати для відновлення даних у робочій директорії, що їх не може супроводжувати Git, наприклад дані про права доступу. Цей гак може також перевіряти присутність файлів, якими Git не керує, проте які мають бути скопійовані під час змін робочого дерева.

Гак pre-push виконується під час git push, після того, як віддаленні посилання оновлено, проте перед тим, як якісь обʼєкти надсилаються. Він отримує імʼя та розташування віддаленого сховища як параметри, та список посилань, які будуть оновлені, через stdin. Ви можете його використати для перевірки набору оновлень посилань перед тим, як станеться надсилання змін (вихід з не нулем скасує надсилання)

Git іноді збирає сміття під час своєї звичайної роботи, тоді він викликає git gc --auto. Гак pre-auto-gc викликається саме перед збиранням сміття, та може використовуватись для того, щоб повідомити вам про це, або скасувати збір, якщо зараз не час для цього.

Під час обробки надсилання змін клієнтом спочатку викликається pre-preceive. Він отримує список посилань, які надсилаються, через stdin; якщо він виходить з не нулем, жодне з них не приймається. Ви можете використати цей гак для того, щоб, наприклад, переконатися, що всі оновлені посилання є перемотуваннями вперед, або щоб здійснити перевірку доступу для всіх посилань та файів, які в них відредагували.

Скрипт update є дуже схожим на скрипт pre-receive, окрім того, що він виконується окремо для кожної гілки, яка намагається оновити автор змін. Якщо автор намагається надіслати декілька гілок, pre-receive виконується лише один раз, у той час як update виконується для кожної надісланої гілки. Замість того, щоб читати з stdin, цей скрипт приймає три аргументи: імʼя посилання (гілки), SHA-1 того, на що вказувало це посилання до надсилання, та SHA-1 того, що намагається надіслати користувач. Якщо скрипт update вийде з не улем, лише це посилання відхиляється; інші посилання все одно можуть бути оновлені.

Гак post-receive виконується після того, як весь процес завершено, та може бути використаним для оновлення інших сервісів або сповіщення користувачів. Він приймає такі самі дані з stdin, як і гак pre-receive. Приклади включають надсилання листа до розсилки, сповіщення сервера постійної інтеграції, або оновлення системи слідкування за завданнями – ви можете навіть проаналізувати повідомлення комітів, щоб побачити, можливо, якісь завдання треба відкрити, змінити або закрити. Цей скрипт не може зупинити процес надсилання, проте клієнт не відключається, доки він не завершиться, тому будьте обережні з тим, щоб намагатись зробити щось, що потребує багато часу.