Kas yra Git hook'ai ir kaip jie naudojami?

Question

Accepted Answer

**Git hook'ai** yra skriptai, kuriuos Git paleidžia **automatiškai** tam tikruose Git darbo srauto taškuose (prieš/po commit'ų, push'ų, merge'ų ir t. t.). Jie suteikia automatizavimo galimybę — standartų įgyvendinimą, patikrinimų paleidimą ir veiksmų suaktyvavimą — ir plačiai naudojami kodo kokybei ir CI integracijai.

## Kas yra hook'ai

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

## Įprasti naudojimo atvejai

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

## Hook'ų valdymas komandoje

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

## Kodėl tai svarbu

Supratimas apie Git hook'us yra vertinga aukštos kvalifikacijos žinios **automatizuoti kokybės patikrinimus ir darbo srauto veiksmus**, todėl tai nauinga kodo kokybės palaikymui ir CI/CD integracijai.

Hook'ai suteikia **automatizavimą pagrindiniais Git įvykiais** — skriptai paleidžiami automatiškai prieš/po commit'ų, push'ų, merge'ų ir t. t. — o tai plačiai naudojama standartams įgyvendinti ir problemoms aptikti anksti.

Dažniausias ir vertingiausias naudojimas yra **pre-commit hook** skriptams vykdyti **linting, formatavimui, greitiems testams ir slaptų duomenų aptikimui prieš kod
es įsisavinimą** — greitai suteikiant grįžtamąjį ryšį ir užtikrinant nuoseklią kokybę automatiškai (todėl problemos nustatomos commit metu, o ne vėliau CI arba peržiūroje), o tai yra itin populiari praktika.

Kiti naudojimo atvejai (commit-msg hook'ai, kurie privalo laikytis žinučių konvencijų kaip Conventional Commits, pre-push hook'ai, vykdantys testus siekiant išvengti sulaužyto kodo push'avimo, ir serverio pusės hook'ai, kurie nustato politiką arba suaktyvina CI/CD ir diegimą) išplečia automatizavimą per visą darbo srautą.

Supratimas apie praktiniu **komandos valdymo** aspektu yra svarbus: `.git/hooks/` yra lokalinis ir **nėra saugomas versijose**, todėl hook'ai nėra bendrinami automatiškai — jų bendrinimas komandoje reikalauja tokių įrankių kaip **Husky, pre-commit arba lefthook**, kurie hook'us versijuoja saugykloje ir diegia visiems.

Krucialiai, supratimas, kad hook'ai **gali būti aplenkti** (`--no-verify`) reiškia, kad jie suteikia greitą *lokalų* grįžtamąjį ryšį, bet **CI taip pat turi priverstinai naudoti** patikrinimus kaip tikrą saugumo tinklą — tai raktas supratimas apie gynybos sluoksnius (lokalūs hook'ai greičiui, CI įgyvendinimui).

Kadangi kokybės patikrinimų ir darbo srauto veiksmų automatizavimas pagerina kodo kokybę ir nuoseklumą, o Git hook'ai (ypač pre-commit lokaliam patikrinimui, valdomi per įrankius ir papildyti CI) yra plačiai naudojamas mechanizmas tam, supratimas apie Git hook'us — kas jie yra, įprasti naudojimo atvejai, komandos valdymas su įrankiais ir jų ryšys su CI — yra vertinga aukštos kvalifikacijos žinios automatizuotiems, kokybės orientuotiems kūrimo darbams, atspindint praktiką, naudojamą kokybės palaikymui profesionaliose komanose.