أساسيات Git للمختبِرين

لماذا يهم

«أي بناء (build) اختبرت؟» سؤال يجيب عنه Git بدقة. فمن دون معرّف الإيداع يصعب إعادة إنتاج الإخفاق، ولا يستطيع أحد أن يثبت أن إعادة الاختبار جرت على النسخة التي فيها الإصلاح. أما عبارة «يفشل على main عند 3f9c2ab» فيستطيع أي عضو في الفريق إعادة إنتاجها.

ويُظهر Git أيضاً ما الذي تغيّر: فالفروقات (diff) منذ آخر نسخة مختبَرة مدخل مباشر لاختيار اختبارات الانحدار. كما أن الاختبارات الآلية وبيانات الاختبار وملفات خط الأنابيب تعيش في المستودع نفسه مع شيفرة المنتج، فصيانتها تعني أن تودع وتنشئ الفروع وتدمج كما يفعل المطور.

المستودع والإيداع والأماكن الثلاثة التي يمر بها التغيير

المستودع (repository) مجلد المشروع مع تاريخه الكامل، ويحفظه Git في مجلد مخفي اسمه .git. أما النسخة المشتركة للفريق، أي المستودع البعيد (remote) الذي يُسمّى عادةً origin، فتوجد على خادم، والأمر git clone ينسخها إلى جهازك مع التاريخ كله. وبعد ذلك ينزّل git fetch الإيداعات الجديدة ويسجّل المواضع التي صارت تشير إليها فروع المستودع البعيد بأسماء مثل origin/main دون أن يمس ملفاتك، أما git pull فيحدّث فرعك الحالي أيضاً، ويرسل git push إيداعاتك أنت إلى origin.

يمر التغيير بثلاثة أماكن: شجرة العمل (working tree) وهي الملفات التي تعدّلها، ومنطقة التجهيز (staging area) أو الفهرس (index) وفيها التغييرات التي تختارها بالأمر git add، ثم التاريخ حيث يسجّل git commit لقطة لما جُهّز. ويسمّي Git كل إيداع ببصمة (hash)، وهي قيمة ثابتة الطول تُحسب من محتوى الإيداع وتاريخه: ⁦40⁩ محرفاً بالنظام السداسي العشري (بخوارزمية SHA-1 في معظم المستودعات)، وتُعرض عادةً مختصرةً إلى أول سبعة محارف أو أكثر مثل 3f9c2ab. وإذا تغيّر محرف واحد تغيّر المعرّف، ولذلك يدل معرّف الإيداع على نسخة واحدة بالضبط. وتُظهر أداة «مولّد SHA-1» هذا الأثر على أي نص، لكن Git يحسب بصمة الإيداع بصيغته الداخلية الخاصة، فلن تحصل بها على معرّف إيداع.

$ git clone https://git.example.com/shop/web.git  # the repository and its history
$ cd web
$ git fetch                     # later: get new commits from origin; files untouched
$ git pull                      # fetch, then bring your current branch up to date
$ git status                    # what is modified, staged or untracked
$ git add tests/checkout/vat.spec.ts
$ git commit -m "Add VAT test for a total ending in .005"
$ git push                      # send your new commits to origin

جرّبها: مولّد SHA-1

الفروع وHEAD والدمج

الفرع (branch) اسم متحرك يشير إلى إيداع واحد، وكل إيداع جديد على الفرع يحرّك الاسم إلى الأمام. ويحمل الفرع main (وفي المستودعات الأقدم غالباً master) عادةً النسخة المدمجة من المنتج، وينشئ المطورون فرعاً قصير العمر لكل تغيير، مثل fix/vat-rounding، حتى لا يزعج العمل غير المكتمل أحداً. وHEAD هو ما سحبته (checked out) حالياً، وهو عادةً فرع.

الدمج (merge) يُدخل إيداعات فرع في فرع آخر. فإذا لم يتحرك الفرع الهدف منذ بدء الفرع، يكتفي Git بتحريك اسمه إلى الأمام (fast-forward)؛ وإذا كان لدى الطرفين إيداعات جديدة، أنشأ إيداع دمج له أبوان. وإذا غيّر الطرفان الأسطر نفسها، توقف Git عند تعارض دمج (merge conflict) وكتب شخصٌ النتيجة. وحتى الدمج النظيف يجمع تغييرات لم تُشغَّل معاً من قبل، لذا يستحق البناء المدمج اختباراً خاصاً به. أما استراتيجيات التفريع وطلبات الدمج (pull requests) فموضوع الدرس التالي.

في مخرجات git log --graph تمثّل كل * إيداعاً، وتقود الخطوط إلى آبائه، وتبيّن الأسماء بين القوسين أين تشير الفروع والوسوم (tags) وHEAD.

$ git switch -c fix/vat-rounding   # new branch at the current commit, switch to it
$ git commit -am "Fix VAT rounding for totals ending in .005"  # -a stages edited files
$ git switch main
$ git pull                         # fast-forward: two new commits from colleagues
$ git merge fix/vat-rounding       # both sides moved on: Git makes a merge commit
$ git log --oneline --graph -5
*   9e41d07 (HEAD -> main) Merge branch 'fix/vat-rounding' into main
|\
| * 3f9c2ab (fix/vat-rounding) Fix VAT rounding for totals ending in .005
* | c7d2e18 (origin/main) Add Arabic labels to the invoice PDF
* | 5b0a9f4 Update minimum order total to 50.00 SAR
|/
* 1d2e3f4 (tag: v2.3.0) Release 2.3.0

