ما هي Git hooks وكيف يتم استخدامها؟

Question

Accepted Answer

**Git hooks** هي سكريبتات يقوم Git بتشغيلها **تلقائياً** في نقاط معينة من سير عمل Git (قبل/بعد الالتزامات، الدفع، الدمج، إلخ). تمكّن الأتمتة — فرض المعايير، تشغيل الفحوصات، وتشغيل الإجراءات — وتُستخدم على نطاق واسع لضمان جودة الكود والتكامل مع CI.

## ما هي الـ 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
```

## الاستخدامات الشائعة

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

## إدارة الـ hooks في الفريق

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

## لماذا هذا مهم

فهم Git hooks معرفة قيّمة على مستوى كبار المطورين لـ **أتمتة فحوصات الجودة وإجراءات سير العمل**، لذا فهو مفيد للحفاظ على جودة الكود والتكامل مع CI/CD.

تمكّن الـ hooks **الأتمتة في أحداث Git الرئيسية** — تشغيل السكريبتات تلقائياً قبل/بعد الالتزامات والدفع والدمج، إلخ. — وهي تُستخدم على نطاق واسع لفرض المعايير والتقاط المشاكل مبكراً.

الاستخدام الأكثر شيوعاً وقيمة هو **pre-commit hook** لتشغيل **linting والتنسيق والاختبارات السريعة والكشف عن الأسرار قبل الالتزام بالكود** — توفير تقييم سريع وضمان جودة متسقة تلقائياً (بحيث يتم التقاط المشاكل في وقت الالتزام بدلاً من وقت لاحق في CI أو المراجعة)، وهي ممارسة شعبية جداً.

الاستخدامات الأخرى (commit-msg hooks التي تفرض اتفاقيات الرسائل مثل Conventional Commits، pre-push hooks التي تشغل الاختبارات لمنع دفع الكود المكسور، و server-side hooks التي تفرض السياسات أو تشغل CI/CD والنشر) تمدّد الأتمتة عبر سير العمل.

فهم جانب **إدارة الفريق** العملي مهم: `.git/hooks/` محلية و**لا يتم الالتزام بها** في المستودع، لذا الـ hooks لا تُشارك تلقائياً — مشاركتها عبر الفريق تتطلب أدوات مثل **Husky أو pre-commit أو lefthook** التي تصدّر الـ hooks في المستودع وتثبتها للجميع.

بشكل حاسم، فهم أن الـ hooks **يمكن تجاوزها** (`--no-verify`) يعني أنها توفر تقييم سريع *محلي* لكن **CI يجب أن تفرض أيضاً** الفحوصات كشبكة الأمان الحقيقية — رؤية أساسية حول الدفاع المتعدد الطبقات (الـ hooks المحلية للسرعة، CI للتنفيذ).

نظراً لأن أتمتة فحوصات الجودة وإجراءات سير العمل تحسّن جودة الكود والاتساق، وبما أن Git hooks (خاصة pre-commit للفحوصات المحلية، المُدارة عبر الأدوات والمُتممة بـ CI) هي آلية مستخدمة على نطاق واسع لهذا، فإن فهم Git hooks — ما هي، والاستخدامات الشائعة، وإدارة الفريق بالأدوات، وعلاقتها بـ CI — معرفة قيّمة على مستوى كبار المطورين لبناء سير عمل تطوير آلي وموجه نحو الجودة، يعكس الممارسات المستخدمة للحفاظ على الجودة في الفرق الاحترافية.