Cilat janë Git hooks dhe si përdoren ata?

Question

Accepted Answer

**Git hooks** janë skripte që Git ekzekuton **automatikisht** në pika të caktuara në flutusin e punës të Git (para/pas commit-ave, push-ave, merge-ave, etj.). Ato mundësojnë automatizim — zbatimin e standardeve, ekzekutimin e kontrolleve dhe aktivizimin e veprimeve — dhe përdoren gjerësisht për cilësinë e kodit dhe integrimin e CI.

## Cilat janë 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
```

## Përdorimet e zakonshme

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

## Menaxhimi i hooks në një ekip

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

## Pse ka rëndësi

Përvetësimi i Git hooks është njohuri e vlefshme në nivel senjor për **automatizimin e kontrolleve të cilësisë dhe veprimeve të flutusin e punës**, kështu që është i dobishëm për ruajtjen e cilësisë së kodit dhe integrimin me CI/CD.

Hooks mundësojnë **automatizimin në ngjarjet kyçe të Git** — ekzekutimin e skripteve automatikisht para/pas commit-ave, push-ave, merge-ave, etj. — i cili përdoret gjerësisht për zbatimin e standardeve dhe kapjen e problemeve më herët.

Përdorimi më i zakonshëm dhe më i vlefshëm është **pre-commit hook** për ekzekutimin e **linting-ut, formatimit, testeve të shpejtë dhe detektimit të sekreve para se kodi të jetë committed** — duke ofruar përgjigje të shpejt dhe duke siguruar cilësi konsistente automatikisht (kështu që problemet kapen në kohën e commit-it në vend se më vonë në CI ose rishikim), një praktikë jashtëzakonisht popullore.

Përdorimet e tjera (commit-msg hooks që zbatojnë konvencione të mesazheve si Conventional Commits, pre-push hooks që ekzekutojnë teste për të parandaluar push-imin e kodit të prishur, dhe server-side hooks që zbatojnë politika ose aktivizojnë CI/CD dhe deployments) zgjrojnë automatizmin në të gjithë flutusin e punës.

Përvetësimi i aspektit praktik të **menaxhimit të ekipit** është i rëndësishëm: `.git/hooks/` është lokal dhe **nuk është committed**, kështu që hooks nuk ndahen automatikisht — ndarja e tyre nëpër një ekip kërkon mjete si **Husky, pre-commit, ose lefthook** që verzionojnë hooks në repo dhe i instalojnë ato për të gjithë.

Është thelbësor të kuptuarit se hooks **mund të anashkalohen** (`--no-verify`) do të thotë që ata ofrojnë përgjigje të shpejt *lokale* por **CI gjithashtu duhet të zbatojë** kontrollat si rrjeta e sigurimit të vërtetë — një njohuri kyçe rreth mbrojtjes në thellësi (hooks lokale për shpejtësinë, CI për zbatimin).

Pasi automatizimi i kontrolleve të cilësisë dhe veprimeve të flutusin e punës përmirëson cilësinë dhe konsistencën e kodit, dhe pasi Git hooks (veçanërisht pre-commit për kontrollat lokale, të menaxhuara përmes mjeteve dhe të plotësuara nga CI) janë një mekanizëm i përdorur gjerësisht për këtë, përvetësimi i Git hooks — çfarë janë ato, përdorimet e zakonshme, menaxhimi i ekipit me mjete, dhe marrëdhënia e tyre me CI — është njohuri e vlefshme në nivel senjor për ndërtimin e fluturave të punës të automatizuara dhe të përqendruara në cilësi, duke reflektuar praktikat e përdorura për ruajtjen e cilësisë në ekipet profesionale.