> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# اختبارات الوحدة Unit Tests عملياً: متى تستخدم Mocks؟
- URL: https://arabroot.io/articles/اختبارات-الوحدة-unit-tests-عمليا-ومتى-تستخدم-mocks/
- Published: 2026-11-03T17:07:14.000Z
- Updated: 2026-11-03T18:07:07.000Z
- Description: كيف تكتب اختبارات وحدة تفشل حين يوجد خطأ وتنجح حين لا يوجد، ومتى يكون ال Mock مفيداً ومتى يخفي الأخطاء، مع تجربة على خدمة تجديد اشتراكات.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, DevOps والتشغيل, DevOps وCI/CD, الاستضافة الذاتية

تقوم بتغيير صغير في الكود لا يلاحظه أي مستخدم، كأن تجمع عمليتي حفظ في قاعدة البيانات في عملية واحدة، أو تغير طريقة استدعاء دالة إرسال البريد، فتجد أن عشرات الاختبارات أصبحت حمراء، فتقضي بقية اليوم في تعديل الاختبارات حتى تعود خضراء دون أن تكتشف خطأً واحداً. وفي الشهر نفسه يصلك بلاغ من عميل اشترك في 31 يناير فجددت المنصة اشتراكه في 2 مارس بدلاً من آخر فبراير، مع أن الملف الذي يحسب التاريخ عليه اختبارات وتقرير التغطية يقول 100%. وهذا هو الوضع الذي يجعل كثيراً من الفرق تشك في اختبارات الوحدة أصلاً: اختبارات تفشل حين لا يوجد خطأ، وتنجح حين يوجد خطأ.

