ufolint

Ufolint هو مخطط ملف المصدر لتطوير المحرف في رمز مصدر كائن الخط الموحد (UFO). تم تصميمه لاختبار التكامل المستمر لمساهمات مصدر UFO في مشاريع محرف.

يقوم التطبيق بإجراء تحليل ثابت محدد للملفات النصية المصدر مقابل مواصفات UFO V2 و V3 للمشكلات التي تتضمن:

• نسخة UFO المدعومة
• الملفات الإلزامية والأدلة
• اتفاقيات تسمية مسار الملف الإلزامي
• المصدر المحدد مسار الملف ومسار الدليل عبر ملفات المصدر
• تنسيق ملف XML صالح
• *.
• *.
• fontinfo.plist opentype خاصية تسمية اتفاقيات
• fontinfo.plist opentype بيانات خاصية
• *.glif اختبار إصدار ملف الملف
• *.GLIF FILE OUTLINE ، السمة ، مرساة ، مبادئ توجيهية ، صورة ، ملاحظة
• الصور اتبع مواصفات UFO V3+ PNG
• ملفات المصدر استيراد إلى مكتبة Ufolib مع أساليب Ufolib العامة

يتم إجراء هذه الاختبارات من خلال مجموعة من الأساليب العامة في مكتبة Fonttools.ufolib واختبارات إضافية يتم تنفيذها في تطبيق Ufolint. يمسك Ufolint الاستثناءات التي أثيرت في أساليب القراءة العامة Ufolib لجميع أنواع ملفات _.plist وجميع عمليات التحقق من UFOLIB التي تم تنفيذها على ملفات _.GLIF. يتم إرجاع هذه إلى المستخدمين الذين لديهم رسائل خطأ إعلامية تشير إلى FilePath (s) للقلق ورمز حالة الخروج 1.

تثبيت وترقية

يمكن تشغيل Ufolint محليًا أو مع خدمات اختبار CI عن بُعد.

التثبيت والترقية المحلية

استخدم الأمر:

 $ pip install ufolint

الترقية إلى إصدار جديد من التطبيق مع الأمر:

 $ pip install --upgrade ufolint

الاستخدام المحلي

العملية مؤتمتة بالكامل. ما عليك سوى توجيه Ufolint إلى أدلة مصدر UFO أو أكثر ويهتم بالباقي. يخرج Ufolint مع رمز الحالة 0 إذا تمر جميع الاختبارات وتخرج برمز الحالة 1 في حالة فشل أي اختبارات.

 $ ufolint [UFO source path] ([UFO path 2] [UFO path3]...)

مثال

 $ ufolint Awesome-Regular.ufo Awesome-Bold.ufo

من أجل الإخفاقات الحاسمة التي تمنع الانتهاء من إجراء مزيد من الاختبارات ، يتم إحباط Ufolint على الفور ويتم إحباط الاختبارات الأخرى. في جميع الظروف الأخرى ، يتم جمع الفشل عبر التحليل بأكمله وعرضه عند الانتهاء من جميع الاختبارات.

يوفر Ufolint رسائل خطأ مطوّلة ومفيدة تتضمن الملف (الملفات) للقلق ونوع الخطأ ، وفي كثير من الحالات ، الخط الإشكالي في الملف.

إعداد Travis CI

لاختبار تغييرات مصدر UFO بشكل مستمر على Travis مع كل طلب تم دفعه أو طلب سحب إلى مستودع GitHub الخاص بك ، استخدم هذه الخطوتين الأوليين من دليل البدء في Travis:

• الخطوة 1 : تسجيل الدخول إلى Travis مع حساب github الخاص بك
• الخطوة 2 : انتقل إلى صفحة ملف تعريف Travis الخاص بك وتمكين Travis لمستودع المحرف حيث ترغب في تمكين اختبار Ufolint

ثم في مستودع github الخاص بك ،

• الخطوة 3 : أضف ملفًا على المسار .travis.yml في جذر مستودع github الخاص بك يتضمن النص التالي:

.travis.yml

 sudo : false
language : python

env :
  - VARIANT=src/Test-Regular.ufo
  - VARIANT=src/Test-Bold.ufo
  - VARIANT=src/Test-Italic.ufo
  - VARIANT=src/Test-BoldItalic.ufo

before_script : pip install ufolint

script : " ufolint $VARIANT "

notifications :
  email : false

• الخطوة 4 : استبدل VARIANT=src/Test-*.ufo في ملف .travis.yml مع المسارات الفعلية لملفات مصدر UFO الخاصة بك بعد = . استخدم سطرًا واحدًا لكل متغير وأضف أو طرح الخطوط حسب الضرورة لاختبار أدلة UFO المصدر المطلوب في المستودع. يجب أن تكون هذه المسارات النسبية من جذر مستودع GIT الخاص بك.

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

• الخطوة 5 : مع كل التزام جديد يتم دفعه إلى مستودع GitHub الخاص بك (أو أي طلب سحب جديد مقدمة من الآخرين) يتم إخطار Travis تلقائيًا ويقوم بإجراء اختبارات Ufolint على مصدر UFO المعدل (أو التعديلات المقترحة لطلبات السحب). يمكنك عرض نتائج الاختبار على صفحة حساب Travis الخاصة بك للمستودع.

• اختياري : لإضافة شارة نتيجة اختبار TRAVIS إلى صفحة README المستودع الخاص بك ، أدخل عملية التخفيض التالية في صفحة readme الخاصة بك وتعديل [ACCOUNT] و [REPOSITORY] مع حساب TRAVIS وتفاصيل المستودع:

 [![Build Status](https://travis-ci.org/[ACCOUNT]/[REPOSITORY].svg?branch=master)](https://travis-ci.org/[ACCOUNT]/[REPOSITORY])

شكر وتقدير

تم تصميمه مع مكتبة Fonttools الرائعة حيث تم تنفيذ غالبية أعمال التحقق من صحة UFO!

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا