Czym są Git hooks i jak się ich używa?

Question

Accepted Answer

**Git hooks** to skrypty, które Git uruchamia **automatycznie** w określonych punktach workflow'u Git (przed/po commit'ach, push'ach, merge'ach, itp.). Umożliwiają automatyzację — wymuszają standardy, uruchamiają testy i wyzwalają akcje — i są szeroko stosowane do zapewnienia jakości kodu i integracji CI.

## Czym są hooks

```text
Hooks are executable scripts in .git/hooks/ (or managed by tools) that Git runs on EVENTS:
  CLIENT-SIDE (local):
    pre-commit   → before a commit is created (lint, format, run quick tests)
    commit-msg   → validate/format the commit message
    pre-push     → before pushing (run tests, prevent pushing broken code)
    post-merge/checkout → after merge/checkout (e.g. reinstall dependencies)
  SERVER-SIDE (on the remote):
    pre-receive / update → enforce policies on push (reject bad pushes)
    post-receive → trigger deployment/CI/notifications after a push
```

## Typowe zastosowania

```text
✓ pre-commit → LINT and FORMAT code; run quick tests; block secrets/debug code
  → catch issues BEFORE they're committed (fast feedback, consistent quality)
✓ commit-msg → enforce message format (e.g. Conventional Commits)
✓ pre-push → run the test suite → don't push failing code
✓ server-side → enforce policies; trigger CI/CD and deployments
```

## Zarządzanie hooks'ami w zespole

```text
⚠️ .git/hooks/ is LOCAL and NOT committed → hooks aren't shared automatically.
To share hooks across a team, use tools:
  → HUSKY (JS ecosystem), pre-commit (Python framework), lefthook, etc.
  → these version hooks in the repo and install them for everyone
→ Combined with CI: hooks give FAST LOCAL feedback; CI is the enforced safety net
  (hooks can be bypassed with --no-verify, so CI must also enforce).
```

## Dlaczego to ważne

Rozumienie Git hooks'ów to cenna wiedza na poziomie senior — **automatyzacja kontroli jakości i akcji workflow** — przydatna do utrzymania jakości kodu i integracji z CI/CD.

Hooks'i umożliwiają **automatyzację w kluczowych zdarzeniach Git** — automatyczne uruchamianie skryptów przed/po commit'ach, push'ach, merge'ach, itp. — co jest szeroko stosowane do wymuszania standardów i wczesnego wychwytywania problemów.

Najczęstsze i najbardziej wartościowe zastosowanie to **hook pre-commit** do uruchamiania **lintingu, formatowania, szybkich testów i detekcji sekretów przed commit'em** — zapewniający szybką informację zwrotną i gwarantujący spójną jakość automatycznie (problemy są wychwytywane w momencie commit'u, zamiast później w CI czy review), bardzo popularna praktyka.

Inne zastosowania (hooks commit-msg wymuszające konwencje wiadomości, takie jak Conventional Commits, hooks pre-push uruchamiające testy aby zapobiec push'owaniu zepsutego kodu, i hooks po stronie serwera wymuszające polityki czy wyzwalające CI/CD i deploymenty) rozszerzają automatyzację na cały workflow.

Rozumienie praktycznego aspektu **zarządzania zespołem** jest ważne: `.git/hooks/` to katalog lokalny i **nie jest zatwierdzany** w repozytorium, więc hooks'i nie są udostępniane automatycznie — dzielenie się nimi w zespole wymaga narzędzi takich jak **Husky, pre-commit lub lefthook**, które przechowują hooks'i w repozytorium i instalują je dla wszystkich.

Krytyczne jest zrozumienie, że hooks'i **mogą być pominięte** (`--no-verify`), co oznacza, że zapewniają szybką *lokalną* informację zwrotną, ale **CI musi również wymuszać** kontrole jako rzeczywista sieć bezpieczeństwa — kluczowy wgląd w obronę warstwową (lokalne hooks'i dla szybkości, CI dla wymuszenia).

Ponieważ automatyzacja kontroli jakości i akcji workflow'u poprawia jakość i spójność kodu, a Git hooks'i (szczególnie pre-commit dla lokalnych kontroli, zarządzane za pośrednictwem narzędzi i uzupełniane przez CI) są powszechnie stosowanym mechanizmem, rozumienie Git hooks'ów — czym są, typowe zastosowania, zarządzanie zespołem za pomocą narzędzi i ich związek z CI — to cenna wiedza na poziomie senior do budowania zautomatyzowanych, ukierunkowanych na jakość workflow'ów rozwojowych, odzwierciedlające praktyki stosowane do utrzymania jakości w profesjonalnych zespołach.