Ceedling

السقف

26 أكتوبر 2024 ؟ سيتم شحن Ceedling 1.0.0 قريبًا جدًا. الإصدارات التجريبية متاحة الآن. اطلع على ملف README الجديد بالكامل لإعادة تقديم Ceedling وروابط لمجموعة متنوعة من الموارد التكميلية. راجع ملاحظات الإصدار للحصول على نظرة عامة على كل ما هو جديد منذ 0.31.1 بالإضافة إلى روابط لسجل التغيير التفصيلي وقائمة التغييرات العاجلة.

Ceedling هو نظام بناء لمشاريع لغة C وهو بمثابة امتداد لنظام بناء Ruby's Rake (make-ish). يجعل Ceedling أيضًا TDD (التطوير القائم على الاختبار) في لغة C أمرًا سهلاً من خلال دمج CMock وUnity وCException - وهي ثلاثة مشاريع رائعة أخرى مفتوحة المصدر لا يمكنك العيش بدونها إذا كنت تنشئ روعة في لغة C. Ceedling قابل للتوسيع أيضًا باستخدام آلية البرنامج المساعد سهلة الاستخدام.

توثيق الاستخدام

معلومات التوثيق والترخيص موجودة في الريبو في المستندات/

ابدء

تأكد أولاً من تثبيت Ruby على نظامك (إذا لم يكن مثبتًا بالفعل). ثم من موجه الأوامر:

 > gem install ceedling

(تثبيت بديل لأولئك الذين يخططون ليكونوا مطورين متفوقين)

 > git clone --recursive https://github.com/throwtheswitch/ceedling.git
> cd ceedling
> bundle install # Ensures you have all RubyGems needed
> git submodule update --init --recursive # Updates all submodules
> bundle exec rake # Run all Ceedling library tests

إذا لم يتم تثبيت المجمع على نظامك أو واجهت مشكلات، فقد يتعين عليك تثبيته:

 > sudo gem install bundler

إذا واجهت مشكلة في تشغيل أداة التجميع وتلقيت رسائل مثل هذه can't find gem bundler (>= 0.a) with executable bundle (Gem::GemNotFoundException) ، فقد تحتاج إلى تثبيت إصدار مختلف من أداة التجميع. لهذا الرجاء الرجوع إلى الإصدار الموجود في Gemfile.lock. فيما يلي مثال يستند إلى Gemfile.lock الحالي:

 > sudo gem install bundler -v 1.16.2

إنشاء مشروع

من السهل إنشاء مشروع باستخدام Ceedling. ما عليك سوى إخبار ceedling باسم المشروع، وسيقوم بإنشاء دليل فرعي يسمى هذا الاسم وملئه ببنية الدليل الافتراضي وتكوينه.

 ceedling new YourNewProjectName

يمكنك إضافة ملفات إلى src وأدلة الاختبار الخاصة بك وستصبح على الفور جزءًا من البنية الاختبارية الخاصة بك. هل تحتاج إلى هيكل مختلف؟ يمكنك البدء في تعديل ملف project.yml فورًا باستخدام المسار الجديد أو متطلبات الأداة.

يمكنك الترقية إلى أحدث إصدار من Ceedling في أي وقت، وستتمكن تلقائيًا من الوصول إلى حزمة Unity وCMock المرفقة به.

 gem update ceedling

التوثيق

هل بدأت للتو مع Ceedling؟ ربما ترغب في تثبيت مشروعك مع بعض الوثائق المفيدة الخاصة به؟ لا مشكلة! يمكنك القيام بذلك عند إنشاء مشروع جديد.

 ceedling new --docs MyAwesomeProject

ربط أدواتك ومشروعك

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

 ceedling new --local YourNewProjectName

سيؤدي هذا إلى تثبيت كل من Unity وCMock وCeedling في مجلد جديد يسمى vendor داخل مشروعك YourNewProjectName . سيستمر في إنشاء بنية الدليل البسيطة لك باستخدام مجلدات src ومجلدات test .

نتيجة!

إذا كنت تريد فرض ترقية إصدار مثبت محليًا من Ceedling ليتوافق مع أحدث جوهرة لديك لاحقًا، فالأمر سهل! فقط قم بإصدار الأمر التالي:

 ceedling upgrade --local YourNewProjectName

تمامًا مثل الأمر new ، يتم استدعاؤه من الدليل الأصلي لمشروعك.

هل أنت خائف من فقدان جميع التغييرات المحلية الخاصة بك عندما يحدث هذا؟ يمكنك منع Ceedling من تحديث ملف مشروعك عن طريق إصدار no_configs .

 ceedling upgrade --local --no_configs TheProject

التكامل مع جيت

هل تستخدم جيت؟ قد ترغب في جعل Ceedling يقوم تلقائيًا بإنشاء ملف gitignore لك عن طريق إضافة --gitignore إلى مكالمتك new .

اختبار سعيد!