أفضل الممارسات في اختبارات وحدة الكتابة للمدونة C

كتاب حالات الاختبار الفعالة: دورية أرنج - آكسترت

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

1. Arrange] - Set up the preconditions: initialize variables, allocate memory, set mock expectations, configure global state (if unavoidable), and create input data.
2. Act] - Call the function under test with the arranged inputs.
3. Assert] - التحقق من أن القيمة العائدة، أو الحالة المعدلة، أو التفاعلات الطاغية تضاهي النتائج المتوقعة.

مثال يستخدم الوحدة:

#include "unity.h"
#include "math_utils.h"

void setUp(void) {}
void tearDown(void) {}

void test_add_positive_numbers(void) {
 // Arrange
 int a = 2;
 int b = 3;

 // Act
 int result = add(a, b);

 // Assert
 TEST_ASSERT_EQUAL_INT(5, result);
}

Notice that the test name is descriptive: it immediately tells you what scenario is being tested. Avoid names like or .

الاتفاقيات والتعليقات المتعلقة بالصياغة

ويتبع اسم وظيفة اختبار جيدة نمطاً من قبيل (مثلاً ]) وفي الاختبار، ينبغي أن تكون التعليقات على الحد الأدنى من الرموز وثائق ذاتية، ولكن إذا كان الإنشاء يتطلب تسلسلاً معقداً (مثلاً، وضع قائمة مترابطة مع 000 1 نُقد)، تعليق موجز يوضح سبب اختيار هذا الترتيب الخاص مفيداً.

الاختبارات الهيكلية للعزل

والعزلة هي أصعب جزء من مدونة اختبار الوحدة جيم، لا سيما عندما تنطوي المعالون على متغيرات عالمية أو وظائف ثابتة أو سجلات للمعدات، والهدف هو استبدال المعالين الحقيقيين بازدواجية الاختبار (الطوق، أو المشابك، أو المزيفات).

التقاط وتصفيق في الجرعة جيم

التواصل مع مكتبة متحركة يمكن أن يتم في وقت تجميعها باستخدام خدعة لربطة الوصلة، مثلاً مع (كماك) يمكنك خلق وظيفة متحركة

int __wrap_send_to_hardware(int data) {
 // Record the call and return a predetermined value
 check_expected(data);
 return mock_type(int);
}

ثم عندما تربط الاختبار قابل للتنفيذ، تضيف ] إلى أعلام الرابط، ويستعاض عن الـ الحقيقي بغلفكم أثناء الاختبار، وهذه التقنية مفصلة في مقال عن الوصلة لربط السلاسل باختبارات مزدوجة .

التعامل مع الدولة العالمية

إن الوضع العالمي يهتز، كلما أمكن، يُعيد تكييف رمزك ليعبر عن طريق هياكل السياق، وإذا كان لا يمكن تجنب العولمة، فإنه يستخدم و]] لإنقاذ قيمها وإعادة استعادتها، فبعض الأطر (مثل الشيك) تجري كل اختبار في عملية منفصلة تعزل، ويعلن أنها ترتفع إلى أعلى.

تغطية قضايا إدج ومعالجة الأخطاء

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

قضايا مشتركة تتعلق بالإنجازات

• Null pointers ] – هل تحطمت الوظيفة؟ هل يعود أو رمز خطأ؟
• Zero-Flength buffers] - هل يمكن أن تعالج المهمة مدخلات من الحجم صفر؟
• Maximum and minimum integer values] - Overflow, underflow, signed/unsigned issues.
• Meemory allocation failures] – Simulate a failed by using a custom allocator or mock.
• Boundary conditions on cycles] — exactly 0 iterations, exactly 1 iteration, the maximum allowed iteration count.
• Error codes from underlying functions] – returning , ]] returning a partial count.

وهنا مثال على اختبار حالة حافة مع الوحدة:

void test_parse_config_null_path(void) {
 // Arrange
 const char* path = NULL;

 // Act
 ConfigResult result = parse_config(path);

 // Assert
 TEST_ASSERT_EQUAL(CONFIG_ERR_NULL_POINTER, result.error);
}

ولا تفترض أن المدخلات " العادية " ستستخدم دائما، فالإطلاع على مسارات سعيدة واضحة أقل قيمة من تغطية مجموعة واسعة من حالات الخطأ.

تأقلم اختباراتك في خط سيري

وتُجرى اختبارات الوحدة بأقصى قدر من الفعالية عندما تجري تلقائياً على كل التزام، ويكفل التكامل المستمر أن يتم التراجع خلال دقائق وليس أياماً، أما بالنسبة للمشاريع جيم، فإن إنشاء مكتب التحقيقات المركزي بأدوات مفتوحة المصدر أمر مباشر.

مثال: عمل جيت هوب مع كيك

Create a ] file:

name: C Unit Tests
on: [push, pull_request]
jobs:
 test:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v4
 - name: Install dependencies
 run: sudo apt-get install -y cmake gcc lcov
 - name: Configure and build
 run: |
 mkdir build && cd build
 cmake .. -DCMAKE_BUILD_TYPE=Debug -DENABLE_TESTS=ON
 make
 - name: Run tests
 run: cd build && ctest --output-on-failure
 - name: Generate coverage report
 run: cd build && lcov --capture --directory . --output-file coverage.info && genhtml coverage.info --output-dir coverage

This work flow compiles the project, runs the unit tests with C testing, and produces a code coverage report. you can then publish the coverage report as an artifact. For a comprehensive guide on CI integration, see the GitHub Actions documentation for C/C+++].

الحفاظ على وتطور مسلسل اختبارك

ومع نمو قاعدة البيانات، يجب أن تظل الاختبارات جارية، فالاختبارات التي تجتاز دائما أو التي لا تستكمل أبدا تصبح ضوضاء وتضعف الثقة، وتتبع هذه الممارسات لضمان أن تكون جُنحة الاختبار الخاصة بك لا تزال قيّمة:

• Run tests before every commit.] Use a pre-commit hook or a CI gate if feasible.
• Treat test code as production code.] Apply the same coding standards, avoid duplication, and refactor when necessary.
• Measure code coverage.] Tools like (included with GCC) and ]) generate lineby-line coverage reports. While 100% line coverage is not always reality, a steady coverage trend ( ⁇ 70%) is a good indicator of test quality.[F4]
• Ruthlessly delete dead test cases.] If a function is removed, its tests must be removed too. Keep the suite lean.
• Usese test —driven development (TDD) for new features.] Write the test first, see it fail, then implement the minimal code to make it pass.

الشلالات المشتركة وكيفية تجنبها

1- نظام الاختبار

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

2 - تفاصيل الاختبار بدلا من السلوك

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

3 - غبار الذاكرة

C programs allocate memory dynamically, and unit tests can leak memory also. Use Valgrind or the address sanitizer () during testing. CMocka can also report memory leaks automatically.

4- التكرار المفرط

عندما تصبح كل وظيفة مسخرة ينتهي بك الأمر بالاختبار فقط أن السخرية تم تسميتها وليس السلوك الفعلي

5 - عدم إجراء اختبارات مع كل من الدبلوم والإفراج عن الأنظار

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

خاتمة

اختبارات وحدة الكتابة لـ (جيم) ليست ترفية، بل هي تأديب يُدفع في وقت أقل من التشويش، وحوادث إنتاج أقل، وزيادة الثقة عند إعادة التصنيع، واختيار إطار اختبار مناسب، وتنظيم اختبارات مع نمط العائد المتواضع من البرتقالي، وعزل المعالين من خلال التكرير، وتغطية الحالات القصوى،

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