Ce sunt Git hooks și cum se folosesc?

Question

Accepted Answer

**Git hooks** sunt scripturi pe care Git le execută **automat** la anumite puncte din fluxul de lucru Git (înainte/după commit-uri, push-uri, merge-uri, etc.). Acestea permit automatizarea — aplicarea standardelor, executarea verificărilor și declanșarea acțiunilor — și sunt utilizate pe scară largă pentru calitatea codului și integrarea CI.

## Ce sunt hook-urile

```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
```

## Utilizări comune

```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
```

## Gestionarea hook-urilor în echipă

```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).
```

## De ce este important

Înțelegerea Git hooks este o cunoaștere valoroasă la nivel senior pentru **automatizarea verificărilor calității și a acțiunilor din flux de lucru**, deci este utilă pentru menținerea calității codului și integrarea cu CI/CD.

Hook-urile permit **automatizare la punctele cheie ale evenimentelor Git** — executând scripturi automat înainte/după commit-uri, push-uri, merge-uri, etc. — care este utilizat pe scară largă pentru aplicarea standardelor și detectarea problemelor din timp.

Cea mai comună și valoroasă utilizare este **pre-commit hook** pentru executarea **linting-ului, formatării, testelor rapide și detecției secretelor înainte ca codul să fie committed** — oferind feedback rapid și asigurând o calitate consistentă automat (astfel încât problemele sunt detectate la momentul commit-ului mai degrabă decât mai târziu în CI sau review), o practică extrem de populară.

Alte utilizări (hook-uri commit-msg care aplică convenții de mesaje precum Conventional Commits, hook-uri pre-push care execută teste pentru a preveni push-ul de cod stricat, și hook-uri la nivel de server care aplică politici sau declanșează CI/CD și deployments) extind automatizarea pe tot fluxul de lucru.

Înțelegerea aspectului practic al **gestionării în echipă** este importantă: `.git/hooks/` este local și **nu este committed**, deci hook-urile nu sunt partajate automat — partajarea lor în întreaga echipă necesită instrumente precum **Husky, pre-commit, sau lefthook** care versionează hook-urile în repo și le instalează pentru toată lumea.

Crucial, înțelegerea că hook-urile **pot fi ocolite** (`--no-verify`) înseamnă că furnizează feedback rapid *local* dar **CI trebuie de asemenea să aplice** verificările ca o rețea de siguranță reală — o perspectivă-cheie despre apărare în profunzime (hook-uri locale pentru viteză, CI pentru aplicare).

Deoarece automatizarea verificărilor calității și a acțiunilor din flux de lucru îmbunătățește calitatea codului și consistența, și deoarece Git hooks (în special pre-commit pentru verificări locale, gestionate via instrumente și complementate de CI) sunt un mecanism utilizat pe scară largă pentru aceasta, înțelegerea Git hooks — ce sunt, utilizări comune, gestionarea echipei cu instrumente, și relația lor cu CI — este o cunoaștere valoroasă la nivel senior pentru construirea fluxurilor de lucru de dezvoltare automatizate și axate pe calitate, reflectând practicile utilizate pentru menținerea calității în echipele profesionale.