قراءة التاريخ بالأوامر log وshow وdiff

يعرض git log الإيداعات من الأحدث إلى الأقدم، ويعرض git show إيداعاً واحداً مع تغييراته، ويقارن git diff بين أي نسختين. والوسم (tag) اسم ثابت لإيداع واحد، وغالباً ما يكون إصداراً مثل v2.3.0.

في الفروقات أدناه يسمّي --- و+++ الملف القديم والملف الجديد، والأسطر التي تبدأ بـ- حُذفت، والتي تبدأ بـ+ أُضيفت، ويعني @@ -9,5 +9,5 @@ أن المقطع يبدأ من السطر ⁦9⁩ ويمتد خمسة أسطر في النسختين، أما النص الذي يلي @@ الثانية فمجرد سطر سابق من الملف يُعرض للتوجيه.

• git log --oneline v2.3.0..main: كل ما في main وليس في الإصدار v2.3.0.
• git log --oneline -- src/checkout/: الإيداعات التي لمست مجلد الدفع فقط.
• git diff --stat v2.3.0 main: الملفات التي تغيّرت وعدد أسطرها بين نسختين.
• git tag --contains 3f9c2ab: الإصدارات التي تتضمن إصلاحاً معيناً.

$ git diff v2.3.0 main -- src/checkout/vat.ts
diff --git a/src/checkout/vat.ts b/src/checkout/vat.ts
index 4b1e2c0..9d7a3f1 100644
--- a/src/checkout/vat.ts
+++ b/src/checkout/vat.ts
@@ -9,5 +9,5 @@ import { roundHalfUp } from './money';
 // VAT rate in this example: 15 %
 export function vatFor(net: number): number {
   const rate = 0.15;
-  return Math.round(net * rate * 100) / 100;
+  return roundHalfUp(net * rate, 2);
 }

جرّبها: مقارنة النصوص (Diff)

مثال تطبيقي: ما الذي تغيّر منذ آخر إصدار

اختبرت الإصدار v2.3.0 الأسبوع الماضي، واليوم طُلب منك اختبار انحدار على أحدث نسخة من main. وقبل أن تفتح التطبيق تسأل Git عمّا تغيّر، والأوامر ومخرجاتها في نهاية هذا القسم. اقرأها ملفاً ملفاً:

• vat.ts: تغيّر سطر واحد في تقريب ضريبة القيمة المضافة. اختبر مبالغ تنتهي ضريبتها بنصف هللة، مثل سعر صافٍ قدره ⁦1.10⁩ ريال (الضريبة ⁦0.165⁩). ويبيّن git grep أن الإجماليات والمبالغ المستردة تستدعي vatFor أيضاً، فيدخل الاسترداد في النطاق.
• min-order.ts: أصبح الحد الأدنى للطلب ⁦50.00⁩ ريالاً. اختبر ⁦49.99⁩ و⁦50.00⁩ كما في تحليل القيم الحدّية، وإن لم تذكر أي تذكرة أو ملاحظات إصدار هذا التغيير فاسأل قبل الاختبار.
• labels.ar.json: تسميات عربية جديدة للفاتورة. افحص فاتورة PDF العربية واتجاهها من اليمين إلى اليسار.
• vat.spec.ts: اختبارات وحدة جديدة. القيم التي تغطيها تحتاج جهداً يدوياً أقل، والقيم التي تفوتها تدخل قائمتك.
• اكتب «اختبار انحدار على main عند 9e41d07، والتغييرات منذ v2.3.0» في تقرير الاختبار وفي كل تقرير خطأ.

$ git fetch origin
$ git log --oneline v2.3.0..origin/main
9e41d07 (origin/main) Merge branch 'fix/vat-rounding' into main
3f9c2ab Fix VAT rounding for totals ending in .005
c7d2e18 Add Arabic labels to the invoice PDF
5b0a9f4 Update minimum order total to 50.00 SAR
$ git diff --stat v2.3.0 origin/main
 src/checkout/min-order.ts  |  4 ++--
 src/checkout/vat.ts        |  2 +-
 src/invoice/labels.ar.json | 18 ++++++++++++++++++
 tests/checkout/vat.spec.ts | 21 +++++++++++++++++++++
 4 files changed, 42 insertions(+), 3 deletions(-)
$ git grep -n "vatFor(" origin/main -- src
origin/main:src/checkout/total.ts:27:  const vat = vatFor(net);
origin/main:src/checkout/vat.ts:10:export function vatFor(net: number): number {
origin/main:src/refunds/refund.ts:41:  return amount + vatFor(amount);

جرّبها: مولّد سيناريوهات الانحدار

أسئلة شائعة

المراجع

• Reference — GitGit projectالمرجع الرسمي لكل أوامر Git وخياراتها، مجمّعةً حسب المهمة — الإعداد والتفريع والمشاركة وتطبيق الرقع والفحص وتتبّع الأخطاء.
• Pro Git, 2nd Edition (Scott Chacon and Ben Straub)Apress · 2014كتاب Pro Git المتاح للقراءة مجاناً على الإنترنت: أساسيات Git، والتفريع والدمج، وسير العمل الموزّع، وكيف يخزّن Git بياناته.
• ISTQB Certified Tester Foundation Level (CTFL) v4.0ISTQB · 2023المنهج التأسيسي لاختبار البرمجيات: مستويات الاختبار وأنواعه وتقنيات تصميم الاختبارات وإدارة الاختبار والأدوات.