وقد شرحنا في مقال [أنواع الاختبارات للمبتدئين](https://arabroot.io/articles/%D8%A7%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-unit-%D9%88-integration-%D9%88-e2e/#unit) ما هو اختبار الوحدة Unit Test ومكانه بين أنواع الاختبارات الأخرى، وعرفنا هناك البدائل Test Doubles بأنواعها الخمسة. وهذا المقال يكمل من هناك ويجيب عن الأسئلة التي تظهر عندما تكتب اختبارات الوحدة في مشروع حقيقي: ماذا تختبر بالضبط، ومتى يكون ال Mock هو الأداة الصحيحة ومتى يجعل اختباراتك تكذب عليك، وكيف تختبر كوداً يعتمد على الوقت والتاريخ، ولماذا ينجح اختبار وحده ويفشل مع غيره. وسوف نتبع في المقال كله مثالاً واحداً، وهو منصة اشتراكات لبرنامج إدارة عيادات، فيها خطة شهرية بسعر 99 ريالاً وخطة سنوية بسعر 990 ريالاً، ومهمة تعمل كل ليلة تجدد الاشتراكات التي تنتهي اليوم: تحسب المبلغ مع ضريبة القيمة المضافة VAT بنسبة 15% كما تحددها [هيئة الزكاة والضريبة والجمارك](https://zatca.gov.sa/ar/RulesRegulations/Taxes/Pages/default.aspx?ref=arabroot.io)، ثم تخصم من بطاقة العميل عبر بوابة الدفع Payment Gateway، ثم تنقل تاريخ نهاية الاشتراك وترسل الإيصال.

وسوف نناقش في هذا المقال ما يلي:

- ما هي الوحدة Unit التي نختبرها، ولماذا نختبر السلوك Behavior وليس طريقة كتابة الكود.
- شكل الاختبار الجيد: الترتيب ثم التنفيذ ثم التحقق، والأسماء، وجداول الحالات Parametrized Tests.
- متى تستخدم Mock ومتى تستخدم Fake، والتحقق من الحالة State مقابل التحقق من الاستدعاءات Interaction، وكيف يكذب ال Mock.
- الوقت والتاريخ والعشوائية: حقن الساعة Clock Injection، وتوقيت السعودية، والتواريخ الحدية، مع حادثة يوم 29 فبراير في Azure.
- عزل الاختبارات Test Isolation والحالة المشتركة، والسرعة، والتغطية، وإضافة اختبارات لكود قديم.
- تجربة عملية بلغة Python على خدمة التجديد: مجموعة اختبارات مبنية على Mocks تنجح والكود فيه ثلاثة أخطاء، ثم مجموعة مبنية على السلوك تكشفها، ثم إعادة هيكلة تفشل فيها الأولى وتنجح الثانية، ثم ترتيب عشوائي يكشف اختباراً يعتمد على غيره.

## ما هي «الوحدة» Unit التي نختبرها؟

أول سؤال يختلف عليه المطورون هو حجم الوحدة، فهناك من يرى أن الوحدة هي الكلاس أو الدالة الواحدة، وأن كل ما تتعامل معه يجب أن يستبدل ببديل، وهناك من يرى أن الوحدة هي سلوك واحد يراه من يستخدم الكود، حتى لو مر هذا السلوك على عدة كلاسات حقيقية. وقد سمى Martin Fowler الأسلوبين في مقاله [UnitTest](https://martinfowler.com/bliki/UnitTest.html?ref=arabroot.io)، فالاختبار المنعزل Solitary يستبدل كل ما يتعامل معه الكود، والاختبار الاجتماعي Sociable يترك الكلاسات الحقيقية تعمل معاً ويستبدل فقط ما هو بطيء أو خارجي، وذكر أن الأسلوبين كانا موجودين منذ البداية، وأن ما يجمعهما ثلاثة أشياء: الاختبار يركز على جزء صغير، والمطور نفسه يكتبه، وهو سريع بما يكفي لتشغيله عشرات المرات في اليوم.

وفي منصة الاشتراكات لدينا نوعان من الكود، والفرق بينهما هو الذي يحدد طريقة الاختبار. فالنوع الأول هو المنطق الخالص Pure Logic، مثل حساب المبلغ مع الضريبة والخصم، وحساب تاريخ التجديد التالي، وهذه دوال تأخذ مدخلات وترجع نتيجة ولا تقرأ من قاعدة بيانات ولا ترسل شيئاً، فاختبارها سهل جداً: استدع الدالة وقارن النتيجة. والنوع الثاني هو الكود الذي ينسق بين الأطراف، مثل خدمة التجديد التي تسأل قاعدة البيانات عن الاشتراكات المستحقة، وتطلب الخصم من بوابة الدفع، وتحفظ النتيجة، وترسل البريد، وتعرف التاريخ من ساعة السيرفر، وهذا الكود هو الذي يحتاج قرارات: أي من هذه الأطراف تتركه حقيقياً، وأيها تستبدله، وبماذا. والصورة التالية تبين الخدمة والأطراف التي حولها:

![مخطط خدمة التجديد في الوسط، وحولها أربعة أطراف: الساعة وقاعدة البيانات وبوابة الدفع والبريد، وكل طرف عليه البديل المناسب له في اختبار الوحدة: ساعة ثابتة، ومستودع في الذاكرة، وبوابة Fake ترجع نتيجة حقيقية، وصندوق بريد يحفظ الرسائل](https://arabroot.io/content/images/2026/11/unit-testing-01-unit-boundary.webp)

المنطق الخالص يختبر مباشرة، والأطراف البطيئة أو الخارجية حول الخدمة هي فقط ما نستبدله

والقاعدة العملية التي نستخدمها في هذا المقال هي أن الوحدة سلوك واحد يمكن أن تصفه بجملة يفهمها صاحب المنتج، مثل «الاشتراك الذي ينتهي اليوم يجدد ويخصم مبلغه مع الضريبة وينتقل شهراً»، وأن الاختبار يستبدل فقط ما يجعله بطيئاً أو غير ثابت النتيجة أو مكلفاً، أي قاعدة البيانات وبوابة الدفع والبريد والساعة، ويترك الباقي حقيقياً. والسبب أن كل بديل تضعه هو افتراض منك عن سلوك الطرف الحقيقي، وكل افتراض قد يكون خاطئاً، وسوف ترى في التجربة كيف نجحت ستة اختبارات لأن البدائل فيها افترضت واجهة لا توجد في الكود الحقيقي أصلاً.

## ماذا تختبر؟ السلوك Behavior بدلاً من التنفيذ Implementation

عندما يجلس المطور ليكتب الاختبارات بعد أن انتهى من الكود، فإنه غالباً يمر على الدوال واحدة واحدة ويكتب لكل منها اختباراً، فيخرج بمجموعة اختبارات تشبه الكود نفسه: لكل دالة اختبار، ولكل استدعاء داخلي تحقق. وهذه الطريقة تبدو منظمة، ولكنها تربط الاختبار بالطريقة التي كتب بها الكود اليوم، فإذا قسمت دالة إلى دالتين أو غيرت ترتيب خطوتين فسوف تفشل اختبارات كثيرة مع أن ما يراه المستخدم لم يتغير.

وقد خصص فريق Google في كتاب [Software Engineering at Google](https://abseil.io/resources/swe-book/html/ch12.html?ref=arabroot.io) فصلاً كاملاً لاختبارات الوحدة، وعرف فيه الاختبار الهش Brittle Test بأنه الاختبار الذي يفشل بسبب تغيير في الكود لا يضيف أي خطأ حقيقي، وذكر أن الاختبار المثالي هو الذي لا يتغير بعد كتابته إلا إذا تغيرت متطلبات النظام نفسه. ومن هذا التعريف تخرج القواعد التالية.

### اختبر من الواجهة العامة Public API

استدع الكود كما يستدعيه من يستخدمه، أي من الدوال والكلاسات العامة، ولا تقم باختبار الدوال الخاصة Private مباشرة ولا بقراءة المتغيرات الداخلية للكلاس. والسبب أن الواجهة العامة عقد بينك وبين من يستخدم الكود، فإذا فشل اختبار مكتوب عليها فهذا يعني أن مستخدماً حقيقياً سوف يتأثر، أما الدالة الخاصة فهي تفصيل يحق لك تغييره متى شئت. وفي خدمة التجديد الواجهة العامة هي `RenewalService.run()`، وما يهمنا بعد تشغيلها هو ما حدث في العالم: من خصم منه، وما تاريخ نهاية اشتراكه الآن، وما الرسالة التي وصلته. ولاحظ أن هذا لا يمنع أن تكون للدالة الخاصة المعقدة اختباراتها، ولكن الحل الأنسب عندها أن تخرجها إلى دالة عامة في ملف خاص بها، كما فعلنا مع `add_months`، فتصبح وحدة لها عقدها الخاص.

### أين تبدأ؟ حسب المخاطر Risk

ليس لديك وقت لاختبار كل شيء بالعمق نفسه، لذلك ابدأ بالكود الذي إذا أخطأ كلف مالاً أو ثقة أو بيانات: الحسابات المالية والتقريب، والتواريخ والمدد، والصلاحيات، والتحويل بين الصيغ، والشروط التي فيها حدود مثل «من 200 ريال فأكثر». وهذه هي الأماكن التي تختبر فيها القيم الحدية Boundary Values التي شرحناها في [مقال ضمان الجودة QA](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%B6%D9%85%D8%A7%D9%86-%D8%A7%D9%84%D8%AC%D9%88%D8%AF%D8%A9-qa-%D9%88%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-%D9%81%D8%B1%D9%8A%D9%82-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1/#boundary-values)، أي الحد نفسه وما قبله وما بعده. وفي منصة الاشتراكات أخطر دالتين هما حساب المبلغ وحساب تاريخ التجديد، لأن الأولى تخصم مال العميل والثانية تحدد متى يخصم مرة أخرى، ولذلك أخذتا في التجربة أكثر من نصف الاختبارات.

### ما الذي لا يستحق اختبار وحدة؟ What Not to Test

هناك كود يكون اختباره بالوحدة مضيعة للوقت أو خداعاً للنفس. فالدوال التي تنقل قيمة من مكان إلى مكان دون أي قرار، مثل Getter وSetter، لا تحتاج اختباراً خاصاً بها لأنها سوف تنفذ ضمن اختبارات السلوك. وكود الإطار Framework نفسه، مثل أن Django يحفظ النموذج أو أن Express يوجه الطلب، مختبر عند أصحابه. واستعلامات SQL لا يثبت صحتها أي اختبار وحدة، لأن البديل في الذاكرة لا يفهم SQL، فمكانها اختبار التكامل Integration Test على قاعدة بيانات حقيقية في Container كما فعلنا في [تجربة أنواع الاختبارات](https://arabroot.io/articles/%D8%A7%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-unit-%D9%88-integration-%D9%88-e2e/#lab-integration-tests). وملفات الإعداد والقوالب تختبرها بتشغيل التطبيق نفسه. والقاعدة هنا أن اختبار الوحدة يجيب عن سؤال «هل المنطق صحيح؟»، فإذا كان السؤال «هل الأجزاء تعمل معاً؟» فهو سؤال لنوع آخر من الاختبارات.

## شكل الاختبار الجيد Test Anatomy

الاختبار يقرأ أكثر مما يكتب، وأكثر من يقرأه هو مطور آخر بعد سنة فشل عنده الاختبار ولا يعرف لماذا، لذلك اكتب الاختبار بحيث يفهم من يقرأه ما السلوك المتوقع دون أن يفتح الكود.

### الترتيب ثم التنفيذ ثم التحقق Arrange Act Assert

قسم كل اختبار إلى ثلاثة أجزاء واضحة: الترتيب Arrange، أي تجهيز البيانات والبدائل، ثم التنفيذ Act، أي استدعاء واحد للسلوك الذي تختبره، ثم التحقق Assert من النتيجة. والجزء الأوسط يجب أن يكون سطراً واحداً تقريباً، فإذا وجدت نفسك تستدعي ثلاث دوال وتتحقق بعد كل واحدة فهذا يعني غالباً أنك تختبر ثلاثة سلوكيات في اختبار واحد، وعندما يفشل لن تعرف أيها فشل. وفي اختبار التجديد في التجربة ترى الترتيب في سطر يجهز الاشتراك، والتنفيذ في استدعاء `run`، ثم أربعة أسطر تحقق، وكلها تتحقق من نتيجة السلوك نفسه: القائمة المرجعة، والمبلغ المخصوم، والتاريخ الجديد، والرسالة.

### اسم الاختبار Test Name يصف السلوك

اسم مثل `test_run` أو `test_add_months_2` لا يخبرك بشيء عندما يظهر في تقرير خط CI، أما اسم مثل `test_declined_card_marks_past_due_and_keeps_the_period` فهو جملة تقرأ كمتطلب، وعندما يفشل تعرف فوراً ما السلوك الذي تغير. لذلك اكتب الاسم بصيغة «في هذه الحالة يحدث كذا»، ولا تخف من طوله، فلن يكتبه أحد يدوياً. وكذلك رسالة الفشل، فإن pytest يعرض قيمتي الطرفين عند فشل `assert` كما سترى في التجربة، أما إذا كتبت `assert result` فقط فسوف يخبرك أن القيمة False ولا شيء غير ذلك.

### الوضوح قبل منع التكرار DAMP vs DRY

في كود الإنتاج نحاول ألا نكرر شيئاً، وهو مبدأ DRY أي Don't Repeat Yourself، ولكن في الاختبارات يقترح الفصل نفسه من كتاب Google مبدأ DAMP، أي Descriptive And Meaningful Phrases، ومعناه أن يكون كل اختبار مفهوماً وحده حتى لو كررت فيه سطرين موجودين في اختبار آخر. والسبب أن الاختبار الذي يعتمد على دالة مساعدة تجهز عشرين شيئاً مخفياً يجبر القارئ على القفز بين الملفات ليعرف ما الذي يختبر. فاستخدم الدوال المساعدة لإخفاء التفاصيل التي لا تهم السلوك المختبر، مثل الدالة `run` في التجربة التي تنشئ الخدمة والبدائل، واترك القيم التي تهم الاختبار ظاهرة في الاختبار نفسه، مثل تاريخ نهاية الاشتراك والساعة.

### جدول حالات بدلاً من عشرة اختبارات Parametrized Tests

عندما يكون السلوك واحداً والمدخلات كثيرة، مثل حساب تاريخ التجديد لسبعة تواريخ مختلفة، فلا تقم بنسخ الاختبار سبع مرات، وإنما اكتبه مرة واحدة مع جدول حالات. وفي pytest يتم ذلك بالمزخرف `@pytest.mark.parametrize` كما في [وثائق pytest](https://docs.pytest.org/en/stable/how-to/parametrize.html?ref=arabroot.io)، وكل سطر في الجدول يظهر كاختبار مستقل في التقرير، وإذا أعطيت كل سطر اسماً بالخيار `ids` فسوف يظهر الفشل باسم مفهوم مثل `test_add_months[jan-31]` بدلاً من `start2-1-expected2`. والجدول له فائدة أخرى أهم، فهو يجعل الحالات الحدية مرئية للمراجع في طلب الدمج، فيسأل: أين يوم 29 فبراير؟ أين نهاية السنة؟ وهذا بالضبط ما حدث في جدول التجربة، فقد كان فيه سطر واحد يمر بالصدفة على الكود الخاطئ وستة أسطر تكشفه.

## Mock أم Fake؟ اختيار البديل Test Double المناسب

عرفنا في [مقال أنواع الاختبارات](https://arabroot.io/articles/%D8%A7%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-unit-%D9%88-integration-%D9%88-e2e/#test-doubles) الأنواع الخمسة كما شرحها Martin Fowler في [Mocks Aren't Stubs](https://martinfowler.com/articles/mocksArentStubs.html?ref=arabroot.io): Dummy وFake وStub وSpy وMock. والمشكلة العملية أن مكتبات مثل `unittest.mock` في Python وMockito في Java وVitest في JavaScript تسمي كل شيء Mock، وتجعل صنع البديل سهلاً جداً، فيصبح الحل الأول لكل اعتماد هو Mock، ثم يتحقق الاختبار من الاستدعاءات بدلاً من النتيجة. والسؤال الذي يحدد البديل الصحيح ليس «ما الذي يعتمد عليه الكود؟» وإنما «ما الذي أريد أن أتحقق منه في النهاية؟».

### التحقق من الحالة State أم من الاستدعاءات Interaction؟

في التحقق من الحالة State Verification تنفذ السلوك ثم تنظر إلى النتيجة: الاشتراك في المستودع أصبح تاريخه 2 أبريل، وصندوق البريد فيه إيصال واحد بمبلغ 113.85\. وفي التحقق من الاستدعاءات Interaction Verification تنظر إلى ما قام به الكود في الطريق: هل استدعى `save` مرة واحدة؟ هل استدعى `send` بهذه المعاملات بهذا الترتيب؟ والفرق بينهما يظهر عند أول إعادة هيكلة Refactoring، فإذا جمعت الحفظ في `save_all` بدلاً من `save` لكل اشتراك فإن الحالة النهائية لم تتغير، ولكن الاستدعاءات تغيرت، فيفشل اختبار الاستدعاءات ويبقى اختبار الحالة أخضر.

![مخطط يقارن طريقتي التحقق: اختبار الاستدعاءات يسأل هل استدعيت save مرة واحدة، واختبار الحالة يسأل ما تاريخ الاشتراك الآن، وبعد إعادة الهيكلة إلى save_all تفشل ثلاثة من ستة اختبارات استدعاءات وينجح كل اختبار حالة](https://arabroot.io/content/images/2026/11/unit-testing-02-state-vs-interaction.webp)

اختبار الاستدعاءات يراقب الطريق، واختبار الحالة ينظر إلى النتيجة، وإعادة الهيكلة تغير الطريق فقط

ويسمي بعض مهندسي Google الاختبارات التي تبالغ في التحقق من الاستدعاءات اختبارات كشف التغيير Change-detector Tests، كما يذكر [فصل البدائل Test Doubles](https://abseil.io/resources/swe-book/html/ch13.html?ref=arabroot.io) في الكتاب نفسه، لأنها تفشل مع أي تغيير في الكود حتى لو لم يتغير السلوك. ويوصي الفصل بتفضيل الواقعية على العزل Prefer Realism Over Isolation، أي استخدام الكلاس الحقيقي إذا كان سريعاً وثابت النتيجة، ثم Fake إذا لم يكن كذلك، وترك التحقق من الاستدعاءات للحالات التي لا توجد فيها حالة تنظر إليها.

### أين يكون ال Mock في مكانه الصحيح؟

هل نتوقف عن استخدام ال Mock إذن؟ لا، فهناك حالات يكون فيها الاستدعاء نفسه هو السلوك المطلوب، وأشهرها الأثر الجانبي الخارجي الذي لا يترك حالة تستطيع قراءتها، مثل خصم مبلغ من بطاقة أو إرسال رسالة نصية أو نشر حدث إلى طرف آخر. وحتى في هذه الحالات ستجد أن Spy بسيطاً يسجل ما وصله، مثل `OutboxMailer` في التجربة الذي يحفظ الرسائل في قائمة، أوضح من Mock مبرمج بالتوقعات، لأنك تتحقق من القائمة بعد التنفيذ كما تتحقق من أي حالة أخرى. ويوصي فصل Google بأن يكون التحقق من الاستدعاءات للدوال التي تغير حالة في مكان آخر فقط، مثل `charge` و`send`، وليس للدوال التي تقرأ فقط مثل `find_due`، لأن التحقق من دالة قراءة لا يضيف حماية ويزيد الهشاشة.

وهناك قاعدة مشهورة عند من يستخدمون ال Mocks كثيراً، وهي ألا تقوم بعمل Mock لشيء لا تملكه، أي لا تستبدل مكتبة طرف آخر مباشرة، مثل مكتبة HTTP أو SDK بوابة الدفع، وإنما اكتب حولها كلاساً صغيراً خاصاً بك، مثل `PaymentGateway` في التجربة، يحول لغة المزود إلى لغة تطبيقك (`ChargeResult` فيه `ok` و`code`)، ثم استبدل هذا الكلاس في اختبارات الوحدة، واختبر الكلاس نفسه مرة واحدة أمام بيئة الاختبار Sandbox عند المزود في اختبار تكامل. والسبب أن واجهة المكتبة الخارجية تتغير مع إصداراتها وأنت لا تتحكم فيها، فإذا كانت البدائل مبعثرة في مئة اختبار فسوف تعدل مئة اختبار مع كل ترقية، أما إذا كانت خلف كلاس واحد فسوف تعدل مكاناً واحداً.

### عندما يكذب ال Mock: الواجهة المتخيلة Autospec

الكائن `Mock` في Python يقبل أي اسم خاصية وأي استدعاء، ويرجع Mock جديداً في كل مرة، والـ Mock كقيمة منطقية يعتبر True. وهذا يعني أن الكود الذي يقرأ `result.approved` من بوابة دفع لا تملك هذا الحقل أصلاً سوف ينجح في الاختبار، لأن `Mock().approved` قيمة موجودة وصحيحة، بينما سيفشل في الإنتاج بخطأ `AttributeError` عند أول عميل. وهذا ليس افتراضاً، فهو أول خطأ من الأخطاء الثلاثة التي مرت من اختبارات ال Mocks في التجربة.

والحل الذي توفره المكتبة هو `create_autospec` أو المعامل `spec`، حيث يأخذ ال Mock شكل الكلاس الحقيقي، فيرفض الخصائص التي لا يملكها الكلاس ويرفض الاستدعاء بعدد معاملات خاطئ، كما في [وثائق Autospeccing](https://docs.python.org/3/library/unittest.mock.html?ref=arabroot.io#autospeccing). والحل الأفضل في رأينا أن ترجع البدائل قيماً حقيقية من نوع `ChargeResult` وليس Mocks، لأن القيمة الحقيقية لا يمكن أن تملك حقلاً غير موجود. والصورة التالية تبين الفرق كما ظهر في التجربة:

![مخطط ثلاثة بدائل لبوابة الدفع: Mock عادي يرجع True لخاصية approved غير الموجودة، وMock من create_autospec يرفض الاستدعاء بمعامل ناقص، وFake يرجع ChargeResult حقيقياً فيظهر AttributeError في الاختبار نفسه](https://arabroot.io/content/images/2026/11/unit-testing-03-mock-lies.webp)

ال Mock العادي يوافق على أي واجهة تتخيلها، والبديل الذي يرجع قيماً حقيقية يكشف الخطأ في الاختبار

### ال Fake يحتاج اختباراً أيضاً Fake Contract

قد يتساءل البعض: إذا كان ال Fake يفترض سلوك الطرف الحقيقي أيضاً، فما الذي يضمن أن افتراضه صحيح؟ والإجابة أن لا شيء يضمنه إلا أن تختبره، وهذا ما ينصح به فصل Google تحت عنوان Fakes Should Be Tested. والطريقة العملية أن تكتب مجموعة اختبارات صغيرة تصف عقد المستودع، مثل «`find_due` ترجع الاشتراكات النشطة التي تنتهي في هذا اليوم فقط»، ثم تشغلها مرتين: مرة على `InMemorySubscriptions` ومرة على المستودع الحقيقي فوق PostgreSQL في اختبار تكامل، فإذا اختلف سلوكهما يفشل أحد التشغيلين. وهذه هي الفكرة نفسها التي شرحناها في [اختبار العقود Contract Testing](https://arabroot.io/articles/%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%B9%D9%82%D9%88%D8%AF-contract-testing-%D9%85%D8%B9-pact/) بين الخدمات، ولكنها هنا داخل الخدمة الواحدة.

## الوقت والعشوائية Time and Randomness: اعتماد لا تراه

أكثر اعتماد يختبئ في الكود هو الوقت، فسطر مثل `datetime.now()` أو `date.today()` داخل الدالة يجعل نتيجتها تتغير كل يوم، والاختبار الذي ينجح اليوم قد يفشل في آخر يوم من الشهر أو بعد منتصف الليل أو في السنة الكبيسة. ونفس الشيء مع الأرقام العشوائية والمعرفات UUID.

### حقن الساعة Clock Injection

الحل الأبسط والأوضح أن تعطي الكود الساعة كمعامل بدلاً من أن يسألها بنفسه، وهذا ما يسمى حقن الاعتماد Dependency Injection. ففي التجربة تأخذ `RenewalService` المعامل `clock`، وهو دالة ترجع اللحظة الحالية، وفي الإنتاج نمرر `lambda: datetime.now(timezone.utc)`، وفي الاختبار نمرر ساعة ثابتة على لحظة نختارها، مثل 21:30 بتوقيت UTC يوم 1 مارس. وهناك مكتبات تجمد الوقت للعملية كلها، مثل freezegun في Python وFake Timers في Jest وVitest، وهي مفيدة مع كود قديم لا تستطيع تغييره، ولكن الساعة المحقونة أوضح لأن الاعتماد يظهر في توقيع الكلاس نفسه، فمن يقرأ الكود يعرف أن هذه الخدمة تعتمد على الوقت.

ولاحظ في التجربة خطأً يقع فيه كثيرون حتى مع الساعة المحقونة، فاختبارات ال Mocks لم تحقن ساعة ترجع لحظة حقيقية، وإنما حقنت Mock ترجع دالته `date()` التاريخ 2 مارس مباشرة، فتجاوز الاختبار الجزء الذي فيه الخطأ تماماً، وهو تحويل اللحظة إلى تاريخ. لذلك اجعل الساعة البديلة ترجع قيمة حقيقية من النوع نفسه الذي ترجعه الساعة الحقيقية، أي `datetime` كاملاً بمنطقته الزمنية، ودع الكود يقوم بكل التحويلات بنفسه.

### التاريخ بتوقيت السعودية Time Zone

السيرفرات وال Containers تعمل غالباً بتوقيت UTC، وعملاء المنصة يعيشون بتوقيت السعودية UTC+3، والمهمة الليلية مجدولة لتعمل بعد منتصف الليل بتوقيت السعودية بنصف ساعة. فإذا أخذ الكود التاريخ من اللحظة بتوقيت UTC فسوف يكون التاريخ عنده هو اليوم السابق، لأن 00:30 يوم 2 مارس بتوقيت السعودية هي 21:30 يوم 1 مارس بتوقيت UTC، فيبحث عن الاشتراكات التي تنتهي في 1 مارس، ولا يجد اشتراكات 2 مارس إلا في الليلة التالية، فيحصل العميل على يوم مجاني ويتأخر الإيراد يوماً، والأسوأ أن التقارير المالية بتوقيت السعودية لا تطابق ما حدث.

![خطان زمنيان متوازيان: توقيت السعودية UTC+3 وتوقيت UTC، والمهمة تعمل في 00:30 يوم 2 مارس بتوقيت السعودية، وهي نفس اللحظة 21:30 يوم 1 مارس بتوقيت UTC، فإذا أخذ الكود التاريخ بتوقيت UTC بحث عن اشتراكات 1 مارس وفاته اشتراك 2 مارس](https://arabroot.io/content/images/2026/11/unit-testing-04-timezone.webp)

لحظة واحدة وتاريخان: الاختبار الذي يثبت الساعة على 21:30 UTC يكشف الخطأ، والاختبار الذي يثبت التاريخ مباشرة لا يراه

والحل أن تحول اللحظة إلى توقيت العمل قبل أن تأخذ التاريخ منها، أي `clock().astimezone(SAUDI_TIME).date()`، وأن تكتب اختباراً يثبت الساعة في الساعات الثلاث الحرجة بين 21:00 و24:00 بتوقيت UTC. والمملكة لا تطبق التوقيت الصيفي، لذلك تكفي إزاحة ثابتة UTC+3 كما في التجربة، أما إذا كان تطبيقك يخدم مناطق فيها توقيت صيفي فاستخدم قاعدة المناطق الزمنية من خلال [الوحدة zoneinfo](https://docs.python.org/3/library/zoneinfo.html?ref=arabroot.io) باسم المنطقة، مثل `ZoneInfo("Asia/Riyadh")`، ولا تقم بكتابة الإزاحة يدوياً.

### التواريخ الحدية Date Edge Cases

حساب «بعد شهر» يبدو سهلاً حتى تسأل: ما الذي يأتي بعد شهر من 31 يناير؟ والإجابة التي يتوقعها العميل هي آخر فبراير، أي 28 أو 29 بحسب السنة، والإجابة التي يعطيها كود يضيف 30 يوماً هي 2 مارس، والإجابة التي يعطيها كود يزيد رقم الشهر فقط هي خطأ لأن 31 فبراير غير موجود. وفي التجربة كان الكود الأول يضيف 30 يوماً لكل شهر، فأعطى 2 مارس بعد 31 يناير، وأعطى 23 فبراير 2029 بعد سنة من 29 فبراير 2028 لأن 360 يوماً ليست سنة، ومع ذلك نجح اختبار ال Mocks الوحيد لهذه الدالة لأنه اختار 1 أبريل، وأبريل 30 يوماً بالضبط.

![جدول حالات حدية لحساب بعد شهر: من 1 أبريل ومن 31 يناير ومن 31 يناير في سنة كبيسة ومن 29 فبراير لسنة كاملة، مع النتيجة الصحيحة ونتيجة إضافة 30 يوماً، ثم مشكلة الانزلاق من 31 إلى 28 بعد فبراير وحلها بحفظ يوم الاشتراك الأصلي](https://arabroot.io/content/images/2026/11/unit-testing-05-month-edges.webp)

سطر واحد فقط من الجدول يمر بالصدفة على إضافة 30 يوماً، والانزلاق إلى يوم 28 ظهر بعد الإصلاح الأول

وهناك حالة أدق لا تظهر إلا إذا اختبرت أكثر من تجديد متتال، فإذا كان الحل «نفس اليوم في الشهر التالي، أو آخر يوم إذا لم يوجد» وطبقته على تاريخ النهاية الحالي، فإن العميل الذي اشترك في 31 يناير يجدد في 28 فبراير، ثم في 28 مارس بدلاً من 31 مارس، ثم يبقى على 28 إلى الأبد. وهذا ما ظهر في التجربة بعد الإصلاح الأول، والحل أن تحفظ يوم الاشتراك الأصلي Anchor Day مع الاشتراك وتحسب منه في كل مرة.

📅

في 29 فبراير 2012 توقفت أجزاء من خدمة Windows Azure، وشرحت Microsoft السبب في [تقريرها عن الحادثة](https://azure.microsoft.com/en-us/blog/summary-of-windows-azure-service-disruption-on-feb-29th-2012/?ref=arabroot.io): البرنامج الذي يعمل داخل كل جهاز افتراضي ينشئ شهادة صلاحيتها سنة، وكان يحسب تاريخ نهايتها بإضافة 1 إلى رقم السنة، فأصبح تاريخ النهاية 29 فبراير 2013، وهو تاريخ غير موجود، ففشل إنشاء الشهادة، فاعتبر النظام السيرفرات معطلة ونقل الأجهزة إلى سيرفرات أخرى فتكرر الخطأ عليها. وبدأ الخطأ في الساعة 4:00 مساءً بتوقيت المحيط الهادئ يوم 28 فبراير، أي منتصف الليل بتوقيت UTC، واستمر إصلاح آثاره حتى 1 مارس. واختبار وحدة واحد بتاريخ 29 فبراير في جدول الحالات كان سيكشف هذا السطر.

### العشوائية والمعرفات Randomness

الكود الذي ينشئ رقم فاتورة عشوائياً أو UUID أو يختار عنصراً عشوائياً يعامل بالطريقة نفسها التي عاملنا بها الساعة، أي تمرر له مولد المعرفات أو مولد الأرقام كمعامل، وتمرر في الاختبار مولداً ثابتاً يعطي قيماً تعرفها مسبقاً، أو تمرر مولداً عشوائياً ببذرة Seed ثابتة. ولا تقم بكتابة اختبار يتحقق فقط أن «القيمة ليست فارغة»، لأنه سوف ينجح مع أي شيء، وإنما تحقق من الخاصية التي تهمك، مثل أن رقمي فاتورتين متتاليتين مختلفان، أو أن المعرف بالطول والصيغة المطلوبين.

## عزل الاختبارات Test Isolation: الحالة المشتركة Shared State

كل اختبار يجب أن ينجح وحده، وينجح مع غيره، وينجح بأي ترتيب، وهذا معنى العزل. والذي يفسد العزل غالباً حالة مشتركة بين الاختبارات: متغير على مستوى الوحدة Module يعدله اختبار ولا يعيده، أو ملف مؤقت باسم ثابت، أو Cache في الذاكرة، أو متغير بيئة. وفي التجربة كتبنا اختباراً لسعر عرض شهر رمضان يغير سعر الخطة الشهرية في القاموس `PLANS` مباشرة ولا يعيده، فنجحت المجموعة كاملة بالترتيب الافتراضي لأن هذا الاختبار كان الأخير في الملف، وعندما شغلناها بترتيب عشوائي فشلت مع بعض الترتيبات، لأن اختبارات السعر جاءت بعده فوجدت 79 ريالاً بدلاً من 99.

وهذا النوع من الأخطاء هو أحد أسباب الاختبارات المتقلبة Flaky Tests التي شرحناها في [مقال أنواع الاختبارات](https://arabroot.io/articles/%D8%A7%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-unit-%D9%88-integration-%D9%88-e2e/#flaky-tests)، وخطورته أنه يظهر فجأة عندما يضيف أحد اختباراً جديداً في ملف آخر فيتغير الترتيب، أو عندما يقسم خط CI الاختبارات على أكثر من عملية. والحل من جهتين: الأولى أن يعيد كل اختبار ما غيره، وفي pytest يتم ذلك بالأداة `monkeypatch` التي تعيد القيمة الأصلية تلقائياً بعد الاختبار كما في [وثائقها](https://docs.pytest.org/en/stable/how-to/monkeypatch.html?ref=arabroot.io)، والثانية أن تشغل الاختبارات بترتيب عشوائي دائماً حتى يظهر الاعتماد الخفي مبكراً، والإضافة [pytest-randomly](https://github.com/pytest-dev/pytest-randomly?ref=arabroot.io) تفعل ذلك بمجرد تثبيتها وتطبع البذرة في أول سطر، فإذا فشل ترتيب معين تعيد تشغيله بالبذرة نفسها `--randomly-seed` وتحصل على الترتيب ذاته.

## السرعة Speed: لماذا يجب أن تعمل في ثوان؟

قيمة اختبارات الوحدة في أنها تعمل مع كل حفظ للملف تقريباً، فإذا أخذت دقيقتين فسوف يتوقف المطورون عن تشغيلها قبل كل Commit ويتركونها لخط CI، فيعرفون الخطأ بعد عشر دقائق بدلاً من ثانيتين. وفي التجربة عملت المجموعة الثانية بعشرين اختباراً في أقل من ثانية ونصف، وأغلب هذا الوقت هو بدء Python نفسه داخل ال Container، أما أبطأ اختبار فأخذ 0.01 ثانية.

والذي يبطئ اختبارات الوحدة في الواقع هو أي شيء يخرج من الذاكرة: الشبكة، وقاعدة البيانات، والملفات، والانتظار. وأشهر مثال هو كود إعادة المحاولة مع انتظار متزايد Exponential Backoff، فإذا كانت الدالة تنتظر بنفسها ثانية ثم ثانيتين ثم أربعاً فإن اختبار حالة الفشل الكامل يأخذ سبع ثوان، والحل كما في الساعة أن تمرر دالة الانتظار كمعامل، وتمرر في الاختبار دالة تسجل المدد فقط دون أن تنتظر، فتتحقق أن المدد كانت 1 ثم 2 ثم 4 في جزء من الثانية. ولكي تعرف أين يذهب الوقت استخدم الخيار `--durations` في pytest الذي يعرض أبطأ الاختبارات، وراقبه في خط CI، فالاختبار الذي يأخذ ثانية كاملة غالباً ليس اختبار وحدة.

## ماذا تعني التغطية Coverage هنا؟

عندما شغلنا مجموعة ال Mocks مع [pytest-cov](https://pytest-cov.readthedocs.io/en/latest/?ref=arabroot.io) كانت تغطية ملف خدمة التجديد 100% وتغطية ملف الحسابات 93%، والكود فيه ثلاثة أخطاء: اسم حقل غير موجود، وتاريخ بتوقيت خاطئ، وإضافة 30 يوماً بدلاً من شهر. والسبب كما شرحنا في [فقرة التغطية](https://arabroot.io/articles/%D8%A7%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-unit-%D9%88-integration-%D9%88-e2e/#coverage) أن التغطية تقيس أن السطر نفذ، ولا تقيس أن هناك اختباراً يفشل إذا كان السطر خاطئاً، فكل سطر في الخدمة نفذ، ولكن مع بدائل تقبل أي شيء. واستخدم التغطية لتجد الكود الذي لا يمر عليه أي اختبار، فهذه معلومة مفيدة، ولا تستخدمها كدليل على أن الاختبارات قوية، فلهذا السؤال أداة أخرى هي [اختبار الطفرات Mutation Testing](https://arabroot.io/articles/%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%B7%D9%81%D8%B1%D8%A7%D8%AA-mutation-testing/).

## إضافة اختبارات لكود قديم Legacy Code

أغلب الفرق لا تبدأ من الصفر، وإنما لديها كود يعمل منذ سنوات دون اختبارات، وفيه دوال طويلة تقرأ من قاعدة البيانات وتحسب وترسل في المكان نفسه. والخطأ الشائع هنا أن تبدأ بإعادة كتابة الكود «ليصبح قابلاً للاختبار» قبل أن يكون عندك أي اختبار، فتغير سلوكه دون أن تعرف. والطريقة الأكثر أماناً أن تبدأ باختبارات التوصيف Characterization Tests، وهو الاسم الذي أعطاه Michael Feathers في كتابه عن الكود القديم لاختبارات تسجل ما يفعله الكود اليوم، صحيحاً كان أو خاطئاً، من الخارج: تشغل الدالة بمدخلات حقيقية وتسجل المخرجات كما هي. وبعد أن تحميك هذه الاختبارات تبدأ في استخراج المنطق الخالص إلى دوال صغيرة، مثل `invoice_amounts` و`add_months`، وتمرير الساعة والبوابة كمعاملات، ثم تكتب لكل دالة مستخرجة اختبارات حقيقية بالقيم الصحيحة، فإذا اكتشفت أن السلوك القديم خاطئ فهذا قرار منتج تتخذه بوعي ويظهر في سجل التغييرات، وليس أثراً جانبياً لإعادة الهيكلة.

## ماذا كان سيمنع اختبار وحدة واحد؟ goto fail

في بداية 2014 أصلحت Apple ثغرة في مكتبة SSL/TLS في أنظمتها اشتهرت باسم goto fail ورقمها CVE-2014-1266، وسببها سطر `goto fail;` مكرر في الدالة التي تتحقق من توقيع السيرفر أثناء الاتصال المشفر، فكان السطر المكرر يقفز دائماً إلى نهاية الدالة قبل خطوة التحقق الأخيرة، والنتيجة أن الاتصال يقبل دون أن يتحقق التوقيع. وقد كتب Mike Bland على موقع Martin Fowler مقالاً مفصلاً بعنوان [Goto Fail, Heartbleed, and Unit Testing Culture](https://martinfowler.com/articles/testing-culture.html?ref=arabroot.io) يبين فيه اختبار وحدة صغيراً يستدعي هذه الدالة بتوقيع خاطئ ويتوقع الرفض، ويوضح أن هذا الاختبار كان سيفشل فور إضافة السطر المكرر، ويناقش كيف أن الكود الذي لا يكتب بحيث يمكن اختباره كوحدة هو الذي يسمح لمثل هذه الأخطاء بالبقاء. والدرس العملي هنا قريب من تجربتنا: الحالات السلبية، مثل البطاقة المرفوضة والتوقيع الخاطئ والكوبون خارج المدى، هي التي تحمي، والكود الذي يسير في طريق النجاح فقط لا يكتشف شيئاً.

## تجربة عملية Lab: خدمة تجديد الاشتراكات

في هذه التجربة نكتب كود خدمة التجديد كما وصفناه، وفيه ثلاثة أخطاء حقيقية، ثم نكتب له مجموعتين من الاختبارات: الأولى كما يكتبها كثيرون، أي كل اعتماد Mock والتحقق من الاستدعاءات، والثانية مبنية على السلوك مع Fakes وساعة حقيقية وجداول حالات. ثم نصلح الأخطاء، ونعيد هيكلة الكود دون تغيير سلوكه، ونشغل الاختبارات بترتيب عشوائي. وكل الأوامر تعمل داخل Container فيه Python 3.13.18 وpytest 9.2.0، وملفات التجربة كاملة في مجلد `lab` مع المقال.

### التجهيز Setup

نبني Image صغيرة فيها pytest وإضافتان، الأولى pytest-randomly للترتيب العشوائي، والثانية pytest-cov للتغطية، والإصدارات كلها مثبتة حتى تحصل على النتائج نفسها:

```dockerfile
FROM python:3.13.18-slim
RUN pip install --no-cache-dir pytest==9.2.0 pytest-randomly==5.0.0 pytest-cov==7.1.0
WORKDIR /lab
```

```bash
docker build -t dv2o-unit:lab .
docker run --rm -v "$PWD:/lab" dv2o-unit:lab pytest -p no:randomly -v tests/test_mocky.py
```

وعند أول تشغيل لم يجد pytest الكود أصلاً، والمخرج كان كما يلي:

```text
ImportError while importing test module '/lab/tests/test_mocky.py'.
Hint: make sure your test modules/packages have valid Python names.
...
tests/test_mocky.py:6: in <module>
    from app.billing import add_months, invoice_amounts
E   ModuleNotFoundError: No module named 'app'
=============================== 1 error in 4.81s ===============================
```

والسبب أن pytest لا يضيف مجلد المشروع إلى مسار الاستيراد تلقائياً في كل الحالات، فالمجلد `app` موجود بجانب `tests` ولكن Python لا يبحث فيه. والحل الصحيح ليس تعديل `sys.path` داخل كل ملف اختبار، وإنما سطر واحد في إعداد pytest يخبره أين يبحث:

```toml
[tool.pytest.ini_options]
pythonpath = ["."]
testpaths = ["tests"]
```

ولاحظ الخيار `-p no:randomly` في الأمر، فهو يوقف الترتيب العشوائي في هذه المرحلة حتى تكون المخرجات ثابتة، وسوف نعيده في نهاية التجربة.

### الكود الأول وأخطاؤه Version 1

ملف الحسابات فيه السعر والضريبة وحساب تاريخ التجديد، والخطأ فيه أن «بعد شهر» تعني 30 يوماً:

```python
"""Prices, VAT and renewal dates for the subscription service (pure functions, no I/O)."""
from datetime import date, timedelta
from decimal import Decimal, ROUND_HALF_UP

VAT_RATE = Decimal("0.15")
PLANS = {
    "monthly": {"months": 1, "price": Decimal("99.00")},
    "yearly": {"months": 12, "price": Decimal("990.00")},
}

def money(x: Decimal) -> Decimal:
    return x.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)

def invoice_amounts(plan: str, coupon_percent: int = 0):
    """Return (subtotal, vat, total) for one renewal."""
    if not 0 <= coupon_percent <= 100:
        raise ValueError(f"coupon must be 0..100, got {coupon_percent}")
    price = PLANS[plan]["price"]
    subtotal = money(price * (100 - coupon_percent) / 100)
    vat = money(subtotal * VAT_RATE)
    return subtotal, vat, subtotal + vat

def add_months(d: date, months: int) -> date:
    return d + timedelta(days=30 * months)
```

وملف بوابة الدفع فيه الكلاس الذي يغلف المزود، ولاحظ أن النتيجة فيها حقلان فقط: `ok` و`code`:

```python
"""The payment gateway client. In production charge() calls the provider's HTTPS API."""
from dataclasses import dataclass
from decimal import Decimal

@dataclass(frozen=True)
class ChargeResult:
    ok: bool
    code: str          # "approved", "insufficient_funds", "card_expired", ...

class PaymentGateway:
    def __init__(self, base_url: str, api_key: str):
        self.base_url, self.api_key = base_url, api_key

    def charge(self, subscription_id: str, amount: Decimal) -> ChargeResult:
        raise NotImplementedError("calls the provider over HTTPS")
```

وخدمة التجديد فيها خطآن: تأخذ التاريخ من اللحظة بتوقيت UTC، وتقرأ الحقل `result.approved` الذي لا يوجد في `ChargeResult`:

```python
"""Nightly job: charge every subscription that ends today and move its period forward."""
from dataclasses import dataclass
from datetime import date

from app.billing import PLANS, add_months, invoice_amounts

@dataclass
class Subscription:
    id: str
    email: str
    plan: str
    period_end: date
    status: str = "active"
    coupon: int = 0

class RenewalService:
    def __init__(self, subscriptions, gateway, mailer, clock):
        self.subs, self.gateway, self.mailer, self.clock = subscriptions, gateway, mailer, clock

    def run(self):
        today = self.clock().date()
        renewed, failed = [], []
        for sub in self.subs.find_due(today):
            _, _, total = invoice_amounts(sub.plan, sub.coupon)
            result = self.gateway.charge(sub.id, total)
            if result.approved:
                sub.period_end = add_months(sub.period_end, PLANS[sub.plan]["months"])
                self.subs.save(sub)
                self.mailer.send(sub.email, "receipt", total)
                renewed.append(sub.id)
            else:
                sub.status = "past_due"
                self.subs.save(sub)
                self.mailer.send(sub.email, "payment_failed", total)
                failed.append(sub.id)
        return renewed, failed
```

### المجموعة الأولى: كل شيء Mock

هذه المجموعة تمثل أسلوباً شائعاً: كل اعتماد Mock، والساعة Mock ترجع التاريخ مباشرة، والتحقق من الاستدعاءات بمعاملاتها:

```python
"""The first suite the team wrote: every collaborator is a Mock, and the tests check the calls."""
from datetime import date
from decimal import Decimal
from unittest.mock import Mock

from app.billing import add_months, invoice_amounts
from app.renewals import RenewalService, Subscription

def make_service(subs_due, approved=True):
    subs = Mock()
    subs.find_due.return_value = subs_due
    gateway = Mock()
    gateway.charge.return_value.approved = approved
    mailer = Mock()
    clock = Mock()
    clock.return_value.date.return_value = date(2026, 3, 2)
    return RenewalService(subs, gateway, mailer, clock), subs, gateway, mailer

def test_monthly_price_with_vat():
    assert invoice_amounts("monthly") == (Decimal("99.00"), Decimal("14.85"), Decimal("113.85"))

def test_add_one_month():
    assert add_months(date(2026, 4, 1), 1) == date(2026, 5, 1)

def test_looks_up_due_subscriptions_for_today():
    service, subs, _, _ = make_service([])
    service.run()
    subs.find_due.assert_called_once_with(date(2026, 3, 2))

def test_charges_the_total_with_vat():
    sub = Subscription("s1", "a@example.com", "monthly", date(2026, 3, 2))
    service, _, gateway, _ = make_service([sub])
    service.run()
    gateway.charge.assert_called_once_with("s1", Decimal("113.85"))

def test_saves_once_and_sends_receipt():
    sub = Subscription("s1", "a@example.com", "monthly", date(2026, 3, 2))
    service, subs, _, mailer = make_service([sub])
    service.run()
    subs.save.assert_called_once_with(sub)
    mailer.send.assert_called_once_with("a@example.com", "receipt", Decimal("113.85"))

def test_declined_card_sends_failure_email():
    sub = Subscription("s1", "a@example.com", "monthly", date(2026, 3, 2))
    service, subs, _, mailer = make_service([sub], approved=False)
    service.run()
    subs.save.assert_called_once_with(sub)
    mailer.send.assert_called_once_with("a@example.com", "payment_failed", Decimal("113.85"))
```

```text
tests/test_mocky.py::test_monthly_price_with_vat PASSED                  [ 16%]
tests/test_mocky.py::test_add_one_month PASSED                           [ 33%]
tests/test_mocky.py::test_looks_up_due_subscriptions_for_today PASSED    [ 50%]
tests/test_mocky.py::test_charges_the_total_with_vat PASSED              [ 66%]
tests/test_mocky.py::test_saves_once_and_sends_receipt PASSED            [ 83%]
tests/test_mocky.py::test_declined_card_sends_failure_email PASSED       [100%]

============================== 6 passed in 3.28s ===============================
```

ستة اختبارات خضراء، ومع `--cov=app --cov-report=term-missing` كانت التغطية كما يلي:

```text
Name              Stmts   Miss  Cover   Missing
-----------------------------------------------
app/__init__.py       0      0   100%
app/billing.py       15      1    93%   19
app/gateway.py       11     11     0%   2-17
app/renewals.py      30      0   100%
-----------------------------------------------
TOTAL                56     12    79%
6 passed in 2.37s
```

في المخرج أعلاه لاحظ التالي:

- الخدمة كلها مغطاة 100%، أي أن كل سطر فيها نفذ، بما في ذلك السطر الذي يقرأ `result.approved`.
- السطر 19 في الحسابات هو رفض الكوبون خارج المدى، ولم يختبره أحد، وهذه المعلومة الوحيدة المفيدة التي أعطتنا إياها التغطية.
- ملف البوابة 0% لأن كل الاختبارات استخدمت Mock بدلاً منه، فلم يعرف أي اختبار أن الحقل اسمه `ok`.

### المجموعة الثانية: ساعة حقيقية مع Fakes

البدائل في المجموعة الثانية نسخ صغيرة تعمل فعلاً: مستودع في الذاكرة يبحث ويحفظ، وبوابة ترجع `ChargeResult` حقيقياً وترفض البطاقات التي نحددها، وصندوق بريد يحفظ الرسائل:

```python
"""Fakes: small working versions of the collaborators. They keep state we can look at after the run."""
from app.gateway import ChargeResult

class InMemorySubscriptions:
    def __init__(self, *subs):
        self.rows = {s.id: s for s in subs}

    def find_due(self, day):
        return [s for s in self.rows.values() if s.status == "active" and s.period_end == day]

    def save(self, sub):
        self.rows[sub.id] = sub

    def save_all(self, subs):
        for s in subs:
            self.save(s)

class FakeGateway:
    """Answers like the real client: a ChargeResult. Cards listed in `declined` are refused."""
    def __init__(self, declined=()):
        self.declined, self.charges = set(declined), []

    def charge(self, subscription_id, amount):
        self.charges.append((subscription_id, amount))
        if subscription_id in self.declined:
            return ChargeResult(ok=False, code="insufficient_funds")
        return ChargeResult(ok=True, code="approved")

class OutboxMailer:
    def __init__(self):
        self.sent = []

    def send(self, to, template, amount):
        self.sent.append((to, template, amount))
```

واختبارات الحسابات جدولا حالات، الأول للمبلغ مع الضريبة والكوبون، والثاني لتاريخ التجديد، وكل سطر فيهما حالة حدية مقصودة:

```python
from datetime import date
from decimal import Decimal

import pytest

from app.billing import add_months, invoice_amounts

@pytest.mark.parametrize("plan, coupon, expected", [
    ("monthly", 0,   ("99.00", "14.85", "113.85")),
    ("monthly", 10,  ("89.10", "13.37", "102.47")),   # 13.365 rounds half up
    ("monthly", 100, ("0.00", "0.00", "0.00")),
    ("yearly", 0,    ("990.00", "148.50", "1138.50")),
    ("yearly", 33,   ("663.30", "99.50", "762.80")),
], ids=["monthly", "monthly-10%", "monthly-free", "yearly", "yearly-33%"])
def test_invoice_amounts(plan, coupon, expected):
    assert invoice_amounts(plan, coupon) == tuple(Decimal(x) for x in expected)

@pytest.mark.parametrize("coupon", [-1, 101])
def test_coupon_outside_0_to_100_is_rejected(coupon):
    with pytest.raises(ValueError, match="coupon"):
        invoice_amounts("monthly", coupon)

@pytest.mark.parametrize("start, months, expected", [
    (date(2026, 4, 1), 1, date(2026, 5, 1)),
    (date(2026, 3, 10), 1, date(2026, 4, 10)),
    (date(2026, 1, 31), 1, date(2026, 2, 28)),     # short month: last day
    (date(2028, 1, 31), 1, date(2028, 2, 29)),     # leap year
    (date(2026, 12, 15), 1, date(2027, 1, 15)),    # year boundary
    (date(2028, 2, 29), 12, date(2029, 2, 28)),    # yearly plan from 29 Feb
    (date(2026, 5, 31), 12, date(2027, 5, 31)),
], ids=["apr-1", "mar-10", "jan-31", "leap-jan-31", "dec-15", "leap-day-yearly", "may-31-yearly"])
def test_add_months(start, months, expected):
    assert add_months(start, months) == expected
```

واختبارات الخدمة تثبت الساعة على لحظة بتوقيت UTC كما تعطيها ساعة السيرفر، وتتحقق من الحالة بعد التشغيل:

```python
from datetime import date, datetime, timezone
from decimal import Decimal

from app.renewals import RenewalService, Subscription
from tests.fakes import FakeGateway, InMemorySubscriptions, OutboxMailer

def at(*args):
    """A clock frozen at a UTC moment, the way the server's clock reports it."""
    moment = datetime(*args, tzinfo=timezone.utc)
    return lambda: moment

def run(subs, gateway=None, clock=at(2026, 3, 2, 9, 0)):
    gateway, mailer = gateway or FakeGateway(), OutboxMailer()
    result = RenewalService(subs, gateway, mailer, clock).run()
    return result, gateway, mailer

def test_due_subscription_is_charged_and_moved_one_month():
    subs = InMemorySubscriptions(Subscription("s1", "a@example.com", "monthly", date(2026, 3, 2)))
    (renewed, failed), gateway, mailer = run(subs)
    assert (renewed, failed) == (["s1"], [])
    assert gateway.charges == [("s1", Decimal("113.85"))]
    assert subs.rows["s1"].period_end == date(2026, 4, 2)
    assert mailer.sent == [("a@example.com", "receipt", Decimal("113.85"))]

def test_declined_card_marks_past_due_and_keeps_the_period():
    subs = InMemorySubscriptions(Subscription("s1", "a@example.com", "monthly", date(2026, 3, 2)))
    (renewed, failed), _, mailer = run(subs, FakeGateway(declined={"s1"}))
    assert (renewed, failed) == ([], ["s1"])
    assert subs.rows["s1"].status == "past_due"
    assert subs.rows["s1"].period_end == date(2026, 3, 2)
    assert mailer.sent[0][1] == "payment_failed"

def test_subscription_not_due_is_left_alone():
    subs = InMemorySubscriptions(Subscription("s1", "a@example.com", "monthly", date(2026, 3, 3)))
    (renewed, failed), gateway, mailer = run(subs)
    assert (renewed, failed, gateway.charges, mailer.sent) == ([], [], [], [])

def test_job_after_midnight_saudi_time_renews_that_day():
    # 00:30 on 2 March in Saudi Arabia (UTC+3) is 21:30 on 1 March in UTC
    subs = InMemorySubscriptions(Subscription("s1", "a@example.com", "monthly", date(2026, 3, 2)))
    (renewed, _), _, _ = run(subs, clock=at(2026, 3, 1, 21, 30))
    assert renewed == ["s1"]

def test_month_end_customer_keeps_month_end_renewals():
    sub = Subscription("s1", "a@example.com", "monthly", date(2026, 1, 31))
    subs = InMemorySubscriptions(sub)
    ends = []
    for day in (date(2026, 1, 31), date(2026, 2, 28), date(2026, 3, 31)):
        run(subs, clock=at(day.year, day.month, day.day, 9, 0))
        ends.append(subs.rows["s1"].period_end)
    assert ends == [date(2026, 2, 28), date(2026, 3, 31), date(2026, 4, 30)]
```

```bash
docker run --rm -v "$PWD:/lab" dv2o-unit:lab pytest -p no:randomly -q -rf tests/test_billing.py tests/test_renewals.py
```

والمخرج سوف يكون كما يلي:

```text
=========================== short test summary info ============================
FAILED tests/test_billing.py::test_add_months[mar-10] - assert datetime.date(...
FAILED tests/test_billing.py::test_add_months[jan-31] - assert datetime.date(...
FAILED tests/test_billing.py::test_add_months[leap-jan-31] - assert datetime....
FAILED tests/test_billing.py::test_add_months[dec-15] - assert datetime.date(...
FAILED tests/test_billing.py::test_add_months[leap-day-yearly] - assert datet...
FAILED tests/test_billing.py::test_add_months[may-31-yearly] - assert datetim...
FAILED tests/test_renewals.py::test_due_subscription_is_charged_and_moved_one_month
FAILED tests/test_renewals.py::test_declined_card_marks_past_due_and_keeps_the_period
FAILED tests/test_renewals.py::test_job_after_midnight_saudi_time_renews_that_day
FAILED tests/test_renewals.py::test_month_end_customer_keeps_month_end_renewals
10 failed, 9 passed in 0.56s
```

عشرة اختبارات فشلت على الكود نفسه الذي نجحت عليه المجموعة الأولى كلها، ولنقرأ رسائل الفشل المهمة واحدة واحدة. أولاً ستة أسطر من جدول التواريخ فشلت، والسطر الوحيد الذي نجح هو `apr-1`، أي الحالة نفسها التي اختارتها المجموعة الأولى. وتفاصيل اثنين منها:

```text
E       assert datetime.date(2026, 3, 2) == datetime.date(2026, 2, 28)
E        +  where datetime.date(2026, 3, 2) = add_months(datetime.date(2026, 1, 31), 1)
E       assert datetime.date(2029, 2, 23) == datetime.date(2029, 2, 28)
E        +  where datetime.date(2029, 2, 23) = add_months(datetime.date(2028, 2, 29), 12)
```

وهنا يظهر سبب البلاغ في بداية المقال: العميل الذي ينتهي اشتراكه في 31 يناير يجدد في 2 مارس، والعميل السنوي يخسر خمسة أيام كل سنة. وثانياً فشل اختبار التجديد العادي برسالة واضحة جداً:

```text
>           if result.approved:
               ^^^^^^^^^^^^^^^
E           AttributeError: 'ChargeResult' object has no attribute 'approved'

app/renewals.py:28: AttributeError
```

وهذا هو الخطأ الذي كان سيظهر في الإنتاج عند أول اشتراك مستحق، أي أن مهمة التجديد كانت ستتوقف كاملة في أول ليلة، ولم تره المجموعة الأولى لأن ال Mock وافق على حقل غير موجود.

### الإصلاحات Fixes: من يفشل بعدها؟

نصلح الأخطاء واحداً واحداً ونشغل المجموعتين معاً بعد كل إصلاح. الإصلاح الأول هو اسم الحقل، أي `if result.ok:`، وبعده بقيت أخطاء التواريخ كما هي، ولكن ظهر فشل جديد في المكان الذي لا تتوقعه:

```text
FAILED tests/test_mocky.py::test_declined_card_sends_failure_email - Assertio...
...
10 failed, 15 passed in 2.67s
```

```text
E           AssertionError: expected call not found.
E           Expected: send('a@example.com', 'payment_failed', Decimal('113.85'))
E             Actual: send('a@example.com', 'receipt', Decimal('113.85'))
```

اختبار البطاقة المرفوضة في المجموعة الأولى فشل على الكود الصحيح، والسبب أنه برمج ال Mock بالحقل الخاطئ `approved = False`، فلما أصبح الكود يقرأ `ok` وجد Mock جديداً قيمته True، فاعتبر البطاقة مقبولة وأرسل إيصالاً. أي أن هذه المجموعة لم تكتف بأنها لم تكشف الخطأ، وإنما كانت تحميه وتفشل عند إصلاحه.

والإصلاح الثاني هو حساب الشهر الصحيح: نفس اليوم في الشهر المطلوب، أو آخر يوم فيه إذا لم يوجد هذا اليوم، باستخدام `calendar.monthrange` التي تعطي عدد أيام الشهر:

```python
def add_months(d: date, months: int) -> date:
    """Same day N months later; the last day of the month when that day does not exist."""
    index = d.month - 1 + months
    year, month = d.year + index // 12, index % 12 + 1
    last = calendar.monthrange(year, month)[1]
    return date(year, month, min(d.day, last))
```

```text
FAILED tests/test_mocky.py::test_declined_card_sends_failure_email - Assertio...
FAILED tests/test_renewals.py::test_job_after_midnight_saudi_time_renews_that_day
FAILED tests/test_renewals.py::test_month_end_customer_keeps_month_end_renewals
3 failed, 22 passed in 1.34s
```

نجح جدول التواريخ كاملاً، وبقي اختبار منتصف الليل لأننا لم نصلح التوقيت بعد، وبقي اختبار التجديدات المتتالية، وهذا الأخير يستحق قسماً خاصاً به.

### مشكلة ظهرت بعد الإصلاح: اليوم 31 يضيع Anchor Day

رسالة الفشل كانت كما يلي:

```text
E       assert [datetime.dat...(2026, 3, 28)] == [datetime.dat...(2026, 4, 30)]
E
E         At index 1 diff: datetime.date(2026, 3, 28) != datetime.date(2026, 3, 31)
```

التجديد الأول أعطى 28 فبراير وهو صحيح، ولكن التجديد الثاني حسب من 28 فبراير فأعطى 28 مارس بدلاً من 31 مارس، ثم لم يجد الاختبار في 31 مارس اشتراكاً مستحقاً لأنه جدد قبل ثلاثة أيام. وكل اختبار في جدول التواريخ كان صحيحاً وناجحاً، لأن كل سطر فيه يختبر خطوة واحدة، والخطأ لا يظهر إلا من تتابع خطوتين، وهذا سبب أن الجدول وحده لا يكفي، وأن اختبار السلوك على عدة دورات له مكانه. والحل أن نحفظ مع الاشتراك اليوم الذي بدأ فيه العميل، ونمرره إلى `add_months`، ومعه إصلاح التوقيت في السطر نفسه الذي يأخذ التاريخ:

```python
"""Nightly job: charge every subscription that ends today and move its period forward."""
from dataclasses import dataclass
from datetime import date, timedelta, timezone

from app.billing import PLANS, add_months, invoice_amounts

SAUDI_TIME = timezone(timedelta(hours=3))   # UTC+3 all year, no daylight saving

@dataclass
class Subscription:
    id: str
    email: str
    plan: str
    period_end: date
    status: str = "active"
    coupon: int = 0
    anchor_day: int = 0      # the day of month the customer first subscribed on

    def __post_init__(self):
        self.anchor_day = self.anchor_day or self.period_end.day

class RenewalService:
    def __init__(self, subscriptions, gateway, mailer, clock):
        self.subs, self.gateway, self.mailer, self.clock = subscriptions, gateway, mailer, clock

    def run(self):
        today = self.clock().astimezone(SAUDI_TIME).date()
        renewed, failed = [], []
        for sub in self.subs.find_due(today):
            _, _, total = invoice_amounts(sub.plan, sub.coupon)
            result = self.gateway.charge(sub.id, total)
            if result.ok:
                sub.period_end = add_months(sub.period_end, PLANS[sub.plan]["months"], day=sub.anchor_day)
                self.subs.save(sub)
                self.mailer.send(sub.email, "receipt", total)
                renewed.append(sub.id)
            else:
                sub.status = "past_due"
                self.subs.save(sub)
                self.mailer.send(sub.email, "payment_failed", total)
                failed.append(sub.id)
        return renewed, failed
```

ومع إضافة المعامل `day` إلى `add_months` أصبحت النتيجة كما يلي:

```text
=========================== short test summary info ============================
FAILED tests/test_mocky.py::test_looks_up_due_subscriptions_for_today - Asser...
FAILED tests/test_mocky.py::test_declined_card_sends_failure_email - Assertio...
2 failed, 23 passed in 1.15s
```

كل اختبارات المجموعة الثانية نجحت، والذي فشل اختباران من المجموعة الأولى على كود صحيح، والأول منهما رسالته كما يلي:

```text
E           AssertionError: expected call not found.
E           Expected: find_due(datetime.date(2026, 3, 2))
E             Actual: find_due(<Mock name='mock().astimezone().date()' id='139826540502656'>)
```

والسبب أن الساعة في المجموعة الأولى Mock يعرف فقط أن الكود سوف يستدعي `date()` مباشرة، فلما أضفنا `astimezone` قبلها رجع Mock جديداً لا علاقة له بالتاريخ. وهذا مثال واضح على اختبار يعرف تفاصيل الكود من الداخل، فكل تغيير في طريقة الوصول إلى النتيجة يفشله، حتى التغيير الذي يصلح خطأً.

### لماذا لم يلاحظ ال Mock الاسم الخاطئ؟ Autospec

لنرى الفرق بين ال Mock العادي وال Mock الذي يأخذ شكل الكلاس الحقيقي، نشغل الملف الصغير التالي:

```python
from unittest.mock import Mock, create_autospec
from app.gateway import ChargeResult, PaymentGateway

loose = Mock()
print("loose  .approved ->", bool(loose.charge("s1", 1).approved))

strict = create_autospec(PaymentGateway, instance=True)
strict.charge.return_value = ChargeResult(ok=False, code="card_expired")
try:
    strict.charge("s1", 1).approved
except AttributeError as e:
    print("strict .approved ->", e)
try:
    strict.charge("s1")
except TypeError as e:
    print("strict charge('s1') ->", e)
```

```text
loose  .approved -> True
strict .approved -> 'ChargeResult' object has no attribute 'approved'
strict charge('s1') -> missing a required argument: 'amount'
```

في المخرج أعلاه لاحظ التالي:

- ال Mock العادي أعطى True لحقل غير موجود، وهذا بالضبط ما جعل المجموعة الأولى تنجح على الكود الخاطئ.
- ال Mock الذي أنشأناه بالدالة `create_autospec` رفض الاستدعاء بمعامل ناقص، لأنه يعرف توقيع `charge` الحقيقي.
- عندما أرجع البديل قيمة حقيقية من نوع `ChargeResult` ظهر `AttributeError` نفسه الذي كان سيظهر في الإنتاج.

### إعادة الهيكلة Refactoring: من يفشل؟

الآن نعيد هيكلة الخدمة دون أن نغير سلوكها، فنجمع الحفظ في استدعاء واحد `save_all` بدلاً من حفظ كل اشتراك وحده، وننقل منطق الاشتراك الواحد إلى دالة خاصة، ونستدعي البريد بمعاملات مسماة:

```python
class RenewalService:
    def __init__(self, subscriptions, gateway, mailer, clock):
        self.subs, self.gateway, self.mailer, self.clock = subscriptions, gateway, mailer, clock

    def run(self):
        today = self.clock().astimezone(SAUDI_TIME).date()
        due = self.subs.find_due(today)
        outcomes = [(sub, self._renew(sub)) for sub in due]
        self.subs.save_all(due)                      # one write instead of one per subscription
        return ([s.id for s, ok in outcomes if ok], [s.id for s, ok in outcomes if not ok])

    def _renew(self, sub):
        _, _, total = invoice_amounts(sub.plan, sub.coupon)
        ok = self.gateway.charge(sub.id, total).ok
        if ok:
            sub.period_end = add_months(sub.period_end, PLANS[sub.plan]["months"], day=sub.anchor_day)
        else:
            sub.status = "past_due"
        self.mailer.send(to=sub.email, template="receipt" if ok else "payment_failed", amount=total)
        return ok
```

```text
FAILED tests/test_mocky.py::test_looks_up_due_subscriptions_for_today - Asser...
FAILED tests/test_mocky.py::test_saves_once_and_sends_receipt - AssertionErro...
FAILED tests/test_mocky.py::test_declined_card_sends_failure_email - Assertio...
3 failed, 22 passed in 3.36s
```

المجموعة الثانية كلها نجحت لأن الحالة النهائية لم تتغير: نفس الاشتراكات جددت، ونفس المبالغ خصمت، ونفس الرسائل وصلت. أما المجموعة الأولى فنصف اختباراتها التي تتعامل مع الخدمة فشلت، ولا يوجد خطأ واحد في الكود. وإذا نظرت إلى ما مر في التجربة كله تجد أن المجموعة الأولى نجحت على كود فيه ثلاثة أخطاء، ثم فشلت مع إصلاح خطأين منها، ثم فشلت مع إعادة الهيكلة، أي أنها كانت تعطي الإشارة المعاكسة في كل مرة. وفي هذه المرحلة نقلنا ملفها إلى مجلد `old-tests`، لأن إصلاحها يعني إعادة كتابتها بالأسلوب الثاني.

### ماذا لو تغير ترتيب الاختبارات؟ What If

نضيف إلى آخر ملف اختبارات الخدمة اختباراً لسعر عرض شهري يغير القاموس المشترك `PLANS` ولا يعيده:

```python
def test_promo_month_price():
    from app.billing import PLANS, invoice_amounts
    PLANS["monthly"]["price"] = Decimal("79.00")          # shared module state, never restored
    assert invoice_amounts("monthly") == (Decimal("79.00"), Decimal("11.85"), Decimal("90.85"))
```

بالترتيب الافتراضي تنجح المجموعة كاملة `20 passed`، لأن هذا الاختبار هو الأخير. ثم نشغلها بثماني بذور مختلفة للترتيب العشوائي:

```bash
for seed in 1 2 3 4 5 6 7 8; do
  echo "seed $seed: $(docker run --rm -v "$PWD:/lab" dv2o-unit:lab pytest -q --randomly-seed=$seed tests/ | tail -1)"
done
```

```text
seed 1: 20 passed in 1.25s
seed 2: 20 passed in 0.84s
seed 3: 20 passed in 0.44s
seed 4: 20 passed in 1.29s
seed 5: 20 passed in 0.80s
seed 6: 20 passed in 2.50s
seed 7: 1 failed, 19 passed in 4.95s
seed 8: 2 failed, 18 passed in 3.55s
```

ست بذور نجحت واثنتان فشلتا، وهذا شكل الاختبار المتقلب في خط CI تماماً: يفشل مرة من أربع تقريباً، وعند إعادة التشغيل ينجح، فيعتاد الفريق على إعادة التشغيل. وفي البذرة 8 كانت الرسالة:

```text
E       AssertionError: assert (Decimal('79....imal('90.85')) == (Decimal('99....mal('113.85'))
E         At index 0 diff: Decimal('79.00') != Decimal('99.00')
FAILED tests/test_billing.py::test_invoice_amounts[monthly] - AssertionError:...
FAILED tests/test_billing.py::test_invoice_amounts[monthly-10%] - AssertionEr...
```

ولاحظ أن الاختبارين اللذين فشلا ليس فيهما أي خطأ، فالخطأ في اختبار آخر في ملف آخر جاء قبلهما في هذا الترتيب، وهذا ما يجعل هذا النوع صعب التتبع إذا لم تعرف البذرة. والإصلاح سطر واحد يجعل pytest يعيد القيمة الأصلية بعد الاختبار:

```python
def test_promo_month_price(monkeypatch):
    from app.billing import PLANS, invoice_amounts
    monkeypatch.setitem(PLANS["monthly"], "price", Decimal("79.00"))   # restored after the test
```

```text
seed 1: 20 passed in 0.92s
seed 2: 20 passed in 0.61s
seed 3: 20 passed in 0.90s
seed 4: 20 passed in 0.59s
seed 5: 20 passed in 0.52s
seed 6: 20 passed in 1.40s
seed 7: 20 passed in 0.41s
seed 8: 20 passed in 0.38s
```

وأخيراً شغلنا المجموعة مع التغطية وأبطأ ثلاثة اختبارات:

```text
Name              Stmts   Miss  Cover
-------------------------------------
app/__init__.py       0      0   100%
app/billing.py       19      0   100%
app/gateway.py       11      2    82%
app/renewals.py      32      0   100%
-------------------------------------
TOTAL                62      2    97%
============================= slowest 3 durations ==============================
0.01s setup    tests/test_renewals.py::test_subscription_not_due_is_left_alone
0.01s call     tests/test_renewals.py::test_subscription_not_due_is_left_alone
20 passed in 1.43s
```

والسطران غير المغطيين في ملف البوابة هما تهيئة الكلاس الحقيقي واستدعاء المزود، ومكانهما اختبار تكامل أمام بيئة الاختبار عند المزود كما ذكرنا.

### النتائج في جدول Results

| المرحلة                            | مجموعة ال Mocks (6) | مجموعة السلوك  | الحالة الحقيقية للكود        |
| ---------------------------------- | ------------------- | -------------- | ---------------------------- |
| الكود الأول بثلاثة أخطاء           | 6 نجحت              | 10 فشلت من 19  | فيه ثلاثة أخطاء              |
| بعد إصلاح اسم الحقل                | 1 فشل               | 9 فشلت         | خطآن                         |
| بعد إصلاح حساب الشهر               | 1 فشل               | 2 فشلا         | خطأ التوقيت والانزلاق إلى 28 |
| بعد إصلاح التوقيت ويوم الاشتراك    | 2 فشلا              | كلها نجحت      | صحيح                         |
| بعد إعادة الهيكلة                  | 3 فشلت              | كلها نجحت      | صحيح                         |
| اختبار يغير حالة مشتركة، 8 ترتيبات | غير مستخدمة         | فشل في ترتيبين | صحيح، والخطأ في الاختبار     |

والصورة التالية تلخص الجدول:

![مخطط مراحل التجربة الخمس، ولكل مرحلة حالة الكود وعدد الاختبارات الفاشلة في المجموعتين: مجموعة ال Mocks خضراء على الكود الخاطئ وحمراء على الكود الصحيح، ومجموعة السلوك حمراء حين يوجد خطأ وخضراء حين لا يوجد](https://arabroot.io/content/images/2026/11/unit-testing-06-lab-results.webp)

الاختبار المفيد يفشل حين يوجد خطأ وينجح حين لا يوجد، ومجموعة ال Mocks أعطت العكس في كل مرحلة

### التنظيف Cleanup

```bash
docker rmi dv2o-unit:lab python:3.13.18-slim
rm -rf .pytest_cache tests/__pycache__ app/__pycache__
```

## أخطاء شائعة Common Mistakes

- **Mock لكل اعتماد بشكل تلقائي:** كل Mock افتراض عن طرف آخر، واستخدم الكلاس الحقيقي إذا كان سريعاً وثابت النتيجة، ثم Fake، واترك ال Mock للآثار الجانبية الخارجية.
- **التحقق من دوال القراءة:** مثل `find_due.assert_called_once_with(...)`، فهذا لا يحمي شيئاً ويفشل مع أي تغيير في طريقة الوصول إلى البيانات، كما فشل مع إصلاح التوقيت.
- **Mock دون شكل:** `Mock()` العادي يقبل أي اسم، فاستخدم `create_autospec` أو أرجع قيماً حقيقية من البدائل.
- **ساعة بديلة ترجع النتيجة بدلاً من اللحظة:** ثبت اللحظة الكاملة بمنطقتها الزمنية، ودع الكود يحول بنفسه، وإلا تجاوز الاختبار مكان الخطأ.
- **اختيار مثال سهل للتواريخ:** 1 أبريل يعطي النتيجة الصحيحة لأي حساب تقريباً، والأمثلة التي تكشف هي 31 يناير و29 فبراير وآخر السنة.
- **اختبار خطوة واحدة فقط من سلوك متكرر:** الانزلاق إلى يوم 28 لم يظهر إلا من تجديدين متتاليين.
- **نسخ مخرج الكود كقيمة متوقعة:** إذا شغلت الدالة ونسخت ما أعطته إلى الاختبار فأنت تختبر أن الخطأ ما زال موجوداً، والقيمة المتوقعة تأتي من المتطلب أو من حساب يدوي.
- **حالة مشتركة لا تعاد:** كل تعديل على متغير عام أو بيئة أو ملف في الاختبار يعاد بعده، عبر `monkeypatch` أو ما يقابلها، وشغل الاختبارات بترتيب عشوائي دائماً.
- **اختبارات الطريق السعيد فقط:** البطاقة المرفوضة والكوبون خارج المدى والتوقيع الخاطئ هي الحالات التي تحمي، كما يبين مثال goto fail.

## قائمة تحقق Checklist

- كل اختبار يصف سلوكاً واحداً باسم يقرأ كمتطلب، ويتبع الترتيب ثم التنفيذ ثم التحقق.
- الاختبارات تستدعي الواجهة العامة فقط، والمنطق المعقد مستخرج في دوال عامة صغيرة لها اختباراتها.
- الحسابات المالية والتواريخ لها جداول حالات فيها الحدود: صفر، والحد، وما بعده، وآخر الشهر، و29 فبراير، وآخر السنة.
- الساعة والعشوائية ومولد المعرفات تمرر كمعاملات، والبدائل ترجع قيماً حقيقية.
- التاريخ يؤخذ بتوقيت العمل، وهناك اختبار في الساعات بين 21:00 و24:00 بتوقيت UTC.
- البدائل Fakes لها اختبارات عقد تعمل عليها وعلى الطرف الحقيقي.
- ال Mocks للآثار الجانبية الخارجية فقط، ومع `autospec`.
- الاختبارات تعمل بترتيب عشوائي، والبذرة تظهر في سجل خط CI.
- المجموعة كاملة تعمل في ثوان، وأبطأ الاختبارات مراقب بالخيار `--durations`.
- التغطية تستخدم لإيجاد كود غير مختبر، وليس كحد يثبت قوة الاختبارات.

## الخلاصة Summary

وصلنا لنهاية الموضوع، وأهم ما فيه:

- الوحدة سلوك يفهمه صاحب المنتج، والاختبار يستبدل فقط ما هو بطيء أو خارجي أو غير ثابت، ويترك الباقي حقيقياً.
- تحقق من الحالة بعد التنفيذ، وليس من الاستدعاءات في الطريق، فاختبارات الاستدعاءات في التجربة نجحت على ثلاثة أخطاء وفشلت على إصلاحين وإعادة هيكلة.
- ال Mock العادي يقبل أي واجهة تتخيلها، فاجعل البدائل ترجع قيماً حقيقية أو استخدم `autospec`.
- الوقت اعتماد مثل قاعدة البيانات، فاحقنه، وثبت اللحظة الكاملة، واختبر منتصف الليل بتوقيت السعودية وآخر الشهر و29 فبراير، فسطر واحد في حساب السنة أوقف أجزاء من Azure في 2012.
- الاختبار الذي يعتمد على ترتيب الاختبارات ينجح أغلب الوقت ويفشل أحياناً، والترتيب العشوائي مع البذرة يكشفه مبكراً.
- التغطية 100% على الخدمة لم تمنع الأخطاء الثلاثة، فهي تخبرك بما لم يختبر وليس بقوة ما اختبر.

وبعد أن تكتب اختبارات وحدة تثق بها، فالخطوة التالية هي أن تعمل في خط CI مع كل طلب دمج، وقد شرحنا الفكرة في [مفهوم CI/CD للمبتدئين](https://arabroot.io/articles/%D9%85%D9%81%D9%87%D9%88%D9%85-ci-cd-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%85%D9%86-%D9%83%D9%84-push-%D8%A7%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D9%8A%D8%B9%D9%85%D9%84/)، وإذا أردت أن تعرف هل اختباراتك تكشف الأخطاء فعلاً فاقرأ [اختبار الطفرات Mutation Testing](https://arabroot.io/articles/%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%B7%D9%81%D8%B1%D8%A7%D8%AA-mutation-testing/).

[![](https://arabroot.io/content/images/2026/10/testing-types-cover-cover.webp)دليلأنواع الاختبارات للمبتدئين: من Unit إلى E2E مع Playwrightما الذي يكشفه كل نوع من الاختبارات وما الذي يفوته، وكم اختباراً تكتب من كل نوع، وأين يعمل كل منها في خط CI.](https://arabroot.io/articles/%D8%A7%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-unit-%D9%88-integration-%D9%88-e2e/)[![](https://arabroot.io/content/images/2026/10/qa-intro-cover-cover.webp)دليلما هو ضمان الجودة QA وكيف يعمل فريق الاختبار؟كيف تفرق بين QA وQC والاختبار، وتصمم حالات الاختبار Test Cases التي تجد الأخطاء قبل أن يجدها عملاؤك.](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%B6%D9%85%D8%A7%D9%86-%D8%A7%D9%84%D8%AC%D9%88%D8%AF%D8%A9-qa-%D9%88%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-%D9%81%D8%B1%D9%8A%D9%82-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1/)[![](https://arabroot.io/content/images/2026/10/mutation-testing-cover-cover.webp)دليلاختبار الطفرات Mutation Testing: هل تكشف اختباراتك الأخطاء؟لماذا تمر الأخطاء من اختبارات تغطيتها 100%، وكيف يقيس اختبار الطفرات قوتها فعلاً ويعمل في خط CI دون أن يبطئه.](https://arabroot.io/articles/%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%B7%D9%81%D8%B1%D8%A7%D8%AA-mutation-testing/)[![](https://arabroot.io/content/images/2026/10/contract-testing-cover-cover.webp)دليلاختبار العقود Contract Testing بين الخدمات مع Pactكيف تمنع خدمة من تعطيل خدمة أخرى تعتمد عليها قبل النشر، بعقد يكتبه المستهلك ويتحقق منه المزود ويحفظه Pact Broker.](https://arabroot.io/articles/%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%B9%D9%82%D9%88%D8%AF-contract-testing-%D9%85%D8%B9-pact/)

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، وتنفيذ التجربة على Docker Engine 29.8.0 مع Python 3.13.18 (python:3.13.18-slim) وpytest 9.2.0 وpytest-randomly 5.0.0 وpytest-cov 7.1.0.