احترف Git

الخطاطيف الأربعة الأولى تخص عملية الإيداع.

يعمل خطاف ما قبل الإيداع (pre-commit) أولا، حتى قبل أن تكتب رسالة الإيداع. ويُستعمل لفحص اللقطة التي ستودعها للتأكد من أنك لم تنسَ شيئًا، أو للتأكد من أنك نفّذت الاختبارات، أو للتأكد مما تريد التأكد منه عمومًا. وإنهاء تنفيذ هذا البُريمج بقيمة خروج غير الصفر يوقف الإيداع، على أنك تستطيع تخطيه بالأمر git commit --no-verify. يمكّنك هذا من تنسيق المصدر البرمجي (مثل تنفيذ lint أو ما يكافئه)، أو التأكد من عدم انتهاء السطور بمسافات زائدة (وهذا ما يفعله المثال الآتي مع جت)، أو فحص وجود التوثيق المناسب للدوال الجديدة.

أما خطاف تجهيز رسالة الإيداع (prepare-commit-msg) فيعمل قبل فتح محرر رسالة الإيداع ولكن بعد إنشاء الرسالة المبدئية، حتى يتيح لك تعديل الرسالة المبدئية قبل أن يراها صانع الإيداع. ويُرسل إلى هذا الخطاف ثلاثة معاملات: مسار الملف المؤقت الذي فيه رسالة الإيداع، ونوع الإيداع، وبصمة SHA-1 للإيداع إذا كان إيداعًا مصحّحًا (أي مودَع بالخيار --amend). وعمومًا ليس هذا الخطاف كبير النفع للإيداعات العادية، لكنه يفيد الإيداعات التي رسالتها المبدئية مولدة آليًّا، مثل قوالب رسائل الإيداع، وإيداعات الدمج، والإيداعات المهروسة (‪“squashed”‬)، والإيداعات المصححة (‪“amended”‬). وقد تستخدمه مع قالب رسالة إيداع لإدراج معلومات فيها برمجيًّا.

وأما خطاف رسالة الإيداع (commit-msg) فيقبل معاملًا واحدًا، وهو كذلك مسار الملف المؤقت الذي فيه رسالة الإيداع التي كتبها المطوّر. وإن أنهى تنفيذه بقيمة خروج غير الصفر فإن جت يوقف الإيداع. فيمكنك إذًا استخدامه لتحقق حالة مشروعك أو رسالة الإيداع قبل السماح للإيداع بأن يتم. وسنرى في الفصل الأخير من هذا الباب شرح مثال لاستعمال هذا الخطاف لتحقُّق موافقة رسائل الإيداع لنمط محدد.

أما خطاف ما بعد الإيداع (post-commit) فيعمل بعد تمام عملية الإيداع بكاملها. ولا يقبل أي معاملات. لكن يمكن جلب الإيداع الأخير بسهولة بالأمر git log -1 HEAD. وعموما يُستعمل هذا البُريمج للإعلامات أو ما يشابهها.

يمكنك إعداد خطاطيف ثلاثة لأساليب التطوير المعتمدة على البريد. جميعها يناديها أمر تطبيق الرقع البريدية git am، فإذا لم يكن هذا الأم‍ر في أسلوب التطوير الذي تتبعه فانتقل إلى الفصل التالي. أما إذا كنت تقبل الرقع المُعدَّة بالأمر git format-patch عبر البريد الشابكي، فقد يفيدك بعضها.

أول خطاف ينفّذ هو خطاف رسالة الرقعة (applypatch-msg). ويقبل معاملًا واحدًا هو مسار الملف المؤقت الذي فيه رسالة الإيداع المقترحة. وإنهاء تنفيذه بقيمة خروج غير الصفر يوقف الرقعة. فيمكنك استعماله للتأكد من أن رسالة الإيداع صحيحة التنسيق، أو لاستنظام (normalize) الرسالة بتعديلها في مكانها.

والتالي هو خطاف ما قبل إيداع الرقعة (pre-applypatch). وقد يسبب اللبس أنه، خلافًا لاسمه الأصلي بالإنجليزية، يعمل بعد تطبيق الرقعة ولكن قبل صنع الإيداع، فيمكنك استعماله لفحص اللقطة قبل إيداعها. فيمكنك فيه تنفيذ الاختبارات أو فحص شجرة العمل أو غير ذلك. وإن افتقدت شيئًا أو فشل اختبار، فإن إنهاء تنفيذ هذا البُريمج بقيمة خروج غير الصفر يوقف أمر git am بغير إيداع الرقعة.

أما خطاف ما بعد إيداع الرقعة (post-applypatch) فهو الخطاف الأخير الذي ينفَّذ عند تطبيق رقعة بريدية بالأمر git am، وينفَّذ بعد صنع الإيداع. فيمكنك استعماله لإعلام صاحب الرقعة أو غيره بإتمام إيداعها. ولا يمكنك إيقاف الرقعة بهذا البُريمج.

