المنهج الدراسي الدرس 118 من 148 · ابتكر أدواتك الخاصة
ابتكر أدواتك الخاصة

ملخص مخاطر الاختلاف

لماذا هذا مهم يقرأ المراجعون بسرعة. ملخص من سطر واحد في أعلى طلب السحب ("يعدل migration، يضعف tests") يخبرهم أين يبطئون، وهو نفسه في كل مرة، على عكس طلب من chat بـ "review this diff".

يدوّن فريقك قواعد المراجعة الخاصة به ويريد أداة تطبّقها على diff موحّد (مخرجات git diff). كل ملف في الـ diff قسم يبدأ بسطر diff --git a/OLD b/NEW. تتبعه أسطر الترويسة (index، ---، +++، new file mode، deleted file mode، rename from/to، similarity index، Binary files ... differ). بعد أول سطر @@ في القسم، كل سطر محتوى: + مضاف، - محذوف، ومسافة للسياق.

الاختلافات الحقيقية أكثر فوضوية من تلك الموجودة في الكتاب الدراسي. إعادة التسمية البحتة لا تحتوي على أسطر ---/+++ ولا تحتوي على محتوى. الملف الثنائي لا يحتوي على أي منهما. سطر +++ للملف المحذوف يقول /dev/null. وتعليق SQL المحذوف، -- old note، يظهر في الاختلاف كـ --- old note.

دورك

اكتب risk_summary(diff). مسار الملف هو NEW من سطر diff --git الخاص به، أو OLD إذا كان القسم يحتوي على سطر deleted file mode. المسارات لا تحتوي على مسافات. أرجع dict من الفئة إلى قائمة المسارات المرتبة فيها (استبعد الفئات الفارغة):

  • schema: يوجد دليل في المسار باسم migrations، أو ينتهي اسم الملف بـ .sql.
  • secrets: يحتوي سطر added على password، أو secret، أو api_key، أو token، في أي حالة كانت.
  • tests-weakened: ملف اختبار (يبدأ اسمه بـ test_، أو يوجد دليل باسم tests) يتم حذفه، أو يحتوي على أسطر محذوفة أكثر من الأسطر المضافة التي تحتوي على assert.
  • dependencies: اسم الملف هو requirements.txt، pyproject.toml، package.json أو package-lock.json.
  • config: ينتهي اسم الملف بـ .yml، .yaml، .ini أو .env، أو يكون settings.py.
فخ للتغلب عليه: تستخدم الاختبارات أسماء مستعارة، وملفات ثنائية، وملفات محذوفة وجديدة، وتعليقات SQL، كما هو موضح أعلاه.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.