ينفَّذ خطاف ما قبل إعادة التأسيس (pre-rebase) قبل إعادة تأسيس أي شيء، ويمكنه إيقاف العملية بإنهاء تنفيذه بقيمة خروج غير الصفر. فيمكنك استعماله لمنع إعادة تأسيس أي إيداعات قد دُفعت. البُريمج المثال المرفق مع جت يفعل هذا، إلا أنه يفترض بعض الأمور التي قد لا توافق أسلوب عملك.

أما خطاف ما بعد التحرير (post-rewrite) فتنفِّذه الأوامر التي تبدّل الإيداعات، مثل أم‍ر تصحيح الإيداع git commit --amend وأم‍ر إعادة التأسيس git rebase (لكن ليس أم‍ر معالجة الفروع git filter-branch). مُعامِله الوحيد هو الأمر الذي سبّب التحرير، ويستقبل قائمة بالتحريرات على المَدخل المعياري (stdin). معظم استعمالات هذا الخطاف مثل خطافَيْ post-checkout و post-merge التاليين.

بعد نجاح أمر السحب، ينفّذ خطاف ما بعد السحب (post-checkout). يمكنك استعماله لإعداد مجلد عملك ليناسب بيئة مشروعك. قد يعني هذا مثلا أن تنقل إليه ملفات رقْمية كبيرة لا تريدها في تاريخ المستودع، أو أن توّلد الوثائق، أو شيئًا من هذا القبيل.

أما خطاف ما بعد الدمج (post-merge) فينفَّذ بعد نجاح أمر الدمج. فيمكنك استعماله لكي تستعيد إلى مجلد العمل البيانات التي لا يسجلها جت، مثل أذونات الملفات. ويمكنه كذلك تحقّق وجود ملفات معينة يتجاهلها جت وتريدها عندما يتبدّل مجلد العمل.

ويعمل خطاف ما قبل الدفع (pre-push) عند تنفيذ أمر الدفع، بعد تحديث الإشارات البعيدة لكن قبل نقل أي كائن. يستقبل مُعامِلين هما اسم البعيد المدفوع إليه، ورابطه، ويستقبل من المدخل المعياري قائمة من الإشارات التي ستُحدَّث. يمكنك استعماله لتحقق تحديثات الإشارات قبل إتمام الدفع، فإن إنهاء تنفيذه بقيمة خروج غير الصفر يوقف الدفع.

خلال عمل جت أحيانا يحتاج تنظيف سجلاته الخاصة بالمستودع، فينفّذ جت أمر التنظيف الآلي git gc --auto، الذي ينظّم الملفات الداخلية للمستودع ويحذف المهملات. (gc اختصار ‪“garbage collection”‬ («جمع المهملات»).) ينفَّذ خطاف ما قبل التنظيف الآلي (pre-auto-gc) قُبَيل بدء التنظيف الآلي، ليُخبرك مثلًا بحدوثه، أو ليمنعه إن لم يمكن الوقت مناسبًا لذلك.

أول بُريمج يعمل عند استقبال دفع من عميل هو خطاف ما قبل الاستلام (pre-receive). ويقرأ من المَدخل المعياري (stdin) قائمةَ الإشارات التي تُدفع. فإذا أنهى تنفيذه بقيمة خروج غير الصفر، لم تُقبل أيٌّ منهم. فيمكنك استعماله مثلًا للتحقُّق أن الإشارات المحدّثة جميعها إيداعات تسريع، أو لتحقُّق صلاحيات الوصول للإشارات والملفات التي تعدلها إيداعات هذا الدفع.

خطاف التحديث (update) يشبه كثيرا خطاف ما قبل الاستلام (pre-receive)، إلا أنه ينفّذ مرة لكل فرع يريد تحديثه الذي يدفع. فإن كان يدفع إلى عدة فروع، فإن خطاف ما قبل الاستلام (pre-receive) سينفّذ مرة واحدة فقط، أما خطاف التحديث (update) سينفّذ م‍رة لكل فرع يدفع إليه. وبدلًا من القراءة من المدخل المعياري، فإنه يقبل ثلاثة معاملات: اسم الإشارة (الفرع)، وبصمة SHA-1 التي كانت تشير إليها الإشارة قبل الدفع، وبصمة SHA-1 التي يريد المستخدم دفعها. فإذا أنهي البُريمج تنفيذه بقيمة خروج غير الصفر، فستُرفض هذه الإشارة وحدها. أما الإشارات الأخرى فلن تتأثر به وقد تقبل.

أما خطاف ما بعد الاستلام (post-receive) فيعمل بعد تمام العملية بكاملها، ويُستعمل لتحديث الخدمات الأخرى أو إعلام المستخدمين. ويقرأ المعطيات نفسها من المدخل المعياري مثل خطاف ما قبل الاستلام (pre-receive) تماما. يمكن استعماله لإرسال بريد شابكي إلى قائمة بريدية، أو تنبيه خادوم دمج مستمر (CI)، أو تحديث نظام متابعة مسائل. فيمكنك تحليل رسائل الإيداع برمجيًّا لتعلم إن كانت مسألةٌ ما تحتاج إلى الفتح أو التعديل أو الغلق. لن يُوقف هذا البريمج عمليةَ الدفع، لكن لن يقطع العميل اتصاله إلا عندما يتنهي، فاحذر أن تفعل شيئًا قد يستغرق وقتًا طويلًا.